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