borg/docs/usage/repo-list.rst

.. include:: repo-list.rst.inc

Examples
~~~~~~~~
::

    $ borg repo-list
    151b1a57  Mon, 2024-09-23 22:57:11 +0200  docs             tw          MacBook-Pro  this is a comment
    3387a079  Thu, 2024-09-26 09:07:07 +0200  scripts          tw          MacBook-Pro
    ca774425  Thu, 2024-09-26 10:05:23 +0200  scripts          tw          MacBook-Pro
    ba56c4a5  Thu, 2024-09-26 10:12:45 +0200  src              tw          MacBook-Pro
    7567b79a  Thu, 2024-09-26 10:15:07 +0200  scripts          tw          MacBook-Pro
    21ab3600  Thu, 2024-09-26 10:15:17 +0200  docs             tw          MacBook-Pro
    ...
docs: fix usage docs and references for repo-* commands 2024-09-08 15:18:53 +00:00			`.. include:: repo-list.rst.inc`
build_usage / build_man / doc updates 2022-06-23 23:19:19 +00:00
			`Examples`
			`~~~~~~~~`
			`::`

cli: rename r* commands to repo-* also: - adapt tests - adapt BuildMan manpage generation - adapt help strings / doc strings - docs 2024-09-08 14:26:52 +00:00			`$ borg repo-list`
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 07:27:43 +00:00			`151b1a57 Mon, 2024-09-23 22:57:11 +0200 docs tw MacBook-Pro this is a comment`
			`3387a079 Thu, 2024-09-26 09:07:07 +0200 scripts tw MacBook-Pro`
			`ca774425 Thu, 2024-09-26 10:05:23 +0200 scripts tw MacBook-Pro`
			`ba56c4a5 Thu, 2024-09-26 10:12:45 +0200 src tw MacBook-Pro`
			`7567b79a Thu, 2024-09-26 10:15:07 +0200 scripts tw MacBook-Pro`
			`21ab3600 Thu, 2024-09-26 10:15:17 +0200 docs tw MacBook-Pro`
build_usage / build_man / doc updates 2022-06-23 23:19:19 +00:00			`...`