1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2024-12-28 19:01:58 +00:00
borg/docs/man/borg-info.1

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

115 lines
3.2 KiB
Groff
Raw Normal View History

2017-02-05 13:22:06 +00:00
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
2024-09-09 14:58:06 +00:00
.TH "BORG-INFO" 1 "2024-09-09" "" "borg backup tool"
2022-06-23 23:19:19 +00:00
.SH NAME
borg-info \- Show archive details such as disk space used
2017-02-05 13:22:06 +00:00
.SH SYNOPSIS
.sp
2022-06-23 23:19:19 +00:00
borg [common options] info [options]
2017-02-05 13:22:06 +00:00
.SH DESCRIPTION
.sp
2022-06-23 23:19:19 +00:00
This command displays detailed information about the specified archive.
2017-02-05 13:22:06 +00:00
.sp
Please note that the deduplicated sizes of the individual archives do not add
2022-09-10 14:03:27 +00:00
up to the deduplicated size of the repository (\(dqall archives\(dq), because the two
2017-02-05 13:22:06 +00:00
are meaning different things:
.sp
This archive / deduplicated size = amount of data stored ONLY for this archive
2017-02-05 13:22:06 +00:00
= unique chunks of this archive.
All archives / deduplicated size = amount of data stored in the repo
2017-02-05 13:22:06 +00:00
= all chunks in the repository.
.SH OPTIONS
.sp
See \fIborg\-common(1)\fP for common options of Borg commands.
2024-07-19 18:40:15 +00:00
.SS optional arguments
2017-03-26 23:58:19 +00:00
.INDENT 0.0
.TP
2022-06-23 23:19:19 +00:00
.B \-\-json
2017-03-26 23:58:19 +00:00
format output as JSON
.UNINDENT
.SS Archive filters
2017-02-05 13:22:06 +00:00
.INDENT 0.0
.TP
2022-10-02 13:51:17 +00:00
.BI \-a \ PATTERN\fR,\fB \ \-\-match\-archives \ PATTERN
only consider archive names matching the pattern. see \(dqborg help match\-archives\(dq.
2017-02-05 13:22:06 +00:00
.TP
.BI \-\-sort\-by \ KEYS
2024-02-20 16:12:43 +00:00
Comma\-separated list of sorting keys; valid keys are: timestamp, archive, name, id; default is: timestamp
2017-02-05 13:22:06 +00:00
.TP
.BI \-\-first \ N
consider first N archives after other filters were applied
.TP
.BI \-\-last \ N
consider last N archives after other filters were applied
2023-02-26 20:30:54 +00:00
.TP
.BI \-\-oldest \ TIMESPAN
consider archives between the oldest archive\(aqs timestamp and (oldest + TIMESPAN), e.g. 7d or 12m.
.TP
.BI \-\-newest \ TIMESPAN
consider archives between the newest archive\(aqs timestamp and (newest \- TIMESPAN), e.g. 7d or 12m.
.TP
.BI \-\-older \ TIMESPAN
2024-02-20 16:12:43 +00:00
consider archives older than (now \- TIMESPAN), e.g. 7d or 12m.
2023-02-26 20:30:54 +00:00
.TP
.BI \-\-newer \ TIMESPAN
consider archives newer than (now \- TIMESPAN), e.g. 7d or 12m.
2017-02-05 13:22:06 +00:00
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
2022-06-23 23:19:19 +00:00
$ borg info Tuesday2022\-06\-25T20:51:39
Archive name: Tuesday2022\-06\-25T20:51:39
Archive fingerprint: f7dea0788dfc026cc2be1c0f5b94beb4e4084eb3402fc40c38d8719b1bf2d943
Comment:
2022-06-23 23:19:19 +00:00
Hostname: mba2020
Username: tw
Time (start): Sat, 2022\-06\-25 20:51:40
Time (end): Sat, 2022\-06\-25 20:51:40
Duration: 0.03 seconds
Command line: /Users/tw/w/borg\-env/bin/borg \-r path/to/repo create \-\-stats \(aqTuesday{now}\(aq src \-\-progress
Utilization of maximum supported archive size: 0%
Number of files: 244
Original size: 13.80 MB
Deduplicated size: 531 B
2017-02-05 13:22:06 +00:00
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
2024-09-08 15:52:10 +00:00
\fIborg\-common(1)\fP, \fIborg\-list(1)\fP, \fIborg\-diff(1)\fP, \fIborg\-repo\-info(1)\fP
2017-02-05 13:22:06 +00:00
.SH AUTHOR
The Borg Collective
.\" Generated by docutils manpage writer.
.