Also documenting common flags in subcommands

This commit is contained in:
Dennis Schwerdel 2017-05-17 08:58:54 +02:00
parent ca28d3ebff
commit 645022ce9c
23 changed files with 507 additions and 173 deletions

View File

@ -5,6 +5,7 @@ This project follows [semantic versioning](http://semver.org).
### UNRELEASED
* [added] Added `copy` subcommand
* [modified] Also documenting common flags in subcommands
### v0.3.2 (2017-05-11)

View File

@ -23,27 +23,43 @@ key will be set as default encryption key.
## OPTIONS
* `-g`, `--generate`:
* `-g`, `--generate`:
Generate a new key pair
* `-d`, `--default`:
* `-d`, `--default`:
Set the key pair as default
* `-p`, `--password <PASSWORD>`:
* `-p`, `--password <PASSWORD>`:
Derive the key pair from the given password instead of randomly creating it.
This setting requires that `--generate` is set too.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -62,11 +62,26 @@ The options are exactly the same as for _zvault-init(1)_.
values.
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -18,11 +18,26 @@ running _zvault-vacuum(1)_ with different ratios.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -45,7 +45,7 @@ restore and access times change by reading files.
## OPTIONS
* `-e`, `--exclude <PATTERN>...`:
* `-e`, `--exclude <PATTERN>...`:
Exclude this path or file pattern. This option can be given multiple times.
Please see *EXCLUDE PATTERNS* for details on pattern.
@ -53,7 +53,7 @@ restore and access times change by reading files.
This option conflicts with `--tar`.
* `--excludes-from <FILE>`:
* `--excludes-from <FILE>`:
Read the list of excludes from this file.
Please see *EXCLUDE PATTERNS* for details on pattern.
@ -61,7 +61,7 @@ restore and access times change by reading files.
This option conflicts with `--tar`.
* `--full`:
* `--full`:
Create a full backup without using another backup as a reference. This makes
sure that all files in the source path (except excluded files) are fully
@ -71,14 +71,14 @@ restore and access times change by reading files.
This option conflicts with `--ref`.
* `--no-default-excludes`:
* `--no-default-excludes`:
Do not load the default `excludes` file from the repository folder.
Those excludes are pre-filled with generic pattern to exclude like pseudo
filesystems or cache folders.
* `--ref <REF>`:
* `--ref <REF>`:
Base the new backup on this reference backup instead of automatically
selecting a matching one. The backup given as `REF` must be a valid backup
@ -87,7 +87,7 @@ restore and access times change by reading files.
This option conflicts with `--full`.
* `--tar`:
* `--tar`:
Read the source data from a tar archive instead of the filesystem. When this
flag is set, the `SRC` path must specify a valid tar file.
@ -102,7 +102,7 @@ restore and access times change by reading files.
This flag conflicts with `--exclude` and `--excludes_from`.
* `-x`, `--xdev`:
* `-x`, `--xdev`:
Allow to cross filesystem boundaries. By default, paths on different
filesystems than the start path will be ignored. If this flag is set,
@ -113,11 +113,26 @@ restore and access times change by reading files.
in the backup.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## EXCLUDE PATTERNS
Exclude patterns can either be absolute patterns or relative patterns. Absolute

View File

@ -19,11 +19,26 @@ names on the remote storage that do not relate to the bundle id.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -16,11 +16,26 @@ given its bundle id.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -62,32 +62,47 @@ has become inaccessible.
## OPTIONS
* `-b`, `--bundles`:
* `-b`, `--bundles`:
Check the integrity of the bundles too.
* `--bundle-data`:
* `--bundle-data`:
Also check the contents of the bundles by fetching and decompressing them.
Note: This flag causes the check to be much slower.
* `-i`, `--index`:
* `-i`, `--index`:
Also check the integrity of the index and its contents.
* `-r`, `--repair`:
* `-r`, `--repair`:
Try to repair broken bundles, backups and rebuild local data when necessary.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -25,27 +25,27 @@ data and can be changed at any time without any drawback.
## OPTIONS
* `--bundle-size <SIZE>`:
* `--bundle-size <SIZE>`:
Set the target bundle size in MiB (default: 25).
Please see _zvault(1)_ for more information on *bundle size*.
* `--chunker <CHUNKER>`:
* `--chunker <CHUNKER>`:
Set the chunker algorithm and target chunk size (default: fastcdc/16).
Please see _zvault(1)_ for more information on *chunkers* and possible
values.
* `-c`, `--compression <COMPRESSION>`:
* `-c`, `--compression <COMPRESSION>`:
Set the compression method and level (default: brotli/3).
Please see _zvault(1)_ for more information on *compression* and possible
values.
* `-e`, `--encryption <PUBLIC_KEY>`:
* `-e`, `--encryption <PUBLIC_KEY>`:
Use the given public key for encryption. The key must be a valid public key
encoded as hexadecimal. Please use _zvault-genkey(1)_ to generate keys and
@ -59,18 +59,33 @@ data and can be changed at any time without any drawback.
Please see _zvault(1)_ for more information on *encryption*.
* `--hash <HASH>`:
* `--hash <HASH>`:
Set the hash method (default: blake2).
Please see _zvault(1)_ for more information on *hash methods* and possible
values.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -17,11 +17,26 @@ If `repository` is omitted, the default repository location is used instead.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -25,11 +25,26 @@ modified (_mod_).
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -14,15 +14,31 @@ writes it to the given file `FILE`.
## OPTIONS
* `-p`, `--password <PASSWORD>`:
* `-p`, `--password <PASSWORD>`:
Derive the key pair from the given password instead of randomly creating it.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -25,7 +25,7 @@ imported via _zvault-backup(1)_ also with the `--tar` flag.
## OPTIONS
* `-k`, `--key <FILE>...`:
* `-k`, `--key <FILE>...`:
Add the key pair in the given file to the repository before importing the
remote bundles. This option can be used to add keys that are needed to read
@ -33,11 +33,26 @@ imported via _zvault-backup(1)_ also with the `--tar` flag.
times.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -17,11 +17,26 @@ The repository, backup or backup subtree given by `PATH` must be in the format
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -25,50 +25,71 @@ configuration can be changed by _zvault-config(1)_ later.
## OPTIONS
* `--bundle-size <SIZE>`:
* `--bundle-size <SIZE>`:
Set the target bundle size in MiB (default: 25).
Please see zvault(1) for more information on *bundle size*.
* `--chunker <CHUNKER>`:
* `--chunker <CHUNKER>`:
Set the chunker algorithm and target chunk size (default: fastcdc/16).
Please see _zvault(1)_ for more information on *chunkers* and possible
values.
* `-c`, `--compression <COMPRESSION>`:
* `-c`, `--compression <COMPRESSION>`:
Set the compression method and level (default: brotli/3).
Please see _zvault(1)_ for more information on *compression* and possible
values.
* `-e`, `--encrypt`:
* `-e`, `--encrypt`:
Generate a keypair and enable encryption.
Please see _zvault(1)_ for more information on *encryption*.
* `--hash <HASH>`:
* `--hash <HASH>`:
Set the hash method (default: blake2).
Please see _zvault(1)_ for more information on *hash methods* and possible
values.
* `-h`, `--help`:
* `-h`, `--help`:
Prints help information
* `-r`, `--remote <REMOTE>`:
* `-r`, `--remote <REMOTE>`:
Set the path to the mounted remote storage. There should be an empty folder
at this location.
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -28,11 +28,26 @@ filesystem which is faster than _zvault-list(1)_ for multiple listings.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -30,11 +30,26 @@ this way is slower than using _zvault-restore(1)_.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -52,41 +52,56 @@ data of the deleted backups becomes inaccessible and can not be restored.**
## OPTIONS
* `-p`, `--prefix <PREFIX>`:
* `-p`, `--prefix <PREFIX>`:
Only consider backups starting with this prefix.
* `-d`, `--daily <NUM>`:
* `-d`, `--daily <NUM>`:
Keep the newest backup for each of the last `NUM` days.
* `-w`, `--weekly <NUM>`:
* `-w`, `--weekly <NUM>`:
Keep the newest backup for each of the last `NUM` weeks.
* `-m`, `--monthly <NUM>`:
* `-m`, `--monthly <NUM>`:
Keep the newest backup for each of the last `NUM` months.
* `-y`, `--yearly <NUM>`:
* `-y`, `--yearly <NUM>`:
Keep the newest backup for each of the last `NUM` years.
* `-f`, `--force`:
* `-f`, `--force`:
Actually remove backups instead of displaying what would be removed.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -35,16 +35,31 @@ data of the deleted backups becomes inaccessible and can not be restored.**
## OPTIONS
* `-f`, `--force`:
* `-f`, `--force`:
Remove multiple backups in a backup folder
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -23,7 +23,7 @@ If `--tar` is not set, the data will be written into the existing folder `DST`.
## OPTIONS
* `--tar`:
* `--tar`:
Write the backup to a tar archive named `DST` instead of creating files and
folders at this location.
@ -32,11 +32,26 @@ If `--tar` is not set, the data will be written into the existing folder `DST`.
zvault-backup(1) with the `--tar` flag.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -43,27 +43,42 @@ should be avoided when the storage space permits it.
## OPTIONS
* `--combine`:
* `--combine`:
Also combine small bundles into larger ones.
* `-r`, `--ratio <NUM>`:
* `-r`, `--ratio <NUM>`:
Do not rewrite bundles with more than `NUM`% of used chunks.
The ratio must be given in whole percentage, e.g. 50 mean 50%.
* `-f`, `--force`:
* `-f`, `--force`:
Actually run the vacuum instead of simulating it.
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -20,11 +20,26 @@ earliest backup that version appeared in.
## OPTIONS
* `-h`, `--help`:
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
## COPYRIGHT
Copyright (C) 2017 Dennis Schwerdel

View File

@ -18,6 +18,16 @@ location.
## OPTIONS
* `-q`, `--quiet`:
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information