--- name: "nfsstat" section: "1" platform: "macos" package: "NFS" version: "343.100.5" release: "macOS 26.5" platforms: ["freebsd", "openbsd", "macos"] url: "https://new.carta.tech/nfsstat" --- # nfsstat(1) display NFS statistics ## NAME **nfsstat** – display NFS statistics ## SYNOPSIS **nfsstat** \[**-cseuv**\] \[**-w** *wait*\] \[**-n** *net\|user*\] \[**-m** \[ *mountpath*\]\] ## DESCRIPTION **nfsstat** displays statistics kept about NFS client and server activity, active user activity, exported directories, and mount information. In the absence of any options, **nfsstat** displays NFS client and server statistics. The options are as follows: - **-c** Show NFS client statistics. - **-e** Show NFS server exported directory statistics. - **-m** \[ *mountpath*\] Show NFS mount information. - **-s** Show NFS server statistics. - **-3** Print only NFS v3 statistics. - **-4** Print only NFS v4 statistics. - **-u** Show NFS server active user statistics. - **-f** *JSON* Print output as JSON format. - **-w** *wait* Display a shorter summary at *wait* second intervals. - **-n** *net\|user* Show network addresses as numbers, or show users as uid numbers. This option can appear multiple times. - **-z** Zero NFS client and server statistics. - **-E** Show NFS protocol errors statistics. - **-v** Show additional information (if available). ## OUTPUT The data fields that **nfsstat** displays for each set of statistics are: - **NFSv3** **Client** **Information:** Statistics for NFSv3 file system mounts. - RPC Counts Counts of the RPC calls made to each of the NFSv3 protocol procedures. - **NLM** **Client** **Information:** Statistics for the Network Lock Manager protocol. - RPC Counts Counts of the LOCK, TEST and UNLOCK RPC calls of the NLM protocol. - **NFSv4** **Client** **Information:** Statistics for NFSv4 file system mounts. - RPC Counts Counts of the RPC calls made to each of the NFSv4 protocol procedures. - Operations Counts Counts of the operations calls made by the client within the compound of the NFSv4 protocol procedure. - NFSv4.1 Operations Counts Counts of operations calls made by the client within the compound of the NFSv4.1 protocol procedure. - Callback RPC Counts Counts of the callback RPC calls made to each of the NFSv4 protocol procedures. - Callback Operations Counts Counts of the callback operations calls made by the client within the callback compound of the NFSv4 protocol procedure. - NFSv4.1 Callback Operations Counts Counts of the callback operations calls made by the client within the callback compound of the NFSv4.1 protocol procedure. - **Common** **Client** **Information:** Common statistics for NFS file system mounts. - RPC Info Statistics for NFS RPC calls: - TimedOut RPC calls that timed out, perhaps to a slow or dead server. - Invalid Invalid RPC replies. - X Replies RPC replies received that did not have calls pending. - Retries RPC calls that were retried. - Requests Total number of RPC calls made. - Cache Info Statistics on NFS client-side cache performance: - Attr Hits/Misses Performance of the NFS file attribute cache. - Lkup Hits/Misses Performance of the directory name lookup cache. - BioR Hits/Misses Performance of block cache for reads. - BioW Hits/Misses Performance of block cache for writes. - BioRL Hits/Misses Performance of symbolic link cache. - BioD Hits/Misses Performance of directory cache. - DirE Hits/Misses Performance of directory offset cache. - Accs Hits/Misses Performance of access rights cache. - Paging Info Counts both pagein and pageout operations. - **NFSv3** **Server** **Information:** Statistics for the NFSv3 server. - RPC Counts Counts of RPC calls on each of the NFS server's procedures are recorded here. - Server Ret-Failed RPC errors returned by the server. - Server Faults Errors in the NFS server. - Server Cache Stats Statistics from the NFS server's RPC duplicate request cache: - Inprog Calls already in progress. - Idem Cache hits for idempotent procedures. - Non-idem Cache hits for non-idempotent procedures. - Misses Cache Misses. - Server Write Gathering These statistics describe the efficiency of the NFS server's write gathering feature. - WriteOps Write operations to disk. - WriteRPC Write operations received by the server. - Opsaved Write operations that were gathered (WriteRPC - WriteOps) - **NFS** **Server** **Exported** **Directory** **Information:** Statistics for each exported directory on the NFS server. - NFS Requests Count of NFS requests processed by an exported directory. - Bytes Read Count of bytes read from an exported directory. - Bytes Written Count of bytes written to an exported directory. - **NFS** **Server** **Active** **User** **Information:** List of active NFS users and statistics on the NFS server. - NFS Requests Count of NFS requests received from an active user. - Bytes Read Count of bytes read by an active user. - Bytes Written Count of bytes written by an active user. - Idle Amount of time an active user has been idle. - User Name (or uid if **-n** *user* was given) of active user. - IP Address Host name (or network address if **-n** *net* was given) of client machine. - **NFS** **Mount** **Information:** Information about the given NFS mount (or all NFS mounts). - The path mounted on and the server:/path that is mounted. - Mount arguments originally passed in to the mount. - Current mount parameter values and status information. - **NFS** **Protocol** **Errors** **Information:** - Information about NFS protocol errors categorized by error type. - This option will provide a detailed breakdown of errors encountered within the NFS layer. - NFS Client Errors Counts of errors received from the server during the NFS protocol procedures. - NFSv4 Client Errors Counts of errors received from the server during the NFSv4 protocol procedures. - NFSv4.1 Client Errors Counts of errors received from the server during the NFSv4.1 protocol procedures. - NFS Server Errors Counts of errors sent by the server during the NFS protocol procedures. ## SEE ALSO [netstat(1)](/netstat/1.md), [iostat(8)](/iostat/8.md), [mount\_nfs(8)](/mount_nfs/8.md), [nfsd(8)](/nfsd/8.md) ## HISTORY The **nfsstat** command appears in 4.4BSD.