Bug 51665 - Inconsistent documentation of LimitRequestLine and friends.
Summary: Inconsistent documentation of LimitRequestLine and friends.
Status: RESOLVED FIXED
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.2.17
Hardware: PC Linux
: P2 minor (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-08-16 14:27 UTC by Riccardo Murri
Modified: 2011-11-11 16:54 UTC (History)
0 users



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Riccardo Murri 2011-08-16 14:27:39 UTC
According to the on-line docs
(http://httpd.apache.org/docs/2.2/mod/core.html#limitrequestline),
LimitRequestLine can be used to lower or *raise* the maximum line
limit:

    The LimitRequestLine directive allows the server administrator to
    reduce or increase the limit on the allowed size of a client's
    HTTP request-line.

However, the doxygen documentation says that it can only be used to
*lower* the default line buffer size; indeed, in file
`include/httpd.h` in the Apache 2.2.17 sources, at lines 185--189 it
says:

    Internal buffer sizes are two bytes more than the DEFAULT_LIMIT_REQUEST_LINE
    and DEFAULT_LIMIT_REQUEST_FIELDSIZE below, which explains the 8190.
    These two limits can be lowered (but not raised) by the server config
    directives LimitRequestLine and LimitRequestFieldsize, respectively.

Which one is correct?
Comment 1 Rich Bowen 2011-11-11 16:48:56 UTC
I think this is a semantic difference only. There's an upper limit beyond which you can't raise it. However, if you lower it, you can then raise it again, right? Perhaps it would be best to just say "set" instead of "reduce or increase."
Comment 2 Rich Bowen 2011-11-11 16:54:39 UTC
Clarified in r1200947.