path: root/docbook/release-notes.asciidoc

include::attributes.asciidoc[]

= Wireshark {wireshark-version} Release Notes
// AsciiDoc quick reference: http://powerman.name/doc/asciidoc

== What is Wireshark?

Wireshark is the world's most popular network protocol analyzer. It is
used for troubleshooting, analysis, development and education.

== What's New

=== Bug Fixes

The following bugs have been fixed:

* ws-salink:2017-47[]
+
The IWARP_MPA dissector could crash.
(ws-buglink:14236[])
// cve-idlink:2017-xxxx[]
// Fixed in master: f23a6e193f
// Fixed in master-2.4: 8502fe94ef
// Fixed in master-2.2: 53cf81d4f2

* ws-salink:2017-48[]
+
The NetBIOS dissector could crash.
(ws-buglink:14249[])
// cve-idlink:2017-xxxx[]
// Fixed in master: b59dc97dfe
// Fixed in master-2.4: 87b6ea2237
// Fixed in master-2.2: 79768d63d1

* ws-salink:2017-49[]
+
The CIP Safety dissector could crash.
(ws-buglink:14250[])
// cve-idlink:2017-xxxx[]
// Fixed in master: 041e3e7c27, 3d6da018e7
// Fixed in master-2.4: ec6972193c, 1166734b35
// Fixed in master-2.2: 6966d5db73, 6966d5db73

//* ws-buglink:5000[]
//* ws-buglink:6000[Wireshark bug]
//* cve-idlink:2014-2486[]
//* Wireshark keeps leaving voicemails advertising timeshare condominiums in Fresno. (ws-buglink:0000[])
// cp /dev/null /tmp/buglist.txt ; for bugnumber in `git log --stat v2.4.4rc0..| grep ' Bug:' | cut -f2 -d: | sort -n -u ` ; do gen-bugnote $bugnumber; pbpaste >> /tmp/buglist.txt; done

* "tshark -G ?" doesn't provide expected help. (ws-buglink:13984[])

* File loading is very slow with TRANSUM dissector enabled. (ws-buglink:14094[])

* packet-knxnetip.c:936: bad bitmask ?. (ws-buglink:14115[])

* packet-q931.c:1306: bad compare ?. (ws-buglink:14116[])

* SSL Dissection bug. (ws-buglink:14117[])

* Wireshark crashes when exporting various files to .csv, txt and other ‘non-capture file’ formats. (ws-buglink:14128[])

* RLC reassembly doesn't work for RLC over UDP heuristic dissector. (ws-buglink:14129[])

* HTTP Object export fails with long extension (possibly query string). (ws-buglink:14130[])

* 3GPP Civic Address not displayed in Packet Details. (ws-buglink:14131[])

* Wireshark prefers packet.dll in System32\\Npcap over the one in System32. (ws-buglink:14134[])

* PEEKREMOTE dissector does not decode 11ac MCS rates properly. (ws-buglink:14136[])

* Visual Studio Community Edition 2015 lacks tools named in developer guide. (ws-buglink:14147[])

* TCP: Malformed data with Riverbed Probe option. (ws-buglink:14150[])

* Wireshark Crash when trying to use Preferences | Advanced. (ws-buglink:14157[])

* Right click on SMB2 Message ID and then Apply as Column causes Runtime Error. (ws-buglink:14169[])

* Return [Enter] should apply change (Column title - Button Label toolbars). (ws-buglink:14191[])

* Wireshark crashes if "rip.display_routing_domain" is set to TRUE in preferences file. (ws-buglink:14197[])

* Entry point inflatePrime not found for androiddump.exe and randpktdump.exe. (ws-buglink:14207[])

* BGP: IPv6 NLRI is received with Add-path ID, then Wire shark is not able to decode the packet correctly. (ws-buglink:14241[])

* Wrong SSL decryption when using EXTENDED MASTER SECRET and Client certificate request (mutual authentication). (ws-buglink:14243[])

* Frame direction isn't always set if it comes from the pcapng record header rather than the packet pseudo-header. (ws-buglink:14245[])

=== New and Updated Features

There are no new features in this release.

//=== Removed Dissectors

//=== New File Format Decoding Support

=== New Protocol Support

There are no new protocols in this release.

=== Updated Protocol Support

--sort-and-group--
3GPP NAS
BGP
CIP Safety
DTLS
IEEE 802.11 Radio
IWARP_MPA
KNXnet/IP
LCSAP
MQTT
NetBIOS
PEEKREMOTE
Q.931
RIP
RLC
SIP
SSL/TLS
TCP
TRANSUM
--sort-and-group--

=== New and Updated Capture File Support

There is no new or updated capture file support in this release.
//--sort-and-group--
//--sort-and-group--

//=== New and Updated Capture Interfaces support

//_Non-empty section placeholder._
//--sort-and-group--
//--sort-and-group--

//=== Major API Changes

//_Non-empty section placeholder._

== Getting Wireshark

Wireshark source code and installation packages are available from
https://www.wireshark.org/download.html.

=== Vendor-supplied Packages

Most Linux and Unix vendors supply their own Wireshark packages. You can
usually install or upgrade Wireshark using the package management system
specific to that platform. A list of third-party packages can be found
on the https://www.wireshark.org/download.html#thirdparty[download page]
on the Wireshark web site.

== File Locations

Wireshark and TShark look in several different locations for preference
files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
from platform to platform. You can use About→Folders to find the default
locations on your system.

== Known Problems

Dumpcap might not quit if Wireshark or TShark crashes.
(ws-buglink:1419[])

The BER dissector might infinitely loop.
(ws-buglink:1516[])

Capture filters aren't applied when capturing from named pipes.
(ws-buglink:1814[])

Filtering tshark captures with read filters (-R) no longer works.
(ws-buglink:2234[])

Application crash when changing real-time option.
(ws-buglink:4035[])

Wireshark and TShark will display incorrect delta times in some cases.
(ws-buglink:4985[])

Wireshark should let you work with multiple capture files. (ws-buglink:10488[])

== Getting Help

Community support is available on https://ask.wireshark.org/[Wireshark's
Q&A site] and on the wireshark-users mailing list. Subscription
information and archives for all of Wireshark's mailing lists can be
found on https://www.wireshark.org/lists/[the web site].

Official Wireshark training and certification are available from
http://www.wiresharktraining.com/[Wireshark University].

== Frequently Asked Questions

A complete FAQ is available on the
https://www.wireshark.org/faq.html[Wireshark web site].