nisstat(1M)

NAME

nisstat − report NIS+ server statistics

SYNOPSIS

/usr/lib/nis/nisstat [ −H host ] [ directory ]

DESCRIPTION

The nisstat command queries a NIS+ server for various statistics on its operation. These statistics may vary between implementations and from release to release. Not all statistics are available from all servers. Requesting a statistic from a server that does not support that statistic is never fatal, it simply returns “unknown statistic”.

By default, statistics are fetched from the server(s) of the NIS+ directory for the default domain. If directory is specified, servers for that directory are queried instead. If the object named by directory is not a NIS+ directory, an error is printed.

Supported statistics for this release are as follows:

Operations This statistic returns results in the form:
OP=opname:C=calls :E=errors:T=micros
Where opname is replaced by the RPC procedure name or operation, calls is the number of calls to this procedure that have been made since the server started running. errors is the number of errors that have occurred while processing a call, and micros is the average time to complete the last 16 calls.

Directory Cache This statistic 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 This statistic 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 This statistic reports the number of bytes the server has allocated for its static storage buffers.

Dynamic Storage This statistic reports the amount of heap the server process is currently using.

Uptime This statistic reports the amount of time since the service was started.

OPTIONS

−H host Normally all servers for the directory are queried. With this option, only the machine named host is queried. If the named machine does not serve the directory no statistics are returned.

ENVIRONMENT

NIS_PATH If this variable is set, and the NIS+ directory name is not fully qualified, each directory specified will be searched until the directory is found (see nisdefaults(1)).

Museum