You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bu...@apache.org on 2011/06/08 02:38:22 UTC
svn commit: r790579 [2/2] -
/websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/records.config.en.html Wed Jun 8 00:38:22 2011
@@ -115,13 +115,11 @@ the <code>records.config</code> file.</p
<dt id="proxy.config.manager_binary"><em><code>proxy.config.manager_binary</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>traffic_manager</code></dd>
-<dd>The name of the executable that runs the <code>traffic_manager</code>
-process.</dd>
+<dd>The name of the executable that runs the <code>traffic_manager</code> process.</dd>
<dt id="proxy.config.cli_binary"><em><code>proxy.config.cli_binary</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>traffic_line</code></dd>
-<dd>The name of the executable that runs the command-line interface
-(Traffic Line).</dd>
+<dd>The name of the executable that runs the command-line interface (Traffic Line).</dd>
<dt id="proxy.config.watch_script"><em><code>proxy.config.watch_script</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>traffic_cop</code></dd>
@@ -129,8 +127,7 @@ process.</dd>
<dt id="proxy.config.env_prep"><em><code>proxy.config.env_prep</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: (none)</dd>
-<dd>The script executed before the <code>traffic_manager</code> process spawns the
-<code>traffic_server</code> process.</dd>
+<dd>The script executed before the <code>traffic_manager</code> process spawns the <code>traffic_server</code> process.</dd>
<dt id="proxy.config.config_dir"><em><code>proxy.config.config_dir</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>config</code></dd>
@@ -142,100 +139,35 @@ process.</dd>
<dt id="proxy.config.alarm_email"><em><code>proxy.config.alarm_email</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: (none)</dd>
-<dd>
-<p>The email address to which Traffic Server sends alarm messages.</p>
-<p>During a custom Traffic Server installation, you can specify the
-email address; otherwise, Traffic Server uses the Traffic Server
-user account name as the default value for this variable.</p>
-</dd>
+<dd>The email address to which Traffic Server sends alarm messages. During a custom Traffic Server installation, you can specify the email address; otherwise, Traffic Server uses the Traffic Server user account name as the default value for this variable.</dd>
<dt id="proxy.config.syslog_facility"><em><code>proxy.config.syslog_facility</code></em></dt>
-<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>LOG_DAEMON</code></p>
-</dd>
-<dd>
-<p>The facility used to record system log files.
-Refer to
-<a href="../working-log-files#UnderstandingTrafficServerLogFiles">Understanding Traffic Server Log Files</a>.</p>
-</dd>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>LOG_DAEMON</code></dd>
+<dd>The facility used to record system log files. Refer to <a href="../working-log-files#UnderstandingTrafficServerLogFiles">Understanding Traffic Server Log Files</a>.</dd>
<dt id="proxy.config.cop.core_signal"><em><code>proxy.config.cop.core_signal</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>The signal sent to <code>traffic_cop</code>'s managed processes to stop them.</p>
-<ul>
-<li>0 = no signal is sent.</li>
-</ul>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>The signal sent to <code>traffic_cop</code>'s managed processes to stop them. * 0 = no signal is sent.</dd>
<dt id="proxy.config.cop.linux_min_swapfree_kb"><em><code>proxy.config.cop.linux_min_swapfree_kb</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>10240</code></p>
-</dd>
-<dd>
-<p>The minimum amount of free swap space allowed before Traffic Server
-stops the <code>traffic_server</code>and <code>traffic_manager</code> processes to
-prevent the system from hanging.</p>
-<p>This configuration variable applies if swap is enabled in Linux 2.2
-only.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>10240</code></dd>
+<dd>The minimum amount of free swap space allowed before Traffic Server stops the <code>traffic_server</code>and <code>traffic_manager</code> processes to prevent the system from hanging. This configuration variable applies if swap is enabled in Linux 2.2 only.</dd>
<dt id="proxy.config.output.logfile"><em><code>proxy.config.output.logfile</code></em></dt>
-<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>traffic.out</code></p>
-</dd>
-<dd>
-<p>The name and location of the file that contains warnings, status
-messages, and error messages produced by the Traffic Server
-processes.</p>
-<p>If no path is specified, then Traffic Server creates the file in
-its logging directory.</p>
-</dd>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>traffic.out</code></dd>
+<dd>The name and location of the file that contains warnings, status messages, and error messages produced by the Traffic Server processes. If no path is specified, then Traffic Server creates the file in its logging directory.</dd>
<dt id="proxy.config.snapshot_dir"><em><code>proxy.config.snapshot_dir</code></em></dt>
-<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>snapshots</code></p>
-</dd>
-<dd>
-<p>The directory in which Traffic Server stores configuration
-snapshots on the local system. Unless you specify an absolute path,
-this directory is located in the Traffic Server <code>config</code>
-directory.</p>
-</dd>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>snapshots</code></dd>
+<dd>The directory in which Traffic Server stores configuration snapshots on the local system. Unless you specify an absolute path, this directory is located in the Traffic Server <code>config</code> directory.</dd>
<dt id="proxy.config.accept_threads"><em><code>proxy.config.accept_threads</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>When enabled (<code>1</code>), runs a separate thread for accept processing.
-If disabled (<code>0</code>), then only 1 thread can be created.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>When enabled (<code>1</code>), runs a separate thread for accept processing. If disabled (<code>0</code>), then only 1 thread can be created.</dd>
<dt id="proxy.config.thread.default.stacksize"><em><code>proxy.config.thread.default.stacksize</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>1096908</code></p>
-</dd>
-<dd>
-<p>The new default thread stack size, for all threads. The original
-default is set at 1 MB.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>1096908</code></dd>
+<dd>The new default thread stack size, for all threads. The original default is set at 1 MB.</dd>
</dl>
<h3 id="LocalManager">Local Manager</h3>
<dl>
@@ -262,9 +194,7 @@ default is set at 1 MB.</p>
<p>Default: <code>8088</code></p>
</dd>
<dd>
-<p>The reliable service port. The reliable service port is used to
-send configuration information between the nodes in a cluster. All
-nodes in a cluster must use the same reliable service port.</p>
+<p>The reliable service port. The reliable service port is used to send configuration information between the nodes in a cluster. All nodes in a cluster must use the same reliable service port.</p>
</dd>
<dt id="proxy.config.admin.autoconf_port"><em><code>proxy.config.admin.autoconf_port</code></em></dt>
<dd>
@@ -284,8 +214,7 @@ nodes in a cluster must use the same rel
<p>Default: <code>3</code></p>
</dd>
<dd>
-<p>The maximum number of copies of rolled configuration files to
-keep.</p>
+<p>The maximum number of copies of rolled configuration files to keep.</p>
</dd>
<dt id="proxy.config.admin.user_id"><em><code>proxy.config.admin.user_id</code></em></dt>
<dd>
@@ -295,19 +224,10 @@ keep.</p>
<p>Default: <code>nobody</code></p>
</dd>
<dd>
-<p>Option used to specify who to run the <code>traffic_server</code>process as;
-also used to specify ownership of config and log files.</p>
+<p>Option used to specify who to run the <code>traffic_server</code>process as; also used to specify ownership of config and log files.</p>
<p>The nonprivileged user account designated to Traffic Server.</p>
-<p>As of version 2.1.1 if the user_id is prefixed with pound
-character (#) the remaining of the string is considered to be
-<a href="http://en.wikipedia.org/wiki/User_identifier">numeric user identifier</a>.
-If the value is set to '#-1' Traffic Server will not change the
-user during startup.</p>
-<p>Setting <code>user_id</code> to <code>root</code> or <code>#0</code> is now forbidden to increase
-security. Trying to do so, will cause the <code>traffic_server</code> fatal
-failure. However there are two ways to bypass that restriction:
-Specify <code>-DBIG_SECURITY_HOLE</code> in <code>CXXFLAGS</code> during compilation
-Set the <code>user_id=#-1</code> and start trafficserver as root.</p>
+<p>As of version 2.1.1 if the user_id is prefixed with pound character (#) the remaining of the string is considered to be <a href="http://en.wikipedia.org/wiki/User_identifier">numeric user identifier</a>. If the value is set to '#-1' Traffic Server will not change the user during startup.</p>
+<p>Setting <code>user_id</code> to <code>root</code> or <code>#0</code> is now forbidden to increase security. Trying to do so, will cause the <code>traffic_server</code> fatal failure. However there are two ways to bypass that restriction: Specify <code>-DBIG_SECURITY_HOLE</code> in <code>CXXFLAGS</code> during compilation Set the <code>user_id=#-1</code> and start trafficserver as root.</p>
</dd>
</dl>
<h3 id="ProcessManager">Process Manager</h3>
@@ -315,31 +235,25 @@ Set the <code>user_id=#-1</code> and sta
<dt id="proxy.config.process_manager.mgmt_port"><em><code>proxy.config.process_manager.mgmt_port</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>8084</code></dd>
-<dd>The port used for internal communication between the
-<code>traffic_manager</code> and <code>traffic_server</code> processes.</dd>
+<dd>The port used for internal communication between the <code>traffic_manager</code> and <code>traffic_server</code> processes.</dd>
</dl>
<h3 id="ProcessManager_1">Alarm Configuration</h3>
<dl>
<dt id="proxy.config.alarm.bin"><em><code>proxy.config.alarm.bin</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>example_alarm_bin.sh</code></dd>
-<dd>Name of the script file that can execute certain actions when an
-alarm is signaled. The default file is a sample script named
-<code>example_alarm_bin.sh</code> located in the <code>bin</code> directory. You must
-edit the script to suit your needs.</dd>
+<dd>Name of the script file that can execute certain actions when an alarm is signaled. The default file is a sample script named <code>example_alarm_bin.sh</code> located in the <code>bin</code> directory. You must edit the script to suit your needs.</dd>
<dt id="proxy.config.alarm.abs_path"><em><code>proxy.config.alarm.abs_path</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>NULL</code></dd>
-<dd>The full path to the script file that sends email to alert someone
-about Traffic Server problems.</dd>
+<dd>The full path to the script file that sends email to alert someone about Traffic Server problems.</dd>
</dl>
<h3 id="HTTPEngine">HTTP Engine</h3>
<dl>
<dt id="proxy.config.http.server_port"><em><code>proxy.config.http.server_port</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>8080</code></dd>
-<dd>The port that Traffic Server uses when acting as a web proxy server
-for web traffic.</dd>
+<dd>The port that Traffic Server uses when acting as a web proxy server for web traffic.</dd>
<dt id="proxy.config.http.server_port_attr"><em><code>proxy.config.http.server_port_attr</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>X</code></dd>
@@ -359,15 +273,9 @@ for web traffic.</dd>
<p>Default: <code>NULL</code></p>
</dd>
<dd>
-<p>The ports other than the port specified by the variable</p>
-<p><em><code>proxy.config.http.server_port</code></em> to bind for incoming HTTP
-requests. Example:</p>
-<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="n">proxy</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">http</span><span class="o">.</span><span class="n">server_other_ports</span> <span class="n">STRING</span> <span class="mi">6060</span><span class="p">:</span><span class="n">X</span> <span class="mi">9090</span><span class="p">:</span><span class="n">X</span>
-</pre></div>
-
-
-<p>would listed to ports <code>6060</code>, <code>9090</code>, and the port specified by
-<em><code>proxy.config.http.server_port</code></em>.</p>
+<p>The ports other than the port specified by the variable <em><code>proxy.config.http.server_port</code></em> to bind for incoming HTTP requests. Example:
+ CONFIG proxy.config.http.server_other_ports STRING 6060:X 9090:X
+would listed to ports <code>6060</code>, <code>9090</code>, and the port specified by <em><code>proxy.config.http.server_port</code></em>.</p>
</dd>
<dt id="proxy.config.http.ssl_ports"><em><code>proxy.config.http.ssl_ports</code></em></dt>
<dd>
@@ -377,11 +285,7 @@ requests. Example:</p>
<p>Default: <code>443 563</code></p>
</dd>
<dd>
-<p>The range of ports used for tunneling. Traffic Server allows
-tunnels only to the specified ports.</p>
-<p>For example: to retrieve an object using HTTPS via Traffic Server,
-a tunnel must be established to an origin server via Traffic
-Server.</p>
+<p>The range of ports used for tunneling. Traffic Server allows tunnels only to the specified ports. For example: to retrieve an object using HTTPS via Traffic Server, a tunnel must be established to an origin server via Traffic Server.</p>
</dd>
<dt id="proxy.config.http.insert_request_via_str"><em><code>proxy.config.http.insert_request_via_str</code></em></dt>
<dd>
@@ -397,8 +301,7 @@ Server.</p>
<li><code>1</code> = all extra information is added.</li>
<li><code>2</code> = some extra information is added.</li>
</ul>
-<p>Note: the Via: header string interpretation is
-<a href="../faqs#interpret_via_header">documented here.</a></p>
+<p>Note: the Via: header string interpretation is <a href="../faqs#interpret_via_header">documented here.</a></p>
</dd>
<dt id="proxy.config.http.insert_response_via_str"><em><code>proxy.config.http.insert_response_via_str</code></em></dt>
<dd>
@@ -427,8 +330,7 @@ Server.</p>
<ul>
<li><code>0</code> no Server: header is added to the response.</li>
<li><code>1</code> the Server: header is added (see string below).</li>
-<li><code>2</code> the Server: header is added only if the response from Origin
- does not have one already.</li>
+<li><code>2</code> the Server: header is added only if the response from Origin does not have one already.</li>
</ul>
</dd>
<dt id="proxy.config.http.response_server_str"><em><code>proxy.config.http.response_server_str</code></em></dt>
@@ -439,9 +341,7 @@ Server.</p>
<p>Default: <code>ATS/</code></p>
</dd>
<dd>
-<p>The Server: string that ATS will insert in a response header
-(if requested, see above). Note that the current version number
-is always appended to this string.</p>
+<p>The Server: string that ATS will insert in a response header (if requested, see above). Note that the current version number is always appended to this string.</p>
</dd>
<dt id="proxy.config.http.enable_url_expandomatic"><em><code>proxy.config.http.enable_url_expandomatic</code></em></dt>
<dd>
@@ -451,12 +351,7 @@ is always appended to this string.</p>
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) <code>.com</code> domain expansion. This
-configures the Traffic Server to resolve unqualified hostnames by
-prepending with <code>www.</code> and appending with <code>.com</code> before redirecting
-to the expanded address.</p>
-<p>For example: if a client makes a request to <code>host</code>, then Traffic
-Server redirects the request to <code>www.host.com</code>.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) <code>.com</code> domain expansion. This configures the Traffic Server to resolve unqualified hostnames by prepending with <code>www.</code> and appending with <code>.com</code> before redirecting to the expanded address. For example: if a client makes a request to <code>host</code>, then Traffic Server redirects the request to <code>www.host.com</code>.</p>
</dd>
<dt id="proxy.config.http.chunking_enabled"><em><code>proxy.config.http.chunking_enabled</code></em></dt>
<dd>
@@ -471,15 +366,9 @@ Server redirects the request to <code>ww
<li><code>0</code> Never</li>
<li><code>1</code> Always</li>
<li><code>2</code> Generate a chunked response if the server has returned HTTP/1.1 before </li>
-<li><code>3</code> = Generate a chunked response if the client request is HTTP/1.1 and
-the origin server has returned HTTP/1.1 before</li>
+<li><code>3</code> = Generate a chunked response if the client request is HTTP/1.1 and the origin server has returned HTTP/1.1 before</li>
</ul>
-<p><strong>Note:</strong> If HTTP/1.1 is used, then Traffic Server can use
-keep-alive connections with pipelining to origin servers. If HTTP/0.9
-is used, then Traffic Server does not use <code>keep-alive</code>
-connections to origin servers. If HTTP/1.0 is used, then Traffic
-Server can use <code>keep-alive</code> connections without pipelining to origin
-servers.</p>
+<p><strong>Note:</strong> If HTTP/1.1 is used, then Traffic Server can use keep-alive connections with pipelining to origin servers. If HTTP/0.9 is used, then Traffic Server does not use <code>keep-alive</code> connections to origin servers. If HTTP/1.0 is used, then Traffic Server can use <code>keep-alive</code> connections without pipelining to origin servers.</p>
</dd>
<dt id="proxy.config.http.share_server_sessions"><em><code>proxy.config.http.share_server_sessions</code></em></dt>
<dd>
@@ -514,43 +403,25 @@ servers.</p>
<li><code>0</code> Never.</li>
<li><code>1</code> Avoid DNS lookup if possible.</li>
</ul>
-<p>This option causes Traffic Server to avoid where possible doing DNS lookups
-in forward transparent proxy mode. The option is only effective if the following
-three conditions are true -</p>
+<p>This option causes Traffic Server to avoid where possible doing DNS lookups in forward transparent proxy mode. The option is only effective if the following three conditions are true -</p>
<ul>
<li>Traffic Server is in forward proxy mode.</li>
<li>Traffic Server is using client side transparency.</li>
<li>The target URL has not been modified by either remapping or a plugin.</li>
</ul>
<p>If any of these conditions are not true, then normal DNS processing is done for the connection.</p>
-<p>If all of these conditions are met, then the origin server IP address is retrieved from the
-original client connection, rather than through HostDB or DNS lookup. In effect, client DNS
-resolution is used instead of Traffic Server DNS.</p>
-<p>This can be used to be a little more efficient (looking up the target once by the client rather
-than by both the client and Traffic Server) but the primary use is when client DNS resolution
-can differ from that of Traffic Server.
-Two known uses cases are:</p>
+<p>If all of these conditions are met, then the origin server IP address is retrieved from the original client connection, rather than through HostDB or DNS lookup. In effect, client DNS resolution is used instead of Traffic Server DNS.</p>
+<p>This can be used to be a little more efficient (looking up the target once by the client rather than by both the client and Traffic Server) but the primary use is when client DNS resolution can differ from that of Traffic Server. Two known uses cases are:</p>
<ol>
<li>
-<p>Embedded IP addresses in a protocol with DNS load sharing. In this case, even though Traffic Server
- and the client both make the same request to the same DNS resolver chain, they may get different origin
- server addresses. If the address is embedded in the protocol then the overall exchange will fail.
- One current example is Microsoft Windows update, which presumably embeds the address as a security measure.</p>
+<p>Embedded IP addresses in a protocol with DNS load sharing. In this case, even though Traffic Server and the client both make the same request to the same DNS resolver chain, they may get different origin server addresses. If the address is embedded in the protocol then the overall exchange will fail. One current example is Microsoft Windows update, which presumably embeds the address as a security measure.</p>
</li>
<li>
-<p>The client has access to local DNS zone information which is not available to Traffic Server. There are
-corporate nets with local DNS information for internal servers which, by design, is not propagated outside
-the core corporate network. Depending a network topology it can be the case that Traffic Server can access
-the servers by IP address but cannot resolve such addresses by name.
-In such as case the client supplied target address must be used.</p>
+<p>The client has access to local DNS zone information which is not available to Traffic Server. There are corporate nets with local DNS information for internal servers which, by design, is not propagated outside the core corporate network. Depending a network topology it can be the case that Traffic Server can access the servers by IP address but cannot resolve such addresses by name. In such as case the client supplied target address must be used.</p>
</li>
</ol>
<p>Additional Notes:</p>
-<p>This solution must be considered interim. In the longer term, it should be possible to arrange for much finer
-grained control of DNS lookup so that wildcard domain can be set to use Traffic Server or client resolution.
-In both known use cases, marking specific domains as client determined (rather than a single global switch)
-would 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.</p>
+<p>This solution must be considered interim. In the longer term, it should be possible to arrange for much finer grained control of DNS lookup so that wildcard domain can be set to use Traffic Server or client resolution. In both known use cases, marking specific domains as client determined (rather than a single global switch) would 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.</p>
</dd>
</dl>
<h3 id="ParentProxyConfiguration">Parent Proxy Configuration</h3>
@@ -558,279 +429,126 @@ mappings to re-disable it for specific d
<dt id="proxy.config.http.parent_proxy_routing_enable"><em><code>proxy.config.http.parent_proxy_routing_enable</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the parent caching option.</p>
-<p>Refer to <a href="../hierachical-caching">Hierarchical Caching</a>.</p>
-</dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) the parent caching option. Refer to <a href="../hierachical-caching">Hierarchical Caching</a>.</dd>
<dt id="proxy.config.http.parent_proxy.retry_time"><em><code>proxy.config.http.parent_proxy.retry_time</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>300</code></p>
-</dd>
-<dd>
-<p>The amount of time allowed between connection retries to a parent
-cache that is unavailable.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>300</code></dd>
+<dd>The amount of time allowed between connection retries to a parent cache that is unavailable.</dd>
<dt id="proxy.config.http.parent_proxy.fail_threshold"><em><code>proxy.config.http.parent_proxy.fail_threshold</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>10</code></p>
-</dd>
-<dd>
-<p>The number of times the connection to the parent cache can fail
-before Traffic Server considers the parent unavailable.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>10</code></dd>
+<dd>The number of times the connection to the parent cache can fail before Traffic Server considers the parent unavailable.</dd>
<dt id="proxy.config.http.parent_proxy.total_connect_attempts"><em><code>proxy.config.http.parent_proxy.total_connect_attempts</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>4</code></p>
-</dd>
-<dd>
-<p>The total number of connection attempts allowed to a parent cache
-before Traffic Server bypasses the parent or fails the request
-(depending on the <em><code>go_direct</code></em> option in the <code>bypass.config</code>
-file).</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>4</code></dd>
+<dd>The total number of connection attempts allowed to a parent cache before Traffic Server bypasses the parent or fails the request (depending on the <em><code>go_direct</code></em> option in the <code>bypass.config</code> file).</dd>
<dt id="proxy.config.http.parent_proxy.per_parent_connect_attempts"><em><code>proxy.config.http.parent_proxy.per_parent_connect_attempts</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>2</code></p>
-</dd>
-<dd>
-<p>The total number of connection attempts allowed per parent, if
-multiple parents are used.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>2</code></dd>
+<dd>The total number of connection attempts allowed per parent, if multiple parents are used.</dd>
<dt id="proxy.config.http.parent_proxy.connect_attempts_timeout"><em><code>proxy.config.http.parent_proxy.connect_attempts_timeout</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>30</code></p>
-</dd>
-<dd>
-<p>The timeout value (in seconds) for parent cache connection
-attempts.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>30</code></dd>
+<dd>The timeout value (in seconds) for parent cache connection attempts.</dd>
<dt id="proxy.config.http.forward.proxy_auth_to_parent"><em><code>proxy.config.http.forward.proxy_auth_to_parent</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>Configures Traffic Server to send proxy authentication headers on
-to the parent cache.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>Configures Traffic Server to send proxy authentication headers on to the parent cache.</dd>
</dl>
<h3 id="HTTPConnectionTimeouts">HTTP Connection Timeouts</h3>
<dl>
<dt id="proxy.config.http.keep_alive_no_activity_timeout_in"><em><code>proxy.config.http.keep_alive_no_activity_timeout_in</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>10</code></dd>
-<dd>Specifies how long Traffic Server keeps connections to clients open
-for a subsequent request after a transaction ends.</dd>
+<dd>Specifies how long Traffic Server keeps connections to clients open for a subsequent request after a transaction ends.</dd>
<dt id="proxy.config.http.keep_alive_no_activity_timeout_out"><em><code>proxy.config.http.keep_alive_no_activity_timeout_out</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>10</code></dd>
-<dd>Specifies how long Traffic Server keeps connections to origin
-servers open for a subsequent transfer of data after a transaction
-ends.</dd>
+<dd>Specifies how long Traffic Server keeps connections to origin servers open for a subsequent transfer of data after a transaction ends.</dd>
<dt id="proxy.config.http.transaction_no_activity_timeout_in"><em><code>proxy.config.http.transaction_no_activity_timeout_in</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>120</code></dd>
-<dd>Specifies how long Traffic Server keeps connections to clients open
-if a transaction stalls.</dd>
+<dd>Specifies how long Traffic Server keeps connections to clients open if a transaction stalls.</dd>
<dt id="proxy.config.http.transaction_no_activity_timeout_out"><em><code>proxy.config.http.transaction_no_activity_timeout_out</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>120</code></dd>
-<dd>Specifies how long Traffic Server keeps connections to origin
-servers open if the transaction stalls.</dd>
+<dd>Specifies how long Traffic Server keeps connections to origin servers open if the transaction stalls.</dd>
<dt id="proxy.config.http.transaction_active_timeout_in"><em><code>proxy.config.http.transaction_active_timeout_in</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>
-<p>The maximum amount of time Traffic Server can remain connected to a
-client. If the transfer to the client is not complete before this
-timeout expires, then Traffic Server closes the connection.</p>
+<dd>The maximum amount of time Traffic Server can remain connected to a client. If the transfer to the client is not complete before this timeout expires, then Traffic Server closes the connection.</dd>
+</dl>
<p>The default value of <code>0</code> specifies that there is no timeout.</p>
-</dd>
+<dl>
<dt id="proxy.config.http.transaction_active_timeout_out"><em><code>proxy.config.http.transaction_active_timeout_out</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>The maximum amount of time Traffic Server waits for fulfillment of
-a connection request to an origin server. If Traffic Server does
-not complete the transfer to the origin server before this timeout
-expires, then Traffic Server terminates the connection request.</p>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>The maximum amount of time Traffic Server waits for fulfillment of a connection request to an origin server. If Traffic Server does not complete the transfer to the origin server before this timeout expires, then Traffic Server terminates the connection request.</dd>
+</dl>
<p>The default value of <code>0</code> specifies that there is no timeout.</p>
-</dd>
+<dl>
<dt id="proxy.config.http.accept_no_activity_timeout"><em><code>proxy.config.http.accept_no_activity_timeout</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>120</code></p>
-</dd>
-<dd>
-<p>The timeout interval in seconds before Traffic Server closes a
-connection that has no activity.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>120</code></dd>
+<dd>The timeout interval in seconds before Traffic Server closes a connection that has no activity.</dd>
<dt id="proxy.config.http.background_fill_active_timeout"><em><code>proxy.config.http.background_fill_active_timeout</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>60</code></p>
-</dd>
-<dd>
-<p>Specifies how long Traffic Server continues a background fill
-before giving up and dropping the origin server connection.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>60</code></dd>
+<dd>Specifies how long Traffic Server continues a background fill before giving up and dropping the origin server connection.</dd>
<dt id="proxy.config.http.background_fill_completed_threshold"><em><code>proxy.config.http.background_fill_completed_threshold</code></em></dt>
-<dd>
-<p><code>FLOAT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0.50000</code></p>
-</dd>
-<dd>
-<p>The proportion of total document size already transferred when a
-client aborts at which the proxy continues fetching the document
-from the origin server to get it into the cache (a
-<strong>background fill</strong>).</p>
-</dd>
+<dd><code>FLOAT</code></dd>
+<dd>Default: <code>0.50000</code></dd>
+<dd>The proportion of total document size already transferred when a client aborts at which the proxy continues fetching the document from the origin server to get it into the cache (a <strong>background fill</strong>).</dd>
</dl>
<h3 id="OriginServerConnectAttempts">Origin Server Connect Attempts</h3>
<dl>
<dt id="proxy.config.http.connect_attempts_max_retries"><em><code>proxy.config.http.connect_attempts_max_retries</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>6</code></dd>
-<dd>The maximum number of connection retries Traffic Server can make
-when the origin server is not responding.</dd>
+<dd>The maximum number of connection retries Traffic Server can make when the origin server is not responding.</dd>
<dt id="proxy.config.http.connect_attempts_max_retries_dead_server"><em><code>proxy.config.http.connect_attempts_max_retries_dead_server</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>2</code></dd>
-<dd>The maximum number of connection retries Traffic Server can make
-when the origin server is unavailable.</dd>
+<dd>The maximum number of connection retries Traffic Server can make when the origin server is unavailable.</dd>
<dt id="proxy.config.http.server_max_connections"><em><code>proxy.config.http.server_max_connections</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>
-<p>Limits the number of socket connections across all origin servers
-to the value specified.</p>
-<p>To disable, set to zero (<code>0</code>).</p>
-</dd>
+<dd>Limits the number of socket connections across all origin servers to the value specified. To disable, set to zero (<code>0</code>).</dd>
<dt id="proxy.config.http.origin_max_connections"><em><code>proxy.config.http.origin_max_connections</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>Limits the number of socket connections per origin server to the
-value specified.</p>
-<p>To enable, set to one (<code>1</code>).</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>Limits the number of socket connections per origin server to the value specified. To enable, set to one (<code>1</code>).</dd>
<dt id="proxy.config.http.origin_min_keep_alive_connections"><em><code>proxy.config.http.origin_min_keep_alive_connections</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>As connection to an origin server are opened, keep at least 'n'
-number of connections open to that origin, even if the connection
-isn't used for a long time period. Useful when the origin supports
-keep-alive, removing the time needed to set up a new connection
-from the next request at the expense of added (inactive)
-connections.</p>
-<p>To enable, set to one (<code>1</code>).</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>As connection to an origin server are opened, keep at least 'n' number of connections open to that origin, even if the connection isn't used for a long time period. Useful when the origin supports keep-alive, removing the time needed to set up a new connection from the next request at the expense of added (inactive) connections. To enable, set to one (<code>1</code>).</dd>
<dt id="proxy.config.http.connect_attempts_rr_retries"><em><code>proxy.config.http.connect_attempts_rr_retries</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>2</code></p>
-</dd>
-<dd>
-<p>The maximum number of failed connection attempts allowed before a
-round-robin entry is marked as 'down' if a server has round-robin
-DNS entries.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>2</code></dd>
+<dd>The maximum number of failed connection attempts allowed before a round-robin entry is marked as 'down' if a server has round-robin DNS entries.</dd>
<dt id="proxy.config.http.connect_attempts_timeout"><em><code>proxy.config.http.connect_attempts_timeout</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>30</code></p>
-</dd>
-<dd>
-<p>The timeout value (in seconds) for an origin server connection.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>30</code></dd>
+<dd>The timeout value (in seconds) for an origin server connection.</dd>
<dt id="proxy.config.http.post_connect_attempts_timeout"><em><code>proxy.config.http.post_connect_attempts_timeout</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>1800</code></p>
-</dd>
-<dd>
-<p>The timeout value (in seconds) for an origin server connection when
-the client request is a <code>POST</code> or <code>PUT</code> request.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>1800</code></dd>
+<dd>The timeout value (in seconds) for an origin server connection when the client request is a <code>POST</code> or <code>PUT</code> request.</dd>
<dt id="proxy.config.http.down_server.cache_time"><em><code>proxy.config.http.down_server.cache_time</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>900</code></p>
-</dd>
-<dd>
-<p>Specifies how long (in seconds) Traffic Server remembers that an
-origin server was unreachable.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>900</code></dd>
+<dd>Specifies how long (in seconds) Traffic Server remembers that an origin server was unreachable.</dd>
<dt id="proxy.config.http.down_server.abort_threshold"><em><code>proxy.config.http.down_server.abort_threshold</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>10</code></p>
-</dd>
-<dd>
-<p>The number of seconds before Traffic Server marks an origin server
-as unavailable after a client abandons a request because the origin
-server was too slow in sending the response header.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>10</code></dd>
+<dd>The number of seconds before Traffic Server marks an origin server as unavailable after a client abandons a request because the origin server was too slow in sending the response header.</dd>
</dl>
<h3 id="CongestionControl">Congestion Control</h3>
<dl>
<dt id="proxy.config.http.congestion_control.enabled"><em><code>proxy.config.http.congestion_control.enabled</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the Congestion Control option,
-which configures Traffic Server to stop forwarding HTTP requests to
-origin servers when they become congested. Traffic Server sends the
-client a message to retry the congested origin server later.</p>
-<p>Refer to
-<a href="../http-proxy-caching#UsingCongestionControl">Using Congestion Control</a>.</p>
-</dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) the Congestion Control option, which configures Traffic Server to stop forwarding HTTP requests to origin servers when they become congested. Traffic Server sends the client a message to retry the congested origin server later. Refer to <a href="../http-proxy-caching#UsingCongestionControl">Using Congestion Control</a>.</dd>
</dl>
<h3 id="NegativeResponseCaching">Negative Response Caching</h3>
<dl>
@@ -838,15 +556,8 @@ client a message to retry the congested
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server caches negative responses (such
-as <code>404 Not Found</code>) when a requested page does not exist. The next
-time a client requests the same page, Traffic Server serves the
-negative response directly from cache.</p>
-<p><strong>Note</strong>: <code>Cache-Control</code> directives from the server forbidding
-cache are ignored for the following HTTP response codes, regardless
-of the value specified for the
-<em><code>proxy.config.http.negative_caching_enabled</code></em> variable. The
-following negative responses are cached by Traffic Server:</p>
+<p>When enabled (<code>1</code>), Traffic Server caches negative responses (such as <code>404 Not Found</code>) when a requested page does not exist. The next time a client requests the same page, Traffic Server serves the negative response directly from cache.</p>
+<p><strong>Note</strong>: <code>Cache-Control</code> directives from the server forbidding cache are ignored for the following HTTP response codes, regardless of the value specified for the <em><code>proxy.config.http.negative_caching_enabled</code></em> variable. The following negative responses are cached by Traffic Server:</p>
<div class="codehilite"><pre><span class="mi">204</span> <span class="n">No</span> <span class="n">Content</span>
<span class="mi">305</span> <span class="n">Use</span> <span class="n">Proxy</span>
<span class="mi">400</span> <span class="n">Bad</span> <span class="n">Request</span>
@@ -868,38 +579,31 @@ following negative responses are cached
<dt id="proxy.config.http.anonymize_remove_from"><em><code>proxy.config.http.anonymize_remove_from</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server removes the <code>From</code> header to
-protect the privacy of your users.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server removes the <code>From</code> header to protect the privacy of your users.</dd>
<dt id="proxy.config.http.anonymize_remove_referer"><em><code>proxy.config.http.anonymize_remove_referer</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server removes the <code>Referrer</code> header to
-protect the privacy of your site and users.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server removes the <code>Referrer</code> header to protect the privacy of your site and users.</dd>
<dt id="proxy.config.http.anonymize_remove_user_agent"><em><code>proxy.config.http.anonymize_remove_user_agent</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server removes the <code>User-agent</code> header
-to protect the privacy of your site and users.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server removes the <code>User-agent</code> header to protect the privacy of your site and users.</dd>
<dt id="proxy.config.http.anonymize_remove_cookie"><em><code>proxy.config.http.anonymize_remove_cookie</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server removes the <code>Cookie</code> header to
-protect the privacy of your site and users.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server removes the <code>Cookie</code> header to protect the privacy of your site and users.</dd>
<dt id="proxy.config.http.anonymize_remove_client_ip"><em><code>proxy.config.http.anonymize_remove_client_ip</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server removes <code>Client-IP</code> headers for
-more privacy.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server removes <code>Client-IP</code> headers for more privacy.</dd>
<dt id="proxy.config.http.anonymize_insert_client_ip"><em><code>proxy.config.http.anonymize_insert_client_ip</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>1</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server inserts <code>Client-IP</code> headers to
-retain the client IP address.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server inserts <code>Client-IP</code> headers to retain the client IP address.</dd>
<dt id="proxy.config.http.append_xforwards_header"><em><code>proxy.config.http.append_xforwards_header</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server appends <code>X-Forwards</code> headers to
-outgoing requests.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server appends <code>X-Forwards</code> headers to outgoing requests.</dd>
<dt id="proxy.config.http.anonymize_other_header_list"><em><code>proxy.config.http.anonymize_other_header_list</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>NULL</code></dd>
@@ -907,21 +611,17 @@ outgoing requests.</dd>
<dt id="proxy.config.http.insert_squid_x_forwarded_for"><em><code>proxy.config.http.insert_squid_x_forwarded_for</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server adds the client IP address to
-the <code>X-Forwarded-For</code> header.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server adds the client IP address to the <code>X-Forwarded-For</code> header.</dd>
<dt id="proxy.config.http.normalize_ae_gzip"><em><code>proxy.config.http.normalize_ae_gzip</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
<dd>
-<p>Enable (<code>1</code>) to normalize all <code>Accept-Encoding:</code> headers to one of
-the following:</p>
+<p>Enable (<code>1</code>) to normalize all <code>Accept-Encoding:</code> headers to one of the following:</p>
<ul>
<li><code>Accept-Encoding: gzip</code> (if the header has <code>gzip</code> or <code>x-gzip</code> with any <code>q</code>) <strong>OR</strong></li>
<li><em>blank</em> (for any header that does not include <code>gzip</code>)</li>
</ul>
-<p>This is useful for minimizing cached alternates of documents (e.g.
-<code>gzip, deflate</code> vs. <code>deflate, gzip</code>). Enabling this option is
-recommended if your origin servers use no encodings other than <code>gzip</code>.</p>
+<p>This is useful for minimizing cached alternates of documents (e.g. <code>gzip, deflate</code> vs. <code>deflate, gzip</code>). Enabling this option is recommended if your origin servers use no encodings other than <code>gzip</code>.</p>
</dd>
</dl>
<h3 id="Security">Security</h3>
@@ -930,13 +630,8 @@ recommended if your origin servers use n
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the HTTP <code>PUSH</code> option, which
-allows you to deliver content directly to the cache without a user
-request.</p>
-<p><strong>Important:</strong> If you enable this option, then you must also
-specify a filtering rule in the
-<a href="filter.config"><code>filter.config</code></a> file to allow only
-certain machines to push content into the cache.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) the HTTP <code>PUSH</code> option, which allows you to deliver content directly to the cache without a user request.</p>
+<p><strong>Important:</strong> If you enable this option, then you must also specify a filtering rule in the <a href="filter.config"><code>filter.config</code></a> file to allow only certain machines to push content into the cache.</p>
</dd>
</dl>
<h3 id="CacheControl">Cache Control</h3>
@@ -944,17 +639,11 @@ certain machines to push content into th
<dt id="proxy.config.cache.enable_read_while_writer"><em><code>proxy.config.cache.enable_read_while_writer</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>Enables (<code>1</code>) or disables (<code>0</code>) ability to a read cached object
-while the another connection is completing the write to cache for
-the same object. This must be enabled for connection collapsing to
-work</dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) ability to a read cached object while the another connection is completing the write to cache for the same object. This must be enabled for connection collapsing to work</dd>
<dt id="proxy.config.cache.force_sector_size"><em><code>proxy.config.cache.force_sector_size</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>512</code></dd>
-<dd>Enables (<code>1</code>) or disables (<code>0</code>) ability to a read cached object
-while the another connection is completing the write to cache for
-the same object. This must be enabled for connection collapsing to
-work</dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) ability to a read cached object while the another connection is completing the write to cache for the same object. This must be enabled for connection collapsing to work</dd>
<dt id="proxy.config.http.cache.http"><em><code>proxy.config.http.cache.http</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>1</code></dd>
@@ -962,18 +651,15 @@ work</dd>
<dt id="proxy.config.http.cache.ignore_client_no_cache"><em><code>proxy.config.http.cache.ignore_client_no_cache</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server ignores client requests to
-bypass the cache.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server ignores client requests to bypass the cache.</dd>
<dt id="proxy.config.http.cache.ims_on_client_no_cache"><em><code>proxy.config.http.cache.ims_on_client_no_cache</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server issues a conditional request to
-the origin server if an incoming request has a <code>No-Cache</code> header.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server issues a conditional request to the origin server if an incoming request has a <code>No-Cache</code> header.</dd>
<dt id="proxy.config.http.cache.ignore_server_no_cache"><em><code>proxy.config.http.cache.ignore_server_no_cache</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>When enabled (<code>1</code>), Traffic Server ignores origin server requests
-to bypass the cache.</dd>
+<dd>When enabled (<code>1</code>), Traffic Server ignores origin server requests to bypass the cache.</dd>
<dt id="proxy.config.http.cache.cache_responses_to_cookies"><em><code>proxy.config.http.cache.cache_responses_to_cookies</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>3</code></dd>
@@ -994,9 +680,7 @@ to bypass the cache.</dd>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server ignores <code>WWW-Authentication</code>
-headers in responses</p>
-<p><code>WWW-Authentication</code> headers are removed and not cached.</p>
+<p>When enabled (<code>1</code>), Traffic Server ignores <code>WWW-Authentication</code> headers in responses <code>WWW-Authentication</code> headers are removed and not cached.</p>
</dd>
<dt id="proxy.config.http.cache.cache_urls_that_look_dynamic"><em><code>proxy.config.http.cache.cache_urls_that_look_dynamic</code></em></dt>
<dd>
@@ -1006,9 +690,7 @@ headers in responses</p>
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) caching of URLs that look dynamic, i.e.: URLs that end in <strong><code>.asp</code></strong> or
-contain a question mark (<strong><code>?</code></strong>), a semicolon (<strong><code>;</code></strong>), or <strong><code>cgi</code></strong>.</p>
-<p>For a full list, please refer to <a href="/link/to/doxygen">HttpTransact::url_looks_dynamic</a></p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) caching of URLs that look dynamic, i.e.: URLs that end in <strong><code>.asp</code></strong> or contain a question mark (<strong><code>?</code></strong>), a semicolon (<strong><code>;</code></strong>), or <strong><code>cgi</code></strong>. For a full list, please refer to <a href="/link/to/doxygen">HttpTransact::url_looks_dynamic</a></p>
</dd>
<dt id="proxy.config.http.cache.enable_default_vary_headers"><em><code>proxy.config.http.cache.enable_default_vary_headers</code></em></dt>
<dd>
@@ -1018,8 +700,7 @@ contain a question mark (<strong><code>?
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) caching of alternate versions of
-HTTP objects that do not contain the <code>Vary</code> header.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) caching of alternate versions of HTTP objects that do not contain the <code>Vary</code> header.</p>
</dd>
<dt id="proxy.config.http.cache.when_to_revalidate"><em><code>proxy.config.http.cache.when_to_revalidate</code></em></dt>
<dd>
@@ -1038,9 +719,7 @@ HTTP objects that do not contain the <co
<li><code>4</code> = use cache directives or heuristic (0) unless the request has
an <code>If-Modified-Since</code> header</li>
</ul>
-<p>If the request contains the <code>If-Modified-Since</code> header, then
-Traffic Server always revalidates the cached content and uses the
-client's <code>If-Modified-Since</code> header for the proxy request.</p>
+<p>If the request contains the <code>If-Modified-Since</code> header, then Traffic Server always revalidates the cached content and uses the client's <code>If-Modified-Since</code> header for the proxy request.</p>
</dd>
<dt id="proxy.config.http.cache.when_to_add_no_cache_to_msie_requests"><em><code>proxy.config.http.cache.when_to_add_no_cache_to_msie_requests</code></em></dt>
<dd>
@@ -1050,8 +729,7 @@ client's <code>If-Modified-Since</code>
<p>Default: 0</p>
</dd>
<dd>
-<p>Specifies when to add <code>no-cache</code> directives to Microsoft Internet
-Explorer requests. You can specify the following:</p>
+<p>Specifies when to add <code>no-cache</code> directives to Microsoft Internet Explorer requests. You can specify the following:</p>
<ul>
<li><code>0</code> = <code>no-cache</code> is <em>not</em> added to MSIE requests</li>
<li><code>1</code> = <code>no-cache</code> is added to IMS MSIE requests</li>
@@ -1066,14 +744,11 @@ Explorer requests. You can specify the f
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>The type of headers required in a request for the request to be
-cacheable.</p>
+<p>The type of headers required in a request for the request to be cacheable.</p>
<ul>
<li><code>0</code> = no headers required to make document cacheable</li>
-<li><code>1</code> = either the <code>Last-Modified</code> header, or an explicit lifetime
- header, <code>Expires</code> or <code>Cache-Control: max-age</code>, is required</li>
-<li><code>2</code> = explicit lifetime is required, <code>Expires</code> or
- <code>Cache-Control: max-age</code></li>
+<li><code>1</code> = either the <code>Last-Modified</code> header, or an explicit lifetime header, <code>Expires</code> or <code>Cache-Control: max-age</code>, is required</li>
+<li><code>2</code> = explicit lifetime is required, <code>Expires</code> or <code>Cache-Control: max-age</code></li>
</ul>
</dd>
<dt id="proxy.config.http.cache.max_stale_age"><em><code>proxy.config.http.cache.max_stale_age</code></em></dt>
@@ -1084,8 +759,7 @@ cacheable.</p>
<p>Default: <code>604800</code></p>
</dd>
<dd>
-<p>The maximum age allowed for a stale response before it cannot be
-cached.</p>
+<p>The maximum age allowed for a stale response before it cannot be cached.</p>
</dd>
<dt id="proxy.config.http.cache.range.lookup"><em><code>proxy.config.http.cache.range.lookup</code></em></dt>
<dd>
@@ -1095,8 +769,7 @@ cached.</p>
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server looks up range requests in the
-cache.</p>
+<p>When enabled (<code>1</code>), Traffic Server looks up range requests in the cache.</p>
</dd>
<dt id="proxy.config.http.cache.enable_read_while_writer"><em><code>proxy.config.http.cache.enable_read_while_writer</code></em></dt>
<dd>
@@ -1106,10 +779,7 @@ cache.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the ability to read a cached object
-while another connection is completing a write to cache for the
-same object. If you want connection collapsing to work, then this
-option must be enabled.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) the ability to read a cached object while another connection is completing a write to cache for the same object. If you want connection collapsing to work, then this option must be enabled.</p>
</dd>
<dt id="proxy.config.connection_collapsing.hashtable_enabled"><em><code>proxy.config.connection_collapsing.hashtable_enabled</code></em></dt>
<dd>
@@ -1119,9 +789,7 @@ option must be enabled.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) whether requests will first search
-the hashtable to see if another similar request is already being
-served.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) whether requests will first search the hashtable to see if another similar request is already being served.</p>
</dd>
<dt id="proxy.config.connection_collapsing.rww_wait_time"><em><code>proxy.config.connection_collapsing.rww_wait_time</code></em></dt>
<dd>
@@ -1131,9 +799,7 @@ served.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>) while the write configuration parameter is also
-enabled, secondary clients will wait this amount of time (in msec)
-before cache lookup is retried.</p>
+<p>When enabled (<code>1</code>) while the write configuration parameter is also enabled, secondary clients will wait this amount of time (in msec) before cache lookup is retried.</p>
</dd>
<dt id="proxy.config.connection_collapsing.revalidate_window_period"><em><code>proxy.config.connection_collapsing.revalidate_window_period</code></em></dt>
<dd>
@@ -1143,9 +809,7 @@ before cache lookup is retried.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>The amount of time (msec) secondary clients for the same URL will
-be served the stale object when revalidation of a cached object is
-in progress.</p>
+<p>The amount of time (msec) secondary clients for the same URL will be served the stale object when revalidation of a cached object is in progress.</p>
</dd>
<dt id="proxy.config.http.cache.fuzz.min_time"><em><code>proxy.config.http.cache.fuzz.min_time</code></em></dt>
<dd>
@@ -1155,9 +819,7 @@ in progress.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Sets a minimum fuzz time; the default value is <code>0</code>.</p>
-<p><strong>Effective fuzz time</strong> is a calculation in the range
-(<code>fuzz.min_time</code> - <code>fuzz.min_time</code>).</p>
+<p>Sets a minimum fuzz time; the default value is <code>0</code>. <strong>Effective fuzz time</strong> is a calculation in the range (<code>fuzz.min_time</code> - <code>fuzz.min_time</code>).</p>
</dd>
<dt id="proxy.config.http.cache.ignore_accept_mismatch"><em><code>proxy.config.http.cache.ignore_accept_mismatch</code></em></dt>
<dd>
@@ -1167,16 +829,11 @@ in progress.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with
-a <code>Content-Type:</code> header that does not match the <code>Accept:</code> header
-of the request.</p>
-<p><strong>Note:</strong> This option should only be enabled if you're having
-problems with caching <em>and</em> one of the following is true:</p>
-<ul>
-<li>Your origin server sets <code>Vary: Accept</code> when doing content
-negotiation with <code>Accept</code> <em>OR</em></li>
-<li>The server does not send a <code>406 (Not Acceptable)</code> response for
-types that it cannot serve.</li>
+<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with a <code>Content-Type:</code> header that does not match the <code>Accept:</code> header of the request.</p>
+<p><strong>Note:</strong> This option should only be enabled if you're having problems with caching <em>and</em> one of the following is true:</p>
+<ul>
+<li>Your origin server sets <code>Vary: Accept</code> when doing content negotiation with <code>Accept</code> <em>OR</em> </li>
+<li>The server does not send a <code>406 (Not Acceptable)</code> response for types that it cannot serve.</li>
</ul>
</dd>
<dt id="proxy.config.http.cache.ignore_accept_language_mismatch"><em><code>proxy.config.http.cache.ignore_accept_language_mismatch</code></em></dt>
@@ -1187,13 +844,8 @@ types that it cannot serve.</li>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with
-a <code>Content-Language:</code> header that does not match the
-<code>Accept-Language:</code> header of the request.</p>
-<p><strong>Note:</strong> This option should only be enabled if you're having
-problems with caching and your origin server is guaranteed to set
-<code>Vary: Accept-Language</code> when doing content negotiation with
-<code>Accept-Language</code>.</p>
+<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with a <code>Content-Language:</code> header that does not match the <code>Accept-Language:</code> header of the request.</p>
+<p><strong>Note:</strong> This option should only be enabled if you're having problems with caching and your origin server is guaranteed to set <code>Vary: Accept-Language</code> when doing content negotiation with <code>Accept-Language</code>.</p>
</dd>
<dt id="proxy.config.http.cache.ignore_accept_charset_mismatch"><em><code>proxy.config.http.cache.ignore_accept_charset_mismatch</code></em></dt>
<dd>
@@ -1203,13 +855,8 @@ problems with caching and your origin se
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with
-a <code>Content-Type:</code> header that does not match the <code>Accept-Charset:</code>
-header of the request.</p>
-<p><strong>Note:</strong> This option should only be enabled if you're having
-problems with caching and your origin server is guaranteed to set
-<code>Vary: Accept-Charset</code> when doing content negotiation with
-<code>Accept-Charset</code>.</p>
+<p>When enabled (<code>1</code>), Traffic Server serves documents from cache with a <code>Content-Type:</code> header that does not match the <code>Accept-Charset:</code> header of the request.</p>
+<p><strong>Note:</strong> This option should only be enabled if you're having problems with caching and your origin server is guaranteed to set <code>Vary: Accept-Charset</code> when doing content negotiation with <code>Accept-Charset</code>.</p>
</dd>
<dt id="proxy.config.http.cache.ignore_client_cc_max_age"><em><code>proxy.config.http.cache.ignore_client_cc_max_age</code></em></dt>
<dd>
@@ -1219,8 +866,7 @@ problems with caching and your origin se
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server ignores any
-<code>Cache-Control: max-age</code> headers from the client.</p>
+<p>When enabled (<code>1</code>), Traffic Server ignores any <code>Cache-Control: max-age</code> headers from the client.</p>
</dd>
<dt id="proxy.config.cache.permit.pinning"><em><code>proxy.config.cache.permit.pinning</code></em></dt>
<dd>
@@ -1230,8 +876,7 @@ problems with caching and your origin se
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), Traffic Server will keep certain HTTP objects in the cache for a certain time as
-specified in <a href="cache.config"><code>cache.config</code></a>.</p>
+<p>When enabled (<code>1</code>), Traffic Server will keep certain HTTP objects in the cache for a certain time as specified in <a href="cache.config"><code>cache.config</code></a>.</p>
</dd>
</dl>
<h3 id="HeuristicExpiration">Heuristic Expiration</h3>
@@ -1239,62 +884,41 @@ specified in <a href="cache.config"><cod
<dt id="proxy.config.http.cache.heuristic_min_lifetime"><em><code>proxy.config.http.cache.heuristic_min_lifetime</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>3600</code> (1 hour)</dd>
-<dd>The minimum amount of time an HTTP object without an expiration date can remain fresh in the cache
-before is considered to be stale.</dd>
+<dd>The minimum amount of time an HTTP object without an expiration date can remain fresh in the cache before is considered to be stale.</dd>
<dt id="proxy.config.http.cache.heuristic_max_lifetime"><em><code>proxy.config.http.cache.heuristic_max_lifetime</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>86400</code> (1 day)</dd>
-<dd>The maximum amount of time an HTTP object without an expiration date can remain fresh in the cache
-before is considered to be stale.</dd>
+<dd>The maximum amount of time an HTTP object without an expiration date can remain fresh in the cache before is considered to be stale.</dd>
<dt id="proxy.config.http.cache.heuristic_lm_factor"><em><code>proxy.config.http.cache.heuristic_lm_factor</code></em></dt>
<dd><code>FLOAT</code></dd>
<dd>Default: <code>0.10000</code></dd>
-<dd>The aging factor for freshness computations.
-Traffic Server stores an object for this percentage of the time that elapsed since it last changed.</dd>
+<dd>The aging factor for freshness computations. Traffic Server stores an object for this percentage of the time that elapsed since it last changed.</dd>
<dt id="proxy.config.http.cache.fuzz.time"><em><code>proxy.config.http.cache.fuzz.time</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>240</code></dd>
-<dd>How often Traffic Server checks for an early refresh, during the
-period before the document stale time. The interval specified must
-be in seconds.</dd>
+<dd>How often Traffic Server checks for an early refresh, during the period before the document stale time. The interval specified must be in seconds.</dd>
<dt id="proxy.config.http.cache.fuzz.probability"><em><code>proxy.config.http.cache.fuzz.probability</code></em></dt>
<dd><code>FLOAT</code></dd>
<dd>Default: <code>0.00500</code></dd>
-<dd>The probability that a refresh is made on a document during the
-specified fuzz time.</dd>
+<dd>The probability that a refresh is made on a document during the specified fuzz time.</dd>
</dl>
<h3 id="DynamicContentAndContentNegotiation">Dynamic Content & Content Negotiation</h3>
<dl>
<dt id="proxy.config.http.cache.vary_default_text"><em><code>proxy.config.http.cache.vary_default_text</code></em></dt>
<dd><code>STRING</code></dd>
<dd>Default: <code>NULL</code></dd>
-<dd>
-<p>The header on which Traffic Server varies for text documents.</p>
-<p>For example: if you specify <code>User-agent</code>, then Traffic Server
-caches all the different user-agent versions of documents it
-encounters.</p>
-</dd>
+<dd>The header on which Traffic Server varies for text documents.</dd>
+</dl>
+<p>For example: if you specify <code>User-agent</code>, then Traffic Server caches all the different user-agent versions of documents it encounters.</p>
+<dl>
<dt id="proxy.config.http.cache.vary_default_images"><em><code>proxy.config.http.cache.vary_default_images</code></em></dt>
-<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>NULL</code></p>
-</dd>
-<dd>
-<p>The header on which Traffic Server varies for images.</p>
-</dd>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>NULL</code></dd>
+<dd>The header on which Traffic Server varies for images.</dd>
<dt id="proxy.config.http.cache.vary_default_other"><em><code>proxy.config.http.cache.vary_default_other</code></em></dt>
-<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>NULL</code></p>
-</dd>
-<dd>
-<p>The header on which Traffic Server varies for anything other than
-text and images.</p>
-</dd>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>NULL</code></dd>
+<dd>The header on which Traffic Server varies for anything other than text and images.</dd>
</dl>
<h3 id="CustomizableUserResponsePages">Customizable User Response Pages</h3>
<dl>
@@ -1302,12 +926,10 @@ text and images.</p>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
<dd>
-<p>Specifies whether customizable response pages are enabled or
-disabled and which response pages are used:</p>
+<p>Specifies whether customizable response pages are enabled or disabled and which response pages are used:</p>
<ul>
<li><code>0</code> = disable customizable user response pages</li>
-<li><code>1</code> = enable customizable user response pages in the default
- directory only</li>
+<li><code>1</code> = enable customizable user response pages in the default directory only</li>
<li><code>2</code> = enable language-targeted user response pages</li>
</ul>
</dd>
@@ -1319,10 +941,7 @@ disabled and which response pages are us
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) logging for customizable response
-pages. </p>
-<p>When enabled, Traffic Server records a message in the error log
-each time a customized response page is used or modified.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) logging for customizable response pages. When enabled, Traffic Server records a message in the error log each time a customized response page is used or modified.</p>
</dd>
<dt id="proxy.config.body_factory.template_sets_dir"><em><code>proxy.config.body_factory.template_sets_dir</code></em></dt>
<dd>
@@ -1355,46 +974,17 @@ each time a customized response page is
<dt id="proxy.config.dns.search_default_domains"><em><code>proxy.config.dns.search_default_domains</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>1</code></dd>
-<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) local domain expansion so that
-Traffic Server can attempt to resolve unqualified hostnames by
-expanding to the local domain.</p>
-<p>For example: if a client makes a request to an unqualified host
-(<code>host_x</code>) and the Traffic Server local domain is <code>y.com</code> , then
-Traffic Server will expand the hostname to <code>host_x.y.com</code>.</p>
-</dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) local domain expansion so that Traffic Server can attempt to resolve unqualified hostnames by expanding to the local domain. For example: if a client makes a request to an unqualified host (<code>host_x</code>) and the Traffic Server local domain is <code>y.com</code> , then Traffic Server will expand the hostname to <code>host_x.y.com</code>.</dd>
<dt id="proxy.config.dns.splitDNS.enabled"><em><code>proxy.config.dns.splitDNS.enabled</code></em></dt>
-<dd>
-<p><code>INT</code></p>
-</dd>
-<dd>
-<p>Default: <code>0</code></p>
-</dd>
-<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) DNS server selection.<br />
-When enabled, Traffic Server refers to the <code>splitdns.config</code> file
-for the selection specification.</p>
-<p>Refer to
-<a href="../security-options#ConfiguringDNSServerSelectionSplit">Configuring DNS Server Selection (Split DNS)</a>.</p>
-</dd>
+<dd><code>INT</code></dd>
+<dd>Default: <code>0</code></dd>
+<dd>Enables (<code>1</code>) or disables (<code>0</code>) DNS server selection. When enabled, Traffic Server refers to the <code>splitdns.config</code> file for the selection specification. Refer to <a href="../security-options#ConfiguringDNSServerSelectionSplit">Configuring DNS Server Selection (Split DNS)</a>.</dd>
<dt id="proxy.config.dns.url_expansions"><em><code>proxy.config.dns.url_expansions</code></em></dt>
+<dd><code>STRING</code></dd>
+<dd>Default: <code>NULL</code></dd>
<dd>
-<p><code>STRING</code></p>
-</dd>
-<dd>
-<p>Default: <code>NULL</code></p>
-</dd>
-<dd>
-<p>Specifies a list of hostname extensions that are automatically
-added to the hostname after a failed lookup.</p>
-<p>For example: if you want Traffic Server to add the hostname
-extension .org, then specify <code>org</code> as the value for this variable
-(Traffic Server automatically adds the dot (.)).</p>
-<p><strong>Note:</strong> If the variable
-<em><code>proxy.config.http.enable_url_expandomatic</code></em> is set to <code>1</code>
-(the default value), then you do not have to add <strong><code>www.</code></strong> and
-<strong><code>.com</code></strong> to this list because Traffic Server automatically tries
-www. and .com after trying the values you've specified.</p>
+<p>Specifies a list of hostname extensions that are automatically added to the hostname after a failed lookup. For example: if you want Traffic Server to add the hostname extension .org, then specify <code>org</code> as the value for this variable (Traffic Server automatically adds the dot (.)).</p>
+<p><strong>Note:</strong> If the variable <em><code>proxy.config.http.enable_url_expandomatic</code></em> is set to <code>1</code> (the default value), then you do not have to add <strong><code>www.</code></strong> and <strong><code>.com</code></strong> to this list because Traffic Server automatically tries www. and .com after trying the values you've specified.</p>
</dd>
<dt id="proxy.config.dns.resolv_conf"><em><code>proxy.config.dns.resolv_conf</code></em></dt>
<dd>
@@ -1404,10 +994,7 @@ www. and .com after trying the values yo
<p>Default: <code>/etc/resolv.conf</code></p>
</dd>
<dd>
-<p>Allows to specify which <code>resolv.conf</code> file to use for finding resolvers.
-While the format of this file must be the same as the standard <code>resolv.conf</code> file,
-this option allows an administrator to manage the set of resolvers in an external
-configuration file, without affecting how the rest of the operating system uses DNS.</p>
+<p>Allows to specify which <code>resolv.conf</code> file to use for finding resolvers. While the format of this file must be the same as the standard <code>resolv.conf</code> file, this option allows an administrator to manage the set of resolvers in an external configuration file, without affecting how the rest of the operating system uses DNS.</p>
</dd>
<dt id="proxy.config.dns.round_robin_nameservers"><em><code>proxy.config.dns.round_robin_nameservers</code></em></dt>
<dd>
@@ -1445,33 +1032,23 @@ configuration file, without affecting ho
<dt id="proxy.config.hostdb.serve_stale_for"><em><code>proxy.config.hostdb.serve_stale_for</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
-<dd>The number of seconds for which to utilize a stale NS record while</dd>
-</dl>
-<p>initiating a background fetch for the new data.</p>
-<dl>
+<dd>The number of seconds for which to utilize a stale NS record whileinitiating a background fetch for the new data.</dd>
<dt id="proxy.config.hostdb.storage_size"><em><code>proxy.config.hostdb.storage_size</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>33554432</code></dd>
-<dd>The amount of space (in bytes) used to store <em><code>hostdb</code></em>. The</dd>
-</dl>
-<p>value of this variable must be increased if you increase the size
- of the <em><code>proxy.config.hostdb.size</code></em> variable.</p>
-<dl>
+<dd>The amount of space (in bytes) used to store <em><code>hostdb</code></em>. Thevalue of this variable must be increased if you increase the sizeof the <em><code>proxy.config.hostdb.size</code></em> variable.</dd>
<dt id="proxy.config.hostdb.size"><em><code>proxy.config.hostdb.size</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>200000</code></dd>
<dd>The maximum number of entries allowed in the host database.</dd>
</dl>
-<p><strong>Note:</strong> For values above <code>200000</code>, you must increase the value of
- the <em><code>proxy.config.hostdb.storage_size</code></em> variable by at least
- 44 bytes per entry.</p>
+<p><strong>Note:</strong> For values above <code>200000</code>, you must increase the value ofthe <em><code>proxy.config.hostdb.storage_size</code></em> variable by at least44 bytes per entry.</p>
<dl>
<dt id="proxy.config.hostdb.ttl_mode"><em><code>proxy.config.hostdb.ttl_mode</code></em></dt>
<dd><code>INT</code></dd>
<dd>Default: <code>0</code></dd>
<dd>
-<p>The host database time to live mode. You can specify one of the
-following:</p>
+<p>The host database time to live mode. You can specify one of the following:</p>
<ul>
<li><code>0</code> = obey</li>
<li><code>1</code>= ignore</li>
@@ -1497,9 +1074,7 @@ following:</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When disabled (<code>0</code>), Traffic Server always uses the same origin
-server for the same client, for as long as the origin server is
-available.</p>
+<p>When disabled (<code>0</code>), Traffic Server always uses the same origin server for the same client, for as long as the origin server is available.</p>
</dd>
</dl>
<h3 id="LoggingConfig">Logging Config</h3>
@@ -1525,8 +1100,7 @@ available.</p>
<p>Default: <code>5</code></p>
</dd>
<dd>
-<p>The maximum amount of time before data in the buffer is flushed to
-disk.</p>
+<p>The maximum amount of time before data in the buffer is flushed to disk.</p>
</dd>
<dt id="proxy.config.log.max_space_mb_for_logs"><em><code>proxy.config.log.max_space_mb_for_logs</code></em></dt>
<dd>
@@ -1536,9 +1110,7 @@ disk.</p>
<p>Default: <code>2000</code></p>
</dd>
<dd>
-<p>The amount of space allocated to the logging directory (in MB).</p>
-<p><strong>Note:</strong> All files in the logging directory contribute
-to the space used, even if they are not log files.</p>
+<p>The amount of space allocated to the logging directory (in MB). <strong>Note:</strong> All files in the logging directory contribute to the space used, even if they are not log files.</p>
</dd>
<dt id="proxy.config.log.max_space_mb_for_orphan_logs"><em><code>proxy.config.log.max_space_mb_for_orphan_logs</code></em></dt>
<dd>
@@ -1548,8 +1120,7 @@ to the space used, even if they are not
<p>Default: <code>25</code></p>
</dd>
<dd>
-<p>The amount of space allocated to the logging directory (in MB) if
-this node is acting as a collation client.</p>
+<p>The amount of space allocated to the logging directory (in MB) if this node is acting as a collation client.</p>
</dd>
<dt id="proxy.config.log.max_space_mb_headroom"><em><code>proxy.config.log.max_space_mb_headroom</code></em></dt>
<dd>
@@ -1559,11 +1130,7 @@ this node is acting as a collation clien
<p>Default: <code>10</code></p>
</dd>
<dd>
-<p>The tolerance for the log space limit (in bytes).</p>
-<p>If the variable <em><code>proxy.config.log.auto_delete_rolled_file</code></em>
-is set to <code>1</code> (enabled), then autodeletion of log files is
-triggered when the amount of free space available in the logging
-directory is less than the value specified here.</p>
+<p>The tolerance for the log space limit (in bytes). If the variable <em><code>proxy.config.log.auto_delete_rolled_file</code></em> is set to <code>1</code> (enabled), then autodeletion of log files is triggered when the amount of free space available in the logging directory is less than the value specified here.</p>
</dd>
<dt id="proxy.config.log.hostname"><em><code>proxy.config.log.hostname</code></em></dt>
<dd>
@@ -1583,9 +1150,7 @@ directory is less than the value specifi
<p>Default: <em><code>install_dir</code></em><code>/logs</code></p>
</dd>
<dd>
-<p>The full path to the logging directory.</p>
-<p>This can be an absolute path or a path relative to the directory in which Traffic Server is installed.</p>
-<p><strong>Note:</strong> The directory you specify must already exist.</p>
+<p>The full path to the logging directory. This can be an absolute path or a path relative to the directory in which Traffic Server is installed. <strong>Note:</strong> The directory you specify must already exist.</p>
</dd>
<dt id="proxy.config.log.logfile_perm"><em><code>proxy.config.log.logfile_perm</code></em></dt>
<dd>
@@ -1595,17 +1160,12 @@ directory is less than the value specifi
<p>Default: <code>rw-r--r--</code></p>
</dd>
<dd>
-<p>The log file permissions. The standard UNIX file permissions are
-used (owner, group, other). Permissable values are:</p>
+<p>The log file permissions. The standard UNIX file permissions are used (owner, group, other). Permissable values are:</p>
<p><code>-</code>no permission
<code>r</code>read permission
<code>w</code>write permission
<code>x</code>execute permission</p>
-<p>Permissions are subject to the umask settings for the Traffic
-Server process. This means that a umask setting of<code>002</code>will not
-allow write permission for others, even if specified in the
-configuration file. Permissions for existing log files are not
-changed when the configuration is changed.</p>
+<p>Permissions are subject to the umask settings for the Traffic Server process. This means that a umask setting of<code>002</code>will not allow write permission for others, even if specified in the configuration file. Permissions for existing log files are not changed when the configuration is changed.</p>
</dd>
<dt id="proxy.config.log.custom_logs_enabled"><em><code>proxy.config.log.custom_logs_enabled</code></em></dt>
<dd>
@@ -1669,8 +1229,7 @@ changed when the configuration is change
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape common log file
-format.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape common log file format.</p>
</dd>
<dt id="proxy.config.log.common_log_is_ascii"><em><code>proxy.config.log.common_log_is_ascii</code></em></dt>
<dd>
@@ -1714,8 +1273,7 @@ format.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape extended log file
-format.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape extended log file format.</p>
</dd>
<dt id="proxy.confg.log.extended_log_is_ascii"><em><code>proxy.confg.log.extended_log_is_ascii</code></em></dt>
<dd>
@@ -1759,8 +1317,7 @@ format.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape Extended-2 log file
-format.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) the Netscape Extended-2 log file format.</p>
</dd>
<dt id="proxy.config.log.extended2_log_is_ascii"><em><code>proxy.config.log.extended2_log_is_ascii</code></em></dt>
<dd>
@@ -1804,8 +1361,7 @@ format.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), configures Traffic Server to store ICP
-transactions in a separate log file.</p>
+<p>When enabled (<code>1</code>), configures Traffic Server to store ICP transactions in a separate log file.</p>
<ul>
<li><code>0</code> = separation is disabled, all ICP transactions are recorded in the same file as HTTP transactions</li>
<li><code>1</code> = all ICP transactions are recorded in a separate log file.</li>
@@ -1820,10 +1376,7 @@ transactions in a separate log file.</p>
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), configures Traffic Server to create a separate
-log file for HTTP transactions for each origin server listed in the
-<code>log_hosts.config</code> file.</p>
-<p>Refer to <a href="../working-log-files#HTTPHostLogSplitting">HTTP Host Log Splitting</a>.</p>
+<p>When enabled (<code>1</code>), configures Traffic Server to create a separate log file for HTTP transactions for each origin server listed in the <code>log_hosts.config</code> file. Refer to <a href="../working-log-files#HTTPHostLogSplitting">HTTP Host Log Splitting</a>.</p>
</dd>
<dt id="proxy.local.log.collation_mode"><em><code>proxy.local.log.collation_mode</code></em></dt>
<dd>
@@ -1837,20 +1390,12 @@ log file for HTTP transactions for each
<ul>
<li><code>0</code> = collation is disabled</li>
<li><code>1</code> = this host is a log collation server</li>
-<li><code>2</code> = this host is a collation client and sends entries using
- standard formats to the collation server</li>
-<li><code>3</code> = this host is a collation client and sends entries using the
- traditional custom formats to the collation server</li>
-<li><code>4</code> = this host is a collation client and sends entries that use
- both the standard and traditional custom formats to the collation
- server</li>
-</ul>
-<p>For information on sending XML-based custom formats to the
-collation server, refer to
-<a href="logs_xml.config">logs_xml.config</a>.</p>
-<p><strong>Note:</strong> Although Traffic Server supports traditional custom
-logging, you should use the more versatile XML-based custom
-formats.</p>
+<li><code>2</code> = this host is a collation client and sends entries using standard formats to the collation server</li>
+<li><code>3</code> = this host is a collation client and sends entries using the traditional custom formats to the collation server</li>
+<li><code>4</code> = this host is a collation client and sends entries that use both the standard and traditional custom formats to the collation server</li>
+</ul>
+<p>For information on sending XML-based custom formats to the collation server, refer to <a href="logs_xml.config">logs_xml.config</a>.</p>
+<p><strong>Note:</strong> Although Traffic Server supports traditional custom logging, you should use the more versatile XML-based custom formats.</p>
</dd>
<dt id="proxy.confg.log.collation_host"><em><code>proxy.confg.log.collation_host</code></em></dt>
<dd>
@@ -1870,8 +1415,7 @@ formats.</p>
<p>Default: <code>8085</code></p>
</dd>
<dd>
-<p>The port used for communication between the collation server and
-client.</p>
+<p>The port used for communication between the collation server and client.</p>
</dd>
<dt id="proxy.config.log.collation_secret"><em><code>proxy.config.log.collation_secret</code></em></dt>
<dd>
@@ -1881,8 +1425,7 @@ client.</p>
<p>Default: <code>foobar</code></p>
</dd>
<dd>
-<p>The password used to validate logging data and prevent the exchange
-of unauthorized information when a collation server is being used.</p>
+<p>The password used to validate logging data and prevent the exchange of unauthorized information when a collation server is being used.</p>
</dd>
<dt id="proxy.config.log.collation_host_tagged"><em><code>proxy.config.log.collation_host_tagged</code></em></dt>
<dd>
@@ -1892,9 +1435,7 @@ of unauthorized information when a colla
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>When enabled (<code>1</code>), configures Traffic Server to include the
-hostname of the collation client that generated the log entry in
-each entry.</p>
+<p>When enabled (<code>1</code>), configures Traffic Server to include the hostname of the collation client that generated the log entry in each entry.</p>
</dd>
<dt id="proxy.config.log.collation_retry_sec"><em><code>proxy.config.log.collation_retry_sec</code></em></dt>
<dd>
@@ -1914,21 +1455,13 @@ each entry.</p>
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>Specifies how log files are rolled. You can specify the following
-values:</p>
+<p>Specifies how log files are rolled. You can specify the following values:</p>
<ul>
<li><code>0</code> = disables log file rolling</li>
-<li><code>1</code> = enables log file rolling at specific intervals during the day
- (specified with the <em><code>proxy.config.log.rolling_interval_sec</code></em>
- and <em><code>proxy.config.log.rolling_offset_hr</code></em> variables)</li>
-<li><code>2</code> = enables log file rolling when log files reach a specific size
- (specified with the <em><code>proxy.config.log.rolling_size_mb</code></em>
- variable)</li>
-<li><code>3</code> = enables log file rolling at specific intervals during the day
- or when log files reach a specific size (whichever occurs first)</li>
-<li><code>4</code> = enables log file rolling at specific intervals during the day
- when log files reach a specific size (i.e., at a specified time if
- the file is of the specified size)</li>
+<li><code>1</code> = enables log file rolling at specific intervals during the day (specified with the <em><code>proxy.config.log.rolling_interval_sec</code></em> and <em><code>proxy.config.log.rolling_offset_hr</code></em> variables)</li>
+<li><code>2</code> = enables log file rolling when log files reach a specific size (specified with the <em><code>proxy.config.log.rolling_size_mb</code></em> variable)</li>
+<li><code>3</code> = enables log file rolling at specific intervals during the day or when log files reach a specific size (whichever occurs first)</li>
+<li><code>4</code> = enables log file rolling at specific intervals during the day when log files reach a specific size (i.e., at a specified time if the file is of the specified size)</li>
</ul>
</dd>
<dt id="proxy.config.log.rolling_interval_sec"><em><code>proxy.config.log.rolling_interval_sec</code></em></dt>
@@ -1939,10 +1472,8 @@ values:</p>
<p>Default: <code>86400</code></p>
</dd>
<dd>
-<p>The log file rolling interval, in seconds. The minimum value is
-<code>300</code> (5 minutes). The maximum value is 86400 seconds (one day).</p>
-<p><strong>Note:</strong> If you start Traffic Server within a few minutes of the next rolling time,
-then rolling might not occur until the next rolling time.</p>
+<p>The log file rolling interval, in seconds. The minimum value is <code>300</code> (5 minutes). The maximum value is 86400 seconds (one day).</p>
+<p><strong>Note:</strong> If you start Traffic Server within a few minutes of the next rolling time, then rolling might not occur until the next rolling time.</p>
</dd>
<dt id="proxy.config.log.rolling_offset_hr"><em><code>proxy.config.log.rolling_offset_hr</code></em></dt>
<dd>
@@ -1952,8 +1483,7 @@ then rolling might not occur until the n
<p>Default: <code>0</code></p>
</dd>
<dd>
-<p>The file rolling offset hour. The hour of the day that starts the
-log rolling period.</p>
+<p>The file rolling offset hour. The hour of the day that starts the log rolling period.</p>
</dd>
<dt id="proxy.config.log.rolling_size_mb"><em><code>proxy.config.log.rolling_size_mb</code></em></dt>
<dd>
@@ -1973,8 +1503,7 @@ log rolling period.</p>
<p>Default: <code>1</code></p>
</dd>
<dd>
-<p>Enables (<code>1</code>) or disables (<code>0</code>) automatic deletion of rolled
-files.</p>
+<p>Enables (<code>1</code>) or disables (<code>0</code>) automatic deletion of rolled files.</p>
</dd>
[... 476 lines stripped ...]