borg/docs/usage.rst

148 lines
3.8 KiB
ReStructuredText

.. _usage_darc_init:
darc init
~~~~~~~~~
::
usage: darc init [-h] [-v] [--key-file] [--passphrase] repository
Initialize a new repository
positional arguments:
repository repository to create
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
--key-file enable key file based encryption
--passphrase enable passphrase based encryption
.. _usage_darc_create:
darc create
~~~~~~~~~~~
::
usage: darc create [-h] [-v] [-s] [-e PATTERN] [-c SECONDS]
[--do-not-cross-mountpoints] [--numeric-owner]
ARCHIVE PATH [PATH ...]
Create new archive
positional arguments:
ARCHIVE archive to create
PATH paths to archive
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
-s, --stats print statistics for the created archive
-e PATTERN, --exclude PATTERN
exclude paths matching PATTERN
-c SECONDS, --checkpoint-interval SECONDS
write checkpointe ever SECONDS seconds (Default: 300)
--do-not-cross-mountpoints
do not cross mount points
--numeric-owner only store numeric user and group identifiers
.. _usage_darc_extract:
darc extract
~~~~~~~~~~~~
::
usage: darc extract [-h] [-v] [-e PATTERN] [--numeric-owner]
ARCHIVE [PATH [PATH ...]]
Extract archive contents
positional arguments:
ARCHIVE archive to extract
PATH paths to extract
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
-e PATTERN, --exclude PATTERN
exclude paths matching PATTERN
--numeric-owner only obey numeric user and group identifiers
.. _usage_darc_delete:
darc delete
~~~~~~~~~~~
::
usage: darc delete [-h] [-v] ARCHIVE
Delete archive
positional arguments:
ARCHIVE archive to delete
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
.. _usage_darc_prune:
darc prune
~~~~~~~~~~
::
usage: darc prune [-h] [-v] [-H HOURLY] [-d DAILY] [-w WEEKLY] [-m MONTHLY]
[-y YEARLY] [-p PREFIX]
REPOSITORY
Prune repository archives according to specified rules
positional arguments:
REPOSITORY repository to prune
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
-H HOURLY, --hourly HOURLY
number of hourly archives to keep
-d DAILY, --daily DAILY
number of daily archives to keep
-w WEEKLY, --weekly WEEKLY
number of daily archives to keep
-m MONTHLY, --monthly MONTHLY
number of monthly archives to keep
-y YEARLY, --yearly YEARLY
number of yearly archives to keep
-p PREFIX, --prefix PREFIX
only consider archive names starting with this prefix
.. _usage_darc_verify:
darc verify
~~~~~~~~~~~
::
usage: darc verify [-h] [-v] [-e PATTERN] ARCHIVE [PATH [PATH ...]]
Verify archive consistency
positional arguments:
ARCHIVE archive to verity integrity of
PATH paths to verify
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output
-e PATTERN, --exclude PATTERN
exclude paths matching PATTERN
.. _usage_darc_change-passphrase:
darc change-passphrase
~~~~~~~~~~~-~~~~~~~~~~
::
usage: darc change-passphrase [-h] [-v] repository
Change passphrase on repository key file
positional arguments:
repository
optional arguments:
-h, --help show this help message and exit
-v, --verbose verbose output