2016-07-05 21:30:08 +00:00
|
|
|
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
|
|
2015-11-13 15:42:16 +00:00
|
|
|
.. _borg_list:
|
|
|
|
|
|
|
|
|
|
borg list
|
|
|
|
|
---------
|
|
|
|
|
::
|
|
|
|
|
|
2016-04-09 23:28:18 +00:00
|
|
|
borg list <options> REPOSITORY_OR_ARCHIVE PATH
|
|
|
|
|
|
|
|
|
|
positional arguments
|
|
|
|
|
REPOSITORY_OR_ARCHIVE
|
|
|
|
|
repository/archive to list contents of
|
|
|
|
|
PATH
|
|
|
|
|
paths to list; patterns are supported
|
|
|
|
|
|
|
|
|
|
optional arguments
|
|
|
|
|
``--short``
|
|
|
|
|
| only print file/directory names, nothing else
|
|
|
|
|
``--format``, ``--list-format``
|
|
|
|
|
| specify format for file listing
|
|
|
|
|
| (default: "{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NL}")
|
|
|
|
|
``-e PATTERN``, ``--exclude PATTERN``
|
|
|
|
|
| exclude paths matching PATTERN
|
|
|
|
|
``--exclude-from EXCLUDEFILE``
|
|
|
|
|
| read exclude patterns from EXCLUDEFILE, one per line
|
|
|
|
|
|
|
|
|
|
`Common options`_
|
|
|
|
|
|
|
|
|
|
|
|
2016-10-01 16:23:36 +00:00
|
|
|
filters
|
|
|
|
|
``-P``, ``--prefix``
|
|
|
|
|
| only consider archive names starting with this prefix
|
|
|
|
|
``--sort-by``
|
|
|
|
|
| Comma-separated list of sorting keys; valid keys are: timestamp, name, id; default is: timestamp
|
|
|
|
|
``--first N``
|
|
|
|
|
| consider first N archives after other filters were applied
|
|
|
|
|
``--last N``
|
|
|
|
|
| consider last N archives after other filters were applied
|
|
|
|
|
|
2015-11-13 15:42:16 +00:00
|
|
|
Description
|
|
|
|
|
~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
This command lists the contents of a repository or an archive.
|
2016-03-18 11:17:57 +00:00
|
|
|
|
|
|
|
|
See the "borg help patterns" command for more help on exclude patterns.
|
|
|
|
|
|
2016-06-21 13:18:19 +00:00
|
|
|
The following keys are available for --format:
|
|
|
|
|
- NEWLINE: OS dependent line separator
|
|
|
|
|
- NL: alias of NEWLINE
|
|
|
|
|
- NUL: NUL character for creating print0 / xargs -0 like output, see barchive/bpath
|
|
|
|
|
- SPACE
|
|
|
|
|
- TAB
|
|
|
|
|
- CR
|
|
|
|
|
- LF
|
|
|
|
|
|
|
|
|
|
-- Keys for listing repository archives:
|
|
|
|
|
- archive: archive name interpreted as text (might be missing non-text characters, see barchive)
|
|
|
|
|
- barchive: verbatim archive name, can contain any character except NUL
|
|
|
|
|
- time: time of creation of the archive
|
|
|
|
|
- id: internal ID of the archive
|
2016-03-18 11:17:57 +00:00
|
|
|
|
2016-06-21 13:18:19 +00:00
|
|
|
-- Keys for listing archive files:
|
2016-03-18 12:29:49 +00:00
|
|
|
- type
|
|
|
|
|
- mode
|
|
|
|
|
- uid
|
|
|
|
|
- gid
|
|
|
|
|
- user
|
|
|
|
|
- group
|
|
|
|
|
- path: path interpreted as text (might be missing non-text characters, see bpath)
|
2016-03-18 11:17:57 +00:00
|
|
|
- bpath: verbatim POSIX path, can contain any character except NUL
|
2016-03-18 12:29:49 +00:00
|
|
|
- source: link target for links (identical to linktarget)
|
|
|
|
|
- linktarget
|
2016-06-21 13:18:19 +00:00
|
|
|
- flags
|
2016-03-18 12:29:49 +00:00
|
|
|
|
|
|
|
|
- size
|
2016-03-18 11:17:57 +00:00
|
|
|
- csize: compressed size
|
2016-03-18 12:29:49 +00:00
|
|
|
- num_chunks: number of chunks in this file
|
|
|
|
|
- unique_chunks: number of unique chunks in this file
|
|
|
|
|
|
|
|
|
|
- mtime
|
2016-03-18 11:17:57 +00:00
|
|
|
- ctime
|
2016-03-18 12:29:49 +00:00
|
|
|
- atime
|
2016-03-18 11:17:57 +00:00
|
|
|
- isomtime
|
2016-03-18 12:29:49 +00:00
|
|
|
- isoctime
|
|
|
|
|
- isoatime
|
|
|
|
|
|
2016-03-18 11:17:57 +00:00
|
|
|
- md5
|
|
|
|
|
- sha1
|
|
|
|
|
- sha224
|
|
|
|
|
- sha256
|
|
|
|
|
- sha384
|
|
|
|
|
- sha512
|
2016-03-18 12:29:49 +00:00
|
|
|
|
|
|
|
|
- archiveid
|
|
|
|
|
- archivename
|
|
|
|
|
- extra: prepends {source} with " -> " for soft links and " link to " for hard links
|
