mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 21:47:45 +00:00
71 lines
2.5 KiB
XML
71 lines
2.5 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<refentry id="fs_checkvolumes1">
|
|
<refmeta>
|
|
<refentrytitle>fs checkvolumes</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>fs checkvolumes</refname>
|
|
<refpurpose>Forces the Cache Manager to update volume information</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Synopsis</title>
|
|
<para><emphasis role="bold">fs checkvolumes</emphasis> [<emphasis role="bold">-help</emphasis>]</para>
|
|
|
|
<para><emphasis role="bold">fs checkv</emphasis> [<emphasis role="bold">-h</emphasis>]</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<para>The <emphasis role="bold">fs checkvolumes</emphasis> command discards the table of mappings between
|
|
volume names and volume ID numbers that the Cache Manager stores in memory
|
|
and uses when fetching data from volumes. The next time an application
|
|
requests AFS data, the Cache Manager must contact the Volume Location (VL)
|
|
Server for volume location information, and then an appropriate file
|
|
server machine for the actual data.</para>
|
|
|
|
<para>The Cache Manager updates the table of mappings periodically (by default,
|
|
hourly), but this command is useful if the issuer knows that a volume's
|
|
name has changed, or that new read-only replicas of a volume have been
|
|
released, because issuing it forces the Cache Manager to reference the
|
|
changed volume.</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Options</title>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term><emphasis role="bold">-help</emphasis></term>
|
|
<listitem>
|
|
<para>Prints the online help for this command. All other valid options are
|
|
ignored.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Output</title>
|
|
<para>The following message confirms that the command ran successfully.</para>
|
|
|
|
<programlisting>
|
|
All volumeID/name mappings checked.
|
|
|
|
</programlisting>
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Privilege Required</title>
|
|
<para>None</para>
|
|
|
|
</refsect1>
|
|
<refsect1>
|
|
<title>Copyright</title>
|
|
<para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
|
|
|
|
<para>This documentation is covered by the IBM Public License Version 1.0. It was
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
|
|
|
|
</refsect1>
|
|
</refentry>
|