The Squid Team are pleased to announce the release of Squid-3.2.7 for
testing.
-This new release is available for download from <url url="http://www.squid-cache.org/Versions/v3/3.2/"> or the <url url="http://www.squid-cache.org/Mirrors/http-mirrors.html" name="mirrors">.
+This new release is available for download from <url url="http://www.squid-cache.org/Versions/v3/3.2/"> or the
+ <url url="http://www.squid-cache.org/Mirrors/http-mirrors.html" name="mirrors">.
While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.
<sect1>Known issues
<p>
-Although this release is deemed good enough for use in many setups, please note the existence of <url url="http://bugs.squid-cache.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&target_milestone=3.2&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=bugs.bug_severity&field0-0-0=noop&type0-0-0=noop&value0-0-0=" name="open bugs against Squid-3.2">.
+Although this release is deemed good enough for use in many setups, please note the existence of
+<url url="http://bugs.squid-cache.org/buglist.cgi?query_format=advanced&product=Squid&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&version=3.2" name="open bugs against Squid-3.2">.
<p>Some issues to note as currently known in this release which are not able to be fixed in the 3.2 series are:
DNS lookups to locate alternative DIRECT destinations will not be done.
<p>Known Issue: When non-strict validation fails Squid will relay the request, but can only do
- so safely to the orginal destination IP the client was contacting. The client original
+ so safely to the original destination IP the client was contacting. The client original
destination IP is lost when relaying to peers in a hierarchy. This means the upstream peers
are still at risk of causing same-origin bypass CVE-2009-0801 vulnerability.
Developer time is required to implement safe transit of these requests.
path and parameters as its own command parameters. The <em>concurrency</em> setting already
existing in Squid is used to configure how many child helpers it may run.
-<p>For example, a traditional configration is
+<p>For example, a traditional configuration is
<verb>
url_rewrite_program /your/redirector.sh
url_rewrite_children 5
<p>The on-demand helpers feature allows greater flexibility and resolves this problem by allowing
maximum, initial and idle thresholds to be configured. Squid will start the initial set during
start and reconfigure phases. However over the operational use new helpers up to the maxium will
- be started as load demands. The idle threshold determins how many more helpers to start if the
+ be started as load demands. The idle threshold determines how many more helpers to start if the
currently running set is not enough to handle current request loads.
-<p>For example, a traditional configration is
+<p>For example, a traditional configuration is
<verb>
auth_param ntlm /usr/libexec/squid/ntlm_auth
auth_param ntlm children 200
<sect2>External ACL helpers
<p><itemize>
<item>mswin_check_ad_group - ext_ad_group_acl - Check logged in users Group membership using Active Directory.
- <item>ip_user_check - ext_file_userip_acl - Restrict users to cetain IP addresses, using a text file backend.
+ <item>ip_user_check - ext_file_userip_acl - Restrict users to certain IP addresses, using a text file backend.
<item>squid_kerb_ldap - ext_kerberos_ldap_group_acl - Check logged in Kerberos or NTLM users Group membership using LDAP.
<item>squid_ldap_group - ext_ldap_group_acl - Check logged in users Group membership using LDAP.
<item>mswin_check_lm_group - ext_lm_group_acl - Check logged in users Group membership using LanManager.
<sect1>Solaris 10 pthreads Support (Experimental)
<p>Automatic detection and use of the pthreads library available from Solaris 10
-<p>The result of this addition means that faster more efficient AUFS cache storage mechanisims
- are now available in Solaris 10.
+<p>The result of this addition means that faster more efficient AUFS cache storage mechanism
+ is now available in Solaris 10.
<p>Support is experimental at this stage due to lack of feedback on the results of enabling it.
We recommend giving AUFS a try for faster disk storage and encourage feedback.
feature support in Squid. This release opens Surrogate support to all reverse proxies.
<p>Reverse proxy requests sent on to the web server include the HTTP header <em>Surrogate-Capabilities:</em>
- specifying the capabilities of the reverse proxy along with an ID which can be used to target reponses with
+ specifying the capabilities of the reverse proxy along with an ID which can be used to target responses with
a <em>Surrogate-Control:</em> HTTP header used instead of the <em>Cache-Control:</em> header.
<p>The default surrogate ID is generated automatically from the Squid site-unique hostname as found by the
automatic detection or manual configuration of <em>visible_hostname</em> although can be configured
separately with the <em>httpd_accel_surrogate_id</em> option.
-<p><em>Security Considerations:</em> Websites sould be careful of accepting any surrogate ID.
+<p><em>Security Considerations:</em> Websites should be careful of accepting any surrogate ID.
Older releases of Squid leak the Surrogate-Control headers to external servers.
This 3.2 series of Squid will now prevent this leakage of its own ID destined responses, however it is possible
and for some uses desirable to receive external reverse-proxies <em>Surrogate-Capabilities:</em> headers.
<itemize>
<item>should contain a complete HTML page, with optional client-side scripting.
<item>must not contain server-side scripting.
- <item>will have macro substitution performed on it using the same macros as used by the error page tempates.
+ <item>will have macro substitution performed on it using the same macros as used by the error page templates.
</itemize>
<p>Version 3.2 of the CGI cache manager tool now presents XHR scripted probes to detect
headers or eCAP options to Squid ICAP requests or eCAP transactions.
<tag>adaptation_send_client_ip</tag>
- <p>Same as depricated icap_send_client_ip
+ <p>Same as deprecated icap_send_client_ip
but applies to both ICAP and eCAP.</p>
<tag>adaptation_send_username</tag>
- <p>Same as depricated icap_send_client_username
+ <p>Same as deprecated icap_send_client_username
but applies to both ICAP and eCAP.</p>
<tag>adaptation_uses_indirect_client</tag>
- <p>Same as depricated icap_uses_indirect_client
+ <p>Same as deprecated icap_uses_indirect_client
but applies to both ICAP and eCAP.</p>
<tag>client_delay_pools</tag>
- <p>New setting for client bandwith limits to specifies the number
+ <p>New setting for client bandwidth limits to specifies the number
of client delay pools used.
<tag>client_delay_initial_bucket_level</tag>
- <p>New setting for client bandwith limits to determine the initial
+ <p>New setting for client bandwidth limits to determine the initial
bucket size as a percentage of max_bucket_size from
client_delay_parameters.
<tag>client_delay_parameters</tag>
- <p>New setting for client bandwith limits to configures client-side
+ <p>New setting for client bandwidth limits to configures client-side
bandwidth limits.
<tag>client_delay_access</tag>
- <p>New setting for client bandwith limits to determines the
+ <p>New setting for client bandwidth limits to determines the
client-side delay pool for the request.
<tag>client_dst_passthru</tag>
New installs, or installs with no logs configured explicitly will use this module by default.
<p>New <em>tcp</em> module to send each log line as text data to a TCP receiver.
<p>New <em>udp</em> module to send each log line as text data to a UDP receiver.
- <p>New format <em>referrer</em> to log with the format prevously used by referer_log directive.
- <p>New format <em>useragent</em> to log with the format prevously used by useragent_log directive.
+ <p>New format <em>referrer</em> to log with the format previously used by referer_log directive.
+ <p>New format <em>useragent</em> to log with the format previously used by useragent_log directive.
<tag>acl : random, localip, localport</tag>
<p>New type <em>random</em>. Pseudo-randomly match requests based on a configured probability.
<tag>auth_param</tag>
<p>New options for Basic, Digest, NTLM, Negotiate <em>children</em> settings.
- <em>startup=N</em> determins minimum number of helper processes used.
+ <em>startup=N</em> determines minimum number of helper processes used.
<em>idle=N</em> determines how many helper to retain as buffer against sudden traffic loads.
<em>concurrency=N</em> previously called <em>auth_param ... concurrency</em> as a separate option.
<p>Removed Basic, Digest, NTLM, Negotiate <em>auth_param ... concurrency</em> setting option.
<p><em>%SRCEUI64</em> EUI-64 of clients with SLAAC address.
<p><em>%EXT_LOG</em> log= message returned by previous external ACL calls. An updated version may be returned.
<p><em>%EXT_TAG</em> tag= value returned by previous external ACL calls. Tag may not be altered once set.
- <p><em>children-max=N</em> determins maximum number of helper processes used.
- <p><em>children-startup=N</em> determins minimum number of helper processes used.
+ <p><em>children-max=N</em> determines maximum number of helper processes used.
+ <p><em>children-startup=N</em> determines minimum number of helper processes used.
<p><em>children-idle=N</em> determines how many helper to retain as buffer against sudden traffic loads.
<p>Deprecated <em>children=N</em> in favor of <em>children-max=N</em>.
<tag>server_http11</tag>
<p>Obsolete.
+ <tag>update_headers</tag>
+ <p>Obsolete. The experimental actions enabled in 2.7 by this option have been integrated as default
+ actions for the <em>rock</em> storage type and memory caches.
+ The configuration option is no longer necessary and has been dropped.
+ NOTE: It is not yet supported by <em>ufs</em>, <em>aufs</em>, or <em>diskd</em> storage.
+
<tag>upgrade_http0.9</tag>
<p>Obsolete.
<tag>storeurl_rewrite_program</tag>
<p>Not yet ported from 2.7
- <tag>update_headers</tag>
- <p>Not yet fully ported from 2.7. Memory and rock storage caches support this natively. UFS caches do not support it.
-
</descrip>
</article>
NAME: dns_v4_fallback
TYPE: obsolete
DOC_START
- Remove this line.
+ Remove this line. Squid performs a 'Happy Eyeballs' algorithm, the 'fallback' algorithm is no longer relevant.
DOC_END
NAME: ftp_list_width
Replaced by connect_retries. The behaviour has changed, please read the documentation before altering.
DOC_END
+NAME: update_headers
+TYPE: obsolete
+DOC_START
+ Remove this line. The feature is supported by default in storage types where update is implemented.
+DOC_END
+
NAME: url_rewrite_concurrency
TYPE: obsolete
DOC_START
auth_param basic program @DEFAULT_PREFIX@/libexec/ncsa_auth @DEFAULT_PREFIX@/etc/passwd
"utf8" on|off
- HTTP uses iso-latin-1 as characterset, while some authentication
+ HTTP uses iso-latin-1 as character set, while some authentication
backends such as LDAP expects UTF-8. If this is set to on Squid will
translate the HTTP iso-latin-1 charset to UTF-8 before sending the
username & password to the helper.
supports one request at a time. Setting this to a number greater than
0 changes the protocol used to include a channel number first on the
request/response line, allowing multiple requests to be sent to the
- same helper in parallell without wating for the response.
+ same helper in parallel without waiting for the response.
Must not be set unless it's known the helper supports this.
auth_param basic children 20 startup=0 idle=1
auth_param digest program @DEFAULT_PREFIX@/bin/digest_pw_auth @DEFAULT_PREFIX@/etc/digpass
"utf8" on|off
- HTTP uses iso-latin-1 as characterset, while some authentication
+ HTTP uses iso-latin-1 as character set, while some authentication
backends such as LDAP expects UTF-8. If this is set to on Squid will
translate the HTTP iso-latin-1 charset to UTF-8 before sending the
username & password to the helper.
supports one request at a time. Setting this to a number greater than
0 changes the protocol used to include a channel number first on the
request/response line, allowing multiple requests to be sent to the
- same helper in parallell without wating for the response.
+ same helper in parallel without waiting for the response.
Must not be set unless it's known the helper supports this.
auth_param digest children 20 startup=0 idle=1
"nonce_strictness" on|off
Determines if squid requires strict increment-by-1 behavior
for nonce counts, or just incrementing (off - for use when
- useragents generate nonce counts that occasionally miss 1
+ user agents generate nonce counts that occasionally miss 1
(ie, 1,2,4,6)). Default off.
"check_nonce_count" on|off
The maximum number of authenticator processes to spawn (default 5).
If you start too few Squid will have to wait for them to
process a backlog of credential verifications, slowing it
- down. When crendential verifications are done via a (slow)
+ down. When credential verifications are done via a (slow)
network you are likely to need lots of authenticator
processes.
LOC: Config.authenticateGCInterval
DOC_START
The time period between garbage collection across the username cache.
- This is a tradeoff between memory utilization (long intervals - say
+ This is a trade-off between memory utilization (long intervals - say
2 days) and CPU (short intervals - say 1 minute). Only change if you
have good reason to.
DOC_END
this directive controls how long Squid remembers the IP
addresses associated with each user. Use a small value
(e.g., 60 seconds) if your users might change addresses
- quickly, as is the case with dialups. You might be safe
+ quickly, as is the case with dialup. You might be safe
using a larger value (e.g., 2 hours) in a corporate LAN
environment with relatively static address assignments.
DOC_END