doc/html/AdminReference/auarf263.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="auarf262.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="auarf264.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_LISTADDRS" HREF="auarf002.htm#ToC_277">vos listaddrs</A></H2>
  19 <A NAME="IDX5698"></A>
  20 <A NAME="IDX5699"></A>
  21 <A NAME="IDX5700"></A>
  22 <A NAME="IDX5701"></A>
  23 <A NAME="IDX5702"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Displays all VLDB server entries
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>vos listaddrs</B> [<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 lista</B> [<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 listaddrs</B> command displays all of the server entries
  34 from the Volume Location Database (VLDB). An entry is created as the
  35 File Server initializes and registers the contents of its
  36 <B>/usr/afs/local/sysid</B> file in the VLDB.
  37 <P><STRONG>Options</STRONG>
  38 <DL>
  39 <P><DT><B>-cell
  40 </B><DD>Names the cell in which to run the command. Do not combine this
  41 argument with the <B>-localauth</B> flag. For more details, see the
  42 introductory <B>vos</B> reference page.
  43 <P><DT><B>-noauth
  44 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  45 issuer. Do not combine this flag with the <B>-localauth</B>
  46 flag. For more details, see the introductory <B>vos</B> reference
  47 page.
  48 <P><DT><B>-localauth
  49 </B><DD>Constructs a server ticket using a key from the local
  50 <B>/usr/afs/etc/KeyFile</B> file. The <B>vos</B> command
  51 interpreter presents it to the Volume Server and Volume Location Server during
  52 mutual authentication. Do not combine this flag with the
  53 <B>-cell</B> argument or <B>-noauth</B> flag. For more details,
  54 see the introductory <B>vos</B> reference page.
  55 <P><DT><B>-verbose
  56 </B><DD>Produces on the standard output stream a detailed trace of the
  57 command's execution. If this argument is omitted, only warnings
  58 and error messages appear.
  59 <P><DT><B>-help
  60 </B><DD>Prints the online help for this command. All other valid options
  61 are ignored.
  62 </DL>
  63 <P><STRONG>Output</STRONG>
  64 <P>The output displays all server entries from the VLDB, each on its own
  65 line. If a file server machine is multihomed, all of its registered
  66 addresses appear on the line. The first one is the one reported as a
  67 volume's site in the output from the <B>vos examine</B> and <B>vos
  68 listvldb</B> commands.
  69 <P>The VLDB records IP addresses, and the command interpreter has the local
  70 name service (either a process like the Domain Name Service or a local host
  71 table) translate them to hostnames before displaying them. If an IP
  72 address appears in the output, it is not possible to translate it.
  73 <P>The existence of an entry does not necessarily indicate that the machine
  74 that is still an active file server machine. To remove obsolete server
  75 entries, use the <B>vos changeaddr</B> command with the <B>-remove</B>
  76 argument.
  77 <P><STRONG>Examples</STRONG>
  78 <P>The following command displays the VLDB server entries in the ABC
  79 Corporation cell:
  80 <PRE>   % <B>vos listaddrs </B>
  81    sv5.abc.com
  82    sv1.abc.com
  83    sv2.abc.com  afs2.abc.com
  84    sv6.abc.com
  85
  86 </PRE>
  87 <P><STRONG>Privilege Required</STRONG>
  88 <P>None
  89 <P><STRONG>Related Information</STRONG>
  90 <P><A HREF="auarf049.htm#HDRSYSID">sysid</A>
  91 <P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
  92 <P><A HREF="auarf257.htm#HDRVOS_CHANGEADDR">vos changeaddr</A>
  93 <P><A HREF="auarf261.htm#HDRVOS_EXAMINE">vos examine</A>
  94 <P><A HREF="auarf265.htm#HDRVOS_LISTVLDB">vos listvldb</A>
  95 <P>
  96 <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="auarf262.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="auarf264.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>
  97 <!-- Begin Footer Records  ========================================== -->
  98 <P><HR><B>
  99 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 100 </B>
 101 <!-- End Footer Records  ============================================ -->
 102 <A NAME="Bot_Of_Page"></A>
 103 </BODY></HTML>