From: Kurt Zeilenga <kurt@openldap.org>
Date: Tue, 8 Aug 2000 04:42:05 +0000 (+0000)
Subject: Add ManageDSAit discussion
X-Git-Tag: LDBM_PRE_GIANT_RWLOCK~2295
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=2144be97ade1a5e2decca6093858f6146264acee;p=openldap

Add ManageDSAit discussion
---

diff --git a/doc/guide/admin/referrals.sdf b/doc/guide/admin/referrals.sdf
index e7b4415868..13b3126c43 100644
--- a/doc/guide/admin/referrals.sdf
+++ b/doc/guide/admin/referrals.sdf
@@ -46,17 +46,6 @@ E:	objectClass: extensibleObject
 E:	dc: subtree
 E:	ref: ldap://b.example.net/dc=subtree,dc=example,dc=net/
 
-Adding, modify, and deleting referral objects is generally done
-using {{ldapmodify}}(1) or similiar tools which support the
-ManageDsaIT control.  The ManageDsaIT control informs the server
-that you intend to manage the referral object as a regular
-entry.  This keeps the server from sending a referral result
-for requests to updating referral objects.  The -M option of
-{{ldapmodify}}(1) (and other tools) enables ManageDsaIT.  For
-example:
-
-E:  ldapmodify -M -f referral.ldif -x -D "cn=Manager,dc=example,dc=net" -W
-
 The server uses this information to generate referrals and
 search continuations to subordinate servers.
 
@@ -64,7 +53,6 @@ For those familiar with X.500, a {{named referral}} object is
 similar to an X.500 knowledge reference held in a {{subr}}
 {{TERM:DSE}}.
 
-
 !if 0
 H2: Immediate Superior Knowledge Information
 
@@ -115,3 +103,24 @@ to any of the naming contexts held by the server.
 For those familiar with X.500, this use of the {{ref}} attribute
 is similar to an X.500 knowledge reference held in a
 {{Supr}} {{TERM:DSE}}.
+
+H2: ManageDSAit
+
+Adding, modify, and deleting referral objects is generally done
+using {{ldapmodify}}(1) or similiar tools which support the
+ManageDsaIT control.  The ManageDsaIT control informs the server
+that you intend to manage the referral object as a regular
+entry.  This keeps the server from sending a referral result
+for requests to introgating or updating referral objects.
+The -M option of {{ldapmodify}}(1) (and other tools) enables
+ManageDsaIT.  For example:
+
+E:  ldapmodify -M -f referral.ldif -x -D "cn=Manager,dc=example,dc=net" -W
+
+or with ldapsearch:
+
+E:  ldapsearch -M -b "dc=example,dc=net" -x "(objectclass=referral)" '*' ref
+
+Note: the {{EX:ref}} attribute is operational and must be explicitly
+requested when desired in search results.
+