<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
- <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
+ <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.50">
<TITLE>Squid 3.1.0.1 release notes</TITLE>
</HEAD>
<BODY>
<P>The 3.1 change history can be
<A HREF="http://www.squid-cache.org/Versions/v3/3.1/changesets/">viewed here</A>.</P>
-<H2><A NAME="s4">4. Changes since Squid-3.0</A></H2>
-
-<H2><A NAME="ss4.1">4.1 Major new features</A>
-</H2>
+<H2><A NAME="s4">4. Major new features sinceSsquid-3.0</A></H2>
<P>Squid 3.1 represents a new feature release above 3.0.</P>
<P>The most important of these new features are:</P>
</P>
<P>Most user-facing changes are reflected in squid.conf (see below).</P>
-<H3>New Version Numbering System</H3>
+<H2><A NAME="ss4.1">4.1 New Version Numbering System</A>
+</H2>
<P>Begining with 3.1 the Squid Developers are trialling a new release numbering system.</P>
</P>
-<H3>Minimal squid.conf improvements</H3>
+<H2><A NAME="ss4.2">4.2 Minimal squid.conf improvements</A>
+</H2>
<P>squid.conf has undergone a facelift.</P>
config options provided on a clean install.</P>
-<H3>Internet Protocol version 6 (IPv6)</H3>
-
-<P>Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option</P>
+<H2><A NAME="ss4.3">4.3 Internet Protocol version 6 (IPv6)</A>
+</H2>
-<P>Details in
+<P>Squid 3.1 supports IPv6.
+Details in
<A HREF="http://wiki.squid-cache.org/Features/IPv6">The Squid wiki</A></P>
<H3>New Features for IPv6</H3>
with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.</P>
-<H3>Error Page Localization</H3>
+<H2><A NAME="ss4.4">4.4 Error Page Localization</A>
+</H2>
<P>Details in
<A HREF="http://wiki.squid-cache.org/Translations">The Squid wiki</A></P>
<P>The error pages presented by squid may now be localized per-request to match the visitors local preferred language.</P>
-<P>Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed.</P>
+<P>The error_directory option in squid.conf needs to be removed.</P>
<P>For best coverage of languages, using the latest language pack of error files is recommended.
Updates can be downloaded from
Contribution of new languages is encouraged.</P>
-<H3>Connection Pinning (for NTLM Auth Passthrough)</H3>
+<H2><A NAME="ss4.5">4.5 Connection Pinning (for NTLM Auth Passthrough)</A>
+</H2>
<P>Details in
<A HREF="http://wiki.squid-cache.org/Features/ConnPinn">The Squid wiki</A></P>
Microsoft NTLM Authentication instead of HTTP standard authentication through a web proxy.</P>
-<H3>Quality of Service (QoS) Flow support</H3>
+<H2><A NAME="ss4.6">4.6 Quality of Service (QoS) Flow support</A>
+</H2>
<P>Details in
<A HREF="http://wiki.squid-cache.org/Features/QualityOfService">The Squid wiki</A></P>
</P>
-<H3>SSL Bump (for HTTPS Filtering and Adaptation)</H3>
+<H2><A NAME="ss4.7">4.7 SSL Bump (for HTTPS Filtering and Adaptation)</A>
+</H2>
<P>Details in
<A HREF="http://wiki.squid-cache.org/Features/SslBump">The Squid wiki</A></P>
While decrypted, the traffic can be inspected using ICAP.</P>
-<H3>eCAP Adaptation Module support</H3>
+<H2><A NAME="ss4.8">4.8 eCAP Adaptation Module support</A>
+</H2>
<P>Details in
<A HREF="http://wiki.squid-cache.org/Features/eCAP">The Squid wiki</A></P>
</P>
-<H2><A NAME="ss5.1">5.1 Changes to squid.conf</A>
-</H2>
+<H2><A NAME="s6">6. Changes to squid.conf since Squid-3.0</A></H2>
<P>There have been changes to Squid's configuration file since Squid-3.0.</P>
<P>This section gives a thorough account of those changes in three categories:</P>
-<H3><A NAME="newtags"></A> New tags</H3>
+<H2><A NAME="newtags"></A> <A NAME="ss6.1">6.1 New tags</A>
+</H2>
<P>
<DL>
</DL>
</P>
-<H3><A NAME="modifiedtags"></A> Changes to existing tags</H3>
+<H2><A NAME="modifiedtags"></A> <A NAME="ss6.2">6.2 Changes to existing tags</A>
+</H2>
<P>
<DL>
</P>
-<H3><A NAME="removedtags"></A> Removed tags</H3>
+<H2><A NAME="removedtags"></A> <A NAME="ss6.3">6.3 Removed tags</A>
+</H2>
<P>
<DL>
</P>
-<H2><A NAME="ss5.2">5.2 Changes to ./configure Options</A>
-</H2>
+<H2><A NAME="s7">7. Changes to ./configure Options since Squid-3.0</A></H2>
<P>There have been some changes to Squid's build configuration since Squid-3.0.</P>
<P>This section gives an account of those changes in three categories:</P>
<LI>
<A HREF="#modifiedoptions">Changes to existing options</A></LI>
<LI>
-<A HREF="#notportedoptions">Not yet available options</A></LI>
-<LI>
<A HREF="#removedoptions">Removed options</A></LI>
</UL>
</P>
-<H3><A NAME="newoptions"></A> New options</H3>
+<H2><A NAME="newoptions"></A> <A NAME="ss7.1">7.1 New options</A>
+</H2>
<P>
<DL>
<DT><B>--enable-ipv6</B><DD>
-<P>Buildwith IPv6 support. The default is to build without.</P>
+<P>Buildwith IPv6 support. The default is to build with IPv6.</P>
<DT><B>--with-localhost-ipv6</B><DD>
<P>Build support for squid to map all 127.0.0.1 traffic onto ::1.
The default is to build with 127.0.0.1 and ::1 being considered seperate IP.
-see the IPv6 details above for a better description. </P>
+see the IPv6 details above for a better description.</P>
<DT><B>--with-ipv6-split-stack</B><DD>
<P>Enable special additions for IPv6 support in Windows XP.
see the IPv6 details above for a better description.</P>
-<DT><B>--with-ipv4-mapped</B><DD>
-<P>Enable special additions for IPv6 support in Windows Vista.
-see the IPv6 details above for a better description.</P>
-
<DT><B>--with-dns-cname</B><DD>
<P>Enable CNAME recursion within the Internal DNS resolver stub squid uses.
This has no effect on the external DNS helper.
</DL>
</P>
-<H3><A NAME="modifiedoptions"></A> Changes to existing options</H3>
+<H2><A NAME="modifiedoptions"></A> <A NAME="ss7.2">7.2 Changes to existing options</A>
+</H2>
<P>
<DL>
</DL>
</P>
-<H3><A NAME="notportedoptions"></A> Not yet available options</H3>
+<H2><A NAME="removedoptions"></A> <A NAME="ss7.3">7.3 Removed options</A>
+</H2>
+
+<P>The following configure options have been removed.</P>
+<P>
+<DL>
+<DT><B>--enable-linux-tproxy</B><DD>
+<P>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</P>
+<DT><B>--enable-default-err-language</B><DD>
+<P>Replaced by error_default_language squid.conf option</P>
+<DT><B>--enable-err-languages</B><DD>
+<P>Removed.</P>
+</DL>
+</P>
+
+
+<H2><A NAME="s8">8. Regressions since Squid-2.6</A></H2>
+
+<P>Some squid.conf and ./configure options which were available in Squid 2.6 are no longer
+or not yet available in Squid-3.1</P>
+
+<P>Some options are listed as <EM>Not Yet Ported</EM>
+If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
+
+<H2><A NAME="ss8.1">8.1 Missing and Removed squid.conf Options</A>
+</H2>
+
+<P>
+<DL>
+<DT><B></B><DD>
+
+
+</DL>
+</P>
+
+<H2><A NAME="ss8.2">8.2 Missing and Removed ./configure Options</A>
+</H2>
-<P>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.</P>
<P>
<DL>
<DT><B>--enable-devpoll</B><DD>
</DL>
</P>
-<H3><A NAME="removedoptions"></A> Removed options</H3>
-<P>The following configure options have been removed.</P>
+<H2><A NAME="s9">9. Regressions since Squid-2.7</A></H2>
+
+<P>Some squid.conf and ./configure options which were available in Squid 2.7 are no longer
+or not yet available in Squid-3.1</P>
+
+<P>Some options are listed as <EM>Not Yet Ported</EM>
+If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
+
+<H2><A NAME="ss9.1">9.1 Missing and Removed squid.conf Options</A>
+</H2>
+
<P>
<DL>
-<DT><B>--enable-linux-tproxy</B><DD>
-<P>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</P>
-<DT><B>--enable-default-err-language</B><DD>
-<P>Replaced by error_default_language squid.conf option</P>
-<DT><B>--enable-err-languages</B><DD>
-<P>Removed.</P>
+<DT><B></B><DD>
+
+
+</DL>
+</P>
+
+<H2><A NAME="ss9.2">9.2 Missing and Removed ./configure Options</A>
+</H2>
+
+<P>
+<DL>
+<DT><B></B><DD>
+
+
</DL>
</P>
<p>
The 3.1 change history can be <url url="http://www.squid-cache.org/Versions/v3/3.1/changesets/" name="viewed here">.
-<sect>Changes since Squid-3.0
-
-<sect1>Major new features
+<sect>Major new features sinceSsquid-3.0
<p>
Squid 3.1 represents a new feature release above 3.0.
Most user-facing changes are reflected in squid.conf (see below).
-<sect2>New Version Numbering System
+<sect1>New Version Numbering System
<p>Begining with 3.1 the Squid Developers are trialling a new release numbering system.
</itemize>
-<sect2>Minimal squid.conf improvements
+<sect1>Minimal squid.conf improvements
<p>squid.conf has undergone a facelift.
config options provided on a clean install.
-<sect2>Internet Protocol version 6 (IPv6)
-
-<p>Squid 3.1 supports IPv6. To enable IPv6 support, use the ./configure --enable-ipv6 option
+<sect1>Internet Protocol version 6 (IPv6)
-<p>Details in <url url="http://wiki.squid-cache.org/Features/IPv6" name="The Squid wiki">
+<p>Squid 3.1 supports IPv6.
+ Details in <url url="http://wiki.squid-cache.org/Features/IPv6" name="The Squid wiki">
-<sect3>New Features for IPv6
+<sect2>New Features for IPv6
<p>Squid handles localhost values seperately. For the purpose of ACLs and also external
connections ::1 is considered a seperate IP from 127.0.0.1. This means all ACL which
software which hard coded the MIB paths needs to be upgraded for this Squid release.
-<sect3>Limitations of IPv6 Support
+<sect2>Limitations of IPv6 Support
<p>Specify a specific tcp_outgoing_address and the clients who match its ACL are limited
to the IPv4 or IPv6 network that address belongs to. They are not permitted over the
with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.
-<sect2>Error Page Localization
+<sect1>Error Page Localization
<p>Details in <url url="http://wiki.squid-cache.org/Translations" name="The Squid wiki">
<p>The error pages presented by squid may now be localized per-request to match the visitors local preferred language.
-<p>Squid needs to be build with the --enable-auto-locale option. And the error_directory option in squid.conf needs to be removed.
+<p>The error_directory option in squid.conf needs to be removed.
<p>For best coverage of languages, using the latest language pack of error files is recommended.
Updates can be downloaded from <url url="http://www.squid-cahch.org/Versions/langpack/" name="www.squid-cache.org/Versions/langpack/">
Contribution of new languages is encouraged.
-<sect2>Connection Pinning (for NTLM Auth Passthrough)
+<sect1>Connection Pinning (for NTLM Auth Passthrough)
<p>Details in <url url="http://wiki.squid-cache.org/Features/ConnPinn" name="The Squid wiki">
Microsoft NTLM Authentication instead of HTTP standard authentication through a web proxy.
-<sect2>Quality of Service (QoS) Flow support
+<sect1>Quality of Service (QoS) Flow support
<p>Details in <url url="http://wiki.squid-cache.org/Features/QualityOfService" name="The Squid wiki">
before copying the value to the TOS send towards clients.
</itemize>
-<sect3>Squid Configuration
+<sect2>Squid Configuration
<p>Squid 3.1 needs to be configured with --enable-zph-qos for the ZPH QoS controls to be available.
<p>The configuration options for 2.7 and 3.1 are based on different ZPH patches.
</itemize>
-<sect2>SSL Bump (for HTTPS Filtering and Adaptation)
+<sect1>SSL Bump (for HTTPS Filtering and Adaptation)
<p>Details in <url url="http://wiki.squid-cache.org/Features/SslBump" name="The Squid wiki">
While decrypted, the traffic can be inspected using ICAP.
-<sect2>eCAP Adaptation Module support
+<sect1>eCAP Adaptation Module support
<p>Details in <url url="http://wiki.squid-cache.org/Features/eCAP" name="The Squid wiki">
</descrip>
-<sect1>Changes to squid.conf
+<sect>Changes to squid.conf since Squid-3.0
<p>
There have been changes to Squid's configuration file since Squid-3.0.
<p>
-<sect2>New tags<label id="newtags">
+<sect1>New tags<label id="newtags">
<p>
<descrip>
<tag>acl_uses_indirect_client</tag>
</descrip>
-<sect2>Changes to existing tags<label id="modifiedtags">
+<sect1>Changes to existing tags<label id="modifiedtags">
<p>
<descrip>
<tag>acl dst ipv6</tag>
</descrip>
-<sect2>Removed tags<label id="removedtags">
+<sect1>Removed tags<label id="removedtags">
<p>
<descrip>
</descrip>
-<sect1>Changes to ./configure Options
+<sect>Changes to ./configure Options since Squid-3.0
<p>
There have been some changes to Squid's build configuration since Squid-3.0.
<itemize>
<item><ref id="newoptions" name="New options">
<item><ref id="modifiedoptions" name="Changes to existing options">
- <item><ref id="notportedoptions" name="Not yet available options">
<item><ref id="removedoptions" name="Removed options">
</itemize>
<p>
-<sect2>New options<label id="newoptions">
+<sect1>New options<label id="newoptions">
<p>
<descrip>
<tag>--enable-ipv6</tag>
- <p>Buildwith IPv6 support. The default is to build without.</p>
+ <p>Buildwith IPv6 support. The default is to build with IPv6.</p>
<tag>--with-localhost-ipv6</tag>
<p>Build support for squid to map all 127.0.0.1 traffic onto ::1.
The default is to build with 127.0.0.1 and ::1 being considered seperate IP.
- see the IPv6 details above for a better description.
+ see the IPv6 details above for a better description.
</p>
<tag>--with-ipv6-split-stack</tag>
<p>Enable special additions for IPv6 support in Windows XP.
see the IPv6 details above for a better description.</p>
- <tag>--with-ipv4-mapped</tag>
- <p>Enable special additions for IPv6 support in Windows Vista.
- see the IPv6 details above for a better description.</p>
-
<tag>--with-dns-cname</tag>
<p>Enable CNAME recursion within the Internal DNS resolver stub squid uses.
This has no effect on the external DNS helper.
</descrip>
</p>
-<sect2>Changes to existing options<label id="modifiedoptions">
+<sect1>Changes to existing options<label id="modifiedoptions">
<p>
<descrip>
</descrip>
</p>
-<sect2>Not yet available options<label id="notportedoptions">
+<sect1>Removed options<label id="removedoptions">
+
+<p>The following configure options have been removed.
+
+<descrip>
+ <tag>--enable-linux-tproxy</tag>
+ <p>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</p>
+ <tag>--enable-default-err-language</tag>
+ <p>Replaced by error_default_language squid.conf option</p>
+ <tag>--enable-err-languages</tag>
+ <p>Removed.</p>
+</descrip>
+
+
+<sect>Regressions since Squid-2.6
+
+<p>Some squid.conf and ./configure options which were available in Squid 2.6 are no longer
+ or not yet available in Squid-3.1
-<p>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.
+<p>Some options are listed as <em>Not Yet Ported</em>
+ If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
+<sect1>Missing and Removed squid.conf Options
+<descrip>
+ <tag></tag>
+ <p>
+
+</descrip>
+
+<sect1>Missing and Removed ./configure Options
<descrip>
<tag>--enable-devpoll</tag>
<p>Support for Solaris /dev/poll</p>
client IP address</p>
</descrip>
-<sect2>Removed options<label id="removedoptions">
-<p>The following configure options have been removed.
+<sect>Regressions since Squid-2.7
+
+<p>Some squid.conf and ./configure options which were available in Squid 2.7 are no longer
+ or not yet available in Squid-3.1
+<p>Some options are listed as <em>Not Yet Ported</em>
+ If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
+
+<sect1>Missing and Removed squid.conf Options
<descrip>
- <tag>--enable-linux-tproxy</tag>
- <p>Replaced by --enable-linux-tproxy2 to make way for differences in TPROXY v2 and v4 support.</p>
- <tag>--enable-default-err-language</tag>
- <p>Replaced by error_default_language squid.conf option</p>
- <tag>--enable-err-languages</tag>
- <p>Removed.</p>
+ <tag></tag>
+ <p>
+
+</descrip>
+
+<sect1>Missing and Removed ./configure Options
+<descrip>
+ <tag></tag>
+ <p>
+
</descrip>
</article>