SunOS man pages : nis_cachemgr (1)
Maintenance 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 tran-
sport 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 main-
tained 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.
The nisprefadm(1M) command 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. Addition-
ally, 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
SunOS 5.8 Last change: 23 Mar 1998 1
Maintenance Commands nis_cachemgr(1M)
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 warn-
ings, but also additional status messages. The addi-
tional messages are logged using syslog(3C) with a
priority of LOG_INFO.
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 attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
SEE ALSO
keylogin(1), nisaddcred(1M), nisinit(1M), nisprefadm(1M),
nisshowcache(1M), rpc.nisd(1M), mmap(2), rpc(3NSL),
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 change: 23 Mar 1998 2
|
 |
|
|
