e20f4caeba5477c13b881ef4760f4ecdaa46769a
[obnox/wireshark/wip.git] / docbook / release-notes.xml
1 <?xml version="1.0"?>
2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4
5 <!-- $Id$ -->
6
7 <!--
8 DOCUMENT SECTION
9 -Use this section to encode all document information
10 -->
11
12 <!--
13 Wireshark Info
14 -->
15   <!ENTITY WiresharkCurrentVersion "1.5.0">
16
17 ]>
18
19 <article>
20   <title>Wireshark &WiresharkCurrentVersion; Release Notes</title>
21
22   <section id="WhatIs"><title>What is Wireshark?</title>
23     <para>
24       Wireshark is the world's most popular network protocol analyzer.  It
25       is used for troubleshooting, analysis, development and education.
26     </para>
27   </section>
28
29   <section id="WhatsNew"><title>What's New</title>
30     <section id="BugFixes"><title>Bug Fixes</title>
31
32     <para>
33
34     The following bugs have been fixed:
35
36       <itemizedlist>
37
38         <listitem><para>
39           Wireshark is unresponsive when capturing from named pipes on Windows.
40           (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1759">Bug
41           1759</ulink>)
42         </para></listitem>
43
44       </itemizedlist>
45
46     </para>
47
48     </section>
49
50     <section id="NewFeatures"><title>New and Updated Features</title>
51     <para>
52       The following features are new (or have been significantly updated)
53       since version 1.4:
54
55       <itemizedlist>
56
57         <listitem>
58           <para>
59             Wireshark can import text dumps, similar to text2pcap.
60           </para>
61         </listitem>
62
63         <listitem>
64           <para>
65             You can now view Wireshark's dissector tables (for example the
66             TCP port to dissector mappings) from the main window.
67           </para>
68         </listitem>
69
70         <listitem>
71           <para>
72             Wireshark can now export SMB objects.
73           </para>
74         </listitem>
75
76         <listitem>
77           <para>
78             dftest and randpkt now have manual pages.
79           </para>
80         </listitem>
81
82         <listitem>
83           <para>
84             TShark can now display iSCSI service response times.
85           </para>
86         </listitem>
87
88       </itemizedlist>
89
90     </para>
91     </section>
92
93     <section id="NewProtocols"><title>New Protocol Support</title>
94     <para>
95
96 ADwin,
97 ADwin-Config,
98 Apache Etch,
99 Aruba PAPI,
100 Constrained Application Protocol (COAP),
101 Digium TDMoE,
102 Ether-S-I/O,
103 FastCGI,
104 Fibre Channel over InfiniBand (FCoIB),
105 Gopher,
106 Gigamon GMHDR,
107 IDMP,
108 Infiniband Socket Direct Protocol (SDP),
109 JSON,
110 MikroTik MAC-Telnet,
111 Mongo Wire Protocol,
112 Network Monitor 802.11 radio header,
113 OPC UA ExtensionObjects,
114 PPI-GEOLOCATION-GPS,
115 ReLOAD,
116 ReLOAD Framing,
117 SAMETIME,
118 SCoP,
119 SGSAP,
120 Tektronix Teklink,
121 WAI authentication,
122 Wi-Fi P2P (Wi-Fi Direct)
123
124     </para>
125     </section>
126
127     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
128
129     </para>
130     </section>
131
132     <section id="NewCapture"><title>New and Updated Capture File Support</title>
133     <para>
134
135 IPFIX (the file format, not the protocol)
136
137     </para>
138     </section>
139
140   </section>
141
142   <section id="GettingWireshark"><title>Getting Wireshark</title>
143     <para>
144       Wireshark source code and installation packages are available from
145       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
146     </para>
147
148     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
149       <para>
150         Most Linux and Unix vendors supply their own Wireshark packages.
151         You can usually install or upgrade Wireshark using the package management
152         system specific to that platform.  A list of third-party packages
153         can be found on the
154         <ulink url="http://www.wireshark.org/download.html#thirdparty">download page</ulink>
155         on the Wireshark web site.
156       </para>
157     </section>
158
159   </section>
160
161   <!-- XXX needs to be written
162   <section id="RemovingWireshark"><title>Removing Wireshark</title>
163     <para>
164     </para>
165   </section>
166   -->
167
168   <section id="FileLocations"><title>File Locations</title>
169     <para>
170       Wireshark and TShark look in several different locations for
171       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
172       These locations vary from platform to platform.  You can use
173       About→Folders to find the default locations on your system.
174     </para>
175   </section>
176
177   <section id="KnownProblems"><title>Known Problems</title>
178
179     <para>
180       Wireshark might make your system disassociate from a wireless network
181       on OS X 10.4.
182       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
183       1315</ulink>)
184     </para>
185
186     <para>
187       Dumpcap might not quit if Wireshark or TShark crashes.
188       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
189       1419</ulink>)
190     </para>
191
192     <para>
193       The BER dissector might infinitely loop.
194       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
195       1516</ulink>)
196     </para>
197
198     <para>
199       Capture filters aren't applied when capturing from named pipes.
200       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
201       1814</ulink>)
202     </para>
203
204     <para>
205       Filtering tshark captures with display filters (-R) no longer works.
206       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
207       2234</ulink>)
208     </para>
209
210     <para>
211       The 64-bit Windows installer does not ship with libsmi.
212       (<ulink url="http://wiki.wireshark.org/Development/Win64">Win64
213       development page</ulink>)
214     </para>
215
216     <para>
217       Application crash when changing real-time option.
218       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4035">Bug
219       4035</ulink>)
220     </para>
221
222     <para>
223       Hex pane display issue after startup.
224       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4056">Bug
225       4056</ulink>)
226     </para>
227
228     <para>
229       Crash when sorting column while capturing.
230       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4273">Bug
231       4273</ulink>)
232     </para>
233
234     <para>
235       Packet list rows are oversized.
236       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4357">Bug
237       4357</ulink>)
238     </para>
239
240     <para>
241       Summary pane selected frame highlighting not maintained.
242       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4445">Bug
243       4445</ulink>)
244     </para>
245
246   </section>
247
248   <section id="GettingHelp"><title>Getting Help</title>
249     <para>
250     Community support is available on
251     <ulink url="http://ask.wireshark.org/">Wireshark's Q&amp;A site</ulink>
252     and on the wireshark-users mailing list.
253     Subscription information and archives for all of Wireshark's mailing
254     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
255     web site</ulink>.
256     </para>
257     <para>
258     Training is available from
259     <ulink url="http://www.wiresharktraining.com/">Wireshark University</ulink>.
260     </para>
261   </section>
262
263   <section id="FAQ"><title>Frequently Asked Questions</title>
264     <para>
265     A complete FAQ is available on the
266     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
267     </para>
268   </section>
269
270 </article>