1nis_cachemgr(1M) System Administration Commands nis_cachemgr(1M)
2
6 nis_cachemgr - NIS+ utility to cache location information about NIS+
7 servers
8
10 /usr/sbin/nis_cachemgr [-i] [-v]
11
14 The nis_cachemgr daemon maintains a cache of NIS+ directory objects and
15 active servers for domains. It is responsible for locating servers for
16 a domain on behalf of client processes. This improves performance
17 because only one process has to search for servers. The cache contains
18 location information necessary to contact the NIS+ servers. This
19 includes transport addresses, information neeeded to authenticate the
20 server, and a time to live field which gives a hint on how long the
21 directory object can be cached. The cache helps to improve the perfor‐
22 mance of the clients that are traversing the NIS+ name space.
23 nis_cachemgr should be running on all the machines that are using NIS+.
24 However, it is not required that the nis_cachemgr program be running in
25 order for NIS+ requests to be serviced.
26 The cache maintained by this program is shared by all the processes
29 that access NIS+ on a machine. The cache is maintained in a file that
30 is memory mapped by all the processes. See mmap(2). On start up,
31 nis_cachemgr initializes the cache from the cold start file and pre‐
32 serves unexpired entries that already exist in the cache file. See
33 nisinit(1M). Thus, the cache survives machine reboots.
34 The nis_cachemgr program is normally started from a system startup
37 script. nisshowcache(1M) can be used to look at the cached objects and
38 active servers.
39 The nisprefadm(1M) command can be used to control which NIS+ servers
42 the nis_cachemgr program will try to select.
43 The nis_cachemgr program makes NIS+ requests under the NIS+ principal
46 name of the host on which it runs. Before running nis_cachemgr, secu‐
47 rity credentials for the host should be added to the cred.org_dir table
48 in the host's domain using nisaddcred(1M). Credentials of type DES will
49 be needed if the NIS+ service is operating at security level 2 (see
50 rpc.nisd(1M)). See the section, below. Additionally, a "keylogin -r "
51 should be done on the machine.
52 svc:/network/rpc/keyserv:default is required for NIS+ operation. See
55 NOTES.
56
58 -i Force nis_cachemgr to ignore the previous cache file and reini‐
59 tialize the cache from just the cold start file. By default, the
60 cache manager initializes itself from both the cold start file
61 and the old cache file, thereby maintaining the entries in the
62 cache across machine reboots.
63 -v This flag sets verbose mode. In this mode, the nis_cachemgr pro‐
66 gram logs not only errors and warnings, but also additional sta‐
67 tus messages. The additional messages are logged using syslog(3C)
68 with a priority of LOG_INFO.
69
72 /var/nis/NIS_SHARED_DIRCACHE
73 the shared cache file
75 /var/nis/NIS_COLD_START
78 the coldstart file
80
83 See attributes(5) for descriptions of the following attributes:
84 ┌─────────────────────────────┬─────────────────────────────┐
89 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
90 ├─────────────────────────────┼─────────────────────────────┤
91 │Availability │SUNWcsu │
92 └─────────────────────────────┴─────────────────────────────┘
93
95 keylogin(1), svcs(1), nisaddcred(1M), nisinit(1M), nisprefadm(1M), nis‐
96 showcache(1M), rpc.nisd(1M), svcadm(1M), mmap(2), rpc(3NSL), sys‐
97 log(3C), nisfiles(4), attributes(5), smf(5)
98
100 The nis_cachemgr daemon logs error messages and warnings using sys‐
101 log(3C). Error messages are logged to the DAEMON facility with a prior‐
102 ity of LOG_ERR . Warning messages are logged with a priority of
103 LOG_WARNING. Additional status messages can be obtained using the -v
104 option.
105
107 NIS+ might not be supported in future releases of the Solaris operating
108 system. Tools to aid the migration from NIS+ to LDAP are available in
109 the current Solaris release. For more information, visit
110 http://www.sun.com/directory/nisplus/transition.html.
111 The nis_cachemgr service is managed by the service management facility,
114 smf(5), under the service identifier:
115 svc:/network/rpc/nisplus:default
117 Administrative actions on this service, such as enabling, disabling, or
122 requesting restart, can be performed using svcadm(1M). The service's
123 status can be queried using the svcs(1) command.
124SunOS 5.11 13 Aug 2004 nis_cachemgr(1M)