ITS#8255 Clarify "sockresps result" behaviour

diff --git a/doc/man/man5/slapd-sock.5 b/doc/man/man5/slapd-sock.5
index 15837abd5ad7a0b3a3f1733c5d1f67d37e941bbc..eb7034a1b8c04d8b6934f7a8fb7152e724f0aa5c 100644 (file)
--- a/doc/man/man5/slapd-sock.5
+++ b/doc/man/man5/slapd-sock.5
@@ -193,11 +193,19 @@ CONTINUE response if request processing should continue normally, or
 a regular RESULT response if the external program wishes to bypass the
 underlying database.
 
-If the overlay is configured to send response messages to the external
-program, they will appear as an extended RESULT message or as an
-ENTRY message, defined below. The RESULT message is similar to
-the one above, but also includes the msgid and any configured
-extensions:
+If
+.B sockresps
+includes
+.BR result
+or
+.BR search ,
+the overlay will also send any response messages to the external program (also
+see KNOWN LIMITATIONS). These will appear as an extended RESULT message or an
+ENTRY message respectively, both are defined below and the program is not
+expected to respond to these.
+
+The extended RESULT message is similar to the one above, but also includes the
+msgid and any configured extensions:
 .RS
 .nf
 RESULT
@@ -225,6 +233,17 @@ The
 .B sock
 backend does not process extended operation results from an external program.
 
+If
+.B sockresps
+is configured,
+.B sock
+overlay does not consider
+.B sockops
+nor
+.B sockdnpat
+to decide which responses are passed onto the external program, instead, all
+responses are currently passed on.
+
 .SH ACCESS CONTROL
 The
 .B sock