cm flush(8dfs)

Forces the Cache Manager to discard data cached from specified files or directories

Synopsis

cm flush [-path {filename | directory_name}...] [-help]

Options
-path {filename | directory_name}
Specifies each file or directory to be flushed. A file for which a full path name is not specified is assumed to reside in the current working directory. In the case of a directory, all the name mappings and blocks associated with the directory are flushed; data cached from files or subdirectories that reside in the directory is not flushed. If this option is omitted, the current working directory is flushed.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The cm flush command forces the Cache Manager to flush data cached from each file or directory specified with the -path option. All data cached from these files and directories is discarded. The next time the data is requested, the Cache Manager contacts the File Exporter to obtain the current version, along with new tokens and other associated status information.

This command does not discard any altered data in the cache not written to the central copy maintained by the File Exporter. It also does not affect data in the buffers of application programs.

It is also possible to flush all cached data that resides in the same fileset as a specific file or directory with the cm flushfileset command. To force the Cache Manager to update fileset-related information, use the cm checkfilesets command.

Privilege Required
No privileges are required.

Examples
The following command flushes the file projectnotes, which is in the current working directory, and all data from the subdirectory plans from the cache:

$ cm flush projectnotes plans/*

Related Information
Commands: cm checkfilesets(8dfs)

cm flushfileset(8dfs)