git.sur5r.net Git - openldap/blob - doc/man/man5/slapo-memberof.5

   1 .TH SLAPO-MEMBEROF 5 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" Copyright 1998-2007 The OpenLDAP Foundation, All Rights Reserved.
   3 .\" Copying restrictions apply.  See the COPYRIGHT file.
   4 .\" $OpenLDAP$
   5 .SH NAME
   6 slapo-memberof \- Reverse Group Membership overlay to slapd
   7 .SH SYNOPSIS
   8 ETCDIR/slapd.conf
   9 .SH DESCRIPTION
  10 The
  11 .B memberof
  12 overlay to
  13 .BR slapd (8)
  14 allows automatic reverse group membership maintenance.
  15 Any time a group entry is modified, its members are modified as appropriate
  16 in order to keep a DN-valued "is member of" attribute updated with the DN
  17 of the group.
  18
  19 .SH CONFIGURATION
  20 The config directives that are specific to the
  21 .B memberof
  22 overlay must be prefixed by
  23 .BR memberof\- ,
  24 to avoid potential conflicts with directives specific to the underlying
  25 database or to other stacked overlays.
  26
  27 .TP
  28 .B overlay memberof
  29 This directive adds the memberof overlay to the current database; see
  30 .BR slapd.conf (5)
  31 for details.
  32
  33 .LP
  34 The following
  35 .B slapd.conf
  36 configuration options are defined for the memberofoverlay.
  37
  38 .TP
  39 .B memberof-group-oc <group-oc>
  40 The value
  41 .B <group-oc>
  42 is the name of the objectClass that triggers the reverse group membership
  43 update.
  44 It defaults to \fIgroupOfNames\fP.
  45
  46 .TP
  47 .B memberof-member-ad <member-ad>
  48 The value
  49 .B <member-ad>
  50 is the name of the attribute that contains the names of the members
  51 in the group objects; it must be DN-valued.
  52 It defaults to \fImember\fP.
  53
  54 .TP
  55 .B memberof-memberof-ad <memberof-ad>
  56 The value
  57 .B <memberof-ad>
  58 is the name of the attribute that contains the names of the groups
  59 an entry is member of; it must be DN-valued.  Its contents are
  60 automatically updated by the overlay.
  61 It defaults to \fImemberOf\fP.
  62
  63 .TP
  64 .B memberof-dn <dn>
  65 The value
  66 .B <dn>
  67 contains the DN that is used as \fImodifiersName\fP for internal
  68 modifications performed to update the reverse group membership.
  69 It defaults to the \fIrootdn\fP of the underlying database.
  70
  71 .TP
  72 .B memberof-dangling {ignore, drop, error}
  73 This option determines the behavior of the overlay when, during
  74 a modification, it encounters dangling references.
  75 The default is
  76 .BR ignore ,
  77 which may leave dangling references.
  78 Other options are
  79 .BR drop ,
  80 which discards those modifications that would result in dangling
  81 references, and
  82 .BR error ,
  83 which causes modifications that would result in dangling references
  84 to fail.
  85
  86 .TP
  87 .B memberof-refint {true|FALSE}
  88 This option determines whether the overlay will try to preserve
  89 referential integrity or not.
  90 If set to
  91 .BR TRUE ,
  92 when an entry containing values of the "is member of" attribute is modified,
  93 the corresponding groups are modified as well.
  94
  95 .LP
  96 The memberof overlay may be used with any backend that provides full
  97 read-write functionality, but it is mainly intended for use
  98 with local storage backends.
  99
 100 .SH FILES
 101 .TP
 102 ETCDIR/slapd.conf
 103 default slapd configuration file
 104 .SH SEE ALSO
 105 .BR slapd.conf (5),
 106 .BR slapd (8).
 107 The
 108 .BR slapo-memberof (5)
 109 overlay supports dynamic configuration via
 110 .BR back-config .
 111 .SH ACKNOWLEDGEMENTS
 112 .P
 113 This module was written in 2005 by Pierangelo Masarati for SysNet s.n.c.
 114