From Graham Bloice:
[obnox/wireshark/wip.git] / docbook / release-notes.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5 <!-- $Id$ -->
6
7 <!--
8 DOCUMENT SECTION
9 -Use this section to encode all document information
10 -->
11
12 <!--
13 Wireshark Info
14 -->
15   <!ENTITY WiresharkCurrentVersion "0.99.5">
16
17 ]>
18
19 <article>
20   <title>Wireshark &WiresharkCurrentVersion; Release Notes</title>
21
22   <section id="WhatIs"><title>What is Wireshark?</title>
23     <para>
24       Wireshark is the world's most popular network protocol analyzer.  It
25       is used for troubleshooting, analysis, development, and education.
26     </para>
27   </section>
28
29   <section id="WhatsNew"><title>What's New</title>
30     <section><title>Bug Fixes</title>
31     <para>
32
33       The following vulnerabilities have been fixed.  See the
34       <ulink url="http://www.wireshark.org/security/wnpa-sec-2007-01.html">security advisory</ulink> for details and a workaround.
35
36       <itemizedlist>
37
38         <listitem><para>
39           The TCP dissector could hang or crash while reassembling HTTP packets.
40           <!-- Fixed in r19859 -->
41           <!-- Bug IDs: 1200 -->
42           Versions affected: 0.99.2 to 0.99.4
43         </para></listitem>
44
45         <listitem><para>
46           The HTTP dissector could crash.
47           <!-- Fixed in 19899 -->
48           <!-- Bug IDs: None -->
49           Versions affected: 0.99.3 to 0.99.4
50         </para></listitem>
51
52         <listitem><para>
53           On some systems, the IEEE 802.11 dissector could crash.
54           <!-- Fixed in 20126 -->
55           <!-- Bug IDs: None -->
56           Versions affected: 0.10.14 to 0.99.4
57         </para></listitem>
58
59         <listitem><para>
60           On some systems, the LLT dissector could crash.
61           <!-- Fixed in 20007 -->
62           <!-- Bug IDs: None -->
63           Versions affected: 0.99.3 to 0.99.4
64         </para></listitem>
65
66       </itemizedlist>
67
68     </para>
69
70     <para>
71
72     The following bugs have been fixed:
73
74       <itemizedlist>
75
76         <para>
77           On Windows systems the packet list scroll bar could sometimes
78           disappear or become unusable.
79           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=220">Bug
80           220</ulink>)
81         </para>
82
83         <listitem><para>
84           The end of HTTP chunked encoding wasn't being displayed.
85           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=646">Bug
86           646</ulink>)
87         </para></listitem>
88
89         <listitem><para>
90           The Follow TCP Stream window could omit characters.
91           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1043">Bug
92           1043</ulink>)
93         </para></listitem>
94
95         <listitem><para>
96           Opening a flow graph could crash Wireshark.
97           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1117">Bug
98           1117</ulink>)
99         </para></listitem>
100
101         <listitem><para>
102           Follow TCP Stream would sometimes get the direction wrong.
103           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1138">Bug
104           1138</ulink>)
105         </para></listitem>
106
107         <listitem><para>
108           The foreground text in the coloring rules editor was always black..
109           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1164">Bug
110           1164</ulink>)
111         </para></listitem>
112
113         <listitem><para>
114           The CSV export format was incorrect.
115           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1173">Bug
116           1173</ulink>)
117         </para></listitem>
118
119         <listitem><para>
120           On some Windows systems Wireshark could take a long time to start up.
121         </para></listitem>
122
123       </itemizedlist>
124     </para>
125
126     </section>
127
128     <section><title>New and Updated Features</title>
129     <para>
130       The following features are new (or have been significantly updated)
131       since the last release:
132       <itemizedlist>
133
134         <listitem><para>
135         WPA and WPA2 decryption support has been added.  The TDS / MS SQL
136         dissector now de-obfuscates passwords.
137         </para></listitem>
138
139         <listitem><para>
140         64-bit file handling has been improved.
141         </para></listitem>
142
143         <listitem><para>
144         The <command>Find</command> function now selects the corresponding.
145         packet detail item.
146         </para></listitem>
147
148         <listitem><para>
149         <command>Find</command> functionality has been added to the TCP and
150         SSL stream dialogs.
151         </para></listitem>
152
153         <listitem><para>
154         Main window keyboard navigation has been improved.
155         </para></listitem>
156
157         <listitem><para>
158         SNMPv3 decryption.
159         </para></listitem>
160
161         <listitem><para>
162         <ulink url="http://www.cacetech.com/products/airpcap.htm">AirPcap</ulink>
163         support (which provides raw mode capture under Windows) has been
164         enhanced to allow capturing on multiple AirPcap adapters
165         simultaneously using the Multi-Channel Aggregator.
166         </para></listitem>
167
168         <listitem><para>
169         You can no longer install Wireshark on Windows 95, 98, or ME.  (OK,
170         so it's not a <emphasis>feature</emphasis> per se&#2026;)
171         </para></listitem>
172
173
174       </itemizedlist>
175     </para>
176     </section>
177
178     <section><title>New Protocol Support</title>
179     <para>
180
181 DMP,
182 NBD,
183 OMAPI,
184 RGMP,
185 Roofnet,
186 STUN v2
187
188     </para>
189     </section>
190
191     <section><title>Updated Protocol Support</title> <para>
192
193 2dparityfec,
194 ACN,
195 AIM,
196 AMR,
197 ANSI 637,
198 ANSI A,
199 ANSI MAP,
200 ARP,
201 ASN.1 BER,
202 ASN.1 PER,
203 BACapp,
204 BPDU,
205 CAMEL,
206 DCERPC (DCERPC, EFS, EVENTLOG, NSPI, PN-IO, WINREG),
207 DCOM CBA,
208 DCP,
209 DHCP,
210 DHCPv6,
211 DMP,
212 DNS,
213 EAP,
214 EPL,
215 ETSI DCP,
216 FCP,
217 GIOP,
218 GSM A,
219 H.245,
220 H.248,
221 HPSW,
222 HTTP,
223 ICMP,
224 ICMPv6,
225 IEEE 802.11,
226 IMAP,
227 INAP,
228 IPMI,
229 IPsec,
230 IRC,
231 ISAKMP,
232 iSCSI,
233 ISIS LSP,
234 IuUP,
235 K12,
236 Kerberos,
237 LDAP,
238 LLDP,
239 MEGACO,
240 MGCP,
241 MIME Multipart,
242 MMS,
243 MMSE,
244 MSRP,
245 MySQL,
246 NetFlow,
247 NFS,
248 NTLMSSP,
249 NTP,
250 OSPF,
251 PN-PTCP,
252 PPPoE,
253 Q.931,
254 Radiotap,
255 RADIUS,
256 RPC,
257 RSVP,
258 RTCP,
259 S4406,
260 SCCP,
261 SCSI,
262 SDP,
263 SES,
264 sFlow,
265 SIGCOMP,
266 SIP,
267 SIR,
268 Skinny,
269 SMB (SMB, NETLOGON),
270 SMTP,
271 SNMP,
272 SPNEGO,
273 SSL,
274 T.38,
275 TCP,
276 TDS,
277 text/media,
278 TIPC,
279 UDP Lite,
280 UDP,
281 UMA,
282 UMTS FP,
283 USB,
284 VNC,
285 WBXML,
286 WLCCP,
287 WSP,
288 X.411,
289 X.420,
290 XML,
291 XOT,
292 YMSG
293
294     </para>
295     </section>
296
297     <section><title>New and Updated Capture File Support</title>
298     <para>
299
300 Catapult DCT2000, Netttl, Windows Sniffer / NetXray
301
302     </para>
303     </section>
304
305   </section>
306
307   <section id="GettingWireshark"><title>Getting Wireshark</title>
308     <para>
309       Wireshark source code and installation packages are available from
310       the <ulink url="http://www.wireshark.org/download.html">download
311       page</ulink> on the main web site.
312     </para>
313
314     <section><title>Vendor-supplied Packages</title>
315       <para>
316         Most Linux and Unix vendors supply their own Wireshark packages.
317         You can usually install or upgrade Wireshark using the package management
318         system specific to that platform.  A list of third-party packages
319         can be found on the
320         <ulink url="http://www.wireshark.org/download.html#otherplat">download page</ulink> on the Wireshark web site.
321       </para>
322     </section>
323
324   </section>
325
326   <!-- XXX needs to be written
327   <section id="RemovingWireshark"><title>Removing Wireshark</title>
328     <para>
329     </para>
330   </section>
331   -->
332
333   <section id="FileLocations"><title>File Locations</title>
334     <para>
335       Wireshark and TShark look in several different locations for
336       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
337       These locations vary from platform to platform.  You can use
338       About->Folders to find the default locations on your system.
339     </para>
340   </section>
341
342   <section id="KnownProblems"><title>Known Problems</title>
343
344     <para>
345       The <guibutton>Filter</guibutton> button is nonfunctional in the
346       file dialogs under Windows.
347       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=942">Bug
348       942</ulink>)
349     </para>
350
351   </section>
352
353   <section id="GettingHelp"><title>Getting Help</title>
354     <para>
355     Community support is available on the wireshark-users mailing list.
356     Subscription information and archives for all of Wireshark's mailing
357     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
358     web site</ulink>.
359     </para>
360     <para>
361     Commercial support, training, and development services are available
362     from <ulink url="http://www.cacetech.com/">CACE Technologies</ulink>.
363     </para>
364   </section>
365
366   <section id="FAQ"><title>Frequently Asked Questions</title>
367     <para>
368     A complete FAQ is available on the
369     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
370     </para>
371   </section>
372
373 </article>