slapd.replog File Format

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

One or more lines indicating the replicas to which the change is to be propagated:

 replica: hostname[ :portnumber ]

The time the change took place 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 replication log files.

time: integer [ .integer ]

The distinguished name of the entry being changed:

dn: distinguishedname

The type of change being made:

changetype: [modify|add|delete|modrdn]

The change information, the format of which depends on what kind of change was specified in the preceding. For a changetype of modify, the format is one or more of the following:

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

For a replace modification:

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

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

where 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.

Access to the slapd.replog file is synchronized through the use of flock(3) on the file slapd.replog.lock. Any process reading or writing this file should obey this locking convention. The format of the values is the LDAP Directory Interchange Format described in "LDAP Data Interchange Format."