ldap_cachemgr(1M)

NAME

     ldap_cachemgr - LDAP daemon to manage  client  configuration
     for LDAP based Network Information Service lookups

SYNOPSIS

     /usr/lib/ldap/ldap_cachemgr [-l  log-file] [-g]

DESCRIPTION

     The ldap_cachemgr daemon 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 caching for  all  parame-
     ters  as  specified  and  used  by  the  LDAP naming service
     clients. The ldap_cachemgr  utility  uses  the  cache  files
     which are originally created by executing the ldapclient(1M)
     utility, as cold start files.  Updates to  the  cache  files
     take place dynamically if profiles are used to configure the
     client. See the init option to ldapclient(1M).

     The ldap_cachemgr utility helps improve the  performance  of
     the  clients that are using LDAP as the Naming service repo-
     sitory.  In order for the LDAP naming services  to  function
     properly,   the   ldap_cachemgr   daemon  must  be  running.
     ldap_cachemgr also improves system security  by  making  the
     configuration files 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  through  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 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.

EXAMPLES

     Example 1: Stopping and Restarting the ldap_cachemgr Daemon

     The following example shows how to stop and to  restart  the
     ldap_cachemgr daemon.

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

     Example   2:   Forcing   ldap_cachemgr   to    Reread    the
     /var/ldap/ldap_client_file   and  /var/ldap/ldap_client_cred
     Files

     The following example shows how to  force  ldap_cachemgr  to
     reread        the       /var/ldap/ldap_client_file       and
     /var/ldap/ldap_client_cred files

     example# pkill -HUP ldap_cachemgr

FILES

     /var/ldap/cachemgr.log
           Default log file.

     /var/ldap/ldap_client_file

     /var/ldap/ldap_client_cred
           Files containing the LDAP configuration of the client.
           These  files  are  not  to be modified manually. Their
           content is not guaranteed to be human  readable.   Use
           ldapclient(1M) to update these files.

WARNINGS

     The ldap_cachemgr utility  is  included  in  the  Solaris  9
     release  on  an  uncommitted   basis  only. It 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

     ldap(1),  ldapadd(1),  ldapdelete(1),  ldaplist(1),  ldapmo-
     dify(1),        ldapmodrdn(1),       ldapsearch(1),pkill(1),
     idsconfig(1M),        ldapaddent(1M),        ldapclient(1M),
     suninstall(1M), signal(3HEAD), resolv.conf(4), attributes(5)