Squid 3.0.STABLE10 release notes

From: Amos Jeffries Date: Sun, 9 Nov 2008 03:21:08 +0000 (+1300) Subject: 3.0 Release Notes updates X-Git-Tag: SQUID_3_0_STABLE11_RC1~5 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b862444e345856ca25297bd40944817b18e4abf9;p=thirdparty%2Fsquid.git 3.0 Release Notes updates Retrospective squid.conf diff against 2.7. --- diff --git a/doc/release-notes/release-3.0.html b/doc/release-notes/release-3.0.html index 2c2ad0d0d2..2bb746ff0d 100644 --- a/doc/release-notes/release-3.0.html +++ b/doc/release-notes/release-3.0.html @@ -1,7 +1,7 @@ - + Squid 3.0.STABLE10 release notes @@ -13,7 +13,52 @@ Squid is a WWW Cache application developed by the National Laboratory for Applied Network Research and members of the Web Caching community.

1. Notice

+ +

2. Known issues

+ +

3. Changes since earlier STABLE releases of Squid-3.0

+ +

4. Changes since Squid-2.6

+ +

4.1 Major new features +
4.2 2.6 features not found in Squid-3.0 +
4.3 Logging changes +

5. Windows support

+ +

6. Changes to squid.conf since Squid-2.6

+ +

6.1 New tags +
6.2 Changes to existing tags +
6.3 Removed tags +

7. Changes to ./configure Options since Squid-2.6

+ +

7.1 New options +
7.2 Changes to existing options +
7.3 Removed options +

8. Regressions since Squid-2.7

+ +

8.1 Missing squid.conf options available in Squid-2.7 +
8.2 Missing ./configure options available in Squid-2.7 +

+ +

1. Notice

The Squid Team are pleased to announce the release of Squid-3.0.STABLE10.

This new release is available for download from @@ -23,19 +68,19 @@ for Applied Network Research and members of the Web Caching community.

We welcome feedback and bug reports. If you find a bug, please see http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d for how to submit a report with a stack trace.

2. Known issues

Although this release is deemed good enough for use in many setups, please note the existence of open bugs against Squid-3.0.

3. Changes since earlier STABLE releases of Squid-3.0

The 3.0 change history can be viewed here.

4. Changes since Squid-2.6

4.1 Major new features +

4.1 Major new features

Squid 3.0 represents a major rewrite of Squid and has a number of new features.

@@ -87,7 +132,7 @@ to perform some simple XML based processing, offloading the final page assembly

More information about ESI can be found from the ESI website http://www.esi.org

4.2 2.6 features not found in Squid-3.0 +

4.2 2.6 features not found in Squid-3.0

Some of the features found in Squid-2.6 is not available in Squid-3. @@ -107,7 +152,7 @@ Some have been dropped as they are not needed. Some have not yet been forward-po

4.3 Logging changes +

4.3 Logging changes

access.log

@@ -123,7 +168,9 @@ Some have been dropped as they are not needed. Some have not yet been forward-po

See http://www.squid-cache.org/Doc/FAQ/FAQ-6.html#ss6.7 for a definition of all log types.

5. Windows support

+ + +

5. Windows support

This Squid version can run on Windows as a system service using the Cygwin emulation environment, or can be compiled in Windows native mode using the MinGW + MSYS development environment. Windows NT 4 SP4 and later are supported.
@@ -345,11 +392,11 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/" -

5.1 Changes to squid.conf -

6. Changes to squid.conf since Squid-2.6

There have been many changes to Squid's configuration file since Squid-2.6.

This section gives a thorough account of those changes in three categories:

+ +

This section gives a detailed account of those changes in three categories:

@@ -362,10 +409,8 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"
- - - -
New tags
+
6.1 New tags +
@@ -384,6 +429,7 @@ of a dynamic) timeout value. To set a fixed timeout see the
+
background_ping_rate
```
@@ -654,7 +700,8 @@ See the accf_http(9) man page.
 
 
 
- Changes to existing tags
+ 6.2 Changes to existing tags
+
 
 
 

@@ -677,21 +724,7 @@ See the accf_http(9) man page.
         
 
```
-
Removed options: -
```
-    urlgroup=, not yet ported to Squid-3.
-    
-    no-connection-auth, not yet ported to Squid-3.
-        
-
```
-
-
https_port
-
Removed options: -
```
-    urlgroup=, not yet ported to Squid-3.
-        
-
```
-
+
cache_peer
New options:
```
@@ -717,54 +750,19 @@ See the accf_http(9) man page.
      frequency of each parent being based on the round trip
      time. Closer parents are used more often.
      Usually used for background-ping parents.
-
         
 
```
-
Removed options: -
```
-    monitorurl, monitorsize etc, not yet ported to Squid-3
 
-    connection-auth=, not yet ported to Squid-3
-        
-
```
-
cache_dir
-
Common options -
```
-    no-store, replaces the older read-only option
-
-    min-size, not yet ported to Squid-3
-        
-
```
-
-
COSS file system: -
```
-    The coss file store is experimental, and still lacks much
-    of the functionality found in 2.6.
+Common options no-store, replaces the older read-only option
 
-    overwrite-percent=n, not yet ported to Squid-3.
-
-    max-stripe-waste=n, not yet ported to Squid-3.
-
-    membufs=n, not yet ported to Squid-3.
-
-    maxfullbufs=n, not yet ported to Squid-3.
-        
-
```
-
auth_param
Removed Basic auth option
```
     blankpasswor, not yet ported to squid-3.
     auth_param basic concurrency 0
         
-
```
-
-
Removed digest options: -
```
-    concurrency, not yet ported to Squid-3.
-        
 
```
@@ -775,14 +773,6 @@ See the accf_http(9) man page. %PATH Requested URL path - -
-
Removed format specifications: -
```
-    %ACL, not yet ported to Squid-3
-
-    %DATA, not yet ported to Squid-3
-        
 
```
New result keywords: @@ -817,17 +807,6 @@ See the accf_http(9) man page.
New types:
```
     acl aclname http_status 200 301 500- 400-403 ...     # status code in reply
-
-        
-
```
-
-
Removed types: -
```
-    acl aclname urllogin [-i] [^a-zA-Z0-9] ...      # regex matching on URL login field
-
-    acl urlgroup group1 ...
-        # match against the urlgroup as indicated by redirectors
-
         
 
```
@@ -906,7 +885,7 @@ See the accf_http(9) man page.
allow/deny no longer used.
url_rewrite_program
-
No urlgroup support in either requests or responese
+
No urlgroup support in either requests or response

auth_param

fake_auth helper for NTLM now accepts the '-S' parameter to strip NTLM domain off the username string. @@ -915,45 +894,28 @@ This is useful for class 4 Delay Pools in Squid 3.x
- - - -
Removed tags
+
6.3 Removed tags +

-
broken_vary_encoding
-
Not yet ported to Squid-3.
-
cache_vary
-
Not yet ported to Squid-3.
-
collapsed_forwarding
-
Not yet ported to Squid-3.
-
follow_x_forwarded_for
-
Not yet ported to Squid-3.
-
*_uses_indirect_client
-
Not yet ported to Squid-3.
-
error_map
-
Not yet ported to Squid-3.

header_access

This has been replaced by request_header_access and reply_header_access
-
http_access2
-
Not yet ported to Squid-3.
+
httpd_accel_no_pmtu_disc

Replaced by disable-pmtu-discovery http_port option
-
location_rewrite_*
-
Not yet ported to Squid-3.
-
refresh_stale_hit
-
Not yet ported to Squid-3.
+
wais_relay_*

equivalent to cache_peer + cache_peer_access.
+

-
5.2 Changes to ./configure Options -
+
7. Changes to ./configure Options since Squid-2.6

There have been some changes to Squid's build configuration since Squid-2.6.
+
This section gives an account of those changes in three categories:
- Changes to existing options
- -Not yet available options
- Removed options
-
New options
+
7.1 New options +

@@ -1084,7 +1045,8 @@ if it is not installed on your system.

-
Changes to existing options
+
7.2 Changes to existing options +

@@ -1127,25 +1089,8 @@ Automatic checks will enable best I/O loop method available.

-
Not yet available options
- -
These configure options have not yet been ported to Squid-3. If you need something to do then -porting one of these from Squid-2 to Squid-3 is most welcome.
-
-
-
--enable-devpoll
-
Support for Solaris /dev/poll
- -
--enable-select-simple
-
Basic POSIX select() loop without any binary fd_set optimizations.
- -
--enable-follow-x-forwarded-for
-
Support following the X-Forwarded-For HTTP header for determining the -client IP address
-
-
- -
Removed options
+
7.3 Removed options +

The following configure options have been removed.

@@ -1168,5 +1113,176 @@ client IP address

+ +
8. Regressions since Squid-2.7
+ +
Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.0
+ +
If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
+ +
8.1 Missing squid.conf options available in Squid-2.7 +
+ +
+
+
acl
+
urllogin option not yet ported from 2.6
+
urlgroup option not yet ported from 2.6
+ +
acl_uses_indirect_client
+
Not yet ported from 2.6
+ +
auth_param digest
+
concurrency option not yet ported from Squid-2
+ +
authenticate_ip_shortcircuit_access
+
Not yet ported from 2.7
+ +
authenticate_ip_shortcircuit_ttl
+
Not yet ported from 2.7
+ +
broken_vary_encoding
+
Not yet ported from 2.6
+ +
cache_dir
+
min-size option not yet ported from Squid-2
+
COSS storage type is lacking stability fixes from 2.6
+
COSS overwrite-percent= option not yet ported from 2.6
+
COSS max-stripe-waste= option not yet ported from 2.6
+
COSS membufs= option not yet ported from 2.6
+
COSS maxfullbufs= option not yet ported from 2.6
+ +
cache_peer
+
multicast-siblings not yet ported from 2.7
+
idle= not yet ported from 2.7
+
http11 not yet ported from 2.7
+
connection-auth= not yet ported from 2.6
+
monitorinterval= not yet ported from 2.6
+
monitorsize= not yet ported from 2.6
+
monitortimeout= not yet ported from 2.6
+
monitorurl= not yet ported from 2.6
+ +
cache_vary
+
Not yet ported from 2.6
+ +
collapsed_forwarding
+
Not yet ported from 2.6
+ +
delay_pool_uses_indirect_client
+
Not yet ported from 2.6
+ +
error_map
+
Not yet ported from 2.6
+ +
external_acl_type
+
%ACL format tag not yet ported from 2.6
+
%DATA format tag not yet ported from 2.6
+ +
external_refresh_check
+
Not yet ported from 2.7
+ +
follow_x_forwarded_for
+
Not yet ported from 2.6
+ +
http_access2
+
Not yet ported from 2.6
+ +
http_port
+
act-as-origin not yet ported from 2.7
+
allow-direct not yet ported from 2.7
+
http11 not yet ported from 2.7
+
urlgroup= not yet ported from 2.6
+
no-connection-auth not yet ported from 2.6
+ +
ignore_expect_100
+
Not yet ported from 2.7
+ +
ignore_ims_on_miss
+
Not yet ported from 2.7
+ +
location_rewrite_access
+
Not yet ported from 2.6
+ +
location_rewrite_children
+
Not yet ported from 2.6
+ +
location_rewrite_concurrency
+
Not yet ported from 2.6
+ +
location_rewrite_program
+
Not yet ported from 2.6
+ +
log_uses_indirect_client
+
Not yet ported from 2.6
+ +
logfile_daemon
+
Not yet ported from 2.7
+ +
logformat
+
%oa tag not yet ported from 2.7
+
%sn tag not yet ported from 2.7
+ +
max_filedescriptors
+
Not yet ported from 2.7
+ +
max_stale
+
Not yet ported from 2.7
+ +
refresh_pattern
+
stale-while-revalidate= not yet ported from 2.7
+
ignore-stale-while-revalidate= not yet ported from 2.7
+
max-stale= not yet ported from 2.7
+
negative-ttl= not yet ported from 2.7
+ +
refresh_stale_hit
+
Not yet ported from 2.7
+ +
server_http11
+
Not yet ported from 2.7
+ +
storeurl_access
+
Not yet ported from 2.7
+ +
storeurl_rewrite_children
+
Not yet ported from 2.7
+ +
storeurl_rewrite_concurrency
+
Not yet ported from 2.7
+ +
storeurl_rewrite_program
+
Not yet ported from 2.7
+ +
update_headers
+
Not yet ported from 2.7
+ +
upgrade_http0.9
+
Not yet ported from 2.7
+ +
zero_buffers
+
Not yet ported from 2.7
+ +
+
+ +
8.2 Missing ./configure options available in Squid-2.7 +
+ +
+
+
--enable-devpoll
+
Support for Solaris /dev/poll
+ +
--enable-select-simple
+
Basic POSIX select() loop without any binary fd_set optimizations.
+ +
--enable-follow-x-forwarded-for
+
Support following the X-Forwarded-For HTTP header for determining the +client IP address
+ +
--without-system-md5
+ +
+
+ diff --git a/doc/release-notes/release-3.0.sgml b/doc/release-notes/release-3.0.sgml index ae36bfcdad..723a906c55 100644 --- a/doc/release-notes/release-3.0.sgml +++ b/doc/release-notes/release-3.0.sgml @@ -109,6 +109,8 @@ Some have been dropped as they are not needed. Some have not yet been forward-po
The requested object was cached but STALE. The IMS query returned the new content.
See for a definition of all log types. + + Windows support
This Squid version can run on Windows as a system service using the Cygwin emulation environment, or can be compiled in Windows native mode using the MinGW + MSYS development environment. Windows NT 4 SP4 and later are supported. @@ -297,24 +299,19 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/" -Changes to squid.conf -
-There have been many changes to Squid's configuration file since Squid-2.6. +Changes to squid.conf since Squid-2.6 +
There have been many changes to Squid's configuration file since Squid-2.6. -This section gives a thorough account of those changes in three categories: +
This section gives a detailed account of those changes in three categories: -
- - -New tags - +New tags
minimum_icp_query_timeout (msec) @@ -329,6 +326,7 @@ value. Do NOT use this option to always use a fixed (instead of a dynamic) timeout value. To set a fixed timeout see the 'icp_query_timeout' directive. + background_ping_rate Default: 10 seconds @@ -541,7 +539,7 @@ See the accf_http(9) man page. -Changes to existing tags +Changes to existing tags
http_port @@ -561,17 +559,7 @@ See the accf_http(9) man page. certain clients sporadically hang or never complete requests set disable-pmtu-discovery option to 'transparent'. -
Removed options: - - urlgroup=, not yet ported to Squid-3. - - no-connection-auth, not yet ported to Squid-3. - - https_port -
Removed options: - - urlgroup=, not yet ported to Squid-3. - + cache_peer
New options: @@ -597,44 +585,17 @@ See the accf_http(9) man page. frequency of each parent being based on the round trip time. Closer parents are used more often. Usually used for background-ping parents. - -
Removed options: - - monitorurl, monitorsize etc, not yet ported to Squid-3 - connection-auth=, not yet ported to Squid-3 - cache_dir -
Common options - - no-store, replaces the older read-only option - - min-size, not yet ported to Squid-3 - -
COSS file system: - - The coss file store is experimental, and still lacks much - of the functionality found in 2.6. - - overwrite-percent=n, not yet ported to Squid-3. - - max-stripe-waste=n, not yet ported to Squid-3. - - membufs=n, not yet ported to Squid-3. +
Common options no-store, replaces the older read-only option - maxfullbufs=n, not yet ported to Squid-3. - auth_param
Removed Basic auth option blankpasswor, not yet ported to squid-3. auth_param basic concurrency 0 -
Removed digest options: - - concurrency, not yet ported to Squid-3. - external_acl_type
New format specifications: @@ -642,12 +603,6 @@ See the accf_http(9) man page. %URI Requested URI %PATH Requested URL path - -
Removed format specifications: - - %ACL, not yet ported to Squid-3 - - %DATA, not yet ported to Squid-3
New result keywords: @@ -677,15 +632,6 @@ See the accf_http(9) man page.
New types: acl aclname http_status 200 301 500- 400-403 ... # status code in reply - - -
Removed types: - - acl aclname urllogin [-i] [^a-zA-Z0-9] ... # regex matching on URL login field - - acl urlgroup group1 ... - # match against the urlgroup as indicated by redirectors - short_icon_urls @@ -748,7 +694,7 @@ See the accf_http(9) man page.
allow/deny no longer used. url_rewrite_program -
No urlgroup support in either requests or responese +
No urlgroup support in either requests or response auth_param
fake_auth helper for NTLM now accepts the '-S' parameter to strip NTLM domain off the username string. @@ -756,55 +702,35 @@ See the accf_http(9) man page. - - - -Removed tags +Removed tags
- broken_vary_encoding -
Not yet ported to Squid-3. - cache_vary -
Not yet ported to Squid-3. - collapsed_forwarding -
Not yet ported to Squid-3. - follow_x_forwarded_for -
Not yet ported to Squid-3. - *_uses_indirect_client -
Not yet ported to Squid-3. - error_map -
Not yet ported to Squid-3. header_access
This has been replaced by request_header_access and reply_header_access - http_access2 -
Not yet ported to Squid-3. + httpd_accel_no_pmtu_disc
Replaced by disable-pmtu-discovery http_port option - location_rewrite_* -
Not yet ported to Squid-3. - refresh_stale_hit -
Not yet ported to Squid-3. + wais_relay_*
equivalent to cache_peer + cache_peer_access. + -Changes to ./configure Options -
-There have been some changes to Squid's build configuration since Squid-2.6. +Changes to ./configure Options since Squid-2.6 +
There have been some changes to Squid's build configuration since Squid-2.6. -This section gives an account of those changes in three categories: +
This section gives an account of those changes in three categories: -
-New options +New options
@@ -915,7 +841,7 @@ This section gives an account of those changes in three categories:
-Changes to existing options +Changes to existing options
@@ -959,24 +885,8 @@ This section gives an account of those changes in three categories:
-Not yet available options -
These configure options have not yet been ported to Squid-3. If you need something to do then -porting one of these from Squid-2 to Squid-3 is most welcome. - - - --enable-devpoll -
Support for Solaris /dev/poll
- - --enable-select-simple -
Basic POSIX select() loop without any binary fd_set optimizations.
- - --enable-follow-x-forwarded-for -
Support following the X-Forwarded-For HTTP header for determining the - client IP address
- - -Removed options +Removed options
The following configure options have been removed. @@ -998,4 +908,169 @@ porting one of these from Squid-2 to Squid-3 is most welcome. + +Regressions since Squid-2.7 + +
Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.0 + +
If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome. + +Missing squid.conf options available in Squid-2.7 +
+ + acl +
urllogin option not yet ported from 2.6 +
urlgroup option not yet ported from 2.6 + + acl_uses_indirect_client +
Not yet ported from 2.6 + + auth_param digest +
concurrency option not yet ported from Squid-2 + + authenticate_ip_shortcircuit_access +
Not yet ported from 2.7 + + authenticate_ip_shortcircuit_ttl +
Not yet ported from 2.7 + + broken_vary_encoding +
Not yet ported from 2.6 + + cache_dir +
min-size option not yet ported from Squid-2 +
COSS storage type is lacking stability fixes from 2.6 +
COSS overwrite-percent= option not yet ported from 2.6 +
COSS max-stripe-waste= option not yet ported from 2.6 +
COSS membufs= option not yet ported from 2.6 +
COSS maxfullbufs= option not yet ported from 2.6 + + cache_peer +
multicast-siblings not yet ported from 2.7 +
idle= not yet ported from 2.7 +
http11 not yet ported from 2.7 +
connection-auth= not yet ported from 2.6 +
monitorinterval= not yet ported from 2.6 +
monitorsize= not yet ported from 2.6 +
monitortimeout= not yet ported from 2.6 +
monitorurl= not yet ported from 2.6 + + cache_vary +
Not yet ported from 2.6 + + collapsed_forwarding +
Not yet ported from 2.6 + + delay_pool_uses_indirect_client +
Not yet ported from 2.6 + + error_map +
Not yet ported from 2.6 + + external_acl_type +
%ACL format tag not yet ported from 2.6 +
%DATA format tag not yet ported from 2.6 + + external_refresh_check +
Not yet ported from 2.7 + + follow_x_forwarded_for +
Not yet ported from 2.6 + + http_access2 +
Not yet ported from 2.6 + + http_port +
act-as-origin not yet ported from 2.7 +
allow-direct not yet ported from 2.7 +
http11 not yet ported from 2.7 +
urlgroup= not yet ported from 2.6 +
no-connection-auth not yet ported from 2.6 + + ignore_expect_100 +
Not yet ported from 2.7 + + ignore_ims_on_miss +
Not yet ported from 2.7 + + location_rewrite_access +
Not yet ported from 2.6 + + location_rewrite_children +
Not yet ported from 2.6 + + location_rewrite_concurrency +
Not yet ported from 2.6 + + location_rewrite_program +
Not yet ported from 2.6 + + log_uses_indirect_client +
Not yet ported from 2.6 + + logfile_daemon +
Not yet ported from 2.7 + + logformat +
%oa tag not yet ported from 2.7 +
%sn tag not yet ported from 2.7 + + max_filedescriptors +
Not yet ported from 2.7 + + max_stale +
Not yet ported from 2.7 + + refresh_pattern +
stale-while-revalidate= not yet ported from 2.7 +
ignore-stale-while-revalidate= not yet ported from 2.7 +
max-stale= not yet ported from 2.7 +
negative-ttl= not yet ported from 2.7 + + refresh_stale_hit +
Not yet ported from 2.7 + + server_http11 +
Not yet ported from 2.7 + + storeurl_access +
Not yet ported from 2.7 + + storeurl_rewrite_children +
Not yet ported from 2.7 + + storeurl_rewrite_concurrency +
Not yet ported from 2.7 + + storeurl_rewrite_program +
Not yet ported from 2.7 + + update_headers +
Not yet ported from 2.7 + + upgrade_http0.9 +
Not yet ported from 2.7 + + zero_buffers +
Not yet ported from 2.7 + + + +Missing ./configure options available in Squid-2.7 +
+ + --enable-devpoll +
Support for Solaris /dev/poll
+ + --enable-select-simple +
Basic POSIX select() loop without any binary fd_set optimizations.
+ + --enable-follow-x-forwarded-for +
Support following the X-Forwarded-For HTTP header for determining the + client IP address
+ + --without-system-md5 + + +

4.1 Major new features +

4.2 2.6 features not found in Squid-3.0 +

4.3 Logging changes +

access.log

5.1 Changes to squid.conf -

New tags

6.1 New tags +

Changes to existing tags

6.2 Changes to existing tags +

Removed tags

6.3 Removed tags +

5.2 Changes to ./configure Options -

New options

7.1 New options +

Changes to existing options

7.2 Changes to existing options +

Not yet available options

Removed options

7.3 Removed options +

8.1 Missing squid.conf options available in Squid-2.7 +

8.2 Missing ./configure options available in Squid-2.7 +