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.3.3">
  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     <para>
  32
  33       The following vulnerabilities have been fixed.  See the
  34       <ulink url="http://www.wireshark.org/security/wnpa-sec-2007-02.html">security advisory</ulink> for details and a workaround.
  35
  36       <itemizedlist>
  37
  38         <listitem>
  39           <para>
  40             The NetFlow dissector could run off with your dog, crash your truck,
  41             and write a country music song about the experience.
  42             <!-- Fixed in r????? -->
  43             <!-- (Bug <ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=????">????</ulink>) -->
  44           </para>
  45           <para>Versions affected: 0.99.5 to 1.0.8</para>
  46           <para>
  47             <!-- <ulink url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-????">CVE-2007-????</ulink> -->
  48           </para>
  49         </listitem>
  50
  51       </itemizedlist>
  52
  53     </para>
  54
  55     <para>
  56
  57     The following bugs have been fixed:
  58
  59       <itemizedlist>
  60
  61         <listitem><para>
  62             Wireshark could crash without warning.
  63         </para></listitem>
  64
  65       </itemizedlist>
  66
  67     </para>
  68
  69     </section>
  70
  71     <section id="NewFeatures"><title>New and Updated Features</title>
  72     <para>
  73       The following features are new (or have been significantly updated)
  74       since version 1.2:
  75
  76       <itemizedlist>
  77
  78         <listitem>
  79           <para>
  80             The packet list internals have been rewritten and are now more
  81             efficient.
  82           </para>
  83         </listitem>
  84
  85         <listitem>
  86           <para>
  87             Python scripting support has been added.
  88           </para>
  89         </listitem>
  90
  91         <listitem>
  92           <para>
  93             Capturing from pipes on Windows has been improved.
  94           </para>
  95         </listitem>
  96
  97         <listitem>
  98           <para>
  99             Many memory leaks have been fixed.
 100           </para>
 101         </listitem>
 102
 103         <listitem>
 104           <para>
 105             Wireshark no longer supports Windows 2000. Please use
 106             Wireshark 1.2 or 1.0 on those systems.
 107           </para>
 108         </listitem>
 109
 110         <listitem>
 111           <para>
 112             Packtets can now be ignored (excluded from dissection), similar to
 113             the way they can be marked.
 114           </para>
 115         </listitem>
 116
 117       </itemizedlist>
 118
 119     </para>
 120     </section>
 121
 122     <section id="NewProtocols"><title>New Protocol Support</title>
 123     <para>
 124
 125     </para>
 126     </section>
 127
 128     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
 129
 130     </para>
 131     </section>
 132
 133     <section id="NewCapture"><title>New and Updated Capture File Support</title>
 134     <para>
 135
 136     </para>
 137     </section>
 138
 139   </section>
 140
 141   <section id="GettingWireshark"><title>Getting Wireshark</title>
 142     <para>
 143       Wireshark source code and installation packages are available from
 144       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
 145     </para>
 146
 147     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
 148       <para>
 149         Most Linux and Unix vendors supply their own Wireshark packages.
 150         You can usually install or upgrade Wireshark using the package management
 151         system specific to that platform.  A list of third-party packages
 152         can be found on the
 153         <ulink url="http://www.wireshark.org/download.html#otherplat">download page</ulink> on the Wireshark web site.
 154       </para>
 155     </section>
 156
 157   </section>
 158
 159   <!-- XXX needs to be written
 160   <section id="RemovingWireshark"><title>Removing Wireshark</title>
 161     <para>
 162     </para>
 163   </section>
 164   -->
 165
 166   <section id="FileLocations"><title>File Locations</title>
 167     <para>
 168       Wireshark and TShark look in several different locations for
 169       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 170       These locations vary from platform to platform.  You can use
 171       About->Folders to find the default locations on your system.
 172     </para>
 173   </section>
 174
 175   <section id="KnownProblems"><title>Known Problems</title>
 176
 177     <para>
 178       Wireshark may appear offscreen on multi-monitor Windows systems.
 179       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=553">Bug
 180       553</ulink>)
 181     </para>
 182
 183     <para>
 184       Wireshark might make your system disassociate from a wireless network
 185       on OS X.
 186       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
 187       1315</ulink>)
 188     </para>
 189
 190     <para>
 191       Dumpcap might not quit if Wireshark or TShark crashes.
 192       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
 193       1419</ulink>)
 194     </para>
 195
 196     <para>
 197       Wireshark is unable to decrypt WPA group keys.
 198       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1420">Bug
 199       1420</ulink>)
 200     </para>
 201
 202     <para>
 203       The BER dissector might infinitely loop.
 204       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
 205       1516</ulink>)
 206     </para>
 207
 208     <para>
 209       Wireshark can't dynamically update the packet list. This means that host
 210       name resolutions above a certain response time threshold won't show up in
 211       the packet list.
 212       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1605">Bug
 213       1605</ulink>)
 214     </para>
 215
 216     <para>
 217       Capture filters aren't applied when capturing from named pipes.
 218       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
 219       1814</ulink>)
 220     </para>
 221
 222     <para>
 223       Wireshark might freeze when reading from a pipe.
 224       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2082">Bug
 225       2082</ulink>)
 226     </para>
 227
 228     <para>
 229       Capturing from named pipes might be delayed on Windows.
 230       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2200">Bug
 231       2200</ulink>)
 232     </para>
 233
 234     <para>
 235       Filtering tshark captures with display filters (-R) no longer works.
 236       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
 237       2234</ulink>)
 238     </para>
 239
 240     <para>
 241       The 64-bit Windows installer does not ship with the same libraries as the
 242       32-bit installer.
 243       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=3610">Bug
 244       3610</ulink>)
 245     </para>
 246
 247   </section>
 248
 249   <section id="GettingHelp"><title>Getting Help</title>
 250     <para>
 251     Community support is available on the wireshark-users mailing list.
 252     Subscription information and archives for all of Wireshark's mailing
 253     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
 254     web site</ulink>.
 255     </para>
 256     <para>
 257     Commercial support, training, and development services are available
 258     from <ulink url="http://www.cacetech.com/">CACE Technologies</ulink>.
 259     </para>
 260   </section>
 261
 262   <section id="FAQ"><title>Frequently Asked Questions</title>
 263     <para>
 264     A complete FAQ is available on the
 265     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
 266     </para>
 267   </section>
 268
 269 </article>