Update the release notes.
[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
48 //=== Removed Dissectors
49
50 //=== New File Format Decoding Support
51
52 === New Protocol Support
53
54 // Add one protocol per line between the --sort-and-group-- delimiters.
55 --sort-and-group--
56 Bluetooth HCI Vendor Intel
57 CAN FD
58 Ericsson A-bis P-GSL
59 Ericsson A-bis TFP (Traffic Forwarding Protocol)
60 Fc00/cjdns Protocol
61 GSM Osmux
62 Health Level 7 (HL7)
63 High-speed SECS message service (HSMS)
64 iPerf2
65 ISO 15765
66 Local Service Discovery (LSD)
67 M2 Application Protocol
68 Nordic BLE Sniffer
69 RFTap Protocol
70 SCTE-35 Digital Program Insertion Messages
71 Snort Post-dissector
72 Unified Diagnostic Services (UDS)
73 vSocket
74 Windows Cluster Management API (clusapi)
75 --sort-and-group--
76
77 === Updated Protocol Support
78
79 Too many protocols have been updated to list here.
80
81 === New and Updated Capture File Support
82
83 _Non-empty section placeholder._
84 // Add one file type per line between the --sort-and-group-- delimiters.
85 --sort-and-group--
86 --sort-and-group--
87
88 === New and Updated Capture Interfaces support
89
90 _Non-empty section placeholder._
91 --sort-and-group--
92 --sort-and-group--
93
94 //=== Major API Changes
95 IEEE802.11: wlan_mgt display filter element got renamed to wlan.
96
97 == Getting Wireshark
98
99 Wireshark source code and installation packages are available from
100 https://www.wireshark.org/download.html.
101
102 === Vendor-supplied Packages
103
104 Most Linux and Unix vendors supply their own Wireshark packages. You can
105 usually install or upgrade Wireshark using the package management system
106 specific to that platform. A list of third-party packages can be found
107 on the https://www.wireshark.org/download.html#thirdparty[download page]
108 on the Wireshark web site.
109
110 == File Locations
111
112 Wireshark and TShark look in several different locations for preference
113 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
114 from platform to platform. You can use About→Folders to find the default
115 locations on your system.
116
117 == Known Problems
118
119 Dumpcap might not quit if Wireshark or TShark crashes.
120 (ws-buglink:1419[])
121
122 The BER dissector might infinitely loop.
123 (ws-buglink:1516[])
124
125 Capture filters aren't applied when capturing from named pipes.
126 (ws-buglink:1814[])
127
128 Filtering tshark captures with read filters (-R) no longer works.
129 (ws-buglink:2234[])
130
131 Application crash when changing real-time option.
132 (ws-buglink:4035[])
133
134 Wireshark and TShark will display incorrect delta times in some cases.
135 (ws-buglink:4985[])
136
137 Wireshark should let you work with multiple capture files. (ws-buglink:10488[])
138
139 Dell Backup and Recovery (DBAR) makes many Windows applications crash,
140 including Wireshark. (ws-buglink:12036[])
141
142 == Getting Help
143
144 Community support is available on https://ask.wireshark.org/[Wireshark's
145 Q&A site] and on the wireshark-users mailing list. Subscription
146 information and archives for all of Wireshark's mailing lists can be
147 found on https://www.wireshark.org/lists/[the web site].
148
149 Official Wireshark training and certification are available from
150 http://www.wiresharktraining.com/[Wireshark University].
151
152 == Frequently Asked Questions
153
154 A complete FAQ is available on the
155 https://www.wireshark.org/faq.html[Wireshark web site].