mirror of
https://github.com/borgbackup/borg.git
synced 2026-02-19 02:29:19 -05:00
91 lines
2.9 KiB
Groff
91 lines
2.9 KiB
Groff
.\" 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
|
|
..
|
|
.TH "BORG-ANALYZE" "1" "2025-12-23" "" "borg backup tool"
|
|
.SH NAME
|
|
borg-analyze \- Analyzes archives.
|
|
.SH SYNOPSIS
|
|
.sp
|
|
borg [common options] analyze [options]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
Analyze archives to find \(dqhot spots\(dq.
|
|
.sp
|
|
\fBborg analyze\fP relies on the usual archive matching options to select the
|
|
archives that should be considered for analysis (e.g. \fB\-a series_name\fP).
|
|
Then it iterates over all matching archives, over all contained files, and
|
|
collects information about chunks stored in all directories it encounters.
|
|
.sp
|
|
It considers chunk IDs and their plaintext sizes (we do not have the compressed
|
|
size in the repository easily available) and adds up the sizes of added and removed
|
|
chunks per direct parent directory, and outputs a list of \(dqdirectory: size\(dq.
|
|
.sp
|
|
You can use that list to find directories with a lot of \(dqactivity\(dq — maybe
|
|
some of these are temporary or cache directories you forgot to exclude.
|
|
.sp
|
|
To avoid including these unwanted directories in your backups, you can carefully
|
|
exclude them in \fBborg create\fP (for future backups) or use \fBborg recreate\fP
|
|
to recreate existing archives without them.
|
|
.SH OPTIONS
|
|
.sp
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
.SS Archive filters
|
|
.INDENT 0.0
|
|
.TP
|
|
.BI \-a \ PATTERN\fR,\fB \ \-\-match\-archives \ PATTERN
|
|
only consider archives matching all patterns. See \(dqborg help match\-archives\(dq.
|
|
.TP
|
|
.BI \-\-sort\-by \ KEYS
|
|
Comma\-separated list of sorting keys; valid keys are: timestamp, archive, name, id, tags, host, user; default is: timestamp
|
|
.TP
|
|
.BI \-\-first \ N
|
|
consider the first N archives after other filters are applied
|
|
.TP
|
|
.BI \-\-last \ N
|
|
consider the last N archives after other filters are applied
|
|
.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
|
|
consider archives older than (now \- TIMESPAN), e.g., 7d or 12m.
|
|
.TP
|
|
.BI \-\-newer \ TIMESPAN
|
|
consider archives newer than (now \- TIMESPAN), e.g., 7d or 12m.
|
|
.UNINDENT
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fIborg\-common(1)\fP
|
|
.SH AUTHOR
|
|
The Borg Collective
|
|
.\" Generated by docutils manpage writer.
|
|
.
|