summaryrefslogtreecommitdiff
path: root/usr.sbin/httpd/htdocs/manual/keepalive.html
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/httpd/htdocs/manual/keepalive.html')
-rw-r--r--usr.sbin/httpd/htdocs/manual/keepalive.html107
1 files changed, 107 insertions, 0 deletions
diff --git a/usr.sbin/httpd/htdocs/manual/keepalive.html b/usr.sbin/httpd/htdocs/manual/keepalive.html
new file mode 100644
index 00000000000..c3a3018dcdb
--- /dev/null
+++ b/usr.sbin/httpd/htdocs/manual/keepalive.html
@@ -0,0 +1,107 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta name="generator" content="HTML Tidy, see www.w3.org" />
+
+ <title>Apache Keep-Alive Support</title>
+ </head>
+ <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
+
+ <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
+ vlink="#000080" alink="#FF0000">
+ <div align="CENTER">
+ <img src="images/sub.gif" alt="[APACHE DOCUMENTATION]" />
+
+ <h3>Apache HTTP Server</h3>
+ </div>
+
+
+
+ <h1 align="CENTER">Apache Keep-Alive Support</h1>
+ <hr />
+
+ <h2>What is Keep-Alive?</h2>
+ The Keep-Alive extension to HTTP, as defined by the
+ <code>HTTP/1.1</code> draft, allows persistent connections.
+ These long-lived HTTP sessions allow multiple requests to be
+ send over the same TCP connection, and in some cases have been
+ shown to result in an almost 50% speedup in latency times for
+ HTML documents with lots of images.
+
+ <h2>Enabling Keep-Alive Support</h2>
+ Apache 1.1 comes with Keep-Alive support on by default, however
+ there are some directives you can use to modify Apache's
+ behavior:
+
+ <p><strong>Note</strong>: Apache 1.2 uses a different syntax
+ for the <a href="mod/core.html#keepalive">KeepAlive</a>
+ directive.</p>
+
+ <h3>KeepAlive</h3>
+ <a href="mod/directive-dict.html#Syntax"
+ rel="Help"><strong>Syntax:</strong></a> KeepAlive
+ <em>max-requests</em><br />
+ <a href="mod/directive-dict.html#Default"
+ rel="Help"><strong>Default:</strong></a> <code>KeepAlive
+ 5</code><br />
+ <a href="mod/directive-dict.html#Context"
+ rel="Help"><strong>Context:</strong></a> server config<br />
+ <a href="mod/directive-dict.html#Status"
+ rel="Help"><strong>Status:</strong></a> Core
+
+ <p>This directive enables Keep-Alive support. Set
+ <em>max-requests</em> to the maximum number of requests you
+ want Apache to entertain per connection. A limit is imposed to
+ prevent a client from hogging your server resources. Set this
+ to <code>0</code> to disable support.</p>
+
+ <h3>KeepAliveTimeout</h3>
+ <a href="mod/directive-dict.html#Syntax"
+ rel="Help"><strong>Syntax:</strong></a> KeepAliveTimeout
+ <em>seconds</em><br />
+ <a href="mod/directive-dict.html#Default"
+ rel="Help"><strong>Default:</strong></a> <code>KeepAliveTimeout
+ 15</code><br />
+ <a href="mod/directive-dict.html#Context"
+ rel="Help"><strong>Context:</strong></a> server config<br />
+ <a href="mod/directive-dict.html#Status"
+ rel="Help"><strong>Status:</strong></a> Core
+
+ <p>The number of seconds Apache will wait for a subsequent
+ request before closing the connection. Once a request has been
+ received, the timeout value specified by the <a
+ href="mod/core.html#timeout"><code>Timeout</code></a> directive
+ applies.</p>
+
+ <h2>When Keep-Alive Is Used</h2>
+ In order for Keep-Alive support to be used, first the browser
+ must support it. Many current browsers, including Netscape
+ Navigator 2.0, and Spyglass Mosaic-based browsers (including
+ Microsoft Internet Explorer) do. Note, however, that some
+ Windows 95-based browsers misbehave with Keep-Alive-supporting
+ servers; they may occasionally hang on a connect. This has been
+ observed with several Windows browsers, and occurs when
+ connecting to any Keep-Alive server, not just Apache. Netscape
+ 3.0b5 and later versions are known to work around this problem.
+
+
+ <p>However, Keep-Alive support only is active with files where
+ the length is known beforehand. This means that most CGI
+ scripts, server-side included files and directory listings will
+ not use the Keep-Alive protocol. While this should be
+ completely transparent to the end user, it is something the
+ web-master may want to keep in mind.</p>
+ <hr />
+
+ <h3 align="CENTER">Apache HTTP Server</h3>
+ <a href="./"><img src="images/index.gif" alt="Index" /></a>
+
+ </body>
+</html>
+
+
+