Synopsis
mvfscache [ cache_name ]
mvfscache { –e cache_list | –d cache_list | –f cache_list }
- Display name cache contents:
mvfscache –p [ –n name ]
[ –v dbid ] [ –i ]
Options and arguments
Determining cache status.
With no options or arguments, mvfscache displays the enabled
or disabled status of all MVFS caches. If you do not use any of the options,
but specify a cache name as an argument, mvfscache does
not display any output; it returns an appropriate exit status:
- 0
- specified cache is enabled
- 1
- specified cache is disabled
Controlling cache operation. Use one of the following
options to control a cache, a set of caches, or cache-related behavior.
- –e cache-list
-
(Requires privileged user status) Enables the specified caches and
(with cto) cache-related behavior. The cache-list must
be comma-separated, with no white space, and can include one or more of the
following keywords.
- attr
- Attribute cache. Caches information about recently accessed file system
objects.
- name
- Name cache. Caches name lookup translations for recently accessed files
and directories.
- noent
- Name-not-found cache. Caches names of files and directories recently looked
up but not found.
- slink
- Symbolic link text cache. Caches the contents of recently accessed symbolic
links.
- rvc
- VOB root version cache. Caches VOB mount point data for each dynamic view.
- cto
- (cache-related behavior) Close-to-open consistency behavior. Forces a
get file info-type operation to the view server on every operating-system open operation.
Disabling this behavior may boost performance if mvfsstat shows
heavy cto activity and the user is not sharing views. However,
disabling this behavior may result in consistency loss.
- –d cache-list
-
(Requires privileged user status.) Disables the specified caches and
cache-related behavior. The syntax is the same as for –e.
- –f cache-list
-
Flushes the specified caches. Use this option only under direction
from IBM Software Support for Rational products support
for Rational® products.
The cache-list can include any of the following keywords
(comma-separated, no white space).
- mnode
- mnode freelist cache. Flushes the attr and slink caches,
open freelist files, and mnode storage for all freelist mnodes.
- name
- Name cache. (Also flushes name-not-found entries.)
- rvc
- VOB root version cache.
- lcred
- Global credentials cache for cleartext lookup permissions.
Displaying name cache contents. Use
–p by
itself or with one or more of
–n,
–v, and
–i.
The name cache contains the name lookup translations for recently accessed
files and directories. The first line of a name lookup translation has this
form:
VOB-tag view:directory-dbid name==> view:lookup-dbid
- –p
- Prints the contents of the name cache.
- –n name
- Prints only the entries in the name cache that match name.
- –v dbid
- Prints only the entries in the name cache that match directory-dbid (database-ID
for the directory in which name is found) or lookup-dbid (database-ID
for the result of the lookup).
- –i
- Includes incorrect name cache entries in the output. These are entries
that were marked as being incorrect and are not used in lookups, but are retained
for statistical purposes. This helps determine how often incorrect entries
are replaced with new data. Incorrect name cache entries usually occur when
a change in the VOB requires the MVFS to refresh its cache.