2004-04-17 16:17:43 +08:00
|
|
|
.TH SLAPO-REFINT 5 "RELEASEDATE" "OpenLDAP LDVERSION"
|
2011-01-05 08:42:37 +08:00
|
|
|
.\" Copyright 2004-2011 The OpenLDAP Foundation All Rights Reserved.
|
2004-04-17 16:17:43 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.\" $OpenLDAP$
|
|
|
|
|
.SH NAME
|
2009-06-03 08:43:44 +08:00
|
|
|
slapo\-refint \- Referential Integrity overlay to slapd
|
2004-04-17 16:17:43 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The Referential Integrity overlay can be used with a backend database such as
|
2009-06-03 08:43:44 +08:00
|
|
|
.BR slapd\-bdb (5)
|
2004-04-17 16:17:43 +08:00
|
|
|
to maintain the cohesiveness of a schema which utilizes reference attributes.
|
|
|
|
|
.LP
|
|
|
|
|
Integrity is maintained by updating database records which contain the named
|
|
|
|
|
attributes to match the results of a
|
|
|
|
|
.B modrdn
|
|
|
|
|
or
|
|
|
|
|
.B delete
|
|
|
|
|
operation. For example, if the integrity attribute were configured as
|
2004-04-19 05:36:32 +08:00
|
|
|
.BR manager ,
|
2006-05-30 05:14:36 +08:00
|
|
|
deletion of the record "uid=robert,ou=people,dc=example,dc=com" would trigger a
|
2004-04-17 16:17:43 +08:00
|
|
|
search for all other records which have a
|
|
|
|
|
.B manager
|
|
|
|
|
attribute containing that DN. Entries matching that search would have their
|
|
|
|
|
.B manager
|
|
|
|
|
attribute removed.
|
2006-05-30 05:14:36 +08:00
|
|
|
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
|
|
|
|
|
.B manager
|
|
|
|
|
attribute containing that DN.
|
|
|
|
|
Entries matching that search would have their
|
|
|
|
|
.B manager
|
|
|
|
|
attribute deleted and replaced by the new DN.
|
2010-12-01 20:20:04 +08:00
|
|
|
.LP
|
|
|
|
|
.B rootdn
|
|
|
|
|
must be set for the database. refint runs as the rootdn
|
|
|
|
|
to gain access to make its updates.
|
|
|
|
|
.B rootpw
|
|
|
|
|
is not needed.
|
2004-04-17 16:17:43 +08:00
|
|
|
.SH CONFIGURATION
|
|
|
|
|
These
|
|
|
|
|
.B slapd.conf
|
|
|
|
|
options apply to the Referential Integrity overlay.
|
|
|
|
|
They should appear after the
|
|
|
|
|
.B overlay
|
|
|
|
|
directive.
|
|
|
|
|
.TP
|
2008-05-24 19:57:18 +08:00
|
|
|
.B refint_attributes <attribute> [...]
|
2004-04-19 05:36:32 +08:00
|
|
|
Specify one or more attributes for which integrity will be maintained
|
2004-04-17 16:17:43 +08:00
|
|
|
as described above.
|
|
|
|
|
.TP
|
|
|
|
|
.B 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.
|
2008-05-24 19:57:18 +08:00
|
|
|
The string must be a valid DN.
|
|
|
|
|
.TP
|
|
|
|
|
.B refint_modifiersname <DN>
|
|
|
|
|
Specify the DN to be used as the modifiersName of the internal modifications
|
|
|
|
|
performed by the overlay.
|
|
|
|
|
It defaults to "\fIcn=Referential Integrity Overlay\fP".
|
2004-04-17 16:17:43 +08:00
|
|
|
.B
|
|
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
default slapd configuration file
|
|
|
|
|
.SH SEE ALSO
|
2009-01-30 08:23:58 +08:00
|
|
|
.BR slapd.conf (5),
|
|
|
|
|
.BR slapd\-config (5).
|
2007-01-03 04:25:16 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
|
|
|
|
.so ../Project
|
