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 about its operations.
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.
Supported statistics for this release are as follows:
- root server
This reports whether the server is a root server.
- NIS compat mode
This reports whether the server is running in NIS compat mode.
- DNS forwarding in NIS mode
This reports whether the server in NIS compat mode will forward host lookup
calls to DNS.
- security level
This reports the security level of this server.
- serves directories
This lists the directories served by this server.
- 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 in microseconds 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 time since the
service has been running.
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.
- directory
If specified, servers for that directory are queried.
EXTERNAL INFLUENCES
Environment Variables
- 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)).
AUTHOR
nisstat
was developed by Sun Microsystems, Inc.