mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-25 17:27:31 +00:00
100 lines
No EOL
4.3 KiB
PHP
100 lines
No EOL
4.3 KiB
PHP
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
.. _borg_recreate:
|
|
|
|
borg recreate
|
|
-------------
|
|
::
|
|
|
|
borg [common options] recreate <options> REPOSITORY_OR_ARCHIVE PATH
|
|
|
|
positional arguments
|
|
REPOSITORY_OR_ARCHIVE
|
|
repository/archive to recreate
|
|
PATH
|
|
paths to recreate; patterns are supported
|
|
|
|
optional arguments
|
|
``--list``
|
|
| output verbose list of items (files, dirs, ...)
|
|
``--filter STATUSCHARS``
|
|
| only display items with the given status characters
|
|
``-n``, ``--dry-run``
|
|
| do not change anything
|
|
``-s``, ``--stats``
|
|
| print statistics at end
|
|
|
|
`Common options`_
|
|
|
|
|
|
|
Exclusion options
|
|
``-e PATTERN``, ``--exclude PATTERN``
|
|
| exclude paths matching PATTERN
|
|
``--exclude-from EXCLUDEFILE``
|
|
| read exclude patterns from EXCLUDEFILE, one per line
|
|
``--exclude-caches``
|
|
| exclude directories that contain a CACHEDIR.TAG file (http://www.brynosaurus.com/cachedir/spec.html)
|
|
``--exclude-if-present NAME``
|
|
| exclude directories that are tagged by containing a filesystem object with the given NAME
|
|
``--keep-exclude-tags``, ``--keep-tag-files``
|
|
| if tag objects are specified with --exclude-if-present, don't omit the tag objects themselves from the backup archive
|
|
``--pattern PATTERN``
|
|
| include/exclude paths matching PATTERN
|
|
``--patterns-from PATTERNFILE``
|
|
| read include/exclude patterns from PATTERNFILE, one per line
|
|
|
|
Archive options
|
|
``--target TARGET``
|
|
| create a new archive with the name ARCHIVE, do not replace existing archive (only applies for a single archive)
|
|
``-c SECONDS``, ``--checkpoint-interval SECONDS``
|
|
| write checkpoint every SECONDS seconds (Default: 1800)
|
|
``--comment COMMENT``
|
|
| add a comment text to the archive
|
|
``--timestamp TIMESTAMP``
|
|
| manually specify the archive creation date/time (UTC, yyyy-mm-ddThh:mm:ss format). alternatively, give a reference file/directory.
|
|
``-C COMPRESSION``, ``--compression COMPRESSION``
|
|
| select compression algorithm, see the output of the "borg help compression" command for details.
|
|
``--recompress``
|
|
| recompress data chunks according to --compression if "if-different". When "always", chunks that are already compressed that way are not skipped, but compressed again. Only the algorithm is considered for "if-different", not the compression level (if any).
|
|
``--chunker-params PARAMS``
|
|
| specify the chunker parameters (CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE) or "default" to use the current defaults. default: 19,23,21,4095
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
Recreate the contents of existing archives.
|
|
|
|
This is an *experimental* feature. Do *not* use this on your only backup.
|
|
|
|
--exclude, --exclude-from, --exclude-if-present, --keep-exclude-tags, and PATH
|
|
have the exact same semantics as in "borg create". If PATHs are specified the
|
|
resulting archive will only contain files from these PATHs.
|
|
|
|
Note that all paths in an archive are relative, therefore absolute patterns/paths
|
|
will *not* match (--exclude, --exclude-from, PATHs).
|
|
|
|
--recompress allows to change the compression of existing data in archives.
|
|
Due to how Borg stores compressed size information this might display
|
|
incorrect information for archives that were not recreated at the same time.
|
|
There is no risk of data loss by this.
|
|
|
|
--chunker-params will re-chunk all files in the archive, this can be
|
|
used to have upgraded Borg 0.xx or Attic archives deduplicate with
|
|
Borg 1.x archives.
|
|
|
|
USE WITH CAUTION.
|
|
Depending on the PATHs and patterns given, recreate can be used to permanently
|
|
delete files from archives.
|
|
When in doubt, use "--dry-run --verbose --list" to see how patterns/PATHS are
|
|
interpreted.
|
|
|
|
The archive being recreated is only removed after the operation completes. The
|
|
archive that is built during the operation exists at the same time at
|
|
"<ARCHIVE>.recreate". The new archive will have a different archive ID.
|
|
|
|
With --target the original archive is not replaced, instead a new archive is created.
|
|
|
|
When rechunking space usage can be substantial, expect at least the entire
|
|
deduplicated size of the archives using the previous chunker params.
|
|
When recompressing expect approx. (throughput / checkpoint-interval) in space usage,
|
|
assuming all chunks are recompressed. |