Repository navigation
Wrong definition of keepAliveMsecs in http.Agent documentation #7335
Description
Documentation for keepAliveMsecs says:
When using HTTP KeepAlive,
how often to send TCP KeepAlive packets over sockets being kept alive.
But internally http.Agent just uses keepAliveMsecs in socket.setKeepAlive(true, self.keepAliveMsecs); (https://github.com/nodejs/node/blob/master/lib/_http_agent.js#L73)
From docs for socket.setKeepAlive([enable][, initialDelay]):
Set initialDelay (in milliseconds) to set the delay between
the last data packet received and the first keepalive probe.
So really keepAliveMsecs doesn't mean how often keep alive probe will be sent, it means delay between the last data received and the first keep alive probe.
Activity
jasnell commentedon Jun 28, 2016
@nodejs/http @nodejs/documentation
dougwilson commentedon Jul 2, 2016
This is correct, in that the HTTP client documentation is not correct, as the time is only the initial delay of the keep alive probe, not the interval between the probes. nodejs/node-v0.x-archive#4109 has a good discussion about this, though all Node.js documentation (and even the libuv documentation) are very terse on this subject and not very clear :)
calibr commentedon Feb 25, 2017
doc fixed by 3b9e8ad
doc: fix `keepAliveMsecs` params description
doc: fix `keepAliveMsecs` params description (#55)