[BACK]Return to xfsinvutil.html CVS log [TXT][DIR] Up to [Development] / xfs-website.orig / manpages
File: [Development] / xfs-website.orig / manpages / xfsinvutil.html (download) (as text)

Revision 1.4, Thu Jan 25 19:55:31 2001 UTC (16 years, 8 months ago) by xfs
Branch: MAIN
CVS Tags: HEAD
Changes since 1.3: +65 -54 lines 

Man pages update.

<html>
<head>
<meta name="Content-Style" content="text/css">
</head>
<body>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#NOTES">NOTES</a><br>
<a href="#Inventory">Inventory</a><br>
<a href="#FILES">FILES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<!-- Creator     : groff version 1.16.1  -->
<!-- CreationDate: Wed Jan 24 01:42:51 2001
 -->
<!-- Total number of pages: 1 -->
<!-- Page: 1 -->
<!-- left  margin: 220 -->
<!-- right margin: 750 -->
<a name="NAME"></a><h2>NAME</h2><p style="margin-left: 18%"><font size=3>xfsinvutil - xfsdump inventory database checking and pruning utility</font></p>
<a name="SYNOPSIS"></a><h2>SYNOPSIS</h2><p style="margin-left: 18%"><font size=3><B>xfsinvutil</B></font> <font size=3>[</font> <font size=3><B>-M</B></font> <font size=3>mountpoint mm/dd/yyyy (prune all entries older than</font>
<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="25%">
</p>
</td>
<td valign="top" align="left" width="74%">
<p><font size=3>specified date for the specified mount point) ]</font></p>
</td>
</tr>
</table>

<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="22%">
</p>
</td>
<td valign="top" align="left" width="77%">
<p><font size=3>[</font> <font size=3><B>-C</B></font> <font size=3>(check and fix xfsdump inventory database inconsistencies)]</font></p>
</td>
</tr>
</table>

<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="22%">
</p>
</td>
<td valign="top" align="left" width="77%">
<p><font size=3>[</font> <font size=3><B>&shy;n</B></font> <font size=3>(no questions)]</font></p>
</td>
</tr>
</table>
</p>
<a name="DESCRIPTION"></a><h2>DESCRIPTION</h2><p style="margin-left: 18%"><font size=3><I>xfsdump</I></font> <font size=3>maintains an online dump inventory in</font> <font size=3><I>/var/xfsdump/inventory</I></font><font size=3>. The</font> <font size=3><B>-I</B></font> <font size=3>option of xfsdump displays the inventory contents hierarchically. The levels of the hierarchy are: filesystem, dump session, stream, and media file.</font></p>
<p style="margin-left: 18%"><font size=3>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.</font></p>
<p style="margin-left: 18%"><font size=3><I>xfsinvutil</I></font> <font size=3>is an utility to check this inventory database for consistency and to remove entries of dump sessions which may no longer be of relevance.</font></p>
<p style="margin-left: 18%"><font size=3>The following command line options are available:</font></p>
<p style="margin-left: 18%"><font size=3><B>-M</B></font> <font size=3><I>mountpoint mm/dd/yyyy</I></font>
<table width="99%" rules="none" frame="none" cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="23%">
</p>
</td>
<td valign="top" align="left" width="76%">
<p><font size=3>Specifies the mount point and cut&shy;off date of inventory entries to be selected for pruning. xfsinvutil prompts the operator when a dump session in the inventory is identified by the mount point and was created prior to the specified date. The operator can then select specific dump sessions for removal from the inventory database. This prompt will not happen if the</font> <font size=3><B>-n</B></font> <font size=3>option is used; it will be assumed that the pruning is wanted.</font> <font size=3><I>xfsinvutil</I></font> <font size=3>also performs consistency checks on other inventory database entries when invoked with this option.</font></p>
<p><font size=3>The</font> <font size=3><I>mountpoint</I></font> <font size=3>must match the mount point as specified in the inventory shown using</font> <font size=3><I>xfsdump</I></font> <font size=3>with the</font> <font size=3><B>-I</B></font> <font size=3>option. This includes the host name and the mount path.</font></p>
</td>
</tr>
</table>

<table width="98%" rules="none" frame="none" cols="3" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</p>
</td>
<td valign="top" align="left" width="4%">
<p><font size=3><B>-C</B></font></p>
</td>
<td valign="top" align="left" width="76%">
<p><font size=3>With this option,</font> <font size=3><I>xfsinvutil</I></font> <font size=3>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.</font></p>
</td>
</tr>
<tr valign="top" align="left">
<td valign="top" align="left" width="18%">
</td>
<td valign="top" align="left" width="4%">
<p><font size=3><B>-n</B></font></p>
</td>
<td valign="top" align="left" width="76%">
<p><font size=3>With this option,</font> <font size=3><I>xfsinvutil</I></font> <font size=3>will not ask any confirmation questions regarding sessions to prune. (It is the &quot;Nike&quot; option).</font></p>
</td>
</tr>
</table>
</p>
<a name="NOTES"></a><h2>NOTES</h2><a name="Inventory"></a><h2>Inventory</h2><p style="margin-left: 16%"><font size=3>Each dump session updates an inventory database in</font> <font size=3><I>/var/xfsdump/inventory</I></font><font size=3>.</font> <font size=3><I>xfsdump</I></font> <font size=3>uses the inventory to determine the base of incremental and resumed dumps.</font></p>
<p style="margin-left: 16%"><font size=3>This database can be displayed by invoking</font> <font size=3><I>xfsdump</I></font> <font size=3>with the</font> <font size=3><B>-I</B></font> <font size=3>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.</font></p>
<a name="FILES"></a><h2>FILES</h2><p style="margin-left: 18%"><font size=3>/var/xfsdump/inventory dump inventory database</font></p>
<a name="SEE ALSO"></a><h2>SEE ALSO</h2><p style="margin-left: 18%"><font size=3>xfsdump(8), xfsrestore(8).</font><br>
</p>
</body>
</html>