Add debugging info to the HttpProtocolOption directive doc

In bugzilla and users@ we keep receiving questions about
how to test the new restrictions imposed by HttpProtocolOptions.
Added some info about how to use openssl s_client properly
and the mod_dumpio's directives to debug (thanks to
Daniel Ferradal for this suggestion).

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1782140 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index c5b645b01eb4c22afa9c49c38b9d6469b7bf1aa4..b754934df3cd631b64ae8e88a42523d6d1ac854e 100644 (file)
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1323,6 +1323,15 @@ EnableSendfile On
         # Missing CRLF<br />
         GET / HTTP/1.0\n\n
       </example>
+      <note type="warning"><title>Command line tools and CRLF</title>
+        <p>Some tools need to be forced to use CRLF, otherwise httpd will return
+        a HTTP 400 response like described in the above use case. For example,
+        the <strong>OpenSSL s_client needs the -crlf parameter to work
+        properly</strong>.</p>
+        <p>The <directive module="mod_dumpio">DumpIOInput</directive> directive
+        can help while reviewing the HTTP request to identify issues like the
+        absence of CRLF.</p>
+      </note>
     </dd>
     <dt>RegisteredMethods|LenientMethods</dt>
     <dd>