Squid 5.0.0 release notes

Squid Developers


This document contains the release notes for version 4 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-4

3. Changes to squid.conf since Squid-4

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

5. Regressions since Squid-2.7

6. Copyright


1. Notice

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

This new release is available for download from http://www.squid-cache.org/Versions/v5/ 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-5.

1.2 Changes since earlier releases of Squid-5

The Squid-4 change history can be viewed here.

2. Major new features since Squid-4

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

The most important of these new features are:

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

2.1 ICAP Trailers

Details in Draft: ICAP Trailers

The Trailers feature from HTTP is being proposed for addition to ICAP, with some modifications.

This implementation complies with version -01 of that draft:

For now Squid logs and ignores all parsed ICAP header fields.

3. Changes to squid.conf since Squid-4

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

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

3.1 New directives

auth_schemes

New access control to customize authentication schemes presence and order in Squid generated HTTP 401 (Unauthorized) and 407 (Proxy Authentication Required) responses.

3.2 Changes to existing directives

acl

The CONNECT ACL definition is now built-in.

3.3 Removed directives

No removed directives in this version.

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

There have been some changes to Squid's build configuration since Squid-4.

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

4.1 New options

No new options in this version.

4.2 Changes to existing options

--disable-optimizations

No longer implies --disable-inline option (which is removed).

4.3 Removed options

--disable-inline

Removed.

-DUSE_CHUNKEDMEMPOOLS=1

Removed compiler flag. Use run-time environment variable MEMPOOLS=1 to enable chunked memory pools instead.

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-2017 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.