1 include::attributes.asciidoc[]
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/
10 This is a semi-experimental release intended to test new features for
15 Wireshark is the world’s most popular network protocol analyzer. It is
16 used for troubleshooting, analysis, development and education.
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.
23 Many user interface improvements have been made. See the “New and Updated
24 Features” section below for more details.
28 The following bugs have been fixed:
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.
35 //_Non-empty section placeholder._
37 Dumpcap might not quit if Wireshark or TShark crashes.
40 === New and Updated Features
42 The following features are new (or have been significantly updated)
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.
51 The following features are new (or have been significantly updated)
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
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.
94 //=== Removed Dissectors
96 //=== New File Format Decoding Support
98 === New Protocol Support
100 // Add one protocol per line between the -- delimiters.
103 ActiveMQ Artemis Core Protocol
104 AMT (Automatic Multicast Tunneling)
105 AVSP (Arista Vendor Specific Protocol)
107 Broadcom tags (Broadcom Ethernet switch management frames)
110 Excentis DOCSIS31 XRA header
111 F1 Application Protocol
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
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
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)
134 RFC 4108 Using CMS to Protect Firmware Packages
135 SolarEdge monitoring protocol
136 Session Multiplex Protocol
137 Steam In-Home Streaming Discovery Protocol
140 Wi-Fi Device Provisioning Protocol
144 === Updated Protocol Support
146 Too many protocols have been updated to list here.
148 === New and Updated Capture File Support
150 //_Non-empty section placeholder._
151 // Add one file type per line between the --sort-and-group-- delimiters.
153 Microsoft Network Monitor
155 === New and Updated Capture Interfaces support
157 //_Non-empty section placeholder._
163 //=== Major API Changes
167 Wireshark source code and installation packages are available from
168 https://www.wireshark.org/download.html.
170 === Vendor-supplied Packages
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.
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.
187 The BER dissector might infinitely loop.
190 Capture filters aren't applied when capturing from named pipes.
193 Filtering tshark captures with read filters (-R) no longer works.
196 Application crash when changing real-time option.
199 Wireshark and TShark will display incorrect delta times in some cases.
202 Wireshark should let you work with multiple capture files. (ws_buglink:10488[])
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].
211 Official Wireshark training and certification are available from
212 http://www.wiresharktraining.com/[Wireshark University].
214 == Frequently Asked Questions
216 A complete FAQ is available on the
217 https://www.wireshark.org/faq.html[Wireshark web site].