docbook/release-notes.asciidoc

   1 = Wireshark wireshark-version:[] Release Notes
   2
   3 This is an experimental release intended to test new features for the next
   4 stable release.
   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:2013-2486[]
  20 //* Wireshark always manages to score tickets for Burning Man, Coachella, and SXSW while you end up working double shifts. (ws-buglink:0000[])
  21
  22 * "On-the-wire" packet lengths are limited to 65535 bytes. (ws-buglink:8808[], ws-buglink:9390)
  23 * "Follow TCP Stream" shows only the first HTTP req+res. (ws-buglink:9044[])
  24 * Files with pcap-ng Simple Packet Blocks can't be read. (ws-buglink:9200[])
  25 * MPLS-over-PPP isn't recognized. (ws-buglink:9492[])
  26
  27 === New and Updated Features
  28
  29 The following features are new (or have been significantly updated)
  30 since version 1.11.3:
  31
  32 * Transport name resolution is now disabled by default.
  33
  34 The following features are new (or have been significantly updated)
  35 since version 1.11.2:
  36
  37 * Qt port:
  38
  39 ** The About dialog has been added
  40 ** The Capture Interfaces dialog has been added.
  41 ** The Decode As dialog has been added. It managed to swallow up the
  42 User Specified Decodes dialog as well.
  43 ** The Export PDU dialog has been added.
  44 ** Several SCTP dialogs have been added.
  45 ** The statistics tree (the backend for many Statistics and Telephony menu
  46 items) dialog has been added.
  47 ** The I/O Graph dialog has been added.
  48 ** French translation has updated.
  49
  50 The following features are new (or have been significantly updated)
  51 since version 1.11.1:
  52
  53 * Mac OS X packaging has been improved.
  54
  55 The following features are new (or have been significantly updated)
  56 since version 1.11.0:
  57
  58 * Dissector output may be encoded as UTF-8. This includes TShark output.
  59
  60 * Qt port:
  61
  62 ** The Follow Stream dialog now supports packet and TCP stream selection.
  63 ** A Flow Graph (sequence diagram) dialog has been added.
  64 ** The main window now respects geometry preferences.
  65
  66
  67 The following features are new (or have been significantly updated)
  68 since version 1.10:
  69
  70 * Wireshark now uses the Qt application framework. The new UI should provide
  71   a significantly better user experience, particularly on Mac OS X and Windows.
  72 * The Windows installer now uninstalls the previous version of Wireshark
  73   silently.  You can still run the uninstaller manually beforehand if you wish
  74   to run it interactively.
  75 * Expert information is now filterable when the new API is in use.
  76 * The "Number" column shows related packets and protocol conversation spans
  77   (Qt only).
  78 * When manipulating packets with editcap using the -C <choplen> and/or
  79   -s <snaplen> options, it is now possible to also adjust the original frame
  80   length using the -L option.
  81 * You can now pass the -C <choplen> option to editcap multiple times, which
  82   allows you to chop bytes from the beginning of a packet as well as at the end
  83   of a packet in a single step.
  84 * You can now specify an optional offset to the -C option for editcap, which
  85   allows you to start chopping from that offset instead of from the absolute
  86   packet beginning or end.
  87 * "malformed" display filter has been renamed to "_ws.malformed".  A handful of
  88   other filters have been given the "_ws." prefix to note they are Wireshark
  89   application specific filters and not dissector filters.
  90 * The Kerberos dissector has been replaced with an auto generated one from ASN1
  91   protocol description, changing a lot of filter names.
  92
  93 === Removed dissectors
  94
  95 * The ASN1 plugin has been removed as it's deemed obsolete.
  96 * The GNM dissector has been removed as it was never used.
  97 * The Kerberos hand made dissector has been replaced by one generated from ASN1 code.
  98
  99 === New Protocol Support
 100
 101 --sort-and-group--
 102
 103 29West
 104 802.1AE Secure tag
 105 ACR122
 106 ADB Client-Server
 107 AllJoyn
 108 Apple PKTAP
 109 Aruba Instant AP
 110 ASTERIX
 111 ATN
 112 Bencode
 113 Bluetooth 3DS
 114 Bluetooth HSP
 115 Bluetooth Linux Monitor Transport
 116 Bluetooth Low Energy
 117 Bluetooth Low Energy RF Info
 118 CARP
 119 CFDP
 120 Cisco MetaData
 121 DCE/RPC MDSSVC
 122 DeviceNet
 123 Ethernet Local Management Interface (E-LMI)
 124 Ethernet Passive Optical Network (EPON)
 125 ELF file format
 126 EXPORTED PDU
 127 FINGER
 128 HDMI
 129 High-Speed LAN Instrument Protocol (HiSLIP)
 130 HTTP2
 131 IDRP
 132 IEEE 1722a
 133 ILP
 134 iWARP Direct Data Placement and Remote Direct Memory Access Protocol
 135 Kafka
 136 Kyoto Tycoon
 137 Landis & Gyr Telegyr 8979
 138 LBM
 139 LBMC
 140 LBMPDM
 141 LBMPDM-TCP
 142 LBMR
 143 LBT-RM
 144 LBT-RU
 145 LBT-TCP
 146 Lightweight Mesh (v1.1.1)
 147 Linux netlink
 148 Linux netlink netfilter
 149 Linux rtnetlink (route netlink)
 150 Linux netlink sock diag
 151 Logcat
 152 MBIM
 153 MiNT
 154 MP4 / ISOBMFF file format
 155 MQ Telemetry Transport Protocol
 156 Novell PKIS certificate extensions
 157 NXP PN532 HCI
 158 OpenFlow
 159 Open Sound Control
 160 PDC
 161 Pathport
 162 Picture Transfer Protocol Over IP
 163 PKTAP
 164 Private Data Channel
 165 QUIC (Quick UDP Internet Connections)
 166 SAE J1939
 167 SEL RTAC (Real Time Automation Controller) EIA-232 Serial-Line Dissection
 168 Sippy RTPproxy
 169 SMB-Direct
 170 SPDY
 171 STANAG 4607
 172 STANAG 5066 DTS
 173 STANAG 5066 SIS
 174 Tinkerforge
 175 Ubertooth
 176 UDT
 177 URL Encoded Form Data
 178 USB Communications and CDC Control
 179 USB Device Firmware Upgrade
 180 VP8
 181 WHOIS
 182 Wi-Fi Display
 183 ZigBee Green Power profile
 184
 185 --sort-and-group--
 186
 187 === Updated Protocol Support
 188
 189 Too many protocols have been updated to list here.
 190
 191 === New and Updated Capture File Support
 192
 193 --sort-and-group--
 194
 195 Netscaler 2.6
 196 STANAG 4607
 197 STANAG 5066 Data Transfer Sublayer
 198
 199 --sort-and-group--
 200
 201 === Major API Changes
 202
 203 The libwireshark API has undergone some major changes:
 204
 205 * A more flexible, modular memory manager (wmem) has been added. It was
 206   available experimentally in 1.10 but is now mature and has mostly
 207   replaced the old emem API (which is deprecated).
 208 * A new API for expert information has been added, replacing the old one.
 209 * The tvbuff API has been cleaned up: tvb_length has been renamed to
 210   tvb_captured_length for clarity, and tvb_get_string and tvb_get_stringz
 211   have been deprecated in favour of tvb_get_string_enc and
 212   tvb_get_stringz_enc.
 213
 214 == Getting Wireshark
 215
 216 Wireshark source code and installation packages are available from
 217 http://www.wireshark.org/download.html.
 218
 219 === Vendor-supplied Packages
 220
 221 Most Linux and Unix vendors supply their own Wireshark packages. You can
 222 usually install or upgrade Wireshark using the package management system
 223 specific to that platform. A list of third-party packages can be found
 224 on the http://www.wireshark.org/download.html#thirdparty[download page]
 225 on the Wireshark web site.
 226
 227 == File Locations
 228
 229 Wireshark and TShark look in several different locations for preference
 230 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
 231 from platform to platform. You can use About→Folders to find the default
 232 locations on your system.
 233
 234 == Known Problems
 235
 236 Dumpcap might not quit if Wireshark or TShark crashes.
 237 (ws-buglink:1419[])
 238
 239 The BER dissector might infinitely loop.
 240 (ws-buglink:1516[])
 241
 242 Capture filters aren't applied when capturing from named pipes.
 243 (ws-buglink:1814)
 244
 245 Filtering tshark captures with read filters (-R) no longer works.
 246 (ws-buglink:2234[])
 247
 248 The 64-bit Windows installer does not support Kerberos decryption.
 249 (https://wiki.wireshark.org/Development/Win64[Win64 development page])
 250
 251 Resolving (ws-buglink:9044[]) reopens (ws-buglink:3528[]) so that Wireshark
 252 no longer automatically decodes gzip data when following a TCP stream.
 253
 254 Application crash when changing real-time option.
 255 (ws-buglink:4035[])
 256
 257 Hex pane display issue after startup.
 258 (ws-buglink:4056[])
 259
 260 Packet list rows are oversized.
 261 (ws-buglink:4357[])
 262
 263 Summary pane selected frame highlighting not maintained.
 264 (ws-buglink:4445[])
 265
 266 Wireshark and TShark will display incorrect delta times in some cases.
 267 (ws-buglink:4985[])
 268
 269 The 64-bit Mac OS X installer doesn't support Mac OS X 10.9 (ws-buglink:9242[])
 270
 271 == Getting Help
 272
 273 Community support is available on http://ask.wireshark.org/[Wireshark's
 274 Q&A site] and on the wireshark-users mailing list. Subscription
 275 information and archives for all of Wireshark's mailing lists can be
 276 found on http://www.wireshark.org/lists/[the web site].
 277
 278 Official Wireshark training and certification are available from
 279 http://www.wiresharktraining.com/[Wireshark University].
 280
 281 == Frequently Asked Questions
 282
 283 A complete FAQ is available on the
 284 http://www.wireshark.org/faq.html[Wireshark web site].