doc/html/AdminReference/auarf264.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="auarf263.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="auarf265.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_LISTPART" HREF="auarf002.htm#ToC_278">vos listpart</A></H2>
  19 <A NAME="IDX5703"></A>
  20 <A NAME="IDX5704"></A>
  21 <A NAME="IDX5705"></A>
  22 <A NAME="IDX5706"></A>
  23 <A NAME="IDX5707"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Displays all AFS partitions on a file server machine
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>vos listpart -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]
  28              [<B>-localauth</B>]  [<B>-verbose</B>]  [<B>-help</B>]
  29
  30 <B>vos listp -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-v</B>]  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>vos listpart</B> command displays all of the valid AFS
  34 partitions on the indicated file server machine, without consulting the Volume
  35 Location Database (VLDB). The <B>vos partinfo</B> command reports
  36 the size of a partition and the available space on that partition.
  37 <P><STRONG>Options</STRONG>
  38 <DL>
  39 <P><DT><B>-server
  40 </B><DD>Identifies the file server machine for which to list the
  41 partitions. Provide the machine's IP address or its host name
  42 (either fully qualified or using an unambiguous abbreviation). For
  43 details, see the introductory reference page for the <B>vos</B> command
  44 suite.
  45 <P><DT><B>-cell
  46 </B><DD>Names the cell in which to run the command. Do not combine this
  47 argument with the <B>-localauth</B> flag. For more details, see the
  48 introductory <B>vos</B> reference page.
  49 <P><DT><B>-noauth
  50 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  51 issuer. Do not combine this flag with the <B>-localauth</B>
  52 flag. For more details, see the introductory <B>vos</B> reference
  53 page.
  54 <P><DT><B>-localauth
  55 </B><DD>Constructs a server ticket using a key from the local
  56 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
  57 interpreter presents it to the Volume Server and Volume Location Server during
  58 mutual authentication. Do not combine this flag with the
  59 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
  60 see the introductory <B>vos</B> reference page.
  61 <P><DT><B>-verbose
  62 </B><DD>Produces on the standard output stream a detailed trace of the
  63 command's execution. If this argument is omitted, only warnings
  64 and error messages appear.
  65 <P><DT><B>-help
  66 </B><DD>Prints the online help for this command. All other valid options
  67 are ignored.
  68 </DL>
  69 <P><STRONG>Output</STRONG>
  70 <P>The output consists of a list of partition names of the form
  71 <B>/vicep</B><VAR>xx</VAR>, following the header:
  72 <PRE>   The partitions on the server are:
  73
  74 </PRE>
  75 <P>The last line of the output reports the total number of partitions.
  76 <P><STRONG>Examples</STRONG>
  77 <P>The following command displays the partitions on
  78 <B>fs1.abc.com</B>:
  79 <PRE>   % <B>vos listpart fs1.abc.com</B>
  80    The partitions on the server are:
  81        /vicepa     /vicepb     /vicepc     /vicepd
  82    Total:  4
  83
  84 </PRE>
  85 <P><STRONG>Privilege Required</STRONG>
  86 <P>None
  87 <P><STRONG>Related Information</STRONG>
  88 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
  89 <P><A HREF="auarf269.htm#HDRVOS_PARTINFO">vos partinfo</A>
  90 <P>
  91 <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="auarf263.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="auarf265.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>
  92 <!-- Begin Footer Records  ========================================== -->
  93 <P><HR><B>
  94 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  95 </B>
  96 <!-- End Footer Records  ============================================ -->
  97 <A NAME="Bot_Of_Page"></A>
  98 </BODY></HTML>