From c4a0c2a9733392a10d41d5f0d4baaa7b07ee12fe Mon Sep 17 00:00:00 2001 From: Amos Jeffries Date: Mon, 1 Feb 2010 14:56:03 +1300 Subject: [PATCH] Prep for 3.1.0.16 --- ChangeLog | 17 ++ doc/release-notes/release-3.1.html | 305 ++++------------------------- doc/release-notes/release-3.1.sgml | 4 +- 3 files changed, 55 insertions(+), 271 deletions(-) diff --git a/ChangeLog b/ChangeLog index ea6ae35bb1..dbb4c7feda 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,20 @@ +Changes to squid-3.1.0.16 (01 Feb 2010): + + - Regression Fix: Make Squid abort on all config parse failures. + - Regression Bug 2811: SNMP client/peer table OID numbering + - Bug 2851: Connection pinning fails when using a peer + - Bug 2850: Mismatch in hier_code enum / hier_strings array + - Bug 2731: Add follow_x_forwarded_for support to ICAP + - Bug 2730: Regressions in follow_x_forwarded_for since Squid-2 + - Bug 2706: Set timestamps during ICAP request satisfaction. + - Bug 2553: X-Forwarded-For with IPv6 address not handled correctly + - Fix: WCCPv1 not connecting to router correctly + - Remove obsolete RunCache/RunAccel scripts. + - Add client_ip_max_connections + - Add the http::>ha format code and make http::>h log original request headers + - ... and all bug fixes from 3.0 up to 3.0.STABLE22 + - ... and many more minor build and display annoyances. + Changes to squid-3.1.0.15 (23 Nov 2009): - Regression Fix: myip ACL not accepted in config diff --git a/doc/release-notes/release-3.1.html b/doc/release-notes/release-3.1.html index 37b21f223a..3cfb5f488e 100644 --- a/doc/release-notes/release-3.1.html +++ b/doc/release-notes/release-3.1.html @@ -1,11 +1,11 @@ - - Squid 3.1.0.15 release notes + + Squid 3.1.0.16 release notes -

Squid 3.1.0.15 release notes

Squid 3.1.0.16 release notes

Squid Developers

@@ -36,53 +36,41 @@ for Applied Network Research and members of the Web Caching community.

2.10 ICY streaming protocol support

3. Windows support

3. Changes to squid.conf since Squid-3.0

3.1 Usage -
3.2 PSAPI.DLL (Process Status Helper) Considerations -
3.3 Registry DNS lookup -
3.4 Compatibility Notes -
3.5 Known Limitations -
3.6 Building Squid on Windows -
3.7 Using cache manager on Windows: +
3.1 New tags +
3.2 Changes to existing tags +
3.3 Removed tags

4. Changes to squid.conf since Squid-3.0

4. Changes to ./configure options since Squid-3.0

4.1 New tags -
4.2 Changes to existing tags -
4.3 Removed tags +
4.1 New options +
4.2 Changes to existing options +
4.3 Removed options

5. Changes to ./configure options since Squid-3.0

5. Options Removed since Squid-2

5.1 New options -
5.2 Changes to existing options -
5.3 Removed options +
5.1 Removed squid.conf options since Squid-2.7 +
5.2 Removed squid.conf options since Squid-2.6 +
5.3 Removed ./configure options since Squid-2.7

6. Options Removed since Squid-2

6. Regressions since Squid-2.7

6.1 Removed squid.conf options since Squid-2.7 -
6.2 Removed squid.conf options since Squid-2.6 -
6.3 Removed ./configure options since Squid-2.7 -

7. Regressions since Squid-2.7

- -

7.1 Missing squid.conf options available in Squid-2.7 -
7.2 Missing ./configure options available in Squid-2.7 +
6.1 Missing squid.conf options available in Squid-2.7 +
6.2 Missing ./configure options available in Squid-2.7

1. Notice

The Squid Team are pleased to announce the release of Squid-3.1.0.15 for testing.

The Squid Team are pleased to announce the release of Squid-3.1.0.16 for testing.

This new release is available for download from http://www.squid-cache.org/Versions/v3/3.1/ or the mirrors.

@@ -425,230 +413,7 @@ unusual replies. This option is now obsolete.

is only aware on an HTTP request. So the ACL will match HTTP.

3. 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.
-On Windows 2000 and later the service is configured to use the Windows Service Recovery option -restarting automatically after 60 seconds.

- -

3.1 Usage -

- -

Some new command line options were added for the Windows service support:

- -

The service installation is made with -i command line switch, it's possible to use -f switch at -the same time for specify a different config-file settings for the Squid Service that will be -stored on the Windows Registry.

- -

A new -n switch specify the Windows Service Name, so multiple Squid instance are allowed. -"Squid" is the default when the switch is not used.

- -

So, to install the service, the syntax is:

-squid -i [-f file] [-n name]
-

- -

Service uninstallation is made with -r command line switch with the appropriate -n switch.

- -

The -k switch family must be used with the appropriate -f and -n switches, so the syntax is:

-squid -k command [-f file] -n service-name
-

- -where service-name is the name specified with -n options at service install time.

- -

To use the Squid original command line, the new -O switch must be used ONCE, the syntax is:

-squid -O cmdline [-n service-name]
-

If multiple service command line options must be specified, use quote. The -n switch is -needed only when a non default service name is in use.

- -

Don't use the "Start parameters" in the Windows 2000/XP/2003 Service applet: they are -specific to Windows services functionality and Squid is not designed for understand they.

- -

In the following example the command line of the "squidsvc" Squid service is set to "-D -u 3130":

-squid -O "-D -u 3130" -n squidsvc
-

- -

3.2 PSAPI.DLL (Process Status Helper) Considerations -

- -

The process status helper functions make it easier for you to obtain information about -processes and device drivers running on Microsoft® Windows NT®/Windows® 2000. These -functions are available in PSAPI.DLL, which is distributed in the Microsoft® Platform -Software Development Kit (SDK). The same information is generally available through the -performance data in the registry, but it is more difficult to get to it. PSAPI.DLL is -freely redistributable.

- -

PSAPI.DLL is available only on Windows NT, 2000, XP and 2003. The implementation in Squid is -aware of this, and try to use it only on the right platform.

- -

On Windows NT PSAPI.DLL can be found as component of many applications, if you need it, -you can find it on Windows NT Resource KIT. If you have problem, it can be -downloaded from here: -http://download.microsoft.com/download/platformsdk/Redist/4.0.1371.1/NT4/EN-US/psinst.EXE

- -

On Windows 2000 and later it is available installing the Windows Support Tools, located on the -Support\Tools folder of the installation Windows CD-ROM.

- -

3.3 Registry DNS lookup -

- -

On Windows platforms, if no value is specified in the dns_nameservers option on -squid.conf or in the /etc/resolv.conf file, the list of DNS name servers are -taken from the Windows registry, both static and dynamic DHCP configurations -are supported.

- -

3.4 Compatibility Notes -

- -

It's recommended to use '/' char in Squid paths instead of '\'
Paths with spaces (like 'C:\Programs Files\Squid) are NOT supported by Squid
When using ACL like 'acl aclname acltype "file"' the file must be in DOS text -format (CR+LF) and the full Windows path must be specified, for example: - -
```
-acl blocklist url_regex -i "c:/squid/etc/blocked1.txt"
-
```
- -
The Windows equivalent of '/dev/null' is 'NUL'
Squid doesn't know how to run external helpers based on scripts, like .bat, .cmd, -.vbs, .pl, etc. So in squid.conf the interpreter path must be always specified, for example: - -
```
-redirect_program c:/perl/bin/perl.exe c:/squid/libexec/redir.pl
-redirect_program c:/winnt/system32/cmd.exe /C c:/squid/libexec/redir.cmd
-
```
-
When Squid runs in command line mode, the launching user account must have administrative privilege on the system
"Start parameters" in the Windows 2000/XP/2003 Service applet cannot be used
On Windows Vista and later, User Account Control (UAC) must be disabled before running service installation

- - -

3.5 Known Limitations -

- -

Squid features not operational:
-
- DISKD: still needs to be ported
- WCCP: cannot work because user space GRE support on Windows is missing
- Transparent Proxy: missing Windows non commercial interception driver
-
Some code sections can make blocking calls.
Some external helpers may not work.
File Descriptors number hard-limited to 2048 when building with MinGW.

- -

3.6 Building Squid on Windows -

- -

A reasonably recent release of -Cygwin or -MinGW is needed.
-The usage of the Cygwin environment is very similar to other Unix/Linux environments, and -devel version of libraries must be installed.
-For the MinGW environment, the packages MSYS, MinGW and msysDTK must be installed. Some additional libraries and tools must be downloaded separately:

-OpenSSL: -Shining Light Productions Win32 OpenSSL
-libcrypt: -MinGW packages repository
-db-1.85: -TinyCOBOL download area
-When running configure, --disable-wccp and --disable-wccpv2 options should always specified to avoid compile errors.
-

New configure options:
-
- --enable-win32-service
-
Updated configure options:
-
- --enable-arp-acl
- --enable-default-hostsfile
-
Unsupported configure options:
-
- --enable-coss-aio-ops: On Windows Posix AIO is not available
- --with-large-files: No suitable build environment is available on both Cygwin and MinGW, but --enable-large-cache-files works fine
-
Recommended configure minimal options for Windows:
-
- --prefix=c:/squid --disable-wccp --disable-wccpv2 --enable-win32-service --enable-default-hostsfile=none
-

-
-Before build Squid with SSL support, some operations are needed (in the following example OpenSSL is installed in C:\OpenSSL and MinGW in C:\MinGW): -

Copy C:\OpenSSL\lib\MinGW content to C:\MinGW\lib
Copy C:\OpenSSL\include\openssl content to C:\MinGW\include\openssl
Rename C:\MinGW\lib\ssleay32.a to C:\MinGW\lib\libssleay32.a

- -

3.7 Using cache manager on Windows: -

- -

On Windows, cache manager (cachemgr.cgi) can be used with Microsoft IIS or Apache.
-Some specific configuration could be needed:
-

IIS 6 (Windows 2003):
-
- On IIS 6.0 all CGI extensions are denied by default for security reason, so the following configuration is needed:
  -
  - Create a cgi-bin Directory
  - Define the cgi-bin IIS Virtual Directory with read and CGI execute IIS -permissions, ASP scripts are not needed. This automatically defines a -cgi-bin IIS web application
  - Copy cachemgr.cgi into cgi-bin directory and look to file permissions: -the IIS system account and SYSTEM must be able to read and execute the file
  - In IIS manager go to Web Service extensions and add a new Web Service -Extension called "Squid Cachemgr", add the cachemgr.cgi file and set the -extension status to Allowed
  -
-

Apache:
-

On Windows, cachemgr.cgi needs to create a temporary file, so Apache must be instructed -to pass the TMP and TEMP Windows environment variables to CGI applications:
-

-ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/"
-<Location /squid/cgi-bin/cachemgr.cgi>
-    PassEnv TMP TEMP
-    Order allow,deny
-    Allow from workstation.example.com
-</Location>
-

- - -

4. Changes to squid.conf since Squid-3.0

3. Changes to squid.conf since Squid-3.0

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

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

@@ -665,7 +430,7 @@ ScriptAlias /squid/cgi-bin/ "c:/squid/libexec/" -

4.1 New tags +

3.1 New tags

@@ -1288,7 +1053,7 @@ DEFAULT: None bypassed.

4.2 Changes to existing tags +

3.2 Changes to existing tags

@@ -1539,11 +1304,13 @@ For now option 'tproxy' remains with old behaviour meaning fully-invisible proxy

logformat

New log format tag sets %icap::* %adapt::* for adaptation information. %Hs tag deprecated and replaced by request/reply specific >Hs and <Hs +new %>ha option to log HTTP request headers after adaptation and redirection. HTTP request/reply format tags may now be optionally prefixed with http::. Old forms will be deprecated in some as yet undecided future release.

                 dt              Total time spent making DNS lookups (milliseconds)
 
+                [http::]>ha     The HTTP request headers after adaptation and redirection.
                 [http::]>Hs     HTTP status code sent to the client
                 [http::]<Hs  HTTP status code received from the next hop
                 [http::]>sh     Received HTTP request headers size
@@ -1674,7 +1441,7 @@ refresh_pattern .                    0   20%     4320
 
 
 
- 4.3 Removed tags
+
 3.3 Removed tags
 
 
 
@@ -1697,7 +1464,7 @@ The -D command line option used previously to suppress these tests is also obsol
 
 
 
-5. Changes to ./configure options since Squid-3.0
+4. Changes to ./configure options since Squid-3.0
 
 There have been some changes to Squid's build configuration since Squid-3.0.
 This section gives an account of those changes in three categories:
@@ -1713,7 +1480,7 @@ The -D command line option used previously to suppress these tests is also obsol
 
 
 
- 5.1 New options
+
 4.1 New options
 
 
 
@@ -1797,7 +1564,7 @@ Default is to automatically detect the binary.
 
 
 
- 5.2 Changes to existing options
+
 4.2 Changes to existing options
 
 
 
@@ -1832,7 +1599,7 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
- 5.3 Removed options
+
 4.3 Removed options
 
 
 
@@ -1849,11 +1616,11 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
-6. Options Removed since Squid-2
+5. Options Removed since Squid-2
 
 Some squid.conf and ./configure options which were available in Squid-2.6 and Squid-2.7 are made obsolete in Squid-3.1.
 
-6.1 Removed squid.conf options since Squid-2.7
+
5.1 Removed squid.conf options since Squid-2.7
 
 
 
@@ -1902,7 +1669,7 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
-6.2 Removed squid.conf options since Squid-2.6
+
5.2 Removed squid.conf options since Squid-2.6
 
 
 
@@ -1913,7 +1680,7 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
-6.3 Removed ./configure options since Squid-2.7
+
5.3 Removed ./configure options since Squid-2.7
 
 
 
@@ -1970,13 +1737,13 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
-7. Regressions since Squid-2.7
+6. 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.1
 
 If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
 
-7.1 Missing squid.conf options available in Squid-2.7
+
6.1 Missing squid.conf options available in Squid-2.7
 
 
 
@@ -2102,7 +1869,7 @@ Use --without-pthreads to disable, but only if you really have to.
 
 
 
-7.2 Missing ./configure options available in Squid-2.7
+
6.2 Missing ./configure options available in Squid-2.7
 
 
 
diff --git a/doc/release-notes/release-3.1.sgml b/doc/release-notes/release-3.1.sgml
index 8ce3298112..094855ce34 100644
--- a/doc/release-notes/release-3.1.sgml
+++ b/doc/release-notes/release-3.1.sgml
@@ -1,6 +1,6 @@
 
 

-Squid 3.1.0.15 release notes
+Squid 3.1.0.16 release notes
 Squid Developers
 
 
@@ -13,7 +13,7 @@ for Applied Network Research and members of the Web Caching community.
 
 Notice
 
-The Squid Team are pleased to announce the release of Squid-3.1.0.15 for testing.
+The Squid Team are pleased to announce the release of Squid-3.1.0.16 for testing.
 
 This new release is available for download from  or the .
 
-- 
2.47.3

Squid 3.1.0.15 release notes

Squid 3.1.0.16 release notes

Squid Developers

3.1 Usage -

3.2 PSAPI.DLL (Process Status Helper) Considerations -

3.3 Registry DNS lookup -

3.4 Compatibility Notes -

3.5 Known Limitations -

3.6 Building Squid on Windows -

3.7 Using cache manager on Windows: -

4.1 New tags +

4.2 Changes to existing tags +

4.3 Removed tags +

5.1 New options +

5.2 Changes to existing options +

5.3 Removed options +

6.1 Removed squid.conf options since Squid-2.7 +

6.2 Removed squid.conf options since Squid-2.6 +

6.3 Removed ./configure options since Squid-2.7 +

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

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