mirror of
https://github.com/restic/restic.git
synced 2026-05-21 01:25:24 +00:00
doc: correctly use RST backticks
RST uses double backticks for inline code unlike the single backticks in Markdown.
This commit is contained in:
@@ -268,7 +268,7 @@ Docker container
|
||||
****************
|
||||
|
||||
A minimal Docker image with just a few files and the restic
|
||||
binary is available; you can get it with `docker pull` like this:
|
||||
binary is available; you can get it with ``docker pull`` like this:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
@@ -281,7 +281,7 @@ The container is also available on the GitHub Container Registry:
|
||||
$ docker pull ghcr.io/restic/restic
|
||||
|
||||
Restic relies on the hostname for various operations. Make sure to set a static
|
||||
hostname using `--hostname` when creating a Docker container, otherwise Docker
|
||||
hostname using ``--hostname`` when creating a Docker container, otherwise Docker
|
||||
will assign a random hostname each time.
|
||||
|
||||
The container additionally honors traditional ``nice`` `(man page) <https://man7.org/linux/man-pages/man1/nice.1.html>`__ and ``ionice`` `(man page) <https://man7.org/linux/man-pages/man1/ionice.1.html#OPTIONS>`__ directives via the following environment variables.
|
||||
|
||||
@@ -89,7 +89,7 @@ command and enter the same password twice:
|
||||
On Linux, storing the backup repository on a CIFS (SMB) share or backing up
|
||||
data from a CIFS share is not recommended due to compatibility issues in
|
||||
older Linux kernels. Either use another backend or set the environment
|
||||
variable `GODEBUG` to `asyncpreemptoff=1`. Refer to GitHub issue
|
||||
variable ``GODEBUG`` to ``asyncpreemptoff=1``. Refer to GitHub issue
|
||||
:issue:`2659` for further explanations.
|
||||
|
||||
SFTP
|
||||
|
||||
+1
-1
@@ -508,7 +508,7 @@ include other filesystems like ``/sys`` and ``/proc``.
|
||||
.. note:: ``--one-file-system`` is currently unsupported on Windows, and will
|
||||
cause the backup to immediately fail with an error.
|
||||
|
||||
Files larger than a given size can be excluded using the `--exclude-larger-than`
|
||||
Files larger than a given size can be excluded using the ``--exclude-larger-than``
|
||||
option:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
@@ -265,7 +265,7 @@ or the environment variable ``$RESTIC_FROM_KEY_HINT``.
|
||||
repository. You can avoid this limitation by using the rclone backend
|
||||
along with remotes which are configured in rclone.
|
||||
|
||||
.. note:: If `copy` is aborted, `copy` will resume the interrupted copying when it is run again. It's possible that up to 10 minutes of progress can be lost because the repository index is only updated from time to time.
|
||||
.. note:: If ``copy`` is aborted, ``copy`` will resume the interrupted copying when it is run again. It's possible that up to 10 minutes of progress can be lost because the repository index is only updated from time to time.
|
||||
|
||||
.. _copy-filtering-snapshots:
|
||||
|
||||
@@ -447,7 +447,7 @@ detect this and yield the same error as when you tried to restore:
|
||||
load indexes
|
||||
error: error loading index de30f3231ca2e6a59af4aa84216dfe2ef7339c549dc11b09b84000997b139628: LoadRaw(<index/de30f3231c>): invalid data returned
|
||||
|
||||
The repository index is damaged and must be repaired. You must run `restic repair index' to correct this.
|
||||
The repository index is damaged and must be repaired. You must run ``restic repair index`` to correct this.
|
||||
|
||||
Fatal: repository contains errors
|
||||
|
||||
|
||||
@@ -48,8 +48,8 @@ CPU usage
|
||||
=========
|
||||
|
||||
By default, restic uses all available CPU cores. You can set the environment variable
|
||||
`GOMAXPROCS` to limit the number of used CPU cores. For example to use a single CPU core,
|
||||
use `GOMAXPROCS=1`. Limiting the number of usable CPU cores can slightly reduce the memory
|
||||
``GOMAXPROCS`` to limit the number of used CPU cores. For example to use a single CPU core,
|
||||
use ``GOMAXPROCS=1``. Limiting the number of usable CPU cores can slightly reduce the memory
|
||||
usage of restic.
|
||||
|
||||
|
||||
|
||||
+1
-1
@@ -223,7 +223,7 @@ Printing files to stdout
|
||||
========================
|
||||
|
||||
Sometimes it's helpful to print files to stdout so that other programs can read
|
||||
the data directly. This can be achieved by using the `dump` command, like this:
|
||||
the data directly. This can be achieved by using the ``dump`` command, like this:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
|
||||
+4
-4
@@ -280,8 +280,8 @@ might be spread over a longer period. If what you want is to keep daily
|
||||
snapshots for the last week, weekly for the last month, monthly for the last
|
||||
year and yearly for the last 75 years, you can instead specify ``forget
|
||||
--keep-within-daily 7d --keep-within-weekly 1m --keep-within-monthly 1y
|
||||
--keep-within-yearly 75y`` (note that `1w` is not a recognized duration, so
|
||||
you will have to specify `7d` instead).
|
||||
--keep-within-yearly 75y`` (note that ``1w`` is not a recognized duration, so
|
||||
you will have to specify ``7d`` instead).
|
||||
|
||||
The processed snapshots are evaluated against all ``--keep-*`` options but a
|
||||
snapshot only needs to match a single option to be kept (the results are ORed).
|
||||
@@ -531,8 +531,8 @@ is available as a method of last resort. It allows prune to work with little to
|
||||
space. However, a **failed** ``prune`` run can cause the repository to become
|
||||
**temporarily unusable**. Therefore, make sure that you have a stable connection to the
|
||||
repository storage, before running this command. In case the command fails, it may become
|
||||
necessary to manually remove all files from the `index/` folder of the repository and
|
||||
run `repair index` afterwards.
|
||||
necessary to manually remove all files from the ``index/`` folder of the repository and
|
||||
run ``restic repair index`` afterwards.
|
||||
|
||||
To prevent accidental usages of the ``--unsafe-recover-no-free-space`` option it is
|
||||
necessary to first run ``prune --unsafe-recover-no-free-space SOME-ID`` and then replace
|
||||
|
||||
@@ -761,7 +761,7 @@ Verbose status
|
||||
^^^^^^^^^^^^^^
|
||||
|
||||
Verbose status provides details about the progress, including details about restored files.
|
||||
Only printed if `--verbose=2` is specified.
|
||||
Only printed if ``--verbose=2`` is specified.
|
||||
|
||||
+------------------+--------------------------------------------------------+--------+
|
||||
| ``message_type`` | Always "verbose_status" | string |
|
||||
|
||||
@@ -120,7 +120,7 @@ whether your issue is already known and solved. Please take a look at the
|
||||
|
||||
.. note::
|
||||
|
||||
If the `check` command tells you to run `restic repair packs`, then use that
|
||||
If the ``check`` command tells you to run ``restic repair packs``, then use that
|
||||
command instead. It will repair the damaged pack files and also update the index.
|
||||
|
||||
Restic relies on its index to contain correct information about what data is
|
||||
|
||||
+4
-4
@@ -572,11 +572,11 @@ A symlink uses the following data structure:
|
||||
]
|
||||
}
|
||||
|
||||
The symlink target is stored in the field `linktarget`. As JSON strings can
|
||||
only contain valid unicode, an exception applies if the `linktarget` is not a
|
||||
valid UTF-8 string. Since restic 0.16.0, in such a case the `linktarget_raw`
|
||||
The symlink target is stored in the field ``linktarget``. As JSON strings can
|
||||
only contain valid unicode, an exception applies if the ``linktarget`` is not a
|
||||
valid UTF-8 string. Since restic 0.16.0, in such a case the ``linktarget_raw``
|
||||
field contains a base64 encoded version of the raw linktarget. The
|
||||
`linktarget_raw` field is only set if `linktarget` cannot be encoded correctly.
|
||||
``linktarget_raw`` field is only set if ``linktarget`` cannot be encoded correctly.
|
||||
|
||||
The command ``restic cat blob`` can also be used to extract and decrypt
|
||||
data given a plaintext ID, e.g. for the data mentioned above:
|
||||
|
||||
+6
-6
@@ -46,7 +46,7 @@ looks like this:
|
||||
pack 819a9a52e4f51230afa89aefbf90df37fb70996337ae57e6f7a822959206a85e: not referenced in any index
|
||||
pack de299e69fb075354a3775b6b045d152387201f1cdc229c31d1caa34c3b340141: not referenced in any index
|
||||
2 additional files were found in the repo, which likely contain duplicate data.
|
||||
You can run `restic prune` to correct this.
|
||||
You can run ``restic prune`` to correct this.
|
||||
check snapshots, trees and blobs
|
||||
[0:00] 100.00% 16 / 16 snapshots
|
||||
no errors were found
|
||||
@@ -283,14 +283,14 @@ Archive** storage classes is available:
|
||||
in the future (although the project will make best-effort attempts to avoid them).
|
||||
- Expect restores to hang from 1 up to 42 hours depending on your storage
|
||||
class, provider and luck. Restores from cold storages are known to be
|
||||
time-consuming. You may need to adjust the `s3.restore-timeout` if a restore
|
||||
time-consuming. You may need to adjust the ``s3.restore-timeout`` option if a restore
|
||||
operation takes more than 24 hours.
|
||||
- Restic will prevent sending metadata files (such as config files, lock files
|
||||
or tree blobs) to Glacier or Deep Archive. Standard class is used instead to
|
||||
ensure normal and fast operations for most tasks.
|
||||
- Currently, only the following commands are known to work:
|
||||
|
||||
- `backup`
|
||||
- `copy`
|
||||
- `prune`
|
||||
- `restore`
|
||||
- ``backup``
|
||||
- ``copy``
|
||||
- ``prune``
|
||||
- ``restore``
|
||||
|
||||
+2
-2
@@ -180,8 +180,8 @@ Additionally, on Unix systems if ``restic`` receives a SIGUSR1 signal the
|
||||
current progress will be written to the standard output so you can check up
|
||||
on the status at will.
|
||||
|
||||
Setting the `RESTIC_PROGRESS_FPS` environment variable or sending a `SIGUSR1`
|
||||
signal prints a status report even when `--quiet` was specified.
|
||||
Setting the ``RESTIC_PROGRESS_FPS`` environment variable or sending a ``SIGUSR1``
|
||||
signal prints a status report even when ``--quiet`` was specified.
|
||||
|
||||
Managing tags
|
||||
-------------
|
||||
|
||||
Reference in New Issue
Block a user