docbook/release-notes.asciidoc

   1 = Wireshark {wireshark-version} Release Notes
   2 // AsciiDoc quick reference: http://powerman.name/doc/asciidoc
   3
   4 This is a semi-experimental release intended to test new features for Wireshark 2.2.
   5
   6 == What is Wireshark?
   7
   8 Wireshark is the world's most popular network protocol analyzer. It is
   9 used for troubleshooting, analysis, development and education.
  10
  11 == What's New
  12
  13 //=== Bug Fixes
  14
  15 //The following bugs have been fixed:
  16
  17 //* ws-buglink:5000[]
  18 //* ws-buglink:6000[Wireshark bug]
  19 //* cve-idlink:2014-2486[]
  20 //* Wireshark accepted your prom invitation then cancelled at the last minute. (ws-buglink:0000[])
  21
  22 //_Non-empty section placeholder._
  23
  24 === New and Updated Features
  25
  26 The following features are new (or have been significantly updated)
  27 since version 2.1.0:
  28
  29 * Added -d option for Decode As support in Wireshark (mimics TShark
  30   functionality)
  31 * The Qt UI, GTK+ UI, and TShark can now export packets as JSON.
  32   TShark can additionally export packets as Elasticsearch-compatible
  33   JSON.
  34 * The Qt UI now supports the -j, -J, and -l flags. The -m flag is now
  35   deprecated.
  36 * The Conversations and Endpoints dialogs are more responsive when
  37   viewing large numbers of items.
  38 * The RTP player now allows up to 30 minutes of silence frames.
  39 * Packet bytes can now be displayed as EBCDIC.
  40
  41 The following features are new (or have been significantly updated)
  42 since version 2.0.0:
  43
  44 * The intelligent scroll bar now sits to the left of a normal scroll bar and
  45   provides a clickable map of nearby packets.
  46 * You can now switch between between Capture and File Format dissection of
  47 the current capture file via the View menu in the Qt GUI.
  48 * You can now show selected packet bytes as ASCII, HTML, Image, ISO 8859-1, Raw, UTF-8,
  49 a C array, or YAML.
  50 * You can now use regular expressions in Find Packet and in the advanced preferences.
  51 * Name resolution for packet capture now supports asynchronous DNS lookups only. Therefore the
  52 "concurrent DNS resolution" preference has been deprecated and is a no-op. To enable DNS name
  53 resolution some build dependencies must be present (currently c-ares). If that is not the case DNS
  54 name resolution will be disabled (but other name resolution mechanisms, such as host files,
  55 are still available).
  56 * The byte under the mouse in the Packet Bytes pane is now highlighted.
  57 * TShark supports exporting PDUs via the `-U` flag.
  58 * The Windows and OS X installers now come with the "sshdump" and "ciscodump" extcap interfaces.
  59 * Most dialogs in the Qt UI now save their size and positions.
  60 * The Follow Stream dialog now supports UTF-16.
  61 * The Firewall ACL Rules dialog has returned.
  62 * The Flow (Sequence) Analysis dialog has been improved.
  63 * We no longer provide packages for 32-bit versions of OS X.
  64 * The Bluetooth Device details dialog has been added.
  65
  66 //=== Removed Dissectors
  67
  68 === New File Format Decoding Support
  69
  70 Wireshark is able to display the format of some types of files (rather than
  71 displaying the contents of those files). This is useful when you're curious
  72 about, or debugging, a file and its format.  To open a capture file (such as
  73 PCAP) in this mode specify "MIME Files Format" as the file's format in the
  74 Open File dialog.
  75
  76 New files that Wireshark can open in this mode include:
  77
  78 //_Non-empty section placeholder._
  79 --sort-and-group--
  80 --sort-and-group--
  81
  82 === New Protocol Support
  83
  84 // Add one protocol per line between the --sort-and-group-- delimiters.
  85 --sort-and-group--
  86 CISCO ERSPAN3 Marker
  87 Nokia Intelligent Service Interface (ISI)
  88 ISO14443
  89 Extensible Control & Management Protocol (eCMP)
  90 RTI TCP Transport Layer (RTITCP)
  91 ITU-T G.7041/Y.1303 Generic Framing Procedure (GFP)
  92 Zigbee Protocol Clusters Dissectors Added (Closures, Lighting, General, Measurement & Sensing, HVAC, Security & Safety)
  93 LAT protocol (DECNET)
  94 Ericsson IPOS Kernel Packet Header Dissector Added (IPOS)
  95 STANAG 5602 SIMPLE
  96 UserLog Protocol
  97 FLEXRAY Protocol dissector added (automotive bus)
  98 USB3 Vision Protocol (USB machine vision cameras)
  99 USBIP Protocol
 100 Open Mobile Alliance Lightweight Machine to Machine TLV payload Added (LwM2M TLV)
 101 Metamako trailers
 102 ISO 8583-1
 103 Bluetooth Pseudoheader for BR/EDR
 104 Edge Control Protocol (ECP)
 105 Bachmann bluecom Protocol
 106 Apache Cassandra - CQL version 3.0
 107 Real Time Location System (RTLS)
 108 Network-Based IP Flow Mobility (NBIFOM)
 109
 110 --sort-and-group--
 111
 112 === Updated Protocol Support
 113
 114 Bluetooth OBEX dissector (btobex) was renamed to Obex Dissector (obex), allow to
 115 DecodeAs it over USB, TCP and UDP.
 116
 117 A preference was added to TCP dissector for handling IPFIX process
 118 information.  It has been disabled by default.
 119
 120 //Too many protocols have been updated to list here.
 121
 122 === New and Updated Capture File Support
 123
 124 //_Non-empty section placeholder._
 125 // Add one file type per line between the --sort-and-group-- delimiters.
 126 --sort-and-group--
 127 Micropross mplog
 128 --sort-and-group--
 129
 130 === New and Updated Capture Interfaces support
 131
 132 _Non-empty section placeholder._
 133 --sort-and-group--
 134 --sort-and-group--
 135
 136 === Major API Changes
 137
 138 The libwireshark API has undergone some major changes:
 139
 140 * The address macros (e.g., SET_ADDRESS) have been removed.  Use the
 141 (lower case) functions of the same names instead.
 142
 143 * "old style" dissector functions (that don't return number of bytes
 144 used) have been replaced in name with the "new style" dissector
 145 functions.
 146
 147 * tvb_get_string and tvb_get_stringz have been replaced with
 148 tvb_get_string_enc and tvb_get_stringz_enc respectively.
 149
 150
 151 == Getting Wireshark
 152
 153 Wireshark source code and installation packages are available from
 154 https://www.wireshark.org/download.html.
 155
 156 === Vendor-supplied Packages
 157
 158 Most Linux and Unix vendors supply their own Wireshark packages. You can
 159 usually install or upgrade Wireshark using the package management system
 160 specific to that platform. A list of third-party packages can be found
 161 on the https://www.wireshark.org/download.html#thirdparty[download page]
 162 on the Wireshark web site.
 163
 164 == File Locations
 165
 166 Wireshark and TShark look in several different locations for preference
 167 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
 168 from platform to platform. You can use About→Folders to find the default
 169 locations on your system.
 170
 171 == Known Problems
 172
 173 Dumpcap might not quit if Wireshark or TShark crashes.
 174 (ws-buglink:1419[])
 175
 176 The BER dissector might infinitely loop.
 177 (ws-buglink:1516[])
 178
 179 Capture filters aren't applied when capturing from named pipes.
 180 (ws-buglink:1814[])
 181
 182 Filtering tshark captures with read filters (-R) no longer works.
 183 (ws-buglink:2234[])
 184
 185 Application crash when changing real-time option.
 186 (ws-buglink:4035[])
 187
 188 Packet list rows are oversized.
 189 (ws-buglink:4357[])
 190
 191 Wireshark and TShark will display incorrect delta times in some cases.
 192 (ws-buglink:4985[])
 193
 194 Wireshark should let you work with multiple capture files. (ws-buglink:10488[])
 195
 196 Dell Backup and Recovery (DBAR) makes many Windows applications crash,
 197 including Wireshark. (ws-buglink:12036[])
 198
 199 == Getting Help
 200
 201 Community support is available on https://ask.wireshark.org/[Wireshark's
 202 Q&A site] and on the wireshark-users mailing list. Subscription
 203 information and archives for all of Wireshark's mailing lists can be
 204 found on https://www.wireshark.org/lists/[the web site].
 205
 206 Official Wireshark training and certification are available from
 207 http://www.wiresharktraining.com/[Wireshark University].
 208
 209 == Frequently Asked Questions
 210
 211 A complete FAQ is available on the
 212 https://www.wireshark.org/faq.html[Wireshark web site].