<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
- <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.50">
- <TITLE>Squid 3.0.RC1 release notes</TITLE>
+ <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
+ <TITLE>Squid 3.0.STABLE10 release notes</TITLE>
</HEAD>
<BODY>
-<H1>Squid 3.0.RC1 release notes</H1>
+<H1>Squid 3.0.STABLE10 release notes</H1>
-<H2>Squid Developers</H2>$Id: release-3.0.sgml,v 1.31 2007/12/14 05:34:16 amosjeffries Exp $
+<H2>Squid Developers</H2>$Id: release-3.0.sgml,v 1.30.2.5 2008/02/28 00:26:31 amosjeffries Exp $
<HR>
<EM>This document contains the release notes for version 3.0 of Squid.
Squid is a WWW Cache application developed by the National Laboratory
<HR>
<H2><A NAME="s1">1. Notice</A></H2>
-<P>The Squid Team are pleased to announce the release of Squid-3.0.RC1 for pre-release testing.</P>
+<P>The Squid Team are pleased to announce the release of Squid-3.0.STABLE10.</P>
<P>This new release is available for download from
<A HREF="http://www.squid-cache.org/Versions/v3/3.0/">http://www.squid-cache.org/Versions/v3/3.0/</A> or the
<A HREF="http://www.squid-cache.org/Mirrors/http-mirrors.html">mirrors</A>.</P>
-<P>A large number of the show-stopper bugs have been fixed along with general improvements to the ICAP support.
-While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.</P>
+<P>A large number of the show-stopper bugs have been fixed along with general improvements to the ICAP support and additional Languages.</P>
<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="s2">2. Known issues</A></H2>
-<P>Although this release is deemed good enough for testing in many setups, please note the existence of
+<P>Although this release is deemed good enough for use 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>
-<H2><A NAME="s3">3. Changes since earlier releases of Squid-3.0</A></H2>
+<H2><A NAME="s3">3. Changes since earlier STABLE releases of Squid-3.0</A></H2>
<P>The 3.0 change history can be
<A HREF="http://www.squid-cache.org/Versions/v3/3.0/changesets/">viewed here</A>.</P>
</H2>
<P>Some of the features found in Squid-2.6 is not available in Squid-3.
-Some has been dropped as they are not needed. Some has not yet been forward-ported to Squid-3 and may appear in a later release.</P>
+Some have been dropped as they are not needed. Some have not yet been forward-ported to Squid-3 and may appear in a later release.</P>
<P>
<UL>
<LI>refresh_stale_hit option. Not yet ported.</LI>
<LI>Mapping of server error messages. Not yet ported.</LI>
<LI>http_access2 access directive. Not yet ported.</LI>
<LI>Location header rewrites. Not yet ported.</LI>
-<LI>umask directive. Not yet ported.</LI>
<LI>wais_relay. Feature dropped as it's equivalent to cache_peer + cache_peer_access.</LI>
<LI>urlgroup. Not yet ported.</LI>
<LI>collapsed forwarding. Not yet ported.</LI>
through without being processed by an ICAP server
service_url = icap://servername:port/service
-Note: reqmod_precache and respmod_postcache is not yet implemented
+Note: reqmod_postcache and respmod_postcache is not yet implemented
Example:
icap_service service_1 reqmod_precache 0 icap://icap1.mydomain.net:1344/reqmod
</PRE>
</P>
+
+<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
+ options are order-specific within the config as a whole.
+
+ A few layers of include are allowed, but too many are confusing and
+ squid will enforce an include depth of 16 files.
+
+ Syntax:
+ include /path/to/file1 /path/to/file2
+
+</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>umask</B><DD>
+<P>Ported from 2.6. Behaviour identical.
+<PRE>
+ Minimum umask which should be enforced while the proxy
+ is running, in addition to the umask set at startup.
+
+ For a traditional octal representation of umasks, start
+ your value with 0.
+
+</PRE>
+</P>
+
</DL>
</P>
</P>
<P>Removed options:
<PRE>
- userhash, not yet ported to Squid-3
-
- sourcehash, not yet ported to Squid-2
-
monitorurl, monitorsize etc, not yet ported to Squid-3
connection-auth=, not yet ported to Squid-3
<PRE>
no-store, replaces the older read-only option
- min-size, not yet portedto Squid-3
+ min-size, not yet ported to Squid-3
</PRE>
</P>
</PRE>
</P>
+
<DT><B>acl</B><DD>
+<P>The 'all' ACL is now provided as a built-in. Warnings will be displayed if any attempt is made to redefine it.</P>
<P>New types:
<PRE>
acl aclname http_status 200 301 500- 400-403 ... # status code in reply
</PRE>
</P>
+
<DT><B>short_icon_urls</B><DD>
<P>New default:
<PRE>
</PRE>
</P>
-<P>Removed format tags:
-<PRE>
- >st Request size including HTTP headers, not yet ported to Squid-3.
-
- st Request+Reply size including HTTP headers, not yet ported to Squid-3.
-
-</PRE>
-</P>
-
<DT><B>reply_body_max_size</B><DD>
<P>Syntax changed:
<PRE>
<DT><B>url_rewrite_program</B><DD>
<P>No urlgroup support in either requests or responese</P>
+
+<DT><B>auth_param</B><DD>
+<P>fake_auth helper for NTLM now accepts the '-S' parameter to strip NTLM domain off the username string.
+This is useful for class 4 Delay Pools in Squid 3.x</P>
+
</DL>
</P>
<P>Not yet ported to Squid-3.</P>
<DT><B>refresh_stale_hit</B><DD>
<P>Not yet ported to Squid-3.</P>
-<DT><B>umask</B><DD>
-<P>Not yet ported to Squid-3.</P>
<DT><B>wais_relay_*</B><DD>
<P>equivalent to cache_peer + cache_peer_access.</P>
</DL>
<!doctype linuxdoc system>
<article>
-<title>Squid 3.0.RC1 release notes</title>
+<title>Squid 3.0.STABLE10 release notes</title>
<author>Squid Developers</author>
-<date>$Id: release-3.0.sgml,v 1.31 2007/12/14 05:34:16 amosjeffries Exp $</date>
+<date>$Id: release-3.0.sgml,v 1.30.2.5 2008/02/28 00:26:31 amosjeffries Exp $</date>
<abstract>
This document contains the release notes for version 3.0 of Squid.
<sect>Notice
<p>
-The Squid Team are pleased to announce the release of Squid-3.0.RC1 for pre-release testing.
+The Squid Team are pleased to announce the release of Squid-3.0.STABLE10.
This new release is available for download from <url url="http://www.squid-cache.org/Versions/v3/3.0/"> or the <url url="http://www.squid-cache.org/Mirrors/http-mirrors.html" name="mirrors">.
-A large number of the show-stopper bugs have been fixed along with general improvements to the ICAP support.
-While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.
+A large number of the show-stopper bugs have been fixed along with general improvements to the ICAP support and additional Languages.
We welcome feedback and bug reports. If you find a bug, please see <url url="http://wiki.squid-cache.org/SquidFaq/TroubleShooting#head-7067fc0034ce967e67911becaabb8c95a34d576d"> for how to submit a report with a stack trace.
<sect>Known issues
<p>
-Although this release is deemed good enough for testing in many setups, please note the existence of <url url="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=" name="open bugs against Squid-3.0">.
+Although this release is deemed good enough for use in many setups, please note the existence of <url url="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=" name="open bugs against Squid-3.0">.
-<sect>Changes since earlier releases of Squid-3.0
+<sect>Changes since earlier STABLE releases of Squid-3.0
<p>
The 3.0 change history can be <url url="http://www.squid-cache.org/Versions/v3/3.0/changesets/" name="viewed here">.
<sect1>2.6 features not found in Squid-3.0
<p>
Some of the features found in Squid-2.6 is not available in Squid-3.
-Some has been dropped as they are not needed. Some has not yet been forward-ported to Squid-3 and may appear in a later release.
+Some have been dropped as they are not needed. Some have not yet been forward-ported to Squid-3 and may appear in a later release.
<itemize>
<item>refresh_stale_hit option. Not yet ported.
<item>Mapping of server error messages. Not yet ported.
<item>http_access2 access directive. Not yet ported.
<item>Location header rewrites. Not yet ported.
- <item>umask directive. Not yet ported.
<item>wais_relay. Feature dropped as it's equivalent to cache_peer + cache_peer_access.
<item>urlgroup. Not yet ported.
<item>collapsed forwarding. Not yet ported.
through without being processed by an ICAP server
service_url = icap://servername:port/service
-Note: reqmod_precache and respmod_postcache is not yet implemented
+Note: reqmod_postcache and respmod_postcache is not yet implemented
Example:
icap_service service_1 reqmod_precache 0 icap://icap1.mydomain.net:1344/reqmod
to Squid until a full HTTP request has been received.
See the accf_http(9) man page.
</verb>
+
+ <tag>include</tag>
+ <p>New option to import entire secondary configuration files into squid.conf.
+ <verb>
+ 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
+ options are order-specific within the config as a whole.
+
+ A few layers of include are allowed, but too many are confusing and
+ squid will enforce an include depth of 16 files.
+
+ Syntax:
+ include /path/to/file1 /path/to/file2
+ </verb>
+
+ <tag>acl myportname</tag>
+ <p>New acl type myportname, matching the name of the http(s)_port where the request was accepted
+ <verb>
+ acl aclname myportname 3128 ... # http(s)_port name
+ </verb>
+
+ <tag>umask</tag>
+ <p>Ported from 2.6. Behaviour identical.
+ <verb>
+ Minimum umask which should be enforced while the proxy
+ is running, in addition to the umask set at startup.
+
+ For a traditional octal representation of umasks, start
+ your value with 0.
+ </verb>
+
</descrip>
</verb>
<p>Removed options:
<verb>
- userhash, not yet ported to Squid-3
-
- sourcehash, not yet ported to Squid-2
-
monitorurl, monitorsize etc, not yet ported to Squid-3
connection-auth=, not yet ported to Squid-3
<verb>
no-store, replaces the older read-only option
- min-size, not yet portedto Squid-3
+ min-size, not yet ported to Squid-3
</verb>
<p>COSS file system:
<verb>
ensures that the client will receive an updated version
if one is available.
</verb>
+
<tag>acl</tag>
+ <p>The 'all' ACL is now provided as a built-in. Warnings will be displayed if any attempt is made to redefine it.
<p>New types:
<verb>
acl aclname http_status 200 301 500- 400-403 ... # status code in reply
# match against the urlgroup as indicated by redirectors
</verb>
+
<tag>short_icon_urls</tag>
<p>New default:
<verb>
<sS Upstream object size
</verb>
- <p>Removed format tags:
- <verb>
- >st Request size including HTTP headers, not yet ported to Squid-3.
-
- st Request+Reply size including HTTP headers, not yet ported to Squid-3.
- </verb>
-
<tag>reply_body_max_size</tag>
<p>Syntax changed:
<verb>
<tag>url_rewrite_program</tag>
<p>No urlgroup support in either requests or responese
+
+ <tag>auth_param</tag>
+ <p>fake_auth helper for NTLM now accepts the '-S' parameter to strip NTLM domain off the username string.
+ This is useful for class 4 Delay Pools in Squid 3.x
+
</descrip>
<p>Not yet ported to Squid-3.
<tag>refresh_stale_hit</tag>
<p>Not yet ported to Squid-3.
- <tag>umask</tag>
- <p>Not yet ported to Squid-3.
<tag>wais_relay_*</tag>
<p>equivalent to cache_peer + cache_peer_access.
</descrip>