mirror of
https://github.com/borgbackup/borg.git
synced 2026-04-26 00:29:08 -04:00
89 lines
2.6 KiB
Groff
89 lines
2.6 KiB
Groff
.\" Man page generated from reStructuredText
|
|
.\" by the Docutils 0.22.4 manpage writer.
|
|
.
|
|
.
|
|
.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-repo-compress" "1" "2026-03-15" "" "borg backup tool"
|
|
.SH Name
|
|
borg-repo-compress \- Repository (re-)compression.
|
|
.SH SYNOPSIS
|
|
.sp
|
|
borg [common options] repo\-compress [options]
|
|
.SH DESCRIPTION
|
|
.sp
|
|
Repository (re\-)compression (and/or re\-obfuscation).
|
|
.sp
|
|
Reads all chunks in the repository and recompresses them if they are not already
|
|
using the compression type/level and obfuscation level given via \fB\-\-compression\fP\&.
|
|
.sp
|
|
If the outcome of the chunk processing indicates a change in compression
|
|
type/level or obfuscation level, the processed chunk is written to the repository.
|
|
Please note that the outcome might not always be the desired compression
|
|
type/level \- if no compression gives a shorter output, that might be chosen.
|
|
.sp
|
|
Please note that this command can not work in low (or zero) free disk space
|
|
conditions.
|
|
.sp
|
|
If the \fBborg repo\-compress\fP process receives a SIGINT signal (Ctrl\-C), the repo
|
|
will be committed and compacted and borg will terminate cleanly afterwards.
|
|
.sp
|
|
Both \fB\-\-progress\fP and \fB\-\-stats\fP are recommended when \fBborg repo\-compress\fP
|
|
is used interactively.
|
|
.sp
|
|
You do \fBnot\fP need to run \fBborg compact\fP after \fBborg repo\-compress\fP\&.
|
|
.SH OPTIONS
|
|
.sp
|
|
See \fIborg\-common(1)\fP for common options of Borg commands.
|
|
.SS options
|
|
.INDENT 0.0
|
|
.TP
|
|
.BI \-C \ COMPRESSION\fR,\fB \ \-\-compression \ COMPRESSION
|
|
select compression algorithm, see the output of the \(dqborg help compression\(dq command for details.
|
|
.TP
|
|
.B \-s\fP,\fB \-\-stats
|
|
print statistics
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.EX
|
|
# Recompress repository contents
|
|
$ borg repo\-compress \-\-progress \-\-compression=zstd,3
|
|
|
|
# Recompress and obfuscate repository contents
|
|
$ borg repo\-compress \-\-progress \-\-compression=obfuscate,1,zstd,3
|
|
.EE
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fIborg\-common(1)\fP
|
|
.SH Author
|
|
The Borg Collective
|
|
.\" End of generated man page.
|