MAN page from RedHat Other ldap-servers-3.3-3.i386.rpm
SLURPD
Section: Maintenance Commands (8C)
Updated: 6 November 1995
Index NAME
slurpd - Standalone LDAP Update Replication Daemon
SYNOPSIS
/usr/sbin/slurpd [-d debug-level][-f slapd-config-file] [-r slapd-replog-file][-t temp-dir] [-o] [-k srvtab-file] DESCRIPTION
Slurpdis used to propagate changes from one slapd database to another. Ifslapd is configured to produce a replication log, slurpdreads thatreplication log and sends the changes to the slave slapdinstancesvia the LDAP protocol.slurpdis typically invoked at boot time, usually out of/etc/rc.local.
Upon startup,slurpdnormally forks and disassociates itself from the invoking tty,then reads the replication log (given either by thereplogfiledirective in the slapdconfig file, or by the-rcommand-line option).If the replication log file does not exist or is empty,slurpdgoes to sleep. It periodically wakes up and checks to see if thereare any changes to be propoagated.
Whenslurpdnotices that there are changes to propagate to slave slapdinstances, it locks the replication log, makes its own private copy,releases the lock, and forks one copy of itself for each replicaslapdto be updated. Each child process binds to the slave slapdas theDN given by thebinddnoption to thereplicadirective in theslapdconfig file, and sends the changes.
Seeslapd(8)for details on the standalone LDAP daemon.
OPTIONS
- -d debug-level
- Turn on debugging as defined bydebug-level.If this option is specified,slurpdwill not fork or disassociate from the invoking terminal. Some generaloperation and status messages are printed for any value of debug-level.debug-level is taken as a bit string, with each bit corresponding to adifferent kind of debugging information. See <ldap.h> for details.
- -f slapd-config-file
- Specifies the slapd configuration file. The default is/etc/slapd.conf.
- -r slapd-replog-file
- Specifies the name of the slapdreplication logfile. Normally, the nameof the replication log file is read from the slapdconfiguration file.The-roption allows you to override this. In conjunction with the-ooption, you can process a replication log file in a "one-shot" mode. Forexample, if slurpdhas encountered errors in processing a replication log,you can run it in one-shot mode and give the rejection file name asthe argument to the -r option, once you've resolved the problem which causedthe replication to fail.
- -o
- Run in "one-shot" mode. Normally, slurpdprocesses the replog fileand then watches for more replication entries to be appended. Inone-shot mode, slurpdprocesses a replication log and exits.
- -t temp-dir
- slurpdcopies the replication log to a working directory before processing it.This option allows you to specify the location of these temporary files. The default is/usr/tmp.
- -k srvtab-file
- Specify the location of the kerberos srvtab file which contains keysfor the replica slapdinstances. Overrides the srvtab argument to thereplica directive in the slapdconfiguration file.
EXAMPLES
To start
slurpdand have it fork and detach from the terminal and processthe replication logs generated by
slapd,just type:
/usr/sbin/slurpd
To start slurpdwith an alternate slapdconfiguration file, and turnon voluminous debugging which will be printed on standard error, type:
/usr/sbin/slurpd -f /usr/local/etc/slapd.conf -d 255
SEE ALSO
ldap(3),
slapd.replog(5),
slapd(8)
"The SLAPD and SLURPD Administrator's Guide"
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- EXAMPLES
- SEE ALSO
This document was created byman2html,using the manual pages.
