From ab024e6a5187685415a526efccb3af4325e84c88 Mon Sep 17 00:00:00 2001 From: Alexander Neumann Date: Thu, 27 Mar 2025 20:16:56 +0100 Subject: [PATCH] Update manpages and auto-completion --- doc/bash-completion.sh | 32 ++++++++++++++++++++++++++++ doc/man/restic-backup.1 | 7 ------- doc/man/restic-cache.1 | 7 ------- doc/man/restic-cat.1 | 7 ------- doc/man/restic-check.1 | 7 ------- doc/man/restic-copy.1 | 7 ------- doc/man/restic-diff.1 | 11 ---------- doc/man/restic-dump.1 | 7 ------- doc/man/restic-features.1 | 7 ------- doc/man/restic-find.1 | 12 +++++------ doc/man/restic-forget.1 | 13 +++++------- doc/man/restic-generate.1 | 15 ++++--------- doc/man/restic-init.1 | 7 ------- doc/man/restic-key-add.1 | 7 ------- doc/man/restic-key-list.1 | 7 ------- doc/man/restic-key-passwd.1 | 7 ------- doc/man/restic-key-remove.1 | 7 ------- doc/man/restic-key.1 | 6 ------ doc/man/restic-list.1 | 7 ------- doc/man/restic-ls.1 | 20 +++++++++++------- doc/man/restic-migrate.1 | 7 ------- doc/man/restic-mount.1 | 8 ------- doc/man/restic-options.1 | 7 ------- doc/man/restic-prune.1 | 13 +++++------- doc/man/restic-recover.1 | 7 ------- doc/man/restic-repair-index.1 | 7 ------- doc/man/restic-repair-packs.1 | 7 ------- doc/man/restic-repair-snapshots.1 | 8 ------- doc/man/restic-repair.1 | 6 ------ doc/man/restic-restore.1 | 17 ++++++++------- doc/man/restic-rewrite.1 | 20 +++++++++++------- doc/man/restic-self-update.1 | 7 ------- doc/man/restic-snapshots.1 | 7 ------- doc/man/restic-stats.1 | 11 ---------- doc/man/restic-tag.1 | 7 ------- doc/man/restic-unlock.1 | 7 ------- doc/man/restic-version.1 | 7 ------- doc/man/restic.1 | 5 ----- doc/powershell-completion.ps1 | 35 ++++++++++++++++++++++++++----- 39 files changed, 117 insertions(+), 276 deletions(-) diff --git a/doc/bash-completion.sh b/doc/bash-completion.sh index 985d0e369..5103d80c0 100644 --- a/doc/bash-completion.sh +++ b/doc/bash-completion.sh @@ -1161,6 +1161,10 @@ _restic_find() two_word_flags+=("--path") local_nonpersistent_flags+=("--path") local_nonpersistent_flags+=("--path=") + flags+=("--reverse") + flags+=("-R") + local_nonpersistent_flags+=("--reverse") + local_nonpersistent_flags+=("-R") flags+=("--show-pack-id") local_nonpersistent_flags+=("--show-pack-id") flags+=("--snapshot=") @@ -1349,6 +1353,10 @@ _restic_forget() local_nonpersistent_flags+=("--repack-small") flags+=("--repack-uncompressed") local_nonpersistent_flags+=("--repack-uncompressed") + flags+=("--repack-smaller-than=") + two_word_flags+=("--repack-smaller-than") + local_nonpersistent_flags+=("--repack-smaller-than") + local_nonpersistent_flags+=("--repack-smaller-than=") flags+=("--help") flags+=("-h") local_nonpersistent_flags+=("--help") @@ -2224,6 +2232,14 @@ _restic_ls() local_nonpersistent_flags+=("--path=") flags+=("--recursive") local_nonpersistent_flags+=("--recursive") + flags+=("--reverse") + local_nonpersistent_flags+=("--reverse") + flags+=("--sort=") + two_word_flags+=("--sort") + two_word_flags+=("-s") + local_nonpersistent_flags+=("--sort") + local_nonpersistent_flags+=("--sort=") + local_nonpersistent_flags+=("-s") flags+=("--tag=") two_word_flags+=("--tag") local_nonpersistent_flags+=("--tag") @@ -2556,6 +2572,10 @@ _restic_prune() local_nonpersistent_flags+=("--repack-cacheable-only") flags+=("--repack-small") local_nonpersistent_flags+=("--repack-small") + flags+=("--repack-smaller-than=") + two_word_flags+=("--repack-smaller-than") + local_nonpersistent_flags+=("--repack-smaller-than") + local_nonpersistent_flags+=("--repack-smaller-than=") flags+=("--repack-uncompressed") local_nonpersistent_flags+=("--repack-uncompressed") flags+=("--unsafe-recover-no-free-space=") @@ -3085,6 +3105,10 @@ _restic_restore() two_word_flags+=("--exclude-file") local_nonpersistent_flags+=("--exclude-file") local_nonpersistent_flags+=("--exclude-file=") + flags+=("--exclude-xattr=") + two_word_flags+=("--exclude-xattr") + local_nonpersistent_flags+=("--exclude-xattr") + local_nonpersistent_flags+=("--exclude-xattr=") flags+=("--help") flags+=("-h") local_nonpersistent_flags+=("--help") @@ -3121,6 +3145,10 @@ _restic_restore() two_word_flags+=("--include-file") local_nonpersistent_flags+=("--include-file") local_nonpersistent_flags+=("--include-file=") + flags+=("--include-xattr=") + two_word_flags+=("--include-xattr") + local_nonpersistent_flags+=("--include-xattr") + local_nonpersistent_flags+=("--include-xattr=") flags+=("--overwrite=") two_word_flags+=("--overwrite") local_nonpersistent_flags+=("--overwrite") @@ -3255,6 +3283,10 @@ _restic_rewrite() two_word_flags+=("--path") local_nonpersistent_flags+=("--path") local_nonpersistent_flags+=("--path=") + flags+=("--snapshot-summary") + flags+=("-s") + local_nonpersistent_flags+=("--snapshot-summary") + local_nonpersistent_flags+=("-s") flags+=("--tag=") two_word_flags+=("--tag") local_nonpersistent_flags+=("--tag") diff --git a/doc/man/restic-backup.1 b/doc/man/restic-backup.1 index a84b955ba..8b4e1a9d1 100644 --- a/doc/man/restic-backup.1 +++ b/doc/man/restic-backup.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-backup - Create a new backup of files and/or directories .SH SYNOPSIS -.PP \fBrestic backup [flags] [FILE/DIR] ...\fP .SH DESCRIPTION -.PP The "backup" command creates a new snapshot and saves the files and directories given as the arguments. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was a fatal error (no snapshot created). Exit status is 3 if some source data could not be read (incomplete snapshot created). @@ -28,7 +24,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-n\fP, \fB--dry-run\fP[=false] do not upload or write any data, just show what would be done @@ -142,7 +137,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -244,5 +238,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-cache.1 b/doc/man/restic-cache.1 index fb23fe8a9..068aad681 100644 --- a/doc/man/restic-cache.1 +++ b/doc/man/restic-cache.1 @@ -2,28 +2,23 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-cache - Operate on local cache directories .SH SYNOPSIS -.PP \fBrestic cache [flags]\fP .SH DESCRIPTION -.PP The "cache" command allows listing and cleaning local cache directories. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB--cleanup\fP[=false] remove old cache directories @@ -41,7 +36,6 @@ Exit status is 1 if there was any error. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -143,5 +137,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-cat.1 b/doc/man/restic-cat.1 index cab1b85a5..cc774cf77 100644 --- a/doc/man/restic-cat.1 +++ b/doc/man/restic-cat.1 @@ -2,22 +2,18 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-cat - Print internal objects to stdout .SH SYNOPSIS -.PP \fBrestic cat [flags] [masterkey|config|pack ID|blob ID|snapshot ID|index ID|key ID|lock ID|tree snapshot:subfolder]\fP .SH DESCRIPTION -.PP The "cat" command is used to print internal objects to stdout. .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. @@ -26,13 +22,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for cat .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -134,5 +128,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-check.1 b/doc/man/restic-check.1 index 60d17a313..9e24ac693 100644 --- a/doc/man/restic-check.1 +++ b/doc/man/restic-check.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-check - Check the repository for errors .SH SYNOPSIS -.PP \fBrestic check [flags]\fP .SH DESCRIPTION -.PP The "check" command tests the repository for errors and reports any errors it finds. It can also be used to read all data and therefore simulate a restore. @@ -22,7 +19,6 @@ repository and not use a local cache. .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. @@ -31,7 +27,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for check @@ -49,7 +44,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -151,5 +145,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-copy.1 b/doc/man/restic-copy.1 index 96c394139..aa38f5ffd 100644 --- a/doc/man/restic-copy.1 +++ b/doc/man/restic-copy.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-copy - Copy snapshots from one repository to another .SH SYNOPSIS -.PP \fBrestic copy [flags] [snapshotID ...]\fP .SH DESCRIPTION -.PP The "copy" command copies one or more snapshots from one repository to another. .PP @@ -31,7 +28,6 @@ new destination repository using the "init" command. .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. @@ -40,7 +36,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB--from-insecure-no-password\fP[=false] use an empty password for the source repository (insecure) @@ -82,7 +77,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -184,5 +178,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-diff.1 b/doc/man/restic-diff.1 index f4c8a1d14..163b54478 100644 --- a/doc/man/restic-diff.1 +++ b/doc/man/restic-diff.1 @@ -2,22 +2,17 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-diff - Show differences between two snapshots .SH SYNOPSIS -.PP \fBrestic diff [flags] snapshotID snapshotID\fP .SH DESCRIPTION -.PP The "diff" command shows differences from the first to the second snapshot. The first characters in each line display what has happened to a particular file or directory: - -.RS .IP \(bu 2 + The item was added .IP \(bu 2 @@ -31,8 +26,6 @@ T The type was changed, e.g. a file was made a symlink .IP \(bu 2 ? Bitrot detected: The file's content has changed but all metadata is the same -.RE - .PP Metadata comparison will likely not work if a backup was created using the \&'--ignore-inode' or '--ignore-ctime' option. @@ -44,7 +37,6 @@ snapshot. .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. @@ -53,7 +45,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for diff @@ -63,7 +54,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -165,5 +155,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-dump.1 b/doc/man/restic-dump.1 index 657570f6d..e4a6126c2 100644 --- a/doc/man/restic-dump.1 +++ b/doc/man/restic-dump.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-dump - Print a backed-up file to stdout .SH SYNOPSIS -.PP \fBrestic dump [flags] snapshotID file\fP .SH DESCRIPTION -.PP The "dump" command extracts files from a snapshot from the repository. If a single file is selected, it prints its contents to stdout. Folders are output as a tar (default) or zip file containing the contents of the specified folder. @@ -29,7 +26,6 @@ snapshot. .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. @@ -38,7 +34,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-a\fP, \fB--archive\fP="tar" set archive \fBformat\fR as "tar" or "zip" @@ -64,7 +59,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -166,5 +160,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-features.1 b/doc/man/restic-features.1 index b288f655a..355b17782 100644 --- a/doc/man/restic-features.1 +++ b/doc/man/restic-features.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-features - Print list of feature flags .SH SYNOPSIS -.PP \fBrestic features [flags]\fP .SH DESCRIPTION -.PP The "features" command prints a list of supported feature flags. .PP @@ -28,19 +25,16 @@ A \fIdeprecated\fP feature is always disabled and cannot be enabled. The flag wi .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for features .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -142,5 +136,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-find.1 b/doc/man/restic-find.1 index e8d974527..9a7517922 100644 --- a/doc/man/restic-find.1 +++ b/doc/man/restic-find.1 @@ -2,24 +2,22 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-find - Find a file, a directory or restic IDs .SH SYNOPSIS -.PP \fBrestic find [flags] PATTERN...\fP .SH DESCRIPTION -.PP The "find" command searches for files or directories in snapshots stored in the repo. It can also be used to search for restic blobs or trees for troubleshooting. +The default sort option for the snapshots is youngest to oldest. To sort the +output from oldest to youngest specify --reverse. .SH OPTIONS -.PP \fB--blob\fP[=false] pattern is a blob-ID @@ -59,6 +57,10 @@ It can also be used to search for restic blobs or trees for troubleshooting. \fB--path\fP=[] only consider snapshots including this (absolute) \fBpath\fR (can be specified multiple times, snapshots must include all specified paths) +.PP +\fB-R\fP, \fB--reverse\fP[=false] + reverse sort order oldest to newest + .PP \fB--show-pack-id\fP[=false] display the pack-ID the blobs belong to (with --blob or --tree) @@ -77,7 +79,6 @@ It can also be used to search for restic blobs or trees for troubleshooting. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -200,5 +201,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-forget.1 b/doc/man/restic-forget.1 index 058dbee25..0ac6dc990 100644 --- a/doc/man/restic-forget.1 +++ b/doc/man/restic-forget.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-forget - Remove snapshots from the repository .SH SYNOPSIS -.PP \fBrestic forget [flags] [snapshot ID] [...]\fP .SH DESCRIPTION -.PP The "forget" command removes snapshots according to a policy. All snapshots are first divided into groups according to "--group-by", and after that the policy specified by the "--keep-\fI" options is applied to each group individually. @@ -31,7 +28,6 @@ security considerations. .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. @@ -40,7 +36,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-l\fP, \fB--keep-last\fP=0 keep the last \fBn\fR snapshots (use 'unlimited' to keep all snapshots) @@ -130,7 +125,7 @@ Exit status is 12 if the password is incorrect. .PP \fB--max-repack-size\fP="" - maximum \fBsize\fR to repack (allowed suffixes: k/K, m/M, g/G, t/T) + stop after repacking this much data in total (allowed suffixes for \fBsize\fR: k/K, m/M, g/G, t/T) .PP \fB--repack-cacheable-only\fP[=false] @@ -144,13 +139,16 @@ Exit status is 12 if the password is incorrect. \fB--repack-uncompressed\fP[=false] repack all uncompressed data +.PP +\fB--repack-smaller-than\fP="" + pack \fBbelow-limit\fR packfiles (allowed suffixes: k/K, m/M) + .PP \fB-h\fP, \fB--help\fP[=false] help for forget .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -252,5 +250,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-generate.1 b/doc/man/restic-generate.1 index f17a6fcd0..1b4f935e6 100644 --- a/doc/man/restic-generate.1 +++ b/doc/man/restic-generate.1 @@ -2,35 +2,30 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-generate - Generate manual pages and auto-completion files (bash, fish, zsh, powershell) .SH SYNOPSIS -.PP \fBrestic generate [flags]\fP .SH DESCRIPTION -.PP The "generate" command writes automatically generated files (like the man pages and the auto-completion files for bash, fish and zsh). .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB--bash-completion\fP="" - write bash completion \fBfile\fR + write bash completion \fBfile\fR (\fB-\fR for stdout) .PP \fB--fish-completion\fP="" - write fish completion \fBfile\fR + write fish completion \fBfile\fR (\fB-\fR for stdout) .PP \fB-h\fP, \fB--help\fP[=false] @@ -42,15 +37,14 @@ Exit status is 1 if there was any error. .PP \fB--powershell-completion\fP="" - write powershell completion \fBfile\fR + write powershell completion \fBfile\fR (\fB-\fR for stdout) .PP \fB--zsh-completion\fP="" - write zsh completion \fBfile\fR + write zsh completion \fBfile\fR (\fB-\fR for stdout) .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -152,5 +146,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-init.1 b/doc/man/restic-init.1 index 50fa00b71..2f2db28be 100644 --- a/doc/man/restic-init.1 +++ b/doc/man/restic-init.1 @@ -2,28 +2,23 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-init - Initialize a new repository .SH SYNOPSIS -.PP \fBrestic init [flags]\fP .SH DESCRIPTION -.PP The "init" command initializes a new repository. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB--copy-chunker-params\fP[=false] copy chunker parameters from the secondary repository (useful with the copy command) @@ -61,7 +56,6 @@ Exit status is 1 if there was any error. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -163,5 +157,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-key-add.1 b/doc/man/restic-key-add.1 index ff33408b4..49d65169a 100644 --- a/doc/man/restic-key-add.1 +++ b/doc/man/restic-key-add.1 @@ -2,22 +2,18 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-key-add - Add a new key (password) to the repository; returns the new key ID .SH SYNOPSIS -.PP \fBrestic key add [flags]\fP .SH DESCRIPTION -.PP The "add" sub-command creates a new key and validates the key. Returns the new key ID. .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. @@ -26,7 +22,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for add @@ -48,7 +43,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -150,5 +144,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-key(1)\fP diff --git a/doc/man/restic-key-list.1 b/doc/man/restic-key-list.1 index 7deb05793..d14b4e1fe 100644 --- a/doc/man/restic-key-list.1 +++ b/doc/man/restic-key-list.1 @@ -2,24 +2,20 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-key-list - List keys (passwords) .SH SYNOPSIS -.PP \fBrestic key list [flags]\fP .SH DESCRIPTION -.PP The "list" sub-command lists all the keys (passwords) associated with the repository. Returns the key ID, username, hostname, created time and if it's the current key being used to access the repository. .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. @@ -28,13 +24,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for list .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -136,5 +130,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-key(1)\fP diff --git a/doc/man/restic-key-passwd.1 b/doc/man/restic-key-passwd.1 index 68e81edd9..b70ea7c8b 100644 --- a/doc/man/restic-key-passwd.1 +++ b/doc/man/restic-key-passwd.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-key-passwd - Change key (password); creates a new key ID and removes the old key ID, returns new key ID .SH SYNOPSIS -.PP \fBrestic key passwd [flags]\fP .SH DESCRIPTION -.PP The "passwd" sub-command creates a new key, validates the key and remove the old key ID. Returns the new key ID. .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. @@ -27,7 +23,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for passwd @@ -49,7 +44,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -151,5 +145,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-key(1)\fP diff --git a/doc/man/restic-key-remove.1 b/doc/man/restic-key-remove.1 index ff1a0ceb9..daf9c97b5 100644 --- a/doc/man/restic-key-remove.1 +++ b/doc/man/restic-key-remove.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-key-remove - Remove key ID (password) from the repository. .SH SYNOPSIS -.PP \fBrestic key remove [ID] [flags]\fP .SH DESCRIPTION -.PP The "remove" sub-command removes the selected key ID. The "remove" command does not allow removing the current key being used to access the repository. .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. @@ -27,13 +23,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for remove .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -135,5 +129,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-key(1)\fP diff --git a/doc/man/restic-key.1 b/doc/man/restic-key.1 index 4fd1f6caf..101e0960a 100644 --- a/doc/man/restic-key.1 +++ b/doc/man/restic-key.1 @@ -2,29 +2,24 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-key - Manage keys (passwords) .SH SYNOPSIS -.PP \fBrestic key [flags]\fP .SH DESCRIPTION -.PP The "key" command allows you to set multiple access keys or passwords per repository. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for key .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -126,5 +121,4 @@ per repository. .SH SEE ALSO -.PP \fBrestic(1)\fP, \fBrestic-key-add(1)\fP, \fBrestic-key-list(1)\fP, \fBrestic-key-passwd(1)\fP, \fBrestic-key-remove(1)\fP diff --git a/doc/man/restic-list.1 b/doc/man/restic-list.1 index 29945e859..b585aca49 100644 --- a/doc/man/restic-list.1 +++ b/doc/man/restic-list.1 @@ -2,22 +2,18 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-list - List objects in the repository .SH SYNOPSIS -.PP \fBrestic list [flags] [blobs|packs|index|snapshots|keys|locks]\fP .SH DESCRIPTION -.PP The "list" command allows listing objects in the repository based on type. .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. @@ -26,13 +22,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for list .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -134,5 +128,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-ls.1 b/doc/man/restic-ls.1 index b990d2ec8..4e83d2f1a 100644 --- a/doc/man/restic-ls.1 +++ b/doc/man/restic-ls.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-ls - List files in a snapshot .SH SYNOPSIS -.PP \fBrestic ls [flags] snapshotID [dir...]\fP .SH DESCRIPTION -.PP The "ls" command lists files and directories in a snapshot. .PP @@ -30,9 +27,13 @@ will allow traversing into matching directories' subfolders. Any directory paths specified must be absolute (starting with a path separator); paths use the forward slash '/' as separator. +.PP +File listings can be sorted by specifying --sort followed by one of the +sort specifiers '(name|size|time=mtime|atime|ctime|extension)'. +The sorting can be reversed by specifying --reverse. + .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. @@ -41,7 +42,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for ls @@ -69,13 +69,20 @@ Exit status is 12 if the password is incorrect. \fB--recursive\fP[=false] include files in subfolders of the listed directories +.PP +\fB--reverse\fP[=false] + reverse sorted output + +.PP +\fB-s\fP, \fB--sort\fP=name + sort output by (name|size|time=mtime|atime|ctime|extension) + .PP \fB--tag\fP=[] only consider snapshots including \fBtag[,tag,...]\fR, when snapshot ID "latest" is given (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) @@ -177,5 +184,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-migrate.1 b/doc/man/restic-migrate.1 index c0fa2dbc1..a85f65b0e 100644 --- a/doc/man/restic-migrate.1 +++ b/doc/man/restic-migrate.1 @@ -2,24 +2,20 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-migrate - Apply migrations .SH SYNOPSIS -.PP \fBrestic migrate [flags] [migration name] [...]\fP .SH DESCRIPTION -.PP The "migrate" command checks which migrations can be applied for a repository and prints a list with available migration names. If one or more migration names are specified, these migrations are applied. .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. @@ -28,7 +24,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-f\fP, \fB--force\fP[=false] apply a migration a second time @@ -38,7 +33,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -140,5 +134,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-mount.1 b/doc/man/restic-mount.1 index 5ec59391d..d75f04ee3 100644 --- a/doc/man/restic-mount.1 +++ b/doc/man/restic-mount.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-mount - Mount the repository .SH SYNOPSIS -.PP \fBrestic mount [flags] mountpoint\fP .SH DESCRIPTION -.PP The "mount" command mounts the repository via fuse to a directory. This is a read-only mount. .SH Snapshot Directories -.PP If you need a different template for directories that contain snapshots, you can pass a time template via --time-template and path templates via --path-template. @@ -59,7 +55,6 @@ The default path templates are: .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. @@ -68,7 +63,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB--allow-other\fP[=false] allow other users to access the data in the mounted directory @@ -106,7 +100,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -208,5 +201,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-options.1 b/doc/man/restic-options.1 index 8ea8bea63..f22aa7b1a 100644 --- a/doc/man/restic-options.1 +++ b/doc/man/restic-options.1 @@ -2,34 +2,28 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-options - Print list of extended options .SH SYNOPSIS -.PP \fBrestic options [flags]\fP .SH DESCRIPTION -.PP The "options" command prints a list of extended options. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for options .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -131,5 +125,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-prune.1 b/doc/man/restic-prune.1 index 1ee262b61..a09735be6 100644 --- a/doc/man/restic-prune.1 +++ b/doc/man/restic-prune.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-prune - Remove unneeded data from the repository .SH SYNOPSIS -.PP \fBrestic prune [flags]\fP .SH DESCRIPTION -.PP The "prune" command checks the repository and removes data that is not referenced and therefore not needed any more. .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. @@ -27,7 +23,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-n\fP, \fB--dry-run\fP[=false] do not modify the repository, just print what would be done @@ -37,7 +32,7 @@ Exit status is 12 if the password is incorrect. .PP \fB--max-repack-size\fP="" - maximum \fBsize\fR to repack (allowed suffixes: k/K, m/M, g/G, t/T) + stop after repacking this much data in total (allowed suffixes for \fBsize\fR: k/K, m/M, g/G, t/T) .PP \fB--max-unused\fP="5%" @@ -51,6 +46,10 @@ Exit status is 12 if the password is incorrect. \fB--repack-small\fP[=false] repack pack files below 80% of target pack size +.PP +\fB--repack-smaller-than\fP="" + pack \fBbelow-limit\fR packfiles (allowed suffixes: k/K, m/M) + .PP \fB--repack-uncompressed\fP[=false] repack all uncompressed data @@ -61,7 +60,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -163,5 +161,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-recover.1 b/doc/man/restic-recover.1 index 382a91ceb..73ea9cca2 100644 --- a/doc/man/restic-recover.1 +++ b/doc/man/restic-recover.1 @@ -2,24 +2,20 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-recover - Recover data from the repository not referenced by snapshots .SH SYNOPSIS -.PP \fBrestic recover [flags]\fP .SH DESCRIPTION -.PP The "recover" command builds a new snapshot from all directories it can find in the raw data of the repository which are not referenced in an existing snapshot. It can be used if, for example, a snapshot has been removed by accident with "forget". .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. @@ -28,13 +24,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for recover .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -136,5 +130,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-repair-index.1 b/doc/man/restic-repair-index.1 index 341f90d59..5a49f5440 100644 --- a/doc/man/restic-repair-index.1 +++ b/doc/man/restic-repair-index.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-repair-index - Build a new index .SH SYNOPSIS -.PP \fBrestic repair index [flags]\fP .SH DESCRIPTION -.PP The "repair index" command creates a new index based on the pack files in the repository. .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. @@ -27,7 +23,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for index @@ -37,7 +32,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -139,5 +133,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-repair(1)\fP diff --git a/doc/man/restic-repair-packs.1 b/doc/man/restic-repair-packs.1 index d0091725b..a463b87a8 100644 --- a/doc/man/restic-repair-packs.1 +++ b/doc/man/restic-repair-packs.1 @@ -2,23 +2,19 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-repair-packs - Salvage damaged pack files .SH SYNOPSIS -.PP \fBrestic repair packs [packIDs...] [flags]\fP .SH DESCRIPTION -.PP The "repair packs" command extracts intact blobs from the specified pack files, rebuilds the index to remove the damaged pack files and removes the pack files from the repository. .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. @@ -27,13 +23,11 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for packs .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -135,5 +129,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-repair(1)\fP diff --git a/doc/man/restic-repair-snapshots.1 b/doc/man/restic-repair-snapshots.1 index d9e12ddf1..66c513b66 100644 --- a/doc/man/restic-repair-snapshots.1 +++ b/doc/man/restic-repair-snapshots.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-repair-snapshots - Repair snapshots .SH SYNOPSIS -.PP \fBrestic repair snapshots [flags] [snapshot ID] [...]\fP .SH DESCRIPTION -.PP The "repair snapshots" command repairs broken snapshots. It scans the given snapshots and generates new ones with damaged directories and file contents removed. If the broken snapshots are deleted, a prune run will be able to @@ -24,7 +21,6 @@ first! .SH WARNING -.PP Repairing and deleting broken snapshots causes data loss! It will remove broken directories and modify broken files in the modified snapshots. @@ -36,7 +32,6 @@ snapshot! .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. @@ -45,7 +40,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 @@ -71,7 +65,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -173,5 +166,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic-repair(1)\fP diff --git a/doc/man/restic-repair.1 b/doc/man/restic-repair.1 index b06562486..f3d8a3318 100644 --- a/doc/man/restic-repair.1 +++ b/doc/man/restic-repair.1 @@ -2,28 +2,23 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-repair - Repair the repository .SH SYNOPSIS -.PP \fBrestic repair [flags]\fP .SH DESCRIPTION -.PP Repair the repository .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for repair .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -125,5 +120,4 @@ Repair the repository .SH SEE ALSO -.PP \fBrestic(1)\fP, \fBrestic-repair-index(1)\fP, \fBrestic-repair-packs(1)\fP, \fBrestic-repair-snapshots(1)\fP diff --git a/doc/man/restic-restore.1 b/doc/man/restic-restore.1 index e9ef4ef94..2f34639e9 100644 --- a/doc/man/restic-restore.1 +++ b/doc/man/restic-restore.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-restore - Extract the data from a snapshot .SH SYNOPSIS -.PP \fBrestic restore [flags] snapshotID\fP .SH DESCRIPTION -.PP The "restore" command extracts the data from a snapshot from the repository to a directory. @@ -26,7 +23,6 @@ syntax, where "subfolder" is a path within the snapshot. .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. @@ -35,7 +31,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB--delete\fP[=false] delete files from target directory if they do not exist in snapshot. Use '--dry-run -vv' to check what would be deleted @@ -51,6 +46,10 @@ Exit status is 12 if the password is incorrect. \fB--exclude-file\fP=[] read exclude patterns from a \fBfile\fR (can be specified multiple times) +.PP +\fB--exclude-xattr\fP=[] + exclude xattr by \fBpattern\fR (can be specified multiple times) + .PP \fB-h\fP, \fB--help\fP[=false] help for restore @@ -83,9 +82,13 @@ Exit status is 12 if the password is incorrect. \fB--include-file\fP=[] read include patterns from a \fBfile\fR (can be specified multiple times) +.PP +\fB--include-xattr\fP=[] + include xattr by \fBpattern\fR (can be specified multiple times) + .PP \fB--overwrite\fP=always - overwrite behavior, one of (always|if-changed|if-newer|never) (default: always) + overwrite behavior, one of (always|if-changed|if-newer|never) .PP \fB--path\fP=[] @@ -109,7 +112,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -211,5 +213,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-rewrite.1 b/doc/man/restic-rewrite.1 index c0d4a7e1a..dc085a8a3 100644 --- a/doc/man/restic-rewrite.1 +++ b/doc/man/restic-rewrite.1 @@ -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 diff --git a/doc/man/restic-self-update.1 b/doc/man/restic-self-update.1 index d475f13cb..59064c6d1 100644 --- a/doc/man/restic-self-update.1 +++ b/doc/man/restic-self-update.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-self-update - Update the restic binary .SH SYNOPSIS -.PP \fBrestic self-update [flags]\fP .SH DESCRIPTION -.PP The command "self-update" downloads the latest stable release of restic from GitHub and replaces the currently running binary. After download, the authenticity of the binary is verified using the GPG signature on the release @@ -20,7 +17,6 @@ files. .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. @@ -29,7 +25,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for self-update @@ -39,7 +34,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -141,5 +135,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-snapshots.1 b/doc/man/restic-snapshots.1 index f59240b44..1f61476e4 100644 --- a/doc/man/restic-snapshots.1 +++ b/doc/man/restic-snapshots.1 @@ -2,22 +2,18 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-snapshots - List all snapshots .SH SYNOPSIS -.PP \fBrestic snapshots [flags] [snapshotID ...]\fP .SH DESCRIPTION -.PP The "snapshots" command lists all snapshots stored in the repository. .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. @@ -26,7 +22,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-c\fP, \fB--compact\fP[=false] use compact output format @@ -56,7 +51,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -158,5 +152,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-stats.1 b/doc/man/restic-stats.1 index 1e6e79dac..1e0c944c6 100644 --- a/doc/man/restic-stats.1 +++ b/doc/man/restic-stats.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-stats - Scan the repository and show basic statistics .SH SYNOPSIS -.PP \fBrestic stats [flags] [snapshot ID] [...]\fP .SH DESCRIPTION -.PP The "stats" command walks one or multiple snapshots in a repository and accumulates statistics about the data stored therein. It reports on the number of unique files and their sizes, according to one of @@ -27,8 +24,6 @@ depending on what you are trying to calculate. .PP The modes are: - -.RS .IP \(bu 2 restore-size: (default) Counts the size of the restored files. .IP \(bu 2 @@ -40,14 +35,11 @@ how many files reference them. .IP \(bu 2 blobs-per-file: A combination of files-by-contents and raw-data. -.RE - .PP Refer to the online manual for more details about each mode. .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. @@ -56,7 +48,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for stats @@ -78,7 +69,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -180,5 +170,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-tag.1 b/doc/man/restic-tag.1 index 89c677867..e7ba784b2 100644 --- a/doc/man/restic-tag.1 +++ b/doc/man/restic-tag.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-tag - Modify tags on snapshots .SH SYNOPSIS -.PP \fBrestic tag [flags] [snapshotID ...]\fP .SH DESCRIPTION -.PP The "tag" command allows you to modify tags on exiting snapshots. .PP @@ -24,7 +21,6 @@ When no snapshotID is given, all snapshots matching the host, tag and path filte .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. @@ -33,7 +29,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS -.PP \fB--add\fP=[] \fBtags\fR which will be added to the existing tags in the format \fBtag[,tag,...]\fR (can be given multiple times) @@ -63,7 +58,6 @@ Exit status is 12 if the password is incorrect. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -165,5 +159,4 @@ Exit status is 12 if the password is incorrect. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-unlock.1 b/doc/man/restic-unlock.1 index 74679ef91..fb709ed57 100644 --- a/doc/man/restic-unlock.1 +++ b/doc/man/restic-unlock.1 @@ -2,28 +2,23 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-unlock - Remove locks other processes created .SH SYNOPSIS -.PP \fBrestic unlock [flags]\fP .SH DESCRIPTION -.PP The "unlock" command removes stale locks that have been created by other restic processes. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for unlock @@ -33,7 +28,6 @@ Exit status is 1 if there was any error. .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -135,5 +129,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic-version.1 b/doc/man/restic-version.1 index 8d5fe6c65..d8244c63b 100644 --- a/doc/man/restic-version.1 +++ b/doc/man/restic-version.1 @@ -2,35 +2,29 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic-version - Print version information .SH SYNOPSIS -.PP \fBrestic version [flags]\fP .SH DESCRIPTION -.PP The "version" command prints detailed information about the build environment and the version of this software. .SH EXIT STATUS -.PP Exit status is 0 if the command was successful. Exit status is 1 if there was any error. .SH OPTIONS -.PP \fB-h\fP, \fB--help\fP[=false] help for version .SH OPTIONS INHERITED FROM PARENT COMMANDS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -132,5 +126,4 @@ Exit status is 1 if there was any error. .SH SEE ALSO -.PP \fBrestic(1)\fP diff --git a/doc/man/restic.1 b/doc/man/restic.1 index bd8009aac..cff43c40d 100644 --- a/doc/man/restic.1 +++ b/doc/man/restic.1 @@ -2,17 +2,14 @@ .TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" "" .SH NAME -.PP restic - Backup and restore files .SH SYNOPSIS -.PP \fBrestic [flags]\fP .SH DESCRIPTION -.PP restic is a backup program which allows saving multiple revisions of files and directories in an encrypted repository stored on different backends. @@ -21,7 +18,6 @@ The full documentation can be found at https://restic.readthedocs.io/ . .SH OPTIONS -.PP \fB--cacert\fP=[] \fBfile\fR to load root certificates from (default: use system certificates or $RESTIC_CACERT) @@ -127,5 +123,4 @@ The full documentation can be found at https://restic.readthedocs.io/ . .SH SEE ALSO -.PP \fBrestic-backup(1)\fP, \fBrestic-cache(1)\fP, \fBrestic-cat(1)\fP, \fBrestic-check(1)\fP, \fBrestic-copy(1)\fP, \fBrestic-diff(1)\fP, \fBrestic-dump(1)\fP, \fBrestic-features(1)\fP, \fBrestic-find(1)\fP, \fBrestic-forget(1)\fP, \fBrestic-generate(1)\fP, \fBrestic-init(1)\fP, \fBrestic-key(1)\fP, \fBrestic-list(1)\fP, \fBrestic-ls(1)\fP, \fBrestic-migrate(1)\fP, \fBrestic-mount(1)\fP, \fBrestic-options(1)\fP, \fBrestic-prune(1)\fP, \fBrestic-recover(1)\fP, \fBrestic-repair(1)\fP, \fBrestic-restore(1)\fP, \fBrestic-rewrite(1)\fP, \fBrestic-self-update(1)\fP, \fBrestic-snapshots(1)\fP, \fBrestic-stats(1)\fP, \fBrestic-tag(1)\fP, \fBrestic-unlock(1)\fP, \fBrestic-version(1)\fP diff --git a/doc/powershell-completion.ps1 b/doc/powershell-completion.ps1 index 033477e7b..674dcd37e 100644 --- a/doc/powershell-completion.ps1 +++ b/doc/powershell-completion.ps1 @@ -125,7 +125,10 @@ filter __restic_escapeStringWithSpecialChars { if (-Not $Description) { $Description = " " } - @{Name="$Name";Description="$Description"} + New-Object -TypeName PSCustomObject -Property @{ + Name = "$Name" + Description = "$Description" + } } @@ -203,7 +206,12 @@ filter __restic_escapeStringWithSpecialChars { __restic_debug "Only one completion left" # insert space after value - [System.Management.Automation.CompletionResult]::new($($comp.Name | __restic_escapeStringWithSpecialChars) + $Space, "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + $CompletionText = $($comp.Name | __restic_escapeStringWithSpecialChars) + $Space + if ($ExecutionContext.SessionState.LanguageMode -eq "FullLanguage"){ + [System.Management.Automation.CompletionResult]::new($CompletionText, "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + } else { + $CompletionText + } } else { # Add the proper number of spaces to align the descriptions @@ -218,7 +226,12 @@ filter __restic_escapeStringWithSpecialChars { $Description = " ($($comp.Description))" } - [System.Management.Automation.CompletionResult]::new("$($comp.Name)$Description", "$($comp.Name)$Description", 'ParameterValue', "$($comp.Description)") + $CompletionText = "$($comp.Name)$Description" + if ($ExecutionContext.SessionState.LanguageMode -eq "FullLanguage"){ + [System.Management.Automation.CompletionResult]::new($CompletionText, "$($comp.Name)$Description", 'ParameterValue', "$($comp.Description)") + } else { + $CompletionText + } } } @@ -227,7 +240,13 @@ filter __restic_escapeStringWithSpecialChars { # insert space after value # MenuComplete will automatically show the ToolTip of # the highlighted value at the bottom of the suggestions. - [System.Management.Automation.CompletionResult]::new($($comp.Name | __restic_escapeStringWithSpecialChars) + $Space, "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + + $CompletionText = $($comp.Name | __restic_escapeStringWithSpecialChars) + $Space + if ($ExecutionContext.SessionState.LanguageMode -eq "FullLanguage"){ + [System.Management.Automation.CompletionResult]::new($CompletionText, "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + } else { + $CompletionText + } } # TabCompleteNext and in case we get something unknown @@ -235,7 +254,13 @@ filter __restic_escapeStringWithSpecialChars { # Like MenuComplete but we don't want to add a space here because # the user need to press space anyway to get the completion. # Description will not be shown because that's not possible with TabCompleteNext - [System.Management.Automation.CompletionResult]::new($($comp.Name | __restic_escapeStringWithSpecialChars), "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + + $CompletionText = $($comp.Name | __restic_escapeStringWithSpecialChars) + if ($ExecutionContext.SessionState.LanguageMode -eq "FullLanguage"){ + [System.Management.Automation.CompletionResult]::new($CompletionText, "$($comp.Name)", 'ParameterValue', "$($comp.Description)") + } else { + $CompletionText + } } }