]> git.ipfire.org Git - thirdparty/squid.git/commitdiff
Align configure options with Squid-2
authorhno <>
Tue, 18 Sep 2007 03:06:09 +0000 (03:06 +0000)
committerhno <>
Tue, 18 Sep 2007 03:06:09 +0000 (03:06 +0000)
--with-valgrind-debug (was --with-valgrind)

--enable-large-files not experimental after the largeobj merge.

And ceaned up releasenotes a bit wrt configure options.

configure.in
doc/release-notes/release-3.0.html
doc/release-notes/release-3.0.sgml

index 3c1f807f4418fee909a8c63dfbbe842adfa06ac9..0ce455d6ec22372ba2eba2db205df2b0a425eba0 100644 (file)
@@ -1,7 +1,7 @@
 
 dnl  Configuration input file for Squid
 dnl
-dnl  $Id: configure.in,v 1.477 2007/09/09 18:11:44 hno Exp $
+dnl  $Id: configure.in,v 1.478 2007/09/17 21:06:09 hno Exp $
 dnl
 dnl
 dnl
@@ -11,7 +11,7 @@ AM_CONFIG_HEADER(include/autoconf.h)
 AC_CONFIG_AUX_DIR(cfgaux)
 AC_CONFIG_SRCDIR([src/main.cc])
 AM_INIT_AUTOMAKE([tar-ustar])
-AC_REVISION($Revision: 1.477 $)dnl
+AC_REVISION($Revision: 1.478 $)dnl
 AC_PREFIX_DEFAULT(/usr/local/squid)
 AM_MAINTAINER_MODE
 
@@ -1134,8 +1134,7 @@ buildmodel=""
 needlargefiles=
 
 AC_ARG_WITH(large-files,
-[  --with-large-files      Enable support for large files (logs etc). Still
-                          experimental.],
+[  --with-large-files      Enable support for large files (logs etc).],
 [ if test "$withval" = yes; then
        needlargefiles=1
   fi
@@ -1603,8 +1602,8 @@ if test -n "$EXTERNAL_ACL_HELPERS"; then
 fi
 AC_SUBST(EXTERNAL_ACL_HELPERS)
 
-AC_ARG_WITH(valgrind,
-[  --with-valgrind        Include debug instrumentation for use with valgrind],
+AC_ARG_WITH(valgrind-debug,
+[  --with-valgrind-debug  Include debug instrumentation for use with valgrind],
 [ case $withval in
   yes)
        valgrind=1
index 7271f53a6c761b9e1ca02558d10c46538b9b2efd..168a57f53a60315be2ad949b4817847b10e076a5 100644 (file)
@@ -7,7 +7,7 @@
 <BODY>
 <H1>Squid 3.0.PRE7 release notes</H1>
 
-<H2>Squid Developers</H2>$Id: release-3.0.html,v 1.9 2007/09/03 05:33:26 amosjeffries Exp $
+<H2>Squid Developers</H2>$Id: release-3.0.html,v 1.10 2007/09/17 21:06:10 hno 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
@@ -43,17 +43,39 @@ While this release is not deemed ready for production use, we believe it is read
 <P>The most important of these are:</P>
 <P>
 <UL>
-<LI>Edge Side Includes (ESI) implementation (www.esi.org)</LI>
-<LI>ICAP implementation (www.i-cap.org)</LI>
-<LI>Internal client streams concept enabling the implementations of ESI and ICAP.</LI>
 <LI>Code converted to C++, with significant internal restructuring and rewrites.</LI>
+<LI>ICAP implementation (RFC 3507 and www.icap-forum.org)</LI>
+<LI>Edge Side Includes (ESI) implementation (www.esi.org)</LI>
 </UL>
 </P>
 <P>Most user-facing changes are reflected in squid.conf (see below).</P>
 
 <H3>Internet Content Adaptation Protocol (ICAP)</H3>
 
-<P>TO BE WRITTEN</P>
+<P>Squid 3.0 supports ICAP/1.0. To enable ICAP support, use the --enable-icap-client ./configure option and icap_enable squid.conf option. You will also need to configure ICAP services in your squid.conf using icap_service, icap_class, and icap_access options. The following example instructs Squid to talk to two ICAP services, one for request and one for response adaptation:</P>
+<P>
+<PRE>
+icap_enable on
+icap_service service_req reqmod_precache 1 icap://127.0.0.1:1344/request
+icap_service service_resp respmod_precache 0 icap://127.0.0.1:1344/response
+icap_class class_req service_req
+icap_class class_resp service_resp
+icap_access class_req allow all
+icap_access class_resp allow all
+</PRE>
+</P>
+
+<P>Please see squid.conf.default for more details about these and many other icap_* options.</P>
+
+<P>Squid supports pre-cache request and pre-cache response vectoring points. The following ICAP features are supported: message preview, 204 responses outside of preview, request satisfaction, X-Transfer-* negotiation, persistent ICAP connections, client IP/credentials sharing, and optional bypass of certain service failures.</P>
+
+<P>No more than one ICAP service can be applied to an HTTP message. In other words, chaining or load balancing multiple services is not yet supported.</P>
+
+<P>Proxy-directed data trickling and patience pages are not supported yet.</P>
+
+<P>Following ICAP requirements, Squid never performs HTTP message adaptation without a successful and fresh ICAP OPTIONS response on file. A REQMOD or RESPMOD request will not be sent to a configured ICAP service until Squid receives a valid OPTIONS response from that service. If a service malfunctions or goes down, Squid may stop talking to the service for a while. Several squid.conf options can be used to tune the failure bypass algorithm (e.g., icap_service_failure_limit and icap_service_revival_delay). </P>
+
+<P>The bypass parameter of the icap_service squid.conf option determines whether Squid will try to bypass service failures. Most connectivity and preview-stage failures can be bypassed.</P>
 
 <P>More information about ICAP can be found from the ICAP-forum website 
 <A HREF="http://www.icap-forum.org">http://www.icap-forum.org</A></P>
@@ -94,10 +116,8 @@ Some has been dropped as they are not needed. Some has not yet been forward-port
 <P>The TCP_REFRESH_HIT and TCP_REFRESH_MISS log types have been replaced because they were misleading (all refreshes need to query the origin server, so they could never be hits). The following log types have been introduced to replace them:</P>
 <P>
 <DL>
-<DT><B>TCP_REFRESH_UNMODIFIED</B><DD>
-<P>The requested object was cached but STALE. The IMS query for the object resulted in "304 not modified".</P>
-<DT><B>TCP_REFRESH_MODIFIED</B><DD>
-<P>The requested object was cached but STALE. The IMS query returned the new content.</P>
+<DT><B>TCP_REFRESH_UNMODIFIED</B><DD><P>The requested object was cached but STALE. The IMS query for the object resulted in "304 not modified".</P>
+<DT><B>TCP_REFRESH_MODIFIED</B><DD><P>The requested object was cached but STALE. The IMS query returned the new content.</P>
 </DL>
 </P>
 <P>See 
@@ -130,8 +150,7 @@ Some has been dropped as they are not needed. Some has not yet been forward-port
 
 <P>
 <DL>
-<DT><B>minimum_icp_query_timeout (msec)</B><DD>
-<P>
+<DT><B>minimum_icp_query_timeout (msec)</B><DD><P>
 <PRE>
 Default: 5
 
@@ -145,8 +164,7 @@ of a dynamic) timeout value. To set a fixed timeout see the
         
 </PRE>
 </P>
-<DT><B>background_ping_rate</B><DD>
-<P>
+<DT><B>background_ping_rate</B><DD><P>
 <PRE>
 Default: 10 seconds
 
@@ -156,8 +174,7 @@ have background-ping set.
 </PRE>
 </P>
 
-<DT><B>httpd_accel_surrogate_id</B><DD>
-<P>
+<DT><B>httpd_accel_surrogate_id</B><DD><P>
 <PRE>
 Default: unset
 
@@ -169,8 +186,7 @@ an identification token.
 </PRE>
 </P>
 
-<DT><B>http_accel_surrogate_remote on|off</B><DD>
-<P>
+<DT><B>http_accel_surrogate_remote on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -180,8 +196,7 @@ Set this to on to have squid behave as a remote surrogate.
 </PRE>
 </P>
 
-<DT><B>esi_parser libxml2|expat|custom</B><DD>
-<P>
+<DT><B>esi_parser libxml2|expat|custom</B><DD><P>
 <PRE>
 Default: custom
 
@@ -192,8 +207,7 @@ encodings.
 </PRE>
 </P>
 
-<DT><B>email_err_data on|off</B><DD>
-<P>
+<DT><B>email_err_data on|off</B><DD><P>
 <PRE>
 Default: on
 
@@ -205,8 +219,7 @@ Syntax is &lt;A HREF="mailto:%w%W"&gt;%w&lt;/A&gt;
 </PRE>
 </P>
 
-<DT><B>refresh_all_ims on|off</B><DD>
-<P>
+<DT><B>refresh_all_ims on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -221,13 +234,10 @@ based on the age of the cached version.
         
 </PRE>
 </P>
-<DT><B>request_header_access</B><DD>
-<P>Replaces the header_access directive of Squid-2.6 and earlier, but applies to requests only.</P>
-<DT><B>reply_header_access</B><DD>
-<P>Replaces the header_access directive of Squid-2.6 and earlier, but applies to replies only.</P>
+<DT><B>request_header_access</B><DD><P>Replaces the header_access directive of Squid-2.6 and earlier, but applies to requests only.</P>
+<DT><B>reply_header_access</B><DD><P>Replaces the header_access directive of Squid-2.6 and earlier, but applies to replies only.</P>
 
-<DT><B>icap_enable on|off</B><DD>
-<P>
+<DT><B>icap_enable on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -235,8 +245,7 @@ If you want to enable the ICAP module support, set this to on.
         
 </PRE>
 </P>
-<DT><B>icap_preview_enable on|off</B><DD>
-<P>
+<DT><B>icap_preview_enable on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -245,8 +254,7 @@ feature in Squid.
         
 </PRE>
 </P>
-<DT><B>icap_preview_size</B><DD>
-<P>
+<DT><B>icap_preview_size</B><DD><P>
 <PRE>
 Default: -1
 
@@ -256,8 +264,7 @@ basis by OPTIONS requests.
         
 </PRE>
 </P>
-<DT><B>icap_default_options_ttl (seconds)</B><DD>
-<P>
+<DT><B>icap_default_options_ttl (seconds)</B><DD><P>
 <PRE>
 Default: 60
 
@@ -266,8 +273,7 @@ an Options-TTL header.
         
 </PRE>
 </P>
-<DT><B>icap_persistent_connections on|off</B><DD>
-<P>
+<DT><B>icap_persistent_connections on|off</B><DD><P>
 <PRE>
 Default: on
 
@@ -276,8 +282,7 @@ an ICAP server.
         
 </PRE>
 </P>
-<DT><B>icap_send_client_ip on|off</B><DD>
-<P>
+<DT><B>icap_send_client_ip on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -285,8 +290,7 @@ This adds the header "X-Client-IP" to ICAP requests.
         
 </PRE>
 </P>
-<DT><B>icap_send_client_username on|off</B><DD>
-<P>
+<DT><B>icap_send_client_username on|off</B><DD><P>
 <PRE>
 Default: off
 
@@ -295,8 +299,7 @@ if proxy access is authentified.
         
 </PRE>
 </P>
-<DT><B>icap_service</B><DD>
-<P>
+<DT><B>icap_service</B><DD><P>
 <PRE>
 Default: none
 
@@ -320,8 +323,7 @@ icap_service service_2 respmod_precache 0 icap://icap2.mydomain.net:1344/respmod
         
 </PRE>
 </P>
-<DT><B>icap_class</B><DD>
-<P>
+<DT><B>icap_class</B><DD><P>
 <PRE>
 Default: none
 
@@ -336,8 +338,7 @@ icap class class_2 service_1 service_3
         
 </PRE>
 </P>
-<DT><B>icap_access</B><DD>
-<P>
+<DT><B>icap_access</B><DD><P>
 <PRE>
 Default: none
 
@@ -361,8 +362,7 @@ icap_access class_1 allow all
 </PRE>
 </P>
 
-<DT><B>accept_filter</B><DD>
-<P>
+<DT><B>accept_filter</B><DD><P>
 <PRE>
 The name of an accept(2) filter to install on Squid's
 listen socket(s).  This feature is perhaps specific to
@@ -382,8 +382,7 @@ See the accf_http(9) man page.
 
 <P>
 <DL>
-<DT><B>http_port</B><DD>
-<P>New options:
+<DT><B>http_port</B><DD><P>New options:
 <PRE>
     disable-pmtu-discovery=
       Control Path-MTU discovery usage:
@@ -409,15 +408,13 @@ See the accf_http(9) man page.
         
 </PRE>
         </P>
-<DT><B> https_port</B><DD>
-<P>Removed options:
+<DT><B> https_port</B><DD><P>Removed options:
 <PRE>
     urlgroup=, not yet ported to Squid-3.
         
 </PRE>
 </P>
-<DT><B>cache_peer</B><DD>
-<P>New options:
+<DT><B>cache_peer</B><DD><P>New options:
 <PRE>
      basetime=n
 
@@ -457,8 +454,7 @@ See the accf_http(9) man page.
         
 </PRE>
 </P>
-<DT><B>cache_dir</B><DD>
-<P>Common options
+<DT><B>cache_dir</B><DD><P>Common options
 <PRE>
     no-store, replaces the older read-only option
 
@@ -481,8 +477,7 @@ See the accf_http(9) man page.
         
 </PRE>
 </P>
-<DT><B>auth_param</B><DD>
-<P>Removed Basic auth option
+<DT><B>auth_param</B><DD><P>Removed Basic auth option
 <PRE>
     blankpasswor, not yet ported to squid-3.
     auth_param basic concurrency 0
@@ -496,8 +491,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>external_acl_type</B><DD>
-<P>New format specifications:
+<DT><B>external_acl_type</B><DD><P>New format specifications:
 <PRE>
     %URI          Requested URI
 
@@ -521,8 +515,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>refresh_pattern</B><DD>
-<P>New options:
+<DT><B>refresh_pattern</B><DD><P>New options:
 <PRE>
     ignore-no-store
     refresh-ims
@@ -539,8 +532,7 @@ See the accf_http(9) man page.
         
 </PRE>
 </P>
-<DT><B>acl</B><DD>
-<P>New types:
+<DT><B>acl</B><DD><P>New types:
 <PRE>
     acl aclname http_status 200 301 500- 400-403 ...     # status code in reply
 
@@ -557,16 +549,14 @@ See the accf_http(9) man page.
         
 </PRE>
 </P>
-<DT><B>short_icon_urls</B><DD>
-<P>New default:
+<DT><B>short_icon_urls</B><DD><P>New default:
 <PRE>
     Default: on
     (Old default: off)
         
 </PRE>
 </P>
-<DT><B>delay_class</B><DD>
-<P>New delay classes:
+<DT><B>delay_class</B><DD><P>New delay classes:
 <PRE>
     class 4 Everything in a class 3 delay pool, with an
     additional limit on a per user basis. This
@@ -580,8 +570,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>htcp_port</B><DD>
-<P>New default to require the feature to be enabled in squid.conf:
+<DT><B>htcp_port</B><DD><P>New default to require the feature to be enabled in squid.conf:
 <PRE>
     Default: 0 (disabled)
     (Old default: 4827)
@@ -589,8 +578,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>icp_port</B><DD>
-<P>New default to require the feature to be enabled in squid.conf:
+<DT><B>icp_port</B><DD><P>New default to require the feature to be enabled in squid.conf:
 <PRE>
     Default: 0 (disabled)
     (Old default: 3130)
@@ -598,8 +586,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>snmp_port</B><DD>
-<P>New default to require the feature to be enabled in squid.conf:
+<DT><B>snmp_port</B><DD><P>New default to require the feature to be enabled in squid.conf:
 <PRE>
     Default: 0 (disabled)
     (Old default: 3401)
@@ -607,8 +594,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>logformat</B><DD>
-<P>New format tags:
+<DT><B>logformat</B><DD><P>New format tags:
 <PRE>
     rp      Request URL-Path excluding hostname
 
@@ -630,8 +616,7 @@ See the accf_http(9) man page.
 </PRE>
 </P>
 
-<DT><B>reply_body_max_size</B><DD>
-<P>Syntax changed:
+<DT><B>reply_body_max_size</B><DD><P>Syntax changed:
 <PRE>
     reply_body_max_size size [acl acl...]
         
@@ -639,8 +624,7 @@ See the accf_http(9) man page.
 </P>
 <P>allow/deny no longer used.</P>
 
-<DT><B>url_rewrite_program</B><DD>
-<P>No urlgroup support in either requests or responese</P>
+<DT><B>url_rewrite_program</B><DD><P>No urlgroup support in either requests or responese</P>
 </DL>
 </P>
 
@@ -651,32 +635,19 @@ See the accf_http(9) man page.
 
 <P>
 <DL>
-<DT><B>broken_vary_encoding</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>cache_vary</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>collapsed_forwarding</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>follow_x_forwarded_for</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>*_uses_indirect_client</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>error_map</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>header_access</B><DD>
-<P>This has been replaced by request_header_access and reply_header_access</P>
-<DT><B>http_access2</B><DD>
-<P>Not yet ported to Squid-3.</P>
-<DT><B>httpd_accel_no_pmtu_disc</B><DD>
-<P>Replaced by disable-pmtu-discovery http_port option</P>
-<DT><B>location_rewrite_*</B><DD>
-<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>
+<DT><B>broken_vary_encoding</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>cache_vary</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>collapsed_forwarding</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>follow_x_forwarded_for</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>*_uses_indirect_client</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>error_map</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>header_access</B><DD><P>This has been replaced by request_header_access and reply_header_access</P>
+<DT><B>http_access2</B><DD><P>Not yet ported to Squid-3.</P>
+<DT><B>httpd_accel_no_pmtu_disc</B><DD><P>Replaced by disable-pmtu-discovery http_port option</P>
+<DT><B>location_rewrite_*</B><DD><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>
 </P>
 
@@ -693,6 +664,8 @@ See the accf_http(9) man page.
 <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>
@@ -703,33 +676,27 @@ See the accf_http(9) man page.
 
 <P>
 <DL>
-<DT><B>--enable-shared[=PKGS]</B><DD>
-<P>Build shared libraries. The default is to build without.</P>
+<DT><B>--enable-shared[=PKGS]</B><DD><P>Build shared libraries. The default is to build without.</P>
 
-<DT><B>--enable-static[=PKGS]</B><DD>
-<P>Build static libraries. The default is on.</P>
+<DT><B>--enable-static[=PKGS]</B><DD><P>Build static libraries. The default is on.</P>
 
-<DT><B>--enable-fast-install[=PKGS]</B><DD>
-<P>
+<DT><B>--enable-fast-install[=PKGS]</B><DD><P>
 <PRE>
 Optimize for fast installation
         default: yes
 </PRE>
 </P>
 
-<DT><B>--disable-libtool-lock</B><DD>
-<P>Avoid locking (might break parallel builds)</P>
+<DT><B>--disable-libtool-lock</B><DD><P>Avoid locking (might break parallel builds)</P>
 
-<DT><B>--disable-optimizations</B><DD>
-<P>Don't compile Squid with compiler optimizations enabled.
+<DT><B>--disable-optimizations</B><DD><P>Don't compile Squid with compiler optimizations enabled.
 Optimization is good for production builds, but not
 good for debugging. During development, use
 --disable-optimizations to reduce compilation times
 and allow easier debugging. This option implicitly
 also enables --disable-inline</P>
 
-<DT><B>--disable-inline</B><DD>
-<P>Don't compile trivial methods as inline. Squid
+<DT><B>--disable-inline</B><DD><P>Don't compile trivial methods as inline. Squid
 is coded with much of the code able to be inlined.
 Inlining is good for production builds, but not
 good for development. During development, use
@@ -739,18 +706,15 @@ production builds, or load tests, use
 --enable-inline to have squid make all trivial
 methods inlinable by the compiler.</P>
 
-<DT><B>--enable-debug-cbdata</B><DD>
-<P>Provide some debug information in cbdata</P>
+<DT><B>--enable-debug-cbdata</B><DD><P>Provide some debug information in cbdata</P>
 
-<DT><B>--enable-disk-io=\"list of modules\"</B><DD>
-<P>Build support for the list of disk I/O modules.
+<DT><B>--enable-disk-io=\"list of modules\"</B><DD><P>Build support for the list of disk I/O modules.
 The default is only to build the "Blocking" module.
 See src/DiskIO for a list of available modules, or
 Programmers Guide for details on how to build your
 custom disk module.</P>
 
-<DT><B>--enable-esi</B><DD>
-<P>Enable ESI for accelerators. Requires libexpat.
+<DT><B>--enable-esi</B><DD><P>Enable ESI for accelerators. Requires libexpat.
 Enabling ESI will cause squid to follow the Edge
 Acceleration Specification (www.esi.org). This
 causes squid to IGNORE client Cache-Control headers.</P>
@@ -758,30 +722,23 @@ causes squid to IGNORE client Cache-Control headers.</P>
 proxy, ONLY use it in a squid configured for
 webserver acceleration.</P>
 
-<DT><B>--enable-icap-client</B><DD>
-<P>Enable the ICAP client.</P>
+<DT><B>--enable-icap-client</B><DD><P>Enable the ICAP client.</P>
 
-<DT><B>--disable-snmp</B><DD>
-<P>Disable SNMP monitoring support which is now built by default.</P>
+<DT><B>--disable-snmp</B><DD><P>Disable SNMP monitoring support which is now built by default.</P>
 
-<DT><B>--disable-htcp</B><DD>
-<P>Disable HTCP protocol support which is now built by default.</P>
+<DT><B>--disable-htcp</B><DD><P>Disable HTCP protocol support which is now built by default.</P>
 
-<DT><B>--enable-kqueue</B><DD>
-<P>Enable kqueue() support. Marked as experimental in 3.0.</P>
+<DT><B>--enable-kqueue</B><DD><P>Enable kqueue() support. Marked as experimental in 3.0.</P>
 
-<DT><B>--enable-ipfw-transparent</B><DD>
-<P>Enable Transparent Proxy support for systems
+<DT><B>--enable-ipfw-transparent</B><DD><P>Enable Transparent Proxy support for systems
 using FreeBSD IPFW style redirection.</P>
 
-<DT><B>--disable-mempools</B><DD>
-<P>Disable memPools. Note that this option now simply sets the
+<DT><B>--disable-mempools</B><DD><P>Disable memPools. Note that this option now simply sets the
 default behaviour. Specific classes can override this at runtime, and
 only lib/MemPool.c needs to be altered to change the squid-wide
 default for all classes.</P>
 
-<DT><B>--enable-cpu-profiling</B><DD>
-<P>This option allows you to see which internal functions
+<DT><B>--enable-cpu-profiling</B><DD><P>This option allows you to see which internal functions
 in Squid are consuming how much CPU. Compiles in probes
 that measure time spent in probed functions. Needs
 source modifications to add new probes. This is meant
@@ -791,21 +748,16 @@ of Squid internal functions.</P>
 you shouldn't enable this, as overhead added, although
 small, is still overhead. See lib/Profiler.c for more.</P>
 
-<DT><B>--with-gnu-ld</B><DD>
-<P>Assume the C compiler uses GNU ld. The default is to auto-detect.</P>
+<DT><B>--with-gnu-ld</B><DD><P>Assume the C compiler uses GNU ld. The default is to auto-detect.</P>
 
-<DT><B>--with-pic</B><DD>
-<P>Try to use only PIC/non-PIC objects. The default is to use both.</P>
+<DT><B>--with-pic</B><DD><P>Try to use only PIC/non-PIC objects. The default is to use both.</P>
 
-<DT><B>--with-tags[=TAGS]</B><DD>
-<P>Include additional configurations. The default is automatic.</P>
+<DT><B>--with-tags[=TAGS]</B><DD><P>Include additional configurations. The default is automatic.</P>
 
-<DT><B>--with-default-user=USER</B><DD>
-<P>Sets the default System User account for squid permissions.
+<DT><B>--with-default-user=USER</B><DD><P>Sets the default System User account for squid permissions.
 The default is 'nobody' as in other releases of squid.</P>
 
-<DT><B>--with-cppunit-basedir=[PATH]</B><DD>
-<P>Path where the cppunit headers and libraries are found
+<DT><B>--with-cppunit-basedir=[PATH]</B><DD><P>Path where the cppunit headers and libraries are found
 for unit testing. The default is automatic detection.</P>
 <P>NOTE: Since 3.0-PRE6 and 2.6STABLE14 squid no longer comes
 bundled with CPPUnit. Compile-time validation will be disabled
@@ -817,79 +769,66 @@ if it is not installed on your system.</P>
 
 <P>
 <DL>
-<DT><B>--enable-carp</B><DD>
-<P>CARP support is now built by default.
+<DT><B>--enable-carp</B><DD><P>CARP support is now built by default.
 --disable-carp can be used to buidl without it.</P>
 
-<DT><B>--enable-htcp</B><DD>
-<P>HTCP protocol support is now built by default.
+<DT><B>--enable-htcp</B><DD><P>HTCP protocol support is now built by default.
 Use --disable-htcp to build without it.</P>
 
-<DT><B>--enable-snmp</B><DD>
-<P>SNMP monitoring is now build by default.
+<DT><B>--enable-snmp</B><DD><P>SNMP monitoring is now build by default.
 Use --disable-snmp to build without it.</P>
 
-<DT><B>--with-valgrind-debug</B><DD>
-<P>Name changed to --with-valgrind</P>
-
-<DT><B>--enable-heap-replacement</B><DD>
-<P>Please use --enable-removal-policies directive instead.</P>
+<DT><B>--enable-heap-replacement</B><DD><P>Please use --enable-removal-policies directive instead.</P>
 
-<DT><B>--with-maxfd=N</B><DD>
-<P>Replaced by --with-filedescriptors=N</P>
+<DT><B>--with-maxfd=N</B><DD><P>Replaced by --with-filedescriptors=N</P>
 <P>Override maximum number of filedescriptors. Useful
 if you build as another user who is not privileged
 to use the number of filedescriptors you want the
 resulting binary to support</P>
 
-<DT><B>--enable-select</B><DD>
-<P>Deprecated.
+<DT><B>--enable-select</B><DD><P>Deprecated.
 Automatic checks will enable best I/O loop method available.</P>
 
-<DT><B>--enable-select-simple</B><DD>
-<P>Deprecated.
+<DT><B>--enable-epoll</B><DD><P>Deprecated.
 Automatic checks will enable best I/O loop method available.</P>
 
-<DT><B>--enable-epoll</B><DD>
-<P>Deprecated.
+<DT><B>--enable-poll</B><DD><P>Deprecated.
 Automatic checks will enable best I/O loop method available.</P>
 
-<DT><B>--enable-poll</B><DD>
-<P>Deprecated.
-Automatic checks will enable best I/O loop method available.</P>
+<DT><B>--enable-kqueue</B><DD><P>kqueue support is marked Experimental in Squid 3.0. Known to have some issues under load.</P>
 
-<DT><B>--enable-kqueue</B><DD>
-<P>Deprecated.
-Automatic checks will enable best I/O loop method available.</P>
+</DL>
+</P>
+<H3><A NAME="notportedoptions"></A> Not yet available options</H3>
 
-<DT><B>--enable-kqueue</B><DD>
-<P>kqueue support is marked Experimental in Squid 3.0
-Automatic configuration checks may enable if it is found as the best method on your OS.</P>
+<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><P>Support for Solaris /dev/poll</P>
 
-<DT><B>--with-large-files</B><DD>
-<P>Marked as Still Experimental in Squid 3.0</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
+client IP address</P>
 </DL>
 </P>
+
 <H3><A NAME="removedoptions"></A> Removed options</H3>
 
+<P>The following configure options have been removed.</P>
 <P>
 <DL>
-<P>
-<UL>
-<LI>--enable-dlmalloc</LI>
-<LI>--enable-mempool-debug</LI>
-<LI>--enable-forward-log</LI>
-<LI>--enable-multicast-miss</LI>
-<LI>--enable-coss-aio-ops</LI>
-<LI>--enable-devpoll</LI>
-<LI>--enable-large-cache-files (now built-in)</LI>
-<LI>--enable-truncate</LI>
-<LI>--enable-follow-x-forwarded-for</LI>
-</UL>
-</P>
+<DT><B>--enable-dlmalloc</B><DD><P>Most OS:es have good malloc implementations these days, and the version we used to ship with Squid was very very old..</P>
+<DT><B>--enable-mempool-debug</B><DD><P>Debug option, not needed and therefore removed.</P>
+<DT><B>--enable-forward-log</B><DD><P>Rarely used extra log file. Removed.</P>
+<DT><B>--enable-multicast-miss</B><DD><P>Rarely used feature, and multicast ICP acheives almost the same result. Removed.</P>
+<DT><B>--enable-coss-aio-ops</B><DD><P>Specific to the COSS implementation in Squid-2</P>
+<DT><B>--enable-large-cache-files</B><DD><P>Now enabled by default. Configure option was redundant and therefore removed.</P>
+<DT><B>--enable-truncate</B><DD><P>Known to cause race conditions where cache objects may get corrupted, and this for at most a marginal performance improvement. Removed.</P>
 
 </DL>
 </P>
+
 </BODY>
 </HTML>
index ed4d3bca272caea138bf9c86a9fb7a41ab786e9d..b6673b225f983f6442bfa107f0755c2bff36d454 100644 (file)
@@ -2,7 +2,7 @@
 <article>\r
 <title>Squid 3.0.PRE7 release notes</title>\r
 <author>Squid Developers</author>\r
-<date>$Id: release-3.0.sgml,v 1.27 2007/09/17 17:54:23 rousskov Exp $</date>\r
+<date>$Id: release-3.0.sgml,v 1.28 2007/09/17 21:06:10 hno Exp $</date>\r
 \r
 <abstract>\r
 This document contains the release notes for version 3.0 of Squid.\r
@@ -590,6 +590,7 @@ This section gives an account of those changes in three categories:
 <itemize>\r
        <item><ref id="newoptions" name="New options">\r
        <item><ref id="modifiedoptions" name="Changes to existing options">\r
+       <item><ref id="notportedoptions" name="Not yet available options">\r
        <item><ref id="removedoptions" name="Removed options">\r
 </itemize>\r
 <p>\r
@@ -722,9 +723,6 @@ This section gives an account of those changes in three categories:
        <p>SNMP monitoring is now build by default.\r
        Use --disable-snmp to build without it.</p>\r
 \r
-       <tag>--with-valgrind-debug</tag>\r
-       <p>Name changed to --with-valgrind</p>\r
-\r
        <tag>--enable-heap-replacement</tag>\r
        <p>Please use --enable-removal-policies directive instead.</p>\r
 \r
@@ -739,10 +737,6 @@ This section gives an account of those changes in three categories:
        <p>Deprecated.\r
        Automatic checks will enable best I/O loop method available.</p>\r
 \r
-       <tag>--enable-select-simple</tag>\r
-       <p>Deprecated.\r
-       Automatic checks will enable best I/O loop method available.</p>\r
-\r
        <tag>--enable-epoll</tag>\r
        <p>Deprecated.\r
        Automatic checks will enable best I/O loop method available.</p>\r
@@ -752,39 +746,48 @@ This section gives an account of those changes in three categories:
        Automatic checks will enable best I/O loop method available.</p>\r
 \r
        <tag>--enable-kqueue</tag>\r
-       <p>Deprecated.\r
-       Automatic checks will enable best I/O loop method available.</p>\r
-\r
-       <tag>--enable-kqueue</tag>\r
-       <p>kqueue support is marked Experimental in Squid 3.0\r
-       Automatic configuration checks may enable if it is found as the best method on your OS.</p>\r
-\r
-       <tag>--with-large-files</tag>\r
-       <p>Marked as Still Experimental in Squid 3.0</p>\r
+       <p>kqueue support is marked Experimental in Squid 3.0. Known to have some issues under load.</p>\r
 \r
 </descrip>\r
 </p>\r
 \r
+<sect2>Not yet available options<label id="notportedoptions">\r
 \r
-<sect2>Removed options<label id="removedoptions">\r
+<p>These configure options have not yet been ported to Squid-3. If you need something to do then\r
+porting one of these from Squid-2 to Squid-3 is most welcome.\r
 \r
-<p>\r
 <descrip>\r
+       <tag>--enable-devpoll</tag>\r
+       <p>Support for Solaris /dev/poll</p>\r
 \r
-<itemize>\r
-       <item>--enable-dlmalloc\r
-       <item>--enable-mempool-debug\r
-       <item>--enable-forward-log\r
-       <item>--enable-multicast-miss\r
-       <item>--enable-coss-aio-ops\r
-       <item>--enable-devpoll\r
-       <item>--enable-large-cache-files (now built-in)\r
-       <item>--enable-truncate\r
-       <item>--enable-follow-x-forwarded-for\r
-</itemize>\r
+       <tag>--enable-select-simple</tag>\r
+       <p>Basic POSIX select() loop without any binary fd_set optimizations.</p>\r
+\r
+       <tag>--enable-follow-x-forwarded-for</tag>\r
+       <p>Support following the X-Forwarded-For HTTP header for determining the\r
+       client IP address</p>\r
+</descrip>\r
+\r
+<sect2>Removed options<label id="removedoptions">\r
+\r
+<p>The following configure options have been removed.\r
+\r
+<descrip>\r
+       <tag>--enable-dlmalloc</tag>\r
+       <p>Most OS:es have good malloc implementations these days, and the version we used to ship with Squid was very very old..</p>\r
+       <tag>--enable-mempool-debug</tag>\r
+       <p>Debug option, not needed and therefore removed.</p>\r
+       <tag>--enable-forward-log</tag>\r
+       <p>Rarely used extra log file. Removed.</p>\r
+       <tag>--enable-multicast-miss</tag>\r
+       <p>Rarely used feature, and multicast ICP acheives almost the same result. Removed.</p>\r
+       <tag>--enable-coss-aio-ops</tag>\r
+       <p>Specific to the COSS implementation in Squid-2</p>\r
+       <tag>--enable-large-cache-files</tag>\r
+       <p>Now enabled by default. Configure option was redundant and therefore removed.\r
+       <tag>--enable-truncate</tag>\r
+       <p>Known to cause race conditions where cache objects may get corrupted, and this for at most a marginal performance improvement. Removed.</p>\r
 \r
 </descrip>\r
-</p>\r
-</sect2>\r
 \r
 </article>\r