1nisstat(1M)             System Administration Commands             nisstat(1M)
2
3
4

NAME

6       nisstat - report NIS+ server statistics
7

SYNOPSIS

9       /usr/lib/nis/nisstat [-H host] [directory]
10
11

DESCRIPTION

13       The  nisstat command queries a NIS+ server for various statistics about
14       its operations. These statistics may vary between  implementations  and
15       from  release  to  release.  Not  all statistics are available from all
16       servers. If you request a statistic from a server that does not support
17       that statistic, it is never a fatal error. The message "unknown statis‐
18       tic" is returned.
19
20
21       By default, statistics are fetched  from  the  server(s)  of  the  NIS+
22       directory  for  the  default domain. If directory is specified, servers
23       for that directory are queried.
24
25
26       Supported statistics for this release are as follows:
27
28       root server                   This reports whether the server is a root
29                                     server.
30
31
32       NIS compat mode               This  reports  whether the server is run‐
33                                     ning in NIS compat mode.
34
35
36       DNS forwarding in NIS mode    This reports whether the  server  in  NIS
37                                     compat  mode  will  forward  host  lookup
38                                     calls to DNS.
39
40
41       security level                This reports the security level  of  this
42                                     server.
43
44
45       serves directories            This lists the directories served by this
46                                     server.
47
48
49       Operations                    This statistic  returns  results  in  the
50                                     form: OP=opname:C=calls:E=errors:T=micros
51                                     Where opname is replaced by the RPC  pro‐
52                                     cedure  name  or  operation, calls is the
53                                     number of calls to  this  procedure  that
54                                     have  been  made since the server started
55                                     running. errors is the number  of  errors
56                                     that  have  occurred  while  processing a
57                                     call, and micros is the average  time  in
58                                     microseconds  to  complete  the  last  16
59                                     calls.
60
61
62       Directory Cache               This  statistic  reports  the  number  of
63                                     calls  to  the  internal directory object
64                                     cache, the number of hits on that  cache,
65                                     the  number  of  misses, and the hit rate
66                                     percentage.
67
68
69       Group Cache                   This  statistic  reports  the  number  of
70                                     calls  to  the internal NIS+ group object
71                                     cache, the number of hits on that  cache,
72                                     the  number  of  misses, and the hit rate
73                                     percentage.
74
75
76       Static Storage                This  statistic  reports  the  number  of
77                                     bytes  the  server  has allocated for its
78                                     static storage buffers.
79
80
81       Dynamic Storage               This statistic reports the amount of heap
82                                     the server process is currently using.
83
84
85       Uptime                        This statistic reports the time since the
86                                     service has been running.
87
88
89
90       Per-server  and  per-directory  access  restrictions  may  apply.   See
91       nisopaccess(1). nisstat uses NIS_STATUS.
92

OPTIONS

94       -H host    Normally  all  servers  for  the directory are queried. With
95                  this option, only the machine named host is queried. If  the
96                  named  machine  does  not serve the directory, no statistics
97                  are returned.
98
99

ENVIRONMENT VARIABLES

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

ATTRIBUTES

107       See attributes(5) for descriptions of the following attributes:
108
109
110
111
112       ┌─────────────────────────────┬─────────────────────────────┐
113       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
114       ├─────────────────────────────┼─────────────────────────────┤
115       │Availability                 │SUNWnisu                     │
116       └─────────────────────────────┴─────────────────────────────┘
117

SEE ALSO

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

NOTES

122       NIS+ might not be supported in future releases of the Solaris Operating
123       system.  Tools  to aid the migration from NIS+ to LDAP are available in
124       the   current   Solaris   release.   For   more   information,    visit
125       http://www.sun.com/directory/nisplus/transition.html.
126
127
128
129SunOS 5.11                        12 Dec 2001                      nisstat(1M)
Impressum