docbook/release-notes.asciidoc

   1 = Wireshark wireshark-version:[] Release Notes
   2 // AsciiDoc quick reference: http://powerman.name/doc/asciidoc
   3
   4 This is a semi-experimental release intended to test new features for Wireshark 2.0.
   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:2014-2486[]
  20 //* Wireshark insists on calling you on your land line which is keeping you from abandoning it for cellular. (ws-buglink:0000[])
  21
  22 === New and Updated Features
  23
  24 The following features are new (or have been significantly updated)
  25 since version 1.99.7:
  26
  27 * Qt port:
  28
  29 ** The Enabled Protocols dialog has been added.
  30 ** Many statistics dialogs have been added, including Service response time,
  31    DHCP/BOOTP, and ANSI.
  32 ** The RTP Analysis dialog has been added.
  33 ** Lua dialog support has been added.
  34 ** You can now manually resolve addresses.
  35 ** The Resolved Addresses dialog has been added.
  36 ** The packet list scrollbar now has a minimap.
  37 ** The capture interfaces dialog has been updated.
  38 ** You can now colorize conversations.
  39 ** Welcome screen behavior has been improved.
  40 ** Plugin support has been improved.
  41 ** Many dialogs should now more correctly minimize and maximize.
  42 ** The reload button has been added back to the toolbar.
  43 ** The "Decode As" dialog no longer saves decoding behavior.
  44 ** You can now stop loading large capture files.
  45 ** The Bluetooth HCI Summary has been added.
  46
  47 The following features are new (or have been significantly updated)
  48 since version 1.99.6:
  49
  50 * Qt port:
  51
  52 ** The Bluetooth Devices dialog has been added.
  53 ** The wireless toolbar has been added.
  54 ** Opening files via drag and drop is now supported.
  55 ** The Capture Filter and Display Filter dialogs have been added.
  56 ** The Display Filter Expression dialog has been added.
  57 ** Conversation Filter menu items have been added.
  58 ** You can change protocol preferences by right clicking on the packet list
  59    and details.
  60
  61 The following features are new (or have been significantly updated)
  62 since version 1.99.4 and 1.99.5:
  63
  64 * Qt port:
  65
  66 ** Capture restarts are now supported.
  67 ** Menu items for plugins are now supported.
  68 ** Extcap interfaces are now supported.
  69 ** The Expert Information dialog has been added.
  70 ** Display and capture filter completion is now supported.
  71 ** Many bugs have been fixed.
  72 ** Translations have been updated.
  73
  74 The following features are new (or have been significantly updated)
  75 since version 1.99.3:
  76
  77 * Qt port:
  78
  79 ** Several interface bugs have been fixed.
  80 ** Translations have been updated.
  81
  82 The following features are new (or have been significantly updated)
  83 since version 1.99.2:
  84
  85 * Qt port:
  86
  87 ** Several bugs have been fixed.
  88 ** You can now open a packet in a new window.
  89 ** The Bluetooth ATT Server Attributes dialog has been added.
  90 ** The Coloring Rules dialog has been added.
  91 ** Many translations have been updated. Chinese, Italian and Polish
  92    translations are complete.
  93 ** General user interface and usability improvements.
  94 ** Automatic scrolling during capture now works.
  95 ** The related packet indicator has been updated.
  96
  97 The following features are new (or have been significantly updated)
  98 since version 1.99.1:
  99
 100 * Qt port:
 101
 102 ** The welcome screen layout has been updated.
 103 ** The Preferences dialog no longer crashes on Windows.
 104 ** The packet list header menu has been added.
 105 ** Statistics tree plugins are now supported.
 106 ** The window icon is now displayed properly in the Windows taskbar.
 107 ** A packet list an byte view selection bug has been fixed (ws-buglink:10896[])
 108 ** The RTP Streams dialog has been added.
 109 ** The Protocol Hierarchy Statistics dialog has been added.
 110
 111 The following features are new (or have been significantly updated)
 112 since version 1.99.0:
 113
 114 * Qt port:
 115
 116 ** You can now show and hide toolbars and major widgets using the View menu.
 117 ** You can now set the time display format and precision.
 118 ** The byte view widget is much faster, particularly when selecting large
 119 reassembled packets.
 120 ** The byte view is explorable. Hovering over it highlights the corresponding
 121 field and shows a description in the status bar.
 122 ** An Italian translation has been added.
 123 ** The Summary dialog has been updated and renamed to Capture File Properties.
 124 ** The VoIP Calls and SIP Flows dialogs have been added.
 125 ** Support for HiDPI / Retina displays has been improved in the official packages.
 126
 127 * DNS stats:
 128      + A new stats tree has been added to the Statistics menu. Now it
 129        is possible to collect stats such as qtype/qclass distribution,
 130        number of resource record per response section, and stats data
 131        (min, max, avg) for values such as query name length or DNS
 132        payload.
 133
 134 * HPFEEDS stats:
 135      + A new stats tree has been added to the statistics menu. Now it
 136        is possible to collect stats per channel (messages count and payload
 137        size), and opcode distribution.
 138
 139 * HTTP2 stats:
 140      + A new stats tree has been added to the statistics menu. Now it
 141        is possible to collect stats (type distribution).
 142
 143 The following features are new (or have been significantly updated)
 144 since version 1.12.0:
 145
 146 * The I/O Graph in the Gtk+ UI now supports an unlimited number of data points
 147 (up from 100k).
 148 * TShark now resets its state when changing files in ring-buffer mode.
 149 * Expert Info severities can now be configured.
 150 * Wireshark now supports external capture interfaces.  External capture
 151 interfaces can be anything from a tcpdump-over-ssh pipe to a program that
 152 captures from proprietary or non-standard hardware.  This functionality is not
 153 available in the Qt UI yet.
 154
 155 * Qt port:
 156
 157 ** The Qt UI is now the default (program name is wireshark).
 158 ** A Polish translation has been added.
 159 ** The Interfaces dialog has been added.
 160 ** The interface list is now updated when interfaces appear or disappear.
 161 ** The Conversations and Endpoints dialogs have been added.
 162 ** A Japanese translation has been added.
 163 ** It is now possible to manage remote capture interfaces.
 164 ** Windows: taskbar progress support has been added.
 165 ** Most toolbar actions are in place and work.
 166 ** More command line options are now supported
 167
 168 //=== Removed Dissectors
 169
 170 === New File Format Support
 171
 172 --sort-and-group--
 173 BTSNOOP
 174 PCAP
 175 PCAPNG
 176 --sort-and-group--
 177
 178 === New Protocol Support
 179
 180 --sort-and-group--
 181 Generic Network Virtualization Encapsulation (Geneve)
 182 IPMI Trace
 183 iSER
 184 OptoMMP
 185 corosync/totemnet  corosync cluster engine ( lowest levelencryption/decryption protocol)
 186 corosync/totemsrp corosync cluster engine ( totem single ring protocol)
 187 ceph
 188 GVSP GigE Vision (TM) Streaming Protocol
 189 HCrt
 190 Stateless Transport Tunneling
 191 CP ``Cooper'' 2179
 192 S7 Communication
 193 KNXnetIP
 194 Dynamic Source Routing (RFC 4728)
 195 MCPE (Minecraft Pocket Edition)
 196 RakNet games library
 197 (LISP) TCP Control Message
 198 Android ADB
 199 Android Logcat text
 200 Couchbase
 201 AllJoyn Reliable Datagram Protocol
 202 HiQnet
 203 Elasticsearch
 204 Shared Memory Communications - RDMA
 205 Remote Shared Virtual Disk - RSVD
 206 Riemann
 207 MACsec Key Agreement - EAPoL-MKA
 208 DJI UAV Drone Control Protocol
 209 ZVT Kassenschnittstelle
 210 ETSI Card Application Toolkit - Transport Protocol
 211 Apache Tribes Heartbeat
 212 QNEX6 (QNET)
 213 Secure Socket Tunnel Protocol (SSTP)
 214 BGP Monitoring Prototol (BMP)
 215 Video Services over IP (VSIP)
 216 OCFS2
 217 Geospatial and Imagery Access Service (GIAS)
 218 C15 Call History Protocol dissection (C15ch)
 219 Thrift
 220 IP Detail Record (IPDR)
 221 Performance Co-Pilot Proxy
 222 Aeron
 223 Network File System over Remote Direct Memory Access (NFSoRDMA)
 224 eXpressive Internet Protocol (XIP)
 225 Windows Search Protocol (MS-WSP)
 226 Message Queuing Telemetry Transport For Sensor Networks (MQTT-SN)
 227 --sort-and-group--
 228
 229 === Updated Protocol Support
 230
 231 Too many protocols have been updated to list here.
 232
 233 === New and Updated Capture File Support
 234
 235 --sort-and-group--
 236 Android Logcat text files
 237 Wireshark now supports nanosecond timestamp resolution in PCAP-NG files.
 238 Colasoft Capsa files
 239 Netscaler 3.5
 240 3GPP TS 32.423 Trace
 241 --sort-and-group--
 242
 243 === New and Updated Capture Interfaces support
 244
 245 --sort-and-group--
 246 Androiddump - provide interfaces to capture (Logcat and Bluetooth) from connected Android devices
 247 --sort-and-group--
 248
 249 === Major API Changes
 250
 251 The libwireshark API has undergone some major changes:
 252
 253 * The emem framework (including all ep_ and se_ memory allocation routines) has
 254 been completely removed in favour of wmem which is now fully mature.
 255 * The (long-since-broken) Python bindings support has been removed.  If
 256 you want to write dissectors in something other than C, use Lua.
 257 * Plugins can now create GUI menu items.
 258 * Heuristic dissectors can now be globally enabled/disabled so
 259 heur_dissector_add() has a few more parameters to make that possible
 260
 261
 262 == Getting Wireshark
 263
 264 Wireshark source code and installation packages are available from
 265 https://www.wireshark.org/download.html.
 266
 267 === Vendor-supplied Packages
 268
 269 Most Linux and Unix vendors supply their own Wireshark packages. You can
 270 usually install or upgrade Wireshark using the package management system
 271 specific to that platform. A list of third-party packages can be found
 272 on the https://www.wireshark.org/download.html#thirdparty[download page]
 273 on the Wireshark web site.
 274
 275 == File Locations
 276
 277 Wireshark and TShark look in several different locations for preference
 278 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
 279 from platform to platform. You can use About→Folders to find the default
 280 locations on your system.
 281
 282 == Known Problems
 283
 284 Dumpcap might not quit if Wireshark or TShark crashes.
 285 (ws-buglink:1419[])
 286
 287 The BER dissector might infinitely loop.
 288 (ws-buglink:1516[])
 289
 290 Capture filters aren't applied when capturing from named pipes.
 291 (ws-buglink:1814[])
 292
 293 Filtering tshark captures with read filters (-R) no longer works.
 294 (ws-buglink:2234[])
 295
 296 Resolving (ws-buglink:9044[]) reopens (ws-buglink:3528[]) so that Wireshark
 297 no longer automatically decodes gzip data when following a TCP stream.
 298
 299 Application crash when changing real-time option.
 300 (ws-buglink:4035[])
 301
 302 Hex pane display issue after startup.
 303 (ws-buglink:4056[])
 304
 305 Packet list rows are oversized.
 306 (ws-buglink:4357[])
 307
 308 Wireshark and TShark will display incorrect delta times in some cases.
 309 (ws-buglink:4985[])
 310
 311 The 64-bit version of Wireshark will leak memory on Windows when the display
 312 depth is set to 16 bits (ws-buglink:9914[])
 313
 314 Wireshark should let you work with multiple capture files. (ws-buglink:10488[])
 315
 316 == Getting Help
 317
 318 Community support is available on https://ask.wireshark.org/[Wireshark's
 319 Q&A site] and on the wireshark-users mailing list. Subscription
 320 information and archives for all of Wireshark's mailing lists can be
 321 found on https://www.wireshark.org/lists/[the web site].
 322
 323 Official Wireshark training and certification are available from
 324 http://www.wiresharktraining.com/[Wireshark University].
 325
 326 == Frequently Asked Questions
 327
 328 A complete FAQ is available on the
 329 https://www.wireshark.org/faq.html[Wireshark web site].