Manual Pages for UNIX Darwin command on man slurpd

SLURPD(8C) SLURPD(8C)

NAME

slurpd - Standalone LDAP Update Replication Daemon

SYNOPSIS

//uussrr//lliibbeexxeecc//sslluurrppdd [[-dd ddeebbuugg-lleevveell]] [[-ff ssllaappdd-ccoonnffiigg-ffiillee]] [[-rr

ssllaappdd-rreepplloogg-ffiillee]] [[-tt tteemmpp-ddiirr]] [[-oo]] [[-kk ssrrvvttaabb-ffiillee]]

DESCRIPTION

SSlluurrppdd is used to propagate changes from one slapd database to another. If slapd is configured to produce a replication log, sslluurrppdd reads that replication log and sends the changes to the slave ssllaappdd instances via the LDAP protocol. sslluurrppdd is typically invoked at boot time, usually out of //eettcc//rrcc..llooccaall. Upon startup, sslluurrppdd normally forks and disassociates itself from the invoking tty, then reads the replication log (given either by the

replogfile directive in the ssllaappdd config file, or by the -rr command-

line option). If the replication log file does not exist or is empty, sslluurrppdd goes to sleep. It periodically wakes up and checks to see if there are any changes to be propoagated. When sslluurrppdd notices that there are changes to propagate to slave ssllaappdd instances, it locks the replication log, makes its own private copy, releases the lock, and forks one copy of itself for each replica ssllaappdd to be updated. Each child process binds to the slave ssllaappdd as the DN given by the binddn option to the replica directive in the ssllaappdd config file, and sends the changes. See ssllaappdd(8) for details on the standalone LDAP daemon.

Note that slurpd reads rreepplliiccaattiioonn directive from ssllaappdd..ccoonnff(5), but

uses llddaapp..ccoonnff(5) to obtain other configuration settings (such as TLS settings). OOPPTTIIOONNSS

-dd debug-level

Turn on debugging as defined by debug-level. If this option is

specified, even with a zero argument, sslluurrppdd will not fork or disassociate from the invoking terminal. Some general operation

and status messages are printed for any value of debug-level.

debug-level is taken as a bit string, with each bit correspond-

ing to a different kind of debugging information. See for details.

-ff slapd-config-file

Specifies the slapd configuration file. The default is //eettcc//ooppeennllddaapp//ssllaappdd..ccoonnff.

-rr slapd-replog-file

Specifies the name of the ssllaappdd replication logfile. Normally,

the name of the replication log file is read from the ssllaappdd con-

figuration file. The file should be located in a directory with

limited read/write/execute access. The -rr option allows you to

override this. In conjunction with the -oo option, you can

process a replication log file in a "one-shot" mode. For exam-

ple, if sslluurrppdd has encountered errors in processing a replica-

tion log, you can run it in one-shot mode and give the rejection

file name as the argument to the -r option, once you've resolved

the problem which caused the replication to fail.

-oo Run in "one-shot" mode. Normally, sslluurrppdd processes the replog

file and then watches for more replication entries to be

appended. In one-shot mode, sslluurrppdd processes a replication log

and exits.

-tt temp-dir

sslluurrppdd copies the replication log to a working directory before processing it. The directory permissions should limit

read/write/execute access as temporary files may contain sensi-

tive information. This option allows you to specify the loca-

tion of these temporary files. The default is //vvaarr//ddbb//ooppeennll-

ddaapp//ooppeennllddaapp-sslluurrpp.

-kk srvtab-file

Specify the location of the kerberos srvtab file which contains keys for the replica slapd instances. Overrides the srvtab argument to the replica directive in the slapd configuration file. EEXXAAMMPPLLEESS