xref: /netbsd-src/external/bsd/openldap/dist/doc/man/man5/slapo-deref.5 (revision e670fd5c413e99c2f6a37901bb21c537fcd322d2)
SLAPO-DEREF 5 "RELEASEDATE" "OpenLDAP LDVERSION"
Copyright 2008-2021 The OpenLDAP Foundation All Rights Reserved.
Copying restrictions apply. See COPYRIGHT/LICENSE.
$OpenLDAP$
NAME
slapo-deref - Dereference Control overlay to slapd
SYNOPSIS
ETCDIR/slapd.conf

ETCDIR/slapd.d

DESCRIPTION
This overlay implements the draft Dereference control. The overlay can be used with any backend or globally for all backends.
EXAMPLES
 database mdb
 ...
 overlay deref
Given these entries:
 dn: cn=Howard Chu,ou=people,dc=example,dc=org
 objectClass: inetOrgPerson
 cn: Howard Chu
 sn: Chu
 uid: hyc

 dn: cn=Pierangelo Masarati,ou=people,dc=example,dc=org
 objectClass: inetOrgPerson
 cn: Pierangelo Masarati
 sn: Masarati
 uid: ando

 dn: cn=Test Group,ou=groups,dc=example,dc=org
 objectClass: groupOfNames
 cn: Test Group
 member: cn=Howard Chu,ou=people,dc=example,dc=org
 member: cn=Pierangelo Masarati,ou=people,dc=example,dc=org
A search could be performed with a Dereference request control value specified as
 { member, uid }
I.e.,
 ldapsearch -x -b dc=example,dc=org -E 'deref=member:uid'
and the "cn=Test Group" entry would be returned with the response control value
 { { member, cn=Howard Chu,ou=people,dc=example,dc=org,
 { { uid, [hyc] } } },
 { member, cn=Pierangelo Masarati,ou=people,dc=example,dc=org,
 { { uid, [ando] } } } }
FILES

ETCDIR/slapd.conf default slapd configuration file

ETCDIR/slapd.d default slapd configuration directory

SEE ALSO
slapd.conf (5), slapd-config (5).

"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)

IETF LDAP Dereference Control proposal by P. Masarati, H. Chu, in IETF document "draft-masarati-ldap-deref-00.txt".

AUTHOR
Pierangelo Masarati