xml-docbook-documentation-first-pass-20060915
[openafs.git] / doc / xml / AdminReference / sect8 / xfs_size_check.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="xfs_size_check8">
3   <refmeta>
4     <refentrytitle>xfs_size_check</refentrytitle>
5     <manvolnum>8</manvolnum>
6   </refmeta>
7   <refnamediv>
8     <refname>xfs_size_check</refname>
9     <refpurpose>Verifies proper IRIX inode configuration</refpurpose>
10   </refnamediv>
11   <refsect1>
12     <title>Synopsis</title>
13     <para><emphasis role="bold">xfs_size_check</emphasis></para>
14
15   </refsect1>
16   <refsect1>
17     <title>Description</title>
18     <para>The <emphasis role="bold">xfs_size_check</emphasis> command, when run on a file server machine that runs
19     IRIX version 6.2 or higher and uses XFS-formatted partitions as server
20     partitions (conventionally mounted at <replaceable>/vicep</replaceable> directories), verifies
21     that each partition uses 512-byte inodes. AFS stores information in the
22     inodes on server partitions, and the 256-byte inode size that XFS uses by
23     default is not large enough.</para>
24
25   </refsect1>
26   <refsect1>
27     <title>Cautions</title>
28     <para>This command is available on in the AFS distribution for IRIX system types
29     that can use XFS-formatted partitions as server partitions.</para>
30
31   </refsect1>
32   <refsect1>
33     <title>Output</title>
34     <para>If all server partitions are properly configured, the command produces no
35     output. Otherwise, it prints the following header:</para>
36
37 <programlisting>
38    Need to remake the following partitions:
39
40 </programlisting>
41       <para>and then the following message for each partition on which to run the IRIX
42       <emphasis role="bold">mkfs</emphasis> command with the indicated options:</para>
43
44 <programlisting>
45    &amp;lt;device&amp;gt;: mkfs -t xfs -i size=512 -l size=4000b &amp;lt;device&amp;gt;
46
47 </programlisting>
48         <para>where &lt;device&gt; is in a format like <computeroutput>/dev/dsk/dks0d0s0</computeroutput> for a single disk
49         partition or <computeroutput>/dev/xlv/xlv0</computeroutput> for a logical volume.</para>
50
51       </refsect1>
52       <refsect1>
53         <title>Privilege Required</title>
54         <para>The issuer must be logged in as the local superuser <computeroutput>root</computeroutput>.</para>
55
56       </refsect1>
57       <refsect1>
58         <title>Copyright</title>
59         <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
60
61         <para>This documentation is covered by the IBM Public License Version 1.0.  It was
62         converted from HTML to POD by software written by Chas Williams and Russ
63         Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
64
65       </refsect1>
66     </refentry>