Copyright (c) 1999-2011 Apple Inc. All rights reserved.

@APPLE_LICENSE_HEADER_START@

This file contains Original Code and/or Modifications of Original Code
as defined in and that are subject to the Apple Public Source License
Version 2.0 (the 'License'). You may not use this file except in
compliance with the License. Please obtain a copy of the License at
http://www.opensource.apple.com/apsl/ and read it before using this
file.

The Original Code and all software distributed under the License are
distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
Please see the License for the specific language governing rights and
limitations under the License.

@APPLE_LICENSE_HEADER_END@

Copyright (c) 1989, 1990, 1993
The Regents of the University of California. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
must display the following acknowledgement:
This product includes software developed by the University of
California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors
may be used to endorse or promote products derived from this software
without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

@(#)nfsstat.1 8.1 (Berkeley) 6/6/93

.Dd January 11, 2011 .Dt NFSSTAT 1 .Os BSD 4.4 .Sh NAME .Nm nfsstat .Nd display .Tn NFS statistics .Sh SYNOPSIS .Nm .Op Fl cseuv .Op Fl w Ar wait .Op Fl n Ar net|user .Op Fl m [ Ar mountpath ] .Sh DESCRIPTION .Nm displays statistics kept about .Tn NFS client and server activity, active user activity, exported directories, and mount information. In the absence of any options, .Nm displays NFS client and server statistics.

p The options are as follows: l -tag -width Ds t Fl c Show NFS client statistics. t Fl e Show NFS server exported directory statistics. t Fl m [ Ar mountpath ] Show NFS mount information. t Fl s Show NFS server statistics. t Fl u Show NFS server active user statistics. t Fl w Ar wait Display a shorter summary at .Ar wait second intervals. t Fl n Ar net|user Show network addresses as numbers, or show users as uid numbers. This option can appear multiple times. t Fl v Show additional information (if available). .El .Sh OUTPUT The data fields that .Nm displays for each set of statistics are: l -tag -width "xx" ========
t Cm Client Information: Statistics for NFS file system mounts. l -tag -width "xx" t RPC Counts Counts of the RPC calls made to each of the NFS protocol procedures. t RPC Info Statistics for NFS RPC calls: l -tag -width "xxx" t TimedOut RPC calls that timed out, perhaps to a slow or dead server. t Invalid Invalid RPC replies. t X Replies RPC replies received that did not have calls pending. t Retries RPC calls that were retried. t Requests Total number of RPC calls made. .El t Cache Info Statistics on NFS client-side cache performance: l -tag -width "xxx" t Attr Hits/Misses Performance of the NFS file attribute cache. t Lkup Hits/Misses Performance of the directory name lookup cache. t BioR Hits/Misses Performance of block cache for reads. t BioW Hits/Misses Performance of block cache for writes. t BioRL Hits/Misses Performance of symbolic link cache. t BioD Hits/Misses Performance of directory cache. t DirE Hits/Misses Performance of directory offset cache. .El .El ========
t Cm Server Information: Statistics for the NFS server. l -tag -width "xx" t RPC Counts Counts of RPC calls on each of the NFS server's procedures are recorded here. t Server Ret-Failed RPC errors returned by the server. t Server Faults Errors in the NFS server. t Server Cache Stats Statistics from the NFS server's RPC duplicate request cache: l -tag -width "xxx" t Inprog Calls already in progress. t Idem Cache hits for idempotent procedures. t Non-idem Cache hits for non-idempotent procedures. t Misses Cache Misses. .El t Server Write Gathering These statistics describe the efficiency of the NFS server's write gathering feature. l -tag -width "xxx" t WriteOps Write operations to disk. t WriteRPC Write operations received by the server. t Opsaved Write operations that were gathered (WriteRPC - WriteOps) .El .El ========
t Cm NFS Server Exported Directory Information: Statistics for each exported directory on the NFS server. l -tag -width "xxx" t NFS Requests Count of NFS requests processed by an exported directory. t Bytes Read Count of bytes read from an exported directory. t Bytes Written Count of bytes written to an exported directory. .El ========
t Cm NFS Server Active User Information: List of active NFS users and statistics on the NFS server. l -tag -width "xxx" t NFS Requests Count of NFS requests received from an active user. t Bytes Read Count of bytes read by an active user. t Bytes Written Count of bytes written by an active user. t Idle Amount of time an active user has been idle. t User Name (or uid if .Fl n Ar user was given) of active user. t IP Address Host name (or network address if .Fl n Ar net was given) of client machine. .El ========
t Cm NFS Mount Information: Information about the given NFS mount (or all NFS mounts). l -tag -width "xxx" t The path mounted on and the server:/path that is mounted. t Mount arguments originally passed in to the mount. t Current mount parameter values and status information. .El .El .Sh SEE ALSO .Xr netstat 1 , .Xr iostat 8 , .Xr mount_nfs 8 , .Xr nfsd 8 .Sh HISTORY The .Nm nfsstat command appears in x 4.4 .