nfsstat(1)

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), iostat(8), mount_nfs(8), nfsd(8)

HISTORY

The nfsstat command appears in 4.4BSD.