slapo-refint(5) slapo-refint(5)
NAME
slapo-refint - Referential Integrity overlay to slapd
SYNOPSIS
/opt/local/etc/openldap/slapd.conf
DESCRIPTION
The Referential Integrity overlay can be used with a backend database
such as slapd-bdb(5) to maintain the cohesiveness of a schema which
utilizes reference attributes.
Integrity is maintained by updating database records which contain the
named attributes to match the results of a modrdn or delete operation.
For example, if the integrity attribute were configured as manager,
deletion of the record "uid=robert,ou=people,dc=example,dc=com" would
trigger a search for all other records which have a manager attribute
containing that DN. Entries matching that search would have their man-
ager attribute removed. Or, renaming the same record into
"uid=george,ou=people,dc=example,dc=com" would trigger a search for all
other records which have a manager attribute containing that DN.
Entries matching that search would have their manager attribute deleted
and replaced by the new DN.
rootdn must be set for the database. refint runs as the rootdn to gain
access to make its updates. rootpw is not needed.
CONFIGURATION
These slapd.conf options apply to the Referential Integrity overlay.
They should appear after the overlay directive.
refint_attributes <attribute> [...]
Specify one or more attributes for which integrity will be main-
tained as described above.
refint_nothing <string>
Specify an arbitrary value to be used as a placeholder when the
last value would otherwise be deleted from an attribute. This
can be useful in cases where the schema requires the existence
of an attribute for which referential integrity is enforced. The
attempted deletion of a required attribute will otherwise result
in an Object Class Violation, causing the request to fail. The
string must be a valid DN.
refint_modifiersname <DN>
Specify the DN to be used as the modifiersName of the internal
modifications performed by the overlay. It defaults to "cn=Ref-
erential Integrity Overlay".
Modifications performed by this overlay are not propagated during
replication. This overlay must be configured identically on replication
consumers in order to maintain full synchronization with the provider.
FILES
/opt/local/etc/openldap/slapd.conf
default slapd configuration file
SEE ALSO
slapd.conf(5), slapd-config(5).
ACKNOWLEDGEMENTS
OpenLDAP Software is developed and maintained by The OpenLDAP Project
<http://www.openldap.org/>. OpenLDAP Software is derived from Univer-
sity of Michigan LDAP 3.3 Release.
OpenLDAP 2.4.40 2014/09/20 slapo-refint(5)
openldap 2.4.40 - Generated Tue Oct 11 07:50:29 CDT 2016