Bug 64342 - KeepAliveTimeout milliseconds on website, but seconds in conf file
Summary: KeepAliveTimeout milliseconds on website, but seconds in conf file
Status: NEW
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.4.38
Hardware: PC Linux
: P2 minor (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-04-12 13:58 UTC by Frank ter Voorde
Modified: 2020-04-12 14:24 UTC (History)
0 users


Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Frank ter Voorde 2020-04-12 13:58:07 UTC 
Hi there,

Regarding the syntax of the directive KeepAliveTimeout, the documentation on https://httpd.apache.org/docs/2.4/mod/core.html states: "KeepAliveTimeout num[ms]" and "Default: KeepAliveTimeout 5". This is about milliseconds, not seconds.

However, in the apache2.conf file, I read:

"# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection." and "# KeepAliveTimeout 5". This about seconds, not milliseconds.

Of course I know what's the real unit, but I think this is confusing for new users.

Yours sincerely,

Frank ter Voorde
Comment 1 Eric Covener 2020-04-12 14:24:46 UTC 
I clarified it in http://svn.apache.org/viewvc?view=revision&revision=1876428 wdyt?

The [ms] meant optional and was described by the body of the directive:

"By adding a postfix of ms the timeout can be also set in milliseconds."

After the update the 'ms' is quoted in the body and the syntax section is maybe a little more clear