mirror of
https://github.com/borgbackup/borg.git
synced 2024-09-11 12:36:12 +03:00
commit
83aed450e9
@ -120,7 +120,7 @@ Compatibility notes:
|
||||
Change Log 2.x
|
||||
==============
|
||||
|
||||
Version 2.0.0b9 (2024-07-xx)
|
||||
Version 2.0.0b9 (2024-07-20)
|
||||
----------------------------
|
||||
|
||||
Please note:
|
||||
@ -139,6 +139,7 @@ New features:
|
||||
Requires to run "borg check --repair --archives-only" to delete orphaned
|
||||
chunks before running "borg compact" to free space! These orphans are
|
||||
expected due to the simplified refcounting with the AdHocFilesCache.
|
||||
- make BORG_EXIT_CODES="modern" the default, #8110
|
||||
- add BORG_USE_CHUNKS_ARCHIVE env var, #8280
|
||||
- automatically rebuild cache on exception, #5213
|
||||
|
||||
@ -152,6 +153,7 @@ Bug fixes:
|
||||
- create: deal with EBUSY, #8123
|
||||
- benchmark: inherit options --rsh --remote-path, #8099
|
||||
- benchmark: fix return value, #8113
|
||||
- key export: fix crash when no path is given, fix exception handling
|
||||
|
||||
Other changes:
|
||||
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-BENCHMARK-CPU" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-BENCHMARK-CPU" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-benchmark-cpu \- Benchmark CPU bound operations.
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-BENCHMARK-CRUD" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-BENCHMARK-CRUD" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-benchmark-crud \- Benchmark Create, Read, Update, Delete for archives.
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-BENCHMARK" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-BENCHMARK" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-benchmark \- benchmark command
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-BREAK-LOCK" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-BREAK-LOCK" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-break-lock \- Break the repository lock (e.g. in case it was left by a dead borg.
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-CHECK" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-CHECK" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-check \- Check repository consistency
|
||||
.SH SYNOPSIS
|
||||
@ -155,7 +155,7 @@ Consequently, if lost chunks were repaired earlier, it is advised to run
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-repository\-only
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-COMMON" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-COMMON" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-common \- Common options of Borg commands
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-COMPACT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-COMPACT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-compact \- compact segment files in the repository
|
||||
.SH SYNOPSIS
|
||||
@ -55,7 +55,7 @@ See \fIseparate_compaction\fP in Additional Notes for more details.
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.BI \-\-threshold \ PERCENT
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-COMPRESSION" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-COMPRESSION" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-compression \- Details regarding compression
|
||||
.SH DESCRIPTION
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-CONFIG" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-CONFIG" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-config \- get, set, and delete values in a repository or cache config file
|
||||
.SH SYNOPSIS
|
||||
@ -39,7 +39,7 @@ This command gets and sets options in a local repository or cache config file.
|
||||
For security reasons, this command only works on local repositories.
|
||||
.sp
|
||||
To delete a config value entirely, use \fB\-\-delete\fP\&. To list the values
|
||||
of the configuration file or the default values, use \fB\-\-list\fP\&. To get and existing
|
||||
of the configuration file or the default values, use \fB\-\-list\fP\&. 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 \(dqsection.name\(dq or
|
||||
simply \(dqname\(dq; the section will default to \(dqrepository\(dq and \(dqcache\(dq for
|
||||
@ -59,7 +59,7 @@ name of config key
|
||||
.B VALUE
|
||||
new value for key
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-c\fP,\fB \-\-cache
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-CREATE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-CREATE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-create \- Create new archive
|
||||
.SH SYNOPSIS
|
||||
@ -137,7 +137,7 @@ specify the archive name
|
||||
.B PATH
|
||||
paths to archive
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-n\fP,\fB \-\-dry\-run
|
||||
@ -156,7 +156,13 @@ only display items with the given status characters (see description)
|
||||
output stats as JSON. Implies \fB\-\-stats\fP\&.
|
||||
.TP
|
||||
.B \-\-no\-cache\-sync
|
||||
experimental: do not synchronize the cache. Implies not using the files cache.
|
||||
experimental: do not synchronize the chunks cache.
|
||||
.TP
|
||||
.B \-\-no\-cache\-sync\-forced
|
||||
experimental: do not synchronize the chunks cache (forced).
|
||||
.TP
|
||||
.B \-\-prefer\-adhoc\-cache
|
||||
experimental: prefer AdHocCache (w/o files cache) over AdHocWithFilesCache (with files cache).
|
||||
.TP
|
||||
.BI \-\-stdin\-name \ NAME
|
||||
use NAME in archive for stdin data (default: \(aqstdin\(aq)
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-DELETE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-DELETE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-delete \- Delete archives
|
||||
.SH SYNOPSIS
|
||||
@ -55,7 +55,7 @@ Always first use \fB\-\-dry\-run \-\-list\fP to see what would be deleted.
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-n\fP,\fB \-\-dry\-run
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-DIFF" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-DIFF" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-diff \- Diff contents of two archives
|
||||
.SH SYNOPSIS
|
||||
@ -53,7 +53,7 @@ ARCHIVE2 name
|
||||
.B PATH
|
||||
paths of items inside the archives to compare; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-numeric\-ids
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-EXPORT-TAR" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-EXPORT-TAR" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-export-tar \- Export archive contents as a tarball
|
||||
.SH SYNOPSIS
|
||||
@ -124,7 +124,7 @@ output tar file. \(dq\-\(dq to write to stdout instead.
|
||||
.B PATH
|
||||
paths to extract; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-tar\-filter
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-EXTRACT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-EXTRACT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-extract \- Extract archive contents
|
||||
.SH SYNOPSIS
|
||||
@ -72,7 +72,7 @@ specify the archive name
|
||||
.B PATH
|
||||
paths to extract; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-list
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-IMPORT-TAR" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-IMPORT-TAR" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-import-tar \- Create a backup archive from a tarball
|
||||
.SH SYNOPSIS
|
||||
@ -96,7 +96,7 @@ specify the archive name
|
||||
.B TARFILE
|
||||
input tar file. \(dq\-\(dq to read from stdin instead.
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-tar\-filter
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-INFO" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-INFO" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-info \- Show archive details such as disk space used
|
||||
.SH SYNOPSIS
|
||||
@ -48,7 +48,7 @@ All archives / deduplicated size = amount of data stored in the repo
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-json
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-KEY-CHANGE-LOCATION" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-KEY-CHANGE-LOCATION" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-key-change-location \- Change repository key location
|
||||
.SH SYNOPSIS
|
||||
@ -56,7 +56,7 @@ See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.B KEY_LOCATION
|
||||
select key location
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-keep
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-KEY-CHANGE-PASSPHRASE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-KEY-CHANGE-PASSPHRASE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-key-change-passphrase \- Change repository key file passphrase
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-KEY-EXPORT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-KEY-EXPORT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-key-export \- Export the repository key for backup
|
||||
.SH SYNOPSIS
|
||||
@ -56,24 +56,6 @@ For repositories using the repokey encryption the key is saved in the
|
||||
repository in the config file. A backup is thus not strictly needed,
|
||||
but guards against the repository becoming inaccessible if the file
|
||||
is damaged for some reason.
|
||||
.sp
|
||||
Examples:
|
||||
.INDENT 0.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
borg key export /path/to/repo > encrypted\-key\-backup
|
||||
borg key export \-\-paper /path/to/repo > encrypted\-key\-backup.txt
|
||||
borg key export \-\-qr\-html /path/to/repo > encrypted\-key\-backup.html
|
||||
# Or pass the output file as an argument instead of redirecting stdout:
|
||||
borg key export /path/to/repo encrypted\-key\-backup
|
||||
borg key export \-\-paper /path/to/repo encrypted\-key\-backup.txt
|
||||
borg key export \-\-qr\-html /path/to/repo encrypted\-key\-backup.html
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
@ -83,7 +65,7 @@ See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.B PATH
|
||||
where to store the backup
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-paper
|
||||
@ -92,6 +74,23 @@ Create an export suitable for printing and later type\-in
|
||||
.B \-\-qr\-html
|
||||
Create an html file suitable for printing and later type\-in or qr scan
|
||||
.UNINDENT
|
||||
.SH EXAMPLES
|
||||
.INDENT 0.0
|
||||
.INDENT 3.5
|
||||
.sp
|
||||
.nf
|
||||
.ft C
|
||||
borg key export > encrypted\-key\-backup
|
||||
borg key export \-\-paper > encrypted\-key\-backup.txt
|
||||
borg key export \-\-qr\-html > encrypted\-key\-backup.html
|
||||
# Or pass the output file as an argument instead of redirecting stdout:
|
||||
borg key export encrypted\-key\-backup
|
||||
borg key export \-\-paper encrypted\-key\-backup.txt
|
||||
borg key export \-\-qr\-html encrypted\-key\-backup.html
|
||||
.ft P
|
||||
.fi
|
||||
.UNINDENT
|
||||
.UNINDENT
|
||||
.SH SEE ALSO
|
||||
.sp
|
||||
\fIborg\-common(1)\fP, \fIborg\-key\-import(1)\fP
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-KEY-IMPORT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-KEY-IMPORT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-key-import \- Import the repository key from backup
|
||||
.SH SYNOPSIS
|
||||
@ -58,7 +58,7 @@ See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.B PATH
|
||||
path to the backup (\(aq\-\(aq to read from stdin)
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-paper
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-KEY" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-KEY" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-key \- Manage a keyfile or repokey of a repository
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-LIST" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-LIST" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-list \- List archive contents
|
||||
.SH SYNOPSIS
|
||||
@ -50,7 +50,7 @@ specify the archive name
|
||||
.B PATH
|
||||
paths to list; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-short
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-MATCH-ARCHIVES" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-MATCH-ARCHIVES" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-match-archives \- Details regarding match-archives
|
||||
.SH DESCRIPTION
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-MOUNT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-MOUNT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-mount \- Mount archive or an entire repository as a FUSE filesystem
|
||||
.SH SYNOPSIS
|
||||
@ -107,7 +107,7 @@ where to mount filesystem
|
||||
.B PATH
|
||||
paths to extract; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-consider\-checkpoints
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-PATTERNS" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-PATTERNS" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-patterns \- Details regarding patterns
|
||||
.SH DESCRIPTION
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-PLACEHOLDERS" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-PLACEHOLDERS" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-placeholders \- Details regarding placeholders
|
||||
.SH DESCRIPTION
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-PRUNE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-PRUNE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-prune \- Prune repository archives according to specified rules
|
||||
.SH SYNOPSIS
|
||||
@ -96,7 +96,7 @@ the \fBborg rlist\fP description for more details about the format string).
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-n\fP,\fB \-\-dry\-run
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RCOMPRESS" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RCOMPRESS" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rcompress \- Repository (re-)compression
|
||||
.SH SYNOPSIS
|
||||
@ -64,7 +64,7 @@ You do \fBnot\fP need to run \fBborg compact\fP after \fBborg rcompress\fP\&.
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.BI \-C \ COMPRESSION\fR,\fB \ \-\-compression \ COMPRESSION
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RCREATE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RCREATE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rcreate \- Create a new, empty repository
|
||||
.SH SYNOPSIS
|
||||
@ -229,7 +229,7 @@ Creating related repositories is useful e.g. if you want to use \fBborg transfer
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.BI \-\-other\-repo \ SRC_REPOSITORY
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RDELETE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RDELETE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rdelete \- Delete a repository
|
||||
.SH SYNOPSIS
|
||||
@ -46,7 +46,7 @@ Always first use \fB\-\-dry\-run \-\-list\fP to see what would be deleted.
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-n\fP,\fB \-\-dry\-run
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RECREATE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RECREATE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-recreate \- Re-create archives
|
||||
.SH SYNOPSIS
|
||||
@ -88,7 +88,7 @@ See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.B PATH
|
||||
paths to recreate; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-list
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RENAME" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RENAME" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rename \- Rename an existing archive
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RINFO" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RINFO" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rinfo \- Show repository infos
|
||||
.SH SYNOPSIS
|
||||
@ -48,7 +48,7 @@ All archives / deduplicated size = amount of data stored in the repo
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-json
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-RLIST" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-RLIST" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-rlist \- List the archives contained in a repository
|
||||
.SH SYNOPSIS
|
||||
@ -39,7 +39,7 @@ This command lists the archives contained in a repository.
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-\-consider\-checkpoints
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-SERVE" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-SERVE" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-serve \- Start in server mode. This command is usually not used manually.
|
||||
.SH SYNOPSIS
|
||||
@ -51,7 +51,7 @@ option if you do not want to use the default path for the socket and pid file).
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.BI \-\-restrict\-to\-path \ PATH
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-TRANSFER" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-TRANSFER" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-transfer \- archives transfer from other repository, optionally upgrade data format
|
||||
.SH SYNOPSIS
|
||||
@ -92,7 +92,7 @@ borg \-\-repo=DST_REPO transfer \-\-other\-repo=SRC_REPO \-\-upgrader=From12To20
|
||||
.SH OPTIONS
|
||||
.sp
|
||||
See \fIborg\-common(1)\fP for common options of Borg commands.
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-n\fP,\fB \-\-dry\-run
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-UMOUNT" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-UMOUNT" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-umount \- un-mount the FUSE filesystem
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-VERSION" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-VERSION" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-version \- Display the borg client / borg server version
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG-WITH-LOCK" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG-WITH-LOCK" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg-with-lock \- run a user specified command with the repository lock held
|
||||
.SH SYNOPSIS
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORG" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORG" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borg \- deduplicating and encrypting backup tool
|
||||
.SH SYNOPSIS
|
||||
@ -423,7 +423,8 @@ When set, use the value to answer the \(dqdisplay the passphrase for verificatio
|
||||
.TP
|
||||
.B BORG_EXIT_CODES
|
||||
When set to \(dqmodern\(dq, the borg process will return more specific exit codes (rc).
|
||||
Default is \(dqlegacy\(dq and returns rc 2 for all errors, 1 for all warnings, 0 for success.
|
||||
When set to \(dqlegacy\(dq, the borg process will return rc 2 for all errors, 1 for all warnings, 0 for success.
|
||||
Default is \(dqmodern\(dq.
|
||||
.TP
|
||||
.B BORG_HOST_ID
|
||||
Borg usually computes a host id from the FQDN plus the results of \fBuuid.getnode()\fP (which usually returns
|
||||
@ -460,6 +461,10 @@ When set to a numeric value, this determines the maximum \(dqtime to live\(dq fo
|
||||
entries (default: 20). The files cache is used to determine quickly whether a file is unchanged.
|
||||
The FAQ explains this more detailed in: \fIalways_chunking\fP
|
||||
.TP
|
||||
.B BORG_USE_CHUNKS_ARCHIVE
|
||||
When set to no (default: yes), the \fBchunks.archive.d\fP folder will not be used. This reduces
|
||||
disk space usage but slows down cache resyncs.
|
||||
.TP
|
||||
.B BORG_SHOW_SYSINFO
|
||||
When set to no (default: yes), system information (like OS, Python version, ...) in
|
||||
exceptions is not shown.
|
||||
@ -482,6 +487,24 @@ given order, e.g.:
|
||||
\fBnone\fP: do not try to load an implementation
|
||||
.UNINDENT
|
||||
.TP
|
||||
.B BORG_CACHE_IMPL
|
||||
Choose the implementation for the clientside cache, choose one of:
|
||||
.INDENT 7.0
|
||||
.IP \(bu 2
|
||||
\fBlocal\fP: uses a persistent chunks cache and keeps it in a perfect state (precise refcounts and
|
||||
sizes), requiring a potentially resource expensive cache sync in multi\-client scenarios.
|
||||
Also has a persistent files cache.
|
||||
.IP \(bu 2
|
||||
\fBadhoc\fP: builds a non\-persistent chunks cache by querying the repo. Chunks cache contents
|
||||
are somewhat sloppy for already existing chunks, concerning their refcount (\(dqinfinite\(dq) and
|
||||
size (0). No files cache (slow, will chunk all input files). DEPRECATED.
|
||||
.IP \(bu 2
|
||||
\fBadhocwithfiles\fP: Like \fBadhoc\fP, but with a persistent files cache. Default implementation.
|
||||
.IP \(bu 2
|
||||
\fBcli\fP: Determine the cache implementation from cli options. Without special options, will
|
||||
usually end up with the \fBlocal\fP implementation.
|
||||
.UNINDENT
|
||||
.TP
|
||||
.B BORG_SELFTEST
|
||||
This can be used to influence borg\(aqs builtin self\-tests. The default is to execute the tests
|
||||
at the beginning of each borg command invocation.
|
||||
|
@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||||
..
|
||||
.TH "BORGFS" 1 "2024-02-20" "" "borg backup tool"
|
||||
.TH "BORGFS" 1 "2024-07-19" "" "borg backup tool"
|
||||
.SH NAME
|
||||
borgfs \- Mount archive or an entire repository as a FUSE filesystem
|
||||
.SH SYNOPSIS
|
||||
@ -48,7 +48,7 @@ where to mount filesystem
|
||||
.B PATH
|
||||
paths to extract; patterns are supported
|
||||
.UNINDENT
|
||||
.SS options
|
||||
.SS optional arguments
|
||||
.INDENT 0.0
|
||||
.TP
|
||||
.B \-V\fP,\fB \-\-version
|
||||
|
@ -13,7 +13,7 @@ borg check
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``--repository-only`` | only perform repository checks |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -60,7 +60,7 @@ borg check
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--repository-only only perform repository checks
|
||||
--archives-only only perform archives checks
|
||||
--verify-data perform cryptographic archive data integrity verification (conflicts with ``--repository-only``)
|
||||
|
@ -13,7 +13,7 @@ borg compact
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+-------------------------+----------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+-------------------------+----------------------------------------------------------------+
|
||||
| | ``--threshold PERCENT`` | set minimum threshold for saved space in PERCENT (Default: 10) |
|
||||
+-------------------------------------------------------+-------------------------+----------------------------------------------------------------+
|
||||
@ -34,7 +34,7 @@ borg compact
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--threshold PERCENT set minimum threshold for saved space in PERCENT (Default: 10)
|
||||
|
||||
|
||||
|
@ -19,7 +19,7 @@ borg config
|
||||
+-------------------------------------------------------+----------------------+----------------------------------------+
|
||||
| | ``VALUE`` | new value for key |
|
||||
+-------------------------------------------------------+----------------------+----------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+----------------------+----------------------------------------+
|
||||
| | ``-c``, ``--cache`` | get and set values from the repo cache |
|
||||
+-------------------------------------------------------+----------------------+----------------------------------------+
|
||||
@ -48,7 +48,7 @@ borg config
|
||||
new value for key
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-c, --cache get and set values from the repo cache
|
||||
-d, --delete delete the key from the config file
|
||||
-l, --list list the configuration of the repo
|
||||
@ -64,7 +64,7 @@ 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 list the values
|
||||
of the configuration file or the default values, use ``--list``. To get and existing
|
||||
of the configuration file or the default values, use ``--list``. 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
|
||||
|
@ -19,7 +19,7 @@ borg create
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to archive |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``-n``, ``--dry-run`` | do not create a backup archive |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -31,7 +31,11 @@ borg create
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--json`` | output stats as JSON. Implies ``--stats``. |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--no-cache-sync`` | experimental: do not synchronize the cache. Implies not using the files cache. |
|
||||
| | ``--no-cache-sync`` | experimental: do not synchronize the chunks cache. |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--no-cache-sync-forced`` | experimental: do not synchronize the chunks cache (forced). |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--prefer-adhoc-cache`` | experimental: prefer AdHocCache (w/o files cache) over AdHocWithFilesCache (with files cache). |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--stdin-name NAME`` | use NAME in archive for stdin data (default: 'stdin') |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -126,13 +130,15 @@ borg create
|
||||
paths to archive
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-n, --dry-run do not create a backup archive
|
||||
-s, --stats print statistics for the created archive
|
||||
--list output verbose list of items (files, dirs, ...)
|
||||
--filter STATUSCHARS only display items with the given status characters (see description)
|
||||
--json output stats as JSON. Implies ``--stats``.
|
||||
--no-cache-sync experimental: do not synchronize the cache. Implies not using the files cache.
|
||||
--no-cache-sync experimental: do not synchronize the chunks cache.
|
||||
--no-cache-sync-forced experimental: do not synchronize the chunks cache (forced).
|
||||
--prefer-adhoc-cache experimental: prefer AdHocCache (w/o files cache) over AdHocWithFilesCache (with files cache).
|
||||
--stdin-name NAME use NAME in archive for stdin data (default: 'stdin')
|
||||
--stdin-user USER set user USER in archive for stdin data (default: do not store user/uid)
|
||||
--stdin-group GROUP set group GROUP in archive for stdin data (default: do not store group/gid)
|
||||
|
@ -13,7 +13,7 @@ borg delete
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``-n``, ``--dry-run`` | do not change repository |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -62,7 +62,7 @@ borg delete
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-n, --dry-run do not change repository
|
||||
--list output verbose list of archives
|
||||
--consider-checkpoints consider checkpoint archives for deletion (default: not considered).
|
||||
|
@ -21,7 +21,7 @@ borg diff
|
||||
+-------------------------------------------------------+---------------------------------------+----------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths of items inside the archives to compare; patterns are supported |
|
||||
+-------------------------------------------------------+---------------------------------------+----------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------+----------------------------------------------------------------------------------+
|
||||
| | ``--numeric-ids`` | only consider numeric user and group identifiers |
|
||||
+-------------------------------------------------------+---------------------------------------+----------------------------------------------------------------------------------+
|
||||
@ -68,7 +68,7 @@ borg diff
|
||||
paths of items inside the archives to compare; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--numeric-ids only consider numeric user and group identifiers
|
||||
--same-chunker-params Override check of chunker parameters.
|
||||
--sort Sort the output lines by file path.
|
||||
|
@ -21,7 +21,7 @@ borg export-tar
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to extract; patterns are supported |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``--tar-filter`` | filter program to pipe data through |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -64,7 +64,7 @@ borg export-tar
|
||||
paths to extract; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--tar-filter filter program to pipe data through
|
||||
--list output verbose list of items (files, dirs, ...)
|
||||
--tar-format FMT select tar format: BORG, PAX or GNU
|
||||
|
@ -19,7 +19,7 @@ borg extract
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to extract; patterns are supported |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``--list`` | output verbose list of items (files, dirs, ...) |
|
||||
+-------------------------------------------------------+---------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -72,7 +72,7 @@ borg extract
|
||||
paths to extract; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--list output verbose list of items (files, dirs, ...)
|
||||
-n, --dry-run do not actually change any files
|
||||
--numeric-ids only obey numeric user and group identifiers
|
||||
|
@ -19,7 +19,7 @@ borg import-tar
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``TARFILE`` | input tar file. "-" to read from stdin instead. |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--tar-filter`` | filter program to pipe data through |
|
||||
+-------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -68,7 +68,7 @@ borg import-tar
|
||||
input tar file. "-" to read from stdin instead.
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--tar-filter filter program to pipe data through
|
||||
-s, --stats print statistics for the created archive
|
||||
--list output verbose list of items (files, dirs, ...)
|
||||
|
@ -13,7 +13,7 @@ borg info
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``--json`` | format output as JSON |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -52,7 +52,7 @@ borg info
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--json format output as JSON
|
||||
|
||||
|
||||
|
@ -17,7 +17,7 @@ borg key change-location
|
||||
+-------------------------------------------------------+------------------+----------------------------------------------------------------+
|
||||
| | ``KEY_LOCATION`` | select key location |
|
||||
+-------------------------------------------------------+------------------+----------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+------------------+----------------------------------------------------------------+
|
||||
| | ``--keep`` | keep the key also at the current location (default: remove it) |
|
||||
+-------------------------------------------------------+------------------+----------------------------------------------------------------+
|
||||
@ -40,7 +40,7 @@ borg key change-location
|
||||
select key location
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--keep keep the key also at the current location (default: remove it)
|
||||
|
||||
|
||||
|
@ -17,7 +17,7 @@ borg key export
|
||||
+-------------------------------------------------------+---------------+------------------------------------------------------------------------+
|
||||
| | ``PATH`` | where to store the backup |
|
||||
+-------------------------------------------------------+---------------+------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------+------------------------------------------------------------------------+
|
||||
| | ``--paper`` | Create an export suitable for printing and later type-in |
|
||||
+-------------------------------------------------------+---------------+------------------------------------------------------------------------+
|
||||
@ -42,7 +42,7 @@ borg key export
|
||||
where to store the backup
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--paper Create an export suitable for printing and later type-in
|
||||
--qr-html Create an html file suitable for printing and later type-in or qr scan
|
||||
|
||||
@ -73,15 +73,4 @@ data backup.
|
||||
For repositories using the repokey encryption the key is saved in the
|
||||
repository in the config file. A backup is thus not strictly needed,
|
||||
but guards against the repository becoming inaccessible if the file
|
||||
is damaged for some reason.
|
||||
|
||||
Examples::
|
||||
|
||||
borg key export /path/to/repo > encrypted-key-backup
|
||||
borg key export --paper /path/to/repo > encrypted-key-backup.txt
|
||||
borg key export --qr-html /path/to/repo > encrypted-key-backup.html
|
||||
# Or pass the output file as an argument instead of redirecting stdout:
|
||||
borg key export /path/to/repo encrypted-key-backup
|
||||
borg key export --paper /path/to/repo encrypted-key-backup.txt
|
||||
borg key export --qr-html /path/to/repo encrypted-key-backup.html
|
||||
|
||||
is damaged for some reason.
|
@ -17,7 +17,7 @@ borg key import
|
||||
+-------------------------------------------------------+-------------+----------------------------------------------------------+
|
||||
| | ``PATH`` | path to the backup ('-' to read from stdin) |
|
||||
+-------------------------------------------------------+-------------+----------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+-------------+----------------------------------------------------------+
|
||||
| | ``--paper`` | interactively import from a backup done with ``--paper`` |
|
||||
+-------------------------------------------------------+-------------+----------------------------------------------------------+
|
||||
@ -40,7 +40,7 @@ borg key import
|
||||
path to the backup ('-' to read from stdin)
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--paper interactively import from a backup done with ``--paper``
|
||||
|
||||
|
||||
|
@ -19,7 +19,7 @@ borg list
|
||||
+-------------------------------------------------------+---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to list; patterns are supported |
|
||||
+-------------------------------------------------------+---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--short`` | only print file/directory names, nothing else |
|
||||
+-------------------------------------------------------+---------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -58,7 +58,7 @@ borg list
|
||||
paths to list; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--short only print file/directory names, nothing else
|
||||
--format FORMAT specify format for file listing (default: "{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}")
|
||||
--json-lines Format output as JSON Lines. The form of ``--format`` is ignored, but keys used in it are added to the JSON output. Some keys are always present. Note: JSON can only represent text.
|
||||
|
@ -19,7 +19,7 @@ borg mount
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to extract; patterns are supported |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
| | ``--consider-checkpoints`` | Show checkpoint archives in the repository contents list (default: hidden). |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+-----------------------------------------------------------------------------------------------------------+
|
||||
@ -80,7 +80,7 @@ borg mount
|
||||
paths to extract; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--consider-checkpoints Show checkpoint archives in the repository contents list (default: hidden).
|
||||
-f, --foreground stay in foreground, do not daemonize
|
||||
-o Extra mount options
|
||||
|
@ -13,7 +13,7 @@ borg prune
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------+
|
||||
| | ``-n``, ``--dry-run`` | do not change repository |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------+
|
||||
@ -78,7 +78,7 @@ borg prune
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-n, --dry-run do not change repository
|
||||
--force force pruning of corrupted archives, use ``--force --force`` in case ``--force`` does not work.
|
||||
-s, --stats print statistics for the deleted archive
|
||||
|
@ -13,7 +13,7 @@ borg rcompress
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
||||
| | ``-C COMPRESSION``, ``--compression COMPRESSION`` | select compression algorithm, see the output of the "borg help compression" command for details. |
|
||||
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
||||
@ -38,7 +38,7 @@ borg rcompress
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-C COMPRESSION, --compression COMPRESSION select compression algorithm, see the output of the "borg help compression" command for details.
|
||||
-s, --stats print statistics
|
||||
-c SECONDS, --checkpoint-interval SECONDS write checkpoint every SECONDS seconds (Default: 1800)
|
||||
|
@ -13,7 +13,7 @@ borg rcreate
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--other-repo SRC_REPOSITORY`` | reuse the key material from the other repository |
|
||||
+-------------------------------------------------------+------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -44,7 +44,7 @@ borg rcreate
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--other-repo SRC_REPOSITORY reuse the key material from the other repository
|
||||
-e MODE, --encryption MODE select encryption key mode **(required)**
|
||||
--append-only create an append-only mode repository. Note that this only affects the low level structure of the repository, and running `delete` or `prune` will still be allowed. See :ref:`append_only_mode` in Additional Notes for more details.
|
||||
|
@ -13,7 +13,7 @@ borg rdelete
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+--------------------------+--------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+--------------------------+--------------------------------------------------------------------------------------------------+
|
||||
| | ``-n``, ``--dry-run`` | do not change repository |
|
||||
+-------------------------------------------------------+--------------------------+--------------------------------------------------------------------------------------------------+
|
||||
@ -42,7 +42,7 @@ borg rdelete
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-n, --dry-run do not change repository
|
||||
--list output verbose list of archives
|
||||
--force force deletion of corrupted archives, use ``--force --force`` in case ``--force`` does not work.
|
||||
|
@ -17,7 +17,7 @@ borg recreate
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``PATH`` | paths to recreate; patterns are supported |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--list`` | output verbose list of items (files, dirs, ...) |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -94,7 +94,7 @@ borg recreate
|
||||
paths to recreate; patterns are supported
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--list output verbose list of items (files, dirs, ...)
|
||||
--filter STATUSCHARS only display items with the given status characters (listed in borg create --help)
|
||||
-n, --dry-run do not change anything
|
||||
|
@ -13,7 +13,7 @@ borg rinfo
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+------------+-----------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+------------+-----------------------+
|
||||
| | ``--json`` | format output as JSON |
|
||||
+-------------------------------------------------------+------------+-----------------------+
|
||||
@ -34,7 +34,7 @@ borg rinfo
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--json format output as JSON
|
||||
|
||||
|
||||
|
@ -13,7 +13,7 @@ borg rlist
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--consider-checkpoints`` | Show checkpoint archives in the repository contents list (default: hidden). |
|
||||
+-----------------------------------------------------------------------------+----------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -58,7 +58,7 @@ borg rlist
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--consider-checkpoints Show checkpoint archives in the repository contents list (default: hidden).
|
||||
--short only print the archive names, nothing else
|
||||
--format FORMAT specify format for archive listing (default: "{archive:<36} {time} [{id}]{NL}")
|
||||
|
@ -13,7 +13,7 @@ borg serve
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-------------------------------------------------------+-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-------------------------------------------------------+-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``--restrict-to-path PATH`` | restrict repository access to PATH. Can be specified multiple times to allow the client access to several directories. Access to all sub-directories is granted implicitly; PATH doesn't need to point directly to a repository. |
|
||||
+-------------------------------------------------------+-----------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -40,7 +40,7 @@ borg serve
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
--restrict-to-path PATH restrict repository access to PATH. Can be specified multiple times to allow the client access to several directories. Access to all sub-directories is granted implicitly; PATH doesn't need to point directly to a repository.
|
||||
--restrict-to-repository PATH restrict repository access. Only the repository located at PATH (no sub-directories are considered) is accessible. Can be specified multiple times to allow the client access to several repositories. Unlike ``--restrict-to-path`` sub-directories are not accessible; PATH needs to point directly at a repository location. PATH may be an empty directory or the last element of PATH may not exist, in which case the client may initialize a repository there.
|
||||
--append-only only allow appending to repository segment files. Note that this only affects the low level structure of the repository, and running `delete` or `prune` will still be allowed. See :ref:`append_only_mode` in Additional Notes for more details.
|
||||
|
@ -13,7 +13,7 @@ borg transfer
|
||||
.. class:: borg-options-table
|
||||
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| **options** |
|
||||
| **optional arguments** |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| | ``-n``, ``--dry-run`` | do not change repository, just check |
|
||||
+-----------------------------------------------------------------------------+---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
@ -60,7 +60,7 @@ borg transfer
|
||||
|
||||
|
||||
|
||||
options
|
||||
optional arguments
|
||||
-n, --dry-run do not change repository, just check
|
||||
--other-repo SRC_REPOSITORY transfer archives from the other repository
|
||||
--upgrader UPGRADER use the upgrader to convert transferred data (default: no conversion)
|
||||
|
@ -8,11 +8,11 @@ if [ "$R" = "" ]; then
|
||||
fi
|
||||
|
||||
if [ "$2" = "test" ]; then
|
||||
export TWINE_REPOSITORY=testpypi
|
||||
export TWINE_REPOSITORY=borgbackuptest
|
||||
else
|
||||
export TWINE_REPOSITORY=pypi
|
||||
export TWINE_REPOSITORY=borgbackup
|
||||
fi
|
||||
|
||||
D=dist/borgbackup-$R.tar.gz
|
||||
|
||||
twine upload "$D"
|
||||
twine upload $D
|
||||
|
@ -52,7 +52,8 @@ def test_config(archivers, request):
|
||||
|
||||
cmd(archiver, "config", "--list", "--delete", exit_code=2)
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "config", exit_code=2)
|
||||
expected_ec = CommandError().exit_code
|
||||
cmd(archiver, "config", exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
cmd(archiver, "config")
|
||||
|
@ -366,7 +366,10 @@ def test_create_content_from_command_with_failed_command(archivers, request):
|
||||
archiver = request.getfixturevalue(archivers)
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
output = cmd(archiver, "create", "--content-from-command", "test", "--", "sh", "-c", "exit 73;", exit_code=2)
|
||||
expected_ec = CommandError().exit_code
|
||||
output = cmd(
|
||||
archiver, "create", "--content-from-command", "test", "--", "sh", "-c", "exit 73;", exit_code=expected_ec
|
||||
)
|
||||
assert output.endswith("Command 'sh' exited with status 73" + os.linesep)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
@ -418,7 +421,10 @@ def test_create_paths_from_command_with_failed_command(archivers, request):
|
||||
archiver = request.getfixturevalue(archivers)
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
output = cmd(archiver, "create", "--paths-from-command", "test", "--", "sh", "-c", "exit 73;", exit_code=2)
|
||||
expected_ec = CommandError().exit_code
|
||||
output = cmd(
|
||||
archiver, "create", "--paths-from-command", "test", "--", "sh", "-c", "exit 73;", exit_code=expected_ec
|
||||
)
|
||||
assert output.endswith("Command 'sh' exited with status 73" + os.linesep)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
|
@ -6,7 +6,7 @@
|
||||
from ...constants import * # NOQA
|
||||
from ...crypto.key import AESOCBRepoKey, AESOCBKeyfileKey, CHPOKeyfileKey, Passphrase
|
||||
from ...crypto.keymanager import RepoIdMismatch, NotABorgKeyFile
|
||||
from ...helpers import EXIT_ERROR, CommandError
|
||||
from ...helpers import CommandError
|
||||
from ...helpers import bin_to_hex, hex_to_bin
|
||||
from ...helpers import msgpack
|
||||
from ...repository import Repository
|
||||
@ -171,7 +171,8 @@ def test_key_export_directory(archivers, request):
|
||||
os.mkdir(export_directory)
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "key", "export", export_directory, exit_code=EXIT_ERROR)
|
||||
expected_ec = CommandError().exit_code
|
||||
cmd(archiver, "key", "export", export_directory, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
cmd(archiver, "key", "export", export_directory)
|
||||
@ -183,7 +184,8 @@ def test_key_export_qr_directory(archivers, request):
|
||||
os.mkdir(export_directory)
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "key", "export", "--qr-html", export_directory, exit_code=EXIT_ERROR)
|
||||
expected_ec = CommandError().exit_code
|
||||
cmd(archiver, "key", "export", "--qr-html", export_directory, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
cmd(archiver, "key", "export", "--qr-html", export_directory)
|
||||
@ -194,7 +196,8 @@ def test_key_import_errors(archivers, request):
|
||||
export_file = archiver.output_path + "/exported"
|
||||
cmd(archiver, "rcreate", KF_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "key", "import", export_file, exit_code=EXIT_ERROR)
|
||||
expected_ec = CommandError().exit_code
|
||||
cmd(archiver, "key", "import", export_file, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
cmd(archiver, "key", "import", export_file)
|
||||
@ -203,7 +206,8 @@ def test_key_import_errors(archivers, request):
|
||||
fd.write("something not a key\n")
|
||||
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "key", "import", export_file, exit_code=2)
|
||||
expected_ec = NotABorgKeyFile().exit_code
|
||||
cmd(archiver, "key", "import", export_file, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(NotABorgKeyFile):
|
||||
cmd(archiver, "key", "import", export_file)
|
||||
@ -212,7 +216,8 @@ def test_key_import_errors(archivers, request):
|
||||
fd.write("BORG_KEY a0a0a0\n")
|
||||
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "key", "import", export_file, exit_code=2)
|
||||
expected_ec = RepoIdMismatch().exit_code
|
||||
cmd(archiver, "key", "import", export_file, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(RepoIdMismatch):
|
||||
cmd(archiver, "key", "import", export_file)
|
||||
|
@ -56,7 +56,8 @@ def test_rcreate_nested_repositories(archivers, request):
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
archiver.repository_location += "/nested"
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION, exit_code=2)
|
||||
expected_ec = Repository.AlreadyExists().exit_code
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION, exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(Repository.AlreadyExists):
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
|
@ -18,7 +18,8 @@ def test_delete_repo(archivers, request):
|
||||
cmd(archiver, "create", "test.2", "input")
|
||||
os.environ["BORG_DELETE_I_KNOW_WHAT_I_AM_DOING"] = "no"
|
||||
if archiver.FORK_DEFAULT:
|
||||
cmd(archiver, "rdelete", exit_code=2)
|
||||
expected_ec = CancelledByUser().exit_code
|
||||
cmd(archiver, "rdelete", exit_code=expected_ec)
|
||||
else:
|
||||
with pytest.raises(CancelledByUser):
|
||||
cmd(archiver, "rdelete")
|
||||
|
@ -84,7 +84,8 @@ def test_recreate_target_rc(archivers, request):
|
||||
archiver = request.getfixturevalue(archivers)
|
||||
cmd(archiver, "rcreate", RK_ENCRYPTION)
|
||||
if archiver.FORK_DEFAULT:
|
||||
output = cmd(archiver, "recreate", "--target=asdf", exit_code=2)
|
||||
expected_ec = CommandError().exit_code
|
||||
output = cmd(archiver, "recreate", "--target=asdf", exit_code=expected_ec)
|
||||
assert "Need to specify single archive" in output
|
||||
else:
|
||||
with pytest.raises(CommandError):
|
||||
|
Loading…
Reference in New Issue
Block a user