Squid 6.0.0 release notes

Squid Developers


This document contains the release notes for version 6 of Squid. 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. Major new features since Squid-5

3. Changes to squid.conf since Squid-5

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

5. Regressions since Squid-2.7

6. Copyright


1. Notice

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

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

While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.

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

1.1 Known issues

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

Support for compiling on HPUX with the native HP xcc compiler has been removed. To build on that OS/compiler combination, it is possible to pass these environemnt variables to ./configure: CC="cxx -Ae" RANLIB=":"

1.2 Changes since earlier releases of Squid-6

The Squid-6 change history can be viewed here.

2. Major new features since Squid-5

Squid-6 represents a new feature release above Squid-5.

The most important of these new features are:

Most user-facing changes are reflected in squid.conf (see below).

3. Changes to squid.conf since Squid-5

This section gives an account of those changes in three categories:

3.1 New directives

There have been no directives added.

3.2 Changes to existing directives

There have been no directives changed.

3.3 Removed directives

request_entities

Obsolete. Squid accepts an entity (aka payload, body) on HTTP/1.1 GET or HEAD requests when a Content-Length or Transfer-Encoding header is presented to clearly determine size.

To retain the old behaviour of rejecting GET/HEAD payloads for HTTP/1.1 use http_access rules:

  acl fetch method GET HEAD
  acl entity req_header Content-Length .
  http_access deny fetch entity

Squid will reject use of Content-Length header on HTTP/1.0 messages with GET, HEAD, DELETE, LINK, UNLINK methods. Since the HTTP/1.0 specification defines those as not having entities. To deliver entities on these methods the chunked encoding feature defined by HTTP/1.1 must be used, or the request upgraded to an HTTP/1.1 message.

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

This section gives an account of those changes in three categories:

4.1 New options

There have been no options added.

4.2 Changes to existing options

There have been no options changed.

4.3 Removed options

--enable-cpu-profiling

This feature has been unreliable for many years. Other tools such as oprofile provide better tracking and should be used instead.

--disable-loadable-modules

This option was performing the same duties as --disable-shared.

5. Regressions since Squid-2.7

Some squid.conf options which were available in Squid-2.7 are not yet available in Squid-5

If you need something to do then porting one of these from Squid-2 is most welcome.

5.1 Missing squid.conf options available in Squid-2.7

broken_vary_encoding

Not yet ported from 2.6

cache_peer

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

error_map

Not yet ported from 2.6

external_refresh_check

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

refresh_pattern

stale-while-revalidate= not yet ported from 2.7

ignore-stale-while-revalidate= not yet ported from 2.7

negative-ttl= not yet ported from 2.7

refresh_stale_hit

Not yet ported from 2.7

update_headers

Not yet ported from 2.7

6. Copyright

Copyright (C) 1996-2022 The Squid Software Foundation and contributors

Squid software is distributed under GPLv2+ license and includes contributions from numerous individuals and organizations. Please see the COPYING and CONTRIBUTORS files for details.