docbook/eug_src/EUG_chapter_customize.xml

   1 <!-- EUG Chapter Customizing -->
   2 <!-- $Id$ -->
   3
   4 <chapter id="ChapterCustomize">
   5   <title>Customizing Ethereal</title>
   6
   7   <section id="ChCustIntroduction"><title>Introduction</title>
   8     <para>
   9         Ethereal's default behaviour will usually suit your needs pretty well.
  10         However, as you become more familiar with Ethereal, it can be customized
  11         in various ways to suit your needs even better. In this chapter we explore:
  12         <itemizedlist>
  13         <listitem>
  14           <para>
  15             How to start Ethereal with command line parameters
  16           </para>
  17         </listitem>
  18         <listitem>
  19           <para>
  20             How to colorize the <application>Ethereal</application> display
  21           </para>
  22         </listitem>
  23         <listitem>
  24           <para>
  25             How to use the various preference settings
  26           </para>
  27         </listitem>
  28         </itemizedlist>
  29         </para>
  30   </section>
  31
  32   <section id="ChCustCommandLine"><title>Start Ethereal from the command line</title>
  33     <para>
  34       You can start <application>Ethereal</application> from the command
  35       line, but it can also be started from most Window managers
  36       as well. In this section we will look at starting it from the command
  37       line.
  38     </para>
  39     <para>
  40       <application>Ethereal</application> supports a large number of
  41       command line parameters. To see what they are, simply enter the
  42       command <command> ethereal -h</command> and the help information
  43       shown in <xref linkend="ChCustEx1"/> (or something similar) should be
  44           printed.
  45         <example id="ChCustEx1">
  46           <title>Help information available from Ethereal</title>
  47           <programlisting>
  48 This is GNU ethereal 0.10.5
  49 Compiled with GTK+ 2.4.3, with GLib 2.4.2, with WinPcap (version unknown),
  50 with libz 1.2.1, with libpcre 4.4, with Net-SNMP 5.1, with ADNS.
  51
  52 Running with WinPcap version 3.0 (packet.dll version 3, 1, 0, 20), based
  53 on libpcap version 0.8 on Windows XP Service Pack 1, build 2600.
  54
  55 ethereal [ -vh ] [ -klLnpQS ] [ -a &lt;capture autostop condition> ] ...
  56         [ -b &lt;number of ringbuffer files>[:&lt;duration>] ]
  57         [ -B &lt;byte view height> ] [ -c &lt;count> ] [ -f &lt;capture filter> ]
  58         [ -i &lt;interface> ] [ -m &lt;medium font> ] [ -N &lt;resolving> ]
  59         [ -o &lt;preference setting> ] ... [ -P &lt;packet list height> ]
  60         [ -r &lt;infile> ] [ -R &lt;read filter> ] [ -s &lt;snaplen> ]
  61         [ -t &lt;time stamp format> ] [ -T &lt;tree view height> ]
  62         [ -w &lt;savefile> ] [ -y &lt;link type> ] [ -z &lt;statistics string> ]
  63         [ &lt;infile> ]
  64           </programlisting>
  65         </example>
  66
  67         We will examine each of the command line options in turn.
  68     </para>
  69     <para>
  70       The first thing to notice is that issuing the command
  71       <command>ethereal</command> by itself will bring up
  72       <application>Ethereal</application>.
  73       However, you can include as many of the command line parameters as
  74       you like. Their meanings are as follows ( in alphabetical order ):
  75           XXX - is the alphabetical order a good choice? Maybe better task based?
  76       <variablelist>
  77           <varlistentry><term><command>-a &lt;capture autostop condition></command></term>
  78           <listitem>
  79                 <para>
  80         Specify a criterion that specifies when Ethereal is to stop writing
  81                 to a capture file. The criterion is of the form test:value, where test
  82                 is one of:
  83                 <variablelist>
  84                 <varlistentry><term><command>duration</command></term>
  85                         <listitem><para>
  86                         Stop writing to a capture file after value of seconds have elapsed.
  87                         </para></listitem>
  88                 </varlistentry>
  89                 <varlistentry><term><command>filesize</command></term>
  90                         <listitem><para>
  91                         Stop writing to a capture file after it reaches a size of value
  92                         kilobytes (where a kilobyte is 1000 bytes, not 1024 bytes).
  93                         </para></listitem>
  94                 </varlistentry>
  95                 </variablelist>
  96                 </para>
  97           </listitem>
  98         </varlistentry>
  99         <varlistentry><term><command>-b &lt;number of ringbuffer files></command></term>
 100           <listitem>
 101             <para>
 102                 If a maximum capture file size was specified, cause Ethereal to run
 103                 in "ring buffer" mode, with the specified number of files. In "ring
 104                 buffer" mode, Ethereal will write to several capture files. Their
 105                 name is based on the number of the file and on the creation date and
 106                 time.
 107             </para>
 108             <para>
 109                 When the first capture file fills up, Ethereal will switch to writing
 110                 to the next file, until it fills up the last file, at which point
 111                 it'll discard the data in the first file (unless 0 is specified, in
 112                 which case, the number of files is unlimited) and start writing to
 113                 that file and so on.
 114             </para>
 115             <para>
 116                 If the optional duration is specified, Ethereal will switch also to
 117                 the next file when the specified number of seconds has elapsed even
 118                 if the current file is not completely fills up.
 119             </para>
 120           </listitem>
 121         </varlistentry>
 122         <varlistentry><term><command>-B &lt;byte view height></command></term>
 123           <listitem>
 124             <para>
 125               This option sets the initial height of the "Packet Bytes" pane.
 126               This pane is usually the bottom pane in the Ethereal display.
 127             </para>
 128           </listitem>
 129         </varlistentry>
 130         <varlistentry><term><command>-c &lt;count></command></term>
 131           <listitem>
 132             <para>
 133               This option specifies the maximum number of packets to capture
 134               when capturing live data.  It would be used in conjunction
 135               with the <command>-k</command> option.
 136             </para>
 137           </listitem>
 138         </varlistentry>
 139         <varlistentry><term><command>-f &lt;capture filter></command></term>
 140           <listitem>
 141             <para>
 142               This option sets the initial capture filter expression to
 143               be used when capturing packets.
 144             </para>
 145           </listitem>
 146         </varlistentry>
 147         <varlistentry><term><command>-h</command></term>
 148           <listitem>
 149             <para>
 150               The <command>-h</command> option requests Ethereal to print
 151               its version and usage instructions (as shown above) and exit.
 152             </para>
 153           </listitem>
 154         </varlistentry>
 155         <varlistentry><term><command>-i &lt;interface></command></term>
 156           <listitem>
 157             <para>
 158               The <command>-i</command> option allows you to specify,
 159               from the command line, which interface packet capture should
 160               occur on if capturing packets.
 161             </para>
 162             <para>
 163               An example would be: <command>ethereal -i eth0</command>.
 164             </para>
 165             <para>
 166               To get a listing of all the interfaces you can capture on,
 167               use the command <command>ifconfig -a</command> or
 168               <command>netstat -i</command>. Unfortunately, some versions of
 169               UNIX do not support <command>ifconfig -a</command>, so you
 170               will have to use <command>netstat -i</command> in these cases.
 171             </para>
 172           </listitem>
 173         </varlistentry>
 174         <varlistentry><term><command>-k</command></term>
 175           <listitem>
 176             <para>
 177               The <command>-k</command> option specifies that Ethereal
 178               should start capturing packets immediately.  This option
 179               requires the use of the <command>-i</command> parameter to
 180               specify the interface that packet capture will occur from.
 181             </para>
 182           </listitem>
 183         </varlistentry>
 184         <varlistentry><term><command>-l</command></term>
 185           <listitem>
 186             <para>
 187               This option turns on automatic scrolling if the packet
 188               list pane is being updated automatically as packets arrive
 189               during a capture ( as specified by the <command>-S</command>
 190               flag).
 191             </para>
 192           </listitem>
 193         </varlistentry>
 194         <varlistentry><term><command>-L</command></term>
 195           <listitem>
 196             <para>
 197                   List the data link types supported by the interface and exit.
 198             </para>
 199           </listitem>
 200         </varlistentry>
 201         <varlistentry><term><command>-m &lt;medium font></command></term>
 202           <listitem>
 203             <para>
 204               This option sets the name of the font used for most text
 205               displayed by Ethereal. XXX - add an example!
 206             </para>
 207           </listitem>
 208         </varlistentry>
 209         <varlistentry><term><command>-n</command></term>
 210           <listitem>
 211             <para>
 212                 Disable network object name resolution (such as hostname, TCP and UDP
 213                 port names).
 214                 </para>
 215           </listitem>
 216         </varlistentry>
 217         <varlistentry><term><command>-N &lt;resolving&gt;</command></term>
 218           <listitem>
 219             <para>
 220               Turns on name resolving for particular types of addresses
 221               and port numbers; the argument is a string that may contain
 222               the letters <command>m</command> to enable MAC address
 223               resolution, <command>n</command> to enable network address
 224               resolution, and <command>t</command> to enable transport-layer
 225               port number resolution.  This overrides <command>-n</command>
 226               if both <command>-N</command> and <command>-n</command> are
 227               present. The letter C enables concurrent (asynchronous) DNS lookups.
 228             </para>
 229           </listitem>
 230         </varlistentry>
 231         <varlistentry>
 232           <term><command>-o &lt;preference settings&gt;</command></term>
 233           <listitem>
 234             <para>
 235               Sets a preference value, overriding the default value and
 236               any value read from a preference file.  The argument to the
 237               flag is a string of the form prefname:value, where prefname
 238               is the name of the preference (which is the same name that
 239               would appear in the preference file), and value is the value
 240               to which it should be set.  Multiple instances of
 241               <command>-o &lt;preference settings&gt; </command> can be
 242               given on a single command line.
 243             </para>
 244             <para>An example of setting a single preference would be: </para>
 245             <para>
 246               <command>
 247                 ethereal -o mgcp.display_dissect_tree:TRUE
 248               </command>
 249             </para>
 250             <para>
 251               An example of setting multiple preferences would be:
 252             </para>
 253             <para>
 254               <command>
 255                 ethereal -o mgcp.display_dissect_tree:TRUE -o mgcp.udp.callagent_port:2627
 256               </command>
 257             </para>
 258                 <tip><title>Tip!</title>
 259                 <para>
 260                 You can get a list of all available preference strings from the
 261                 preferences file, see <xref linkend="AppFiles"/>.
 262                 </para>
 263                 </tip>
 264           </listitem>
 265         </varlistentry>
 266         <varlistentry><term><command>-p</command></term>
 267           <listitem>
 268             <para>
 269               Don't put the interface into promiscuous mode.  Note that
 270               the interface might be in promiscuous mode for some other
 271               reason; hence, -p cannot be used to ensure that the only
 272               traffic that is captured is traffic sent to or from the
 273               machine on which Ethereal is running, broadcast traffic, and
 274               multicast traffic to addresses received by that machine.
 275             </para>
 276           </listitem>
 277         </varlistentry>
 278         <varlistentry>
 279           <term><command>-P &lt;packet list height></command></term>
 280           <listitem>
 281             <para>
 282               This option sets the initial height of the "Packet List" pane,
 283               ie, the top pane.
 284             </para>
 285           </listitem>
 286         </varlistentry>
 287         <varlistentry><term><command>-Q</command></term>
 288           <listitem>
 289             <para>
 290               This option forces Ethereal to exit when capturing is
 291               complete. It can be used with the <command>-c</command> option.
 292               It must be used in conjunction with the
 293               <command>-i</command> and <command>-w</command> options.
 294             </para>
 295           </listitem>
 296         </varlistentry>
 297         <varlistentry><term><command>-r &lt;infile></command></term>
 298           <listitem>
 299             <para>
 300               This option provides the name of a capture file for Ethereal
 301               to read and display. This capture file can be in one of the
 302               formats Ethereal understands.
 303             </para>
 304           </listitem>
 305         </varlistentry>
 306         <varlistentry><term><command>-R &lt;read filter></command></term>
 307           <listitem>
 308             <para>
 309               This option specifies a display filter to be applied when
 310               reading packets from a capture file. The syntax of this
 311               filter is that of the display filters discussed in
 312               <xref linkend="ChWorkDisplayFilterSection"/>.  Packets not
 313                   matching the filter are discarded.
 314             </para>
 315           </listitem>
 316         </varlistentry>
 317         <varlistentry><term><command>-s &lt;snaplen></command></term>
 318           <listitem>
 319             <para>
 320               This option specifies the snapshot length to use when
 321               capturing packets. Ethereal will only capture
 322               <command>&lt;snaplen></command> bytes of data for each packet.
 323             </para>
 324           </listitem>
 325         </varlistentry>
 326         <varlistentry><term><command>-S</command></term>
 327           <listitem>
 328             <para>
 329               This option specifies that Ethereal will display packets as
 330               it captures them. This is done by capturing in one process
 331               and displaying them in a separate process. This is the same
 332                   as "Update list of packets in real time" in the Capture Options
 333                   dialog box.
 334             </para>
 335           </listitem>
 336         </varlistentry>
 337         <varlistentry>
 338           <term><command>-t &lt;time stamp format></command></term>
 339           <listitem>
 340             <para>
 341               This option sets the format of packet timestamps that are
 342               displayed in the packet list window.  The format can be one of:
 343               <itemizedlist>
 344                 <listitem>
 345                   <para>
 346                     <command>r</command> relative, which specifies timestamps are
 347                     displayed relative to the first packet captured.
 348                   </para>
 349                 </listitem>
 350                 <listitem>
 351                   <para>
 352                     <command>a</command> absolute, which specifies that actual times
 353                         be displayed for all packets.
 354                   </para>
 355                 </listitem>
 356                 <listitem>
 357                   <para>
 358                     <command>ad</command> absolute with date, which specifies that
 359                         actual dates and times be displayed for all packets.
 360                   </para>
 361                 </listitem>
 362                 <listitem>
 363                   <para>
 364                     <command>d</command> delta, which specifies that timestamps
 365                     are relative to the previous packet.
 366                   </para>
 367                 </listitem>
 368               </itemizedlist>
 369             </para>
 370           </listitem>
 371         </varlistentry>
 372         <varlistentry>
 373           <term><command>-T &lt;tree view height></command></term>
 374           <listitem>
 375             <para>
 376               This option sets the initial height of the "Packet Details" pane.
 377             </para>
 378           </listitem>
 379         </varlistentry>
 380         <varlistentry><term><command>-v</command></term>
 381           <listitem>
 382             <para>
 383               The <command>-v</command> option requests
 384               Ethereal to print out its version information and exit.
 385             </para>
 386           </listitem>
 387         </varlistentry>
 388         <varlistentry><term><command>-w &lt;savefile></command></term>
 389           <listitem>
 390             <para>
 391               This option sets the name of the <command>savefile</command>
 392               to be used when saving a capture file.
 393             </para>
 394           </listitem>
 395         </varlistentry>
 396         <varlistentry><term><command>-y &lt;link type></command></term>
 397           <listitem>
 398             <para>
 399                 If a capture is started from the command line with -k, set the data
 400                 link type to use while capturing packets. The values reported by -L
 401                 are the values that can be used.
 402                 </para>
 403           </listitem>
 404         </varlistentry>
 405         <varlistentry><term><command>-z &lt;statistics-string></command></term>
 406           <listitem>
 407             <para>
 408                 Get Ethereal to collect various types of statistics and display the
 409                 result in a window that updates in semi-real time.
 410                 XXX - add more details here!
 411                 </para>
 412           </listitem>
 413         </varlistentry>
 414       </variablelist>
 415     </para>
 416   </section>
 417
 418   <section id="ChCustColorizationSection"><title>Packet colorization</title>
 419     <para>
 420       A very useful mechanism available in Ethereal is packet colorization.
 421       You can set Ethereal up so that it colorizes packets according to a
 422       filter. This allows you to emphasize the packets you are interested in.
 423     </para>
 424     <para>
 425       To colorize packets, select the Coloring Rules... menu item from
 426       the View menu, and Ethereal will pop up the "Coloring Rules"
 427       dialog box as shown in <xref linkend="ChCustColoringRulesDialog"/>.
 428     </para>
 429     <figure id="ChCustColoringRulesDialog">
 430       <title>The "Coloring Rules" dialog box</title>
 431       <graphic entityref="EtherealColoringRulesDialog" format="PNG"/>
 432     </figure>
 433     <para>
 434       Once the Coloring Rules dialog box is up, there are a number
 435       of buttons you can use, depending on whether or not you have any
 436       color filters installed already.
 437     </para>
 438     <note><title>Note!</title>
 439         <para>
 440       You will need to carefully select the order that rules are listed
 441       (and thus applied) as they are applied in order from top to bottom.
 442           So, more specific rules need to be listed before more general rules.
 443           For example, if you have a color rule for UDP before the one for DNS,
 444           the color rule for DNS will never be applied (as DNS uses UDP, so the
 445           UDP rule will be matching first).
 446         </para>
 447     </note>
 448     <para>
 449           If this is the first time you have used Coloring Rules, click on the New
 450           button which will bring up the Edit color filter dialog box as shown in
 451       <xref linkend="ChCustEditColorDialog"/>.
 452     </para>
 453     <figure id="ChCustEditColorDialog">
 454       <title>The "Edit Color Filter" dialog box</title>
 455       <graphic entityref="EtherealEditColorDialog" format="PNG"/>
 456     </figure>
 457     <para>
 458       In the Edit Color dialog box, simply enter a name for the color filter,
 459       and enter a filter string in the Filter text field.
 460       <xref linkend="ChCustEditColorDialog"/> shows the values
 461         <command>arp</command> and <command>arp</command> which means that
 462         the name of the color filter is <command>arp</command> and the filter
 463         will select protocols of type <command>arp</command>.  Once you have
 464         entered these values, you can choose a foreground and background
 465         color for packets that match the filter expression.  Click on
 466         <command>Foreground color...</command> or
 467         <command>Background color...</command> to achieve this and
 468         Ethereal will pop up the Choose foreground/background color for
 469         protocol dialog box as shown in
 470         <xref linkend="ChCustChooseColorDialog"/>.
 471     </para>
 472     <figure id="ChCustChooseColorDialog">
 473       <title>The "Choose color" dialog box</title>
 474       <graphic entityref="EtherealChooseColorDialog" format="PNG"/>
 475     </figure>
 476     <para>
 477       Select the color you desire for the selected packets and click on OK.
 478     </para>
 479     <note>
 480       <title>Note!</title>
 481       <para>
 482         You must select a color in the colorbar next to the colorwheel to
 483         load values into the RGB values. Alternatively, you can set the
 484         values to select the color you want.
 485       </para>
 486     </note>
 487     <para>
 488       <xref linkend="ChCustColorFilterMany"/> shows an example of several color
 489         filters being used in Ethereal. You may not like the color choices,
 490         however, feel free to choose your own.
 491     </para>
 492     <figure id="ChCustColorFilterMany">
 493       <title>Using color filters with Ethereal</title>
 494       <graphic entityref="EtherealThreePane1" format="PNG"/>
 495     </figure>
 496   </section>
 497
 498   <section id="ChCustProtocolDissectionSection">
 499         <title>Control Protocol dissection</title>
 500         <para>
 501                 There are some ways, to let the user control how protocols are
 502                 dissected.
 503         </para>
 504         <para>
 505                 Each protocol has its own dissector, so dissecting a packet will
 506                 typically involve several dissectors. As Ethereal tries to find the
 507                 right dissector for each packet (using static "routes" and heuristics
 508                 "guessing"), it might choose the wrong dissector in your specific
 509                 case. For example, Ethereal won't know if you use a common protocol
 510                 on an uncommon TCP port, e.g. using HTTP on TCP port 800 instead of
 511                 the standard port 80.
 512         </para>
 513         <para>
 514                 There are two ways to control the relations between protocol
 515                 dissectors: disable a protocol dissector completely or temporarily
 516                 divert the way Ethereal calls the dissectors.
 517         </para>
 518         <section id="ChAdvEnabledProtocols"><title>The "Enabled Protocols" dialog
 519         box</title>
 520         <para>
 521                 The Enabled Protocols dialog box lets you enable or
 522                 disable specific protocols, all protocols are enabled by default.
 523                 When a protocol is disabled, Ethereal stops processing a packet
 524                 whenever that protocol is encountered.
 525         </para>
 526         <note><title>Note!</title>
 527                 <para>
 528                 Disabling a protocol will prevent information about higher-layer
 529                 protocols from being displayed.  For example,
 530                 suppose you disabled the IP protocol and selected
 531                 a packet containing Ethernet, IP, TCP, and HTTP
 532                 information.  The Ethernet information would be
 533                 displayed, but the IP, TCP and HTTP information
 534                 would not - disabling IP would prevent it and
 535                 the other protocols from being displayed.
 536                 </para>
 537         </note>
 538     <figure id="ChAdvEnabledProtocolsFig">
 539       <title>The "Enabled Protocols" dialog box</title>
 540       <graphic entityref="EtherealEnabledProtocols" format="PNG"/>
 541     </figure>
 542         <para>
 543                 To disable or enable a protocol, simply click on it using the
 544                 mouse or press the space bar when the protocol is highlighted.
 545         </para>
 546         <warning><title>Warning!</title>
 547                 <para>
 548                 You have to use the Save button to save your settings. The OK or Apply
 549                 buttons will not save your changes, so they will be lost when Ethereal
 550                 is closed.
 551                 </para>
 552         </warning>
 553     <para>
 554       You can choose from the following actions:
 555       <orderedlist>
 556         <listitem>
 557           <para>
 558             <command>Enable All</command> Enable all protocols in the list.
 559           </para>
 560         </listitem>
 561         <listitem>
 562           <para>
 563             <command>Disable All</command> Disable all protocols in the list.
 564           </para>
 565         </listitem>
 566         <listitem>
 567           <para>
 568             <command>Invert</command> Toggle the state of all protocols in the
 569                 list.
 570           </para>
 571         </listitem>
 572         <listitem>
 573           <para>
 574             <command>OK</command> Apply the changes and close the dialog box.
 575           </para>
 576         </listitem>
 577         <listitem>
 578           <para>
 579             <command>Apply</command> Apply the changes and keep the dialog box
 580                 open.
 581           </para>
 582         </listitem>
 583         <listitem>
 584           <para>
 585             <command>Save</command> Save the settings to the disabled_protos, see
 586                 <xref linkend="AppFiles"/> for details.
 587           </para>
 588         </listitem>
 589         <listitem>
 590           <para>
 591             <command>Cancel</command> Cancel the changes and close the dialog box.
 592           </para>
 593         </listitem>
 594       </orderedlist>
 595     </para>
 596         </section>
 597
 598     <section id="ChAdvDecodeAs"><title>User Specified Decodes</title>
 599         <para>
 600                 The "Decode As" functionality let you temporarily divert specific
 601                 protocol dissections. This might be useful for example, if you do some
 602                 uncommon things on your network.
 603         </para>
 604     <para>
 605     <figure id="ChAdvDecodeAsFig">
 606       <title>The "Decode As" dialog box</title>
 607       <graphic scale="100" entityref="EtherealDecodeAs" format="PNG"/>
 608     </figure>
 609         The content of this dialog box depends on the selected packet when it
 610         was opened.
 611         <warning><title>Warning!</title>
 612                 <para>
 613                 The user specified decodes can not be saved. If you quit Ethereal,
 614                 these settings will be lost.
 615                 </para>
 616         </warning>
 617       <orderedlist>
 618         <listitem>
 619           <para>
 620             <command>Decode</command> Decode packets the selected way.
 621           </para>
 622         </listitem>
 623         <listitem>
 624           <para>
 625             <command>Do not decode</command> Do not decode packets the selected
 626                 way.
 627           </para>
 628         </listitem>
 629         <listitem>
 630           <para>
 631             <command>Link/Network/Transport</command> Specify the way to decode
 632                 packets. Which of these pages are available, depends on the content
 633                 of the selected packet when this dialog box was opened.
 634           </para>
 635         </listitem>
 636         <listitem>
 637           <para>
 638             <command>Show Current</command> Open a dialog box showing the
 639                 current list of user specified decodes.
 640           </para>
 641         </listitem>
 642         <listitem>
 643           <para>
 644             <command>OK</command> Apply the currently selected decode and close
 645                 the dialog box.
 646           </para>
 647         </listitem>
 648         <listitem>
 649           <para>
 650             <command>Apply</command> Apply the currently selected decode and keep
 651                 the dialog box open.
 652           </para>
 653         </listitem>
 654         <listitem>
 655           <para>
 656             <command>Cancel</command> Cancel the changes and close the dialog box.
 657           </para>
 658         </listitem>
 659       </orderedlist>
 660         </para>
 661         </section>
 662
 663     <section id="ChAdvDecodeAsShow"><title>Show User Specified Decodes</title>
 664     <para>
 665         This dialog box shows the currently active user specified decodes.
 666     <figure id="ChAdvDecodeAsShowFig">
 667       <title>The "Decode As: Show" dialog box</title>
 668       <graphic entityref="EtherealDecodeAsShow" format="PNG"/>
 669     </figure>
 670       <orderedlist>
 671         <listitem>
 672           <para>
 673             <command>OK</command> Close this dialog box.
 674           </para>
 675         </listitem>
 676         <listitem>
 677           <para>
 678             <command>Clear</command> Removes all user specified decodes.
 679           </para>
 680         </listitem>
 681       </orderedlist>
 682         </para>
 683   </section>
 684   </section>
 685
 686   <section id="ChCustPreferencesSection"><title>Preferences</title>
 687     <para>
 688       There are a number of preferences you can set. Simply
 689       select the Preferences... menu item from the Edit menu, and Ethereal
 690       will pop up the Preferences dialog box as shown in
 691       <xref linkend="ChCustGUIPrefPage"/>, with the "User Interface" page as
 692           default. On the left side is a tree where you can select the page to be
 693           shown. XXX - add detailed descriptions of all the preferences pages.
 694           <warning>
 695                 <title>Warning!</title>
 696                 <para>
 697                 The OK or Apply button will not save the preference settings,
 698                 you'll have to save the settings by clicking the Save button.
 699                 </para>
 700           </warning>
 701         <itemizedlist>
 702                 <listitem>
 703                   <para>
 704                         The <command>OK</command> button will apply the preferences
 705                         settings and close the dialog.
 706                   </para>
 707                 </listitem>
 708                 <listitem>
 709                   <para>
 710                         The <command>Apply</command> button will apply the preferences
 711                         settings and keep the dialog open.
 712                   </para>
 713                 </listitem>
 714                 <listitem>
 715                   <para>
 716                         The <command>Save</command> button will apply the preferences
 717                         settings, save the settings on the harddisk and keep the dialog open.
 718                   </para>
 719                 </listitem>
 720                 <listitem>
 721                   <para>
 722                         The <command>Cancel</command> button will restore all preferences
 723                         settings to the last saved state.
 724                   </para>
 725                 </listitem>
 726         </itemizedlist>
 727     </para>
 728         <section><title>The "User Interface" page</title>
 729     <figure id="ChCustGUIPrefPage">
 730       <title>The "User Interface" preferences page</title>
 731       <graphic entityref="EtherealGUIPreferences" format="PNG"/>
 732     </figure>
 733         <para>
 734               This page allows you to configure various characteristics
 735               of the GUI.
 736         </para>
 737         </section>
 738         <section><title>The "User Interface: Layout" page</title>
 739     <figure id="ChCustGUILayoutPrefPage">
 740       <title>The "User Interface: Layout" preferences page</title>
 741       <graphic entityref="EtherealGUILayoutPreferences" format="PNG"/>
 742     </figure>
 743         <para>
 744         This page selects the GUI layout of the main window.
 745         </para>
 746         </section>
 747         <section><title>The "User Interface: Columns" page</title>
 748         <para>
 749     <figure id="ChCustGUIColumnsPrefPage">
 750       <title>The "User Interface: Columns" preferences page</title>
 751       <graphic entityref="EtherealGUIColumnsPreferences" format="PNG"/>
 752     </figure>
 753               This page allows you to select which columns appear in the
 754               "Packet List" Pane.
 755             </para>
 756                 <note><title>Note!</title>
 757                 <para>
 758                 Unlike all other preference changes, you will have to save the
 759                 preferences and restart Ethereal in order for column changes to
 760                 take effect!
 761                 </para>
 762                 </note>
 763         </section>
 764
 765         <section><title>The "User Interface: Font" page</title>
 766         <para>
 767     <figure id="ChCustGUIFontPrefPage">
 768       <title>The "User Interface: Font" preferences page</title>
 769       <graphic entityref="EtherealGUIFontPreferences" format="PNG"/>
 770     </figure>
 771               This page allows you to select which font to use.
 772             </para>
 773         </section>
 774
 775         <section><title>The "User Interface: Colors" page</title>
 776         <para>
 777     <figure id="ChCustGUIColrsPrefPage">
 778       <title>The "User Interface: Colors" preferences page</title>
 779       <graphic entityref="EtherealGUIColorsPreferences" format="PNG"/>
 780     </figure>
 781               This page allows you to select which colors to use.
 782             </para>
 783         </section>
 784
 785         <section><title>The "Capture" page</title>
 786         <para>
 787     <figure id="ChCustCapturePrefPage">
 788       <title>The "Capture" preferences page</title>
 789       <graphic entityref="EtherealCapturePreferences" format="PNG"/>
 790     </figure>
 791               This page allows you to select some defaults for the capture options dialog.
 792             </para>
 793         </section>
 794
 795         <section><title>The "Printing" page</title>
 796         <para>
 797     <figure id="ChCustPrintingPrefPage">
 798       <title>The "Printing" preferences page</title>
 799       <graphic entityref="EtherealPrintingPreferences" format="PNG"/>
 800     </figure>
 801               This page allows you to select some defaults for the print dialog.
 802             </para>
 803         </section>
 804
 805         <section><title>The "Name Resolution" page</title>
 806         <para>
 807     <figure id="ChCustNameResolutionPrefPage">
 808       <title>The "Name Resolution" preferences page</title>
 809       <graphic entityref="EtherealNameResolutionPreferences" format="PNG"/>
 810     </figure>
 811               This page allows you to select some defaults for the name resolution.
 812             </para>
 813         </section>
 814
 815         <section id="ChCustProtocolsPrefPages"><title>The "Protocols" pages</title>
 816         <para>
 817         These pages allows you to select settings for various protocols.
 818         </para>
 819         </section>
 820   </section>
 821
 822 </chapter>
 823 <!-- End of EUG Chapter Customizing -->
 824