1nfsstat(8)                  System Manager's Manual                 nfsstat(8)
2
3
4

NAME

6       nfsstat - list NFS statistics
7

SYNOPSIS

9       nfsstat [OPTION]...
10

DESCRIPTION

12       The nfsstat displays statistics kept about NFS client and server activ‐
13       ity.
14

OPTIONS

16       -s, --server
17              Print only server-side statistics. The default is to print  both
18              server and client statistics.
19
20       -c, --client
21              Print only client-side statistics.
22
23       -n, --nfs
24              Print  only NFS statistics. The default is to print both NFS and
25              RPC information.
26
27       -2     Print only NFS v2 statistics.  The  default  is  to  only  print
28              information about the versions of NFS that have non-zero counts.
29
30       -3     Print  only  NFS  v3  statistics.  The  default is to only print
31              information about the versions of NFS that have non-zero counts.
32
33       -4     Print only NFS v4 statistics.  The  default  is  to  only  print
34              information about the versions of NFS that have non-zero counts.
35
36       -m, --mounts
37              Print information about each of the mounted NFS file systems.
38
39              If this option is used, all other options are ignored.
40
41       -r, --rpc
42              Print only RPC statistics.
43
44       -o facility
45              Display statistics for the specified facility, which must be one
46              of:
47
48              nfs    NFS protocol information, split up by RPC call.
49
50              rpc    General RPC information.
51
52              net    Network layer statistics, such as the number of  received
53                     packets, number of TCP connections, etc.
54
55              fh     Usage  information  on  the  server's  file handle cache,
56                     including the total number of lookups, and the number  of
57                     hits and misses.
58
59              rc     Usage  information  on  the server's request reply cache,
60                     including the total number of lookups, and the number  of
61                     hits and misses.
62
63              io     Usage  information  on  the server's io statistics; bytes
64                     read and written.
65
66              ra     Usage information  on  the  server's  read  ahead  cache,
67                     including  the ra cache size, the depth of ra cache hits,
68                     and ra cache misses.
69
70              all    Display all of the above facilities.
71
72       -v, --verbose
73              This is equivalent to -o all.
74
75       -l, --list
76              Print information in list form.
77
78       -S, --since file
79              Instead of printing current statistics, nfsstat imports  statis‐
80              tics from file and displays the difference between those and the
81              current statistics.  Valid input files may be  in  the  form  of
82              /proc/net/rpc/nfs  (raw  client  stats), /proc/net/rpc/nfsd (raw
83              server stats), or  saved  output  from  nfsstat  itself  (client
84              and/or server stats).   Any statistics missing from a saved nfs‐
85              stat output file are treated as zeroes.
86
87       -Z[interval], --sleep=[interval]
88              Instead of printing current statistics and immediately  exiting,
89              nfsstat  takes  a  snapshot of the current statistics and pauses
90              until it receives SIGINT (typically from Ctrl-C), at which point
91              it  takes  another  snapshot and displays the difference between
92              the two.  If interval is specified, nfsstat will print the  num‐
93              ber  of NFS calls made since the previous report.  Stats will be
94              printed repeatedly every interval seconds.
95

EXAMPLES

97       nfsstat -o all -234
98              Show all information about all versions of NFS.
99
100       nfsstat --verbose -234
101              Same as above.
102
103       nfsstat -o all
104              Show all information about active versions of NFS.
105
106       nfsstat --nfs --server -3
107              Show statistics for NFS version 3 server.
108
109       nfsstat -m
110              Show information about mounted NFS filesystems.
111

DISPLAY

113       The Flags output from the -m option is the same as the  flags  give  to
114       the mount command.
115

FILES

117       /proc/net/rpc/nfsd
118              procfs-based interface to kernel NFS server statistics.
119
120       /proc/net/rpc/nfs
121              procfs-based interface to kernel NFS client statistics.
122
123       /proc/mounts
124              procfs-based interface to the mounted filesystems.
125

SEE ALSO

127       rpc.nfsd(8).  nfs(5).
128

BUGS

130       The default output has been changed.  To get the old default output you
131       must run nfsstat --auto -2.
132
133       The function of the -v and -a options have changed. The  -a  option  is
134       now reserved for future use. The -v does what the -a option used to do,
135       and the new -[234] options replace the -v option.
136
137       The Display section should be more complete.
138
139       Further bugs can be found or reported at http://nfs.sf.net/.
140

AUTHOR

142       Olaf Kirch, <okir@suse.de>
143
144
145
146                                  7 Aug 2007                        nfsstat(8)