10057 Man page misspellings ouput particuliar overriden
Reviewed by: Gergő Mihály Doma <domag02@gmail.com>
1 NFSSTAT(1M) Maintenance Commands NFSSTAT(1M)
2
3
4
5 NAME
6 nfsstat - NFS statistics
7
8 SYNOPSIS
9 nfsstat [-cnrsza] [-T u | d ] [-v version] [interval [count]]
10
11
12 nfsstat -m [pathname]...
13
14
15 DESCRIPTION
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
21
22 nfsstat -csnra
23
24
25 The default displays everything, but reinitializes nothing.
26
27 OPTIONS
28 -a
29
30 Display NFS_ACL information.
31
32
33 -c
34
35 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
38 information only.
39
40
41 -m [pathname...]
42
43 Display statistics for each NFS mounted file system. If pathname is
44 not specified, displays statistics for all NFS mounted file
45 systems. If pathname is specified, displays statistics for the NFS
46 mounted file systems indicated by pathname.
47
48 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
52 displayed only where dynamic retransmission is in use. By default,
53 NFS mounts over the TCP protocols and NFS Version 3 mounts over
54 either TCP or UDP do not use dynamic retransmission.
55
56 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
61
62 -n
63
64 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
68
69 -r
70
71 Display RPC information.
72
73
74 -s
75
76 Display server information.
77
78
79 -T u | d
80
81 Display a time stamp.
82
83 Specify u for a printed representation of the internal
84 representation of time. See time(2). Specify d for standard date
85 format. See date(1).
86
87
88 -v version
89
90 Specify which NFS version for which to print statistics. When
91 followed by the optional version argument, (2|3|4), specifies
92 statistics for that version. By default, prints statistics for all
93 versions.
94
95
96 -z
97
98 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
102
103 OPERANDS
104 The following operands are supported:
105
106 count
107
108 Display only count reports
109
110
111 interval
112
113 Report once each interval seconds.
114
115
116 pathname
117
118 Specify the pathname of a file in an NFS mounted file system for
119 which statistics are to be displayed.
120
121
122 DISPLAYS
123 The server RPC display includes the following fields:
124
125 badcalls
126
127 The total number of calls rejected by the RPC layer (the sum of
128 badlen and xdrcall as defined below).
129
130
131 badlen
132
133 The number of RPC calls with a length shorter than a minimum-sized
134 RPC call.
135
136
137 calls
138
139 The total number of RPC calls received.
140
141
142 dupchecks
143
144 The number of RPC calls that looked up in the duplicate request
145 cache.
146
147
148 dupreqs
149
150 The number of RPC calls that were found to be duplicates.
151
152
153 nullrecv
154
155 The number of times an RPC call was not available when it was
156 thought to be received.
157
158
159 xdrcall
160
161 The number of RPC calls whose header could not be XDR decoded.
162
163
164
165 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
169
170 The server NFS_ACL display shows the counts and percentages for the
171 various calls that were made.
172
173
174 The client RPC display includes the following fields:
175
176 calls
177
178 The total number of RPC calls made.
179
180
181 badcalls
182
183 The total number of calls rejected by the RPC layer.
184
185
186 badverfs
187
188 The number of times the call failed due to a bad verifier in the
189 response.
190
191
192 badxids
193
194 The number of times a reply from a server was received which did
195 not correspond to any outstanding call.
196
197
198 cantconn
199
200 The number of times the call failed due to a failure to make a
201 connection to the server.
202
203
204 cantsend
205
206 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
209
210 interrupts
211
212 The number of times the call was interrupted by a signal before
213 completing.
214
215
216 newcreds
217
218 The number of times authentication information had to be refreshed.
219
220
221 nomem
222
223 The number of times the call failed due to a failure to allocate
224 memory.
225
226
227 retrans
228
229 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
233
234 timeouts
235
236 The number of times a call timed out while waiting for a reply from
237 the server.
238
239
240 timers
241
242 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
245
246
247 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
251 respective percentages.
252
253
254 The client NFS_ACL display shows the counts and percentages for the
255 various calls that were made.
256
257
258 The -m option includes information about mount flags set by mount
259 options, mount flags internal to the system, and other mount
260 information. See mount_nfs(1M).
261
262
263 The following mount flags are set by mount options:
264
265 grpid
266
267 System V group id inheritance.
268
269
270 hard
271
272 Hard mount.
273
274
275 intr
276
277 Interrupts allowed on hard mount.
278
279
280 llock
281
282 Local locking being used (no lock manager).
283
284
285 noac
286
287 Client is not caching attributes.
288
289
290 nointr
291
292 No interrupts allowed on hard mount.
293
294
295 nocto
296
297 No close-to-open consistency.
298
299
300 retrans
301
302 NFS retransmissions.
303
304
305 rpctimesync
306
307 RPC time sync.
308
309
310 rsize
311
312 Read buffer size in bytes.
313
314
315 sec
316
317 sec has one of the following values:
318
319 dh
320
321 des-style authentication (encrypted timestamps).
322
323
324 krb5
325
326 kerberos v5-style authentication.
327
328
329 krb5i
330
331 kerberos v5-style authentication with integrity.
332
333
334 krb5p
335
336 kerberos v5-style authentication with privacy.
337
338
339 none
340
341 No authentication.
342
343
344 short
345
346 Short hand UNIX-style authentication.
347
348
349 sys
350
351 UNIX-style authentication (UID, GID).
352
353
354
355 soft
356
357 Soft mount.
358
359
360 timeo
361
362 Initial NFS timeout, in tenths of a second.
363
364
365 wsize
366
367 Write buffer size in bytes.
368
369
370
371 The following mount flags are internal to the system:
372
373 acl
374
375 Server supports NFS_ACL.
376
377
378 down
379
380 Server is down.
381
382
383 dynamic
384
385 Dynamic transfer size adjustment.
386
387
388 link
389
390 Server supports links.
391
392
393 mirrormount
394
395 Mounted automatically by means of the mirrormount mechanism.
396
397
398 printed
399
400 "Not responding" message printed.
401
402
403 readdir
404
405 Use readdir instead of readdirplus.
406
407
408 symlink
409
410 Server supports symbolic links.
411
412
413
414 The following flags relate to additional mount information:
415
416 proto
417
418 Protocol.
419
420
421 vers
422
423 NFS version.
424
425
426
427 The -m option also provides attribute cache timeout values. The
428 following fields in -m output provide timeout values for attribute
429 cache:
430
431 acdirmax
432
433 Maximum seconds to hold cached directory attributes.
434
435
436 acdirmin
437
438 Minimum seconds to hold cached directory attributes.
439
440
441 acregmax
442
443 Maximum seconds to hold cached file attributes.
444
445
446 acregmin
447
448 Minimum seconds to hold cached file attributes.
449
450
451
452 The following fields in -m output provide failover information:
453
454 currserver
455
456 Which server is currently providing NFS service. See the for
457 additional details.
458
459
460 failover
461
462 How many times a new server has been selected.
463
464
465 noresponse
466
467 How many times servers have failed to respond.
468
469
470 remap
471
472 How many times files have been re-evaluated to the new server.
473
474
475
476 The fields in -m output shown below provide information on dynamic
477 retransmissions. These items are displayed only where dynamic
478 retransmission is in use.
479
480 cur
481
482 Current backed-off retransmission value, in milliseconds.
483
484
485 dev
486
487 Estimated deviation, in milliseconds.
488
489
490 srtt
491
492 The value for the smoothed round-trip time, in milliseconds.
493
494
495 EXIT STATUS
496 The following exit values are returned:
497
498 0
499
500 Successful completion.
501
502
503 >0
504
505 An error occurred.
506
507
508 SEE ALSO
509 mount_nfs(1M), attributes(5)
510
511
512
513
514
515
516
517 June 16, 2009 NFSSTAT(1M)
--- EOF ---