1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-01-03 13:45:31 +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.

121 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-10-31 19:50:06 +00:00
.TH "BORG-INFO" 1 "2024-10-31" "" "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
2024-09-26 05:57:01 +00:00
borg [common options] info [options] [NAME]
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-09-26 05:57:01 +00:00
.SS arguments
.INDENT 0.0
.TP
.B NAME
specify the archive name
.UNINDENT
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
2024-10-03 10:23:03 +00:00
only consider archives matching all patterns. see \(dqborg help match\-archives\(dq.
2017-02-05 13:22:06 +00:00
.TP
.BI \-\-sort\-by \ KEYS
2024-10-03 10:23:03 +00:00
Comma\-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; 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
2024-09-26 05:57:01 +00:00
$ borg info aid:f7dea078
Archive name: source\-backup
2022-06-23 23:19:19 +00:00
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
2024-09-26 05:57:01 +00:00
Command line: /usr/bin/borg \-r path/to/repo create source\-backup src
2022-06-23 23:19:19 +00:00
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.
.