KurlesHS/restic
1
0
Fork 0
forked from TrueCloudLab/restic
Code Pull requests Activity

Update doc excerpts for --help

Browse source 
This adds some previously missing changes and the new paramters names
from the previous commit.
This commit is contained in:
Michael Eischer 2020-04-03 19:46:30 +02:00
parent bc74cd3ae5
commit 6bee62e346
2 changed files with 63 additions and 49 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc/020_installation.rst
View file

@ -288,7 +288,7 @@ Restic can write out man pages and bash/zsh compatible autocompletion scripts:
$ ./restic generate --help $ ./restic generate --help
The "generate" command writes automatically generated files like the man pages The "generate" command writes automatically generated files (like the man pages
and the auto-completion files for bash and zsh). and the auto-completion files for bash and zsh).
Usage: Usage:

110
doc/manual_rest.rst
View file

@ -22,7 +22,7 @@ Usage help is available:
check Check the repository for errors check Check the repository for errors
diff Show differences between two snapshots diff Show differences between two snapshots
dump Print a backed-up file to stdout dump Print a backed-up file to stdout
find Find a file or directory find Find a file, a directory or restic IDs
forget Remove snapshots from the repository forget Remove snapshots from the repository
generate Generate manual pages and auto-completion files (bash, zsh) generate Generate manual pages and auto-completion files (bash, zsh)
help Help about any command help Help about any command
@ -34,30 +34,33 @@ Usage help is available:
mount Mount the repository mount Mount the repository
prune Remove unneeded data from the repository prune Remove unneeded data from the repository
rebuild-index Build a new index file rebuild-index Build a new index file
recover Recover data from the repository
restore Extract the data from a snapshot restore Extract the data from a snapshot
self-update Update the restic binary
snapshots List all snapshots snapshots List all snapshots
stats Count up sizes and show information about repository data stats Scan the repository and show basic statistics
tag Modify tags on snapshots tag Modify tags on snapshots
unlock Remove locks other processes created unlock Remove locks other processes created
version Print version information version Print version information
Flags: Flags:
--cacert file file to load root certificates from (default: use system certificates) --cacert file file to load root certificates from (default: use system certificates)
--cache-dir string set the cache directory. (default: use system default cache directory) --cache-dir directory set the cache directory. (default: use system default cache directory)
--cleanup-cache auto remove old cache directories --cleanup-cache auto remove old cache directories
-h, --help help for restic -h, --help help for restic
--json set output mode to JSON for commands that support it --json set output mode to JSON for commands that support it
--key-hint string key ID of key to try decrypting first (default: $RESTIC_KEY_HINT) --key-hint key key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
--limit-download int limits downloads to a maximum rate in KiB/s. (default: unlimited) --limit-download int limits downloads to a maximum rate in KiB/s. (default: unlimited)
--limit-upload int limits uploads to a maximum rate in KiB/s. (default: unlimited) --limit-upload int limits uploads to a maximum rate in KiB/s. (default: unlimited)
--no-cache do not use a local cache --no-cache do not use a local cache
--no-lock do not lock the repo, this allows some operations on read-only repos --no-lock do not lock the repo, this allows some operations on read-only repos
-o, --option key=value set extended option (key=value, can be specified multiple times) -o, --option key=value set extended option (key=value, can be specified multiple times)
-p, --password-file string read the repository password from a file (default: $RESTIC_PASSWORD_FILE) --password-command command specify a shell command to obtain a password (default: $RESTIC_PASSWORD_COMMAND)
-q, --quiet do not output comprehensive progress report -p, --password-file file read the repository password from a file (default: $RESTIC_PASSWORD_FILE)
-r, --repo string repository to backup to or restore from (default: $RESTIC_REPOSITORY) -q, --quiet do not output comprehensive progress report
--tls-client-cert string path to a file containing PEM encoded TLS client certificate and private key -r, --repo repository repository to backup to or restore from (default: $RESTIC_REPOSITORY)
-v, --verbose n[=-1] be verbose (specify --verbose multiple times or level n) --tls-client-cert file path to a file containing PEM encoded TLS client certificate and private key
-v, --verbose n be verbose (specify --verbose multiple times or level n)
Use "restic [command] --help" for more information about a command. Use "restic [command] --help" for more information about a command.
@ -73,42 +76,53 @@ command:
The "backup" command creates a new snapshot and saves the files and directories The "backup" command creates a new snapshot and saves the files and directories
given as the arguments. given as the arguments.
EXIT STATUS
===========
Exit status is 0 if the command was successful, and non-zero if there was any error.
Note that some issues such as unreadable or deleted files during backup
currently doesn't result in a non-zero error exit status.
Usage: Usage:
restic backup [flags] FILE/DIR [FILE/DIR] ... restic backup [flags] FILE/DIR [FILE/DIR] ...
Flags: Flags:
-e, --exclude pattern exclude a pattern (can be specified multiple times) -e, --exclude pattern exclude a pattern (can be specified multiple times)
--exclude-caches excludes cache directories that are marked with a CACHEDIR.TAG file. See http://bford.info/cachedir/spec.html for the Cache Directory Tagging Standard --exclude-caches excludes cache directories that are marked with a CACHEDIR.TAG file. See http://bford.info/cachedir/spec.html for the Cache Directory Tagging Standard
--exclude-file file read exclude patterns from a file (can be specified multiple times) --exclude-file file read exclude patterns from a file (can be specified multiple times)
--exclude-if-present stringArray takes filename[:header], exclude contents of directories containing filename (except filename itself) if header of that file is as provided (can be specified multiple times) --exclude-if-present filename[:header] takes filename[:header], exclude contents of directories containing filename (except filename itself) if header of that file is as provided (can be specified multiple times)
--files-from string read the files to backup from file (can be combined with file args/can be specified multiple times) --files-from file read the files to backup from file (can be combined with file args/can be specified multiple times)
-f, --force force re-reading the target files/directories (overrides the "parent" flag) -f, --force force re-reading the target files/directories (overrides the "parent" flag)
-h, --help help for backup -h, --help help for backup
--hostname hostname set the hostname for the snapshot manually. To prevent an expensive rescan use the "parent" flag -H, --host hostname set the hostname for the snapshot manually. To prevent an expensive rescan use the "parent" flag
-x, --one-file-system exclude other file systems --iexclude pattern same as --exclude pattern but ignores the casing of filenames
--parent string use this parent snapshot (default: last snapshot in the repo that has the same target files/directories) --ignore-inode ignore inode number changes when checking for modified files
--stdin read backup from stdin -x, --one-file-system exclude other file systems
--stdin-filename string file name to use when reading from stdin (default "stdin") --parent snapshot use this parent snapshot (default: last snapshot in the repo that has the same target files/directories)
--tag tag add a tag for the new snapshot (can be specified multiple times) --stdin read backup from stdin
--time string time of the backup (ex. '2012-11-01 22:08:41') (default: now) --stdin-filename filename filename to use when reading from stdin (default "stdin")
--with-atime store the atime for all files and directories --tag tag add a tag for the new snapshot (can be specified multiple times)
--time time time of the backup (ex. '2012-11-01 22:08:41') (default: now)
--with-atime store the atime for all files and directories
Global Flags: Global Flags:
--cacert file file to load root certificates from (default: use system certificates) --cacert file file to load root certificates from (default: use system certificates)
--cache-dir string set the cache directory. (default: use system default cache directory) --cache-dir directory set the cache directory. (default: use system default cache directory)
--cleanup-cache auto remove old cache directories --cleanup-cache auto remove old cache directories
--json set output mode to JSON for commands that support it --json set output mode to JSON for commands that support it
--key-hint string key ID of key to try decrypting first (default: $RESTIC_KEY_HINT) --key-hint key key ID of key to try decrypting first (default: $RESTIC_KEY_HINT)
--limit-download int limits downloads to a maximum rate in KiB/s. (default: unlimited) --limit-download int limits downloads to a maximum rate in KiB/s. (default: unlimited)
--limit-upload int limits uploads to a maximum rate in KiB/s. (default: unlimited) --limit-upload int limits uploads to a maximum rate in KiB/s. (default: unlimited)
--no-cache do not use a local cache --no-cache do not use a local cache
--no-lock do not lock the repo, this allows some operations on read-only repos --no-lock do not lock the repo, this allows some operations on read-only repos
-o, --option key=value set extended option (key=value, can be specified multiple times) -o, --option key=value set extended option (key=value, can be specified multiple times)
-p, --password-file string read the repository password from a file (default: $RESTIC_PASSWORD_FILE) --password-command command specify a shell command to obtain a password (default: $RESTIC_PASSWORD_COMMAND)
-q, --quiet do not output comprehensive progress report -p, --password-file file read the repository password from a file (default: $RESTIC_PASSWORD_FILE)
-r, --repo string repository to backup to or restore from (default: $RESTIC_REPOSITORY) -q, --quiet do not output comprehensive progress report
--tls-client-cert string path to a file containing PEM encoded TLS client certificate and private key -r, --repo repository repository to backup to or restore from (default: $RESTIC_REPOSITORY)
-v, --verbose n[=-1] be verbose (specify --verbose multiple times or level n) --tls-client-cert file path to a file containing PEM encoded TLS client certificate and private key
-v, --verbose n be verbose (specify --verbose multiple times or level n)
Subcommand that support showing progress information such as ``backup``, Subcommand that support showing progress information such as ``backup``,
``check`` and ``prune`` will do so unless the quiet flag ``-q`` or ``check`` and ``prune`` will do so unless the quiet flag ``-q`` or