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 corre­
       sponding 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 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  for­
       mat  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>

            ...
            -

       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

       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.

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

       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.


EXAMPLE

       The following sample slapd.replog file  contains  informa­
       tion 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 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


FILES

       slapd.replog slapd.replog.lock


SEE ALSO

       ldap(3), ldif(5), slapd(8), slurpd(8)


ACKNOWLEDGEMENTS

       OpenLDAP  is developed and maintained by The OpenLDAP Pro­
       ject (http://www.openldap.org/).  OpenLDAP is derived from
       University of Michigan LDAP 3.3 Release.


Man(1) output converted with man2html