doc/release-notes/release-3.3.sgml

   1 <!doctype linuxdoc system>
   2 <article>
   3 <title>Squid 3.3.0.0 release notes</title>
   4 <author>Squid Developers</author>
   5
   6 <abstract>
   7 This document contains the release notes for version 3.3 of Squid.
   8 Squid is a WWW Cache application developed by the National Laboratory
   9 for Applied Network Research and members of the Web Caching community.
  10 </abstract>
  11
  12 <toc>
  13
  14 <sect>Notice
  15 <p>
  16 The Squid Team are pleased to announce the release of Squid-3.3.0.0 for testing.
  17
  18 This new release is available for download from <url url="http://www.squid-cache.org/Versions/v3/3.3/"> or the <url url="http://www.squid-cache.org/Mirrors/http-mirrors.html" name="mirrors">.
  19
  20 While this release is not deemed ready for production use, we believe it is ready for wider testing by the community.
  21
  22 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.
  23
  24 <sect1>Known issues
  25 <p>
  26 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&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;target_milestone=3.3&amp;long_desc_type=allwordssubstr&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;status_whiteboard_type=allwordssubstr&amp;status_whiteboard=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailtype1=substring&amp;email1=&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=bugs.bug_severity&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=" name="open bugs against Squid-3.3">.
  27
  28 <sect1>Changes since earlier releases of Squid-3.3
  29 <p>
  30 The 3.3 change history can be <url url="http://www.squid-cache.org/Versions/v3/3.3/changesets/" name="viewed here">.
  31
  32 <sect>Major new features since Squid-3.2
  33 <p>Squid 3.3 represents a new feature release above 3.2.
  34
  35 <p>The most important of these new features are:
  36 <itemize>
  37         <item>...
  38 </itemize>
  39
  40 Most user-facing changes are reflected in squid.conf (see below).
  41
  42 <sect1>...
  43 <p>...
  44
  45
  46 <sect>Changes to squid.conf since Squid-3.2
  47 <p>
  48 There have been changes to Squid's configuration file since Squid-3.2.
  49
  50 This section gives a thorough account of those changes in three categories:
  51
  52 <itemize>
  53         <item><ref id="newtags" name="New tags">
  54         <item><ref id="modifiedtags" name="Changes to existing tags">
  55         <item><ref id="removedtags" name="Removed tags">
  56 </itemize>
  57 <p>
  58
  59 <sect1>New tags<label id="newtags">
  60 <p>
  61 <descrip>
  62
  63 </descrip>
  64
  65 <sect1>Changes to existing tags<label id="modifiedtags">
  66 <p>
  67 <descrip>
  68         <tag>logformat</tag>
  69         <p><em>%&gt;bs</em> Number of HTTP-equivalent message body bytes received from the next hop.
  70         <p><em>icap::%&gt;bs</em> Number of message body bytes received from the ICAP server.
  71 </descrip>
  72
  73
  74 <sect1>Removed tags<label id="removedtags">
  75 <p>
  76 <descrip>
  77
  78 </descrip>
  79
  80
  81 <sect>Changes to ./configure options since Squid-3.2
  82 <p>
  83 There have been some changes to Squid's build configuration since Squid-3.2.
  84
  85 This section gives an account of those changes in three categories:
  86
  87 <itemize>
  88         <item><ref id="newoptions" name="New options">
  89         <item><ref id="modifiedoptions" name="Changes to existing options">
  90         <item><ref id="removedoptions" name="Removed options">
  91 </itemize>
  92
  93
  94 <sect1>New options<label id="newoptions">
  95 <p>
  96 <descrip>
  97
  98 </descrip>
  99
 100 <sect1>Changes to existing options<label id="modifiedoptions">
 101 <p>
 102 <descrip>
 103
 104 </descrip>
 105 </p>
 106
 107 <sect1>Removed options<label id="removedoptions">
 108 <p>
 109 <descrip>
 110
 111 </descrip>
 112
 113
 114 <sect>Options Removed since Squid-2
 115
 116 <p>Some squid.conf and ./configure options which were available in Squid-2.6 and Squid-2.7 are made obsolete in Squid-3.3.
 117
 118 <sect1>Removed squid.conf options since Squid-2.7
 119 <p>
 120 <descrip>
 121         <tag>auth_param</tag>
 122         <p><em>blankpassword</em> option for basic scheme removed.
 123
 124         <tag>cache_peer</tag>
 125         <p><em>http11</em> Obsolete.
 126
 127         <tag>external_acl_type</tag>
 128         <p>Format tag <em>%{Header}</em> replaced by <em>%>{Header}</em>
 129         <p>Format tag <em>%{Header:member}</em> replaced by <em>%>{Header:member}</em>
 130
 131         <tag>header_access</tag>
 132         <p>Replaced by <em>request_header_access</em> and <em>reply_header_access</em>
 133
 134         <tag>http_port</tag>
 135         <p><em>no-connection-auth</em> replaced by <em>connection-auth=[on|off]</em>. Default is ON.
 136         <p><em>transparent</em> option replaced by <em>intercept</em>
 137         <p><em>http11</em> obsolete.
 138
 139         <tag>http_access2</tag>
 140         <p>Replaced by <em>adapted_http_access</em>
 141
 142         <tag>httpd_accel_no_pmtu_disc</tag>
 143         <p>Replaced by <em>http_port disable-pmtu-discovery=</em> option
 144
 145         <tag>incoming_rate</tag>
 146         <p>Obsolete.
 147
 148         <tag>redirector_bypass</tag>
 149         <p>Replaced by <em>url_rewrite_bypass</em>
 150
 151         <tag>server_http11</tag>
 152         <p>Obsolete.
 153
 154         <tag>upgrade_http0.9</tag>
 155         <p>Obsolete.
 156
 157         <tag>zph_local</tag>
 158         <p>Replaced by <em>qos_flows local-hit=</em>
 159
 160         <tag>zph_mode</tag>
 161         <p>Obsolete.
 162
 163         <tag>zph_option</tag>
 164         <p>Obsolete.
 165
 166         <tag>zph_parent</tag>
 167         <p>Replaced by <em>qos_flows parent-hit=</em>
 168
 169         <tag>zph_sibling</tag>
 170         <p>Replaced by <em>qos_flows sibling-hit=</em>
 171
 172 </descrip>
 173
 174 <sect1>Removed squid.conf options since Squid-2.6
 175 <p>
 176 <descrip>
 177         <tag>cache_dir</tag>
 178         <p><em>read-only</em> option replaced by <em>no-store</em>.
 179
 180 </descrip>
 181
 182 <sect1>Removed ./configure options since Squid-2.7
 183 <p>
 184 <descrip>
 185         <tag>--enable-coss-aio-ops</tag>
 186         <p>Obsolete.
 187
 188         <tag>--enable-devpoll</tag>
 189         <p>Replaced by automatic detection.
 190
 191         <tag>--enable-dlmalloc=LIB</tag>
 192         <p>Obsolete.
 193
 194         <tag>--enable-epoll</tag>
 195         <p>Replaced by automatic detection.
 196
 197         <tag>--enable-forward-log</tag>
 198         <p>Obsolete.
 199
 200         <tag>--enable-heap-replacement</tag>
 201         <p>Obsolete.
 202
 203         <tag>--enable-htcp</tag>
 204         <p>Obsolete. Enabled by default.
 205
 206         <tag>--enable-large-cache-files</tag>
 207         <p>Obsolete.
 208
 209         <tag>--enable-mempool-debug</tag>
 210         <p>Obsolete.
 211
 212         <tag>--enable-multicast-miss</tag>
 213         <p>Obsolete.
 214
 215         <tag>--enable-poll</tag>
 216         <p>Replaced by automatic detection.
 217
 218         <tag>--enable-select</tag>
 219         <p>Replaced by automatic detection.
 220
 221         <tag>--enable-select-simple</tag>
 222         <p>Replaced by automatic detection.
 223
 224         <tag>--enable-snmp</tag>
 225         <p>Obsolete. Enabled by default.
 226
 227         <tag>--enable-truncate</tag>
 228         <p>Obsolete.
 229
 230         <tag>--disable-kqueue</tag>
 231         <p>Obsolete. Disabled by default.
 232
 233 </descrip>
 234
 235
 236 <sect>Regressions since Squid-2.7
 237
 238 <p>Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.3
 239
 240 <p>If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.
 241
 242 <sect1>Missing squid.conf options available in Squid-2.7
 243 <p>
 244 <descrip>
 245         <tag>acl</tag>
 246         <p><em>urllogin</em> option not yet ported from 2.6
 247         <p><em>urlgroup</em> option not yet ported from 2.6
 248
 249         <tag>authenticate_ip_shortcircuit_access</tag>
 250         <p>Not yet ported from 2.7
 251
 252         <tag>authenticate_ip_shortcircuit_ttl</tag>
 253         <p>Not yet ported from 2.7
 254
 255         <tag>broken_vary_encoding</tag>
 256         <p>Not yet ported from 2.6
 257
 258         <tag>cache_dir</tag>
 259         <p><em>min-size</em> option not yet ported from Squid-2
 260         <p><em>COSS</em> storage type is lacking stability fixes from 2.6
 261         <p>COSS <em>overwrite-percent=</em> option not yet ported from 2.6
 262         <p>COSS <em>max-stripe-waste=</em> option not yet ported from 2.6
 263         <p>COSS <em>membufs=</em> option not yet ported from 2.6
 264         <p>COSS <em>maxfullbufs=</em> option not yet ported from 2.6
 265
 266         <tag>cache_peer</tag>
 267         <p><em>idle=</em> not yet ported from 2.7
 268         <p><em>monitorinterval=</em> not yet ported from 2.6
 269         <p><em>monitorsize=</em> not yet ported from 2.6
 270         <p><em>monitortimeout=</em> not yet ported from 2.6
 271         <p><em>monitorurl=</em> not yet ported from 2.6
 272
 273         <tag>cache_vary</tag>
 274         <p>Not yet ported from 2.6
 275
 276         <tag>collapsed_forwarding</tag>
 277         <p>Not yet ported from 2.6
 278
 279         <tag>error_map</tag>
 280         <p>Not yet ported from 2.6
 281
 282         <tag>external_acl_type</tag>
 283         <p><em>%ACL</em> format tag not yet ported from 2.6
 284         <p><em>%DATA</em> format tag not yet ported from 2.6
 285
 286         <tag>external_refresh_check</tag>
 287         <p>Not yet ported from 2.7
 288
 289         <tag>http_port</tag>
 290         <p><em>act-as-origin</em> not yet ported from 2.7
 291         <p><em>urlgroup=</em> not yet ported from 2.6
 292
 293         <tag>ignore_ims_on_miss</tag>
 294         <p>Not yet ported from 2.7
 295
 296         <tag>location_rewrite_access</tag>
 297         <p>Not yet ported from 2.6
 298
 299         <tag>location_rewrite_children</tag>
 300         <p>Not yet ported from 2.6
 301
 302         <tag>location_rewrite_concurrency</tag>
 303         <p>Not yet ported from 2.6
 304
 305         <tag>location_rewrite_program</tag>
 306         <p>Not yet ported from 2.6
 307
 308         <tag>logformat</tag>
 309         <p><em>%oa</em> tag not yet ported from 2.7
 310
 311         <tag>max_stale</tag>
 312         <p>Not yet ported from 2.7
 313
 314         <tag>refresh_pattern</tag>
 315         <p><em>stale-while-revalidate=</em> not yet ported from 2.7
 316         <p><em>ignore-stale-while-revalidate=</em> not yet ported from 2.7
 317         <p><em>max-stale=</em> not yet ported from 2.7
 318         <p><em>negative-ttl=</em> not yet ported from 2.7
 319
 320         <tag>refresh_stale_hit</tag>
 321         <p>Not yet ported from 2.7
 322
 323         <tag>storeurl_access</tag>
 324         <p>Not yet ported from 2.7
 325
 326         <tag>storeurl_rewrite_children</tag>
 327         <p>Not yet ported from 2.7
 328
 329         <tag>storeurl_rewrite_concurrency</tag>
 330         <p>Not yet ported from 2.7
 331
 332         <tag>storeurl_rewrite_program</tag>
 333         <p>Not yet ported from 2.7
 334
 335         <tag>update_headers</tag>
 336         <p>Not yet ported from 2.7
 337
 338         <tag>zero_buffers</tag>
 339         <p>Not yet ported from 2.7
 340
 341 </descrip>
 342
 343 <sect1>Missing ./configure options available in Squid-2.7
 344 <p>
 345 <descrip>
 346         <tag>--without-system-md5</tag>
 347
 348 </descrip>
 349
 350 </article>