]> git.sur5r.net Git - openldap/blob - doc/man/man8/slapd.8
7ebbf2677b567e74d79c6bb6ecd36c935cf4485e
[openldap] / doc / man / man8 / slapd.8
1 .TH SLAPD 8C "6 November 1995" "U-M LDAP LDVERSION"
2 .SH NAME
3 slapd \- Stand-alone LDAP Daemon
4 .SH SYNOPSIS
5 .B LIBEXECDIR/slapd [\-d debug\-level]
6 .B [\-f slapd\-config\-file] [\-p port\-number]
7 .B [\-s syslog\-level] [\-i]
8 .B 
9 .SH DESCRIPTION
10 .LP
11 .B Slapd
12 is the stand-alone LDAP daemon. It listens for LDAP connections on
13 port 389, responding
14 to the LDAP operations it receives over these connections.
15 .B slapd
16 is typically invoked at boot time, usually out of
17 .BR  /etc/rc.local .
18 Upon startup,
19 .B slapd
20 normally forks and disassociates itself from the invoking tty.
21 If the
22 .B \-d
23 flag is given and debugging is set to some non-zero
24 value,
25 .B slapd
26 will not fork and disassociate from the invoking tty.
27 .LP
28 .B Slapd
29 can be configured to provide replicated service for a database with
30 the help of
31 .BR slurpd ,
32 the standalone LDAP update replication daemon.
33 See
34 .BR slurpd (8)
35 for details.
36 .LP
37 See "The SLAPD and SLURPD Administrator's Guide" for more details on
38 .BR slapd .
39 .SH OPTIONS
40 .TP
41 .BI \-d " debug\-level"
42 Turn on debugging as defined by
43 .I debug\-level.
44 If this option is specified,
45 .B slapd
46 will not fork or disassociate from the invoking terminal.  Some general
47 operation and status messages are printed for any value of \fIdebug\-level\fP.
48 \fIdebug\-level\fP is taken as a bit string, with each bit corresponding to a
49 different kind of debugging information.  See <ldap.h> for details.
50 .TP
51 .BI \-s " syslog\-level"
52 This option tells
53 .B slapd
54 at what level debugging statements should be logged to the
55 .BR syslog (8)
56 facility.
57 .TP
58 .BI \-f " slapd\-config\-file"
59 Specifies the slapd configuration file. The default is
60 .BR ETCDIR/slapd.conf .
61 .TP
62 .BI \-p " port\-number"
63 .B slapd
64 will listen on the default LDAP port (389) unless this option is given
65 to override the default.
66 .TP
67 .B \-i
68 This option tells
69 .B slapd
70 that it is being run from
71 .BR inetd(8) ,
72 the Internet protocol daemon.
73 .SH EXAMPLES
74 To start 
75 .I slapd
76 and have it fork and detach from the terminal and start serving
77 the LDAP databases defined in the default config file, just type:
78 .LP
79 .nf
80 .ft tt
81         ETCDIR/slapd
82 .ft
83 .fi
84 .LP
85 To start 
86 .B slapd
87 with an alternate configuration file, and turn
88 on voluminous debugging which will be printed on standard error, type:
89 .LP
90 .nf
91 .ft tt
92         LIBEXECDIR/slapd -f ETCDIR/slapd.conf -d 255
93 .ft
94 .fi
95 .LP
96 .SH "SEE ALSO"
97 .BR ldap (3),
98 .BR slapd.conf (5),
99 .BR slurpd (8)
100 .LP
101 "The SLAPD and SLURPD Administrator's Guide"
102 .SH BUGS
103 When using the LDBM database backend, the Modify RDN operation does not
104 update the attribute values in the entry that are affected by the change.