#include <lber.h> #include <ldap.h>ldap_enable_cache(LDAP
ld, long timeout, long maxmem);
void ldap_disable_cache(LDAP
ld);
void ldap_destroy_cache(LDAP
ld);
void ldap_flush_cache(LDAP
ld);
void ldap_uncache_entry(LDAP
ld, char
dn);
void ldap_uncache_request(LDAP
ld, int msgid);
void ldap_set_cache_options(LDAP
ld, unsigned long opts);
ldap_enable_cache should be called to turn on local caching or to change cache parameters (lifetime of cached requests and memory used). The ld parameter should be the result of a successful call to ldap_open(3ldap). The timeout is specified in seconds, and is used to decide how long to keep cached requests. The maxmem value is in bytes, and is used to set an upper bound on how much memory the cache will use. You can specify 0 for maxmem to restrict the cache size by the timeout only. The first call to ldap_enable_cache creates the cache; subsequent calls re-enable the cache and set the timeout and memory values.
ldap_disable_cache temporarily disables use of the cache (new requests are not cached and the cache is not checked when returning results). It does not delete the cache contents.
ldap_destroy_cache turns off caching and completely removes the cache from memory.
ldap_flush_cache deletes the cache contents, but does not affect it in any other way.
ldap_uncache_entry removes all requests that make reference to the distinguished name dn from the cache. It should be used, for example, after doing an ldap_modify(3ldap) call involving dn.
ldap_uncache_request removes the request indicated by the LDAP request ID, msgid, from the cache.
ldap_set_cache_options is used to change caching behavior. The current supported options are LDAP_CACHE_OPT_CACHENOERRS to suppress caching of any requests that result in an error, and LDAP_CACHE_OPT_CACHEALLERRS to enable caching of all requests. The default behavior is to not cache requests that result in errors, except for requests that result in the error LDAP_SIZELIMIT_EXCEEDED.
void
and return nothing.