Maintenance 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.  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  opera-
                tion,   calls is the number of calls to this pro-
                cedure 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

SunOS 5.8           Last change: 19 May 1999                    1

Maintenance Commands                                  nisstat(1M)

                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.

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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWnisu                    |
    |_____________________________|_____________________________|

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

NOTES

SunOS 5.8           Last change: 19 May 1999                    2

Maintenance Commands                                  nisstat(1M)

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

SunOS 5.8           Last change: 19 May 1999                    3