FABSYS_DUMP-LIST(1)

NAME
fabsys_dump-list - List dumps in the FABS backup database

SYNOPSIS
fabsys dump-list (<id> [<id> ...] | --all | [--brid <brid>]
    [--volid <volid> | --volume <volume>]
    [--before <time] [--after <time]
    [--redundant[=<redundancy>]]
    [-n <n_dumps>] )
    [--verbose]

DESCRIPTION
The fabsys dump-list command allows an administrator to lists dumps of volumes that have been backed up by FABS.

To search for volume dumps to restore from, see "fabsys_dump-find(1)". Both commands are similar, but dump-find has different options that are more useful when searching for a dump to restore from (such as file paths, and user authorization).

OPTIONS

<id> [<id> ...]
    If at least one numeric volume dump ID is given, fabsys dump-list will show volume dump information for those dump IDs.

    If a dump ID is given, you cannot also give any of the other search criteria options like --volume or --before.

--all
    If this flag is given, list all dumps in the database. You cannot specify this flag together with other search criteria or dump IDs.

--brid <brid>
    Search for volume dumps in the given backup run ID (brid).

--volid <volid> | --volume <volume>
    Search for volume dumps for the given volume. If --volume is given, the given volume name or volid is resolved to an RW volid in the VLDB (using vos).

    If --volid is given, fabsys dump-list interprets it as an RW volid, and it is not looked up in the VLDB. This can be useful if the given volume no longer exists, or may have a different volid in the current VLDB.

--before <time>
--after <time>
    Search for volume dumps taken before or after the given timestamp.

    The given time can be given as a unix timestamp with a leading "@" (e.g. "--before @1644102842"), or as an ISO-8601 string, or any format understood by the Python module dateutil.parser (e.g. "2022-02-05 23:14:02 UTC").

--redundant[=<redundancy>]
    Search for redundant volume dumps, with a redundancy of redundancy. If --redundant is given without specifying a value, the default redundancy is 1.

    A volume dump is considered redundant if there are at least <redundancy> newer volume dumps for the same volume. For example, if --redundancy=3 is given, fabsys dump-list will only show volume dumps if there are at least 3 newer volume dumps for the same volume.

-n <n_dumps>
    Only show a maximum of <n_dumps>. By default, fabsys dump-list will show all matching dumps.

--verbose
    Print some extra information on stderr, such as our search criteria.

EXAMPLES
    $ fabsys dump-list --volume vol.1 --before 2022-02-18 --redundant
    Volume dump id 2001, volume: 536871063 (vol.1)
      cloned at:    Mon Jan 31 16:25:07 2022
      last updated: Mon Jan 31 16:24:36 2022
      dump blob: /var/lib/fabs/fabs-dumps/cell-example.com/20/00/00/536871063/536871063.2001.dump
    Volume dump id 2003, volume: 536871063 (vol.1)
      cloned at:    Mon Feb 14 18:47:30 2022
      last updated: Mon Feb 14 18:46:57 2022
      dump blob: /var/lib/fabs/fabs-dumps/cell-example.com/20/00/00/536871063/536871063.8001.dump

PRIVILEGED REQUIRED
The issuer of this command must be able to read the FABS configuration (specifically, the database access information), typically in /etc/fabs/fabs.yaml.d/.

COPYRIGHT
Copyright (c) 2022, Sine Nomine Associates.

See the provided LICENSE file for licensing terms.