Switch back to normal versioning. Bump the version to 1.3.3.
[obnox/wireshark/wip.git] / docbook / release-notes.xml
index 52c44252c5e61a75a40ac69336748fa9e47311cf..2db33350dc60a121f95b69d4a7f3f1008e88f657 100644 (file)
@@ -12,7 +12,7 @@ DOCUMENT SECTION
 <!--
 Wireshark Info
 -->
-  <!ENTITY WiresharkCurrentVersion "0.99.4">
+  <!ENTITY WiresharkCurrentVersion "1.3.3">
 
 ]>
 
@@ -27,48 +27,26 @@ Wireshark Info
   </section>
 
   <section id="WhatsNew"><title>What's New</title>
-    <section><title>Bug Fixes</title>
+    <section id="BugFixes"><title>Bug Fixes</title>
     <para>
 
       The following vulnerabilities have been fixed.  See the
-      <ulink url="http://www.wireshark.org/security/wnpa-sec-2006-02.html">security advisory</ulink> for details and a workaround.
+      <ulink url="http://www.wireshark.org/security/wnpa-sec-2007-02.html">security advisory</ulink> for details and a workaround.
 
       <itemizedlist>
 
-        <listitem><para>
-         The HTTP dissector could crash.
-         <!-- Fixed in r19022, r19153 -->
-         <!-- Bug IDs: 1050, 1079 -->
-         Versions affected: 0.99.3.
-        </para></listitem>
-
-        <listitem><para>
-         The LDAP dissector (and possibly others) could crash.
-         <!-- Fixed in r19154 -->
-         <!-- Bug IDs: 1079 -->
-         Versions affected: 0.99.3.
-        </para></listitem>
-
-        <listitem><para>
-         The XOT dissector could attempt to allocate a large amount of memory and crash.
-         <!-- Fixed in r19365 -->
-         <!-- Bug IDs: 1133 -->
-         Versions affected: 0.9.8 to 0.99.3.
-        </para></listitem>
-
-        <listitem><para>
-         The WBXML dissector could crash.
-         <!-- Fixed in r19560 -->
-         <!-- Bug IDs: 1134 -->
-         Versions affected: 0.10.11 to 0.99.3.
-        </para></listitem>
-
-        <listitem><para>
-         If AirPcap support was enabled, parsing a WEP key could sometimes cause a crash.
-         <!-- Fixed in r19401 -->
-         <!-- Bug IDs: None -->
-         Versions affected: 0.99.3.
-        </para></listitem>
+        <listitem>
+          <para>
+            The NetFlow dissector could run off with your dog, crash your truck,
+            and write a country music song about the experience.
+            <!-- Fixed in r????? -->
+            <!-- (Bug <ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=????">????</ulink>) -->
+          </para>
+          <para>Versions affected: 0.99.5 to 1.0.8</para>
+          <para>
+            <!-- <ulink url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-????">CVE-2007-????</ulink> -->
+          </para>
+        </listitem>
 
       </itemizedlist>
 
@@ -81,241 +59,66 @@ Wireshark Info
       <itemizedlist>
 
         <listitem><para>
-          The file set dialog could grow excessively large.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=331">Bug
-          331</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          Trying to save flow data may crash Wireshark.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=396">Bug
-          396</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          It may not be possible to re-order coloring rules under Windows.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=699">Bug
-          699</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          Printing each packet to a new page didn't work under Windows.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=707">Bug
-          707</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          The personal hosts configuration file wasn't being parsed correctly.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=795">Bug
-          795</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          "Save as" to an existing file wasn't allowed.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=927">Bug
-          927</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          The SNMP dissector was not handling 64-bit counters properly.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1047">Bug
-          1047</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          Wireshark and TShark would fail to start under Windows while trying to acquire a crypto context.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1096">Bug
-          1096</ulink>)
-        </para></listitem>
-
-        <listitem><para>
-          Invalid characters could show up in PDML output.
-          (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1110">Bug
-          1110</ulink>)
+            Wireshark could crash without warning.
         </para></listitem>
 
       </itemizedlist>
+
     </para>
 
     </section>
 
-    <section><title>New and Updated Features</title>
+    <section id="NewFeatures"><title>New and Updated Features</title>
     <para>
       The following features are new (or have been significantly updated)
-      since the last release:
-      <itemizedlist>
-
-        <listitem><para>
-        <ulink url="http://www.cacetech.com/products/airpcap.htm">AirPcap</ulink>,
-        support (which provides raw mode capture under Windows) has been
-        enhanced.
-        </para></listitem>
-
-        <listitem><para>
-        VoIP call playback has been enhanced.  If Wireshark is linked with
-        the PortAudio library, you can play back G.711 conversations.  This
-        feature is present in the standard Windows installer.
-        </para></listitem>
+      since version 1.2:
 
-        <listitem><para>
-        The capture interface dialog display has been enhanced.
-        </para></listitem>
-
-        <listitem><para>
-        The "Save" button has been removed from the "Ok" / "Apply" / "Cancel"
-        button group in the following dialogs:
-        <itemizedlist>
-          <listitem><para>Edit/Preferences</para></listitem>
-          <listitem><para>View/Coloring Rules</para></listitem>
-          <listitem><para>Capture/Capture Filters</para></listitem>
-          <listitem><para>Analyze/Display Filters</para></listitem>
-          <listitem><para>"Analyze/Enabled Protocols</para></listitem>
-        </itemizedlist>
-        If you're fond of the "Save" button it can be resurrected in the
-        User Interface preferences.
-        </para></listitem>
-
-        <listitem><para>
-        Reading from stdin ("-i -") now works under Windows.
-        </para></listitem>
+      <itemizedlist>
 
-        <listitem><para>
-        Expert analysis has been improved.
-        </para></listitem>
-
-        <listitem><para>
-        Wireshark now supports USB as a media type.
-        </para></listitem>
+        <listitem>
+          <para>
+            The packet list internals have been rewritten and are now more
+            efficient.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Python scripting support has been added.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Capturing from pipes on Windows has been improved.
+          </para>
+        </listitem>
+
+        <listitem>
+          <para>
+            Many memory leaks have been fixed.
+          </para>
+        </listitem>
 
       </itemizedlist>
+
     </para>
     </section>
 
-    <section><title>New Protocol Support</title>
+    <section id="NewProtocols"><title>New Protocol Support</title>
     <para>
 
-Enea LINX,
-Ethernet Powerlink (v1 and v2),
-H.248 Q.1950 Annex A,
-Linux pktgen,
-MP2T,
-NEWMAIL,
-PNG,
-SCSI OSD,
-UDLD,
-UMTS FP,
-USB,
-WLCCP,
-WZCSVC,
-
     </para>
     </section>
 
-    <section><title>Updated Protocol Support</title> <para>
-
-3Com NJACK,
-802.11,
-ACSE,
-AH,
-ALCAP,
-ANSI MAP,
-ATM,
-ASN.1,
-BACapp,
-BER,
-BGP,
-BSSAP,
-Camel,
-Catapult DCT2000,
-CFlow,
-CLNP,
-Common Windows networking,
-DAP,
-DCERPC (DCERPC, ATSVC, DFS, EFS, EPM, EVENTLOG, INITSHUTDOWN, MAPI, NT, PIPE, SAMR, SPOOLSS, SRVSVC, SVCCTL, WINREG),
-DCOM (DCOM, CBA-ACCO, SYSACT),
-DIAMETER,
-DISP,
-DNS,
-DOP,
-DSP,
-ESP,
-Ethernet,
-FC,
-FCP,
-GSM A,
-GSM MAP,
-GSM SMS,
-GSSAPI,
-GTP,
-H.225,
-H.245,
-H.248,
-HTTP,
-ICQ,
-IKE,
-ISAKMP,
-iSCSI,
-ISUP,
-IUUP,
-Kerberos 4,
-LAP-D,
-LDAP,
-LLC,
-LogotypeCertExtn,
-MEGACO,
-MIME Multipart,
-MIP6,
-MMS,
-MSRP,
-MTP3,
-NCP,
-NDMP,
-NDPS,
-NFS,
-NTP,
-OSI,
-PER,
-PN-MRP,
-PPP,
-19154Q.931,
-RADIUS,
-Redback,
-RPC,
-RTCP,
-RTP,
-SCCP,
-SCSI,
-SDP,
-SIP,
-SMB,
-SMRSE,
-SNMP,
-SSL,
-STANAG 5066,
-STP,
-TCAP,
-TCP,
-TFTP,
-TIPC,
-UDP,
-UMA,
-VLAN,
-VNC,
-VRRP,
-X.509ce
-X11,
-YMSG,
-WTLS,
-
+    <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
 
     </para>
     </section>
 
-    <section><title>New and Updated Capture File Support</title>
+    <section id="NewCapture"><title>New and Updated Capture File Support</title>
     <para>
 
-Catapult DCT2000, EyeSDN, iSeries
-
     </para>
     </section>
 
@@ -324,11 +127,10 @@ Catapult DCT2000, EyeSDN, iSeries
   <section id="GettingWireshark"><title>Getting Wireshark</title>
     <para>
       Wireshark source code and installation packages are available from
-      the <ulink url="http://www.wireshark.org/download.html">download
-      page</ulink> on the main web site.
+      <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
     </para>
 
-    <section><title>Vendor-supplied Packages</title>
+    <section id="VendorPackages"><title>Vendor-supplied Packages</title>
       <para>
        Most Linux and Unix vendors supply their own Wireshark packages.
        You can usually install or upgrade Wireshark using the package management
@@ -359,18 +161,73 @@ Catapult DCT2000, EyeSDN, iSeries
   <section id="KnownProblems"><title>Known Problems</title>
 
     <para>
-      On Windows systems the packet list scroll bar can sometimes disappear
-      or become unusable.  Until the problem is fixed you can work around it
-      by resizing the packet list or the main window.
-      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=220">Bug
-      220</ulink>)
+      Wireshark may appear offscreen on multi-monitor Windows systems.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=553">Bug
+      553</ulink>)
+    </para>
+
+    <para>
+      Wireshark might make your system disassociate from a wireless network
+      on OS X.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
+      1315</ulink>)
+    </para>
+
+    <para>
+      Dumpcap might not quit if Wireshark or TShark crashes.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
+      1419</ulink>)
+    </para>
+
+    <para>
+      Wireshark is unable to decrypt WPA group keys.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1420">Bug
+      1420</ulink>)
+    </para>
+
+    <para>
+      The BER dissector might infinitely loop.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
+      1516</ulink>)
+    </para>
+
+    <para>
+      Wireshark can't dynamically update the packet list. This means that host
+      name resolutions above a certain response time threshold won't show up in
+      the packet list.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1605">Bug
+      1605</ulink>)
+    </para>
+
+    <para>
+      Capture filters aren't applied when capturing from named pipes.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
+      1814</ulink>)
+    </para>
+
+    <para>
+      Wireshark might freeze when reading from a pipe.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2082">Bug
+      2082</ulink>)
+    </para>
+
+    <para>
+      Capturing from named pipes might be delayed on Windows.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2200">Bug
+      2200</ulink>)
+    </para>
+
+    <para>
+      Filtering tshark captures with display filters (-R) no longer works.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
+      2234</ulink>)
     </para>
 
     <para>
-      The <guibutton>Filter</guibutton> button is nonfunctional in the
-      file dialogs under Windows.
-      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=942">Bug
-      942</ulink>)
+      The 64-bit Windows installer does not ship with the same libraries as the
+      32-bit installer.
+      (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=3610">Bug
+      3610</ulink>)
     </para>
 
   </section>