From Harald Welte:
[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.7.1">
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           .
40         </para></listitem>
41
42       </itemizedlist>
43
44     </para>
45
46     </section>
47
48     <section id="NewFeatures"><title>New and Updated Features</title>
49     <para>
50       The following features are new (or have been significantly updated)
51       since version 1.6:
52
53       <itemizedlist>
54
55         <listitem>
56           <para>
57             Wireshark supports capturing from multiple interfaces at once.
58           </para>
59         </listitem>
60
61         <listitem>
62           <para>
63             Wireshark, TShark, and their associated utilities now save files
64             using the pcap-ng file format by default. (Your copy of Wireshark
65             might still use the pcap file format if pcap-ng is disabled in
66             your preferences.)
67           </para>
68         </listitem>
69
70         <listitem>
71           <para>
72             Decryption key management for IEEE 802.11, IPsec, and ISAKMP
73             is easier.
74           </para>
75         </listitem>
76
77         <listitem>
78           <para>
79             OID resolution is now supported on 64-bit Windows.
80           </para>
81         </listitem>
82
83         <listitem>
84           <para>
85             When saving packets, the default choice is now to save
86             only the displayed packets rather than all packets.
87           </para>
88         </listitem>
89
90         <listitem>
91           <para>
92             TCP fast retransmissions are now indicated as an expert info note,
93             rather than a warning, just as TCP retransmissions are.
94           </para>
95         </listitem>
96
97         <listitem>
98           <para>
99             TCP window updates are no longer colorized as "Bad TCP".
100           </para>
101         </listitem>
102
103         <listitem>
104           <para>
105             TShark's command-line options have changed. The previously
106             undocumented -P option is now -2 option for performing a two-pass
107             analysis; the former -S option is now the -P option for printing
108             packets even if writing to a file, and the -S option is now used to
109             specify a different line separator between packets.
110           </para>
111         </listitem>
112
113         <listitem>
114           <para>
115             GeoIP IPv6 databases are now supported.
116           </para>
117         </listitem>
118
119       </itemizedlist>
120
121     </para>
122     </section>
123
124     <section id="NewProtocols"><title>New Protocol Support</title>
125     <para>
126
127 <!-- Sorted, one per line -->
128
129     </para>
130     </section>
131
132     <section id="UpdatedProtocols"><title>Updated Protocol Support</title> <para>
133
134     </para>
135     </section>
136
137     <section id="NewCapture"><title>New and Updated Capture File Support</title>
138     <para>
139
140 <!-- Sorted, one per line -->
141
142     </para>
143     </section>
144
145   </section>
146
147   <section id="GettingWireshark"><title>Getting Wireshark</title>
148     <para>
149       Wireshark source code and installation packages are available from
150       <ulink url="http://www.wireshark.org/download.html">http://www.wireshark.org/download.html</ulink>.
151     </para>
152
153     <section id="VendorPackages"><title>Vendor-supplied Packages</title>
154       <para>
155         Most Linux and Unix vendors supply their own Wireshark packages.
156         You can usually install or upgrade Wireshark using the package management
157         system specific to that platform.  A list of third-party packages
158         can be found on the
159         <ulink url="http://www.wireshark.org/download.html#thirdparty">download page</ulink>
160         on the Wireshark web site.
161       </para>
162     </section>
163
164   </section>
165
166   <!-- XXX needs to be written
167   <section id="RemovingWireshark"><title>Removing Wireshark</title>
168     <para>
169     </para>
170   </section>
171   -->
172
173   <section id="FileLocations"><title>File Locations</title>
174     <para>
175       Wireshark and TShark look in several different locations for
176       preference files, plugins, SNMP MIBS, and RADIUS dictionaries.
177       These locations vary from platform to platform.  You can use
178       About→Folders to find the default locations on your system.
179     </para>
180   </section>
181
182   <section id="KnownProblems"><title>Known Problems</title>
183
184     <para>
185       Wireshark might make your system disassociate from a wireless network
186       on OS X 10.4.
187       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1315">Bug
188       1315</ulink>)
189     </para>
190
191     <para>
192       Dumpcap might not quit if Wireshark or TShark crashes.
193       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1419">Bug
194       1419</ulink>)
195     </para>
196
197     <para>
198       The BER dissector might infinitely loop.
199       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1516">Bug
200       1516</ulink>)
201     </para>
202
203     <para>
204       Capture filters aren't applied when capturing from named pipes.
205       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1814">Bug
206       1814</ulink>)
207     </para>
208
209     <para>
210       Filtering tshark captures with display filters (-R) no longer works.
211       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=2234">Bug
212       2234</ulink>)
213     </para>
214
215     <para>
216       The 64-bit Windows installer does not support Kerberos decryption.
217       (<ulink url="http://wiki.wireshark.org/Development/Win64">Win64
218       development page</ulink>)
219     </para>
220
221     <para>
222       Application crash when changing real-time option.
223       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4035">Bug
224       4035</ulink>)
225     </para>
226
227     <para>
228       Hex pane display issue after startup.
229       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4056">Bug
230       4056</ulink>)
231     </para>
232
233     <para>
234       Packet list rows are oversized.
235       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4357">Bug
236       4357</ulink>)
237     </para>
238
239     <para>
240       Summary pane selected frame highlighting not maintained.
241       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=4445">Bug
242       4445</ulink>)
243     </para>
244
245     <para>
246       Wireshark and TShark will display incorrect delta times in some cases.
247       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">Bug
248       4985</ulink>
249       and
250       <ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">bug
251       5580</ulink>)
252     </para>
253
254     <para>
255       Character echo pauses in Capture Filter field in Capture Options.
256       (<ulink url="http://bugs.wireshark.org/bugzilla/show_bug.cgi?id=5356">Bug
257       5356</ulink>)
258     </para>
259
260   </section>
261
262   <section id="GettingHelp"><title>Getting Help</title>
263     <para>
264     Community support is available on
265     <ulink url="http://ask.wireshark.org/">Wireshark's Q&amp;A site</ulink>
266     and on the wireshark-users mailing list.
267     Subscription information and archives for all of Wireshark's mailing
268     lists can be found on <ulink url="http://www.wireshark.org/lists/">the
269     web site</ulink>.
270     </para>
271     <para>
272     Training is available from
273     <ulink url="http://www.wiresharktraining.com/">Wireshark University</ulink>.
274     </para>
275   </section>
276
277   <section id="FAQ"><title>Frequently Asked Questions</title>
278     <para>
279     A complete FAQ is available on the
280     <ulink url="http://www.wireshark.org/faq.html">Wireshark web site</ulink>.
281     </para>
282   </section>
283
284 </article>