nisstat(1M)                                               System Administration Commands                                               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 about its operations. These statistics may vary between implementations
       and from release to release. Not all statistics are available from all servers. If you request a statistic from a server that does not sup-
       port that statistic, it is never a fatal error. The message "unknown statistic" is returned.

       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.

        Per-server and per-directory access restrictions may apply. See nisopaccess(1). nisstat uses NIS_STATUS.

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 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).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWnisu                     |
       +-----------------------------+-----------------------------+

SEE ALSO

       nisdefaults(1), nisopaccess(1), attributes(5)

NOTES

       NIS+  might  not  be  supported in future releases of the SolarisTM Operating Environment. Tools to aid the migration from NIS+ to LDAP are
       available in the Solaris 9 operating environment. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.10                                                          12 Dec 2001                                                        nisstat(1M)