mvfscache

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 might boost performance if mvfsstat shows heavy cto activity and the user is not sharing views. However, disabling this behavior might 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 HCL Software Customer Support for HCL 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.