openafs/doc/xml/AdminReference/sect5/afs_volume_header.xml
Chas Williams 52557c982e xml-docbook-documentation-first-pass-20060915
needs more massaging to make it fit the tree, but, get it here first
2006-09-16 01:13:22 +00:00

37 lines
1.6 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<refentry id="afs_volume_header5">
<refmeta>
<refentrytitle>afs_volume_header</refentrytitle>
<manvolnum>5</manvolnum>
</refmeta>
<refnamediv>
<refname>afs_volume_header</refname>
<refpurpose>Represents an AFS volume</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>The <replaceable>V</replaceable><emphasis>vol_ID</emphasis><replaceable>.vol</replaceable> file is the header file for the AFS volume with
volume ID <emphasis>vol_ID</emphasis>. There is one such file for each volume stored on an
AFS server (<replaceable>/vicep</replaceable>) partition. The header file stores information that
includes the volume's name, ID number, type (read/write, read-only, or
backup), size and status (online, offline, or busy). To display
information from the header file, use the <emphasis role="bold">vos listvol</emphasis> or <emphasis role="bold">vos examine</emphasis>
command.</para>
<para>The header file points to, but does not contain, the actual data in the
volume. It is not possible to access the AFS data except by mounting the
volume in the AFS filespace and reading its contents through the Cache
Manager.</para>
</refsect1>
<refsect1>
<title>Copyright</title>
<para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; 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>