CFSSTAT(1M) CFSSTAT(1M)
NAME
cfsstat - display Network File System statistics
SYNOPSIS
/usr/etc/cfsstat [ -Cfbz ] [ interval ]
DESCRIPTION
Cfsstat displays statistical information about the Cache File System
(CacheFS). It can also be used to reinitialize this information. If no
options are given the default is to print everything and reinitialize
nothing. The optional argument interval may be used to indicate the
interval in seconds between display updates in the "full-screen" mode
described below. The default value is 1.
OPTIONS
-C Display using a "full-screen" form which is updated every interval
seconds. The values can be displayed as simple totals (r or "raw"),
changes during the previous interval (d or "delta"), or changes
since a fix moment (z or "zero").
-f Display statistics for the file header cache. This cache is used to
hold in memory copies of cached file attributes read from the front
file system. These statistics are provided primarily to assist in
tuning the size of the file header cache.
-b Display back file system operation statisics. This option is
ignored with the -f option.
-z Zero (reinitialize) statistics. Can be combined with any of the
above options to zero particular sets of statistics after printing
them.
GENERAL STATISTICS
The meanings of the primary display fields are given below. These fields
appear in both the full-screen and default display forms.
inval
the number of cache invalidations
nocache
the number of files marked as not being cached
reclaim
the number of CacheFS vnodes reclaimed by the system
dnlchit
the number of lookups which hit in the Directory Name Lookup Cache
(DNLC)
shorthit
the number of lookups which do not hit in the DNLC but for which an
existing cnode is found (i.e., the file system dependent data has
Page 1
CFSSTAT(1M) CFSSTAT(1M)
not been reclaimed)
shortmiss
the number of lookups for which there is a front file but for which
there is no cnode data
lookuphit
the number of lookups which find a front file (cache hits)
lookupstale
the number of lookups which find a front file with a stale back file
ID
lookupmiss
the number of lookups for which no front file was found (cache
misses)
nocachelook
the number of lookups for uncached files or directories
lookups
total number of lookups
readhit
the number of reads which hit in the cache
readmiss
the number of reads which miss (i.e., the read goes to the back
filesystem)
reads
total number of reads
nocachereads
the number of reads on uncached files
readerrors
the number of read errors (either reading from the front or back
file)
writes
total number of writes
nocachewrite
the number of writes to uncached files
writeerrors
the number of write errors (either writing to the front or back
file)
Page 2
CFSSTAT(1M) CFSSTAT(1M)
asyncreqs
total number of requests to the CacheFS asynchronous operation
daemon(s)
replacements
total number of file replacements (files removed from the cache to
make room for new files)
rdirhit
the number of readdir requests which hit in the cache
rdirmiss
the number of readdir requests which miss
readdirs
total number of readdir requests
short rdlink
the number of reads of symbolic links which get data from the file
header and so do not require a further read of the front file
long rdlink
the number of reads of symbolic links which must get data from the
front file
vnops
total number of vnode operations
vfsops
total number of vfs operations
back vnops
total number of vnode operations to the back file system
back vfsops
total number of vfs operations to the back file system
getbackvp
the total number of times a back vnode must be gotten using the file
ID
objchecks
total number of cache consistency checks
back checks
the number of cache consistency checks which go to the back file
system
objinits
total number of cache object initializations
Page 3
CFSSTAT(1M) CFSSTAT(1M)
objmods
total number of cache object modifications (this occurs for writes)
objinvals
total number of cache object invalidations
newcnodes
number of new cnodes created
makecnode
number of calls to makecachefsnode (the function which looks up and
creates cnodes)
nocnode
the number of times makecachefsnode returns ENOENT when given a back
file ID and no front and back vnodes
cnodehit
the number of times a cnode was found (not created) by
makecachefsnode
cnrestart
the number of times cnode lookup has been restarted due to a cnode
bein destroyed or failure to get the vnode
cnlookagain
the number of times cnode lookup has been restarted after creating a
new cnode
cntoss
the number of cnodes freed due to duplication
reclaim race
the number of collisions between cnode lookup and reclaiming
destroy race
the number of collisions between cnode lookup and destruction
BACK FILE SYSTEM OPERATIONS
In addition to the primary fields, the full-screen form offers some
additional fields. These fields provide a summary of back file system
operations. These appear in all of the display modes (delta, zero, or
raw) but are most useful in "delta" mode.
The statistics are not printed if the -f option is supplied.
lku the number of lookups
fsy the number of file syncs
Page 4
CFSSTAT(1M) CFSSTAT(1M)
rdl the number of readlinks
acc the number of access checks
get the number of getattrs
set the number of setattrs
clo the number of closes
opn the number of opens
rdd the number readdirs
cre the number of creates
rem the number of removes
lnk the number of links
ren the number of renames
mkd the number of mkdirs
rmd the number of rmdirs
sym the number of symlinks
frl the number of file locks
rdv the number of reads
wrv the number of writes
FILE HEADER CACHE STATISTICS
Cfsstat can also be instructed to display statistics for the file header
cache. The fields displayed are described below.
hits the percentage of file header reads that hit in the cache
misses
the percentage of file header reads that miss in the cache
reads
total number of file header reads
writes
total number of file header writes
cache enter
number of file headers entered into the cache
Page 5
CFSSTAT(1M) CFSSTAT(1M)
cache remove
number of file headers removed from the cache
LRU enter
number of file headers placed onto the LRU list
LRU remove
number of file headers removed from the LRU list
purges
number of file headers purged from the cache
releases
number of file header releases
FILES
/unix system namelist
/dev/kmem kernel memory
SEE ALSO
cachefs(4), osview(1), nfsstat(1M), sar(1), systune(1M)
Page 6