Man page - borg2-placeholders(1)
Packages contains this manual
- borg2-diff(1)
- borg2-break-lock(1)
- borg2-umount(1)
- borg2-mount(1)
- borg2-export-tar(1)
- borg2-key(1)
- borg2-common(1)
- borg2-prune(1)
- borg2-match-archives(1)
- borg2-placeholders(1)
- borg2-check(1)
- borg2-compact(1)
- borg2-delete(1)
- borg2-extract(1)
- borg2-benchmark-crud(1)
- borg2-key-export(1)
- borg2-analyze(1)
- borg2(1)
- borg2-list(1)
- borg2-import-tar(1)
- borg2-repo-delete(1)
- borg2-undelete(1)
- borg2-create(1)
- borg2-patterns(1)
- borgfs2(1)
- borg2-compression(1)
- borgbackup2(1)
- borg2-key-change-passphrase(1)
- borg2-recreate(1)
- borg2-version(1)
- borg2-repo-list(1)
- borg2-tag(1)
- borg2-rename(1)
- borg2-repo-create(1)
- borg2-serve(1)
- borg2-transfer(1)
- borg2-benchmark-cpu(1)
- borg2-benchmark(1)
- borg2-info(1)
- borg2-key-change-location(1)
- borg2-repo-compress(1)
- borg2-with-lock(1)
- borg2-key-import(1)
- borg2-repo-info(1)
- borg2-repo-space(1)
apt-get install borgbackup2
Manual
BORG-PLACEHOLDERS
NAMEDESCRIPTION
AUTHOR
NAME
borg-placeholders - Details regarding placeholders
DESCRIPTION
Repository URLs,
--name
,
-a
/
--match-archives
,
--comment
and
--remote-path
values support
these placeholders:
{hostname}
The (short) hostname of the machine.
|
{fqdn} |
The full name of the machine. |
{reverse-fqdn}
The full name of the machine in reverse domain name notation.
|
{now} |
The current local date and time, by default in ISO-8601 format. You can also supply your own format string <https://docs.python.org/3.9/library/datetime.html#strftime-and-strptime-behavior> , e.g. {now:%Y-%m-%d_%H:%M:%S} |
{utcnow}
The current UTC date and time, by default in ISO-8601 format. You can also supply your own format string <https://docs.python.org/3.9/library/datetime.html#strftime-and-strptime-behavior> , e.g. {utcnow:%Y-%m-%d_%H:%M:%S}
|
{user} |
The user name (or UID, if no name is available) of the user running borg. |
||
|
{pid} |
The current process ID. |
{borgversion}
The version of borg, e.g.: 1.0.8rc1
{borgmajor}
The version of borg, only the major version, e.g.: 1
{borgminor}
The version of borg, only major and minor version, e.g.: 1.0
{borgpatch}
The version of borg, only major, minor and patch version, e.g.: 1.0.8
If literal curly braces need to be used, double them for escaping:
borg create --repo /path/to/repo {{literal_text}}
Examples:
borg create
--repo /path/to/repo {hostname}-{user}-{utcnow} ...
borg create --repo /path/to/repo
{hostname}-{now:%Y-%m-%d_%H:%M:%S%z} ...
borg prune -a 'sh:{hostname}-*' ...
NOTE:
systemd uses a difficult, non-standard syntax for command lines in unit files (refer to the systemd.unit(5) manual page).
When invoking borg from unit files, pay particular attention to escaping, especially when using the now/utcnow placeholders, since systemd performs its own %-based variable replacement even in quoted text. To avoid interference from systemd, double all percent signs ( {hostname}-{now:%Y-%m-%d_%H:%M:%S} becomes {hostname}-{now:%%Y-%%m-%%d_%%H:%%M:%%S} ).
AUTHOR
The Borg Collective