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 "1.5.0">
  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 id="BugFixes"><title>Bug Fixes</title>
  31
  32     <para>
  33
  34     The following bugs have been fixed:
  35
  36       <itemizedlist>
  37
  38         <listitem><para>
  39           Wireshark is unresponsive when capturing from named pipes on Windows.
  40           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1759">Bug
  41           1759</ulink>)
  42         </para></listitem>
  43
  44       </itemizedlist>
  45
  46     </para>
  47
  48     </section>
  49
  50     <section id="NewFeatures"><title>New and Updated Features</title>
  51     <para>
  52       The following features are new (or have been significantly updated)
  53       since version 1.2:
  54
  55       <itemizedlist>
  56
  57         <listitem>
  58           <para>
  59             The packet list internals have been rewritten and are now more
  60             efficient.
  61           </para>
  62         </listitem>
  63
  64         <listitem>
  65           <para>
  66             Columns are easier to use. You can add a protocol field as a column
  67             by right-clicking on its packet detail item, and you can adjust
  68             some column preferences by right-clicking the column header.
  69           </para>
  70         </listitem>
  71
  72         <listitem>
  73           <para>
  74             Preliminary Python scripting support has been added.
  75           </para>
  76         </listitem>
  77
  78         <listitem>
  79           <para>
  80             Many memory leaks have been fixed.
  81           </para>
  82         </listitem>
  83
  84         <listitem>
  85           <para>
  86             Wireshark no longer supports Windows 2000. Please use
  87             Wireshark 1.2 or 1.0 on those systems.
  88           </para>
  89         </listitem>
  90
  91         <listitem>
  92           <para>
  93             Packets can now be ignored (excluded from dissection), similar to
  94             the way they can be marked.
  95           </para>
  96         </listitem>
  97
  98         <listitem>
  99           <para>
 100             Manual IP address resolution is now supported.
 101           </para>
 102         </listitem>
 103
 104         <listitem>
 105           <para>
 106             Columns with seconds can now be displayed as hours, minutes and
 107             seconds.
 108           </para>
 109         </listitem>
 110
 111         <listitem>
 112           <para>
 113             You can now set the capture buffer size on UNIX and Linux if you have
 114             libpcap 1.0.0 or greater.
 115           </para>
 116         </listitem>
 117
 118         <listitem>
 119           <para>
 120             TShark no longer needs elevated privileges on UNIX or Linux to list
 121             interfaces. Only dumpcap requires privileges now.
 122           </para>
 123         </listitem>
 124
 125         <listitem>
 126           <para>
 127             Wireshark and TShark can enable 802.11 monitor mode directly if you
 128             have libpcap 1.0.0 or greater.
 129           </para>
 130         </listitem>
 131
 132         <listitem>
 133           <para>
 134             Play the RTP stream directly from the RTP Analysis.
 135           </para>
 136         </listitem>
 137
 138         <listitem>
 139           <para>
 140             Capinfos and editcap now respectively support time order checking
 141             and forcing.
 142           </para>
 143         </listitem>
 144
 145       </itemizedlist>
 146
 147     </para>
 148     </section>
 149
 150     <section id="NewProtocols"><title>New Protocol Support</title>
 151     <para>
 152
 153     </para>
 154     </section>
 155
 156     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
 157
 158     </para>
 159     </section>
 160
 161     <section id="NewCapture"><title>New and Updated Capture File Support</title>
 162     <para>
 163
 164     </para>
 165     </section>
 166
 167   </section>
 168
 169   <section id="GettingWireshark"><title>Getting Wireshark</title>
 170     <para>
 171       Wireshark source code and installation packages are available from
 172       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
 173     </para>
 174
 175     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
 176       <para>
 177         Most Linux and Unix vendors supply their own Wireshark packages.
 178         You can usually install or upgrade Wireshark using the package management
 179         system specific to that platform.  A list of third-party packages
 180         can be found on the
 181         <ulink url="http://www.wireshark.org/download.html#thirdparty">download page</ulink>
 182         on the Wireshark web site.
 183       </para>
 184     </section>
 185
 186   </section>
 187
 188   <!-- XXX needs to be written
 189   <section id="RemovingWireshark"><title>Removing Wireshark</title>
 190     <para>
 191     </para>
 192   </section>
 193   -->
 194
 195   <section id="FileLocations"><title>File Locations</title>
 196     <para>
 197       Wireshark and TShark look in several different locations for
 198       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 199       These locations vary from platform to platform.  You can use
 200       About->Folders to find the default locations on your system.
 201     </para>
 202   </section>
 203
 204   <section id="KnownProblems"><title>Known Problems</title>
 205
 206     <para>
 207       Wireshark may appear offscreen on multi-monitor Windows systems.
 208       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=553">Bug
 209       553</ulink>)
 210     </para>
 211
 212     <para>
 213       Wireshark might make your system disassociate from a wireless network
 214       on OS X 10.4.
 215       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
 216       1315</ulink>)
 217     </para>
 218
 219     <para>
 220       Dumpcap might not quit if Wireshark or TShark crashes.
 221       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
 222       1419</ulink>)
 223     </para>
 224
 225     <para>
 226       The BER dissector might infinitely loop.
 227       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
 228       1516</ulink>)
 229     </para>
 230
 231     <para>
 232       Capture filters aren't applied when capturing from named pipes.
 233       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
 234       1814</ulink>)
 235     </para>
 236
 237     <para>
 238       Filtering tshark captures with display filters (-R) no longer works.
 239       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
 240       2234</ulink>)
 241     </para>
 242
 243     <para>
 244       The 64-bit Windows installer does not ship with the same libraries as the
 245       32-bit installer.
 246       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=3610">Bug
 247       3610</ulink>)
 248     </para>
 249
 250     <para>
 251       Application crash when changing real-time option.
 252       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4035">Bug
 253       4035</ulink>)
 254     </para>
 255
 256     <para>
 257       Hex pane display issue after startup.
 258       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4056">Bug
 259       4056</ulink>)
 260     </para>
 261
 262     <para>
 263       Crash when sorting column while capturing.
 264       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4273">Bug
 265       4273</ulink>)
 266     </para>
 267
 268     <para>
 269       Packet list rows are oversized.
 270       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4357">Bug
 271       4357</ulink>)
 272     </para>
 273
 274     <para>
 275       Summary pane selected frame highlighting not maintained.
 276       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4445">Bug
 277       4445</ulink>)
 278     </para>
 279
 280   </section>
 281
 282   <section id="GettingHelp"><title>Getting Help</title>
 283     <para>
 284     Community support is available on the wireshark-users mailing list.
 285     Subscription information and archives for all of Wireshark's mailing
 286     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
 287     web site</ulink>.
 288     </para>
 289     <para>
 290     Commercial support is available from
 291     <ulink url="http://www.cacetech.com/products/sharknet.html">CACE Technologies</ulink>.
 292     </para>
 293     <para>
 294     Training is available from
 295     <ulink url="http://www.wiresharktraining.com/">Wireshark University</ulink>.
 296     </para>
 297   </section>
 298
 299   <section id="FAQ"><title>Frequently Asked Questions</title>
 300     <para>
 301     A complete FAQ is available on the
 302     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
 303     </para>
 304   </section>
 305
 306 </article>