1nfsstat(1M) System Administration Commands nfsstat(1M)
2
6 nfsstat - NFS statistics
7
9 nfsstat [-cnrsza] [-T u | d ] [-v version] [interval [count]]
10 nfsstat -m [pathname]...
13
16 nfsstat displays statistical information about the NFS and RPC (Remote
17 Procedure Call), interfaces to the kernel. It can also be used to
18 reinitialize this information. If no options are given the default is
19 as follows:
20 nfsstat -csnra
23 The default displays everything, but reinitializes nothing.
26
28 -a
29 Display NFS_ACL information.
31 -c
34 Display client information. Only the client side NFS, RPC, and
36 NFS_ACL information is printed. Can be combined with the -n, -r,
37 and -a options to print client side NFS, RPC, and NFS_ACL informa‐
38 tion only.
39 -m [pathname...]
42 Display statistics for each NFS mounted file system. If pathname is
44 not specified, displays statistics for all NFS mounted file sys‐
45 tems. If pathname is specified, displays statistics for the NFS
46 mounted file systems indicated by pathname.
47 This includes the server name and address, mount flags, current
49 read and write sizes, the retransmission count, the attribute cache
50 timeout values, failover information, and the timers used for
51 dynamic retransmission. The dynamic retransmission timers are dis‐
52 played only where dynamic retransmission is in use. By default, NFS
53 mounts over the TCP protocols and NFS Version 3 mounts over either
54 TCP or UDP do not use dynamic retransmission.
55 If you specify the -m option, this is the only option that nfsstat
57 uses. If you specify other options with -m, you receive an error
58 message alerting that the -m flag cannot be combined with other
59 options.
60 -n
63 Display NFS information. NFS information for both the client and
65 server side are printed. Can be combined with the -c and -s options
66 to print client or server NFS information only.
67 -r
70 Display RPC information.
72 -s
75 Display server information.
77 -T u | d
80 Display a time stamp.
82 Specify u for a printed representation of the internal representa‐
84 tion of time. See time(2). Specify d for standard date format. See
85 date(1).
86 -v version
89 Specify which NFS version for which to print statistics. When fol‐
91 lowed by the optional version argument, (2|3|4), specifies statis‐
92 tics for that version. By default, prints statistics for all ver‐
93 sions.
94 -z
97 Zero (reinitialize) statistics. This option is for use by the super
99 user only, and can be combined with any of the above options to
100 zero particular sets of statistics after printing them.
101
104 The following operands are supported:
105 count
107 Display only count reports
109 interval
112 Report once each interval seconds.
114 pathname
117 Specify the pathname of a file in an NFS mounted file system for
119 which statistics are to be displayed.
120
123 The server RPC display includes the following fields:
124 badcalls
126 The total number of calls rejected by the RPC layer (the sum of
128 badlen and xdrcall as defined below).
129 badlen
132 The number of RPC calls with a length shorter than a minimum-sized
134 RPC call.
135 calls
138 The total number of RPC calls received.
140 dupchecks
143 The number of RPC calls that looked up in the duplicate request
145 cache.
146 dupreqs
149 The number of RPC calls that were found to be duplicates.
151 nullrecv
154 The number of times an RPC call was not available when it was
156 thought to be received.
157 xdrcall
160 The number of RPC calls whose header could not be XDR decoded.
162 The server NFS display shows the number of NFS calls received (calls)
166 and rejected (badcalls), and the counts and percentages for the various
167 calls that were made.
168 The server NFS_ACL display shows the counts and percentages for the
171 various calls that were made.
172 The client RPC display includes the following fields:
175 calls
177 The total number of RPC calls made.
179 badcalls
182 The total number of calls rejected by the RPC layer.
184 badverfs
187 The number of times the call failed due to a bad verifier in the
189 response.
190 badxids
193 The number of times a reply from a server was received which did
195 not correspond to any outstanding call.
196 cantconn
199 The number of times the call failed due to a failure to make a con‐
201 nection to the server.
202 cantsend
205 The number of times a client was unable to send an RPC request over
207 a connectionless transport when it tried to do so.
208 interrupts
211 The number of times the call was interrupted by a signal before
213 completing.
214 newcreds
217 The number of times authentication information had to be refreshed.
219 nomem
222 The number of times the call failed due to a failure to allocate
224 memory.
225 retrans
228 The number of times a call had to be retransmitted due to a timeout
230 while waiting for a reply from the server. Applicable only to RPC
231 over connection-less transports.
232 timeouts
235 The number of times a call timed out while waiting for a reply from
237 the server.
238 timers
241 The number of times the calculated time-out value was greater than
243 or equal to the minimum specified time-out value for a call.
244 The client NFS display shows the number of calls sent and rejected, as
248 well as the number of times a CLIENT handle was received (clgets), the
249 number of times the CLIENT handle cache had no unused entries
250 (cltoomany), as well as a count of the various calls and their respec‐
251 tive percentages.
252 The client NFS_ACL display shows the counts and percentages for the
255 various calls that were made.
256 The -m option includes information about mount flags set by mount
259 options, mount flags internal to the system, and other mount informa‐
260 tion. See mount_nfs(1M).
261 The following mount flags are set by mount options:
264 grpid
266 System V group id inheritance.
268 hard
271 Hard mount.
273 intr
276 Interrupts allowed on hard mount.
278 llock
281 Local locking being used (no lock manager).
283 noac
286 Client is not caching attributes.
288 nointr
291 No interrupts allowed on hard mount.
293 nocto
296 No close-to-open consistency.
298 retrans
301 NFS retransmissions.
303 rpctimesync
306 RPC time sync.
308 rsize
311 Read buffer size in bytes.
313 sec
316 sec has one of the following values:
318 dh
320 des-style authentication (encrypted timestamps).
322 krb5
325 kerberos v5-style authentication.
327 krb5i
330 kerberos v5-style authentication with integrity.
332 krb5p
335 kerberos v5-style authentication with privacy.
337 none
340 No authentication.
342 short
345 Short hand UNIX-style authentication.
347 sys
350 UNIX-style authentication (UID, GID).
352 soft
356 Soft mount.
358 timeo
361 Initial NFS timeout, in tenths of a second.
363 wsize
366 Write buffer size in bytes.
368 The following mount flags are internal to the system:
372 acl
374 Server supports NFS_ACL.
376 down
379 Server is down.
381 dynamic
384 Dynamic transfer size adjustment.
386 link
389 Server supports links.
391 mirrormount
394 Mounted automatically by means of the mirrormount mechanism.
396 printed
399 "Not responding" message printed.
401 readdir
404 Use readdir instead of readdirplus.
406 symlink
409 Server supports symbolic links.
411 The following flags relate to additional mount information:
415 proto
417 Protocol.
419 vers
422 NFS version.
424 The -m option also provides attribute cache timeout values. The follow‐
428 ing fields in -m ouput provide timeout values for attribute cache:
429 acdirmax
431 Maximum seconds to hold cached directory attributes.
433 acdirmin
436 Minimum seconds to hold cached directory attributes.
438 acregmax
441 Maximum seconds to hold cached file attributes.
443 acregmin
446 Minimum seconds to hold cached file attributes.
448 The following fields in -m output provide failover information:
452 currserver
454 Which server is currently providing NFS service. See the for addi‐
456 tional details.
457 failover
460 How many times a new server has been selected.
462 noresponse
465 How many times servers have failed to respond.
467 remap
470 How many times files have been re-evaluated to the new server.
472 The fields in -m output shown below provide information on dynamic
476 retransmissions. These items are displayed only where dynamic retrans‐
477 mission is in use.
478 cur
480 Current backed-off retransmission value, in milliseconds.
482 dev
485 Estimated deviation, in milliseconds.
487 srtt
490 The value for the smoothed round-trip time, in milliseconds.
492
495 The following exit values are returned:
496 0
498 Successful completion.
500 >0
503 An error occurred.
505
508 See attributes(5) for descriptions of the following attributes:
509 ┌─────────────────────────────┬─────────────────────────────┐
514 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
515 ├─────────────────────────────┼─────────────────────────────┤
516 │Availability │SUNWnfscu │
517 └─────────────────────────────┴─────────────────────────────┘
518
520 mount_nfs(1M), attributes(5)
521SunOS 5.11 16 Jun 2009 nfsstat(1M)