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