[\c
.BI \-p \ ldapport\fR]
[\c
-.BR \-O \ security-properties ]
+.BI \-O \ security-properties\fR]
[\c
.BR \-I ]
[\c
.TP
.BI \-d \ debuglevel
Set the LDAP debugging level to \fIdebuglevel\fP.
-.B ldapcompare
+.B ldapwhoami
must be compiled with LDAP_DEBUG defined for this option to have any effect.
.TP
.B \-x
.\" Copyright 1998-2005 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
+.SH NAME
slapd.conf \- configuration file for slapd, the stand-alone LDAP daemon
.SH SYNOPSIS
ETCDIR/slapd.conf
only exist in some of these databases. In general, all of the glued
databases should be configured as similarly as possible, since the intent
is to provide the appearance of a single directory.
+
+Note that the \fIsubordinate\fP functionality is implemented internally
+by the \fIglue\fP overlay and as such its behavior will interact with other
+overlays in use. By default, the glue overlay is automatically configured as
+the last overlay on the superior backend. Its position on the backend
+can be explicitly configured by setting an \fBoverlay glue\fP directive
+at the desired position. This explicit configuration is necessary e.g.
+when using the \fIsyncprov\fP overlay, which needs to follow \fIglue\fP
+in order to work over all of the glued databases. E.g.
+.RS
+.nf
+ database bdb
+ suffix dc=example,dc=com
+ ...
+ overlay glue
+ overlay syncprov
+.fi
+.RE
.HP
.hy 0
.B syncrepl rid=<replica ID>
be specified, which uses a numeric weight prepended to the attribute values.
The weighted sort is always performed in ascending order, but may be combined
with the other methods for values that all have equal weights. The weight
-is specified by prepending an integer weight
-.B {<weight>}
+is specified by prepending an integer weight {<\fIweight\fP>}
in front of each value of the attribute for which weighted sorting is
desired. This weighting factor is stripped off and never returned in
search results.
.SH CONFIGURATION
These
-.B slapd.conf
+.I slapd.conf
options apply to the Value Sorting overlay.
They should appear after the
.B overlay
.B database
directive.
.TP
-.B valsort-attr <attribute> <baseDN> (<sort-method> | weighted [<sort-method>])
+valsort-attr <\fIattribute\fP> <\fIbaseDN\fP> (<\fIsort-method\fP> | weighted [<\fIsort-method\fP>])
Configure a sorting method for the specified
-.B attribute
+.I attribute
in the subtree rooted at
-.BR baseDN .
+.IR baseDN .
The
-.B sort-method
+.I sort-method
may be one of
.BR alpha-ascend ,
.BR alpha-descend ,
.BR numeric-descend .
If the special
.B weighted
-method is specified, a secondary sort-method may also be specified. It is an
-error to specify an alphanumeric sort-method for an attribute with Integer
-or NumericString syntax, and it is an error to specify a numeric sort for
-an attribute with a syntax other than Integer or NumericString.
+method is specified, a secondary
+.I sort-method
+may also be specified. It is an
+error to specify an alphanumeric
+.I sort-method
+for an attribute with Integer
+or NumericString syntax, and it is an error to specify a numeric
+.I sort-method
+for an attribute with a syntax other than Integer or NumericString.
.SH EXAMPLES
.LP
.nf
.SH FILES
.TP
-ETCDIR/slapd.conf
-default slapd configuration file
+\fIETCDIR/slapd.conf\fP
+default \fBslapd\fP configuration file
.SH SEE ALSO
.BR slapd.conf (5).
.SH ACKNOWLEDGEMENTS
.B [\-v]
.B [\-d level]
.B [\-f slapd.conf]
+.B [\-F confdir]
.B [\-D authcDN | \-U authcID]
.B \-b DN
.B [\-u]
.BR slapd.conf (5)
file.
.TP
+.BI \-F " confdir"
+specify a config directory.
+If both
+.B -f
+and
+.B -F
+are specified, the config file will be read and converted to
+config directory format and written to the specified directory.
+If neither option is specified, an attempt to read the
+default config directory wll be made before trying to use the default
+config file. If a valid config directory exists then the
+default config file is ignored.
+.TP
.BI \-D " authcDN"
specify a DN to be used as identity through the test session
when selecting appropriate
.B [\-b suffix]
.B [\-n dbnum]
.B [\-f slapd.conf]
+.B [\-F confdir]
.B [\-l ldif-file]
.SH DESCRIPTION
.LP
.BR slapd.conf (5)
file.
.TP
+.BI \-F " confdir"
+specify a config directory.
+If both
+.B -f
+and
+.B -F
+are specified, the config file will be read and converted to
+config directory format and written to the specified directory.
+If neither option is specified, an attempt to read the
+default config directory wll be made before trying to use the default
+config file. If a valid config directory exists then the
+default config file is ignored. If dryrun mode is also specified,
+no conversion will occur.
+.TP
.BI \-l " ldif-file"
Read LDIF from the specified file instead of standard input.
.SH LIMITATIONS
.B [\-b suffix]
.B [\-n dbnum]
.B [\-f slapd.conf]
+.B [\-F confdir]
.B
.LP
.SH DESCRIPTION
specify an alternative
.BR slapd.conf (5)
file.
+.TP
+.BI \-F " confdir"
+specify a config directory.
+If both
+.B -f
+and
+.B -F
+are specified, the config file will be read and converted to
+config directory format and written to the specified directory.
+If neither option is specified, an attempt to read the
+default config directory wll be made before trying to use the default
+config file. If a valid config directory exists then the
+default config file is ignored.
.SH LIMITATIONS
Your
.BR slapd (8)
default config directory before trying to use the default
config file. If a valid config directory exists then the
default config file is ignored. If dryrun mode is also specified,
-no conversion will occur. All of the slap tools that
-use the config options observe this same behavior.
+no conversion will occur.
.TP
.B \-u
enable dryrun mode (i.e. don't fail if databases cannot be opened,