docbook/release-notes.asciidoc

   1 include::attributes.asciidoc[]
   2 :stylesheet: ws.css
   3 :linkcss:
   4
   5 = Wireshark {wireshark-version} Release Notes
   6 // AsciiDoc quick reference: http://powerman.name/doc/asciidoc
   7 // Asciidoctor Syntax Quick Reference:
   8 // http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
   9
  10 This is an experimental release intended to test new features for
  11 Wireshark 3.0.
  12
  13 == What is Wireshark?
  14
  15 Wireshark is the world’s most popular network protocol analyzer. It is
  16 used for troubleshooting, analysis, development and education.
  17
  18 == What’s New
  19
  20 Many user interface improvements have been made. See the “New and Updated
  21 Features” section below for more details.
  22
  23 === Bug Fixes
  24
  25 The following bugs have been fixed:
  26
  27 //* wsbuglink:5000[]
  28 //* wsbuglink:6000[Wireshark bug]
  29 //* cveidlink:2014-2486[]
  30 //* Wireshark slowly leaked water under the kitchen sink over the course of several months, causing a big mess.
  31
  32 //_Non-empty section placeholder._
  33
  34 Dumpcap might not quit if Wireshark or TShark crashes.
  35 (wsbuglink:1419[])
  36
  37 === New and Updated Features
  38
  39 The following features are new (or have been significantly updated)
  40 since version 2.6.0:
  41
  42 * The membership operator now supports ranges, allowing display filters such as
  43   `tcp.port in {4430..4434}` to be expressed. See the User's Guide, chapter
  44   _Building display filter expressions_ for details.
  45 * The autotools build system has been removed. CMake is the one build system now.
  46 * tshark has now "-G elastic-mapping" option to generate an ElasticSearch mapping file.
  47 * The “Capture Information” dialog has been added back (wsbuglink:12004[]).
  48
  49 === Removed Features and Support
  50
  51 * The legacy (GTK+) user interface has been removed and is no longer supported.
  52 * Wireshark requires Qt 5.2 or later. Qt 4 is no longer supported.
  53 * Wireshark requires GLib 2.32 or later.
  54 * Building Wireshark using Autotools is no longer supported.
  55
  56 //=== Removed Dissectors
  57
  58 //=== New File Format Decoding Support
  59
  60 === New Protocol Support
  61
  62 // Add one protocol per line between the -- delimiters.
  63 [commaize]
  64 --
  65 DoIP (ISO 13400-2 Diagnostic communication over Internet Protocol)
  66 GSUP (Osmocom Generic Subscriber Update Protocol)
  67 NR (5G) PDCP protocol
  68 TPM 2.0 protocol
  69 PROXY (v2) protocol
  70 --
  71 GSM-R protocol (User-to-User Information Element usage)
  72 --
  73
  74 === Updated Protocol Support
  75
  76 Too many protocols have been updated to list here.
  77
  78 === New and Updated Capture File Support
  79
  80 //_Non-empty section placeholder._
  81 // Add one file type per line between the --sort-and-group-- delimiters.
  82 [commaize]
  83
  84 === New and Updated Capture Interfaces support
  85
  86 //_Non-empty section placeholder._
  87 [commaize]
  88 --
  89 A new extcap has been added: dpauxmon. It allows capturing DisplayPort AUX channel
  90 data from linux kernel drivers.
  91 --
  92
  93 //=== Major API Changes
  94
  95 == Getting Wireshark
  96
  97 Wireshark source code and installation packages are available from
  98 https://www.wireshark.org/download.html.
  99
 100 === Vendor-supplied Packages
 101
 102 Most Linux and Unix vendors supply their own Wireshark packages. You can
 103 usually install or upgrade Wireshark using the package management system
 104 specific to that platform. A list of third-party packages can be found
 105 on the https://www.wireshark.org/download.html#thirdparty[download page]
 106 on the Wireshark web site.
 107
 108 == File Locations
 109
 110 Wireshark and TShark look in several different locations for preference
 111 files, plugins, SNMP MIBS, and RADIUS dictionaries. These locations vary
 112 from platform to platform. You can use About→Folders to find the default
 113 locations on your system.
 114
 115 == Known Problems
 116
 117 The BER dissector might infinitely loop.
 118 (wsbuglink:1516[])
 119
 120 Capture filters aren't applied when capturing from named pipes.
 121 (wsbuglink:1814[])
 122
 123 Filtering tshark captures with read filters (-R) no longer works.
 124 (wsbuglink:2234[])
 125
 126 Application crash when changing real-time option.
 127 (wsbuglink:4035[])
 128
 129 Wireshark and TShark will display incorrect delta times in some cases.
 130 (wsbuglink:4985[])
 131
 132 Wireshark should let you work with multiple capture files. (wsbuglink:10488[])
 133
 134 == Getting Help
 135
 136 Community support is available on https://ask.wireshark.org/[Wireshark’s
 137 Q&A site] and on the wireshark-users mailing list. Subscription
 138 information and archives for all of Wireshark’s mailing lists can be
 139 found on https://www.wireshark.org/lists/[the web site].
 140
 141 Official Wireshark training and certification are available from
 142 http://www.wiresharktraining.com/[Wireshark University].
 143
 144 == Frequently Asked Questions
 145
 146 A complete FAQ is available on the
 147 https://www.wireshark.org/faq.html[Wireshark web site].