NAME

cm − Introduction to the cm command suite

OPTIONS

The following options are used with many cm commands. They are also listed with the commands that use them.  Names the files, directories, or both to be used with the command.  Prints the online help for the command. All other valid options specified with this option are ignored. For complete details about receiving help, see the dfs_intro(8dfs) reference page. 

DESCRIPTION

Commands in the cm command suite are issued by administrative users to set cache parameters and to update cached information on local workstations.  Certain commands in the cm suite are available to all users to determine machine and cell information. 

The files described in the following sections are used by the Cache Manager to determine its initial configuration and to store and track cached data. Each DFS client machine stores machine-specific versions of these files on its local disk. 

The CacheInfo File

The dcelocal/etc/CacheInfo file specifies the Cache Manager’s initial configuration. It is manually created during DFS client installation. The Cache Manager checks the file at initialization to determine certain cache configuration information. 

The file is a one-line ASCII file that contains three fields separated by colons. The fields provide the following information: The local directory where the Cache Manager mounts the DCE global namespace.  The default is the global namespace designation (/...).  The local directory to serve as the cache directory. The Cache Manager stores the CacheItems, FilesetItems, and V files in this directory. The default, dcelocal/var/adm/dfs/cache, can be overridden to direct the Cache Manager to store the files in a different directory.  The size of the cache in 1024-byte (1-kilobyte) blocks. 

The CacheItems File

The dcelocal/var/adm/dfs/cache/CacheItems file is a binary file created and maintained by the Cache Manager. The file records information such as the file ID number and data version number of each V file on a client machine using a disk cache. Never directly modify or delete this file; doing so can cause the kernel to panic. 

The FilesetItems File

The dcelocal/var/adm/dfs/cache/FilesetItems file is a binary file created and maintained by the Cache Manager. The file records the fileset-to-mount point mapping for each fileset accessed by the Cache Manager.  The mappings allow the Cache Manager to respond correctly to commands such as pwd. Never directly modify or delete this file; doing so can cause the kernel to panic. 

V Files

The dcelocal/var/adm/dfs/cache/Vn files, or V files, hold chunks of cached data on a client machine using a disk cache. In the name of an actual V file, n is an integer; each V file has a unique name (for example, V1, V2, and so on). The format of a V file depends on the information it contains. 

By default, each V file holds up to 65,536 bytes (64 kilobytes) of data. The default size can be overridden with the dfsd command. Never directly modify or delete a V file; doing so can cause the kernel to panic. 

Cautions

Specific cautionary information is included with individual commands. 

Receiving Help

There are several different ways to receive help about DFS commands. The following examples summarize the syntax for the different help options: Displays the reference page for the command suite.  Displays the reference page for an individual command. You must use an _ (underscore) to connect the command suite to the command name. Do not use the underscore when issuing the command in DFS.  Displays a list of commands in a command suite.  Displays the syntax for a single command.  Displays a short description of any commands that match the specified string. 

Consult the dfs_intro(8dfs) reference page for complete information about the DFS help facilities. 

Privilege Required

Specific privileges required by each command are listed with individual commands. 

RELATED INFORMATION

Commands: cm apropos(8dfs), cm checkfilesets(8dfs), cm flush(8dfs), cm flushfileset(8dfs), cm getcachesize(8dfs), cm getdevok(8dfs), cm getsetuid(8dfs), cm help(8dfs), cm lscellinfo(8dfs), cm lsstores(8dfs), cm resetstores(8dfs), cm setcachesize(8dfs), cm setdevok(8dfs), cm setsetuid(8dfs), cm statservers(8dfs), cm sysname(8dfs), cm whereis(8dfs), dfs_intro(8dfs), dfsd(8dfs)

Files: CacheInfo(4dfs), CacheItems(4dfs), FilesetItems(4dfs), Vn(4dfs)