initial-html-documentation-20010606
[openafs.git] / doc / html / AdminReference / auarf269.htm
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
2 <HTML><HEAD>
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records  ========================================== -->
5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
10 </HEAD><BODY>
11 <!-- (C) IBM Corporation 2000. All Rights Reserved    --> 
12 <BODY bgcolor="ffffff"> 
13 <!-- End Header Records  ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Administration Reference</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf268.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf270.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
17 <P>
18 <H2><A NAME="HDRVOS_PARTINFO" HREF="auarf002.htm#ToC_283">vos partinfo</A></H2>
19 <A NAME="IDX5775"></A>
20 <A NAME="IDX5776"></A>
21 <A NAME="IDX5777"></A>
22 <A NAME="IDX5778"></A>
23 <A NAME="IDX5779"></A>
24 <A NAME="IDX5780"></A>
25 <A NAME="IDX5781"></A>
26 <P><STRONG>Purpose</STRONG>
27 <P>Reports the available and total space on a partition
28 <P><STRONG>Synopsis</STRONG>
29 <PRE><B>vos partinfo -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-partition</B> &lt;<VAR>partition&nbsp;name</VAR>>] 
30              [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-verbose</B>]  [<B>-help</B>]
31    
32 <B>vos p -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-p</B> &lt;<VAR>partition&nbsp;name</VAR>>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  
33       [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
34 </PRE>
35 <P><STRONG>Description</STRONG>
36 <P>The <B>vos partinfo</B> command reports the amount of space available
37 and total size on <B>either</B> all of the partitions on the indicated
38 file server machine (if the <B>-partition</B> argument is omitted)
39 <B>or</B> the specified partition on that file server machine. The
40 Volume Location Database (VLDB) is not consulted.
41 <P><STRONG>Options</STRONG>
42 <DL>
43 <P><DT><B>-server
44 </B><DD>Identifies the file server machine for which to display partition
45 information. Provide the machine's IP address or its host name
46 (either fully qualified or using an unambiguous abbreviation). For
47 details, see the introductory reference page for the <B>vos</B> command
48 suite.
49 <P><DT><B>-partition
50 </B><DD>Identifies which partition on the file server machine specified by the
51 <B>-server</B> argument for which to display information. Provide
52 the partition's complete name with preceding slash (for example,
53 <B>/vicepa</B>) or use one of the three acceptable abbreviated
54 forms. For details, see the introductory reference page for the
55 <B>vos</B> command suite.
56 <P><DT><B>-cell
57 </B><DD>Names the cell in which to run the command. Do not combine this
58 argument with the <B>-localauth</B> flag. For more details, see the
59 introductory <B>vos</B> reference page.
60 <P><DT><B>-noauth
61 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
62 issuer. Do not combine this flag with the <B>-localauth</B>
63 flag. For more details, see the introductory <B>vos</B> reference
64 page.
65 <P><DT><B>-localauth
66 </B><DD>Constructs a server ticket using a key from the local
67 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
68 interpreter presents it to the Volume Server and Volume Location Server during
69 mutual authentication. Do not combine this flag with the
70 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
71 see the introductory <B>vos</B> reference page.
72 <P><DT><B>-verbose
73 </B><DD>Produces on the standard output stream a detailed trace of the
74 command's execution. If this argument is omitted, only warnings
75 and error messages appear.
76 <P><DT><B>-help
77 </B><DD>Prints the online help for this command. All other valid options
78 are ignored.
79 </DL>
80 <P><STRONG>Cautions</STRONG>
81 <P>The partition-related statistics in this command's output do not
82 always agree with the corresponding values in the output of the standard UNIX
83 <B>df</B> command. The statistics reported by this command can be
84 up to five minutes old, because the Cache Manager polls the File Server for
85 partition information at that frequency. Also, on some operating
86 systems, the <B>df</B> command's report of partition size includes
87 reserved space not included in this command's calculation, and so is
88 likely to be about 10% larger.
89 <P><STRONG>Output</STRONG>
90 <P>The output reports the amount of space available and total space for each
91 specified partition.
92 <P><STRONG>Examples</STRONG>
93 <P>The following command displays all partitions on the file server machine
94 <B>fs2.abc.com</B>.
95 <PRE>   % <B>vos partinfo fs2.abc.com</B>
96    Free space on partition /vicepa: 27301 K blocks out of total 549197
97    Free space on partition /vicepb: 13646 K blocks out of total 69194
98    Free space on partition /vicepc: 31798 K blocks out of total 320315
99    Free space on partition /vicepd: 33302 K blocks out of total 494954
100    
101 </PRE>
102 <P><STRONG>Privilege Required</STRONG>
103 <P>None
104 <P><STRONG>Related Information</STRONG>
105 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
106 <P><A HREF="auarf264.htm#HDRVOS_LISTPART">vos listpart</A>
107 <P>
108 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf268.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf270.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P> 
109 <!-- Begin Footer Records  ========================================== -->
110 <P><HR><B> 
111 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved 
112 </B> 
113 <!-- End Footer Records  ============================================ -->
114 <A NAME="Bot_Of_Page"></A>
115 </BODY></HTML>