doc/release-notes.adoc

   1 include::attributes.adoc[]
   2 :stylesheet: ws.css
   3 :linkcss:
   4 :copycss: {css_dir}/{stylesheet}
   5
   6 = Wireshark {wireshark-version} Release Notes
   7 // Asciidoctor Syntax Quick Reference:
   8 // https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
   9
  10 This is an experimental release intended to test new features for Wireshark 5.0.
  11
  12 == What is Wireshark?
  13
  14 Wireshark is the world’s most popular network protocol analyzer.
  15 It is used for troubleshooting, analysis, development and education.
  16
  17 == What’s New
  18
  19 // Add a summary of **major** changes here.
  20 // Add other changes to "New and Updated Features" below.
  21
  22 Many other improvements have been made.
  23 See the “New and Updated Features” section below for more details.
  24
  25 //=== Bug Fixes
  26
  27 //The following bugs have been fixed:
  28 //* wsbuglink:5000[]
  29 //* wsbuglink:6000[Wireshark bug]
  30 //* cveidlink:2014-2486[]
  31 //* Wireshark grabs your ID at 3 am, goes to Waffle House, and insults people.
  32
  33 === New and Updated Features
  34
  35 The following features are either new or have been significantly updated since version 4.4.0:
  36
  37 * The Windows installers now ship with Npcap 1.80.
  38   They previously shipped with Npcap 1.79.
  39
  40 * Source packages are now compressed using zstd.
  41
  42 //* The Windows installers now ship with Qt 6.5.2.
  43 //  They previously shipped with Qt 6.2.3.
  44
  45 * The default format for absolute times when output with -T fields, -T json,
  46   and the "show" field of -T pdml, or when in custom columns (including CSV
  47   output of columns) has been changed to ISO 8601. (This was already the case
  48   for -T ek.) For backwards compatibility, a preference has been added,
  49   protocols.display_abs_time_ascii. This can be set to continue to format
  50   times in a manner similar to asctime. (E.g., Dec 18, 2017 05:28:39.071704055 EST.)
  51   This preference can also be set to never use ascii time and to use ISO 8601 time
  52   in the protocol tree (Packet Details) as well.
  53
  54 * The TShark `-G` option for generating glossary reports does not need to be the
  55   first option given on the command line anymore. In addition, the reports now
  56   are affected by other command line options such as `-o`, `-d`, and
  57   `--disable-protocol`, in addition to the `-C` option, which was already supported.
  58   (The `defaultprefs` report remains unaffected by any other options.)
  59   As a part of this change, `-G` with no argument, which was previously deprecated,
  60   is no longer supported. Use `tshark -G fields` to produce the same report.
  61   Also, the syntax for only listing fields with a certain prefix has changed to
  62   `tshark -G fields,prefix`.
  63
  64 * Wireshark can now decrypt NTP packets using NTS (Network Time Security). To decrypt packets,
  65   the NTS-KE (Network Time Security Key Establishment Protocol) packets need to be present,
  66   alongside the TLS client and exporter secrets. Additionally, the parts of a NTP packet which
  67   can be cryptographically authenticated (from NTP packet header until the end  of the last
  68   extension field that precedes the NTS Authenticator and Encrypted Extension Fields
  69   extension field) are checked for validity.
  70
  71 * The TCP Stream Graph axes now use units with SI prefixes. wsbuglink:20197[]
  72
  73 * Custom columns have an option to show the values using the same format as
  74   in Packet Details.
  75
  76 * Custom column complex expressions (e.g., with arithmetic, filter functions,
  77   etc.) that return numeric results are sorted numerically instead of
  78   lexicographically.
  79
  80 * A display filter function `double` is added to allow explicitly converting
  81   field types like integers and times to doubles. This can be used to perform
  82   further arithmetic operations on fields of different types, including in
  83   custom column definitions.
  84
  85 * The minimum width of the I/O Graph dialog window is reduced, so it should
  86   work better on small resolution desktops, especially in certain languages.
  87   To enable this, some checkbox controls were moved to the graph right-click
  88   context menu. wsbuglink:20147[]
  89
  90 * X.509 certificates, used in TLS and elsewhere, can be exported via the
  91   File->Export Objects menu in Wireshark (under the name "X509AF") and
  92   `--export-objects` in TShark (with the protocol name `x509af`.)
  93
  94 * Zstandard Content-Encoding is supported in the HTTP and HTTP/2 dissectors.
  95
  96 * Follow Stream is supported for MPEG 2 Transport Stream PIDs, and for
  97   Packetized Elementary Streams contained within MPEG 2 TS. The latter
  98   can be used to extract audio or video for playback with other tools.
  99
 100 * DNP 3 (Distributed Network Protocol 3) is now supported in the Conversations
 101   and Endpoints table dialogs.
 102
 103 * The Lua supplied preloaded libraries `bit` and `rex_pcre2` are loaded in
 104   a way that adds them to the `package.loaded` table, as though through
 105   `require`, so that `require("bit")` and `require("rex_pcre2")` statements
 106   in Lua dissectors, while usually superfluous, behave as expected. wsbuglink:20213[]
 107
 108 // === Removed Features and Support
 109
 110
 111 // === Removed Dissectors
 112
 113
 114 //=== New File Format Decoding Support
 115
 116 //[commaize]
 117 //--
 118 //--
 119
 120 === New Protocol Support
 121
 122 // Add one protocol per line between the -- delimiters in the format
 123 // “Full protocol name (Abbreviation)”
 124 // git log --oneline --diff-filter=A --stat v4.3.0rc0.. epan/dissectors plugins
 125 [commaize]
 126 --
 127 Lenbrook Service Discovery Protocol (LSDP)
 128 Network Time Security Key Establishment Protocol (NTS-KE)
 129 --
 130
 131 === Updated Protocol Support
 132
 133 Too many protocol updates have been made to list them all here.
 134
 135 //=== New and Updated Capture File Support
 136
 137 There is no new or updated capture file support in this release.
 138 // Add one file type per line between the -- delimiters.
 139 // [commaize]
 140 // --
 141 // --
 142
 143 // === New and Updated Capture Interfaces support
 144 // [commaize]
 145 // --
 146 // --
 147
 148 //=== New and Updated Codec support
 149
 150 //_Non-empty section placeholder._
 151
 152 // === Major API Changes
 153
 154
 155 == Getting Wireshark
 156
 157 Wireshark source code and installation packages are available from
 158 https://www.wireshark.org/download.html.
 159
 160 === Vendor-supplied Packages
 161
 162 Most Linux and Unix vendors supply their own Wireshark packages.
 163 You can usually install or upgrade Wireshark using the package management system specific to that platform.
 164 A list of third-party packages can be found on the
 165 https://www.wireshark.org/download.html[download page]
 166 on the Wireshark web site.
 167
 168 == File Locations
 169
 170 Wireshark and TShark look in several different locations for preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
 171 These locations vary from platform to platform.
 172 You can use menu:Help[About Wireshark,Folders] or `tshark -G folders` to find the default locations on your system.
 173
 174 == Getting Help
 175
 176 The User’s Guide, manual pages and various other documentation can be found at
 177 https://www.wireshark.org/docs/
 178
 179 Community support is available on
 180 https://ask.wireshark.org/[Wireshark’s Q&A site]
 181 and on the wireshark-users mailing list.
 182 Subscription information and archives for all of Wireshark’s mailing lists can be found on https://lists.wireshark.org/lists/[the mailing list site].
 183
 184 Bugs and feature requests can be reported on
 185 https://gitlab.com/wireshark/wireshark/-/issues[the issue tracker].
 186
 187 You can learn protocol analysis and meet Wireshark’s developers at
 188 https://sharkfest.wireshark.org[SharkFest].
 189
 190 // Official Wireshark training and certification are available from
 191 // https://www.wiresharktraining.com/[Wireshark University].
 192
 193 == How You Can Help
 194
 195 The Wireshark Foundation helps as many people as possible understand their networks as much as possible.
 196 You can find out more and donate at https://wiresharkfoundation.org[wiresharkfoundation.org].
 197
 198 == Frequently Asked Questions
 199
 200 A complete FAQ is available on the
 201 https://www.wireshark.org/faq.html[Wireshark web site].