diff options
author | ulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7> | 2004-09-11 07:16:24 +0000 |
---|---|---|
committer | ulfl <ulfl@f5534014-38df-0310-8fa8-9805f1628bb7> | 2004-09-11 07:16:24 +0000 |
commit | 2b4ed9b5de6bec89bd7d3dfe69a4e7b0366c99e1 (patch) | |
tree | 31ccfd8f69d7bb24efb1d086a1df46e33b346573 /docbook | |
parent | 003dc50bebe7876c6037a7c1b1b1ece72720b3c9 (diff) |
added a chapter "How Ethereal Works", with only little content right now...
git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@11962 f5534014-38df-0310-8fa8-9805f1628bb7
Diffstat (limited to 'docbook')
-rw-r--r-- | docbook/developer-guide.xml | 2 | ||||
-rw-r--r-- | docbook/dg-src/EDG_chapter_works.xml | 60 |
2 files changed, 62 insertions, 0 deletions
diff --git a/docbook/developer-guide.xml b/docbook/developer-guide.xml index 90b2416f18..9a8508181c 100644 --- a/docbook/developer-guide.xml +++ b/docbook/developer-guide.xml @@ -69,6 +69,7 @@ FILE SECTION <!ENTITY Sources SYSTEM "dg-src/EDG_chapter_sources.xml"> <!ENTITY BuildIntroduction SYSTEM "dg-src/EDG_chapter_build_intro.xml"> + <!ENTITY HowEtherealWorks SYSTEM "dg-src/EDG_chapter_works.xml"> <!ENTITY Dissection SYSTEM "dg-src/EDG_chapter_dissection.xml"> <!ENTITY UserInterface SYSTEM "dg-src/EDG_chapter_userinterface.xml"> @@ -128,6 +129,7 @@ to generate Ethereal, and how to do some typical development tasks. to change the sources (e.g. adding a new dissector).</command> </para> </partintro> +&HowEtherealWorks; &BuildIntroduction; &Dissection; &UserInterface; diff --git a/docbook/dg-src/EDG_chapter_works.xml b/docbook/dg-src/EDG_chapter_works.xml new file mode 100644 index 0000000000..3dac16c7c7 --- /dev/null +++ b/docbook/dg-src/EDG_chapter_works.xml @@ -0,0 +1,60 @@ +<!-- EDG Chapter Works -->
+<!-- $Id: EDG_chapter_works.xml 11908 2004-09-05 21:22:14Z ulfl $ -->
+
+<chapter id="ChapterWorks">
+ <title>How Ethereal Works</title>
+
+ <section id="ChWorksIntro">
+ <title>Introduction</title>
+ <para>
+ This chapter will give you a short overview, how Ethereal is working.
+ </para>
+
+ <section id="ChWorksCapturePackets">
+ <title>Capturing packets</title>
+ <para>
+ Capturing will take packets from a network adapter, and save them to a file
+ on your harddisk.
+ </para>
+ <para>
+ To hide all the lowlevel machine dependant details from
+ Ethereal, the libpcap/WinPcap (see <xref linkend="ChLibsPcap"/>) library
+ is used. This library provides a general purpose interface to capture
+ packets from a lot of different network interface types (Ethernet,
+ Token Ring, ...).
+ </para>
+ </section>
+
+ <section id="ChWorksCaptureFiles">
+ <title>Capture Files</title>
+ <para>
+ Ethereal can read and write capture files in it's natural file format, the
+ libpcap format, which is used by many other network capturing tools,
+ e.g. tcpdump. In addition to this, as one of it's strengths,
+ Ethereal can read/write files in many different file formats of other
+ network capturing tools. The wiretap library, developed together with
+ Ethereal, provides a general purpose interface to read/write all the file
+ formats. If you need to add another capture file format, this is the place
+ to start.
+ </para>
+ </section>
+
+ <section id="ChWorksDissectPackets">
+ <title>Dissect packets</title>
+ <para>
+ While Ethereal is loading packets from a file, each packet is dissected.
+ Ethereal tries to detect what kind of packet it is and getting as much
+ information from it as possible. In this run, only the information showed
+ in the packet list pane is needed though.
+ </para>
+ <para>
+ As the user selects a specific packet in the packet list pane, this packet
+ will be dissected again. This time, Ethereal tries to
+ get every single piece of information and put it into
+ the packet details pane then.
+ </para>
+ </section>
+
+ </section>
+</chapter>
+<!-- End of EUG Chapter Works -->
|