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)