aboutsummaryrefslogtreecommitdiffstats
path: root/NEWS
blob: e64ee271cb39366bf550c0265731280a6fd93237 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
Wireshark 3.7.0 Release Notes

 This is an experimental release intended to test new features for
 Wireshark 4.0.

 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

    • We no longer ship Windows Installer (.msi) packages for 32-bit
      Windows. Issue 17779[1]

    • The PCRE2 library (https://www.pcre.org/) is now a required
      dependency to build Wireshark.

    • You must now have a compiler with C11 support in order to build
      Wireshark.

  Many improvements have been made. See the “New and Updated Features”
  section below for more details.

  New and Updated Features

   The following features are new (or have been significantly updated)
   since version 3.6.0:

     • The Windows installers now ship with Npcap 1.60. They previously
       shipped with Npcap 1.55.

     • Display filter syntax:

        • Set elements must be separated using a comma, e.g: {1, 2,
       "foo"}. Using only whitespace as separator was deprecated in 3.6
       and is now a syntax error.

        • Adds support for some additional character escape sequences in
       double quoted strings. Besides octal and hex byte specification
       the following C escape sequences are now supported with the same
       meaning: \a, \b, \f, \n, \r, \t, \v. Previously they were only
       supported with character constants.

        • Unrecognized escape sequences are now treated as a syntax
       error. Previously they were treated as a literal character. In
       addition to the sequences indicated above, backslash, single
       quotation and double quotation mark are also valid sequences: \\,
       \', \".

        • The display filter engine now uses PCRE2 instead of GRegex
       (GLib bindings to the older end-of-life PCRE library). PCRE2 is
       compatible with PCRE so the user-visible changes should be
       minimal. Some exotic patterns may now be invalid and require
       rewriting.

        • Adds a new strict equality operator "===" or "all_eq". The
       expression "a === b" is true if and only if all a’s are equal to
       b. The negation of "===" can now be written as "!==" (any_ne).

        • Adds the aliases "any_eq" for "==" and "all_ne" for "!=".

        • The operator "~=" is deprecated and will be removed in a
       future version. Use "!==" with the same meaning instead.

        • Date and time can be given in UTC using ISO 8601 (with 'Z'
       timezone) or by appending the suffix "UTC" to the legacy formats.
       Otherwise local time is used.

        • Integer literal constants may be written in binary (in
       addition to decimal/octal/hexadecimal) using the prefix "0b" or
       "0B".

        • New syntax to disambiguate literals from identifiers. Every
       value with a leading dot is a protocol or protocol field. Every
       value with a leading colon or in between angle brackets is a
       literal value. See the User Guide for details.

        • Floats must be written with a leading and ending digit. For
       example the values ".7" and "7." are now invalid as floats. It
       must be written "0.7" and "7.0" respectively.

        • The "bitwise and" operator is now a first-class bit operator,
       not a boolean operator. In particular this means it is now
       possible to mask bits, e.g.: frame[0] & 0x0F == 3.

        • Arithmetic is supported for numeric fields with the usual
       operators: +, -, *, /, %. Arithmetic expressions must be grouped
       using curly brackets (not parenthesis).

        • Logical AND now has higher precedence than logical OR, in line
       with most programming languages.

        • Adds new display filter functions max() and min().

     • text2pcap and "Import from Hex Dump":

        • text2pcap supports writing the output file in all the capture
       file formats that wiretap library supports, using the same "-F"
       option as editcap, mergecap, and tshark.

        • text2pcap supports selecting the encapsulation type of the
       output file format using the wiretap library short names with an
       "-E" option, similiar to the "-T" option of editcap.

        • text2pcap has been updated to use the new logging output
       options and the "-d" flag has been removed. The "debug" log level
       corresponds to the old "-d" flag, and the "noisy" log level
       corresponds to using "-d" multiple times.

        • text2pcap and Import from Hex Dump support writing fake IP
       headers (and fake TCP, UDP, and SCTP headers) to files with Raw
       IP, Raw IPv4, and Raw IPv6 encapsulations, in addition to
       Ethernet encapsulation as previously.

        • text2pcap supports scanning the input file using a custom
       regular expression, as supported in Import from Hex Dump in
       Wireshark 3.6.x.

        • In general, text2pcap and wireshark’s Import from Hex Dump
       have feature parity.

     • HTTP2 dissector now supports using fake headers to parse the
       DATAs of streams captured without first HEADERS frames of a
       long-lived stream (like gRPC streaming call which allows sending
       many request or response messages in one HTTP2 stream). User can
       specify fake headers according to the server port, stream id and
       direction of the long-lived stream that we start capturing
       packets after it is established.

     • Mesh Connex (MCX) support in existing 802.11 packets.

     • Capture Options dialog contains same configuration icon as
       Welcome Screen. It is possible to configure interface there.

     • Extcap dialog remembers password items during runtime therefore
       it is possible to run extcap multiple times in row. Passwords are
       never stored to disk.

     • It is possible to set extcap passwords on cli for tshark and
       other cli tools.

     • Extcap configuration dialog now supports and remembers empty
       strings. There are new buttons to reset a value back to default
       value.

     • Support to display JSON mapping for Protobuf message.

     • macOS debugging symbols are now shipped in separate packages.

     • ZigBee ZCL Messaging: rename zbee_zcl_se.msg.msg_ctrl.depreciated
       to zbee_zcl_se.msg.msg_ctrl.deprecated

  Removed Features and Support

     • CMake: The options starting with DISABLE_something were renamed
       ENABLE_something for consistency. For example DISABLE_WERROR=On
       became ENABLE_WERROR=Off. The defaults are unchanged.

  New File Format Decoding Support

  New Protocol Support

   Allied Telesis Loop Detection (AT LDF), AUTOSAR I-PDU Multiplexer
   (AUTOSAR I-PduM), DTN Bundle Protocol Security (BPSec), DTN Bundle
   Protocol Version 7 (BPv7), DTN TCP Convergence Layer Protocol
   (TCPCL), DVB Selection Information Table (DVB SIT), Enhanced Cash
   Trading Interface 10.0 (XTI), Enhanced Order Book Interface 10.0
   (EOBI), Enhanced Trading Interface 10.0 (ETI), FiveCo’s Legacy
   Register Access Protocol (5co-legacy), Generic Data Transfer Protocol
   (GDT), gRPC Web (gRPC-Web), Host IP Configuration Protocol (HICP),
   Mesh Connex (MCX), Microsoft Cluster Remote Control Protocol (RCP),
   Realtek, REdis Serialization Protocol v2 (RESP), Secure File Transfer
   Protocol (sftp), Secure Host IP Configuration Protocol (SHICP), USB
   Attached SCSI (UASP), and ZBOSS NCP

  Updated Protocol Support

   Too many protocols have been updated to list here.

  New and Updated Capture File Support

  Major API Changes

     • proto.h: The field display types "STR_ASCII" and "STR_UNICODE"
       were removed. Use "BASE_NONE" instead.

 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 download page[2] 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 "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 Wireshark’s Q&A site[3] and on the
  wireshark-users mailing list. Subscription information and archives
  for all of Wireshark’s mailing lists can be found on the web site[4].

  Bugs and feature requests can be reported on the issue tracker[5].

 Frequently Asked Questions

  A complete FAQ is available on the Wireshark web site[6].

  Last updated 2022-04-13 13:07:01 UTC

 References

   1. https://gitlab.com/wireshark/wireshark/-/issues/17779
   2. https://www.wireshark.org/download.html
   3. https://ask.wireshark.org/
   4. https://www.wireshark.org/lists/
   5. https://gitlab.com/wireshark/wireshark/-/issues
   6. https://www.wireshark.org/faq.html