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