1999-01-21 23:53:54 +08:00
|
|
|
.TH SLAPD 8C "20 January 1999" "OpenLDAP LDVERSION"
|
1998-08-09 08:43:13 +08:00
|
|
|
.SH NAME
|
|
|
|
slapd \- Stand-alone LDAP Daemon
|
|
|
|
.SH SYNOPSIS
|
1998-08-19 10:38:35 +08:00
|
|
|
.B LIBEXECDIR/slapd [\-d debug\-level]
|
1998-08-09 08:43:13 +08:00
|
|
|
.B [\-f slapd\-config\-file] [\-p port\-number]
|
1999-01-08 17:59:09 +08:00
|
|
|
.B [\-s syslog\-level] [\-l syslog\-local\-user] [\-i]
|
1998-08-09 08:43:13 +08:00
|
|
|
.B
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.LP
|
|
|
|
.B Slapd
|
|
|
|
is the stand-alone LDAP daemon. It listens for LDAP connections on
|
|
|
|
port 389, responding
|
|
|
|
to the LDAP operations it receives over these connections.
|
|
|
|
.B slapd
|
|
|
|
is typically invoked at boot time, usually out of
|
|
|
|
.BR /etc/rc.local .
|
|
|
|
Upon startup,
|
|
|
|
.B slapd
|
|
|
|
normally forks and disassociates itself from the invoking tty.
|
1999-01-21 23:53:54 +08:00
|
|
|
If configured in
|
|
|
|
.BR ETCDIR/slapd.conf ,
|
|
|
|
the
|
1999-01-08 17:59:09 +08:00
|
|
|
.B slapd
|
1999-01-21 23:53:54 +08:00
|
|
|
process will print its process ID ( see
|
1999-01-08 17:59:09 +08:00
|
|
|
.BR getpid (2)
|
1999-01-21 23:53:54 +08:00
|
|
|
) to a
|
|
|
|
.B .pid
|
|
|
|
file, as well as the command line options during invocation to an
|
1999-01-08 17:59:09 +08:00
|
|
|
.B .args
|
1999-01-21 23:53:54 +08:00
|
|
|
file ( see
|
|
|
|
.BR slapd.conf (5)
|
|
|
|
).
|
1998-08-09 08:43:13 +08:00
|
|
|
If the
|
|
|
|
.B \-d
|
|
|
|
flag is given and debugging is set to some non-zero
|
|
|
|
value,
|
|
|
|
.B slapd
|
|
|
|
will not fork and disassociate from the invoking tty.
|
|
|
|
.LP
|
|
|
|
.B Slapd
|
|
|
|
can be configured to provide replicated service for a database with
|
|
|
|
the help of
|
|
|
|
.BR slurpd ,
|
|
|
|
the standalone LDAP update replication daemon.
|
|
|
|
See
|
|
|
|
.BR slurpd (8)
|
|
|
|
for details.
|
|
|
|
.LP
|
|
|
|
See "The SLAPD and SLURPD Administrator's Guide" for more details on
|
|
|
|
.BR slapd .
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
|
|
.BI \-d " debug\-level"
|
|
|
|
Turn on debugging as defined by
|
|
|
|
.I debug\-level.
|
|
|
|
If this option is specified,
|
|
|
|
.B slapd
|
|
|
|
will not fork or disassociate from the invoking terminal. Some general
|
|
|
|
operation and status messages are printed for any value of \fIdebug\-level\fP.
|
|
|
|
\fIdebug\-level\fP is taken as a bit string, with each bit corresponding to a
|
|
|
|
different kind of debugging information. See <ldap.h> for details.
|
|
|
|
.TP
|
|
|
|
.BI \-s " syslog\-level"
|
|
|
|
This option tells
|
|
|
|
.B slapd
|
|
|
|
at what level debugging statements should be logged to the
|
|
|
|
.BR syslog (8)
|
|
|
|
facility.
|
|
|
|
.TP
|
1999-01-08 18:09:07 +08:00
|
|
|
.BI \-l " syslog\-local\-user"
|
1999-01-08 17:59:09 +08:00
|
|
|
Selects the local user of the
|
|
|
|
.BR syslog (8)
|
|
|
|
facility. Values can be
|
|
|
|
.BR LOCAL0 ,
|
|
|
|
.BR LOCAL1 ,
|
|
|
|
and so on, up to
|
|
|
|
.BR LOCAL7 .
|
|
|
|
The default is
|
|
|
|
.BR LOCAL4 .
|
|
|
|
However, this option is only permitted on systems that support
|
|
|
|
local users with the
|
|
|
|
.BR syslog (8)
|
|
|
|
facility.
|
|
|
|
.TP
|
1998-08-09 08:43:13 +08:00
|
|
|
.BI \-f " slapd\-config\-file"
|
|
|
|
Specifies the slapd configuration file. The default is
|
|
|
|
.BR ETCDIR/slapd.conf .
|
|
|
|
.TP
|
|
|
|
.BI \-p " port\-number"
|
|
|
|
.B slapd
|
|
|
|
will listen on the default LDAP port (389) unless this option is given
|
|
|
|
to override the default.
|
|
|
|
.TP
|
|
|
|
.B \-i
|
|
|
|
This option tells
|
|
|
|
.B slapd
|
|
|
|
that it is being run from
|
|
|
|
.BR inetd(8) ,
|
|
|
|
the Internet protocol daemon.
|
|
|
|
.SH EXAMPLES
|
|
|
|
To start
|
|
|
|
.I slapd
|
|
|
|
and have it fork and detach from the terminal and start serving
|
|
|
|
the LDAP databases defined in the default config file, just type:
|
|
|
|
.LP
|
|
|
|
.nf
|
|
|
|
.ft tt
|
1998-08-20 02:19:39 +08:00
|
|
|
LIBEXECDIR/slapd
|
1998-08-09 08:43:13 +08:00
|
|
|
.ft
|
|
|
|
.fi
|
|
|
|
.LP
|
|
|
|
To start
|
|
|
|
.B slapd
|
|
|
|
with an alternate configuration file, and turn
|
|
|
|
on voluminous debugging which will be printed on standard error, type:
|
|
|
|
.LP
|
|
|
|
.nf
|
|
|
|
.ft tt
|
1998-08-19 10:38:35 +08:00
|
|
|
LIBEXECDIR/slapd -f ETCDIR/slapd.conf -d 255
|
1998-08-09 08:43:13 +08:00
|
|
|
.ft
|
|
|
|
.fi
|
|
|
|
.LP
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR ldap (3),
|
|
|
|
.BR slapd.conf (5),
|
|
|
|
.BR slurpd (8)
|
|
|
|
.LP
|
|
|
|
"The SLAPD and SLURPD Administrator's Guide"
|
|
|
|
.SH BUGS
|
|
|
|
When using the LDBM database backend, the Modify RDN operation does not
|
|
|
|
update the attribute values in the entry that are affected by the change.
|
1998-10-25 09:41:42 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
|
|
|
.B OpenLDAP
|
|
|
|
is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
|
|
|
|
.B OpenLDAP
|
|
|
|
is derived from University of Michigan LDAP 3.3 Release.
|