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