git.sur5r.net Git - openldap/blob - doc/man/man5/slapd-dnssrv.5

   1 .TH SLAPD-DNSSRV 5 "RELEASEDATE" "OpenLDAP LDVERSION"
   2 .\" Copyright 1998-2017 The OpenLDAP Foundation All Rights Reserved.
   3 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   4 .\" $OpenLDAP$
   5 .SH NAME
   6 slapd\-dnssrv \- DNS SRV referral backend to slapd
   7 .SH SYNOPSIS
   8 ETCDIR/slapd.conf
   9 .SH DESCRIPTION
  10 The DNSSRV backend to
  11 .BR slapd (8)
  12 serves up referrals based upon SRV resource records held in
  13 the Domain Name System.
  14 .LP
  15 This backend is experimental.
  16 .SH CONFIGURATION
  17 The DNSSRV backend has no backend nor database specific options.
  18 It is configured simply by "database dnssrv" followed a suffix
  19 directive, e.g. suffix "".
  20 .SH ACCESS CONTROL
  21 The
  22 .B dnssrv
  23 backend does not honor all ACL semantics as described in
  24 .BR slapd.access (5).
  25 In fact, this backend only implements the
  26 .B search
  27 operation when the
  28 .B manageDSAit
  29 control (RFC 3296) is used, otherwise for every operation a referral,
  30 whenever appropriate, or an error is returned.
  31 Currently, there is no means to condition the returning of the referral
  32 by means of ACLs; no access control is implemented, except for
  33 .B read (=r)
  34 access to the returned entries, which is actually provided by the frontend.
  35 Note, however, that the information returned by this backend is collected
  36 through the DNS, so it is public by definition.
  37 .SH FILES
  38 .TP
  39 ETCDIR/slapd.conf
  40 default slapd configuration file
  41 .br
  42 .SH SEE ALSO
  43 \fB"OpenLDAP Root Service - An experimental LDAP referral
  44 service"\fR [RFC 3088],
  45 .br
  46 \fB"OpenLDAP LDAP Root Service"\fR <http://www.openldap.org/faq/?file=393)>,
  47 .br
  48 .BR slapd.conf (5),
  49 .BR slapd (8)