doc/html/AdminReference/auarf151.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="auarf150.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="auarf152.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_LSMOUNT" HREF="auarf002.htm#ToC_165">fs lsmount</A></H2>
  19 <A NAME="IDX4884"></A>
  20 <A NAME="IDX4885"></A>
  21 <A NAME="IDX4886"></A>
  22 <A NAME="IDX4887"></A>
  23 <A NAME="IDX4888"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Reports the volume for which a directory is the mount point.
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>fs lsmount -dir</B> &lt;<VAR>directory</VAR>><SUP>+</SUP>  [<B>-help</B>]
  28
  29 <B>fs ls -d</B> &lt;<VAR>directory</VAR>><SUP>+</SUP>  [<B>-h</B>]
  30 </PRE>
  31 <P><STRONG>Description</STRONG>
  32 <P>The <B>fs lsmount</B> command reports the volume for which each
  33 specified directory is a mount point, or indicates with an error message that
  34 a directory is not a mount point or is not in AFS.
  35 <P>To create a mount point, use the <B>fs mkmount</B> command. To
  36 remove one, use the <B>fs rmmount</B> command.
  37 <P><STRONG>Options</STRONG>
  38 <DL>
  39 <P><DT><B>-dir
  40 </B><DD>Names the directory that serves as a mount point for a volume. The
  41 last element in the pathname provided must be an actual name, not a shorthand
  42 notation such as one or two periods (<B>.</B> or
  43 <B>..</B>).
  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>If the specified directory is a mount point, the output is of the following
  50 form:
  51 <PRE>   '<VAR>directory</VAR>' is a mount point for volume '<VAR>volume&nbsp;name</VAR>'
  52
  53 </PRE>
  54 <P>where
  55 <UL>
  56 <P><LI>A number sign (<TT>#</TT>) precedes the <VAR>volume name</VAR> string for
  57 a regular mount point.
  58 <P><LI>A percent sign (<TT>%</TT>) precedes the <VAR>volume name</VAR> string for
  59 a read/write mount point.
  60 <P><LI>A cell name and colon (<TT>:</TT>) follow the number or percent
  61 sign and precede the <VAR>volume name</VAR> string for a cellular mount
  62 point.
  63 </UL>
  64 <P>The <B>fs mkmount</B> reference page explains how the Cache Manager
  65 interprets each of the three types of mount points.
  66 <P>If the directory is a symbolic link to a mount point, the output is of the
  67 form:
  68 <PRE>   '<VAR>directory</VAR>' is a symbolic link, leading to a mount point for volume '<VAR>volume&nbsp;name</VAR>'
  69
  70 </PRE>
  71 <P>If the directory is not a mount point or is not in AFS, the output
  72 reads:
  73 <PRE>   '<VAR>directory</VAR>' is not a mount point.
  74
  75 </PRE>
  76 <P>If the output is garbled, it is possible that the mount point has become
  77 corrupted in the local AFS client cache. Use the <B>fs
  78 flushmount</B> command to discard it, which forces the Cache Manager to
  79 refetch the mount point.
  80 <P><STRONG>Examples</STRONG>
  81 <P>The following example shows the mount point for the home directory of user
  82 <B>smith</B>:
  83 <PRE>   % <B>fs lsmount /afs/abc.com/usr/smith</B>
  84    '/afs/abc.com/usr/smith' is a mount point for volume '#user.smith'
  85
  86 </PRE>
  87 <P>The following example shows both the regular and read/write mount points
  88 for the ABC Corporation cell's <TT>root.cell</TT> volume.
  89 <PRE>   % <B>fs lsmount /afs/abc.com</B>
  90    '/afs/abc.com' is a mount point for volume '#root.cell'
  91
  92    % <B>fs lsmount /afs/.abc.com</B>
  93    '/afs/.abc.com' is a mount point for volume '%root.cell'
  94
  95 </PRE>
  96 <P>The following example shows a cellular mount point: the State
  97 University cell's <TT>root.cell</TT> volume as mounted in the
  98 ABC Corporation cell's tree.
  99 <PRE>   % <B>fs lsmount /afs/stateu.edu</B>
 100    '/afs/stateu.edu' is a mount point for volume '#stateu.edu:root.cell'
 101
 102 </PRE>
 103 <P><STRONG>Privilege Required</STRONG>
 104 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
 105 ACL of the root directory of the volume that houses the file or directory
 106 named by the <B>-dir</B> argument, and on the ACL of each directory that
 107 precedes it in the pathname.
 108 <P><STRONG>Related Information</STRONG>
 109 <P><A HREF="auarf141.htm#HDRFS_FLUSHMOUNT">fs flushmount</A>
 110 <P><A HREF="auarf153.htm#HDRFS_MKMOUNT">fs mkmount</A>
 111 <P><A HREF="auarf156.htm#HDRFS_RMMOUNT">fs rmmount</A>
 112 <P>
 113 <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="auarf150.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="auarf152.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>
 114 <!-- Begin Footer Records  ========================================== -->
 115 <P><HR><B>
 116 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 117 </B>
 118 <!-- End Footer Records  ============================================ -->
 119 <A NAME="Bot_Of_Page"></A>
 120 </BODY></HTML>