]>
Commit | Line | Data |
---|---|---|
aee44ee6 AJ |
1 | <!doctype linuxdoc system> |
2 | <article> | |
3 | <title>Squid 5.0.0 release notes</title> | |
4 | <author>Squid Developers</author> | |
5 | ||
6 | <abstract> | |
7 | This document contains the release notes for version 4 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>The Squid Team are pleased to announce the release of Squid-5.0.0 for testing. | |
16 | ||
17 | This new release is available for download from <url url="http://www.squid-cache.org/Versions/v5/"> or the | |
18 | <url url="http://www.squid-cache.org/Download/http-mirrors.html" name="mirrors">. | |
19 | ||
20 | <p>While this release is not deemed ready for production use, we believe it is ready for wider testing by the community. | |
21 | ||
22 | <p>We welcome feedback and bug reports. If you find a bug, please see <url url="http://wiki.squid-cache.org/SquidFaq/BugReporting"> | |
23 | for how to submit a report with a stack trace. | |
24 | ||
25 | <sect1>Known issues | |
26 | <p>Although this release is deemed good enough for use in many setups, please note the existence of | |
27 | <url url="http://bugs.squid-cache.org/buglist.cgi?query_format=advanced&product=Squid&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&version=5" name="open bugs against Squid-5">. | |
28 | ||
29 | <sect1>Changes since earlier releases of Squid-5 | |
30 | <p> | |
31 | The Squid-4 change history can be <url url="http://www.squid-cache.org/Versions/v5/changesets/" name="viewed here">. | |
32 | ||
33 | ||
34 | <sect>Major new features since Squid-4 | |
35 | <p>Squid-5 represents a new feature release above Squid-4. | |
36 | ||
37 | <p>The most important of these new features are: | |
38 | <itemize> | |
565b91d8 | 39 | <item>ICAP Trailers |
aee44ee6 AJ |
40 | </itemize> |
41 | ||
42 | Most user-facing changes are reflected in squid.conf (see below). | |
43 | ||
44 | ||
565b91d8 AJ |
45 | <sect1>ICAP Trailers |
46 | <p>Details in <url url="https://datatracker.ietf.org/doc/draft-rousskov-icap-trailers/" name="Draft: ICAP Trailers"> | |
aee44ee6 | 47 | |
565b91d8 AJ |
48 | <p>The <em>Trailers</em> feature from HTTP is being proposed for addition to ICAP, |
49 | with some modifications. | |
aee44ee6 | 50 | |
565b91d8 AJ |
51 | <p>This implementation complies with version -01 of that draft: |
52 | <itemize> | |
53 | <item>Announces ICAP Trailer support via the ICAP Allow request header field. | |
54 | <item>Parses the ICAP response trailer if and only if the ICAP server signals | |
55 | its presence by sending both Trailer header and Allow/trailers in the | |
56 | ICAP response. | |
57 | </itemize> | |
58 | ||
59 | <p>For now Squid logs and ignores all parsed ICAP header fields. | |
aee44ee6 AJ |
60 | |
61 | ||
62 | <sect>Changes to squid.conf since Squid-4 | |
63 | <p> | |
64 | There have been changes to Squid's configuration file since Squid-4. | |
65 | ||
66 | This section gives a thorough account of those changes in three categories: | |
67 | ||
68 | <itemize> | |
69 | <item><ref id="newdirectives" name="New directives"> | |
70 | <item><ref id="modifieddirectives" name="Changes to existing directives"> | |
71 | <item><ref id="removeddirectives" name="Removed directives"> | |
72 | </itemize> | |
73 | <p> | |
74 | ||
75 | <sect1>New directives<label id="newdirectives"> | |
76 | <p> | |
77 | <descrip> | |
457c00d0 AJ |
78 | <tag>auth_schemes</tag> |
79 | <p>New access control to customize authentication schemes presence | |
80 | and order in Squid generated HTTP 401 (Unauthorized) and 407 | |
81 | (Proxy Authentication Required) responses. | |
aee44ee6 AJ |
82 | |
83 | </descrip> | |
84 | ||
85 | <sect1>Changes to existing directives<label id="modifieddirectives"> | |
86 | <p> | |
87 | <descrip> | |
c2afddd8 | 88 | <p>No changes to existing directives in this version. |
aee44ee6 AJ |
89 | |
90 | </descrip> | |
91 | ||
92 | <sect1>Removed directives<label id="removeddirectives"> | |
93 | <p> | |
94 | <descrip> | |
95 | <p>No removed directives in this version. | |
96 | ||
97 | </descrip> | |
98 | ||
99 | ||
100 | <sect>Changes to ./configure options since Squid-4 | |
101 | <p> | |
102 | There have been some changes to Squid's build configuration since Squid-4. | |
103 | ||
104 | This section gives an account of those changes in three categories: | |
105 | ||
106 | <itemize> | |
107 | <item><ref id="newoptions" name="New options"> | |
108 | <item><ref id="modifiedoptions" name="Changes to existing options"> | |
109 | <item><ref id="removedoptions" name="Removed options"> | |
110 | </itemize> | |
111 | ||
112 | ||
113 | <sect1>New options<label id="newoptions"> | |
114 | <p> | |
115 | <descrip> | |
116 | <p>No new options in this version. | |
117 | ||
118 | </descrip> | |
119 | ||
120 | <sect1>Changes to existing options<label id="modifiedoptions"> | |
121 | <p> | |
122 | <descrip> | |
123 | <p>No changes to existing options in this version. | |
124 | ||
125 | </descrip> | |
126 | </p> | |
127 | ||
128 | <sect1>Removed options<label id="removedoptions"> | |
129 | <p> | |
130 | <descrip> | |
c2afddd8 | 131 | <p>No removed options in this version. |
aee44ee6 AJ |
132 | |
133 | </descrip> | |
134 | ||
135 | ||
136 | <sect>Regressions since Squid-2.7 | |
137 | ||
138 | <p>Some squid.conf options which were available in Squid-2.7 are not yet available in Squid-5 | |
139 | ||
140 | <p>If you need something to do then porting one of these from Squid-2 is most welcome. | |
141 | ||
142 | <sect1>Missing squid.conf options available in Squid-2.7 | |
143 | <p> | |
144 | <descrip> | |
145 | <tag>broken_vary_encoding</tag> | |
146 | <p>Not yet ported from 2.6 | |
147 | ||
148 | <tag>cache_peer</tag> | |
149 | <p><em>monitorinterval=</em> not yet ported from 2.6 | |
150 | <p><em>monitorsize=</em> not yet ported from 2.6 | |
151 | <p><em>monitortimeout=</em> not yet ported from 2.6 | |
152 | <p><em>monitorurl=</em> not yet ported from 2.6 | |
153 | ||
154 | <tag>cache_vary</tag> | |
155 | <p>Not yet ported from 2.6 | |
156 | ||
157 | <tag>error_map</tag> | |
158 | <p>Not yet ported from 2.6 | |
159 | ||
160 | <tag>external_refresh_check</tag> | |
161 | <p>Not yet ported from 2.7 | |
162 | ||
163 | <tag>location_rewrite_access</tag> | |
164 | <p>Not yet ported from 2.6 | |
165 | ||
166 | <tag>location_rewrite_children</tag> | |
167 | <p>Not yet ported from 2.6 | |
168 | ||
169 | <tag>location_rewrite_concurrency</tag> | |
170 | <p>Not yet ported from 2.6 | |
171 | ||
172 | <tag>location_rewrite_program</tag> | |
173 | <p>Not yet ported from 2.6 | |
174 | ||
175 | <tag>refresh_pattern</tag> | |
176 | <p><em>stale-while-revalidate=</em> not yet ported from 2.7 | |
177 | <p><em>ignore-stale-while-revalidate=</em> not yet ported from 2.7 | |
178 | <p><em>negative-ttl=</em> not yet ported from 2.7 | |
179 | ||
180 | <tag>refresh_stale_hit</tag> | |
181 | <p>Not yet ported from 2.7 | |
182 | ||
183 | <tag>update_headers</tag> | |
184 | <p>Not yet ported from 2.7 | |
185 | ||
186 | </descrip> | |
187 | ||
188 | <sect>Copyright | |
189 | <p> | |
190 | Copyright (C) 1996-2016 The Squid Software Foundation and contributors | |
191 | <p> | |
192 | Squid software is distributed under GPLv2+ license and includes | |
193 | contributions from numerous individuals and organizations. | |
194 | Please see the COPYING and CONTRIBUTORS files for details. | |
195 | ||
196 | </article> |