borg-list(1)                   borg backup tool                   borg-list(1)

<?><?><?> (NAME)
       borg-list - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       borg [common options] list [options] [REPOSITORY_OR_ARCHIVE] [PATH...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> borg_patterns <?><?>
       <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> Borg <?><?> borg-common(1) <?><?><?><?><?><?>
       <?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> (arguments)

       REPOSITORY_OR_ARCHIVE
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>

       PATH   <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

   <?><?><?><?><?><?><?><?> (options)

       --consider-checkpoints
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> (checkpoint) <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?>:
              <?><?><?><?><?>).

       --short
              <?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?>/<?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>

       --format FORMAT
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?>: "{mode} {user:6}
              {group:6} {size:8} {mtime} {path}{extra}{NL}"<?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?>: "{archive:<36} {time}
              [{id}]{NL}")

       --json <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              JSON. <?><?><?><?><?><?> --format <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?> <?><?> <?><?><?><?><?> JSON <?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>. <?><?><?><?>:
              JSON <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> "barchive" <?><?> <?><?><?><?><?> <?><?><?><?>.

       --json-lines
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> JSON (JSON Lines). <?><?><?><?><?><?>
              --format <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?> JSON <?><?><?><?><?><?> <?><?><?><?><?><?><?>.
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?>. <?><?><?><?>: JSON <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?> "bpath" <?><?> <?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (Archive filters)

       -P PREFIX, --prefix PREFIX
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
              (<?><?><?><?><?> <?><?><?>)

       -a GLOB, --glob-archives GLOB
              <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> glob. <?><?><?><?><?> sh: <?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> sh:)<?> <?><?> "borg help
              patterns" <?><?><?><?><?><?> <?><?><?><?>.

       --sort-by KEYS
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?>: timestamp, archive, name,
              id<?> <?><?><?><?><?><?><?>: timestamp

       --first N
              <?><?><?><?> <?><?><?><?><?> N <?><?><?><?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?>

       --last N
              <?><?><?><?> <?><?><?><?><?> N <?><?><?><?><?><?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?>

   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>/<?><?><?><?><?><?>
       <?><?><?><?> (Include/Exclude options)

       -e PATTERN, --exclude PATTERN
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> PATTERN

       --exclude-from EXCLUDEFILE
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> EXCLUDEFILE<?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?>

       --pattern PATTERN
              <?><?><?><?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> PATTERN

       --patterns-from PATTERNFILE
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>/<?><?><?><?><?><?> <?><?> PATTERNFILE<?>
              <?><?> <?><?><?><?> <?><?> <?><?> <?><?>

<?><?><?><?><?><?><?> (EXAMPLES)

          $ borg list /path/to/repo
          Monday                               Mon, 2016-02-15 19:15:11
          repo                                 Mon, 2016-02-15 19:26:54
          root-2016-02-15                      Mon, 2016-02-15 19:36:29
          newname                              Mon, 2016-02-15 19:50:19
          ...

          $ borg list /path/to/repo::root-2016-02-15
          drwxr-xr-x root   root          0 Mon, 2016-02-15 17:44:27 .
          drwxrwxr-x root   root          0 Mon, 2016-02-15 19:04:49 bin
          -rwxr-xr-x root   root    1029624 Thu, 2014-11-13 00:08:51 bin/bash
          lrwxrwxrwx root   root          0 Fri, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
          -rwxr-xr-x root   root       2140 Fri, 2015-03-27 20:24:22 bin/bzdiff
          ...

          $ borg list /path/to/repo::root-2016-02-15 --pattern "- bin/ba*"
          drwxr-xr-x root   root          0 Mon, 2016-02-15 17:44:27 .
          drwxrwxr-x root   root          0 Mon, 2016-02-15 19:04:49 bin
          lrwxrwxrwx root   root          0 Fri, 2015-03-27 20:24:26 bin/bzcmp -> bzdiff
          -rwxr-xr-x root   root       2140 Fri, 2015-03-27 20:24:22 bin/bzdiff
          ...

          $ borg list /path/to/repo::archiveA --format="{mode} {user:6} {group:6} {size:8d} {isomtime} {path}{extra}{NEWLINE}"
          drwxrwxr-x user   user          0 Sun, 2015-02-01 11:00:00 .
          drwxrwxr-x user   user          0 Sun, 2015-02-01 11:00:00 code
          drwxrwxr-x user   user          0 Sun, 2015-02-01 11:00:00 code/myproject
          -rw-rw-r-- user   user    1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
          -rw-rw-r-- user   user    1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.text
          ...

          $ borg list /path/to/repo/::archiveA --pattern '+ re:\.ext$' --pattern '- re:^.*$'
          -rw-rw-r-- user   user    1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
          ...

          $ borg list /path/to/repo/::archiveA --pattern '+ re:.ext$' --pattern '- re:^.*$'
          -rw-rw-r-- user   user    1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.ext
          -rw-rw-r-- user   user    1416192 Sun, 2015-02-01 11:00:00 code/myproject/file.text
          ...

<?><?><?><?><?><?><?><?><?><?> (NOTES)
   <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> FORMAT (The FORMAT specifier
       syntax)
       <?><?><?><?><?> --format <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>: <https://docs
       .python.org/3.10/library/string.html#formatstrings>.

       <?><?><?><?><?><?><?>:

          $ borg list --format '{archive}{NL}' /path/to/repo
          ArchiveFoo
          ArchiveBar
          ...

          # {VAR:NUMBER} - <?><?><?><?><?><?><?><?><?><?><?> <?><?> NUMBER <?><?><?><?>.
          # <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
          # <?><?><?><?>: <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> isomtime<?> isoctime <?> isoatime <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
          $ borg list --format '{archive:36} {time} [{id}]{NL}' /path/to/repo
          ArchiveFoo                           Thu, 2021-12-09 10:22:28 [0b8e9a312bef3f2f6e2d0fc110c196827786c15eba0188738e81697a7fa3b274]
          $ borg list --format '{mode} {user:6} {group:6} {size:8} {mtime} {path}{extra}{NL}' /path/to/repo::ArchiveFoo
          -rw-rw-r-- user   user       1024 Thu, 2021-12-09 10:22:17 file-foo
          ...

          # {VAR:<NUMBER} - <?><?><?><?><?><?><?><?><?><?><?> <?><?> NUMBER <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
          # {VAR:>NUMBER} - <?><?><?><?><?><?><?><?><?><?><?> <?><?> NUMBER <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.
          $ borg list --format '{mode} {user:>6} {group:>6} {size:<8} {mtime} {path}{extra}{NL}' /path/to/repo::ArchiveFoo
          -rw-rw-r--   user   user 1024     Thu, 2021-12-09 10:22:17 file-foo
          ...

       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>:

       o NEWLINE: <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?><?><?><?>

       o NL: <?><?><?> <?><?><?><?><?><?> NEWLINE

       o NUL: <?><?><?><?><?> NUL <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
         <?><?><?><?><?> print0 / xargs -0<?> <?><?><?><?><?><?><?> barchive
         <?> bpath <?><?> <?><?> <?><?><?> <?><?><?><?><?><?>

       o SPACE: <?><?><?><?><?> <?><?><?><?><?>

       o TAB: <?><?><?><?><?> <?><?><?> (<?><?>)

       o CR: <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> (Carriage
         Return)

       o LF: <?><?><?><?><?> <?><?> (Line Feed)

       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?>:

       o archive: <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?> (<?><?><?><?> <?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
         barchive <?><?> <?><?><?><?><?><?>)

       o name: <?><?><?> <?><?><?><?><?><?> "archive"

       o barchive: <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
         <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
         <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> NUL <?><?><?><?>

       o comment: <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?> (<?><?><?><?> <?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
         bcomment <?><?> <?><?><?><?><?><?>)

       o bcomment: <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
         <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
         <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> NUL <?><?><?><?>

       o id: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>

       o tam: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> TAM <?><?><?>
         <?><?><?><?><?><?><?>

       o start: <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>

       o time: <?><?><?> <?><?><?><?><?><?> "start"

       o end: <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>

       o command_line: <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
         <?><?><?>

       o hostname: <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
         <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?>

       o username: <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
         <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>

       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?>:

       o type: <?><?><?> <?><?><?><?><?><?>

       o mode: <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>

       o uid: <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>

       o gid: <?><?><?><?><?> <?><?><?><?> <?><?><?><?>

       o user: <?><?><?> <?><?><?><?><?><?> <?><?><?><?>

       o group: <?><?><?> <?><?><?><?> <?><?><?><?>

       o path: <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
         <?><?><?> (<?><?><?><?> <?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
         bpath <?><?> <?><?><?><?><?><?>)

       o bpath: <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> POSIX
         <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> NUL
         <?><?><?><?>

       o source: <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?> (<?><?><?><?><?><?> linktarget)

       o linktarget: <?><?><?><?> <?><?><?><?><?>

       o flags: <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       o size: <?><?><?><?><?><?>

       o csize: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>

       o dsize: <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
         <?><?><?><?><?><?> (deduplicated)

       o dcsize: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
         <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       o num_chunks: <?><?><?><?><?> <?><?><?><?><?><?>
         (<?><?><?><?><?><?><?>) <?><?> <?><?><?> <?><?><?><?><?><?>

       o unique_chunks: <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
         <?><?> <?><?><?> <?><?><?><?><?><?>

       o mtime: <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>

       o ctime: <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
         <?><?><?><?><?><?>

       o atime: <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>

       o isomtime: <?><?><?><?> mtime <?><?> <?><?><?><?> ISO

       o isoctime: <?><?><?><?> ctime <?><?> <?><?><?><?> ISO

       o isoatime: <?><?><?><?> atime <?><?> <?><?><?><?> ISO

       o blake2b: <?><?> blake2b

       o blake2s: <?><?> blake2s

       o md5: <?><?> md5

       o sha1: <?><?> sha1

       o sha224: <?><?> sha224

       o sha256: <?><?> sha256

       o sha384: <?><?> sha384

       o sha3_224: <?><?> sha3_224

       o sha3_256: <?><?> sha3_256

       o sha3_384: <?><?> sha3_384

       o sha3_512: <?><?> sha3_512

       o sha512: <?><?> sha512

       o xxh64: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> XXH64 <?><?><?>
         <?><?><?><?><?><?> (<?><?><?><?>: <?><?><?> <?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>!)

       o archiveid: <?><?><?><?><?> <?><?><?><?><?><?><?>

       o archivename: <?><?><?> <?><?><?><?><?><?><?>

       o extra: <?><?><?><?><?><?> <?><?><?><?><?><?> " -> " <?><?> {source}
         <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?> " link to "
         <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>

       o health: <?><?><?><?><?> <?><?><?><?><?><?> <?><?> "healthy"
         (<?><?><?><?><?><?> <?><?><?><?>) <?><?> "broken" (<?><?>
         <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
         <?><?><?><?><?><?> <?><?><?>)

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       borg-common(1), borg-info(1), borg-diff(1), borg-prune(1),
       borg-patterns(1)

<?><?><?><?><?><?><?> (AUTHOR)
       The Borg Collective

                                  2026-07-18                      borg-list(1)