1 .TH SLAPD-LDBM 5 "RELEASEDATE" "OpenLDAP LDVERSION"
2 .\" Copyright 1998-2005 The OpenLDAP Foundation All Rights Reserved.
3 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 slapd-ldbm \- LDBM backend to slapd
12 is the database backend which is easiest to configure.
13 However, it does not offer the data durability features of the BDB
15 It uses Berkeley DB or GDBM to store data.
16 It makes extensive use of indexing and caching to speed data access.
20 options apply to the LDBM backend database.
21 That is, they must follow a "database ldbm" line and come before any
22 subsequent "backend" or "database" lines.
23 Other database options are described in the
27 .B cachesize <integer>
28 Specify the size in entries of the in-memory cache maintained
29 by the LDBM backend database instance.
30 The default is 1000 entries.
32 .B dbcachesize <integer>
33 Specify the size in bytes of the in-memory cache associated with each
35 If not supported by the underlying database method, this option is
36 ignored without comment.
37 The default is 100000 bytes.
40 Specify that no database locking should be performed.
41 Enabling this option may improve performance at the expense of data security.
42 Do NOT run any slap tools while slapd is running.
45 Specify that on-disk database contents should not be immediately
46 synchronized with in memory changes.
47 Enabling this option may improve performance at the expense of data
50 .B dbsync <frequency> <maxdelays> <delayinterval>
51 Flush dirty database buffers to disk every
56 (ie. individual updates are no longer written to disk).
57 It attempts to avoid syncs during periods of peak activity by waiting
59 seconds if the server is busy, repeating this delay up to
61 times before proceeding.
62 It is an attempt to provide higher write performance with some amount
64 Note that it may still be possible to get an inconsistent database if
65 the underlying engine fills its cache and writes out individual pages
66 and slapd crashes or is killed before the next sync.
70 are optional and default to
74 respectively, giving a total elapsed delay of 60 seconds before a sync
81 .B directory <directory>
82 Specify the directory where the LDBM files containing this database and
83 associated indexes live.
84 A separate directory must be specified for each database.
86 .BR LOCALSTATEDIR/openldap-data .
89 index {<attrlist>|default} [pres,eq,approx,sub,<special>]
90 Specify the indexes to maintain for the given attribute (or
92 Some attributes only support a subset of indexes.
93 If only an <attr> is given, the indices specified for \fBdefault\fR
95 Note that setting a default does not imply that all attributes will be
96 indexed. Also, for best performance, an
98 index should always be configured for the
102 A number of special index parameters may be specified.
105 can be decomposed into
114 may be specified to disallow use of this index by subtypes with tagging
115 options (such as language options).
118 may be specified to disallow use of this index by named subtypes.
119 Note: changing index settings requires rebuilding indices, see
123 Specify the file protection mode that newly created database
124 index files should have.
129 backend honors access control semantics as indicated in
130 .BR slapd.access (5).
134 default slapd configuration file