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         <listitem><para>
  45           Ring buffers are no longer turned on by default when using multiple
  46           capture files.
  47         </para></listitem>
  48
  49       </itemizedlist>
  50
  51     </para>
  52
  53     </section>
  54
  55     <section id="NewFeatures"><title>New and Updated Features</title>
  56     <para>
  57       The following features are new (or have been significantly updated)
  58       since version 1.4:
  59
  60       <itemizedlist>
  61
  62         <listitem>
  63           <para>
  64             Wireshark can import text dumps, similar to text2pcap.
  65           </para>
  66         </listitem>
  67
  68         <listitem>
  69           <para>
  70             You can now view Wireshark's dissector tables (for example the
  71             TCP port to dissector mappings) from the main window.
  72           </para>
  73         </listitem>
  74
  75         <listitem>
  76           <para>
  77            TShark can show a specific occurrence of a field when using '-T fields'.
  78           </para>
  79         </listitem>
  80
  81         <listitem>
  82           <para>
  83             Custom columns can show a specific occurrence of a field.
  84           </para>
  85         </listitem>
  86
  87
  88         <listitem>
  89           <para>
  90             You can hide columns in the packet list.
  91           </para>
  92         </listitem>
  93
  94         <listitem>
  95           <para>
  96             Wireshark can now export SMB objects.
  97           </para>
  98         </listitem>
  99
 100         <listitem>
 101           <para>
 102             dftest and randpkt now have manual pages.
 103           </para>
 104         </listitem>
 105
 106         <listitem>
 107           <para>
 108             TShark can now display iSCSI service response times.
 109           </para>
 110         </listitem>
 111
 112
 113         <listitem>
 114           <para>
 115             Dumpcap can now save files with a user-specified group id.
 116           </para>
 117         </listitem>
 118
 119         <listitem>
 120           <para>
 121             Syntax checking is done for capture filters.
 122           </para>
 123         </listitem>
 124
 125         <listitem>
 126           <para>
 127             You can display the compiled BPF code for capture filters in the
 128             Capture Options dialog.
 129           </para>
 130         </listitem>
 131
 132         <listitem>
 133           <para>
 134             You can now navigate backwards and forwards through TCP and UDP
 135             sessions.
 136           </para>
 137         </listitem>
 138
 139         <listitem>
 140           <para>
 141             Packet length is (finally) a default column.
 142           </para>
 143         </listitem>
 144
 145         <listitem>
 146           <para>
 147             TCP window size is now avaiable both scaled and unscaled.
 148           </para>
 149         </listitem>
 150
 151         <listitem>
 152           <para>
 153             802.1q VLAN tags are now shown by the Ethernet II dissector.
 154           </para>
 155         </listitem>
 156
 157         <listitem>
 158           <para>
 159             Various dissectors now display some UTF-16 strings as proper Unicode
 160             including the DCE/RPC and SMB dissectors.
 161           </para>
 162         </listitem>
 163
 164         <listitem>
 165           <para>
 166             The RTP player now has an option to show the time of day in the
 167             graph in addition to the seconds since beginning of capture.
 168           </para>
 169         </listitem>
 170
 171       </itemizedlist>
 172
 173     </para>
 174     </section>
 175
 176     <section id="NewProtocols"><title>New Protocol Support</title>
 177     <para>
 178
 179 ADwin,
 180 ADwin-Config,
 181 Apache Etch,
 182 Aruba PAPI,
 183 Constrained Application Protocol (COAP),
 184 Digium TDMoE,
 185 Ether-S-I/O,
 186 FastCGI,
 187 Fibre Channel over InfiniBand (FCoIB),
 188 Gopher,
 189 Gigamon GMHDR,
 190 IDMP,
 191 Infiniband Socket Direct Protocol (SDP),
 192 JSON,
 193 MikroTik MAC-Telnet,
 194 Mongo Wire Protocol,
 195 Network Monitor 802.11 radio header,
 196 OPC UA ExtensionObjects,
 197 PPI-GEOLOCATION-GPS,
 198 ReLOAD,
 199 ReLOAD Framing,
 200 SAMETIME,
 201 SCoP,
 202 SGSAP,
 203 Tektronix Teklink,
 204 WAI authentication,
 205 Wi-Fi P2P (Wi-Fi Direct)
 206
 207     </para>
 208     </section>
 209
 210     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
 211
 212     </para>
 213     </section>
 214
 215     <section id="NewCapture"><title>New and Updated Capture File Support</title>
 216     <para>
 217
 218 Apple PacketLogger,
 219 Catapult DCT2000,
 220 Daintree SNA,
 221 Endace ERF,
 222 IPFIX (the file format, not the protocol),
 223 Lucent/Ascend debug,
 224 Microsoft Network Monitor,
 225 Network Instruments,
 226 TamoSoft CommView,
 227 VMS TCPTrace,
 228
 229     </para>
 230     </section>
 231
 232   </section>
 233
 234   <section id="GettingWireshark"><title>Getting Wireshark</title>
 235     <para>
 236       Wireshark source code and installation packages are available from
 237       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
 238     </para>
 239
 240     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
 241       <para>
 242         Most Linux and Unix vendors supply their own Wireshark packages.
 243         You can usually install or upgrade Wireshark using the package management
 244         system specific to that platform.  A list of third-party packages
 245         can be found on the
 246         <ulink url="http://www.wireshark.org/download.html#thirdparty">download page</ulink>
 247         on the Wireshark web site.
 248       </para>
 249     </section>
 250
 251   </section>
 252
 253   <!-- XXX needs to be written
 254   <section id="RemovingWireshark"><title>Removing Wireshark</title>
 255     <para>
 256     </para>
 257   </section>
 258   -->
 259
 260   <section id="FileLocations"><title>File Locations</title>
 261     <para>
 262       Wireshark and TShark look in several different locations for
 263       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 264       These locations vary from platform to platform.  You can use
 265       About→Folders to find the default locations on your system.
 266     </para>
 267   </section>
 268
 269   <section id="KnownProblems"><title>Known Problems</title>
 270
 271     <para>
 272       Wireshark might make your system disassociate from a wireless network
 273       on OS X 10.4.
 274       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
 275       1315</ulink>)
 276     </para>
 277
 278     <para>
 279       Dumpcap might not quit if Wireshark or TShark crashes.
 280       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
 281       1419</ulink>)
 282     </para>
 283
 284     <para>
 285       The BER dissector might infinitely loop.
 286       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
 287       1516</ulink>)
 288     </para>
 289
 290     <para>
 291       Capture filters aren't applied when capturing from named pipes.
 292       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
 293       1814</ulink>)
 294     </para>
 295
 296     <para>
 297       Filtering tshark captures with display filters (-R) no longer works.
 298       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
 299       2234</ulink>)
 300     </para>
 301
 302     <para>
 303       The 64-bit Windows installer does not ship with libsmi.
 304       (<ulink url="http://wiki.wireshark.org/Development/Win64">Win64
 305       development page</ulink>)
 306     </para>
 307
 308     <para>
 309       Application crash when changing real-time option.
 310       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4035">Bug
 311       4035</ulink>)
 312     </para>
 313
 314     <para>
 315       Hex pane display issue after startup.
 316       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4056">Bug
 317       4056</ulink>)
 318     </para>
 319
 320     <para>
 321       Crash when sorting column while capturing.
 322       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4273">Bug
 323       4273</ulink>)
 324     </para>
 325
 326     <para>
 327       Packet list rows are oversized.
 328       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4357">Bug
 329       4357</ulink>)
 330     </para>
 331
 332     <para>
 333       Summary pane selected frame highlighting not maintained.
 334       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4445">Bug
 335       4445</ulink>)
 336     </para>
 337
 338     <para>
 339       Character echo pauses in Capture Filter field in Capture Options.
 340       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">Bug
 341       5356</ulink>)
 342     </para>
 343
 344   </section>
 345
 346   <section id="GettingHelp"><title>Getting Help</title>
 347     <para>
 348     Community support is available on
 349     <ulink url="http://ask.wireshark.org/">Wireshark's Q&amp;A site</ulink>
 350     and on the wireshark-users mailing list.
 351     Subscription information and archives for all of Wireshark's mailing
 352     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
 353     web site</ulink>.
 354     </para>
 355     <para>
 356     Training is available from
 357     <ulink url="http://www.wiresharktraining.com/">Wireshark University</ulink>.
 358     </para>
 359   </section>
 360
 361   <section id="FAQ"><title>Frequently Asked Questions</title>
 362     <para>
 363     A complete FAQ is available on the
 364     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
 365     </para>
 366   </section>
 367
 368 </article>