From: Luca Toscano <elukey@apache.org>
Date: Wed, 8 Feb 2017 14:19:45 +0000 (+0000)
Subject: Merge r1782140 from trunk:
X-Git-Tag: 2.4.26~317
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c1baa954559745a9b44ffbdbd3a50d4640197ba1;p=apache

Merge r1782140 from trunk:

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/branches/2.4.x@1782180 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 0fe29ea7b9..ec6c5d3a26 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -1300,6 +1300,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>