add E-LMI to the release notes
[metze/wireshark/wip.git] / docbook / release-notes.asciidoc
1 = Wireshark wireshark-version:[] Release Notes
2
3 This is an experimental release intended to test new features for the next
4 stable release.
5
6 == What is Wireshark?
7
8 Wireshark is the world's most popular network protocol analyzer. It is
9 used for troubleshooting, analysis, development and education.
10
11 == What's New
12
13 === Bug Fixes
14
15 The following bugs have been fixed:
16
17 //* ws-buglink:5000[]
18 //* ws-buglink:6000[Wireshark bug]
19 //* cve-idlink:2013-2486[]
20 //* Wireshark always manages to score tickets for Burning Man, Coachella, and SXSW while you end up working double shifts. (ws-buglink:0000[])
21
22 * "On-the-wire" packet lengths are limited to 65535 bytes. (ws-buglink:8808[], ws-buglink:9390)
23 * "Follow TCP Stream" shows only the first HTTP req+res. (ws-buglink:9044[])
24 * Files with pcap-ng Simple Packet Blocks can't be read. (ws-buglink:9200[])
25 * MPLS-over-PPP isn't recognized. (ws-buglink:9492[])
26
27 === New and Updated Features
28
29 The following features are new (or have been significantly updated)
30 since version 1.11.2:
31
32 * Qt port:
33
34 ** The About dialog has been added
35 ** The Capture Interfaces dialog has been added.
36 ** The Decode As dialog has been added. It managed to swallow up the
37 User Specified Decodes dialog as well.
38 ** The Export PDU dialog has been added.
39 ** Several SCTP dialogs have been added.
40 ** The statistics tree (the backend for many Statistics and Telephony menu
41 items) dialog has been added.
42 ** The I/O Graph dialog has been added.
43 ** French translation has updated.
44
45 The following features are new (or have been significantly updated)
46 since version 1.11.1:
47
48 * Mac OS X packaging has been improved.
49
50 The following features are new (or have been significantly updated)
51 since version 1.11.0:
52
53 * Dissector output may be encoded as UTF-8. This includes TShark output.
54
55 * Qt port:
56
57 ** The Follow Stream dialog now supports packet and TCP stream selection.
58 ** A Flow Graph (sequence diagram) dialog has been added.
59 ** The main window now respects geometry preferences.
60
61
62 The following features are new (or have been significantly updated)
63 since version 1.10:
64
65 * Wireshark now uses the Qt application framework. The new UI should provide
66   a significantly better user experience, particularly on Mac OS X and Windows.
67 * The Windows installer now uninstalls the previous version of Wireshark
68   silently.  You can still run the uninstaller manually beforehand if you wish
69   to run it interactively.
70 * Expert information is now filterable when the new API is in use.
71 * The "Number" column shows related packets and protocol conversation spans
72   (Qt only).
73 * When manipulating packets with editcap using the -C <choplen> and/or
74   -s <snaplen> options, it is now possible to also adjust the original frame
75   length using the -L option.
76 * You can now pass the -C <choplen> option to editcap multiple times, which
77   allows you to chop bytes from the beginning of a packet as well as at the end
78   of a packet in a single step.
79 * You can now specify an optional offset to the -C option for editcap, which
80   allows you to start chopping from that offset instead of from the absolute
81   packet beginning or end.
82 * "malformed" display filter has been renamed to "_ws.malformed".  A handful of
83   other filters have been given the "_ws." prefix to note they are Wireshark
84   application specific filters and not dissector filters.
85 * The Kerberos dissector has been replaced with an auto generated one from ASN1
86   protocol description, changing a lot of filter names.  
87
88 === Removed dissectors
89
90 * The ASN1 plugin has been removed as it's deemed obsolete.
91 * The GNM dissector has been removed as it was never used.
92 * The Kerberos hand made dissector has been replaced by one generated from ASN1 code.
93
94 === New Protocol Support
95
96 --sort-and-group--
97
98 29West
99 802.1AE Secure tag
100 ACR122
101 ADB Client-Server
102 AllJoyn
103 Apple PKTAP
104 Aruba Instant AP
105 ASTERIX
106 ATN
107 Bencode
108 Bluetooth 3DS
109 Bluetooth HSP
110 Bluetooth Linux Monitor Transport
111 Bluetooth Low Energy
112 Bluetooth Low Energy RF Info
113 CARP
114 CFDP
115 Cisco MetaData
116 DCE/RPC MDSSVC
117 DeviceNet
118 Ethernet Local Management Interface (E-LMI)
119 ELF file format
120 EXPORTED PDU
121 FINGER
122 HDMI
123 HTTP2
124 IDRP
125 IEEE 1722a
126 ILP
127 iWARP Direct Data Placement and Remote Direct Memory Access Protocol
128 Kafka
129 Kyoto Tycoon
130 Landis & Gyr Telegyr 8979
131 LBM
132 LBMC
133 LBMPDM
134 LBMPDM-TCP
135 LBMR
136 LBT-RM
137 LBT-RU
138 LBT-TCP
139 Lightweight Mesh (v1.1.1)
140 Linux netlink
141 Linux netlink netfilter
142 Linux rtnetlink (route netlink)
143 Linux netlink sock diag
144 Logcat
145 MBIM
146 MiNT
147 MP4 / ISOBMFF file format
148 MQ Telemetry Transport Protocol
149 Novell PKIS certificate extensions
150 NXP PN532 HCI
151 OpenFlow
152 Open Sound Control
153 PDC
154 Pathport
155 Picture Transfer Protocol Over IP
156 PKTAP
157 Private Data Channel
158 QUIC (Quick UDP Internet Connections)
159 SAE J1939
160 SEL RTAC (Real Time Automation Controller) EIA-232 Serial-Line Dissection
161 Sippy RTPproxy
162 SMB-Direct
163 SPDY
164 STANAG 4607
165 STANAG 5066 DTS
166 STANAG 5066 SIS
167 Tinkerforge
168 Ubertooth
169 UDT
170 URL Encoded Form Data
171 USB Communications and CDC Control
172 USB Device Firmware Upgrade
173 VP8
174 WHOIS
175 Wi-Fi Display
176 ZigBee Green Power profile
177
178 --sort-and-group--
179
180 === Updated Protocol Support
181
182 Too many protocols have been updated to list here.
183
184 === New and Updated Capture File Support
185
186 --sort-and-group--
187
188 Netscaler 2.6
189 STANAG 4607
190 STANAG 5066 Data Transfer Sublayer
191
192 --sort-and-group--
193
194 === Major API Changes
195
196 The libwireshark API has undergone some major changes:
197
198 * A more flexible, modular memory manager (wmem) has been added. It was
199   available experimentally in 1.10 but is now mature and has mostly
200   replaced the old emem API (which is deprecated).
201 * A new API for expert information has been added, replacing the old one.
202 * The tvbuff API has been cleaned up: tvb_length has been renamed to
203   tvb_captured_length for clarity, and tvb_get_string and tvb_get_stringz
204   have been deprecated in favour of tvb_get_string_enc and
205   tvb_get_stringz_enc.
206
207 == Getting Wireshark
208
209 Wireshark source code and installation packages are available from
210 http://www.wireshark.org/download.html.
211
212 === Vendor-supplied Packages
213
214 Most Linux and Unix vendors supply their own Wireshark packages. You can
215 usually install or upgrade Wireshark using the package management system
216 specific to that platform. A list of third-party packages can be found
217 on the http://www.wireshark.org/download.html#thirdparty[download page]
218 on the Wireshark web site.
219
220 == File Locations
221
222 Wireshark and TShark look in several different locations for preference
223 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
224 from platform to platform. You can use About→Folders to find the default
225 locations on your system.
226
227 == Known Problems
228
229 Dumpcap might not quit if Wireshark or TShark crashes.
230 (ws-buglink:1419[])
231
232 The BER dissector might infinitely loop.
233 (ws-buglink:1516[])
234
235 Capture filters aren't applied when capturing from named pipes.
236 (ws-buglink:1814)
237
238 Filtering tshark captures with read filters (-R) no longer works.
239 (ws-buglink:2234[])
240
241 The 64-bit Windows installer does not support Kerberos decryption.
242 (https://wiki.wireshark.org/Development/Win64[Win64 development page])
243
244 Resolving (ws-buglink:9044[]) reopens (ws-buglink:3528[]) so that Wireshark
245 no longer automatically decodes gzip data when following a TCP stream.
246
247 Application crash when changing real-time option.
248 (ws-buglink:4035[])
249
250 Hex pane display issue after startup.
251 (ws-buglink:4056[])
252
253 Packet list rows are oversized.
254 (ws-buglink:4357[])
255
256 Summary pane selected frame highlighting not maintained.
257 (ws-buglink:4445[])
258
259 Wireshark and TShark will display incorrect delta times in some cases.
260 (ws-buglink:4985[])
261
262 The 64-bit Mac OS X installer doesn't support Mac OS X 10.9 (ws-buglink:9242[])
263
264 == Getting Help
265
266 Community support is available on http://ask.wireshark.org/[Wireshark's
267 Q&A site] and on the wireshark-users mailing list. Subscription
268 information and archives for all of Wireshark's mailing lists can be
269 found on http://www.wireshark.org/lists/[the web site].
270
271 Official Wireshark training and certification are available from
272 http://www.wiresharktraining.com/[Wireshark University].
273
274 == Frequently Asked Questions
275
276 A complete FAQ is available on the
277 http://www.wireshark.org/faq.html[Wireshark web site].