docbook/ug-src/EUG_chapter_io.xml

   1 <!-- EUG Chapter IO -->
   2 <!-- $Id$ -->
   3
   4 <chapter id="ChapterIO">
   5   <title>File Input / Output and Printing</title>
   6
   7   <section id="ChIOIntroductionSection"><title>Introduction</title>
   8     <para>
   9         This chapter will describe input and output of capture data.
  10         <itemizedlist>
  11         <listitem>
  12           <para>
  13             Open/Import capture files in various capture file formats
  14           </para>
  15         </listitem>
  16         <listitem>
  17           <para>
  18             Save/Export capture files in various capture file formats
  19           </para>
  20         </listitem>
  21         <listitem>
  22           <para>
  23           Merge capture files together
  24           </para>
  25         </listitem>
  26         <listitem>
  27           <para>
  28             Print packets
  29           </para>
  30         </listitem>
  31       </itemizedlist>
  32     </para>
  33   </section>
  34
  35   <section id="ChIOOpenSection"><title>Open capture files</title>
  36     <para>
  37       Ethereal can read in previously saved capture files.
  38           To read them, simply select the <command>Open</command>
  39       menu item from the <command>File</command> menu.
  40       Ethereal will then pop up the File
  41       Open dialog box, which is discussed in more detail in
  42       <xref linkend="ChIOOpen"/>.
  43     </para>
  44         <note><title>Note!</title>
  45     <para>
  46         You can also use <command>drag-and-drop </command> to open a file, by
  47         simply dropping the desired file from your file manager onto Ethereal's
  48         main window. However, drag-and-drop is not available/won't work in all
  49         desktop environments.
  50     </para>
  51     </note>
  52     <para>
  53           If you didn't save the current capture file before, you will be asked
  54           to do so, to prevent data loss (this behaviour can be disabled in the
  55           preferences).
  56     </para>
  57     <para>
  58           In addition to its native file format (libpcap format, also used by
  59           tcpdump/WinDump and other libpcap/WinPcap-based programs), Ethereal can
  60           read capture files from a large number of other packet capture programs
  61           as well. See <xref linkend="ChIOInputFormatsSection"/> for the list of
  62           capture formats Ethereal understands.
  63     </para>
  64
  65     <section id="ChIOOpen"><title>The "Open Capture File" dialog box</title>
  66       <para>
  67         The "Open Capture File" dialog box allows you to search for a
  68         capture file containing previously captured packets for display in
  69         Ethereal.  <xref linkend="ChIOOpenFileDialog"/> shows an example
  70           of the Ethereal Open File Dialog box.
  71       </para>
  72             <note>
  73               <title>Note</title>
  74               <para>
  75                   Ethereal uses the open dialog box from the version of the GTK+
  76                   toolkit that it's using. This dialog was completely redesigned in
  77                   GTK version 2.4. Depending on the installed GTK version,
  78                   your dialog box might look different. However, as the
  79                   functionality remains almost the same, much of this description
  80                   will work with your version of Ethereal.
  81               </para>
  82             </note>
  83       <figure id="ChIOOpenFileDialog">
  84         <title>The "Open Capture File" Dialog box</title>
  85         <graphic entityref="EtherealOpen" format="PNG"/>
  86       </figure>
  87       <para>
  88         With this dialog box, you can perform the following actions:
  89         <orderedlist>
  90           <listitem>
  91             <para>
  92                 The "+ Add" button allows you to add a directory, selected in the
  93                 right-hand pane, to the favorites (bookmarks?) list. Those changes
  94                 are persistent.
  95             </para>
  96           </listitem>
  97           <listitem>
  98             <para>
  99                 The "- Remove" button allows you to remove a selected directory from
 100                 that list again (the items like: "Home", "Desktop", and "Filesystem"
 101                 cannot be removed).
 102             </para>
 103           </listitem>
 104           <listitem>
 105             <para>
 106               Select files and directories with the list boxes.
 107             </para>
 108           </listitem>
 109           <listitem>
 110             <para>
 111               View file preview information (like the filesize, the number of
 112                   packets, ...), while browsing the filesystem.
 113             </para>
 114           </listitem>
 115           <listitem>
 116             <para>
 117               Specify a display filter with the Filter button and filter
 118               field. This filter will be used when opening the new file.
 119                   Clicking on the Filter button causes Ethereal to pop up
 120               the Filters dialog box (which is discussed further in
 121               <xref linkend="ChWorkDisplayFilterSection"/>).
 122             </para>
 123           </listitem>
 124           <listitem>
 125             <para>
 126               Specify which name resolution is to be performed for all packets by
 127                   clicking on one of the "Enable name resolution" check buttons.
 128                   Details about name resolution can be found in
 129                   <xref linkend="ChAdvNameResolutionSection"/>.
 130             </para>
 131           </listitem>
 132           <listitem>
 133             <para>
 134               Click the Open button to accept your selected file and open it.
 135                   If Ethereal doesn't recognize the capture format, it will grey out
 136                   this button.
 137             </para>
 138           </listitem>
 139           <listitem>
 140             <para>
 141               Click the Cancel button to go back to Ethereal and not load a capture
 142               file.
 143             </para>
 144           </listitem>
 145         </orderedlist>
 146         You can change the display filter and name resolution settings later while
 147         viewing the packets. However, for very large capture files it can take a
 148         significant amount of time changing these settings, so it might be
 149         a good idea to set them in advance here.
 150       </para>
 151     </section>
 152
 153   <section id="ChIOInputFormatsSection">
 154     <title>Input File Formats</title>
 155     <para>
 156         The following file formats from other capture tools can be opened by
 157         <application>Ethereal</application>:
 158         <itemizedlist>
 159               <listitem><para>libpcap, tcpdump and various other tools using tcpdump's capture format</para></listitem>
 160               <listitem><para>Sun snoop and atmsnoop</para></listitem>
 161               <listitem><para>Shomiti/Finisar <emphasis>Surveyor</emphasis> captures</para></listitem>
 162               <listitem><para>Novell <emphasis>LANalyzer</emphasis> captures</para></listitem>
 163               <listitem><para>Microsoft Network Monitor captures</para></listitem>
 164               <listitem><para>AIX's iptrace captures</para></listitem>
 165               <listitem><para>Cinco Networks NetXray captures</para></listitem>
 166               <listitem><para>Network Associates Windows-based Sniffer and Sniffer Pro captures</para></listitem>
 167                   <listitem><para>Network General/Network Associates DOS-based Sniffer (compressed or uncompressed) captures</para></listitem>
 168               <listitem><para>AG Group/WildPackets EtherPeek/TokenPeek/AiroPeek/EtherHelp/PacketGrabber captures</para></listitem>
 169               <listitem><para>RADCOM's WAN/LAN Analyzer captures</para></listitem>
 170                   <listitem><para>Network Instruments Observer version 9 captures</para></listitem>
 171                   <listitem><para>Lucent/Ascend router debug output</para></listitem>
 172               <listitem><para>HP-UX's nettl</para></listitem>
 173               <listitem><para>Toshiba's ISDN routers dump output</para></listitem>
 174               <listitem><para>ISDN4BSD <emphasis>i4btrace</emphasis> utility</para></listitem>
 175                   <listitem><para>traces from the EyeSDN USB S0</para></listitem>
 176                   <listitem><para>IPLog format from the Cisco Secure Intrusion Detection System</para></listitem>
 177                   <listitem><para>pppd logs (pppdump format)</para></listitem>
 178                   <listitem><para>the output from VMS's TCPIPtrace/TCPtrace/UCX$TRACE utilities</para></listitem>
 179                   <listitem><para>the text output from the DBS Etherwatch VMS utility</para></listitem>
 180                   <listitem><para>Visual Networks' Visual UpTime traffic capture</para></listitem>
 181                   <listitem><para>the output from CoSine L2 debug</para></listitem>
 182                   <listitem><para>the output from Accellent's 5Views LAN agents</para></listitem>
 183                   <listitem><para>Endace Measurement Systems' ERF format captures</para></listitem>
 184                   <listitem><para>Linux Bluez Bluetooth stack hcidump -w traces</para></listitem>
 185         </itemizedlist>
 186     </para>
 187     <note><title>Note!</title>
 188         <para>
 189         It may not be possible to read some formats dependent on the packet types
 190         captured. Ethernet captures are usually supported for most file formats,
 191         but other packet types (e.g. token ring packets) may not be possible to
 192         read from all file formats.
 193         </para>
 194         </note>
 195
 196   </section>
 197
 198   </section>
 199
 200   <section id="ChIOSaveSection"><title>Saving captured packets</title>
 201     <para>
 202       You can save captured packets simply by using the Save As... menu
 203       item from the File menu under Ethereal. You can choose which
 204       packets to save and which file format to be used.
 205     </para>
 206     <section id="ChIOSaveAs">
 207       <title>The "Save Capture File As" dialog box</title>
 208       <para>
 209         The "Save Capture File As" dialog box allows you to save
 210         the current capture to a file.
 211         <xref linkend="ChIOSaveCaptureFileAs"/> shows an example of this
 212           dialog box.
 213       </para>
 214             <note>
 215               <title>Note</title>
 216               <para>
 217                   Ethereal uses the open dialog box from the version of the GTK+
 218                   toolkit that it's using. This dialog was completely redesigned in
 219                   the GTK version 2.4. Depending on the installed GTK version,
 220                   your dialog box might look different. However, as the
 221                   functionality remains almost the same, much of this description
 222                   will work with your version of Ethereal.
 223               </para>
 224             </note>
 225       <figure id="ChIOSaveCaptureFileAs">
 226         <title>The "Save Capture File As" dialog box</title>
 227         <graphic entityref="EtherealSaveAs" format="PNG"/>
 228       </figure>
 229       <para>
 230         With this dialog box, you can perform the following actions:
 231         <orderedlist>
 232           <listitem>
 233             <para>
 234               Type in the name of the file you wish to save the captured
 235               packets in, as a standard file name in your file system.
 236             </para>
 237           </listitem>
 238           <listitem>
 239             <para>
 240                 Select the directory to save the file into.
 241             </para>
 242           </listitem>
 243           <listitem>
 244             <para>
 245               Select the range of the packets to be saved, see
 246                   <xref linkend="ChIOPacketRangeSection"/>
 247             </para>
 248           </listitem>
 249           <listitem>
 250             <para>
 251               Specify the format of the saved capture file by clicking on
 252               the File type drop down box. You can choose from the
 253               types, described in <xref linkend="ChIOInputFormatsSection"/>.
 254                 </para>
 255             <note>
 256               <title>Note!</title>
 257               <para>
 258                 Some capture formats may not be available, depending on the
 259                 packet types captured.
 260               </para>
 261             </note>
 262             <tip>
 263               <title>Tip!</title>
 264               <para>
 265                 You can convert capture files from one format to another
 266                 by reading in a capture file and writing it out using a
 267                 different format.
 268               </para>
 269             </tip>
 270           </listitem>
 271           <listitem>
 272             <para>
 273               Use "Browse for other folders" to browse files and folders in your
 274                   file system.
 275             </para>
 276           </listitem>
 277           <listitem>
 278             <para>
 279               Click on the Save button to accept your selected file and save to
 280                   it. If Ethereal has a problem saving the captured packets to
 281               the file you specified, it will display an error dialog box.
 282               After clicking OK on this error dialog box, you can try again.
 283             </para>
 284           </listitem>
 285           <listitem>
 286             <para>
 287               Click on the Cancel button to go back to Ethereal and not save the
 288               captured packets.
 289             </para>
 290           </listitem>
 291         </orderedlist>
 292       </para>
 293     </section>
 294   <section id="ChIOOutputFormatsSection">
 295     <title>Output File Formats</title>
 296     <para>
 297         The following file formats can be saved by <application>Ethereal</application>,
 298         so other capture tools can read the capture data from:
 299         <itemizedlist>
 300               <listitem><para>libpcap (tcpdump)</para></listitem>
 301               <listitem><para>Novell LANalyzer</para></listitem>
 302               <listitem><para>Network Associates Sniffer</para></listitem>
 303               <listitem><para>Sun snoop</para></listitem>
 304               <listitem><para>Microsoft Network Monitor</para></listitem>
 305               <listitem><para>Visual Networks Visual UpTime traffic</para></listitem>
 306               <listitem><para>Accellent 5Views</para></listitem>
 307               <listitem><para>Networks Instruments Observer version 9</para></listitem>
 308         </itemizedlist>
 309     </para>
 310         <note><title></title>
 311         <para>
 312         Other protocol analyzers may require that the file has a certain suffix
 313         in order to read the files you generate with Ethereal, e.g.:
 314         </para>
 315         <para>
 316         ".DMP" for Tcpdump/libpcap
 317         </para>
 318         <para>
 319         ".CAP" for Network Assosciates Sniffer Windows
 320         </para>
 321         </note>
 322   </section>
 323   </section>
 324
 325   <section id="ChIOMergeSection"><title>Merging capture files</title>
 326         <para>
 327         Sometimes you need to merge several capture files into one. For example
 328         this can be useful, if you have captured simultaneously from multiple
 329         interfaces at once (e.g. using multiple instances of Ethereal).
 330         </para>
 331         <para>
 332         Merging capture files can be done in three ways:
 333         <itemizedlist>
 334                 <listitem><para>
 335                 Use the <command>menu item "Merge"</command> from the "File" menu,
 336                 to open the merge dialog, see <xref linkend="ChIOMergeDialog"/>.
 337                 This menu item will be disabled, until you have loaded a capture file.
 338                 </para></listitem>
 339                 <listitem><para>
 340                 Use <command>drag-and-drop</command> to drop multiple files on the
 341                 main window. Ethereal will try to merge the packets in chronological
 342                 order from the dropped files into a newly created temporary file. If
 343                 you drop only a single file, it will simply replace a (maybe) existing
 344                 one.
 345                 </para></listitem>
 346                 <listitem><para>
 347                 Use the <command>mergecap</command> tool, which is a command
 348                 line tool to merge capture files. This tool provides the most options
 349                 to merge capture files, see <xref linkend="AppToolsmergecap"/>.
 350                 </para></listitem>
 351         </itemizedlist>
 352         </para>
 353         <section><title>The "Merge with Capture File" dialog box</title>
 354         <para>
 355         This dialog box let you select a file to be merged into the currently
 356         loaded file.
 357         </para>
 358         <note><title>Note!</title>
 359         <para>If your current data wasn't saved before, you will be asked to save
 360         it first, before this dialog box is shown.</para>
 361         </note>
 362         <figure id="ChIOMergeDialog">
 363       <title>The "Merge with Capture File" dialog box</title>
 364       <graphic entityref="EtherealMergeDialog" format="PNG"/>
 365     </figure>
 366         <variablelist>
 367         <varlistentry>
 368           <term><command>Prepend packets to existing file</command></term>
 369           <listitem>
 370             <para>
 371                 Prepend the packets from the selected file before the currently loaded
 372                 packets.
 373             </para>
 374           </listitem>
 375         </varlistentry>
 376         <varlistentry>
 377           <term><command>Merge packets chronologically</command></term>
 378           <listitem>
 379             <para>
 380                 Merge both the packets from the selected and currently loaded file in
 381                 chronological order.
 382             </para>
 383           </listitem>
 384         </varlistentry>
 385         <varlistentry>
 386           <term><command>Append packets to existing file</command></term>
 387           <listitem>
 388             <para>
 389                 Append the packets from the selected file after the currently loaded
 390                 packets.
 391             </para>
 392           </listitem>
 393         </varlistentry>
 394         </variablelist>
 395         <para>
 396         All other controls will work the same way as in the "Open Capture File"
 397         dialog box, see <xref linkend="ChIOOpen"/>.
 398         </para>
 399         </section>
 400   </section>
 401
 402   <section id="ChIOExportSection"><title>Exporting data</title>
 403     <para>
 404       Ethereal provides several ways and formats to export packet data. This
 405           section describes general ways to export data from Ethereal.
 406     </para>
 407         <note><title>Note!</title>
 408         <para>
 409           There are more specialized functions to export specific data,
 410           which will be described at the appropriate places.
 411         </para>
 412         </note>
 413     <para>
 414           XXX - add detailed descriptions of the output formats and some sample
 415           output, too.
 416     </para>
 417         <section id="ChIOExportPlainDialog">
 418         <title>The "Export as Plain Text File" dialog box</title>
 419           <para id="ChIOExportPlain">
 420             Export packet data into a plain ASCII text file, much like the format
 421                 used to print packets.
 422     <figure>
 423       <title>The "Export as Plain Text File" dialog box</title>
 424       <graphic entityref="EtherealExportPlainDialog" format="PNG"/>
 425     </figure>
 426         <itemizedlist>
 427                 <listitem><para>
 428                 <command>Export to file:</command> frame chooses the file to export
 429                 the packet data to.
 430                 </para></listitem>
 431                 <listitem><para>
 432                 The <command>Packet Range</command> frame is described in <xref
 433                 linkend="ChIOPacketRangeSection"/>.
 434                 </para></listitem>
 435                 <listitem><para>
 436                 The <command>Packet Details</command> frame is described in <xref
 437                 linkend="ChIOPacketFormatSection"/>.
 438                 </para></listitem>
 439         </itemizedlist>
 440           </para>
 441     </section>
 442         <section id="ChIOExportPSDialog">
 443         <title>The "Export as PostScript File" dialog box</title>
 444           <para>
 445             Export packet data into PostScript, much like the format used
 446                 to print packets.
 447         <tip><title>Tip!</title>
 448         <para>
 449         You can easily convert PostScript files to PDF files using ghostscript.
 450         For example: export to a file named foo.ps and then call:
 451         <command>ps2pdf foo.ps</command>
 452         </para>
 453         </tip>
 454     <figure>
 455       <title>The "Export as PostScript File" dialog box</title>
 456       <graphic entityref="EtherealExportPSDialog" format="PNG"/>
 457     </figure>
 458         <itemizedlist>
 459                 <listitem><para>
 460                 <command>Export to file:</command> frame chooses the file to export
 461                 the packet data to.
 462                 </para></listitem>
 463                 <listitem><para>
 464                 The <command>Packet Range</command> frame is described in <xref
 465                 linkend="ChIOPacketRangeSection"/>.
 466                 </para></listitem>
 467                 <listitem><para>
 468                 The <command>Packet Details</command> frame is described in <xref
 469                 linkend="ChIOPacketFormatSection"/>.
 470                 </para></listitem>
 471         </itemizedlist>
 472           </para>
 473     </section>
 474         <section id="ChIOExportPSMLDialog">
 475         <title>The "Export as PSML File" dialog box</title>
 476           <para>
 477             Export packet data into PSML. This is an XML based format including
 478                 only the packet summary.
 479     <figure>
 480       <title>The "Export as PSML File" dialog box</title>
 481       <graphic entityref="EtherealExportPSMLDialog" format="PNG"/>
 482     </figure>
 483         <itemizedlist>
 484                 <listitem><para>
 485                 <command>Export to file:</command> frame chooses the file to export
 486                 the packet data to.
 487                 </para></listitem>
 488                 <listitem><para>
 489                 The <command>Packet Range</command> frame is described in <xref
 490                 linkend="ChIOPacketRangeSection"/>.
 491                 </para></listitem>
 492         </itemizedlist>
 493         There's no such thing as a packet details frame for PSML export, as the
 494         packet format is defined by the PSML specification.
 495           </para>
 496     </section>
 497         <section id="ChIOExportPDMLDialog">
 498         <title>The "Export as PDML File" dialog box</title>
 499           <para>
 500             Export packet data into PDML. This is an XML based format including
 501                 the packet details. The PDML file specification is available at:
 502                 <ulink url="http://analyzer.polito.it/30alpha/docs/dissectors/PDMLSpec.htm">
 503                 PDML specification</ulink>.
 504                 <note><title></title>
 505                 <para>
 506                 The PDML specification is not officially released and Ethereal's
 507                 implementation of it is still in an early beta state, so please expect
 508                 changes in future Ethereal versions.
 509                 </para>
 510                 </note>
 511     <figure>
 512       <title>The "Export as PDML File" dialog box</title>
 513       <graphic entityref="EtherealExportPDMLDialog" format="PNG"/>
 514     </figure>
 515         <itemizedlist>
 516                 <listitem><para>
 517                 <command>Export to file:</command> frame chooses the file to export
 518                 the packet data to.
 519                 </para></listitem>
 520                 <listitem><para>
 521                 The <command>Packet Range</command> frame is described in <xref
 522                 linkend="ChIOPacketRangeSection"/>.
 523                 </para></listitem>
 524         </itemizedlist>
 525         There's no such thing as a packet details frame for PDML export, as the
 526         packet format is defined by the PDML specification.
 527           </para>
 528   </section>
 529         <section id="ChIOExportSelectedDialog">
 530         <title>The "Export selected packet bytes" dialog box</title>
 531           <para>
 532             Export the bytes selected in the "Packet Bytes" pane into a raw
 533                 binary file.
 534     <figure>
 535       <title>The "Export Selected Packet Bytes" dialog box</title>
 536       <graphic entityref="EtherealExportSelectedDialog" format="PNG"/>
 537     </figure>
 538         <itemizedlist>
 539                 <listitem><para>
 540                 <command>Name:</command> the filename to export the packet data to.
 541                 </para></listitem>
 542                 <listitem><para>
 543                 The <command>Save in folder:</command> field lets you select the
 544                 folder to save to (from some predefined folders).
 545                 </para></listitem>
 546                 <listitem><para>
 547                 <command>Browse for other folders</command> provides a flexible
 548                 way to choose a folder.
 549                 </para></listitem>
 550         </itemizedlist>
 551           </para>
 552   </section>
 553   </section>
 554
 555   <section id="ChIOPrintSection"><title>Printing packets</title>
 556     <para>
 557             To print packets, select the "Print..." menu item from the File menu.
 558                 When you do this, Ethereal pops up the Print dialog box as shown in
 559             <xref linkend="ChIOPrintDialogBox"/>.
 560     </para>
 561         <section><title>The "Print" dialog box</title>
 562     <figure id="ChIOPrintDialogBox">
 563       <title>The "Print" dialog box</title>
 564       <graphic entityref="EtherealPrint" format="PNG"/>
 565     </figure>
 566     <para>
 567       The following fields are available in the Print dialog box:
 568       <variablelist>
 569         <varlistentry><term><command>Printer</command></term>
 570           <listitem>
 571             <para>
 572               This field contains a pair of mutually exclusive radio buttons:
 573               <itemizedlist>
 574                 <listitem>
 575                   <para>
 576                     <command>Plain Text</command> specifies that
 577                     the packet print should be in plain text.
 578                   </para>
 579                 </listitem>
 580                 <listitem>
 581                   <para>
 582                     <command>PostScipt</command> specifies that
 583                     the packet print process should use PostScript to
 584                     generate a better print output on PostScript aware printers.
 585                   </para>
 586                 </listitem>
 587                 <listitem>
 588                   <para>
 589                     <command>Output to file:</command> specifies that printing
 590                     be done to a file, which name is entered in the field or selected
 591                         using the browse button.
 592                   </para>
 593             <para>
 594               This field is where you enter the <command>file</command> to
 595               print to if you have selected Print to a file, or you can click the
 596                   button to browse the filesystem. It is greyed out if Print to a file
 597                   is not selected.
 598             </para>
 599                 </listitem>
 600                 <listitem>
 601                   <para>
 602                     <command>Print command</command> specifies that a
 603                     command be used for printing.
 604                   </para>
 605                 <note><title>Note!</title>
 606                 <para>
 607                 These <command>Print command</command> fields are not available on
 608                 windows platforms.
 609                 </para>
 610                 </note>
 611             <para>
 612               This field specifies the command to use for printing. It
 613               is typically <command>lpr</command>. You would change it
 614               to specify a particular queue if you need to print to a
 615               queue other than the default.  An example might be:
 616               <programlisting>
 617 lpr -Pmypostscript
 618               </programlisting>
 619               This field is greyed out if <command>Output to file:</command> is
 620               checked above.
 621             </para>
 622                 </listitem>
 623               </itemizedlist>
 624             </para>
 625           </listitem>
 626         </varlistentry>
 627         <varlistentry>
 628           <term><command>Packet Range</command></term>
 629           <listitem>
 630             <para>
 631                   Select the packets to be printed, see <xref
 632                   linkend="ChIOPacketRangeSection"/>
 633             </para>
 634           </listitem>
 635         </varlistentry>
 636         <varlistentry>
 637           <term><command>Packet Format</command></term>
 638           <listitem>
 639             <para>
 640                   Select the output format of the packets to be printed. You can
 641                   choose, how each packet is printed, see
 642                   <xref linkend="ChIOPacketFormatFrame"/>
 643             </para>
 644           </listitem>
 645         </varlistentry>
 646       </variablelist>
 647     </para>
 648   </section>
 649   </section>
 650
 651   <section id="ChIOPacketRangeSection"><title>The Packet Range frame</title>
 652         <para>
 653         The packet range frame is a part of various output related dialog boxes.
 654         It provides options to select which packets should be processed for the
 655         output function.
 656     <figure id="ChIOPacketRangeFrame">
 657       <title>The "Packet Range" frame</title>
 658       <graphic entityref="EtherealPacketRangeFrame" format="PNG"/>
 659     </figure>
 660         </para>
 661         <para>
 662         If the <command>Captured</command> button is set (default), all packets
 663         from the selected rule will be processed. If the <command>Displayed
 664         </command> button is set, only the currently displayed packets are taken
 665         into account to the selected rule.
 666         </para>
 667         <para>
 668         <itemizedlist>
 669                 <listitem>
 670                   <para>
 671                   <command>All packets</command> will process all packets.
 672                   </para>
 673                 </listitem>
 674                 <listitem>
 675                   <para>
 676                   <command>Selected packet only</command> process only the selected
 677                   packet.
 678                   </para>
 679                 </listitem>
 680                 <listitem>
 681                   <para>
 682                   <command>Marked packets only</command> process only the marked
 683                   packets.
 684                   </para>
 685                 </listitem>
 686                 <listitem>
 687                   <para>
 688                   <command>From first to last marked packet</command> process the
 689                   packets from the first to the last marked one.
 690                   </para>
 691                 </listitem>
 692                 <listitem>
 693                   <para>
 694                   <command>Specify a packet range</command> process a user specified
 695                   range of packets, e.g. specifying <command>5,10-15,20-</command> will
 696                   process the packet number five, the packets from packet number ten
 697                   to fifteen (inclusive) and every packet from number twenty to the
 698                   end of the capture.
 699                   </para>
 700                 </listitem>
 701         </itemizedlist>
 702         </para>
 703   </section>
 704
 705   <section id="ChIOPacketFormatSection"><title>The Packet Format frame</title>
 706         <para>
 707         The packet format frame is a part of various output related dialog boxes.
 708         It provides options to select which parts of a packet should be used for
 709         the output function.
 710     <figure id="ChIOPacketFormatFrame">
 711       <title>The "Packet Format" frame</title>
 712       <graphic entityref="EtherealPacketFormatFrame" format="PNG"/>
 713     </figure>
 714         <itemizedlist>
 715                 <listitem>
 716                   <para>
 717                   <command>Packet summary line</command> enable the output of the
 718                   summary line, just as in the "Packet List" pane.
 719                   </para>
 720                 </listitem>
 721                 <listitem>
 722                   <para>
 723                   <command>Packet details</command> enable the output of the packet
 724                   details tree.
 725                   </para>
 726                 <itemizedlist>
 727                 <listitem>
 728                   <para>
 729                   <command>All collapsed</command> the info from the "Packet Details"
 730                   pane in "all collapsed" state.
 731                   </para>
 732                 </listitem>
 733                 <listitem>
 734                   <para>
 735                   <command>As displayed</command> the info from the "Packet Details"
 736                   pane in the current state.
 737                   </para>
 738                 </listitem>
 739                 <listitem>
 740                   <para>
 741                   <command>All expanded</command> the info from the "Packet Details"
 742                   pane in "all expanded" state.
 743                   </para>
 744                 </listitem>
 745                 </itemizedlist>
 746                 </listitem>
 747                 <listitem>
 748                   <para>
 749                   <command>Packet bytes</command> enable the output of the packet
 750                   bytes, just as in the "Packet Bytes" pane.
 751                   </para>
 752                 </listitem>
 753                 <listitem>
 754                   <para>
 755                   <command>Each packet on a new page</command> put each packet on a
 756                   separate page (e.g. when saving/printing to a text file, this will
 757                   put a form feed character between the packets).
 758                   </para>
 759                 </listitem>
 760         </itemizedlist>
 761         </para>
 762   </section>
 763
 764 </chapter>
 765 <!-- End of EUG Chapter IO -->
 766