1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records ========================================== -->
5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID -->
6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29 -->
7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
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>
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> <<VAR>directory</VAR>><SUP>+</SUP> [<B>-help</B>]
29 <B>fs ls -d</B> <<VAR>directory</VAR>><SUP>+</SUP> [<B>-h</B>]
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>
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
45 </B><DD>Prints the online help for this command. All other valid options
48 <P><STRONG>Output</STRONG>
49 <P>If the specified directory is a mount point, the output is of the following
51 <PRE> '<VAR>directory</VAR>' is a mount point for volume '<VAR>volume name</VAR>'
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
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
68 <PRE> '<VAR>directory</VAR>' is a symbolic link, leading to a mount point for volume '<VAR>volume name</VAR>'
71 <P>If the directory is not a mount point or is not in AFS, the output
73 <PRE> '<VAR>directory</VAR>' is not a mount point.
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
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'
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'
92 % <B>fs lsmount /afs/.abc.com</B>
93 '/afs/.abc.com' is a mount point for volume '%root.cell'
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'
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>
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 ========================================== -->
116 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
118 <!-- End Footer Records ============================================ -->
119 <A NAME="Bot_Of_Page"></A>