NAME
nfslogsum - summarize nfswatch log file
SYNOPSIS
nfslogsum [ -n ] [ -v ] [ logfile ]
DESCRIPTION
nfslogsum summarizes log files produced by the nfswatch program. By
default the log file nfswatch.log is summarized; an alternate log file
can be specified on the command line.
Each nfswatch log file may contain one or more log sessions, each
indicated by a header which is printed when logging is turned on. For
each log session, nfslogsum tallies up the interval packet totals and
prints out a one-page summary of the log session. Total packets and
percentages are tabulated for each category and displayed.
The -n option tells nfslogsum to read only the first n entries in the
log file. This is useful for summarizing log files in cumulative
‘‘chunks’’.
If the -v option is given, nfslogsum will produce a ‘‘verbose’’ summary
of the log file. In addition to the summary information printed as
described above, a summary of how many calls to each NFS procedure were
made on each file system and individual file will be printed. This
summary information is divided into three sections of six columns each.
The columns are headed by the names of the NFS procedures; these are
described briefly below:
NULLPROC
Do nothing. This procedure is provided to allow server response
testing and timing.
GETATTR
Get file attributes (type, mode, number of links, owner’s uid,
owner’s gid, size, access, modification and change times, etc.).
This procedure is used by the stat(2) system call, as well as
several others.
SETATTR
Set file attributes (mode, owner’s uid, owner’s gid, size in
bytes, access and modification times). This procedure is used
by system calls such as chmod(2), chown(2), truncate(2), and so
on.
GETROOT
Get file system root. This procedure is obsolete, and has been
replaced by a MOUNT Protocol procedure.
LOOKUP Look up file name. This procedure is used to obtain an initial
file handle for use in current and future requests on that file,
and is used by many different system calls.
READLINK
Read from symbolic link. This procedure is used by the readlink
system call, and by the kernel.
READ Read data from file. This procedure is used by the read(2)
system call.
WCACHE Write to cache. Unused in the current NFS protocol revision.
WRITE Write data to file. This procedure is used by the write(2)
system call.
CREATE Create file. This procedure is used by the creat(2) and open(2)
system calls.
REMOVE Remove file. This procedure is used by the unlink(2) system
call.
RENAME Rename file. This procedure is used by the rename system call.
LINK Create link to file. This procedure is used by the link(2)
system call.
SYMLINK
Create symbolic link to file. This procedure is used by the
symlink(2) system call.
MKDIR Create directory. This procedure is used by the mkdir(2) system
call.
RMDIR Remove directory. This procedure is used by the rmdir(2) system
call.
READDIR
Read entries from directory. Generally only one READDIR call is
needed per directory, since a variable number of entries can be
returned.
STATFS Get file system attributes (transfer size, block size, blocks in
use, blocks free). This procedure is used by the statfs(2)
system call.
SEE ALSO
nfswatch(8)
BUGS
nfslogsum is exteremely sensitive to the format of the log file
produced by nfswatch. The log file should not be edited or changed
before feeding it to nfslogsum.
AUTHOR
David A. Curry
Purdue University
Engineering Computer Network
1285 Electrical Engineering Building
West Lafayette, IN 47907-1285
davy@ecn.purdue.edu