borgbackup/docs/usage/general.rst

General
-------

Borg consists of a number of commands. Each command accepts
a number of arguments and options and interprets various environment variables.
The following sections will describe each command in detail.

Commands, options, parameters, paths, and similar elements are shown in ``fixed-width``.
Option values are `underlined. Borg has a few options that accept a fixed set
of values (e.g., ``--encryption`` of :ref:`borg_repo-create`).

.. container:: experimental

   Experimental features are marked with red stripes on the sides, like this paragraph.

   Experimental features are not stable, which means that they may be changed in incompatible
   ways or even removed entirely without prior notice in following releases.

.. include:: usage_general.rst.inc

If you are interested in more details (such as formulas), see
:ref:`internals`. For details on the available JSON output, refer to
:ref:`json_output`.

.. _common_options:

Common options
~~~~~~~~~~~~~~

All Borg commands share these options:

.. include:: common-options.rst.inc

Option ``--help`` when used as a command works as expected on subcommands (e.g., ``borg help compact``).
But it does not work when the help command is used on sub-sub-commands (e.g., ``borg help key export``).
The workaround for this is to use the help command as a flag (e.g., ``borg key export --help``).

Examples
~~~~~~~~
::

    # Create an archive and log: borg version, files list, return code
    $ borg -r /path/to/repo create --show-version --list --show-rc my-files files