X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fman%2Fman5%2Fslapd-bdb.5;h=d24bd0cff463cd45d45795b205635087ee24d789;hb=74443523583b0516de43abf9624420c030f43a0f;hp=0dfdb8ba9e880be7653a3ac6d7bc91ff1d26eabc;hpb=2ab8810555d7dfacec389864eaf2d83beaa8e329;p=openldap diff --git a/doc/man/man5/slapd-bdb.5 b/doc/man/man5/slapd-bdb.5 index 0dfdb8ba9e..d24bd0cff4 100644 --- a/doc/man/man5/slapd-bdb.5 +++ b/doc/man/man5/slapd-bdb.5 @@ -1,5 +1,5 @@ -.TH SLAPD-BDB 5 "30 April 2002" "OpenLDAP LDVERSION" -.\" Copyright 1998-2002 The OpenLDAP Foundation All Rights Reserved. +.TH SLAPD-BDB 5 "RELEASEDATE" "OpenLDAP LDVERSION" +.\" Copyright 1998-2003 The OpenLDAP Foundation All Rights Reserved. .\" Copying restrictions apply. See COPYRIGHT/LICENSE. .\" $OpenLDAP$ .SH NAME @@ -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 @@ -94,13 +111,49 @@ The default is the same as Specify the file protection mode that newly created database index files should have. 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 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 +are nested deeper than the search stack depth will cause a separate +stack to be allocated for that particular search operation. These +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.