xfsinvutil(1M)

NAME
     xfsinvutil - xfsdump inventory database checking and pruning utility

SYNOPSIS
     xfsinvutil [ -M mountpoint mm/dd/yyyy (prune all entries older than
                     specified date for the specified mount point) ]
             [ -C (check and fix xfsdump inventory database inconsistencies)]

DESCRIPTION
     xfsdump maintains an online dump inventory in /var/xfsdump/inventory.
     The -I option of xfsdump displays the inventory contents hierarchically.
     The levels of the hierarchy are:  filesystem, dump session, stream, and
     media file.

     Over time, this database may grow too large as xfsdump and xfsrestore do
     not remove entries from the inventory. The database may also develop
     inconsistencies due to various reasons such as operator errors etc.,
     causing xfsdump or xfsrestore to print error or warning messages.

     xfsinvutil is an utility to check this inventory database for consistency
     and to remove entries of dump sessions which may no longer be of
     relevance.

     The following command line options are available:

     -M mountpoint mm/dd/yyyy
          Specifies the mount point of the inventory entry to be selected for
          pruning. xfsinvutil prompts the operator when an inventory entry for
          a filesystem at the specified mount point is found. If selected ,
          all inventory entries for that filesystem older than the specified
          date are removed. xfsinvutil also performs consistency checks on
          other inventory database entries when invoked with this option.

     -C   With this option, xfsinvutil performs consistency checks for all
          entries in the inventory database.  It fixes any problems found. If
          no consistent entries are found , the corresponding inventory
          database file is removed.

NOTES
   Inventory
     Each dump session updates an inventory database in
     /var/xfsdump/inventory.  xfsdump uses the inventory to determine the base
     of incremental and resumed dumps.

     This database can be displayed by invoking xfsdump with the -I option.
     The display uses tabbed indentation to present the inventory
     hierarchically.  The first level is filesystem.  The second level is
     session.  The third level is media stream (currently only one stream is
     supported).  The fourth level lists the media files sequentially
     composing the stream.
FILES
     /var/xfsdump/inventory   dump inventory database

SEE ALSO
     xfsdump(1M), xfsrestore(1M).

BUGS
     xfsinvutil does not allow dump session level granularity for selection of
     pruning.

     xfsinvutil does not check StObj files of the inventory database.