Disclaimer: This manual is NOT a Squid tutorial. It is only a reference material that provides detailed explanation of all configuration parameters available in Squid 2.4. The reader is expected to have prior knowledge of basic Squid installation and configuration. For Complete tutorial on Squid, please visit http://www.squid-cache.org

Squid 2.4 Configuration Manual

<<Back

TIMEOUTS

Tag Name connect_timeout
Usage connect_timeout seconds

Description
The time duration until which squid waits for the reply from the origin server. If it exceeds this squid will respond with the error message “Connection timed out” to the client

Default connect_timeout 120 seconds

Example
connect_timeout 180 seconds

Caution
Increasing the time here will lead to annoying of browser user.

 

Tag Name peer_connect_timeout
Usage peer_connect_timeout time-units

Description
This parameter specifies how long to wait for a pending TCP connection to a peer cache. The default is 30 seconds. You may also set different timeout values for individual neighbors with the 'connect-timeout' option on a 'cache_peer' line

Default peer_connect_timeout 30 seconds

Example
peer_connect_timeout 45 seconds

Caution
Setting of peer_connect_timeout to more than 30 seconds will be a performance issue.

 

Tag Name siteselect_timeout
Usage siteselect_timeout time-units

Description
Site select timeout is the timeout for URN to the multiple URLs selection. URN is a protocol designed for location-independent name resolution, specified in RFC 2169. This option configures the siteselect_timeout directive and defaults to 4 seconds. You do not need to change this.

Default siteselect_timeout 4 seconds

Example
siteselect_timeout 6 seconds

 

Tag Name read_timeout
Usage read_timeout time-units

Description
The read_timeout is applied on server-side connections. After each successful read(), the timeout will be extended by this amount. If no data is read again after this amount of time, the request is aborted and logged with ERR_READ_TIMEOUT. The default is 15 minutes.

Default read_timeout 15 minutes

Example
read_timeout 10 minutes

 

Tag Name request_timeout
Usage request_timeout seconds

Description
This tag specifies Squid the time in seconds to wait for an HTTP request after connection establishment. For persistent connections, Squid will wait this long after the previous request completes

Default request_timeout 30 seconds

Example
request_timeout 20 seconds

 

Tag Name client_lifetime
Usage client_lifetime time-units

Description
The maximum amount of time that a client (browser) is allowed to remain connected to the cache process. This protects the Cache from having a lot of sockets (and hence file descriptors) tied up in a CLOSE_WAIT state from remote clients that go away without properly shutting down (either because of a network failure or because of a poor client implementation). The default is one day, 1440 minutes

Default client_lifetime 1 day

Example
client_lifetime 1000 minutes

Caution
The default value is intended to be much larger than any client would ever need to be connected to your cache. You should probably change client_lifetime only as a last resort. If you seem to have many client connections tying up filedescriptors, we recommend first tuning the read_timeout, request_timeout, pconn_timeout and quick_abort values. If the more file descriptors are in use then the memory in use will also increase, which is also a performance issue.

 

Tag Name half_closed_clients
Usage half_closed_clients on|off

Description
Some clients may shutdown the sending side of their TCP connections, while leaving their receiving sides open. Sometimes, Squid cannot tell the difference between a half-closed and a fully-closed TCP connection. By default, half-closed client connections are kept open until a read(2) or write(2) on the socket returns an error. Change this option to 'off' and Squid will immediately close client connections when read (2) returns "no more data to read

Default half_closed_clients on

Example
half_closed_clients off

 

Tag Name pconn_timeout
Usage pconn_timeout seconds

Description
Persistent timeout is the timeout value for persistent connections. Squid closes persistent connections if they are idle for this amount of time. Persistent connections are disabled entirely if this option is set to a value less than 10 seconds. The default is 120 seconds and likely does not need to be changed.

Default pconn_timeout 120 seconds

Example
pconn_timeout 60 seconds

 

Tag Name ident_timeout
Usage ident_timeout seconds

Description
Maximum time to wait for IDENT requests. If this is too high, and you enabled 'ident_lookup', then you might be susceptible to denial-of-service by having many ident requests going at once. Only src type ACL checks are fully supported. An src_domainACL might work at times, but it will not always provide the correct result. This option may be disabled by using --disable-ident with the configure script

Default ident_timeout 10 seconds

Example
ident_timeout 5 seconds

 

Tag Name shutdown_lifetime
Usage shutdown_lifetime time-units

Description
When SIGTERM or SIGHUP is received, the cache is put into "shutdown pending" mode until all active sockets are closed. This value is the lifetime to set for all open descriptors during shutdown mode. Any active clients after this many seconds will receive a 'timeout' message

Default shutdown_lifetime 30 seconds

Example
shutdown_lifetime 45 seconds

Caution
If this time is set to be too low then some file descriptors may remain open which will be a performance issue in memory usage.

 

 

<<Back
 

All rights reserved.
All trademarks used in this document are owned by their respective companies. This document makes no ownership claim of any trademark(s). If you wish to have your trademark removed from this document, please contact the copyright holder. No disrespect is meant by any use of other companies? trademarks in this document.
Note: The pages on this website cannot be duplicated on to another site. Copying and usage of the contents for personal and corporate purposes is acceptable. In near future, it will be released under the GNU Free Documentation License.
 
 
Revision No:0.0  
Last Modified By: ViSolve Date: July 30 2006