[PATCH] nfsstat.man

[PATCH] nfsstat.man

[G. Allen Morris III]

[-- Attachment #1: Type: text/plain, Size: 217 bytes --]

Could I have comments this patch.

I should have a patch for nfsstat to have it match the man file with in
the next day or so.

I have included the complete new man page as well as a patch against
CVS.

Allen Morris


[-- Attachment #2: nfsstat.man.patch --]
[-- Type: text/plain, Size: 3126 bytes --]

Index: nfsstat.man
===================================================================
RCS file: /cvsroot/nfs/nfs-utils/utils/nfsstat/nfsstat.man,v
retrieving revision 1.2
diff -u -r1.2 nfsstat.man
--- nfsstat.man	7 Oct 2001 06:24:35 -0000	1.2
+++ nfsstat.man	11 Apr 2005 14:52:40 -0000
@@ -1,30 +1,46 @@
 .\"
 .\" nfsstat(8)
 .\" 
-.\" Copyright (C) 1996 Olaf Kirch <okir@monad.swb.de>
-.TH nfsstat 8 "05 Oct 2001"
+.\" Copyright (C) 1996-2005 Olaf Kirch <okir@monad.swb.de>
+.TH nfsstat 8 "11 Apr 2005"
 .SH NAME
-nfsstat \- print NFS statistics
+nfsstat \- list NFS statistics
 .SH SYNOPSIS
-.BI "/usr/sbin/nfsstat [-anrcsz] [-o " "facility" "] ...
+.B nfsstat
+[\fIOPTION\fR]...
 .SH DESCRIPTION
 The
 .B nfsstat
 displays statistics kept about NFS client and server activity.
 .SH OPTIONS
 .TP
-.B -s
+.B -s, --server
 Print only server-side statistics. The default is to print both server and
 client statistics.
 .TP
-.B -c
+.B -c, --client
 Print only client-side statistics.
 .TP
-.B -n
+.B -n, --nfs
 Print only NFS statistics. The default is to print both NFS and RPC
 information.
 .TP
-.B -r
+.B -2
+Print only NFS v2 statistics. The default is to only print information
+about the versions of \fBNFS\fR that have non-zero counts.
+.TP
+.B -3
+Print only NFS v3 statistics. 
+.TP
+.B -4
+Print only NFS v4 statistics. 
+.TP
+.B -m, --mounted
+Print information about each of the mounted \fBNFS\fR file systems.
+
+If this option is used, all other options are ignored.
+.TP
+.B -r, --rpc
 Print only RPC statistics.
 .TP
 .BI -o " facility
@@ -48,8 +64,35 @@
 .B rc
 Usage information on the server's request reply cache, including the
 total number of lookups, and the number of hits and misses.
+.TP
+.B all
+Display all of the above facilities.
 .RE
+.TP
+.B -v, --verbose
+This is equivient to \fB-o all\fR.
 .SH EXAMPLES
+.TP
+.B nfsstat -o all -234
+Show all information about all versions of \fBNFS\fR.
+.TP
+.B nfsstat --verbose -234
+Same as above.
+.TP
+.B nfsstat -o all
+Show all information about about active versions of \fBNFS\fR.
+.TP
+.B nfsstat --nfs --server -3
+Show statictics for \fBNFS\fR version 3 server.
+.TP
+.B nfsstat -m
+Show information about mounted \fBNFS\fR filesystems.
+.\" --------------------- DISPLAY --------------------------------
+.SH DISPLAY
+.TP
+The \fBFlags\fR output from the \fB-m\fR option is the same as the
+flags give to the \fBmount\fR command.
+.TP
 .\" --------------------- FILES ----------------------------------
 .SH FILES
 .TP
@@ -60,9 +103,22 @@
 .B /proc/net/rpc/nfs
 .BR procfs -based
 interface to kernel NFS client statistics.
+.TP
+.B /proc/mounts
+.BR procfs -based
+interface to the mounted filesystems.
 .\" -------------------- SEE ALSO --------------------------------
 .SH SEE ALSO
 .BR rpc.nfsd (8).
+.BR nfs (5).
+.SH BUGS
+.TP
+The \fBDisplay\fR section should be more commplete.
+.TP
+The function of the \fB-v\fR and \fB-a\fR options have changed.
+.TP
+Further bugs can be found or reported at 
+.BR http://nfs.sf.net/ .
 .\" -------------------- AUTHOR ----------------------------------
 .SH AUTHOR
 Olaf Kirch, <okir@monad.swb.de>

[-- Attachment #3: nfsstat.man --]
[-- Type: application/x-troff-man, Size: 3105 bytes --]

Re: [PATCH] nfsstat.man

[G. Allen Morris III]

Here are the main changes that I think might upset people:

The default output has be changed. To get the old default output you
must run 'nfsstat --auto -2'. That is by defult the version 2 info is
not output unless it has a non-zero entry.

I removed the -v[23] option and added -2 -3 -4 options. I changed the -a
option to -v (verbose). The -a option is reserved for nfs acl output.

Allen



-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click
_______________________________________________
NFS maillist  -  NFS@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/nfs