cfsadmin.1m (2010 09)

c
cfsadmin(1M) cfsadmin(1M)
NAME
cfsadmin - administer disk space used for caching file systems with the Cache File-System (CacheFS)
SYNOPSIS
/usr/sbin/cfsadmin -c
[ -o CacheFS-parameters ] cache_directory
/usr/sbin/cfsadmin -d
{ cache_ID | all
} cache_directory
/usr/sbin/cfsadmin -l
cache_directory
/usr/sbin/cfsadmin -s
{ mntpt1 ... }
| all
/usr/sbin/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 gen-
erate 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
systems in the cache by specifying
all. After deleting a file system from the cache, you must
run the fsck_cachefs 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
system is listed by cache ID. The statistics document resource utilization and cache resource
parameters.
-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 con-
sistency 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.
cache_ID Cache ID is a string that specifies a particular instance of a cache.
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
multiple 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 3: September 2010 − 1 − Hewlett-Packard Company 1