zvault/docs/man/zvault-config.1.md

93 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2017-04-05 14:02:16 +00:00
zvault-config(1) -- Display or change the configuration
=======================================================
## SYNOPSIS
2017-04-07 16:57:49 +00:00
`zvault config <REPO>`
2017-04-05 14:02:16 +00:00
## DESCRIPTION
This subcommand displays or changes the configuration of the repository `REPO`.
The configuration can be changes using the options described below. If no
options are set, the current configuration is displayed. Otherwise, the
configuration is changed as specified and then displayed.
Beware that the *chunker algorithm*, *chunk size* and *hash method* should not
be changed on existing repositories already containing many backups. If those
values are changed, new backups will not be able to use existing data for
deduplication. This can waste lots of storage space and most likely outweighs
the expected benefits.
The values for *bundle size*, *compression* and *encryption* only affect new
data and can be changed at any time without any drawback.
## OPTIONS
* `--bundle-size <SIZE>`:
2017-04-05 14:02:16 +00:00
Set the target bundle size in MiB (default: 25).
Please see _zvault(1)_ for more information on *bundle size*.
2017-04-05 14:02:16 +00:00
* `--chunker <CHUNKER>`:
2017-04-05 14:02:16 +00:00
Set the chunker algorithm and target chunk size (default: fastcdc/16).
Please see _zvault(1)_ for more information on *chunkers* and possible
values.
2017-04-05 14:02:16 +00:00
* `-c`, `--compression <COMPRESSION>`:
2017-04-05 14:02:16 +00:00
Set the compression method and level (default: brotli/3).
Please see _zvault(1)_ for more information on *compression* and possible
values.
2017-04-05 14:02:16 +00:00
* `-e`, `--encryption <PUBLIC_KEY>`:
2017-04-05 14:02:16 +00:00
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
_zvault-addkey(1)_ to add keys to the repository.
2017-04-05 14:02:16 +00:00
If `none` is given as public key, encryption is deactivated.
2017-04-05 14:02:16 +00:00
**Warning:** ZVault does not verify that the matching secret key which is
needed for decryption is known.
2017-04-05 14:02:16 +00:00
Please see _zvault(1)_ for more information on *encryption*.
2017-04-05 14:02:16 +00:00
* `--hash <HASH>`:
2017-04-05 14:02:16 +00:00
Set the hash method (default: blake2).
Please see _zvault(1)_ for more information on *hash methods* and possible
values.
2017-04-05 14:02:16 +00:00
* `-q`, `--quiet`:
2017-04-05 14:02:16 +00:00
Print less information
* `-v`, `--verbose`:
Print more information
* `-h`, `--help`:
Prints help information
* `-V`, `--version`:
Prints version information
2017-04-05 14:02:16 +00:00
## COPYRIGHT
2018-03-03 16:25:38 +00:00
Copyright (C) 2017-2018 Dennis Schwerdel
2017-04-05 14:02:16 +00:00
This software is licensed under GPL-3 or newer (see LICENSE.md)