nisstat Command

Purpose

Reports NIS+ server statistics.

Syntax

/usr/lib/nis/nisstat [  -H HostName ] [ DirName ]

Description

The nisstat command queries an NIS+ server for statistics about its operations. These statistics vary from release to release and between implementations. Not all statistics are available from all servers. If you request a statistic from a server that does not support it, nisstat simply returns unknown statistic.

By default, statistics are retrieved from the server(s) of the NIS+ directory for the default domain. If a directory is specified in DirName, then that directory's server is queried.

To retrieve a specific statistic, use one of these keywords:

Item Description
root server Reports whether or not the server is a root server.
NIS compat mode Reports whether or not the server is running in NIS compat mode.
DNS forwarding in NIS mode Reports whether or not the server in NIS compat mode will forward host-lookup calls to DNS.
security level Reports the security level of the default server or the server specified in HostName.
serves directories Lists the directories served by the default server or the server specified in HostName.
Operations Returns results in the format

OP=opname:C=calls:E=errors:T=micros

opname
States the RPC procedure or operation.
calls
States the number of calls to the RPC procedure made since the server began running.
errors
States the number of errors that occurred while a call was being processed.
micros
States the average amount of time (in microseconds) to complete the most recent 16 calls.
Directory Cache Reports the number of calls to the internal directory object cache, the number of hits on that cache, the number of misses, and the hit rate percentage.
Group Cache Reports the number of calls to the internal NIS+ group object cache, the number of hits on that cache, the number of misses, and the hit rate percentage.
Static Storage Reports the number of bytes the server allocated for its static storage buffers.
Dynamic Storage Reports the amount of heap the server process is currently using.
Uptime Reports the amount of time the service has been running.

Flags

Item Description
-H HostName Indicates that only the server specified in HostName is queried by the nisstat command. By default, all servers for the directory are queried. If HostName does not serve the directory, no statistics are returned.

Environment

Item Description
NIS_PATH If the NIS+: name is not fully qualified, searches each NIS+ directory specified until the directory is found.