ldap_cachemgr(1M) (man pages section 1M: System Administration Commands)

man pages section 1M: System Administration Commands

ldap_cachemgr(1M)

NAME

ldap_cachemgr- LDAP daemon to cache server and client information for NIS lookups

SYNOPSIS

/usr/lib/ldap/ldap_cachemgr

-g

-l

log-file

-r

revalidate-interval

DESCRIPTION

The ldap_cachemgr utility is a process that provides an up-to-date configuration cache for LDAP naming services. It is started during multi-user boot.

The ldap_cachemgr utility provides cacheing for all parameters as specified and used by the ldap naming service clients. The ldap_cachemgr utility uses the cache files (see FILES) as cold start files which are originally created by executing the ldapclient(1M) utility. Updates to the cache files take place dynamically if profiles are used.

The ldap_cachemgr utility helps improve the performance of the clients that are using LDAP as the Naming service repository. Although it is not required that the ldap_cachemgr daemon be running in order for LDAP naming requests to be serviced, it is strongly recommended that it be run on all machines. It will not only improve the performance on both clients and the server(s), but will also improves system security by making the credential file readable by superuser only.

The cache maintained by this daemon is shared by all the processes that access LDAP Naming information. All processes access this cache thru a door call. On startup, ldap_cachemgr initializes the cache from the cache files (see ldapclient(1M) Thus, the cache survives machine reboots.

The ldap_cachemgr daemon is normally started from a system startup script.

The ldap_cachemgr utility also acts as its own administration tool. If an instance of ldap_cachemgr is already running, commands are passed transparently to the running version.

OPTIONS

The following options are supported:

-g: Print current configuration and statistics to standard output. This is the only option executable without superuser privileges.
-l log-file: Cause ldap_cachemgr to use a log file other than the default /var/ldap/cachemgr.log.
-r revalidate-interval: Override the built-in default refresh interval. When the refresh interval expires, the cache files are updated. The default for this value is 600 seconds. This value can be overridden from the server profile (see ldapclient(1M)).

EXAMPLES

Example 1 Stop and restart the `ldap_cachemgr` daemon.

example# /etc/init.d/ldap.client stop
example# /etc/init.d/ldap.client start

Example 2 Force `ldap_cachemgr` to re-read the `/var/ldap/ldap_client_cache` and `/var/ldap/ldap_client_cred` files.

example# ps -efl | grep ldap
8 S     root 10923     1  0  71 20        ?    318
? 11:01:42 ?        0:00 ./ldap_cachemgr
     $
example# kill -HUP 10923

FILES

/var/ldap/ldap_client_cache: cold start file for the ldap_cachemgr daemon
/var/ldap/ldap_client_cred: credential file as created by ldapclient(1M)

WARNINGS

The ldap_cachemgr utility is included in the Solaris 8 release on an uncommitted basis only, and is subject to change or removal in a future minor release.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWnisu