cfsadmin.1m (2010 09)

c
cfsadmin(1M) cfsadmin(1M)
minblocks=n Minimum amount of storage space, expressed as a percentage of the total number of
blocks in the front file system, that CacheFS is always allowed to use without limita-
tion by its internal control mechanisms. If CacheFS does not have exclusive use of the
front file system, there is no guarantee that all the space the
minblocks parameter
attempts to reserve will be available. The default is
0.
threshblocks=
n
A percentage of the total blocks in the front file system beyond which CacheFS cannot
claim resources once its block usage has reached the level specified by
minblocks.
The default is
85.
maxfiles=n Maximum number of files that CacheFS can use, expressed as a percentage of the
total number of inodes in the front file system. CacheFS may automatically increase
this parameter when being used on a VxFS file system. If CacheFS does not have
exclusive use of the front file system, there is no guarantee that all the inodes the
maxfiles parameter allows will be available. The default is
90.
minfiles=n Minimum number of files, expressed as a percentage of the total number of inodes in
the front file system, that CacheFS is always allowed to use without limitation by its
internal control mechanisms. If CacheFS does not have exclusive use of the front file
system, there is no guarantee that all the inodes the
minfiles parameter attempts
to reserve will be available. The default is
0.
threshfiles=n A percentage of the total inodes in the front file system beyond which CacheFS cannot
claim inodes once its usage has reached the level specified by minfiles. The default
is 85.
maxfilesize=n Largest file size, expressed in megabytes, that CacheFS is allowed to cache. The
default is 3.
Currently,
maxfilesize is ignored by CacheFS; therefore, setting it will have no
effect.
Note: You cannot decrease the block or inode allotment for a cache. To decrease the size of a cache, you
must remove it and create it again with different parameters.
RETURN VALUE
cfsadmin returns the following values:
0 Successful completion.
1 An error occurred.
EXAMPLES
Create a cache directory named
/cache:
cfsadmin -c /cache
Create a cache named /cache1 that can claim a maximum of 60 percent of the blocks in the front file
system, can use 40 percent of the front file system blocks without interference by CacheFS internal con-
trol mechanisms, and has a threshold value of 50 percent. The threshold value indicates that after
CacheFS reaches its guaranteed minimum, it cannot claim more space if 50 percent of the blocks in the
front file system are already used.
cfsadmin -c -o maxblocks=60,minblocks=40,threshblocks=50 /cache1
Change the maxfilesize parameter for the cache directory /cache2 to 2 megabytes:
cfsadmin -u -o maxfilesize=2 /cache2
List the contents of a cache directory named /cache3 and provides statistics about resource utilization:
cfsadmin -l /cache3
Remove the cached file system with cache ID 23 from the cache directory /cache3 and frees its
resources (the cache ID is part of the information returned by cfsadmin -l):
cfsadmin -d 23 /cache3
Remove all cached file systems from the cache directory /cache3:
cfsadmin -d all /cache3
2 Hewlett-Packard Company 2 HP-UX 11i Version 3: September 2010