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

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