0ed61a278285ecb54e5db14bb6cb879ba0f1c162
[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 * GTK+ is disabled by default in Autotools and CMake.
38 * SS7 Point Codes can now be resolved into names with a hosts-like file.
39 * Wireshark can now go fullscreen to have more room for packets.
40 * TShark can now export objects like the other GUI interfaces.
41 * Support for G.722 and G.726 codecs in the RTP Player (via the SpanDSP library).
42 * You can now choose the output device when playing RTP streams.
43 * Added support for dissectors to include a unit name natively in their hf field.
44   A field can now automatically append "seconds" or "ms" to its value without
45   additional printf-style APIs.
46
47 //=== Removed Dissectors
48
49 //=== New File Format Decoding Support
50
51 === New Protocol Support
52
53 // Add one protocol per line between the --sort-and-group-- delimiters.
54 --sort-and-group--
55 Nordic BLE Sniffer
56 Ericsson A-bis TFP (Traffic Forwarding Protocol)
57 Ericsson A-bis P-GSL
58 vSocket
59 ISO 15765
60 Unified Diagnostic Services (UDS)
61 SCTE-35 Digital Program Insertion Messages
62 Windows Cluster Management API (clusapi)
63 RFTap Protocol
64 M2 Application Protocol
65 CAN FD
66 Bluetooth HCI Vendor Intel
67 High-speed SECS message service (HSMS)
68 GSM Osmux
69 Health Level 7 (HL7)
70 Local Service Discovery (LSD)
71 Fc00/cjdns Protocol
72 iPerf2
73 Snort Post-dissector
74
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 Packet list rows are oversized.
135 (ws-buglink:4357[])
136
137 Wireshark and TShark will display incorrect delta times in some cases.
138 (ws-buglink:4985[])
139
140 Wireshark should let you work with multiple capture files. (ws-buglink:10488[])
141
142 Dell Backup and Recovery (DBAR) makes many Windows applications crash,
143 including Wireshark. (ws-buglink:12036[])
144
145 == Getting Help
146
147 Community support is available on https://ask.wireshark.org/[Wireshark's
148 Q&A site] and on the wireshark-users mailing list. Subscription
149 information and archives for all of Wireshark's mailing lists can be
150 found on https://www.wireshark.org/lists/[the web site].
151
152 Official Wireshark training and certification are available from
153 http://www.wiresharktraining.com/[Wireshark University].
154
155 == Frequently Asked Questions
156
157 A complete FAQ is available on the
158 https://www.wireshark.org/faq.html[Wireshark web site].