HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

c
cfsadmin(1M) cfsadmin(1M)
NAME
cfsadmin - administer disk space used for caching file systems with the Cache File-System (CacheFS)
SYNOPSIS
cfsadmin -c [ -o cacheFS-parameters ] cache_directory
cfsadmin -d [ cache_ID | all
] cache_directory
cfsadmin -l cache_directory
cfsadmin -s [ mntpt1 ... |
all ]
cfsadmin -u [ -o cacheFS-parameters ] cache_directory
DESCRIPTION
The
cfsadmin command provides the following functions:
cache creation
deletion of cached file systems
listing of cache contents and statistics
resource parameter adjustment when the file system is unmounted.
For each form of the command, with the exception of the -s form, you must specify a cache directory, that
is, the directory under which the cache is actually stored. A path name in the front file system identifies the
cache directory. For the
-s form of the command, you must specify a mount point.
You can specify a cache ID when you mount a file system with CacheFS, or you can let the system generate
one for you. The -l option includes the cache ID in its listing of information. You must know the cache ID
to delete a cached file system.
Options
-c Create a cache under the directory specified by cache_directory. This directory must not exist
prior to cache creation.
-d Remove the file system whose cache ID you specify and release its resources, or remove all file sys-
tems in the cache by specifying
all. After deleting a file system from the cache, you must run the
fsck_cachefs(1M) command to correct the resource counts for the cache.
-l List file systems stored in the specified cache, as well as statistics about them. Each cached file sys-
tem is listed by cache ID. The statistics document resource utilization and cache resource parame-
ters.
-s Request a consistency check on the specified file system (or all cachefs mounted file systems). The
-s option will only work if the cache file system was mounted with demandconst
enabled (see
mount_cachefs(1M)). Each file in the specified cache file system is checked for consistency with its
corresponding file in the back file system. Note that the consistency check is performed file by file
as files are accessed. If no files are accessed, no checks are performed. Use of this option will not
result in a sudden "storm" of consistency checks.
-u Update resource parameters of the specified cache directory. Parameter values can only be
increased. To decrease the values, you must remove the cache and recreate it. All file systems in
the cache directory must be unmounted when you use this option. Changes will take effect the next
time you mount any file system in the specified cache directory. The -u option with no -o option
sets all parameters to their default values.
Operands
cache_directory The directory under which the cache is actually stored.
mntpt1 The directory under which the CacheFS is mounted.
CacheFS Resource Parameters
You can specify the following cacheFS resource parameters as arguments to the -o option. Separate multi-
ple parameters with commas.
maxblocks= n Maximum amount of storage space that CacheFS can use, expressed as a percentage of
the total number of blocks in the front file system. If CacheFS does not have exclusive
use of the front file system, there is no guarantee that all the space the maxblocks
parameter allows will be available. The default is 90.
HP-UX 11i Version 1: September 2005 1 Hewlett-Packard Company Section 1M129