src/man/fs_flushvolume.1

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