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