slapd.replog(4ldap)

slapd.replog -- slapd replication log format

Synopsis

slapd.replog 
slapd.replog.lock

Description

The file slapd.replog is produced by the stand-alone LDAP daemon, slapd when changes are made to its local database that are to be propagated to one or more replica slapds. The file consists of zero or more records, each one corresponding to a change, addition, or deletion from the slapd database. The file is meant to be read and processed by slurpd, the stand-alone LDAP update replication daemon. The records are separated by a blank line. Each record has the following format.

The record begins with one or more lines indicating the replicas to which the change is to be propagated:

   replica: hostname[:portnumber]

Next, the time the change took place is given, as the number of seconds since 00:00:00 GMT, Jan. 1, 1970, with an optional decimal extension, in order to make times unique. Note that slapd does not make times unique, but slurpd makes all times unique in its copies of the replog files.

   time: integer[.integer]

Next, the distinguished name of the entry being changed is given:

   dn: distinguishedname

Next, the type of change being made is given:

   changetype: [modify|add|delete|modrdn]

Finally, the change information itself is given, the format of which depends on what kind of change was specified above. For a changetype of modify, the format is one or more of the following:

   add: attributetype 
   attributetype: value1 
   attributetype: value2 
   ... 
   -

Or, for a replace modification:

   replace: attributetype 
   attributetype: value1 
   attributetype: value2 
   ... 
   -

Or, for a delete modification:

   delete: attributetype 
   attributetype: value1 
   attributetype: value2 
   ... 
   -

If no attributetype lines are given, the entire attribute is to be deleted.

For a changetype of add, the format is:

   attributetype1: value1 
   attributetype1: value2 
   ... 
   attributetypeN: value1 
   attributetypeN: value2

For a changetype of modrdn, the format is:

   newrdn: newrdn 
   deleteoldrdn: 0 | 1

A value of ``1'' for deleteoldrdn means to delete the values forming the old RDN from the entry, and a value of 0 means to leave the values as non-distinguished attributes in the entry.

For a changetype of delete, no additional information is needed in the record.

The format of the values is the LDAP Directory Interchange Format described in ldif(4ldap).

Access to the slapd.replog file is synchronized through the use of lockf(3C) on the file slapd.replog.lock. Any process reading or writing this file should obey this locking convention.

Examples

The following sample slapd.replog file contains information on one of each type of change.

   replica: truelies.rs.itd.umich.edu 
   replica: judgmentday.rs.itd.umich.edu 
   time: 797612941 
   dn: cn=Babs Jensen, o=U of M, c=US 
   changetype: add 
   objectclass: person 
   cn: babs 
   cn: babs jensen 
   sn: jensen 
   	 
   replica: truelies.rs.itd.umich.edu 
   replica: judgmentday.rs.itd.umich.edu 
   time: 797612973 
   dn: cn=Babs Jensen, o=U of M, c=US 
   changetype: modify 
   add: description 
   description: the fabulous babs 
   	 
   replica: truelies.rs.itd.umich.edu 
   replica: judgmentday.rs.itd.umich.edu 
   time: 797613020 
   dn: cn=Babs Jensen, o=U of M, c=US 
   changetype: modrdn 
   newrdn: cn=Barbara J Jensen 
   deleteoldrdn: 0

References

Intro(3ldap), ldif(4ldap), slapd(1Mldap), slurpd(1Mldap)