mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-23 08:16:54 +00:00
154 lines
5.4 KiB
Groff
154 lines
5.4 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH BORG-INFO 1 "2022-04-14" "" "borg backup tool"
|
|
.SH NAME
|
|
borg-info \- Show archive details such as disk space used
|
|
.
|
|
.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
|
|
..
|
|
.SH SYNOPSIS
|
|
.sp
|
|
borg [common options] info [options] [REPOSITORY_OR_ARCHIVE]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
This command displays detailed information about the specified archive or repository.
|
|
.sp
|
|
Please note that the deduplicated sizes of the individual archives do not add
|
|
up to the deduplicated size of the repository ("all archives"), because the two
|
|
are meaning different things:
|
|
.sp
|
|
This archive / deduplicated size = amount of data stored ONLY for this archive
|
|
= unique chunks of this archive.
|
|
All archives / deduplicated size = amount of data stored in the repo
|
|
= all chunks in the repository.
|
|
.sp
|
|
Borg archives can only contain a limited amount of file metadata.
|
|
The size of an archive relative to this limit depends on a number of factors,
|
|
mainly the number of files, the lengths of paths and other metadata stored for files.
|
|
This is shown as \fIutilization of maximum supported archive size\fP\&.
|
|
.SH OPTIONS
|
|
.sp
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
.SS arguments
|
|
.INDENT 0.0
|
|
.TP
|
|
.B REPOSITORY_OR_ARCHIVE
|
|
repository or archive to display information about
|
|
.UNINDENT
|
|
.SS optional arguments
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-json
|
|
format output as JSON
|
|
.UNINDENT
|
|
.SS Archive filters
|
|
.INDENT 0.0
|
|
.TP
|
|
.BI \-P \ PREFIX\fR,\fB \ \-\-prefix \ PREFIX
|
|
only consider archive names starting with this prefix.
|
|
.TP
|
|
.BI \-a \ GLOB\fR,\fB \ \-\-glob\-archives \ GLOB
|
|
only consider archive names matching the glob. sh: rules apply, see "borg help patterns". \fB\-\-prefix\fP and \fB\-\-glob\-archives\fP are mutually exclusive.
|
|
.TP
|
|
.BI \-\-sort\-by \ KEYS
|
|
Comma\-separated list of sorting keys; valid keys are: timestamp, name, id; default is: timestamp
|
|
.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
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ borg info /path/to/repo::2017\-06\-29T11:00\-srv
|
|
Archive name: 2017\-06\-29T11:00\-srv
|
|
Archive fingerprint: b2f1beac2bd553b34e06358afa45a3c1689320d39163890c5bbbd49125f00fe5
|
|
Comment:
|
|
Hostname: myhostname
|
|
Username: root
|
|
Time (start): Thu, 2017\-06\-29 11:03:07
|
|
Time (end): Thu, 2017\-06\-29 11:03:13
|
|
Duration: 5.66 seconds
|
|
Number of files: 17037
|
|
Command line: /usr/sbin/borg create /path/to/repo::2017\-06\-29T11:00\-srv /srv
|
|
Utilization of max. archive size: 0%
|
|
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Original size Compressed size Deduplicated size
|
|
This archive: 12.53 GB 12.49 GB 1.62 kB
|
|
All archives: 121.82 TB 112.41 TB 215.42 GB
|
|
|
|
Unique chunks Total chunks
|
|
Chunk index: 1015213 626934122
|
|
|
|
$ borg info /path/to/repo \-\-last 1
|
|
Archive name: 2017\-06\-29T11:00\-srv
|
|
Archive fingerprint: b2f1beac2bd553b34e06358afa45a3c1689320d39163890c5bbbd49125f00fe5
|
|
Comment:
|
|
Hostname: myhostname
|
|
Username: root
|
|
Time (start): Thu, 2017\-06\-29 11:03:07
|
|
Time (end): Thu, 2017\-06\-29 11:03:13
|
|
Duration: 5.66 seconds
|
|
Number of files: 17037
|
|
Command line: /usr/sbin/borg create /path/to/repo::2017\-06\-29T11:00\-srv /srv
|
|
Utilization of max. archive size: 0%
|
|
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Original size Compressed size Deduplicated size
|
|
This archive: 12.53 GB 12.49 GB 1.62 kB
|
|
All archives: 121.82 TB 112.41 TB 215.42 GB
|
|
|
|
Unique chunks Total chunks
|
|
Chunk index: 1015213 626934122
|
|
|
|
$ borg info /path/to/repo
|
|
Repository ID: d857ce5788c51272c61535062e89eac4e8ef5a884ffbe976e0af9d8765dedfa5
|
|
Location: /path/to/repo
|
|
Encrypted: Yes (repokey)
|
|
Cache: /root/.cache/borg/d857ce5788c51272c61535062e89eac4e8ef5a884ffbe976e0af9d8765dedfa5
|
|
Security dir: /root/.config/borg/security/d857ce5788c51272c61535062e89eac4e8ef5a884ffbe976e0af9d8765dedfa5
|
|
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Original size Compressed size Deduplicated size
|
|
All archives: 121.82 TB 112.41 TB 215.42 GB
|
|
|
|
Unique chunks Total chunks
|
|
Chunk index: 1015213 626934122
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fIborg\-common(1)\fP, \fIborg\-list(1)\fP, \fIborg\-diff(1)\fP
|
|
.SH AUTHOR
|
|
The Borg Collective
|
|
.\" Generated by docutils manpage writer.
|
|
.
|