doc/html/AdminReference/auarf142.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="auarf141.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="auarf143.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_FLUSHVOLUME" HREF="auarf002.htm#ToC_156">fs flushvolume</A></H2>
  19 <A NAME="IDX4819"></A>
  20 <A NAME="IDX4820"></A>
  21 <A NAME="IDX4821"></A>
  22 <A NAME="IDX4822"></A>
  23 <A NAME="IDX4823"></A>
  24 <A NAME="IDX4824"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Forces the Cache Manager to discard all cached data from the volume
  27 containing a file or directory
  28 <P><STRONG>Synopsis</STRONG>
  29 <PRE><B>fs flushvolume</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  30
  31 <B>fs flushv</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 flushvolume</B> command removes from the cache all data that
  35 was fetched from the same volume as each specified directory or file.
  36 It does not discard cached status information. The next time an
  37 application requests data from a flushed directory or file, the Cache Manager
  38 fetches the most current version from a File Server, along with a new callback
  39 (if necessary) and associated status information. This command has no
  40 effect on two types of data:
  41 <OL TYPE=1>
  42 <P><LI>Data in application program buffers
  43 <P><LI>Data that has been changed locally and written to the cache but not yet
  44 written to the copy on the file server machine
  45 </OL>
  46 <P>To discard the data and status information associated with individual files
  47 and directories, use the <B>fs flush</B> command. To flush a
  48 corrupted mount point, use the <B>fs flushmount</B> command.
  49 <P><STRONG>Options</STRONG>
  50 <DL>
  51 <P><DT><B>-path
  52 </B><DD>Names a file or directory from each volume for which to discard all cached
  53 data. Partial pathnames are interpreted relative to the current working
  54 directory, which is also the default value if this argument is omitted.
  55 <P><DT><B>-help
  56 </B><DD>Prints the online help for this command. All other valid options
  57 are ignored.
  58 </DL>
  59 <P><STRONG>Examples</STRONG>
  60 <P>The following command flushes from the cache all data fetched from the
  61 volume that contains the current working directory:
  62 <PRE>   % <B>fs flushvolume </B>
  63
  64 </PRE>
  65 <P><STRONG>Privilege Required</STRONG>
  66 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
  67 ACL of the root directory of the volume that houses the file or directory
  68 named by the <B>-path</B> argument, and on the ACL of each directory that
  69 precedes it in the pathname.
  70 <P><STRONG>Related Information</STRONG>
  71 <P><A HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
  72 <P><A HREF="auarf141.htm#HDRFS_FLUSHMOUNT">fs flushmount</A>
  73 <P>
  74 <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="auarf141.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="auarf143.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>
  75 <!-- Begin Footer Records  ========================================== -->
  76 <P><HR><B>
  77 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
  78 </B>
  79 <!-- End Footer Records  ============================================ -->
  80 <A NAME="Bot_Of_Page"></A>
  81 </BODY></HTML>