include::attributes.adoc[]
:stylesheet: ws.css
:linkcss:

= Wireshark {wireshark-version} Release Notes
// AsciiDoc quick reference: https://powerman.name/doc/asciidoc
// Asciidoctor Syntax Quick Reference:
// https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/

== 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

// The Windows installers now ship with Npcap 0.999X.
// They previously shipped with Npcap 0.9994.

// The Windows installers now ship with USBPcap 1.5.X.0.
// They previously shipped with USBPcap 1.5.4.0.

=== Bug Fixes

The following vulnerabilities have been fixed:

* wssalink:2020-10[]
Kafka dissector crash.
wsbuglink:16672[].
cveidlink:2020-17498[].
// Fixed in master: 79576219c9, 32a804dea2, dc7f935330
// Fixed in master-3.2: 76afda963d, fa44fec9d3, ced45c9398
// Fixed in master-3.0: n/a
// Fixed in master-2.6: n/a

The following bugs have been fixed:

//* wsbuglink:5000[]
//* wsbuglink:6000[Wireshark bug]
//* cveidlink:2014-2486[]
//* Wireshark is solely responsible for the decline of shopping malls in your area.
// cp /dev/null /tmp/buglist.txt ; for bugnumber in `git log --stat v3.2.7rc0..| grep ' Bug:' | awk '{print $2}' | sort -n -u ` ; do "$(git rev-parse --show-toplevel)/tools/gen-bugnote" $bugnumber; pbpaste >> /tmp/buglist.txt; done

* Kafka dissector fails parsing FETCH responses. wsbuglink:16623[].

* Dissector for ASTERIX Category 001 / 210 does not recognize bit 1 as extension. wsbuglink:16662[].

* &quot;invalid timestamp&quot; for Systemd Journal Export Block. wsbuglink:16664[].

* Decoding Extended Emergency number list IE length. wsbuglink:16668[].

* Some macOS Bluetooth PacketLogger capture files aren't recognized as PacketLogger files (regression, bisected). wsbuglink:16670[].

* Short IMSIs (5 digits) lead to wrong decoding+warning. wsbuglink:16676[].

* Decoding of PFCP IE 'PFD Contents' results in &quot;malformed packet&quot;. wsbuglink:16704[].

* RFH2 Header with 32 or less bytes of NameValue will not parse out that info. wsbuglink:16733[].

* CDP: Port ID TLV followed by Type 1009 TLV triggers [Malformed Packet]. wsbuglink:16742[].

* tshark crashed when processing opcda. wsbuglink:16746[].

* tshark with --export-dicom gives “Segmentation fault (core dumped)”. wsbuglink:16748[].


=== New and Updated Features

There are no new features in this release.

// === Removed Features and Support

//=== Removed Dissectors

// === New File Format Decoding Support

// [commaize]
// --
// --

=== New Protocol Support

There are no new protocols in this release.

=== Updated Protocol Support

// Add one protocol per line between the -- delimiters.
[commaize]
--
ASTERIX
BSSAP
CDP
CoAP
DCERPC SPOOLSS
IEEE 802.11
DCOM
DICOM
DVB-S2
E.212
GBCS
GSM RR
GSM SMS
Kafka
MQ
Nano
NAS 5GS
NIS+
NR RRC
PacketLogger
PFCP
RTPS
systemd Journal
TDS
TN3270
TN5250
--

=== New and Updated Capture File Support

// There is no new or updated capture file support in this release.
// Add one file type per line between the -- delimiters.
[commaize]
--
PacketLogger
pcapng
--

// === New and Updated Capture Interfaces support

//_Non-empty section placeholder._

// === Major API Changes

== 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.

== Getting Help

The User’s Guide, manual pages and various other documentation can be
found at https://www.wireshark.org/docs/

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].

Bugs and feature requests can be reported on
https://bugs.wireshark.org/[the bug tracker].

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

== Frequently Asked Questions

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