doc/html/AdminReference/auarf166.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="auarf165.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="auarf167.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="HDRFS_WHEREIS" HREF="auarf002.htm#ToC_180">fs whereis</A></H2>
  19 <A NAME="IDX5001"></A>
  20 <A NAME="IDX5002"></A>
  21 <A NAME="IDX5003"></A>
  22 <A NAME="IDX5004"></A>
  23 <A NAME="IDX5005"></A>
  24 <A NAME="IDX5006"></A>
  25 <A NAME="IDX5007"></A>
  26 <P><STRONG>Purpose</STRONG>
  27 <P>Reports the name of each file server machine housing a file or directory
  28 <P><STRONG>Synopsis</STRONG>
  29 <PRE><B>fs whereis</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  30
  31 <B>fs whe</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>fs whereis</B> command returns the name of each file server
  35 machine that houses the volume containing each directory or file named by the
  36 <B>-path</B> argument.
  37 <P><STRONG>Options</STRONG>
  38 <DL>
  39 <P><DT><B>-path
  40 </B><DD>Names each AFS file or directory for which to return the host file server
  41 machine. Partial pathnames are interpreted relative to the current
  42 working directory, which is also the default value if this argument is
  43 omitted.
  44 <P><DT><B>-help
  45 </B><DD>Prints the online help for this command. All other valid options
  46 are ignored.
  47 </DL>
  48 <P><STRONG>Output</STRONG>
  49 <P>The output includes a line for each specified directory or file. It
  50 names the file server machine on which the volume that houses the specified
  51 directory or file resides. A list of multiple machines indicates that
  52 the directory or file is in a replicated volume.
  53 <P>Machine names usually have a suffix indicating their cell
  54 membership. If the cell is not clear, use the <B>fs whichcell</B>
  55 command to display the cell in which the directory or file resides. To
  56 display the cell membership of the local machine, use the <B>fs wscell</B>
  57 command.
  58 <P><STRONG>Examples</STRONG>
  59 <P>The following example indicates that volume housing the directory
  60 <B>/afs/abc.com</B> resides is replicated on both
  61 <B>fs1.abc.com</B> and
  62 <B>fs3.abc.com</B>:
  63 <PRE>   % <B>fs whereis -path /afs/abc.com</B>
  64    File /afs/abc.com is on hosts fs1.abc.com fs3.abc.com
  65
  66 </PRE>
  67 <P><STRONG>Privilege Required</STRONG>
  68 <P>None
  69 <P><STRONG>Related Information</STRONG>
  70 <P><A HREF="auarf167.htm#HDRFS_WHICHCELL">fs whichcell</A>
  71 <P><A HREF="auarf168.htm#HDRFS_WSCELL">fs wscell</A>
  72 <P>
  73 <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="auarf165.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="auarf167.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>
  74 <!-- Begin Footer Records  ========================================== -->
  75 <P><HR><B>
  76 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  77 </B>
  78 <!-- End Footer Records  ============================================ -->
  79 <A NAME="Bot_Of_Page"></A>
  80 </BODY></HTML>