From John Bradshaw:
[metze/wireshark/wip.git] / docbook / wsug_src / WSUG_chapter_introduction.xml
1 <!-- WSUG Chapter Introduction -->
2 <!-- $Id$ -->
3
4 <chapter id="ChapterIntroduction">
5   <title>Introduction</title>
6   <!-- Introduction -->
7   <section id="ChIntroWhatIs">
8     <title>What is <application>Wireshark?</application></title>
9     <para>
10         Wireshark is a network packet analyzer. A network packet
11         analyzer will try to capture network packets and tries to display
12         that packet data as detailed as possible.
13     </para>
14     <para>
15         You could think of a network packet analyzer as a measuring device used to
16         examine what's going on inside a network cable, just like a voltmeter is
17         used by an electrician to examine what's going on inside an electric cable
18         (but at a higher level, of course).
19     </para>
20     <para>
21         In the past, such tools were either very expensive, proprietary, or both.
22         However, with the advent of Wireshark, all that has changed.
23     </para>
24     <para>
25         <application>Wireshark</application> is perhaps one of the best open
26         source packet analyzers available today.
27         </para>
28
29   <section id="ChIntroPurposes"><title>Some intended purposes</title>
30         <para>
31         Here are some examples people use Wireshark for:
32       <itemizedlist>
33         <listitem><para>
34           network administrators use it to <command>troubleshoot network
35            problems</command>
36         </para></listitem>
37         <listitem><para>
38           network security engineers use it to <command>examine security
39           problems</command>
40         </para></listitem>
41         <listitem><para>
42           developers use it to <command>debug protocol implementations</command>
43         </para></listitem>
44         <listitem><para>
45           people use it to <command>learn network protocol</command>
46           internals
47         </para></listitem>
48       </itemizedlist>
49           Beside these examples, Wireshark can be helpful in many other situations
50           too.
51         </para>
52   </section>
53
54   <section id="ChIntroFeatures"><title>Features</title>
55         <para>
56         The following are some of the many features Wireshark provides:
57       <itemizedlist>
58         <listitem>
59           <para>Available for <command>UNIX</command> and <command>Windows</command>.</para>
60         </listitem>
61         <listitem>
62           <para>
63             <command>Capture</command> live packet data from a network interface.
64           </para>
65         </listitem>
66         <listitem>
67           <para>
68             Display packets with <command>very detailed protocol information</command>.
69           </para>
70         </listitem>
71         <listitem>
72           <para>
73             <command>Open and Save</command> packet data captured.
74           </para>
75         </listitem>
76         <listitem>
77           <para>
78             <command>Import and Export</command> packet data from and to a lot of
79                 other capture programs.
80           </para>
81         </listitem>
82         <listitem>
83           <para><command>Filter packets</command> on many criteria.</para>
84         </listitem>
85         <listitem>
86           <para><command>Search</command> for packets on many criteria.</para>
87         </listitem>
88         <listitem>
89           <para><command>Colorize</command> packet display based on filters.</para>
90         </listitem>
91         <listitem>
92           <para>Create various <command>statistics</command>.</para>
93         </listitem>
94         <listitem>
95           <para>... and <command>a lot more!</command></para>
96         </listitem>
97       </itemizedlist>
98       However, to really appreciate its power, you have to start using it.
99     </para>
100     <para>
101       <xref linkend="ChIntroFig1"/> shows <application>Wireshark</application>
102         having captured some packets and waiting for you to examine
103         them.
104         <figure id="ChIntroFig1">
105           <title>
106             <application>Wireshark</application> captures packets and allows
107             you to examine their content.
108           </title>
109           <graphic entityref="WiresharkMain1" format="PNG"/>
110         </figure>
111     </para>
112         </section>
113
114         <section>
115         <title>Live capture from many different network media</title>
116         <para>
117           Wireshark can capture traffic from many different network media types
118           - and despite its name - including wireless LAN as well.
119           Which media types are supported, depends on many things like the
120           operating system you are using.
121           An overview of the supported media types can be found at:
122           <ulink url="&WiresharkMediaPage;"/>.
123         </para>
124         </section>
125
126     <section><title>Import files from many other capture programs</title>
127         <para>
128             Wireshark can open packets captured from a large number of
129                 other capture programs. For a list of input formats see
130                 <xref linkend="ChIOInputFormatsSection"/>.
131         </para>
132     </section>
133     <section><title>Export files for many other capture programs</title>
134         <para>
135             Wireshark can save packets captured in a large number of formats of
136                 other capture programs. For a list of output formats see
137                 <xref linkend="ChIOOutputFormatsSection"/>.
138         </para>
139     </section>
140
141         <section>
142         <title>Many protocol decoders</title>
143         <para>
144       There are protocol decoders (or dissectors, as they are
145       known in Wireshark) for a great many protocols:
146           see <xref linkend="AppProtocols"/>.
147         </para>
148         </section>
149
150         <section><title>Open Source Software</title>
151     <para>
152       Wireshark is an open source software project, and is released under
153       the <ulink url="&GPLWebsite;">GNU General Public License</ulink> (GPL).
154           You can freely use Wireshark on any number of computers you like, without
155           worrying about license keys or fees or such. In addition, all source
156           code is freely available under the GPL. Because of that, it is very easy
157           for people to add new protocols to Wireshark, either as plugins, or built
158           into the source, and they often do!
159     </para>
160         </section>
161
162     <section id="ChIntroNoFeatures"><title>What Wireshark is not</title>
163         <para>
164         Here are some things Wireshark does not provide:
165       <itemizedlist>
166         <listitem><para>
167           Wireshark isn't an intrusion detection system.  It will not warn you when
168           someone does strange things on your network that he/she isn't allowed to
169           do. However, if strange things happen, Wireshark might help you figure
170           out what is really going on.
171         </para></listitem>
172         <listitem><para>
173           Wireshark will not manipulate things on the network, it will only
174           "measure" things from it. Wireshark doesn't send packets on the network
175           or do other active things (except for name resolutions, but even
176           that can be disabled).
177         </para></listitem>
178       </itemizedlist>
179         </para>
180     </section>
181   </section>
182
183   <section id="ChIntroPlatforms">
184     <title>System Requirements</title>
185     <para>What you'll need to get Wireshark up and running ...</para>
186
187         <section><title>General Remarks</title>
188     <para>
189         <itemizedlist>
190         <listitem><para>The values below are the minimum requirements and only
191         "rules of thumb" for use on a moderately used network</para></listitem>
192         <listitem><para>Working with a busy network can easily produce huge
193         memory and disk space usage! For example: Capturing on a fully saturated
194         100MBit/s Ethernet will produce ~ 750MBytes/min! Having a fast processor,
195         lots of memory and disk space is a good idea in that case.</para></listitem>
196         <listitem><para>If Wireshark is running out of memory it crashes,
197         see: <ulink url="http://wiki.wireshark.org/KnownBugs/OutOfMemory"/>
198         for details and workarounds</para></listitem>
199         <listitem><para>Wireshark won't benefit much from Multiprocessor/Hyperthread
200         systems as time consuming tasks like filtering packets are single threaded.
201         No rule is without exception: during an "Update list of packets in real
202         time" capture, capturing traffic runs in one process and dissecting and
203         displaying packets runs in another process - which should benefit from two
204         processors.</para></listitem>
205         </itemizedlist>
206     </para>
207     </section>
208
209         <section><title>Microsoft Windows</title>
210     <para>
211         <itemizedlist>
212         <listitem><para>Windows XP Home, XP Pro, XP Tablet PC, XP Media
213         Center, Server 2003, Vista, 2008, 7, or 2008 R2
214         </para></listitem>
215         <listitem><para>Any modern 32-bit x86 or 64-bit AMD64/x86-64 processor.
216         </para></listitem>
217         <listitem><para>128MB available RAM. Larger capture files require more RAM.
218         </para></listitem>
219         <listitem><para>75MB available disk space. Capture files require additional disk space.
220         </para></listitem>
221         <listitem><para>800*600 (1280*1024 or higher recommended) resolution with
222         at least 65536 (16bit) colors (256 colors should work if Wireshark is
223         installed with the "legacy GTK1" selection of the Wireshark 1.0.x releases)
224         </para></listitem>
225         <listitem><para>A supported network card for capturing:
226         </para>
227         <itemizedlist>
228         <listitem><para>
229           Ethernet: Any card supported by Windows should work. See the wiki
230           pages on <ulink
231           url="http://wiki.wireshark.org/CaptureSetup/Ethernet">Ethernet
232           capture</ulink> and <ulink
233           url="http://wiki.wireshark.org/CaptureSetup/Offloading">offloading</ulink>
234           for issues that may affect your environment.
235         </para></listitem>
236         <listitem><para>
237           802.11: See the <ulink
238           url="http://wiki.wireshark.org/CaptureSetup/WLAN#head-02456742c655394c9e948a4c9a59d3441c92782f">Wireshark
239           wiki page</ulink>. Capturing raw 802.11 information may be difficult without special equipment.
240         </para></listitem>
241         <listitem><para>
242           Other media: See <ulink
243           url="http://wiki.wireshark.org/CaptureSetup/NetworkMedia"/>
244         </para></listitem>
245         </itemizedlist>
246         </listitem>
247         </itemizedlist>
248
249         Remarks:
250
251         <itemizedlist>
252         <listitem><para>
253           Many older Windows versions are no longer supported for three reasons:
254           None of the developers use those systems which makes support
255           difficult. The libraries Wireshark depends on (GTK, WinPcap, …) have
256           dropped support for older releases. Microsoft <ulink
257           url="http://support.microsoft.com/gp/lifeselect">has also dropped
258           support for these systems</ulink>.
259         </para></listitem>
260         <listitem><para>
261           Windows 95, 98 and ME are no longer supported. The "old technology"
262           releases of Windows lack memory protection (specifically <ulink
263           url="http://msdn.microsoft.com/en-us/library/aa366898.aspx">VirtualProtect</ulink>)
264           which we use to improve program safety and security. The last known
265           version to work was Ethereal 0.10.14 (which includes WinPcap 3.1). You
266           can get it from <ulink url="http://ethereal.com/download.html" />.
267           According to <ulink
268           url="https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=1130">this
269           bug report</ulink>, you may need to install Ethereal 0.10.0 on some
270           systems.
271         </para>
272         <para>
273           Microsoft retired support for Windows 98 and ME in 2006.
274         </para></listitem>
275         <listitem><para>
276           Windows NT 4.0 no longer works with Wireshark. The last known version
277           to work was Wireshark 0.99.4 (which includes WinPcap 3.1). You still
278           can get it from <ulink
279           url="http://www.wireshark.org/download/win32/all-versions/wireshark-setup-0.99.4.exe"
280           />.
281         </para>
282         <para>
283           Microsoft retired support for Windows NT 4.0 in 2004.
284         </para></listitem>
285         <listitem><para>
286           Windows 2000 no longer works with Wireshark. The last known version
287           to work was Wireshark 1.2.x (which includes WinPcap 4.1.2). You still
288           can get it from <ulink
289           url="http://www.wireshark.org/download/win32/all-versions/" />.
290         </para>
291         <para>
292           Microsoft retired support for Windows 2000 in 2010.
293         </para></listitem>
294         <listitem><para>
295           Windows CE and the embedded versions of Windows are not currently supported.
296         </para></listitem>
297         <listitem><para>
298           Multiple monitor setups are supported but may behave a bit
299           strangely.
300         </para></listitem>
301         </itemizedlist>
302     </para>
303         </section>
304
305         <section><title>Unix / Linux</title>
306     <para>
307       Wireshark currently runs on most UNIX platforms.
308           The system requirements should be comparable to the Windows values
309           listed above.
310     </para>
311     <para>
312       Binary packages are available for at least the following platforms:
313     </para>
314         <para>
315         <itemizedlist>
316         <listitem><para>Apple Mac OS X</para></listitem>
317         <listitem><para>Debian GNU/Linux</para></listitem>
318         <listitem><para>FreeBSD</para></listitem>
319         <listitem><para>Gentoo Linux</para></listitem>
320         <listitem><para>HP-UX</para></listitem>
321         <listitem><para>Mandriva Linux</para></listitem>
322         <listitem><para>NetBSD</para></listitem>
323         <listitem><para>OpenPKG</para></listitem>
324         <listitem><para>Red Hat Fedora/Enterprise Linux</para></listitem>
325         <listitem><para>rPath Linux</para></listitem>
326         <listitem><para>Sun Solaris/i386</para></listitem>
327         <listitem><para>Sun Solaris/Sparc</para></listitem>
328         <listitem><para>Canonical Ubuntu</para></listitem>
329         </itemizedlist>
330         </para>
331     <para>
332       If a binary package is not available for your platform, you should
333       download the source and try to build it.
334           Please report your experiences
335           to <ulink url="mailto:&WiresharkDevMailList;">&WiresharkDevMailList;
336           </ulink>.
337     </para>
338         </section>
339
340   </section>
341
342   <section id="ChIntroDownload">
343     <title>Where to get Wireshark?</title>
344     <para>
345       You can get the latest copy of the program from the Wireshark website:
346       <ulink url="&WiresharkDownloadPage;">&WiresharkDownloadPage;</ulink>.  The
347       website allows you to choose from among several mirrors for
348       downloading.
349     </para>
350     <para>
351         A new Wireshark version will typically become available every 4-8 months.
352     </para>
353     <para>
354         If you want to be notified about new Wireshark releases, you should
355         subscribe to the wireshark-announce mailing list. You will find more
356         details in <xref linkend="ChIntroMailingLists"/>.
357     </para>
358   </section>
359
360   <section id="ChIntroHistory">
361     <title>A brief history of Wireshark</title>
362     <para>
363       In late 1997, Gerald Combs needed a tool for tracking down
364       networking problems and wanted to learn more about networking, so
365       he started writing Ethereal (the former name of the Wireshark project)
366           as a way to solve both problems.
367     </para>
368     <para>
369       Ethereal was initially released, after several pauses in development,
370       in July 1998 as version 0.2.0.  Within days, patches, bug reports,
371       and words of encouragement started arriving, so Ethereal was on its
372       way to success.
373     </para>
374     <para>
375       Not long after that, Gilbert Ramirez saw its potential and contributed
376       a low-level dissector to it.
377     </para>
378     <para>
379       In October, 1998, Guy Harris of Network Appliance was looking for
380           something better than tcpview, so he started applying patches and
381           contributing dissectors to Ethereal.
382     </para>
383     <para>
384       In late 1998, Richard Sharpe, who was giving TCP/IP courses, saw its
385       potential on such courses, and started looking at it to see if it
386       supported the protocols he needed. While it didn't at that point,
387       new protocols could be easily added.  So he started contributing
388       dissectors and contributing patches.
389     </para>
390     <para>
391       The list of people who have contributed to the project has become very
392       long since then, and almost all of them started with a protocol that they
393       needed that Wireshark or Ethereal did not already handle. So they copied
394       an existing dissector and contributed the code back to the team.
395     </para>
396     <para>
397       In 2006 the project moved house and re-emerged under a new name: Wireshark.
398     </para>
399     <para>
400       In 2008, after ten years of development, Wireshark finally arrived at
401       version 1.0. This release was the first deemed complete, with the minimum
402       features implemented. Its release coincided with the first Wireshark
403       Developer and User Conference, called SharkFest.
404     </para>
405   </section>
406
407   <section id="ChIntroMaintenance">
408     <title>
409       Development and maintenance of <application>Wireshark</application>
410     </title>
411     <para>
412       Wireshark was initially developed by Gerald Combs. Ongoing development
413       and maintenance of Wireshark is handled by the Wireshark team, a loose
414       group of individuals who fix bugs and provide new functionality.
415     </para>
416     <para>
417       There have also been a large number of people who have contributed
418       protocol dissectors to Wireshark, and it is expected that this will
419       continue.  You can find a list of the people who have contributed
420       code to Wireshark by checking the about dialog box of Wireshark, or at
421           the <ulink url="&WiresharkAuthorsPage;">authors</ulink> page on the
422       Wireshark web site.
423     </para>
424     <para>
425       Wireshark is an open source software project, and is released under
426       the <ulink url="&GPLWebsite;">GNU General Public License</ulink> (GPL).
427           All source code is freely available under the GPL.  You are welcome to
428       modify Wireshark to suit your own needs, and it would be appreciated
429       if you contribute your improvements back to the Wireshark team.
430     </para>
431     <para>
432       You gain three benefits by contributing your improvements back to the
433       community:
434       <itemizedlist>
435         <listitem>
436           <para>
437             Other people who find your contributions useful will appreciate
438             them, and you will know that you have helped people in the
439             same way that the developers of Wireshark have helped people.
440           </para>
441         </listitem>
442         <listitem>
443           <para>
444             The developers of Wireshark might improve your changes even more,
445                 as there's always room for improvement. Or they may implement some
446                 advanced things on top of your code, which can be useful for yourself
447                 too.
448           </para>
449         </listitem>
450         <listitem>
451           <para>
452             The maintainers and developers of Wireshark will maintain your
453             code as well, fixing it when API changes or other changes are
454             made, and generally keeping it in tune with what is happening
455             with Wireshark. So if Wireshark is updated (which is done often),
456                 you can get a new Wireshark version from the website and your changes
457                 will already be included without any effort for you.
458           </para>
459         </listitem>
460       </itemizedlist>
461     </para>
462     <para>
463       The Wireshark source code and binary kits for some platforms are all
464       available on the download page of the Wireshark website:
465       <ulink url="&WiresharkDownloadPage;">&WiresharkDownloadPage;</ulink>.
466     </para>
467   </section>
468
469   <section id="ChIntroHelp">
470     <title>Reporting problems and getting help</title>
471         <para>
472       If you have problems, or need help with Wireshark, there are several
473       places that may be of interest to you (well, besides this guide of
474           course).
475         </para>
476
477         <section id="ChIntroHomepage"><title>Website</title>
478     <para>
479         You will find lots of useful information on the Wireshark homepage at
480         <ulink url="&WiresharkWebSite;">&WiresharkWebSite;</ulink>.
481         </para>
482         </section>
483
484         <section id="ChIntroWiki"><title>Wiki</title>
485     <para>
486         The Wireshark Wiki at <ulink
487         url="&WiresharkWikiPage;">&WiresharkWikiPage;</ulink> provides a wide range
488         of information related to Wireshark and packet capturing in general.
489         You will find a lot of information not part of this user's guide. For
490         example, there is an explanation how to capture on a switched network,
491         an ongoing effort to build a protocol reference and a lot more.
492         </para>
493         <para>
494         And best of all, if you would like to contribute your knowledge on a
495         specific topic (maybe a network protocol you know well), you can edit the
496         wiki pages by simply using your web browser.
497         </para>
498         </section>
499
500         <section id="ChIntroQA"><title>Q&amp;A Forum</title>
501         <para>
502         The Wireshark Q and A forum at
503         <ulink url="&WiresharkQASite;">&WiresharkQASite;</ulink> offers a resource
504         where questions and answers come together. You have the option to search
505         what questions were asked before and what answers were given by people who
506         knew about the issue. Answers are graded, so you can pick out the best ones
507         easily. If your issue isn't discussed before you can post one yourself.
508         </para>
509         </section>
510
511         <section id="ChIntroFAQ"><title>FAQ</title>
512     <para>
513         The "Frequently Asked Questions" will list often asked questions and
514         the corresponding answers.
515         <note><title>Read the FAQ!</title>
516         <para>
517         Before sending any mail to the mailing lists below, be sure to read the
518         FAQ, as it will often answer the question(s) you might have. This will save
519         yourself and others a lot of time (keep in mind that a lot of people are
520         subscribed to the mailing lists).
521     </para>
522     </note>
523         You will find the FAQ inside Wireshark by clicking the menu item
524         Help/Contents and selecting the FAQ page in the dialog shown.
525     </para>
526     <para>
527         An online version is available at the Wireshark website:
528         <ulink url="&WiresharkFAQPage;">&WiresharkFAQPage;</ulink>. You might
529         prefer this online version, as it's typically more up to date and the HTML
530         format is easier to use.
531     </para>
532         </section>
533
534         <section id="ChIntroMailingLists"><title>Mailing Lists</title>
535     <para>
536       There are several mailing lists of specific Wireshark topics available:
537       <variablelist>
538         <varlistentry><term><command>wireshark-announce</command></term>
539           <listitem>
540             <para>
541               This mailing list will inform you about new program
542                   releases, which usually appear about every 4-8 weeks.
543             </para>
544           </listitem>
545         </varlistentry>
546         <varlistentry><term><command>wireshark-users</command></term>
547           <listitem>
548             <para>
549               This list is for users of Wireshark.  People post
550               questions about building and using Wireshark, others (hopefully)
551                   provide answers.
552             </para>
553           </listitem>
554         </varlistentry>
555         <varlistentry><term><command>wireshark-dev</command></term>
556           <listitem>
557             <para>
558               This list is for Wireshark developers. If you want to start
559               developing a protocol dissector, join this list.
560             </para>
561           </listitem>
562         </varlistentry>
563       </variablelist>
564       You can subscribe to each of these lists from the Wireshark web site:
565       <ulink url="&WiresharkWebSite;">&WiresharkWebSite;</ulink>.  Simply
566       select the <command>mailing lists</command> link on the left hand
567       side of the site. The lists are archived at the Wireshark web site
568       as well.
569         <tip><title>Tip!</title>
570         <para>
571         You can search in the list archives to see if someone asked the same
572         question some time before and maybe already got an answer. That way you
573         don't have to wait until someone answers your question.
574         </para>
575         </tip>
576     </para>
577         </section>
578
579         <section><title>Reporting Problems</title>
580         <note><title>Note!</title>
581         <para>
582         Before reporting any problems, please make sure you have installed the
583         latest version of Wireshark.
584         </para>
585         </note>
586     <para>
587       When reporting problems with Wireshark, it is helpful if you supply the
588       following information:
589       <orderedlist>
590         <listitem>
591           <para>
592             The version number of Wireshark and the dependent libraries linked with
593             it, e.g. GTK+, etc. You can obtain this from the about dialog box
594             of Wireshark, or with the command <command>wireshark -v</command>.
595           </para>
596         </listitem>
597         <listitem>
598           <para>
599             Information about the platform you run Wireshark on.
600           </para>
601         </listitem>
602         <listitem>
603           <para>
604             A detailed description of your problem.
605           </para>
606         </listitem>
607         <listitem>
608           <para>
609                 If you get an error/warning message, copy the text of that message
610                 (and also a few lines before and after it, if there are some), so
611                 others may find the place where things go wrong. Please don't
612                 give something like: "I get a warning while doing x" as this won't
613                 give a good idea where to look at.
614           </para>
615         </listitem>
616       </orderedlist>
617     </para>
618         <note><title>Don't send large files!</title>
619         <para>
620         Do not send large files (>100KB) to the mailing lists, just place a note
621         that further data is available on request. Large files will only annoy a
622         lot of people on the list who are not interested in your specific problem.
623         If required, you will be asked for further data by the persons who really
624         can help you.
625         </para>
626         </note>
627         <warning><title>Don't send confidential information!</title>
628         <para>
629         If you send captured data to the mailing lists, be sure they don't contain
630         any sensitive or confidential information like passwords or such.
631         </para>
632         </warning>
633   </section>
634
635         <section><title>Reporting Crashes on UNIX/Linux platforms</title>
636     <para>
637       When reporting crashes with Wireshark, it is helpful if you supply the
638       traceback information (besides the information mentioned in "Reporting
639           Problems").
640     </para>
641           <para>
642             You can obtain this traceback information with the following commands:
643             <programlisting>
644 <![CDATA[
645 $ gdb `whereis wireshark | cut -f2 -d: | cut -d' ' -f2` core >& bt.txt
646 backtrace
647 ^D
648 $
649 ]]>
650                 </programlisting>
651             <note>
652               <para>
653                 Type the characters in the first line verbatim! Those are
654                 back-tics there!
655               </para>
656             </note>
657             <note>
658               <para>
659                 backtrace is a <command>gdb</command> command. You should
660                 enter it verbatim after the first line shown above, but it will not be
661                 echoed. The ^D
662                 (Control-D, that is, press the Control key and the D key
663                 together) will cause <command>gdb</command> to exit. This will
664                 leave you with a file called
665                 <filename>bt.txt</filename> in the current directory.
666                 Include the file with your bug report.
667               </para>
668             </note>
669             <note>
670               <para>
671                 If you do not have <command>gdb</command> available, you
672                 will have to check out your operating system's debugger.
673               </para>
674             </note>
675           </para>
676           <para>
677             You should mail the traceback to the
678                 <ulink url="mailto:&WiresharkDevMailList;">&WiresharkDevMailList;</ulink>
679             mailing list.
680           </para>
681   </section>
682
683         <section><title>Reporting Crashes on Windows platforms</title>
684     <para>
685         The Windows distributions don't contain the symbol files (.pdb), because
686         they are very large. For this reason it's not possible to create
687         a meaningful backtrace file from it. You should report your crash just
688         like other problems, using the mechanism described above.
689     </para>
690   </section>
691   </section>
692
693 </chapter>
694 <!-- End of WSUG Chapter 1 -->