docbook/release-notes.asciidoc

   1 include::attributes.asciidoc[]
   2 :stylesheet: ws.css
   3 :linkcss:
   4
   5 = Wireshark {wireshark-version} Release Notes
   6 // AsciiDoc quick reference: http://powerman.name/doc/asciidoc
   7 // Asciidoctor Syntax Quick Reference:
   8 // http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
   9
  10 This is a semi-experimental release intended to test new features for
  11 Wireshark 2.6.
  12
  13 == What is Wireshark?
  14
  15 Wireshark is the world’s most popular network protocol analyzer. It is
  16 used for troubleshooting, analysis, development and education.
  17
  18 == What’s New
  19
  20 Wireshark 2.6 is the last release that will support the legacy (GTK+)
  21 user interface. It will not be supported or available in Wireshark 3.0.
  22
  23 Many user interface improvements have been made. See the “New and Updated
  24 Features” section below for more details.
  25
  26 === Bug Fixes
  27
  28 The following bugs have been fixed:
  29
  30 //* ws_buglink:5000[]
  31 //* ws_buglink:6000[Wireshark bug]
  32 //* cve_idlink:2014-2486[]
  33 //* Wireshark convinced you to switch seats on the plane while neglecting to tell you that its seat was noticeably moist.
  34
  35 //_Non-empty section placeholder._
  36
  37 Dumpcap might not quit if Wireshark or TShark crashes.
  38 (ws_buglink:1419[])
  39
  40 === New and Updated Features
  41
  42 The following features are new (or have been significantly updated)
  43 since version 2.5.0:
  44
  45 * HTTP Referer statistics are now supported.
  46 * Wireshark now supports MaxMind DB files. Support for GeoIP and GeoLite
  47   Legacy databases has been removed.
  48 * The Windows packages are now built using Microsoft Visual Studio 2017.
  49 * The IP map feature (the “Map” button in the “Endpoints” dialog) has been removed.
  50
  51 The following features are new (or have been significantly updated)
  52 since version 2.4.0:
  53
  54 * Display filter buttons can now be edited, disabled, and removed via a context
  55   menu directly from the toolbar
  56 * Drag & Drop filter fields to the display filter toolbar or edit to create
  57   a button on the fly or apply the filter as a display filter.
  58 * Application startup time has been reduced.
  59 * Some keyboard shortcut mix-ups have been resolved by assigning new shortcuts
  60   to Edit -> Copy methods.
  61 * TShark now supports color using the --color option.
  62 * The "matches" display filter operator is now case-insensitive.
  63 * Display expression (button) preferences have been converted to a UAT.
  64   This puts the display expressions in their own file.  Wireshark still
  65   supports preference files that contain the old preferences, but new
  66   preference files will be written without the old fields.
  67 * SMI private enterprise numbers are now read from the "enterprises.tsv" configuration file.
  68 * The QUIC dissector has been renamed to **G**oogle QUIC (quic -> **g**quic).
  69 * The selected packet number can now be shown in the Status Bar by enabling
  70   Preferences -> Appearance -> Layout -> Show selected packet number.
  71 * File load time in the Status Bar is now disabled by default and can be enabled in
  72   Preferences -> Appearance -> Layout -> Show file load time.
  73 * Support for the G.729A codec in the RTP Player is now added via the bcg729 library.
  74 * Support for hardware-timestamping of packets has been added.
  75 * Improved NetMon .cap support with comments, event tracing, network filter,
  76   network info types and some Message Analyzer exported types.
  77 * The personal plugins folder on Linux/Unix is now {tilde}/.local/lib/wireshark/plugins.
  78 * TShark can print flow graphs using `-z flow…`
  79 * Capinfos now prints SHA256 hashes in addition to RIPEMD160 and SHA1. MD5 output
  80   has been removed.
  81 * The packet editor has been removed. (This was a GTK+ only experimental feature.)
  82 * Support BBC micro:bit Bluetooth profile
  83 * The Linux and UNIX installation step for Wireshark will now install
  84   headers required to build plugins. A pkg-config file is provided to
  85   help with this (see doc/plugins.example for details). Note you must
  86   still rebuild all plugins between minor releases (X.Y).
  87 * The Windows installers and packages now ship with Qt 5.9.4.
  88 * The generic data dissector can now uncompress zlib compressed data.
  89 * Dns Stats now support service-level stats.
  90 * Dns filters for retransmissions and unsolicited responses have been added.
  91 * The “tcptrace” TCP Stream graph now shows duplicate ACKS and zero
  92   window advertisements.
  93
  94 //=== Removed Dissectors
  95
  96 //=== New File Format Decoding Support
  97
  98 === New Protocol Support
  99
 100 // Add one protocol per line between the -- delimiters.
 101 [commaize]
 102 --
 103 ActiveMQ Artemis Core Protocol
 104 AMT (Automatic Multicast Tunneling)
 105 AVSP (Arista Vendor Specific Protocol)
 106 Bluetooth Mesh
 107 Broadcom tags (Broadcom Ethernet switch management frames)
 108 CVS password server
 109 CAN-ETH
 110 Excentis DOCSIS31 XRA header
 111 F1 Application Protocol
 112 F5ethtrailer
 113 FP Mux
 114 GRPC (gRPC)
 115 IEEE 802.3br Frame Preemption Protocol
 116 IEEE 802.11ax (High Efficiency WLAN (HEW))
 117 IEEE 802.15.9 IEEE Recommended Practice for Transport of Key Management Protocol (KMP) Datagrams
 118 IEEE 1905.1a
 119 ISOBUS
 120 LoRaTap
 121 LoRaWAN
 122 Lustre Network
 123 Lustre Filesystem
 124 Nano / RaiBlocks Cryptocurrency Protocol (UDP)
 125 Network Functional Application Platform Interface (NFAPI) Protocol
 126 New Radio Radio Resource Control protocol
 127 New Radio Radio Link Control protocol
 128 NR (5G) MAC protocol
 129 NXP 802.15.4 Sniffer Protocol
 130 Object Security for Constrained RESTful Environments (OSCORE)
 131 PFCP (Packet Forwarding Control Protocol)
 132 Protobuf (Protocol Buffers)
 133 QUIC (IETF)
 134 RFC 4108 Using CMS to Protect Firmware Packages
 135 SolarEdge monitoring protocol
 136 Session Multiplex Protocol
 137 Steam In-Home Streaming Discovery Protocol
 138 Tibia
 139 TWAMP and OWAMP
 140 Wi-Fi Device Provisioning Protocol
 141 Wi-SUN FAN Protocol
 142 --
 143
 144 === Updated Protocol Support
 145
 146 Too many protocols have been updated to list here.
 147
 148 === New and Updated Capture File Support
 149
 150 //_Non-empty section placeholder._
 151 // Add one file type per line between the --sort-and-group-- delimiters.
 152 [commaize]
 153 Microsoft Network Monitor
 154
 155 === New and Updated Capture Interfaces support
 156
 157 //_Non-empty section placeholder._
 158 [commaize]
 159 --
 160 LoRaTap
 161 --
 162
 163 //=== Major API Changes
 164
 165 == Getting Wireshark
 166
 167 Wireshark source code and installation packages are available from
 168 https://www.wireshark.org/download.html.
 169
 170 === Vendor-supplied Packages
 171
 172 Most Linux and Unix vendors supply their own Wireshark packages. You can
 173 usually install or upgrade Wireshark using the package management system
 174 specific to that platform. A list of third-party packages can be found
 175 on the https://www.wireshark.org/download.html#thirdparty[download page]
 176 on the Wireshark web site.
 177
 178 == File Locations
 179
 180 Wireshark and TShark look in several different locations for preference
 181 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
 182 from platform to platform. You can use About→Folders to find the default
 183 locations on your system.
 184
 185 == Known Problems
 186
 187 The BER dissector might infinitely loop.
 188 (ws_buglink:1516[])
 189
 190 Capture filters aren't applied when capturing from named pipes.
 191 (ws_buglink:1814[])
 192
 193 Filtering tshark captures with read filters (-R) no longer works.
 194 (ws_buglink:2234[])
 195
 196 Application crash when changing real-time option.
 197 (ws_buglink:4035[])
 198
 199 Wireshark and TShark will display incorrect delta times in some cases.
 200 (ws_buglink:4985[])
 201
 202 Wireshark should let you work with multiple capture files. (ws_buglink:10488[])
 203
 204 == Getting Help
 205
 206 Community support is available on https://ask.wireshark.org/[Wireshark’s
 207 Q&A site] and on the wireshark-users mailing list. Subscription
 208 information and archives for all of Wireshark’s mailing lists can be
 209 found on https://www.wireshark.org/lists/[the web site].
 210
 211 Official Wireshark training and certification are available from
 212 http://www.wiresharktraining.com/[Wireshark University].
 213
 214 == Frequently Asked Questions
 215
 216 A complete FAQ is available on the
 217 https://www.wireshark.org/faq.html[Wireshark web site].