1 .TH SLURPD 8C "20 August 2000" "OpenLDAP LDVERSION"
3 .\" Copyright 1998-2000 The OpenLDAP Foundation All Rights Reserved.
4 .\" Copying restrictions apply. See COPYRIGHT/LICENSE.
6 slurpd \- Standalone LDAP Update Replication Daemon
8 .B LIBEXECDIR/slurpd [\-d debug\-level]
9 .B [\-f slapd\-config\-file] [\-r slapd\-replog\-file]
10 .B [\-t temp\-dir] [\-o] [\-k srvtab\-file]
15 is used to propagate changes from one slapd database to another. If
16 slapd is configured to produce a replication log,
19 replication log and sends the changes to the slave
22 via the LDAP protocol.
24 is typically invoked at boot time, usually out of
29 normally forks and disassociates itself from the invoking tty,
30 then reads the replication log (given either by the
34 config file, or by the
37 If the replication log file does not exist or is empty,
39 goes to sleep. It periodically wakes up and checks to see if there
40 are any changes to be propoagated.
44 notices that there are changes to propagate to slave
46 instances, it locks the replication log, makes its own private copy,
47 releases the lock, and forks one copy of itself for each replica
49 to be updated. Each child process binds to the slave
58 config file, and sends the changes.
62 for details on the standalone LDAP daemon.
65 .BI \-d " debug\-level"
66 Turn on debugging as defined by
68 If this option is specified, even with a zero argument,
70 will not fork or disassociate from the invoking terminal. Some general
71 operation and status messages are printed for any value of \fIdebug\-level\fP.
72 \fIdebug\-level\fP is taken as a bit string, with each bit corresponding to a
73 different kind of debugging information. See <ldap.h> for details.
75 .BI \-f " slapd\-config\-file"
76 Specifies the slapd configuration file. The default is
77 .BR ETCDIR/slapd.conf .
79 .BI \-r " slapd\-replog\-file"
80 Specifies the name of the
82 replication logfile. Normally, the name
83 of the replication log file is read from the
85 configuration file. The file should be located in a directory
86 with limited read/write/execute access.
89 option allows you to override this. In conjunction with the
91 option, you can process a replication log file in a "one\-shot" mode. For
94 has encountered errors in processing a replication log,
95 you can run it in one\-shot mode and give the rejection file name as
96 the argument to the \-r option, once you've resolved the problem which caused
97 the replication to fail.
100 Run in "one\-shot" mode. Normally,
102 processes the replog file
103 and then watches for more replication entries to be appended. In
106 processes a replication log and exits.
110 copies the replication log to a working directory before processing it.
111 The directory permissions should limit read/write/execute access as
112 temporary files may contain sensitive information.
113 This option allows you to specify the location of these temporary files.
115 .BR LOCALSTATEDIR/openldap-slurp .
117 .BI \-k " srvtab\-file"
118 Specify the location of the kerberos srvtab file which contains keys
121 instances. Overrides the srvtab argument to the
122 replica directive in the
128 and have it fork and detach from the terminal and process
129 the replication logs generated by
143 configuration file, and turn
144 on voluminous debugging which will be printed on standard error, type:
148 LIBEXECDIR/slurpd -f ETCDIR/slapd.conf -d 255
154 .BR slapd.replog (5),
157 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
160 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
162 is derived from University of Michigan LDAP 3.3 Release.