.BR slapd (8)
serves up referrals based upon SRV resource records held in
the Domain Name System.
+.LP
+This backend is experimental.
.SH CONFIGURATION
The DNSSRV backend has no backend nor database specific options.
It is configured simply by "database dnssrv" followed a suffix
servers, generating an error.
.TP
.B uri <ldapurl>
-LDAP server to use.
+LDAP server to use. Multiple URIs can be set in in a single
+.B ldapurl
+argument, resulting in the underlying library automatically
+call the first server of the list that responds, e.g.
+
+\fBuri "ldap://host/ ldap://backup-host"\fP
+
+The URI list is space- or comma-separated.
.TP
.B server <hostport>
Obsolete option; same as `uri ldap://<hostport>/'.
.LP
The <naming context> part doesn't need to be unique across the targets;
it may also match one of the values of the "suffix" directive.
+Multiple URIs may be defined in a single argument. The URIs must
+be separated by TABs (e.g. '\\t'), and the additional URIs must have
+no <naming context> part. This causes the underlying library
+to contact the first server of the list that responds.
.TP
.B default-target [<target>]
The "default-target" directive can also be used during target specification.
This directive sets the password for acl checking in conjunction
with the above mentioned "binddn" directive.
.TP
+.B rebind-as-user
+If this option is given, the client's bind credentials are remembered
+for rebinds when chasing referrals.
+.TP
.B pseudorootdn "<substitute DN in case of rootdn bind>"
This directive, if present, sets the DN that will be substituted to
the bind DN if a bind with the backend's "rootdn" succeeds.
.BR slapd (8)
serves up the user account information listed in the system
.BR passwd (5)
-file.
+file. This backend is provided for demonstration purposes only.
The DN of each entry is "uid=<username>,<suffix>".
Note that non-base searches scan the the entire passwd file, and
are best suited for hosts with small passwd files.
make it easy to tie an existing database to the
.B slapd
front-end.
+.LP
+This backend is is primarily intended to be used in prototypes.
.SH WARNING
.B "This backend's calling conventions have changed since OpenLDAP 2.0."
The abandon operation now gets a new "pid:" line.
for SQL dialects RDBMSes may use, so it may be used for integration
and distribution of data on different RDBMSes, OSes, hosts etc., in
other words, in highly heterogeneous environment.
+.LP
+This backend is experimental.
.SH CONFIGURATION
These
.B slapd.conf
Any tcl database section of the configuration file
.BR slapd.conf (5)
must then specify what Tcl script to use.
+.LP
+This backend is experimental.
.SH WARNING
.B "This backend's calling conventions have changed since OpenLDAP 2.0."
Previously, the 2nd argument to the procs was a message ID.
.B one
to indicate all the entries immediately below the
.BR pattern ,
-.B sub
+.B subtree
to indicate all the subentries of an entry including the entry itself,
.B children
to indicate all the subentries of an entry not including the entry itself.
.B dn=".*"
is equivalent to
.BR * .
-The regex form of the pattern does not support UTF-8 (7) yet.
+The regex form of the pattern does not support UTF-8 yet.
.LP
The statement
.B filter=<ldapfilter>