ITS#5718

diff --git a/CHANGES b/CHANGES
index 72bd44e1e0ab5d879e4d3cc90eb7b7e5132dfe05..855c54a2ad265bf487d22052a8e87ab210fff614 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -53,11 +53,12 @@ OpenLDAP 2.4.12 Engineering
                Added BDB 4.7 support (ITS#5523)
                Added slapo-collect overlay with enhancements(ITS#5659)
        Documentation
-               Added slapo-collect(5) man page (ITS#5706)
                Added slapd-ldap(5), slapd-meta(5) noundeffilter (ITS#5614)
                Fixed slapd-ldap(5), slapd-meta(5), slapo-pcache(5) schema requirements (ITS#5680)
+               Added slapo-collect(5) man page (ITS#5706)
                Added slapo-pcache(5) proxycheckcacheability option (ITS#5680)
                Added slapo-retcode(5) retcode.conf location (ITS#5633)
+               admin24 dontusecopy control update (ITS#5718)
                admin24 guide updates (ITS#5616)
                admin24 octetString fix (ITS#5670)
 

diff --git a/doc/guide/admin/overlays.sdf b/doc/guide/admin/overlays.sdf
index 48dd94d02ac30cb3ed5dbff884f0e05e07aa82ec..8987caa462cc367352b14b353b7c219c267e4899 100644 (file)
--- a/doc/guide/admin/overlays.sdf
+++ b/doc/guide/admin/overlays.sdf
@@ -322,6 +322,20 @@ side, the actual error is returned to the client.
 >        chain-return-error TRUE
 
 
+H3: Read-Back of Chained Modifications
+
+Occasionally, applications want to read back the data that they just wrote.
+If a modification requested to a shadow server was silently chained to its 
+producer, an immediate read could result in receiving data not yet sync'ed.  
+In those cases, clients should use the {{B:dontusecopy}} control to ensure 
+they are directed to the authoritative source for that piece of data.
+
+This control usually causes a referral to the actual source of the data
+to be returned.  However, when the {{slapo-chain(5)}} overlay is used,
+it intercepts the referral being returned in response to the
+{{B:dontusecopy}} control, and tries to fetch the requested data.
+
+
 H3: Further Information
 
 {{:slapo-chain(5)}}