X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fman%2Fman5%2Fslapd-bdb.5;h=d24bd0cff463cd45d45795b205635087ee24d789;hb=75b9f8acdc626041190468939fbf045e2c83e104;hp=91876cf37ae5fb7cc6eaeefe1b856a94daedfc21;hpb=6939c531700652491f4be4688c6a1f35a1ab8a18;p=openldap diff --git a/doc/man/man5/slapd-bdb.5 b/doc/man/man5/slapd-bdb.5 index 91876cf37a..d24bd0cff4 100644 --- a/doc/man/man5/slapd-bdb.5 +++ b/doc/man/man5/slapd-bdb.5 @@ -10,8 +10,20 @@ ETCDIR/slapd.conf The BDB backend to .BR slapd (8) is the recommended backend for a normal slapd database. -It uses the Sleepycat BerkelyDB package to store data. +However, it takes more care than with the LDBM backend to configure +it properly. +It uses the Sleepycat Berkeley DB (BDB) package to store data. It makes extensive use of indexing and caching to speed data access. +.LP +It is noted that these options are intended to complement +Berkeley DB configuration options set in the environment's +.B DB_CONFIG +file. See Berkeley DB documentation for +details on +.B DB_CONFIG +configuration options. Where there is overlap, settings in +.B DB_CONFIG +take precedence. .SH CONFIGURATION These .B slapd.conf @@ -58,6 +70,11 @@ results if the data comes from a transaction that is later aborted. In this case, the modified data is discarded and a subsequent search will return a different result. .TP +.B idlcachesize +Specify the size of the in-memory index cache, in index slots. The +default is zero. A larger value will speed up frequent searches of +indexed entries. +.TP .B index {|default} [pres,eq,approx,sub,] Specify the indexes to maintain for the given attribute (or @@ -97,7 +114,7 @@ The default is 0600. .TP .B searchstack Specify the depth of the stack used for search filter evaluation. -Search filters are evaluated on a stack to accomodate nested AND / OR +Search filters are evaluated on a stack to accommodate nested AND / OR clauses. An individual stack is assigned to each server thread. The depth of the stack determines how complex a filter can be evaluated without requiring any additional memory allocation. Filters that @@ -107,13 +124,36 @@ allocations can have a major negative impact on server performance, but specifying too much stack will also consume a great deal of memory. Each search stack uses 512K bytes per level. The default stack depth is 16, thus 8MB per thread is used. +.TP +.B shm_key +Specify a key for a shared memory BDB environment. By default the +BDB environment uses memory mapped files. If a non-zero value is +specified, it will be used as the key to identify a shared memory +region that will house the environment. +.TP +.B sessionlog +Specify a session log store for the syncrepl replication provider +site which contains information on the entries that have been scoped +out of the content of the replication session identified by {{EX:}}. +The number of entries in the session log store is limited +by {{EX:}}. Excessive entries are removed from the store +in the FIFO order. Both {{EX:}} and {{EX:}} are +non-negative integers. {{EX:}} has no more than three digits. +Refer to the "OpenLDAP Administrator's Guide" for detailed information +on setting up a replicated slapd directory service using the syncrepl +replication engine and the session log store. +.B .SH FILES .TP ETCDIR/slapd.conf default slapd configuration file +.TP +DB_CONFIG +Berkeley DB configuration file .SH SEE ALSO .BR slapd.conf (5), .BR slapd (8), .BR slapadd (8), .BR slapcat (8), -.BR slapindex (8). +.BR slapindex (8), +Berkeley DB documentation.