2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 23:51:04 +00:00
|
|
|
fs_flushvolume - Forces the Cache Manager to discard cached data from a volume
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<fs flushvolume> S<<< [B<-path> <I<dir/file path>>+] >>> [B<-help>]
|
|
|
|
|
|
|
|
B<fs flushv> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-h>]
|
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The B<fs flushvolume> command removes from the cache all data that was
|
|
|
|
fetched from the same volume as each specified directory or file. It does
|
|
|
|
not discard cached status information. The next time an application
|
|
|
|
requests data from a flushed directory or file, the Cache Manager fetches
|
|
|
|
the most current version from a File Server, along with a new callback (if
|
|
|
|
necessary) and associated status information. This command has no effect
|
|
|
|
on two types of data:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=over 4
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item *
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Data in application program buffers.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
|
|
|
Data that has been changed locally and written to the cache but not yet
|
2005-12-09 14:48:56 +00:00
|
|
|
written to the copy on the file server machine.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=back
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
To discard the data and status information associated with individual
|
|
|
|
files and directories, use the B<fs flush> command. To flush a corrupted
|
|
|
|
mount point, use the B<fs flushmount> command.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-path> <I<dir/file path>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Names a file or directory from each volume for which to discard all cached
|
|
|
|
data. Partial pathnames are interpreted relative to the current working
|
|
|
|
directory, which is also the default value if this argument is omitted.
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
The following command flushes from the cache all data fetched from the
|
|
|
|
volume that contains the current working directory:
|
|
|
|
|
2005-12-21 00:41:17 +00:00
|
|
|
% fs flushvolume
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-09 14:48:56 +00:00
|
|
|
The issuer must have the C<l> (lookup) permission on the ACL of the root
|
|
|
|
directory of the volume that houses the file or directory named by the
|
|
|
|
B<-path> argument, and on the ACL of each directory that precedes it in
|
|
|
|
the pathname.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<fs_flush(1)>,
|
|
|
|
L<fs_flushmount(1)>
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|