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 ---