manpages.info - online man pages   

SunOS man pages : ldap_cachemgr (1)

Maintenance 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 parame- ters 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 repo- sitory. 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 administra- tion tool. If an instance of ldap_cachemgr is already run- ning, commands are passed transparently to the running ver- sion.

OPTIONS

The following options are supported: -g Print current configuration and statistics to stan- dard output. This is the only option executable without superuser privileges. SunOS 5.8 Last change: 12 Oct 1999 1 Maintenance Commands ldap_cachemgr(1M) -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 attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWnisu | |_____________________________|_____________________________|

SEE ALSO

SunOS 5.8 Last change: 12 Oct 1999 2 Maintenance Commands ldap_cachemgr(1M) ldap(1), ldapclient(1M), attributes(5) SunOS 5.8 Last change: 12 Oct 1999 3