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.3pre1">
  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:
  34
  35       <itemizedlist>
  36
  37         <listitem><para>
  38           The SCSI dissector could crash.
  39           <!-- Fixed in r18832 -->
  40           <!-- Bug IDs: 1034 -->
  41           Versions affected: 0.99.2.
  42         </para></listitem>
  43
  44         <listitem><para>
  45           If Wireshark was compiled with ESP decryption support, the
  46           IPsec ESP preference parser was susceptible to off-by-one
  47           errors.
  48           <!-- Fixed in r18856, r18915 -->
  49           <!-- Bug IDs: None -->
  50           Versions affected: 0.99.2.
  51         </para></listitem>
  52
  53       </itemizedlist>
  54
  55     </para>
  56
  57     </section>
  58
  59     <section><title>New and Updated Features</title>
  60     <para>
  61       The following features are new (or have been significantly updated)
  62       since the last release:
  63       <itemizedlist>
  64
  65         <listitem><para>
  66         ESP, Kerberos, and SSL decryption are now supported in the
  67         Windows installer.  (As as result, Wireshark is now subject to
  68         United States export controls.)
  69         </para></listitem>
  70
  71         <listitem><para>
  72         Wireshark can now generate ACL rules for several popular firewall
  73         products.
  74         </para></listitem>
  75
  76       </itemizedlist>
  77     </para>
  78     </section>
  79
  80     <section><title>New Protocol Support</title>
  81     <para>
  82
  83     </para>
  84     </section>
  85
  86     <section><title>Updated Protocol Support</title> <para>
  87
  88     </para>
  89     </section>
  90
  91     <section><title>New and Updated Capture File Support</title>
  92     <para>
  93
  94     </para>
  95     </section>
  96
  97   </section>
  98
  99   <section id="GettingWireshark"><title>Getting Wireshark</title>
 100     <para>
 101       Wireshark source code and installation packages are available from
 102       the <ulink url="http://www.wireshark.org/download.html">download
 103       page</ulink> on the main web site.
 104     </para>
 105
 106     <section><title>Vendor-supplied Packages</title>
 107       <para>
 108         Most Linux and Unix vendors supply their own Wireshark packages.
 109         You can install or upgrade Wireshark using the package management
 110         system specific to that platform.  A list of third-party packages
 111         can be found on the <ulink url="http://www.wireshark.org/download.html#otherplat">download page</ulink> on the Wireshark web site.
 112       </para>
 113     </section>
 114
 115   </section>
 116
 117   <!-- XXX needs to be written
 118   <section id="RemovingWireshark"><title>Removing Wireshark</title>
 119     <para>
 120     </para>
 121   </section>
 122   -->
 123
 124   <section id="FileLocations"><title>File Locations</title>
 125     <para>
 126       Wireshark and TShark look in several different locations for
 127       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 128       These locations vary from platform to platform.  You can use
 129       About->Folders to find the default locations on your system.
 130     </para>
 131   </section>
 132
 133   <section id="KnownProblems"><title>Known Problems</title>
 134
 135     <para>
 136       On Windows systems the packet list scroll bar can sometimes disappear
 137       or become unusable.  Until the problem is fixed you can work around it
 138       by resizing the packet list or the main window.
 139       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=220">Bug
 140       #220</ulink>)
 141     </para>
 142
 143     <para>
 144       The <guibutton>Filter</guibutton> button is nonfunctional in the
 145       file dialogs under Windows.
 146     </para>
 147
 148     <para>
 149       Trying to save flow data may crash Wireshark.
 150       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=396">Bug
 151       #396</ulink>)
 152     </para>
 153
 154     <para>
 155       It may not be possible to re-order coloring rules under Windows.
 156       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=699">Bug
 157       #699</ulink>)
 158     </para>
 159
 160     <para>
 161       Multiple tap interfaces may cause a crash under FreeBSD.
 162       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=757">Bug
 163       #757</ulink>)
 164     </para>
 165
 166     <para>
 167       Wireshark may crash while viewing TCP streams.
 168       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=852">Bug
 169       #852</ulink>)
 170     </para>
 171
 172   </section>
 173
 174   <section id="GettingHelp"><title>Getting Help</title>
 175     <para>
 176     Community support is available on the wireshark-users mailing list.
 177     Subscription information and archives for all of Wireshark's mailing
 178     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
 179     web site</ulink>.
 180     </para>
 181     <para>
 182     Commercial support, training, and development services are available
 183     from <ulink url="http://www.cacetech.com/">CACE Technologies</ulink>.
 184     </para>
 185   </section>
 186
 187   <section id="FAQ"><title>Frequently Asked Questions</title>
 188     <para>
 189     A complete FAQ is available on the
 190     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
 191     </para>
 192   </section>
 193
 194 </article>