pam-afs-new-features-20010907
[openafs.git] / doc / html / AdminReference / auarf141.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="auarf140.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="auarf142.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_FLUSHMOUNT" HREF="auarf002.htm#ToC_155">fs flushmount</A></H2>
19 <A NAME="IDX4813"></A>
20 <A NAME="IDX4814"></A>
21 <A NAME="IDX4815"></A>
22 <A NAME="IDX4816"></A>
23 <A NAME="IDX4817"></A>
24 <A NAME="IDX4818"></A>
25 <P><STRONG>Purpose</STRONG>
26 <P>Forces the Cache Manager to discard a mount point
27 <P><STRONG>Synopsis</STRONG>
28 <PRE><B>fs flushmount</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
29    
30 <B>fs flushm</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
31 </PRE>
32 <P><STRONG>Description</STRONG>
33 <P>The <B>fs flushmount</B> command removes from the cache all information
34 associated with each mount point named by the <B>-path</B>
35 argument. The next time an application accesses the mount point, the
36 Cache Manager fetches the most current version of it from the File
37 Server. Data cached from the associated volume is not affected.
38 <P>The command's intended use is to discard information about mount
39 points that has become corrupted in the cache. (The Cache Manager
40 periodically refreshes cached mount points, but the only other way to discard
41 them immediately is to reinitialize the Cache Manager by rebooting the
42 machine.) Symptoms of a corrupted mount point included garbled output
43 from the <B>fs lsmount</B> command, and failed attempts to change
44 directory to or list the contents of a mount point.
45 <P>To flush cached data rather than a mount point, use the <B>fs flush</B>
46 or <B>fs flushvolume</B> command.
47 <P><STRONG>Options</STRONG>
48 <DL>
49 <P><DT><B>-path
50 </B><DD>Names each mount point to flush from the cache. Partial pathnames
51 are interpreted relative to the current working directory, which is also the
52 default value if this argument is omitted.
53 <P><DT><B>-help
54 </B><DD>Prints the online help for this command. All other valid options
55 are ignored.
56 </DL>
57 <P><STRONG>Examples</STRONG>
58 <P>The following command flushes from the cache the mount point for user
59 <B>pat</B>'s home directory:
60 <PRE>   % <B>fs flushm /afs/abc.com/usr/pat</B>
61    
62 </PRE>
63 <P><STRONG>Privilege Required</STRONG>
64 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
65 ACL of the root directory of the volume that houses the file or directory
66 named by the <B>-path</B> argument, and on the ACL of each directory that
67 precedes it in the pathname.
68 <P><STRONG>Related Information</STRONG>
69 <P><A HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
70 <P><A HREF="auarf142.htm#HDRFS_FLUSHVOLUME">fs flushvolume</A>
71 <P><A HREF="auarf151.htm#HDRFS_LSMOUNT">fs lsmount</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="auarf140.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="auarf142.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>