doc/xml/AdminReference/sect5/FORCESALVAGE.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <refentry id="FORCESALVAGE5">
   3   <refmeta>
   4     <refentrytitle>FORCESALVAGE</refentrytitle>
   5     <manvolnum>5</manvolnum>
   6   </refmeta>
   7   <refnamediv>
   8     <refname>FORCESALVAGE</refname>
   9     <refpurpose>Forces salvage of entire partition</refpurpose>
  10   </refnamediv>
  11   <refsect1>
  12     <title>Description</title>
  13     <para>The <replaceable>FORCESALVAGE</replaceable> file, if present on an AFS server partition (that is,
  14     in a <replaceable>/vicep</replaceable> directory), signals that the Salvager must salvage the
  15     entire partition. The AFS-modified version of the <emphasis role="bold">fsck</emphasis> program creates
  16     the empty (zero-length) file when it discovers corruption on the
  17     partition. The Salvager removes the file when it completes the salvage
  18     operation.</para>
  19
  20     <para>When the File Server detects the presence of the file on a partition on
  21     which it is attaching volumes, it stops, detaches any volumes that are
  22     already attached, and exits after recording a message in the
  23     <replaceable>/usr/afs/logs/FileLog</replaceable> file. The Bos Server then invokes the Salvager to
  24     salvage the partition.</para>
  25
  26   </refsect1>
  27   <refsect1>
  28     <title>See Also</title>
  29     <para><link linkend="FileLog5">FileLog(5)</link>,
  30     <link linkend="bosserver8">bosserver(8)</link>,
  31     <link linkend="fileserver8">fileserver(8)</link>,
  32     <link linkend="salvager8">salvager(8)</link></para>
  33
  34   </refsect1>
  35   <refsect1>
  36     <title>Copyright</title>
  37     <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
  38
  39     <para>This documentation is covered by the IBM Public License Version 1.0.  It was
  40     converted from HTML to POD by software written by Chas Williams and Russ
  41     Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
  42
  43   </refsect1>
  44 </refentry>