nisstat(1M)                                                     nisstat(1M)




 NAME    [Toc]    [Back]
      nisstat - report NIS+ server statistics

 SYNOPSIS    [Toc]    [Back]
      /usr/lib/nis/nisstat [ -H host ] [ directory ]

 DESCRIPTION    [Toc]    [Back]
      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.





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 nisstat(1M)                                                     nisstat(1M)




      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    [Toc]    [Back]
      -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    [Toc]    [Back]
    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)).

 WARNINGS    [Toc]    [Back]
      HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
      supported.

      LDAP is the recommended replacement for NIS+.  HP fully supports the
      industry standard naming services based on LDAP.

 AUTHOR    [Toc]    [Back]
      nisstat was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      nisdefaults(1).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003