1ldap_cachemgr(1M)       System Administration Commands       ldap_cachemgr(1M)
2
3
4

NAME

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

SYNOPSIS

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

DESCRIPTION

14       The ldap_cachemgr daemon is a process that provides an up-to-date  con‐
15       figuration  cache for LDAP naming services. It is started during multi-
16       user boot.
17
18
19       The ldap_cachemgr utility provides caching for all parameters as speci‐
20       fied  and  used  by  the LDAP naming service clients. The ldap_cachemgr
21       utility uses the cache files which are originally created by  executing
22       the  ldapclient(1M)  utility, as cold start files. Updates to the cache
23       files take place dynamically if profiles  are  used  to  configure  the
24       client. See the init option to ldapclient(1M).
25
26
27       The  ldap_cachemgr utility helps improve the performance of the clients
28       that are using LDAP as the Naming service repository. In order for  the
29       LDAP  naming  services  to  function properly, the ldap_cachemgr daemon
30       must be running. ldap_cachemgr also improves system security by  making
31       the configuration files readable by superuser only.
32
33
34       The cache maintained by this daemon is shared by all the processes that
35       access LDAP Naming information. All processes access this cache through
36       a  door  call. On startup, ldap_cachemgr initializes the cache from the
37       cache files. See  ldapclient(1M).  Thus,  the  cache  survives  machine
38       reboots.
39
40
41       The  ldap_cachemgr  daemon also acts as its own administration tool. If
42       an instance of ldap_cachemgr is already running,  commands  are  passed
43       transparently to the running version.
44

OPTIONS

46       The following options are supported:
47
48       -g
49
50           Print current configuration and statistics to standard output. This
51           is the only option executable without superuser privileges.
52
53
54       -l log-file
55
56           Cause ldap_cachemgr to use  a  log  file  other  than  the  default
57           /var/ldap/cachemgr.log.
58
59

EXAMPLES

61       Example 1 Stopping and Restarting the ldap_cachemgr Daemon
62
63
64       The   following   example   shows  how  to  stop  and  to  restart  the
65       ldap_cachemgr daemon.
66
67
68         example# svcadm disable network/ldap/client
69         example# svcadm enable network/ldap/client
70
71
72
73       Example 2 Forcing ldap_cachemgr to Reread Configuration Files
74
75
76       The following example shows how to force ldap_cachemgr  to  reread  the
77       /var/ldap/ldap_client_file and /var/ldap/ldap_client_cred files
78
79
80         example# pkill -HUP ldap_cachemgr
81
82
83

FILES

85       /var/ldap/cachemgr.log
86
87           Default log file.
88
89
90       /var/ldap/ldap_client_file
91       /var/ldap/ldap_client_cred
92
93           Files  containing the LDAP configuration of the client. These files
94           are not to be modified manually. Their content is not guaranteed to
95           be human readable. Use ldapclient(1M) to update these files.
96
97

WARNINGS

99       The ldap_cachemgr utility is included in the current Solaris release on
100       an uncommitted basis only. It is subject to  change  or  removal  in  a
101       future minor release.
102

ATTRIBUTES

104       See attributes(5) for descriptions of the following attributes:
105
106
107
108
109       ┌─────────────────────────────┬─────────────────────────────┐
110       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
111       ├─────────────────────────────┼─────────────────────────────┤
112       │Availability                 │SUNWnisu                     │
113       └─────────────────────────────┴─────────────────────────────┘
114

SEE ALSO

116       ldap(1),  ldapadd(1),  ldapdelete(1), ldaplist(1), ldapmodify(1), ldap‐
117       modrdn(1), ldapsearch(1),  pkill(1),  svcs(1),  idsconfig(1M),  ldapad‐
118       dent(1M),  ldapclient(1M), suninstall(1M), svcadm(1M), signal.h(3HEAD),
119       resolv.conf(4), attributes(5), smf(5)
120

NOTES

122       The ldap_cachemgr service is managed by the service  management  facil‐
123       ity, smf(5), under the service identifier:
124
125         svc:/network/ldap/client
126
127
128
129
130       Administrative actions on this service, such as enabling, disabling, or
131       requesting restart, can be performed using  svcadm(1M).  The  service's
132       status can be queried using the svcs(1) command.
133
134
135
136SunOS 5.11                        7 Oct 2008                 ldap_cachemgr(1M)
Impressum