include::../docbook/attributes.adoc[]
:stylesheet: ws.css
:linkcss:
:copycss: {stylesheet}

= Wireshark {wireshark-version} Release Notes
// 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.

Wireshark is hosted by the Wireshark Foundation, a nonprofit which promotes protocol analysis educaton.
Wireshark and the foundation depend on your contributions in order to do their work.
If you or your employer would like to contribute or become a sponsor, please visit https://wiresharkfoundation.org[wiresharkfoundation.org].

== What’s New

=== Bug Fixes

The following vulnerabilities have been fixed:

* wssalink:2024-01[]
GVCP dissector crash.
wsbuglink:19496[].
cveidlink:2024-0208[].
// Fixed in master: a8586fde3a
// Fixed in release-4.2: 9dd7b50c3e
// Fixed in release-4.0: 0a0669c9d4
// Fixed in release-3.6: 4953fa99e7
// CVSS AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H
// CWE-674
// * Fuzz job crash output: fuzz-2023-11-23-7156.pcap. wsbuglink:19496[].

* wssalink:2024-02[]
IEEE 1609.2 dissector crash.
wsbuglink:19501[].
cveidlink:2024-0209[].
// Fixed in master: 8f797db63c
// Fixed in release-4.2: c59e392e80
// Fixed in release-4.0: 496679c1c3
// Fixed in release-3.6: 5e94986719
// CVSS AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H
// CWE-674
// * OSS-Fuzz bug in fuzzshark: stack overflow in tvb_parse_param and dissect_oer_sequence. wsbuglink:19501[].

* wssalink:2024-03[]
HTTP3 dissector crash.
wsbuglink:19502[].
cveidlink:2024-0207[].
// Fixed in master: 577cc97f32
// Fixed in release-4.2: e9e71ca8c7
// Fixed in release-4.0: xxx
// Fixed in release-3.6: xxx
// CVSS AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H
// CWE-125
// * HTTP3 crash in read_qpack_prefixed_integer. wsbuglink:19502[].

* wssalink:2024-04[]
Zigbee TLV dissector crash.
wsbuglink:19504[].
cveidlink:2024-0210[].
// Fixed in master: 98a8a9787b
// Fixed in release-4.2: 649d1398fa
// Fixed in release-4.0: xxx
// Fixed in release-3.6: xxx
// CVSS AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H
// CWE-674
// * OSS-Fuzz bug in fuzzshark: stack exhausion for dissect_zbee_tlvs. wsbuglink:19504[].

* wssalink:2024-05[]
DOCSIS dissector crash.
wsbuglink:19557[].
cveidlink:2024-0211[].
// Fixed in master: 77b0583568
// Fixed in release-4.2: 4cac2027e0
// Fixed in release-4.0: xxx
// Fixed in release-3.6: xxx
// CVSS AV:L/AC:L/PR:N/UI:R/S:U/C:H/I:H/A:H
// CWE-125
// * Fuzz job crash output: fuzz-2024-01-01-7166.pcap. wsbuglink:19557[].

The following bugs have been fixed:

//* wsbuglink:5000[]
//* wsbuglink:6000[Wireshark bug]
//* cveidlink:2014-2486[]
//* Wireshark grabs your ID at 3 am, goes to Waffle House, and insults people.

* Capture filters not saved to recently used list. wsbuglink:12918[].
* CFM dissector does not handle Sender ID TLV correctly when Chassis ID Length is zero. wsbuglink:13720[].
* OSS-Fuzz 64290: wireshark:fuzzshark_ip: Global-buffer-overflow in dissect_zcl_read_attr_struct. wsbuglink:19490[].
* Overriding capture options set by preference by command line arguments (like -S) doesn't work. wsbuglink:14549[].
* Segfault when enabling monitor mode on wireless card that falsely claims to support it. wsbuglink:16693[].
* Documented format of temporary file name is out of date in the Wireshark User's Guide. wsbuglink:18464[].
* Selection highlight lost when interface list is sorted. wsbuglink:19133[].
* HTTP3 malformed packets. wsbuglink:19475[].
* Capture filter compilation fails with obscure error message. wsbuglink:19480[].
* XML: Parsing encoding attribute failed when standalone attribute exists. wsbuglink:19485[].
* Display filter expressions where the protocol name starts with digit and contains a hyphen are rejected. wsbuglink:19489[].
* diameter.3GPP-*** display filters not working after upgrade to version 4.2.0. wsbuglink:19493[].
* GigE-vision: Control Protocol shows \"unknown\" as value for ASCII character set. wsbuglink:19494[].
* The HTTP/3 Request Header URI is not correct. wsbuglink:19497[].
* QUIC/TLS not extracting \"h3\" from ALPN in a capture. wsbuglink:19503[].
* Documentation on system requirements should be updated. wsbuglink:19512[].
* 4.2.0: init.lua in subdirectories not loaded anymore. wsbuglink:19516[].
* Malformed SIP/SDP messages: components are not decoded properly. wsbuglink:19518[].
* heuristic_protos do not reset on profile swap. wsbuglink:19520[].
* Wireshark 4.2 crashes on Apply As Column. wsbuglink:19521[].
* NFLOG timestamp is incorrect. wsbuglink:19525[].
* Qt6 Crash (Double Free) When Attempting to Save TCP Stream Graph. wsbuglink:19529[].

* Fixed parsing display filter expressions containing literal OID values, e.g. `snmp.name == 1.3.6.1.2.1.1.3.0`.


=== New and Updated Features

There are no new or updated features in this release.

// === Removed Features and Support

// === Removed Dissectors

// === New File Format Decoding Support


=== New Protocol Support

There are no new protocols in this release.

=== Updated Protocol Support

// Add one protocol per line between the -- delimiters.
// ag -A1 '(define PSNAME|proto_register_protocol[^_])' $(git diff --name-only v4.0.11.. | ag packet- | sort -u)
[commaize]
--
--

=== 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]
--
pcapng: the if_tsoffset option is now supported.
--

// === New and Updated Capture Interfaces support

// === New and Updated Codec support

// === Major API Changes

== Prior Versions

This document only describes the changes introduced in Wireshark {wireshark-version}.
You can find release notes for prior versions at the following locations:

* https://www.wireshark.org/docs/relnotes/wireshark-4.2.0.html[Wireshark 4.2.0]

== 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[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 menu:Help[About Wireshark,Folders] or `tshark -G 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://gitlab.com/wireshark/wireshark/-/issues[the issue tracker].

You can learn protocol analysis and meet Wireshark’s developers at
https://sharkfest.wireshark.org[SharkFest].

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

== How You Can Help

The Wireshark Foundation helps as many people as possible understand their networks as much as possible.
You can find out more and donate at https://wiresharkfoundation.org[wiresharkfoundation.org].

== Frequently Asked Questions

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