src/man/fs_flush.1

   1 fs flush                   AFS Commands                fs flush
   2
   3
   4 NAME
   5
   6    fs   flush -- force  Cache  Manager  to  discard  a  cached
   7
   8                        file/directory.
   9
  10
  11                                    +
  12    fs flush  [-path <dir/file path> ]  [-help]
  13
  14 ACCEPTABLE ABBREVIATIONS/ALIASES
  15
  16                                 +
  17    fs flush  [-p <dir/file path> ]  [-h]
  18
  19 DESCRIPTION
  20
  21    Forces the Cache Manager to remove each specified  directory
  22    or file from its caches of data and status information.  The
  23    result is that the next time data from a  flushed  directory
  24    or  file  is  requested, the Cache Manager contacts the File
  25    Server for the  most  current  version,  along  with  a  new
  26    callback  (if  necessary) and associated status information.
  27    This command does not discard data from application  program
  28    buffers  or  data that has been altered in the cache but not
  29    yet written back to the central copy maintained by the  File
  30    Server.
  31
  32    The  fs  flushvolume  command  can be used to flush all data
  33    that resides in the same  volume  as  a  specified  file  or
  34    directory.
  35
  36 ARGUMENTS
  37
  38    -path specifies  each  file  or directory to be flushed.  In
  39          the case of a  directory  element,  only  the  element
  40          itself  is  flushed,  not  data  cached  from files or
  41          subdirectories that reside in it.  If this argument is
  42          omitted, the current directory is flushed.
  43
  44    -help prints the online help entry for this command.  Do not
  45          provide any other arguments or flags  with  this  one.
  46          See  section  3.1  in  the  Reference  Manual for more
  47          details.
  48
  49 EXAMPLES
  50
  51    The following flushes from the cache the  file  projectnotes
  52    in  the  current  working  directory  and  all data from the
  53    subdirectory plans:
  54
  55    %  fs flush projectnotes ./plans/*
  56
  57 PRIVILEGE REQUIRED
  58
  59    None.
  60
  61 MORE INFORMATION
  62
  63    fs flushvolume