TheArchive/restic
1
0
Fork 0
mirror of https://github.com/restic/restic.git synced 2025-12-12 12:12:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update manpages and auto-completion

Browse Source
This commit is contained in:
Alexander Neumann
2025-03-27 20:16:56 +01:00
parent 0e5f41c842
commit ab024e6a51
39 changed files with 117 additions and 276 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
doc/man/restic-rewrite.1
View File

@@ -2,17 +2,14 @@
.TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" ""
.SH NAME
.PP
restic-rewrite - Rewrite snapshots to exclude unwanted files
.SH SYNOPSIS
.PP
\fBrestic rewrite [flags] [snapshotID ...]\fP
.SH DESCRIPTION
.PP
The "rewrite" command excludes files from existing snapshots. It creates new
snapshots containing the same data as the original ones, but without the files
you specify to exclude. All metadata (time, host, tags) will be preserved.
@@ -32,9 +29,17 @@ Please note that the --forget option only removes the snapshots and not the actu
data stored in the repository. In order to delete the no longer referenced data,
use the "prune" command.
.PP
When rewrite is used with the --snapshot-summary option, a new snapshot is
created containing statistics summary data. Only two fields in the summary will
be non-zero: TotalFilesProcessed and TotalBytesProcessed.
.PP
When rewrite is called with one of the --exclude options, TotalFilesProcessed
and TotalBytesProcessed will be updated in the snapshot summary.
.SH EXIT STATUS
.PP
Exit status is 0 if the command was successful.
Exit status is 1 if there was any error.
Exit status is 10 if the repository does not exist.
@@ -43,7 +48,6 @@ Exit status is 12 if the password is incorrect.
.SH OPTIONS
.PP
\fB-n\fP, \fB--dry-run\fP[=false]
do not do anything, just print what would be done
@@ -87,13 +91,16 @@ Exit status is 12 if the password is incorrect.
\fB--path\fP=[]
only consider snapshots including this (absolute) \fBpath\fR (can be specified multiple times, snapshots must include all specified paths)
.PP
\fB-s\fP, \fB--snapshot-summary\fP[=false]
create snapshot summary record if it does not exist
.PP
\fB--tag\fP=[]
only consider snapshots including \fBtag[,tag,...]\fR (can be specified multiple times)
.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB--cacert\fP=[]
\fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT)
@@ -195,5 +202,4 @@ Exit status is 12 if the password is incorrect.
.SH SEE ALSO
.PP
\fBrestic(1)\fP