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.4">
  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-2006-02.html">security advisory</ulink> for details and a workaround.
  35
  36       <itemizedlist>
  37
  38         <listitem><para>
  39           The HTTP dissector could crash.
  40           <!-- Fixed in r19022, r19153 -->
  41           <!-- Bug IDs: 1050, 1079 -->
  42           Versions affected: 0.99.3.
  43         </para></listitem>
  44
  45         <listitem><para>
  46           The LDAP dissector (and possibly others) could crash.
  47           <!-- Fixed in r19154 -->
  48           <!-- Bug IDs: 1079 -->
  49           Versions affected: 0.99.3.
  50         </para></listitem>
  51
  52         <listitem><para>
  53           The XOT dissector could attempt to allocate a large amount of memory and crash.
  54           <!-- Fixed in r19365 -->
  55           <!-- Bug IDs: 1133 -->
  56           Versions affected: 0.9.8 to 0.99.3.
  57         </para></listitem>
  58
  59         <listitem><para>
  60           If AirPcap support was enabled, parsing a WEP key could sometimes cause a crash.
  61           <!-- Fixed in r19401 -->
  62           <!-- Bug IDs: None -->
  63           Versions affected: 0.99.3.
  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         <listitem><para>
  77           The file set dialog could grow excessively large.
  78           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=331">Bug
  79           331</ulink>)
  80         </para></listitem>
  81
  82         <listitem><para>
  83           Trying to save flow data may crash Wireshark.
  84           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=396">Bug
  85           396</ulink>)
  86         </para></listitem>
  87
  88         <listitem><para>
  89           It may not be possible to re-order coloring rules under Windows.
  90           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=699">Bug
  91           699</ulink>)
  92         </para></listitem>
  93
  94         <listitem><para>
  95           Printing each packet to a new page didn't work under Windows.
  96           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=707">Bug
  97           707</ulink>)
  98         </para></listitem>
  99
 100         <listitem><para>
 101           The personal hosts configuration file wasn't being parsed correctly.
 102           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=795">Bug
 103           795</ulink>)
 104         </para></listitem>
 105
 106         <listitem><para>
 107           "Save as" to an existing file wasn't allowed.
 108           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=927">Bug
 109           927</ulink>)
 110         </para></listitem>
 111
 112         <listitem><para>
 113           The SNMP dissector was not handling 64-bit counters properly.
 114           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1047">Bug
 115           1047</ulink>)
 116         </para></listitem>
 117
 118         <listitem><para>
 119           Wireshark and TShark would fail to start under Windows while trying to acquire a crypto context.
 120           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1096">Bug
 121           1096</ulink>)
 122         </para></listitem>
 123
 124         <listitem><para>
 125           Invalid characters could show up in PDML output.
 126           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1110">Bug
 127           1110</ulink>)
 128         </para></listitem>
 129
 130       </itemizedlist>
 131     </para>
 132
 133     </section>
 134
 135     <section><title>New and Updated Features</title>
 136     <para>
 137       The following features are new (or have been significantly updated)
 138       since the last release:
 139       <itemizedlist>
 140
 141         <listitem><para>
 142         <ulink url="http://www.cacetech.com/products/airpcap.htm">AirPcap</ulink>,
 143         support (which provides raw mode capture under Windows) has been
 144         enhanced.
 145         </para></listitem>
 146
 147         <listitem><para>
 148         VoIP call playback has been enhanced.  If Wireshark is linked with
 149         the PortAudio library, you can play back G.711 conversations.  This
 150         feature is present in the standard Windows installer.
 151         </para></listitem>
 152
 153         <listitem><para>
 154         The capture interface dialog display has been enhanced.
 155         </para></listitem>
 156
 157         <listitem><para>
 158         The "Save" button has been removed from the "Ok" / "Apply" / "Cancel"
 159         button group in the following dialogs:
 160         <itemizedlist>
 161           <listitem><para>Edit/Preferences</para></listitem>
 162           <listitem><para>View/Coloring Rules</para></listitem>
 163           <listitem><para>Capture/Capture Filters</para></listitem>
 164           <listitem><para>Analyze/Display Filters</para></listitem>
 165           <listitem><para>"Analyze/Enabled Protocols</para></listitem>
 166         </itemizedlist>
 167         If you're fond of the "Save" button it can be resurrected in the
 168         User Interface preferences.
 169         </para></listitem>
 170
 171         <listitem><para>
 172         Reading from stdin ("-i -") now works under Windows.
 173         </para></listitem>
 174
 175         <listitem><para>
 176         Expert analysis has been improved.
 177         </para></listitem>
 178
 179         <listitem><para>
 180         Wireshark now supports USB as a media type.
 181         </para></listitem>
 182
 183       </itemizedlist>
 184     </para>
 185     </section>
 186
 187     <section><title>New Protocol Support</title>
 188     <para>
 189
 190 Enea LINX,
 191 Ethernet Powerlink (v1 and v2),
 192 H.248 Q.1950 Annex A,
 193 Linux pktgen,
 194 MP2T,
 195 NEWMAIL,
 196 PNG,
 197 SCSI OSD,
 198 UDLD,
 199 UMTS FP,
 200 USB,
 201 WLCCP,
 202 WZCSVC,
 203
 204     </para>
 205     </section>
 206
 207     <section><title>Updated Protocol Support</title> <para>
 208
 209 3Com NJACK,
 210 802.11,
 211 ACSE,
 212 AH,
 213 ALCAP,
 214 ANSI MAP,
 215 ATM,
 216 ASN.1,
 217 BACapp,
 218 BER,
 219 BGP,
 220 BSSAP,
 221 Camel,
 222 Catapult DCT2000,
 223 CFlow,
 224 CLNP,
 225 Common Windows networking,
 226 DAP,
 227 DCERPC (DCERPC, ATSVC, DFS, EFS, EPM, EVENTLOG, INITSHUTDOWN, MAPI, NT, PIPE, SAMR, SPOOLSS, SRVSVC, SVCCTL, WINREG),
 228 DCOM (DCOM, CBA-ACCO, SYSACT),
 229 DIAMETER,
 230 DISP,
 231 DNS,
 232 DOP,
 233 DSP,
 234 ESP,
 235 Ethernet,
 236 FC,
 237 FCP,
 238 GSM A,
 239 GSM MAP,
 240 GSM SMS,
 241 GSSAPI,
 242 GTP,
 243 H.225,
 244 H.245,
 245 H.248,
 246 HTTP,
 247 ICQ,
 248 IKE,
 249 ISAKMP,
 250 iSCSI,
 251 ISUP,
 252 IUUP,
 253 Kerberos 4,
 254 LAP-D,
 255 LDAP,
 256 LLC,
 257 LogotypeCertExtn,
 258 MEGACO,
 259 MIME Multipart,
 260 MIP6,
 261 MMS,
 262 MSRP,
 263 MTP3,
 264 NCP,
 265 NDMP,
 266 NDPS,
 267 NFS,
 268 NTP,
 269 OSI,
 270 PER,
 271 PN-MRP,
 272 PPP,
 273 19154Q.931,
 274 RADIUS,
 275 Redback,
 276 RPC,
 277 RTCP,
 278 RTP,
 279 SCCP,
 280 SCSI,
 281 SDP,
 282 SIP,
 283 SMB,
 284 SMRSE,
 285 SNMP,
 286 SSL,
 287 STANAG 5066,
 288 STP,
 289 TCAP,
 290 TCP,
 291 TFTP,
 292 TIPC,
 293 UDP,
 294 UMA,
 295 VLAN,
 296 VNC,
 297 VRRP,
 298 X.509ce
 299 X11,
 300 YMSG,
 301 WTLS,
 302
 303
 304     </para>
 305     </section>
 306
 307     <section><title>New and Updated Capture File Support</title>
 308     <para>
 309
 310 Catapult DCT2000, EyeSDN, iSeries
 311
 312     </para>
 313     </section>
 314
 315   </section>
 316
 317   <section id="GettingWireshark"><title>Getting Wireshark</title>
 318     <para>
 319       Wireshark source code and installation packages are available from
 320       the <ulink url="http://www.wireshark.org/download.html">download
 321       page</ulink> on the main web site.
 322     </para>
 323
 324     <section><title>Vendor-supplied Packages</title>
 325       <para>
 326         Most Linux and Unix vendors supply their own Wireshark packages.
 327         You can usually install or upgrade Wireshark using the package management
 328         system specific to that platform.  A list of third-party packages
 329         can be found on the
 330         <ulink url="http://www.wireshark.org/download.html#otherplat">download page</ulink> on the Wireshark web site.
 331       </para>
 332     </section>
 333
 334   </section>
 335
 336   <!-- XXX needs to be written
 337   <section id="RemovingWireshark"><title>Removing Wireshark</title>
 338     <para>
 339     </para>
 340   </section>
 341   -->
 342
 343   <section id="FileLocations"><title>File Locations</title>
 344     <para>
 345       Wireshark and TShark look in several different locations for
 346       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 347       These locations vary from platform to platform.  You can use
 348       About->Folders to find the default locations on your system.
 349     </para>
 350   </section>
 351
 352   <section id="KnownProblems"><title>Known Problems</title>
 353
 354     <para>
 355       On Windows systems the packet list scroll bar can sometimes disappear
 356       or become unusable.  Until the problem is fixed you can work around it
 357       by resizing the packet list or the main window.
 358       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=220">Bug
 359       220</ulink>)
 360     </para>
 361
 362     <para>
 363       The <guibutton>Filter</guibutton> button is nonfunctional in the
 364       file dialogs under Windows.
 365       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=942">Bug
 366       942</ulink>)
 367     </para>
 368
 369   </section>
 370
 371   <section id="GettingHelp"><title>Getting Help</title>
 372     <para>
 373     Community support is available on the wireshark-users mailing list.
 374     Subscription information and archives for all of Wireshark's mailing
 375     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
 376     web site</ulink>.
 377     </para>
 378     <para>
 379     Commercial support, training, and development services are available
 380     from <ulink url="http://www.cacetech.com/">CACE Technologies</ulink>.
 381     </para>
 382   </section>
 383
 384   <section id="FAQ"><title>Frequently Asked Questions</title>
 385     <para>
 386     A complete FAQ is available on the
 387     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
 388     </para>
 389   </section>
 390
 391 </article>