cfsstat(1M)
cfsstat - display Network File System statistics
As shipped in IRIX 6.5.30. Last changed in IRIX 6.5.15.
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 statistics. 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 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) 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 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 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 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)