1xfsinvutil(8)               System Manager's Manual              xfsinvutil(8)
2
3
4

NAME

6       xfsinvutil - xfsdump inventory database checking and pruning utility
7

SYNOPSIS

9       xfsinvutil [-F|-i] [-m media_label] -M mount_point mm/dd/yyyy
10       xfsinvutil [-F|-i] [-m media_label] -u UUID mm/dd/yyyy
11       xfsinvutil [-F] -s SESSION_ID
12       xfsinvutil -i
13       xfsinvutil -C
14

DESCRIPTION

16       xfsdump  maintains  an online dump inventory in /var/lib/xfsdump/inven‐
17       tory.  The -I option of xfsdump displays the inventory contents hierar‐
18       chically.   The  levels of the hierarchy are: filesystem, dump session,
19       stream, and media file.
20
21       xfsinvutil is a utility to check this inventory  database  for  consis‐
22       tency,  to  remove  entries  of dump sessions which may no longer be of
23       relevance, and to browse the contents of the inventory.
24
25       The following command line options are available:
26
27       -F   Don't prompt the operator.  When xfsinvutil encounters a  matching
28            dump  session,  xfsinvutil will normally ask the operator for per‐
29            mission to delete the entry. With this option the deletion is per‐
30            formed, no questions asked.
31
32       -i   Interactive  mode.   Causes  xfsinvutil to run in a mode that will
33            allow the operator to browse and modify the contents of the inven‐
34            tory.  Please refer to the Interactive Mode section below for more
35            information.
36
37       -M mount_point mm/dd/yyyy
38            Prunes dump sessions identified by the  given  mount  point  which
39            were  created prior to the specified date. Optionally -m may be be
40            specified to further limit the matching  dump  sessions  by  media
41            label.   xfsinvutil  will  prompt  the operator prior to pruning a
42            dump session unless the -F or -i options are given.
43
44       -u UUID mm/dd/yyyy
45            Like -M, except the matching filesystem  is  specified  using  its
46            universally unique identifier (UUID) instead of its mount point.
47
48       -m media_label
49            If  specified,  only  sessions  with at least one media file whose
50            label matches this value  will  be  eligible  for  pruning.   This
51            restriction is in addition to those imposed by the date and the -M
52            or -u options.  This option allows the pruning  of  all  inventory
53            references  to media which may have been overwritten or lost. Note
54            that this option does not apply to sessions with no media files.
55
56       -s SESSION_ID
57            Prunes the dump session identified by the given session id.   xfs‐
58            invutil  will  prompt the operator prior to pruning a dump session
59            unless the -F option is given.
60
61       -C   With this option, xfsinvutil performs consistency checks  for  all
62            entries  in  the inventory database.  It fixes any problems found.
63            If no consistent entries are found , the  corresponding  inventory
64            database file is removed.
65
66   Interactive Mode
67       When  run  with -i, xfsinvutil will present the operator with a hierar‐
68       chical representation of the xfsdump  inventory.   In  this  mode,  the
69       operator  can  use the arrow keys (or the h j k l keys) to navigate the
70       inventory and also use the following keys and functionality:
71
72       +    Expand a branch of the tree.
73
74       -    Collapse a branch of the tree.
75
76       *    Fully expand a branch of the tree.
77
78       %    Fully collapse a branch of the tree.
79
80       h    Move selection to the parent entry.
81
82       l    Move selection to the child entry.
83
84       j    Move selection to next entry.
85
86       k    Move selection to previous entry.
87
88       d    Mark the current record, and all sub-records, to be deleted.
89
90       u    Clear the  current  record  and  all  parent  records  from  being
91            deleted.
92
93       i    Import another xfsdump inventory.
94
95       ?    Show help window.
96
97       x    Commit any changes made to the inventory, and exit the program.
98
99       q    Exit the program without committing any changes to the inventory.
100
101       Inventories  from other hosts can be imported to create a larger common
102       inventory.  It  is  recommended  that  the  contents  of  /var/lib/xfs‐
103       dump/inventory on the remote host be copied to a temporary local direc‐
104       tory prior to running xfsinvutil.  When xfsinvutil is run  in  interac‐
105       tive  mode, and the operator hits i, they will be prompted for the path
106       to the inventory to be imported.  xfsinvutil will then add the contents
107       of  the  imported inventory to the main window, and all entries will be
108       marked as imported.  The operator can then delete any of these  entries
109       that  are  not  to be imported.  When the operator commits the changes,
110       xfsinvutil will import any entries which were not  marked  as  deleted.
111       Deleted  entries  are  not  actually deleted from the original imported
112       inventory.
113

NOTES

115   Inventory
116       Each dump  session  updates  an  inventory  database  in  /var/lib/xfs‐
117       dump/inventory.   xfsdump  uses  the inventory to determine the base of
118       incremental and resumed dumps.
119
120       This database can be displayed by invoking xfsdump with the -I  option.
121       The display uses tabbed indentation to present the inventory hierarchi‐
122       cally.  The first level is filesystem.  The second  level  is  session.
123       The  third  level  is  media  stream (currently only one stream is sup‐
124       ported).  The fourth level lists the media files sequentially composing
125       the stream.
126

FILES

128       /var/lib/xfsdump/inventory
129                                dump inventory database
130

SEE ALSO

132       xfsdump(8), xfsrestore(8).
133
134
135
136                                                                 xfsinvutil(8)
Impressum