From 2567e107a4c99859de240256019acf764d95bc66 Mon Sep 17 00:00:00 2001 From: Tim Mooney Date: Tue, 12 Apr 2011 11:31:31 -0500 Subject: [PATCH] ITS#6904 Update to reflect that hdb is preferred Tweak wording -- hyc --- doc/man/man5/slapd-bdb.5 | 14 ++++++-------- doc/man/man5/slapd.backends.5 | 14 ++++++++++---- 2 files changed, 16 insertions(+), 12 deletions(-) diff --git a/doc/man/man5/slapd-bdb.5 b/doc/man/man5/slapd-bdb.5 index b02e5eac0a..f64e6d3e4b 100644 --- a/doc/man/man5/slapd-bdb.5 +++ b/doc/man/man5/slapd-bdb.5 @@ -9,16 +9,14 @@ slapd\-bdb, slapd\-hdb \- Berkeley DB backends to slapd .SH DESCRIPTION The \fBbdb\fP backend to .BR slapd (8) -is the recommended primary backend for a normal -.B slapd -database. -It uses the Oracle Berkeley DB (BDB) package to store data. +uses the Oracle Berkeley DB (BDB) package to store data. It makes extensive use of indexing and caching to speed data access. .LP -\fBhdb\fP is a variant of the \fBbdb\fP backend that uses a -hierarchical database -layout which supports subtree renames. It is otherwise identical to -the \fBbdb\fP behavior, and all the same configuration options apply. +\fBhdb\fP is the recommended primary database backend. It is a variant of +the \fBbdb\fP backend that uses a hierarchical database layout which +supports subtree renames. It is both more space-efficient and more +execution-efficient than the \fBbdb\fP backend. It is otherwise identical +to the \fBbdb\fP behavior, and all the same configuration options apply. .LP It is noted that these options are intended to complement Berkeley DB configuration options set in the environment's diff --git a/doc/man/man5/slapd.backends.5 b/doc/man/man5/slapd.backends.5 index ca22f8a332..e69e043330 100644 --- a/doc/man/man5/slapd.backends.5 +++ b/doc/man/man5/slapd.backends.5 @@ -20,8 +20,10 @@ corresponding manual pages. .TP .B bdb -This is the recommended primary backend for a normal slapd database. -It takes care to configure it properly. +This was the recommended primary backend through OpenLDAP 2.3, but it has +since been superseded by the +.BR hdb +backend. It takes care to configure it properly. It uses the transactional database interface of the Oracle Berkeley DB (BDB) package to store data. .TP @@ -40,14 +42,18 @@ It serves up referrals based upon SRV resource records held in the Domain Name System. .TP .B hdb -This is a variant of the +This is the recommended primary backend for a normal slapd database. +.B hdb +is a variant of the .B bdb backend that uses a hierarchical database -layout. This layout stores entry DNs more efficiently than the +layout. +This layout stores entry DNs more efficiently than the .B bdb backend, using less space and requiring less work to create, delete, and rename entries. It is also one of the few backends to support subtree renames. +.BR .TP .B ldap This backend acts as a proxy to forward incoming requests to another -- 2.39.5