git.sur5r.net Git - openldap/blob - doc/man/man8/slapd.8

   1 .TH SLAPD 8C "20 January 1999" "OpenLDAP 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] [\-l syslog\-local\-user] [\-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 configured in
  22 .BR ETCDIR/slapd.conf ,
  23 the
  24 .B slapd
  25 process will print its process ID ( see
  26 .BR getpid (2)
  27 ) to a
  28 .B .pid
  29 file, as well as the command line options during invocation to an
  30 .B .args
  31 file ( see
  32 .BR slapd.conf (5)
  33 ).
  34 If the
  35 .B \-d
  36 flag is given and debugging is set to some non-zero
  37 value,
  38 .B slapd
  39 will not fork and disassociate from the invoking tty.
  40 .LP
  41 .B Slapd
  42 can be configured to provide replicated service for a database with
  43 the help of
  44 .BR slurpd ,
  45 the standalone LDAP update replication daemon.
  46 See
  47 .BR slurpd (8)
  48 for details.
  49 .LP
  50 See "The SLAPD and SLURPD Administrator's Guide" for more details on
  51 .BR slapd .
  52 .SH OPTIONS
  53 .TP
  54 .BI \-d " debug\-level"
  55 Turn on debugging as defined by
  56 .I debug\-level.
  57 If this option is specified,
  58 .B slapd
  59 will not fork or disassociate from the invoking terminal.  Some general
  60 operation and status messages are printed for any value of \fIdebug\-level\fP.
  61 \fIdebug\-level\fP is taken as a bit string, with each bit corresponding to a
  62 different kind of debugging information.  See <ldap.h> for details.
  63 .TP
  64 .BI \-s " syslog\-level"
  65 This option tells
  66 .B slapd
  67 at what level debugging statements should be logged to the
  68 .BR syslog (8)
  69 facility.
  70 .TP
  71 .BI \-l " syslog\-local\-user"
  72 Selects the local user of the
  73 .BR syslog (8)
  74 facility. Values can be
  75 .BR LOCAL0 ,
  76 .BR LOCAL1 ,
  77 and so on, up to
  78 .BR LOCAL7 .
  79 The default is
  80 .BR LOCAL4 .
  81 However, this option is only permitted on systems that support
  82 local users with the
  83 .BR syslog (8)
  84 facility.
  85 .TP
  86 .BI \-f " slapd\-config\-file"
  87 Specifies the slapd configuration file. The default is
  88 .BR ETCDIR/slapd.conf .
  89 .TP
  90 .BI \-p " port\-number"
  91 .B slapd
  92 will listen on the default LDAP port (389) unless this option is given
  93 to override the default.
  94 .TP
  95 .B \-i
  96 This option tells
  97 .B slapd
  98 that it is being run from
  99 .BR inetd(8) ,
 100 the Internet protocol daemon.
 101 .SH EXAMPLES
 102 To start
 103 .I slapd
 104 and have it fork and detach from the terminal and start serving
 105 the LDAP databases defined in the default config file, just type:
 106 .LP
 107 .nf
 108 .ft tt
 109         LIBEXECDIR/slapd
 110 .ft
 111 .fi
 112 .LP
 113 To start
 114 .B slapd
 115 with an alternate configuration file, and turn
 116 on voluminous debugging which will be printed on standard error, type:
 117 .LP
 118 .nf
 119 .ft tt
 120         LIBEXECDIR/slapd -f ETCDIR/slapd.conf -d 255
 121 .ft
 122 .fi
 123 .LP
 124 .SH "SEE ALSO"
 125 .BR ldap (3),
 126 .BR slapd.conf (5),
 127 .BR slurpd (8)
 128 .LP
 129 "The SLAPD and SLURPD Administrator's Guide"
 130 .SH BUGS
 131 When using the LDBM database backend, the Modify RDN operation does not
 132 update the attribute values in the entry that are affected by the change.
 133 .SH ACKNOWLEDGEMENTS
 134 .B      OpenLDAP
 135 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
 136 .B      OpenLDAP
 137 is derived from University of Michigan LDAP 3.3 Release.