Add keep-alive documentation (including keep_alive_post_out)

Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/e90caa17
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/e90caa17
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/e90caa17

Branch: refs/heads/5.0.x
Commit: e90caa173571d5ba2ded7b4be1b79e374672d1c6
Parents: 61f4ded
Author: Thomas Jackson <[email protected]>
Authored: Mon Nov 11 19:10:43 2013 -0800
Committer: Thomas Jackson <[email protected]>
Committed: Mon Nov 11 19:10:43 2013 -0800

----------------------------------------------------------------------
 .../configuration/records.config.en.rst         | 24 ++++++++++++++++++++
 1 file changed, 24 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/e90caa17/doc/reference/configuration/records.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/records.config.en.rst 
b/doc/reference/configuration/records.config.en.rst
index cf2d39a..18f913a 100644
--- a/doc/reference/configuration/records.config.en.rst
+++ b/doc/reference/configuration/records.config.en.rst
@@ -651,6 +651,25 @@ suffice. It is possible to do this crudely with this flag 
by
 enabling it and then use identity URL mappings to re-disable it for
 specific domains.
 
+.. ts:cv:: CONFIG proxy.config.http.keep_alive_enabled_in  INT 0
+
+   Enables (``1``) or disables (``0``) incoming keep-alive connections.
+
+.. ts:cv:: CONFIG proxy.config.http.keep_alive_enabled_out  INT 0
+
+   Enables (``1``) or disables (``0``) outgoing keep-alive connections.
+
+  .. note::
+        Enabling keep-alive does not automatically enable purging of keep-alive
+        requests when nearing the connection limit, that is controlled by
+        ```proxy.config.http.server_max_connections``.
+
+.. ts:cv:: CONFIG proxy.config.http.keep_alive_post_out  INT 0
+
+   Controls wether new POST requests re-use keep-alive sessions (``1``) or
+   create new connections per request (``0``).
+
+
 Parent Proxy Configuration
 ==========================
 
@@ -768,6 +787,11 @@ Origin Server Connect Attempts
 
    Limits the number of socket connections across all origin servers to the 
value specified. To disable, set to zero (``0``).
 
+   .. note::
+        This value is used in determining when and if to prune active origin 
sessions. Without this value set connections
+        to origins can consume all the way up to 
``proxy.config.net.connections_throttle`` connections, which in turn can
+        starve incoming requests from available connections.
+
 .. ts:cv:: CONFIG proxy.config.http.origin_max_connections INT 0
    :reloadable:
 

Reply via email to