fdf8847ede77bd76326c42bbafd8bdeb4199c828
[metze/wireshark/wip.git] / docbook / release-notes.asciidoc
1 include::attributes.asciidoc[]
2
3 = Wireshark {wireshark-version} Release Notes
4 // AsciiDoc quick reference: http://powerman.name/doc/asciidoc
5
6 This is a semi-experimental release intended to test new features for
7 Wireshark 2.4.
8
9 == What is Wireshark?
10
11 Wireshark is the world's most popular network protocol analyzer. It is
12 used for troubleshooting, analysis, development and education.
13
14 == What's New
15
16 //=== Bug Fixes
17
18 //The following bugs have been fixed:
19
20 //* ws-buglink:5000[]
21 //* ws-buglink:6000[Wireshark bug]
22 //* cve-idlink:2014-2486[]
23 //* Wireshark keeps leaving voicemails advertising timeshare condominiums in Fresno. (ws-buglink:0000[])
24
25 //_Non-empty section placeholder._
26
27 === New and Updated Features
28
29 The following features are new (or have been significantly updated)
30 since version 2.2.0:
31
32 * Experimental 32-bit and 64-bit Windows Installer (.msi) packages are available.
33   It is recommended that you use these independently of the NSIS (.exe) installers.
34   That is, you should make sure the NSIS package is completely uninstalled before
35   installing the Windows Installer package and vice-versa.
36 * Source packages are now compressed using xz instead of bzip2.
37 * The legacy (GTK+) UI is disabled by default in the Windows installer.
38 * The legacy (GTK+) UI is disabled by default in Autotools and CMake.
39 * SS7 Point Codes can now be resolved into names with a hosts-like file.
40 * Wireshark can now go fullscreen to have more room for packets.
41 * TShark can now export objects like the other GUI interfaces.
42 * Support for G.722 and G.726 codecs in the RTP Player (via the SpanDSP library).
43 * You can now choose the output device when playing RTP streams.
44 * Added support for dissectors to include a unit name natively in their hf field.
45   A field can now automatically append "seconds" or "ms" to its value without
46   additional printf-style APIs.
47 * The Default profile can now be reset to default values.
48 * You can move back and forth in the selection history in the Qt UI.
49 * IEEE 802.15.4 dissector now uses an UAT for decryption keys. The original
50   decryption key preference has been obsoleted.
51 * Extcap utilities can now provide configuration for a GUI interface toolbar to
52   control the extcap utility while capturing.
53
54 //=== Removed Dissectors
55
56 //=== New File Format Decoding Support
57
58 === New Protocol Support
59
60 // Add one protocol per line between the --sort-and-group-- delimiters.
61 --sort-and-group--
62 Bluetooth HCI Vendor Intel
63 CAN FD
64 Ericsson A-bis P-GSL
65 Ericsson A-bis TFP (Traffic Forwarding Protocol)
66 Fc00/cjdns Protocol
67 Generic Netlink (genl)
68 GSM Osmux
69 Health Level 7 (HL7)
70 High-speed SECS message service (HSMS)
71 iPerf2
72 ISO 15765
73 Linux 802.11 Netlink (nl80211)
74 Local Service Discovery (LSD)
75 M2 Application Protocol
76 Mesh Link Establishment (MLE)
77 Nordic BLE Sniffer
78 NVMe Fabrics RDMA
79 NVMe
80 OpenThread simulator
81 RFTap Protocol
82 SCTE-35 Digital Program Insertion Messages
83 Snort Post-dissector
84 Thread CoAP
85 Unified Diagnostic Services (UDS)
86 vSocket
87 Windows Cluster Management API (clusapi)
88 GSMTAP based logging
89 HomePNA
90 X-Rite i1 Display Pro (and derivatives) USB protocol
91 IndigoCare iCall protocol
92 IndigoCare Netrix protocol
93 NetScaler HA Protocol
94 NetScaler Metric Exchange Protocol
95 NetScaler RPC Protocol
96 DirectPlay 8 protocol
97 NM protocol
98 Netgear Ensemble Protocol
99 --sort-and-group--
100
101 === Updated Protocol Support
102
103 Too many protocols have been updated to list here.
104
105 === New and Updated Capture File Support
106
107 _Non-empty section placeholder._
108 // Add one file type per line between the --sort-and-group-- delimiters.
109 --sort-and-group--
110 --sort-and-group--
111
112 === New and Updated Capture Interfaces support
113
114 _Non-empty section placeholder._
115 --sort-and-group--
116 --sort-and-group--
117
118 //=== Major API Changes
119 IEEE802.11: wlan_mgt display filter element got renamed to wlan.
120 Libgcrypt is now a required dependency.
121
122 == Getting Wireshark
123
124 Wireshark source code and installation packages are available from
125 https://www.wireshark.org/download.html.
126
127 === Vendor-supplied Packages
128
129 Most Linux and Unix vendors supply their own Wireshark packages. You can
130 usually install or upgrade Wireshark using the package management system
131 specific to that platform. A list of third-party packages can be found
132 on the https://www.wireshark.org/download.html#thirdparty[download page]
133 on the Wireshark web site.
134
135 == File Locations
136
137 Wireshark and TShark look in several different locations for preference
138 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
139 from platform to platform. You can use About→Folders to find the default
140 locations on your system.
141
142 == Known Problems
143
144 Dumpcap might not quit if Wireshark or TShark crashes.
145 (ws-buglink:1419[])
146
147 The BER dissector might infinitely loop.
148 (ws-buglink:1516[])
149
150 Capture filters aren't applied when capturing from named pipes.
151 (ws-buglink:1814[])
152
153 Filtering tshark captures with read filters (-R) no longer works.
154 (ws-buglink:2234[])
155
156 Application crash when changing real-time option.
157 (ws-buglink:4035[])
158
159 Wireshark and TShark will display incorrect delta times in some cases.
160 (ws-buglink:4985[])
161
162 Wireshark should let you work with multiple capture files. (ws-buglink:10488[])
163
164 Dell Backup and Recovery (DBAR) makes many Windows applications crash,
165 including Wireshark. (ws-buglink:12036[])
166
167 == Getting Help
168
169 Community support is available on https://ask.wireshark.org/[Wireshark's
170 Q&A site] and on the wireshark-users mailing list. Subscription
171 information and archives for all of Wireshark's mailing lists can be
172 found on https://www.wireshark.org/lists/[the web site].
173
174 Official Wireshark training and certification are available from
175 http://www.wiresharktraining.com/[Wireshark University].
176
177 == Frequently Asked Questions
178
179 A complete FAQ is available on the
180 https://www.wireshark.org/faq.html[Wireshark web site].