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 education.
Wireshark and the foundation depend on your contributions in order to do their work.
If you or your organization would like to contribute or become a sponsor, please visit https://wiresharkfoundation.org[wiresharkfoundation.org].

== What’s New

=== Bug Fixes

If you are upgrading Wireshark 4.2.0 or 4.2.1 on Windows you will need to https://www.wireshark.org/download.html[download and install] Wireshark {wireshark-version} or later by hand.

// The following vulnerabilities have been fixed:

// * wssalink:2024-06[]
// Foo dissector {crash,infinite loop,memory leak}.
// wsbuglink:xxx[].
// cveidlink:2024-xxx[].
// Fixed in master: xxx
// Fixed in release-4.2: xxx
// 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

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 start fails when file set enabled and file extension not supplied if directory contains a period. wsbuglink:14614[].
* Cannot drag and move custom filter buttons in toolbar. wsbuglink:19447[].
* Not equal won't work when used with wlan.addr. wsbuglink:19449[].
* sshdump fails to connect with private key (ssh-rsa) wsbuglink:19510[].
* ChmodBPF installation fails on macOS Sonoma 14.1.2. wsbuglink:19527[].
* Windows installers should check for Windows 8.1. wsbuglink:19569[].
* Fuzz job crash output: fuzz-2024-01-05-7725.pcap. wsbuglink:19570[].
* Fuzz job crash output: fuzz-2024-01-06-7734.pcap. wsbuglink:19578[].
* Incorrect recursion depth assert failure when dissecting a legitimate GOOSE message. wsbuglink:19580[].
* OPC UA - large read request is reported as malformed in 4.2.1 but not in 4.0.12. wsbuglink:19581[].
* TFTP dissector bug type listed as netscii instead of netascii doesn't show all TFTP packets including TFTP blocks. wsbuglink:19589[].
* SMB1 replies from LAN Drive app only show up as NBSS Continuation Message. wsbuglink:19593[].
* ciscodump - older SSH key exchange algorithms not supported. wsbuglink:19594[].
* Problem decoding LAPB/X.25/FTAM after adding X.75 decoding. wsbuglink:19595[].
* Wireshark Filter not working. wsbuglink:19604[].
* CFLOW: failure to decode 0 length data fields of IPFIX variable length data types. wsbuglink:19605[].
* Copy ...as Printable Text Feature Missing in 4.1/4.2. wsbuglink:19607[].
* Export Objects - HTTP is missing some HTTP/2 files in a two-pass analysis. wsbuglink:19609[].
* ASAM-CMP Plugin: Malformed message, length mismatch if vendor defined data of status messages has odd length. wsbuglink:19626[].
* OSS-Fuzz 66561: wireshark:fuzzshark_ip_proto-udp: Null-dereference READ in wmem_map_lookup. wsbuglink:19642[].

=== 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.2.2.. | ag packet- | sort -u)
[commaize]
--
ASAM CMP
CAN
CFLOW
CMIP
CMP
DAP
DICOM
DISP
E2AP
GLOW
GOOSE
GTP
GTPv2
H.225
H.245
H.248
HTTP2
IEEE 1609.2
IEEE 1722
IPv4
IPv6
ISO 15765
ISUP
ITS
Kerberos
LDAP
MMS
NBT
openSAFETY
NRUP
P22
P7
PARLAY
RTMPT
RTP
SCSI
SOME/IP
T.38
TCP
TECMP
TFTP
WOW
X11
X.509if
X.509sat
X.75
Z39.50
ZigBee Green Power
--

=== 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]
--
pcap
pcapng
--

// === 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.2.html[Wireshark 4.2.2]
* https://www.wireshark.org/docs/relnotes/wireshark-4.2.1.html[Wireshark 4.2.1]
* 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].
