1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2024-12-27 10:18:12 +00:00
borg/docs/usage
Thomas Waldmann 9b3a0023c3
repo-list: add hostname/username/comment to default format, reorder, adjust
borg 1.x encouraged users to put everything into the archive name:
- name of the dataset
- timestamp (usually used to make the archive name unique)
- maybe also hostname (when backing up to same repo from multiple hosts)
- maybe also username (when backing up to same repo from multiple users)

borg2 now discourages users from putting the timestamp into the name,
because we rather want same name within a series of archives - thus,
the field width for the name can be narrower.

the ID of the archive is now the only unique identifier, thus it is
moved to the leftmost place.
256bits (64 hex digits) was a bit much and as borg can also deal with
abbreviated IDs, we only show 32bits (8 hex digits) by default.

the ID is followed by the timestamp (also quite "interesting", because
it usually differs for different archives).

then following are: archive name, user name, host name - these might be
always the same if there is only one series of archives in a repo.

use 2 blanks separating the fields for better readability.
2024-09-26 15:53:36 +02:00
..
general add support for rclone:// repositories (via borgstore) 2024-09-22 22:26:07 +02:00
benchmark.rst docs: usage: add benchmark cpu and key change-location 2022-03-26 23:40:03 +01:00
benchmark_cpu.rst.inc build_usage / build_man / doc updates 2022-06-25 21:58:19 +02:00
benchmark_crud.rst.inc build_usage / build_man / doc updates 2022-06-25 21:58:19 +02:00
borgfs.rst [DOCS] #4587 – Make Sphinx warnings break docs build 2020-03-16 19:06:00 +01:00
borgfs.rst.inc Docs grammar fixes 2022-12-29 22:26:54 +00:00
break-lock.rst.inc build_usage / build_man / doc updates 2022-06-25 21:58:19 +02:00
change-passphrase.rst.inc build_usage (master) 2017-11-25 14:35:52 +01:00
check.rst docs: split usage 2017-06-07 00:38:48 +02:00
check.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
common-options.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
compact.rst docs: fix rst literal blocks 2022-07-05 00:38:37 +02:00
compact.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
create.rst docs: update about archive series 2024-09-18 14:05:12 +02:00
create.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
debug.rst docs: split usage 2017-06-07 00:38:48 +02:00
delete.rst docs: update about archive series 2024-09-18 14:05:12 +02:00
delete.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
diff.rst docs: fix rst literal blocks 2022-07-05 00:38:37 +02:00
diff.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
export-tar.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
extract.rst docs: fix rst literal blocks 2022-07-05 00:38:37 +02:00
extract.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
general.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
help.rst docs: split usage 2017-06-07 00:38:48 +02:00
help.rst.inc docs: update about archive series 2024-09-18 14:05:12 +02:00
import-tar.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
info.rst docs: update about archive series 2024-09-18 14:05:12 +02:00
info.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
key.rst cli: rename r* commands to repo-* 2024-09-08 18:06:24 +02:00
key_change-location.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
key_change-passphrase.rst.inc build_usage / build_man / doc updates 2022-06-25 21:58:19 +02:00
key_export.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
key_import.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
list.rst list: fix --pattern examples, fixes #7611 2023-06-29 23:04:21 +02:00
list.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
lock.rst docs: split usage 2017-06-07 00:38:48 +02:00
mount.rst docs: do not refer to setup.py installation method 2024-02-09 17:37:40 +01:00
mount.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
notes.rst cli: rename r* commands to repo-* 2024-09-08 18:06:24 +02:00
prune.rst docs: update about archive series 2024-09-18 14:05:12 +02:00
prune.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
recreate.rst docs: fix rst literal blocks 2022-07-05 00:38:37 +02:00
recreate.rst.inc build_usage / build_man 2024-09-08 12:02:17 +02:00
rename.rst cli: rename r* commands to repo-* 2024-09-08 18:06:24 +02:00
rename.rst.inc build_usage / build_man / doc updates 2022-06-25 21:58:19 +02:00
repo-compress.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-compress.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-create.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-create.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-delete.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-delete.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-info.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-info.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-list.rst repo-list: add hostname/username/comment to default format, reorder, adjust 2024-09-26 15:53:36 +02:00
repo-list.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-space.rst docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
repo-space.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
serve.rst Docs grammar fixes 2022-12-29 22:26:54 +00:00
serve.rst.inc build_usage / build_man 2024-07-19 20:40:15 +02:00
tar.rst docs: update about archive series 2024-09-18 14:05:12 +02:00
transfer.rst cli: rename r* commands to repo-* 2024-09-08 18:06:24 +02:00
transfer.rst.inc docs: fix usage docs and references for repo-* commands 2024-09-08 18:06:26 +02:00
umount.rst.inc docs: use DOM ready event, not document loaded event 2017-06-20 15:48:30 +02:00
usage_general.rst.inc [DOCS] #4587 – Make Sphinx warnings break docs build 2020-03-16 19:22:59 +01:00
version.rst scripts/gendocs.py: make it work 2024-02-09 17:37:38 +01:00
version.rst.inc scripts/gendocs.py: make it work 2024-02-09 17:37:38 +01:00
with-lock.rst.inc build_usage 2024-02-20 17:11:43 +01:00