openldap/doc/man/man5/slapd-dnssrv.5

.TH SLAPD-DNSSRV 5 "RELEASEDATE" "OpenLDAP LDVERSION"
.\" Copyright 1998-2009 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH NAME
slapd\-dnssrv \- DNS SRV referral backend to slapd
.SH SYNOPSIS
ETCDIR/slapd.conf
.SH DESCRIPTION
The DNSSRV backend to
.BR slapd (8)
serves up referrals based upon SRV resource records held in
the Domain Name System.
.LP
This backend is experimental.
.SH CONFIGURATION
The DNSSRV backend has no backend nor database specific options.
It is configured simply by "database dnssrv" followed a suffix
directive, e.g. suffix "".
.SH ACCESS CONTROL
The
.B dnssrv
backend does not honor all ACL semantics as described in
.BR slapd.access (5).
In fact, this backend only implements the
.B search
operation when the
.B manageDSAit
control (RFC 3296) is used, otherwise for every operation a referral,
whenever appropriate, or an error is returned.
Currently, there is no means to condition the returning of the referral
by means of ACLs; no access control is implemented, except for 
.B read (=r)
access to the returned entries, which is actually provided by the frontend.
Note, however, that the information returned by this backend is collected
through the DNS, so it is public by definition.
.SH FILES
.TP
ETCDIR/slapd.conf
default slapd configuration file
.br
.SH SEE ALSO
\fB"OpenLDAP Root Service - An experimental LDAP referral
service"\fR [RFC 3088],
.br
\fB"OpenLDAP LDAP Root Service"\fR <http://www.openldap.org/faq/?file=393)>,
.br
.BR slapd.conf (5),
.BR slapd (8)
Generate man page date from version.sh 2002-06-13 11:59:10 +08:00			`.TH SLAPD-DNSSRV 5 "RELEASEDATE" "OpenLDAP LDVERSION"`
Update copyright notices 2009-01-22 08:40:04 +08:00			`.\" Copyright 1998-2009 The OpenLDAP Foundation All Rights Reserved.`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`.\" Copying restrictions apply. See COPYRIGHT/LICENSE.`
			`.\" $OpenLDAP$`
			`.SH NAME`
ITS#6023 minor formatting tweaks 2009-06-03 08:43:44 +08:00			`slapd\-dnssrv \- DNS SRV referral backend to slapd`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`.SH SYNOPSIS`
			`ETCDIR/slapd.conf`
			`.SH DESCRIPTION`
			`The DNSSRV backend to`
			`.BR slapd (8)`
			`serves up referrals based upon SRV resource records held in`
			`the Domain Name System.`
Add a few notes about intended usage of these backends 2003-01-09 20:07:14 +08:00			`.LP`
			`This backend is experimental.`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`.SH CONFIGURATION`
			`The DNSSRV backend has no backend nor database specific options.`
Fix typos 2002-05-04 12:35:41 +08:00			`It is configured simply by "database dnssrv" followed a suffix`
			`directive, e.g. suffix "".`
further fulfilment of ITS#3639 2005-04-09 06:08:40 +08:00			`.SH ACCESS CONTROL`
			`The`
			`.B dnssrv`
			`backend does not honor all ACL semantics as described in`
			`.BR slapd.access (5).`
			`In fact, this backend only implements the`
			`.B search`
			`operation when the`
			`.B manageDSAit`
Update RFC references 2006-06-10 01:20:38 +08:00			`control (RFC 3296) is used, otherwise for every operation a referral,`
further fulfilment of ITS#3639 2005-04-09 06:08:40 +08:00			`whenever appropriate, or an error is returned.`
			`Currently, there is no means to condition the returning of the referral`
			`by means of ACLs; no access control is implemented, except for`
			`.B read (=r)`
			`access to the returned entries, which is actually provided by the frontend.`
clarify why there's no access checking in back-dnssrv 2005-04-11 00:03:59 +08:00			`Note, however, that the information returned by this backend is collected`
			`through the DNS, so it is public by definition.`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`.SH FILES`
Documentation patch #4 (ITS#1749) ================ Written by Hallvard B. Furuseth and placed into the public domain. This software is not subject to any license of the University of Oslo. ================ Small changes: - Fix typo slapd_meta -> slapd-meta in slapd-meta(5). - Add slapd-dnssrv(5) to SEE ALSO in slapd.conf(5). - Add descriptions of the files in FILES sections. - Add $HOME/.udrc to FILES in ud(1) and ud.conf(5). - Add ldaprc (without ".") and ENVIRONMENT VARIABLES in ldap.conf(5). - Change manpage references to proper ".BR name (section)". Hallvard B. Furuseth <h.b.furuseth@usit.uio.no>, May 2002. 2002-05-09 10:07:41 +08:00			`.TP`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`ETCDIR/slapd.conf`
Documentation patch #4 (ITS#1749) ================ Written by Hallvard B. Furuseth and placed into the public domain. This software is not subject to any license of the University of Oslo. ================ Small changes: - Fix typo slapd_meta -> slapd-meta in slapd-meta(5). - Add slapd-dnssrv(5) to SEE ALSO in slapd.conf(5). - Add descriptions of the files in FILES sections. - Add $HOME/.udrc to FILES in ud(1) and ud.conf(5). - Add ldaprc (without ".") and ENVIRONMENT VARIABLES in ldap.conf(5). - Change manpage references to proper ".BR name (section)". Hallvard B. Furuseth <h.b.furuseth@usit.uio.no>, May 2002. 2002-05-09 10:07:41 +08:00			`default slapd configuration file`
Basic dnssrv man page 2002-05-04 12:34:58 +08:00			`.br`
			`.SH SEE ALSO`
			`\fB"OpenLDAP Root Service - An experimental LDAP referral`
			`service"\fR [RFC 3088],`
			`.br`
			`\fB"OpenLDAP LDAP Root Service"\fR <http://www.openldap.org/faq/?file=393)>,`
			`.br`
			`.BR slapd.conf (5),`
			`.BR slapd (8)`