Home | History | Annotate | Line # | Download | only in man 
      1 .lf 1 stdin
      2 .TH SLAPO-DEREF 5 "2025/05/22" "OpenLDAP 2.6.10"
      3 .\" Copyright 2008-2024 The OpenLDAP Foundation All Rights Reserved.
      4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
      5 .\" $OpenLDAP$
      6 .SH NAME
      7 slapo\-deref \- Dereference Control overlay to slapd
      8 .SH SYNOPSIS
      9 /etc/openldap/slapd.conf
     10 .TP
     11 /etc/openldap/slapd.d
     12 .SH DESCRIPTION
     13 This overlay implements the draft Dereference control. The overlay can be
     14 used with any backend or globally for all backends.
     15 
     16 .SH EXAMPLES
     17 .nf
     18   database mdb
     19   ...
     20   overlay deref
     21 .fi
     22 
     23 Given these entries:
     24 .nf
     25   dn: cn=Howard Chu,ou=people,dc=example,dc=org
     26   objectClass: inetOrgPerson
     27   cn: Howard Chu
     28   sn: Chu
     29   uid: hyc
     30 
     31   dn: cn=Pierangelo Masarati,ou=people,dc=example,dc=org
     32   objectClass: inetOrgPerson
     33   cn: Pierangelo Masarati
     34   sn: Masarati
     35   uid: ando
     36 
     37   dn: cn=Test Group,ou=groups,dc=example,dc=org
     38   objectClass: groupOfNames
     39   cn: Test Group
     40   member: cn=Howard Chu,ou=people,dc=example,dc=org
     41   member: cn=Pierangelo Masarati,ou=people,dc=example,dc=org
     42 .fi
     43 
     44 A search could be performed with a Dereference request control value
     45 specified as
     46 
     47 .nf
     48   { member, uid }
     49 .fi
     50 
     51 I.e.,
     52 .nf
     53   ldapsearch -x -b dc=example,dc=org -E 'deref=member:uid'
     54 .fi
     55 
     56 and the "cn=Test Group" entry would be returned with the response
     57 control value
     58 .nf
     59   { { member, cn=Howard Chu,ou=people,dc=example,dc=org,
     60       { { uid, [hyc] } } },
     61     { member, cn=Pierangelo Masarati,ou=people,dc=example,dc=org,
     62       { { uid, [ando] } } } }
     63 .fi
     64 
     65 .SH FILES
     66 .TP
     67 /etc/openldap/slapd.conf
     68 default slapd configuration file
     69 .TP
     70 /etc/openldap/slapd.d
     71 default slapd configuration directory
     72 .SH SEE ALSO
     73 .BR slapd.conf (5),
     74 .BR slapd\-config (5).
     75 .LP
     76 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
     77 .LP
     78 IETF LDAP Dereference Control proposal by P. Masarati, H. Chu,
     79 in IETF document "draft-masarati-ldap-deref-00.txt".
     80 .SH AUTHOR
     81 Pierangelo Masarati
     82