mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-24 00:37:56 +00:00
ce92960c63
also: move a bit upwards in the use docs
(cherry picked from commit 278ed640e9
)
73 lines
No EOL
3.7 KiB
HTML
73 lines
No EOL
3.7 KiB
HTML
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
.. _borg_config:
|
|
|
|
borg config
|
|
-----------
|
|
.. code-block:: none
|
|
|
|
borg [common options] config [options] REPOSITORY NAME [VALUE]
|
|
|
|
.. only:: html
|
|
|
|
.. class:: borg-options-table
|
|
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| **positional arguments** |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| | ``REPOSITORY`` | repository to configure |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| | ``NAME`` | name of config key |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| | ``VALUE`` | new value for key |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| **optional arguments** |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| | ``-c``, ``--cache`` | get and set values from the repo cache |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| | ``-d``, ``--delete`` | delete the key from the config file |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
| .. class:: borg-common-opt-ref |
|
|
| |
|
|
| :ref:`common_options` |
|
|
+-------------------------------------------------------+----------------------+----------------------------------------+
|
|
|
|
.. raw:: html
|
|
|
|
<script type='text/javascript'>
|
|
$(document).ready(function () {
|
|
$('.borg-options-table colgroup').remove();
|
|
})
|
|
</script>
|
|
|
|
.. only:: latex
|
|
|
|
REPOSITORY
|
|
repository to configure
|
|
NAME
|
|
name of config key
|
|
VALUE
|
|
new value for key
|
|
|
|
|
|
optional arguments
|
|
-c, --cache get and set values from the repo cache
|
|
-d, --delete delete the key from the config file
|
|
|
|
|
|
:ref:`common_options`
|
|
|
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
This command gets and sets options in a local repository or cache config file.
|
|
For security reasons, this command only works on local repositories.
|
|
|
|
To delete a config value entirely, use ``--delete``. To get an existing key, pass
|
|
only the key name. To set a key, pass both the key name and the new value. Keys
|
|
can be specified in the format "section.name" or simply "name"; the section will
|
|
default to "repository" and "cache" for the repo and cache configs, respectively.
|
|
|
|
By default, borg config manipulates the repository config file. Using ``--cache``
|
|
edits the repository cache's config file instead. |