man pages section 1M: System Administration Commands

nis_cachemgr(1M)

NAME

nis_cachemgr– NIS+ utility to cache location information about NIS+ servers

SYNOPSIS

/usr/sbin/nis_cachemgr

-i

-v

DESCRIPTION

The nis_cachemgr daemon maintains a cache of NIS+ directory objects and active servers for domains. It is responsible for locating servers for a domain on behalf of client processes. This improves performance because only one process has to search for servers. The cache contains location information necessary to contact the NIS+ servers. This includes transport addresses, information neeeded to authenticate the server, and a time to live field which gives a hint on how long the directory object can be cached. The cache helps to improve the performance of the clients that are traversing the NIS+ name space. nis_cachemgr should be running on all the machines that are using NIS+. However, it is not required that the nis_cachemgr program be running in order for NIS+ requests to be serviced.

The cache maintained by this program is shared by all the processes that access NIS+ on a machine. The cache is maintained in a file that is memory mapped (see mmap(2)) by all the processes. On start up, nis_cachemgr initializes the cache from the cold start file (see nisinit(1M)) and preserves unexpired entries that already exist in the cache file. Thus, the cache survives machine reboots.

The nis_cachemgr program is normally started from a system startup script. nisshowcache(1M) can be used to look at the cached objects and active servers.It must be started by a user with a UID of 0 and at a sensitivity label of ADMIN_LOW. Upon startup nis_cachemgr must inherit the net_mac_read, net_upgrade_sl, file_dac_read, file_dac_write, and sys_system_door privileges.

The nisprefadm(1M) command (see the SunOS 5.8 Reference Manual) can be used to control which NIS+ servers the nis_cachemgr program will try to select.

The nis_cachemgr program makes NIS+ requests under the NIS+ principal name of the host on which it runs. Before running nis_cachemgr, security credentials for the host should be added to the cred.org_dir table in the host's domain using nisaddcred(1M). Credentials of type DES will be needed if the NIS+ service is operating at security level 2 (see rpc.nisd(1M)). See the WARNINGS section, below. Additionally, a "keylogin -r " should be done on the machine.

OPTIONS

-i: Force nis_cachemgr to ignore the previous cache file and reinitialize the cache from just the cold start file. By default, the cache manager initializes itself from both the cold start file and the old cache file, thereby maintaining the entries in the cache across machine reboots.
-v: This flag sets verbose mode. In this mode, the nis_cachemgr program logs not only errors and warnings, but also additional status messages. The additional messages are logged using syslog(3C) with a priority of LOG_INFO.

SUMMARY OF TRUSTED SOLARIS CHANGES

The nis_cachemgr must be started by a user with a UID of 0 and at a sensitivity level of ADMIN_LOW. At startup it must inherit the net_mac_read, net_upgrade_sl, file_dac_read, file_dac_write, and sys_system_door privileges.

FILES

/var/nis/NIS_SHARED_DIRCACHE: The shared cache file
/var/nis/NIS_COLD_START: The coldstart file
/etc/init.d/rpc: Initialization scripts for NIS+

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

Trusted Solaris 8 HW 12/02 Reference Manual

rpc.nisd(1M), rpc(3NSL)

SunOS 5.8 Reference Manual

keylogin(1), nisaddcred(1M), nisinit(1M), nisprefadm(1M), nisshowcache(1M), mmap(2), syslog(3C), nisfiles(4), attributes(5)

DIAGNOSTICS

The nis_cachemgr daemon logs error messages and warnings using syslog(3C). Error messages are logged to the DAEMON facility with a priority of LOG_ERR. Warning messages are logged with a priority of LOG_WARNING. Additional status messages can be obtained using the -v option.

SunOS 5.8 Last Revised 30 Jun 2000