Bug 64342

Summary: KeepAliveTimeout milliseconds on website, but seconds in conf file
Product: Apache httpd-2 Reporter: Frank ter Voorde <f.ter.voorde>
Component: DocumentationAssignee: HTTP Server Documentation List <docs>
Status: NEW ---    
Severity: minor    
Priority: P2    
Version: 2.4.38   
Target Milestone: ---   
Hardware: PC   
OS: Linux   

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