<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
- <TITLE>Squid 3.1.PRE1 release notes: Changes since Squid-2.6: Changes to ./configure Options</TITLE>
+ <TITLE>Squid 3.1.PRE1 release notes</TITLE>
</HEAD>
<BODY>
<H1>Squid 3.1.PRE1 release notes</H1>
-<H2>Squid Developers</H2>$Id: release-3.1.html,v 1.4 2008/01/11 03:49:18 amosjeffries Exp $
+<H2>Squid Developers</H2>$Id: release-3.1.html,v 1.5 2008/01/17 10:09:05 hno Exp $
<HR>
<EM>This document contains the release notes for version 3.1 of Squid.
Squid is a WWW Cache application developed by the National Laboratory
for Applied Network Research and members of the Web Caching community.</EM>
<HR>
-<H2><A NAME="s5">5. Notice</A></H2>
+<H2><A NAME="s1">1. Notice</A></H2>
<P>The Squid Team are pleased to announce the release of Squid-3.1.PRE1 for pre-release testing.</P>
<P>This new release is available for download from
<P>We welcome feedback and bug reports. If you find a bug, please see
<A HREF="http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d">http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d</A> for how to submit a report with a stack trace.</P>
-<H2><A NAME="s6">6. Known issues</A></H2>
+<H2><A NAME="s2">2. Known issues</A></H2>
<P>Although this release is deemed good enough for testing in many setups, please note the existence of
-<A HREF="http://www.squid-cache.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&target_milestone=3.0&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=bugs.bug_severity&field0-0-0=noop&type0-0-0=noop&value0-0-0=">open bugs against Squid-3.0</A>.</P>
+<A HREF="http://www.squid-cache.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&target_milestone=3.1&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=bugs.bug_severity&field0-0-0=noop&type0-0-0=noop&value0-0-0=">open bugs against Squid-3.1</A>.</P>
-<H2><A NAME="s7">7. Changes since earlier PRE releases of Squid-3.0</A></H2>
+<H2><A NAME="s3">3. Changes since earlier PRE releases of Squid-3.1</A></H2>
<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="s8">8. Changes since Squid-3.0</A></H2>
+<H2><A NAME="s4">4. Changes since Squid-3.0</A></H2>
-<H2><A NAME="ss8.1">8.1 Major new features</A>
+<H2><A NAME="ss4.1">4.1 Major new features</A>
</H2>
<P>Squid 3.1 represents a new feature release above 3.0.</P>
with the RADIUS server. A new helper will be needed for IPv6 RADIUS protocol.</P>
-<H2><A NAME="ss8.2">8.2 Changes to squid.conf</A>
+<H2><A NAME="ss4.2">4.2 Changes to squid.conf</A>
</H2>
<P>There have been changes to Squid's configuration file since Squid-3.0.</P>
<P>
<DL>
-<DT><B>pinger_enable</B><DD>
-<P>New option to enable/disable the ICMP pinger helper with a reconfigure instead of a full rebuild.
+<DT><B>pinger_enable</B><DD><P>New option to enable/disable the ICMP pinger helper with a reconfigure instead of a full rebuild.
<PRE>
Control whether the pinger is active at run-time.
Enables turning ICMP pinger on and off with a simple squid -k reconfigure.
</PRE>
</P>
-<DT><B>dns_v4_fallback</B><DD>
-<P>New option to prevent squid from always looking up IPv4 regardless of whether IPv6 addresses are found.
+<DT><B>dns_v4_fallback</B><DD><P>New option to prevent squid from always looking up IPv4 regardless of whether IPv6 addresses are found.
Squid will follow a policy of prefering IPv6 links, keeping the IPv4 only as a safety net behind IPv6.
<PRE>
Standard practice with DNS is to lookup either A or AAAA records
</PRE>
</P>
-<DT><B>include</B><DD>
-<P>New option to import entire secondary configuration files into squid.conf.
+<DT><B>include</B><DD><P>New option to import entire secondary configuration files into squid.conf.
<PRE>
Squid will follow the files immediately and insert all their content
as if it was at that position in squid.conf. As per squid.conf some
<P>
<DL>
-<DT><B>acl</B><DD>
-<P>New preset content
+<DT><B>acl dst ipvs</B><DD><P>New preset content - ipv6 - available as a preset type in the src and dst ACL matching all of the public IPv6 network space.
<PRE>
- <p>ipv6 - now available as a preset type in the src and dst ACL matching all of the public IPv6 network space.
- <verb>
- acl aclname dst ipv6
+ acl aclname dst ipv6
</PRE>
</P>
-<DT><B>external_acl_type</B><DD>
-<P>New options 'ipv4' and 'ipv6' are added to set the IPv4/v6 protocol between squid and its helpers.
+<DT><B>http(s)_port name= option</B><DD><P>New port option to assign internal names to listening ports
+<PRE>
+ name= Specifies a internal name for the port. Defaults to
+ the port specification (port or addr:port)
+
+</PRE>
+</P>
+
+<DT><B>acl myportname</B><DD><P>New acl type myportname, matching the name of the http(s)_port where the request was accepted
+<PRE>
+ acl aclname myportname 3128 ... # http(s)_port name
+
+</PRE>
+</P>
+
+
+<DT><B>external_acl_type</B><DD><P>New options 'ipv4' and 'ipv6' are added to set the IPv4/v6 protocol between squid and its helpers.
Please be aware of some limits to these options. These options only affet the transport protocol used
to send data to and from the helpers. Squid in IPv6-mode may still send %SRC addresses in IPv4 or IPv6
format, so all helpers will need to be checked and converted to cope with such information cleanly.
</PRE>
</P>
-<DT><B>tcp_outgoing_address</B><DD>
-<P>This option causes some problems when bridging IPv4 and IPv6. A workaround has been provided.
+<DT><B>tcp_outgoing_address</B><DD><P>This option causes some problems when bridging IPv4 and IPv6. A workaround has been provided.
<PRE>
Squid is built with a capability of bridging the IPv4 and IPv6 internets.
tcp_outgoing_address as previously used breaks this bridging by forcing
</PRE>
</P>
-<DT><B>balance_on_multiple_ip</B><DD>
-<P>The previous default behavour (rotate per-request) of this setting causes failover clashes with IPv6 built-in mechanisms.
+<DT><B>balance_on_multiple_ip</B><DD><P>The previous default behavour (rotate per-request) of this setting causes failover clashes with IPv6 built-in mechanisms.
It has thus been turned off by default. Making the 'best choice' IP continue in use for any hostname until it encounters a connection failure and failover drops to the next known IP.
<PRE>
Modern IP resolvers in squid sort lookup results by preferred access.
</P>
-<H2><A NAME="ss8.3">8.3 Changes to ./configure Options</A>
+<H2><A NAME="ss4.3">4.3 Changes to ./configure Options</A>
</H2>
<P>There have been some changes to Squid's build configuration since Squid-3.0.</P>
<P>
<DL>
-<DT><B>--enable-ipv6</B><DD>
-<P>Buildwith IPv6 support. The default is to build without.</P>
+<DT><B>--enable-ipv6</B><DD><P>Buildwith IPv6 support. The default is to build without.</P>
-<DT><B>--with-localhost-ipv6</B><DD>
-<P>Build support for squid to map all 127.0.0.1 traffic onto ::1.
+<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>
-<DT><B>--with-ipv6-split-stack</B><DD>
-<P>Enable special additions for IPv6 support in Windows XP.
+<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.
+<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.
+<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.
Please note this extension is still experimental and may encounter problems.
To see if it is actually needed you can run squid without it for a period and
<P>
<DL>
-<DT><B>--disable-internl-dns</B><DD>
-<P>Better support for Linux using the external DNS helper.
+<DT><B>--disable-internl-dns</B><DD><P>Better support for Linux using the external DNS helper.
The helper will compile and work with dns_nameservers on more variants of Linux than previously.</P>
</DL>
porting one of these from Squid-2 to Squid-3 is most welcome.</P>
<P>
<DL>
-<DT><B>--enable-devpoll</B><DD>
-<P>Support for Solaris /dev/poll</P>
+<DT><B>--enable-devpoll</B><DD><P>Support for Solaris /dev/poll</P>
-<DT><B>--enable-select-simple</B><DD>
-<P>Basic POSIX select() loop without any binary fd_set optimizations.</P>
+<DT><B>--enable-select-simple</B><DD><P>Basic POSIX select() loop without any binary fd_set optimizations.</P>
-<DT><B>--enable-follow-x-forwarded-for</B><DD>
-<P>Support following the X-Forwarded-For HTTP header for determining the
+<DT><B>--enable-follow-x-forwarded-for</B><DD><P>Support following the X-Forwarded-For HTTP header for determining the
client IP address</P>
</DL>
</P>
projects / thirdparty / squid.git / commitdiff
