r2752 - in trunk/BOOK: . basicnet/netutils introduction/welcome template

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sun Sep 26 08:12:41 PDT 2004


Author: randy
Date: 2004-09-26 09:12:40 -0600 (Sun, 26 Sep 2004)
New Revision: 2752

Added:
   trunk/BOOK/basicnet/netutils/ethereal.xml
Modified:
   trunk/BOOK/basicnet/netutils/netutils.xml
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/template/template.xml
Log:
Added new package Ethereal-0.10.6

Added: trunk/BOOK/basicnet/netutils/ethereal.xml
===================================================================
--- trunk/BOOK/basicnet/netutils/ethereal.xml	2004-09-25 01:52:30 UTC (rev 2751)
+++ trunk/BOOK/basicnet/netutils/ethereal.xml	2004-09-26 15:12:40 UTC (rev 2752)
@@ -0,0 +1,217 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY ethereal-download-http "http://www.ethereal.com/distribution/ethereal-&ethereal-version;.tar.bz2">
+  <!ENTITY ethereal-download-ftp  "ftp://ftp.ethereal.com/pub/ethereal/all-versions/ethereal-&ethereal-version;.tar.bz2">
+  <!ENTITY ethereal-md5sum        "722a2529c3a19b5b81c825bca444baea">
+  <!ENTITY ethereal-size          "5.0 MB">
+  <!ENTITY ethereal-buildsize     "172 MB">
+  <!ENTITY ethereal-time          "3.09 SBU">
+]>
+
+<sect1 id="ethereal" xreflabel="Ethereal-&ethereal-version;">
+<sect1info>
+<othername>$LastChangedBy$</othername>
+<date>$Date$</date>
+</sect1info>
+<?dbhtml filename="ethereal.html"?>
+<title>Ethereal-&ethereal-version;</title>
+
+<sect2>
+<title>Introduction to <application>Ethereal</application></title>
+
+<para>The <application>Ethereal</application> package contains a network 
+protocol analyzer, also known as a <quote>sniffer</quote>. This is useful for 
+analyzing data captured <quote>off the wire</quote> from a live network 
+connection, or data read from a capture file. 
+<application>Ethereal</application> provides both <acronym>GUI</acronym> and 
+<acronym>TTY</acronym>-mode programs for examining captured network packets 
+from over 500 protocols, as well as the capability to read capture files from 
+many other popular network analyzers.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing="compact">
+<listitem><para>Download (HTTP): 
+<ulink url="&ethereal-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): 
+<ulink url="&ethereal-download-ftp;"/></para></listitem>
+<listitem><para>MD5 Sum: &ethereal-md5sum;</para></listitem>
+<listitem><para>Download size: &ethereal-size;</para></listitem>
+<listitem><para>Estimated Disk space required: 
+&ethereal-buildsize;</para></listitem>
+<listitem><para>Estimated build time: 
+&ethereal-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>Ethereal</application> dependencies</title>
+<sect4><title>Recommended</title>
+<para><xref linkend="libpcap"/> (required to capture data)</para>
+</sect4>
+
+<sect4><title>Optional</title>
+<para><xref linkend="pkgconfig"/>, 
+<xref linkend="GTK"/> or <xref linkend="GTK2"/> (to build the 
+<acronym>GUI</acronym> front-end), 
+<xref linkend="GLib"/> or <xref linkend="GLib2"/> (to build the 
+<acronym>TTY</acronym>-mode front-end only), 
+<xref linkend="openssl"/>, 
+<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>, 
+<xref linkend="Python"/>, 
+<xref linkend="pcre"/>, 
+<ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>, 
+<ulink url="http://www.gnu.org/software/adns/adns.html">adns</ulink> and 
+<ulink url="http://www.stack.nl/~dimitri/doxygen/">doxygen</ulink></para>
+</sect4>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Installation of <application>Ethereal</application></title>
+
+<para>Install <application>Ethereal</application> by running the following 
+commands:</para>
+
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc \
+    --enable-randpkt --enable-threads &&
+make &&
+make install</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><option>--enable-randpkt</option>: Adding this parameter will 
+build the random capture program.</para>
+
+<para><option>--enable-threads</option>: Adding this parameter enables the use 
+of threads in <command>ethereal</command>.</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application>Ethereal</application></title>
+
+<sect3><title>Config files</title>
+<para><filename>/etc/ethereal.conf</filename> and 
+<filename>~/.ethereal/preferences</filename></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+<sect4><title>Package configuration</title>
+<para>Though the default configuration parameters are very sane, 
+reference the configuration section of the 
+<ulink url="http://www.ethereal.com/docs/user-guide/">Ethereal User's 
+Guide</ulink> for configuration information. Most of 
+<application>Ethereal</application>'s configuration can be accomplished 
+using the menu options of the <command>ethereal</command> 
+<acronym>GUI</acronym> interface.</para>
+</sect4>
+
+<sect4><title>Kernel configuration</title>
+<para>The kernel must have the Packet protocol enabled for 
+<application>Ethereal</application> to capture live packets from the network. 
+Enable the Packet protocol by choosing <quote>Y</quote> in the 
+<quote>Device Drivers</quote> – <quote>Networking support</quote> 
+– <quote>Networking options</quote> – <quote>Packet socket</quote> 
+configuration parameter. Alternatively, build the af_packet module by choosing 
+<quote>M</quote> in this parameter.</para>
+
+<para>If you plan on filtering captured packets (to eliminate them from being 
+captured), a substantial performance increase can be acheived by letting the 
+kernel do the filtering. Kernel filtering results in desired packets being 
+dropped before being handed to userspace programs. To enable kernel filtering, 
+you must enable the <quote>Network packet filtering</quote> and 
+<quote><acronym>IP</acronym> tables support</quote> options in the 
+<quote>Device Drivers</quote> – <quote>Networking support</quote> – 
+<quote>Network packet filtering</quote> section. In addition, you'll need to
+install and configure <xref linkend="postlfs-security-iptables"/>.</para>
+</sect4>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>Contents</title>
+
+<para>The <application>Ethereal</application> package contains 
+<command>capinfo</command>, 
+<command>dftest</command>, 
+<command>editcap</command>, 
+<command>ethereal</command>, 
+<command>idl2eth</command>, 
+<command>mergecap</command>, 
+<command>randpkt</command>, 
+<command>tethereal</command>, 
+<command>text2pcap</command>, 
+<filename class='libraryfile'>libethereal</filename>, 
+<filename class='libraryfile'>libwiretap</filename> and 
+many dissector plugin modules.</para>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<sect3><title>capinfo</title>
+<para><command>capinfo</command> reads a saved capture file and returns any or 
+all of several statistics about that file. It is able to detect and read any 
+capture supported by the <application>Ethereal</application> package.</para>
+</sect3>
+
+<sect3><title>dftest</title>
+<para><command>dftest</command> is a display-filter-compiler test 
+program.</para>
+</sect3>
+
+<sect3><title>editcap</title>
+<para><command>editcap</command> edits and/or translates the format of capture 
+files. It knows how to read <application>libpcap</application> capture files, 
+including those of <command>tcpdump</command>, 
+<application>Ethereal</application> and other tools that write captures in that 
+format.</para>
+</sect3>
+
+<sect3><title>ethereal</title>
+<para><command>ethereal</command> is a <acronym>GUI</acronym> network protocol 
+analyzer. It lets you interactively browse packet data from a live network or 
+from a previously saved capture file.</para>
+</sect3>
+
+<sect3><title>idl2eth</title>
+<para><command>idl2eth</command> takes a user specified 
+<acronym>CORBA</acronym> <acronym>IDL</acronym> file and generates 
+<quote>C</quote> source code that can be used to create an 
+<application>Ethereal</application> plugin.</para>
+</sect3>
+
+<sect3><title>mergecap</title>
+<para><command>mergecap</command> combines multiple saved capture files into a 
+single output file.</para>
+</sect3>
+
+<sect3><title>randpkt</title>
+<para><command>randpkt</command> creates random-packet capture files.</para>
+</sect3>
+
+<sect3><title>tethereal</title>
+<para><command>tethereal</command> is a <acronym>TTY</acronym>-mode network 
+protocol analyzer. It lets you capture packet data from a live network or
+read packets from a previously saved capture file.</para>
+</sect3>
+
+<sect3><title>text2pcap</title>
+<para><command>text2pcap</command> reads in an <acronym>ASCII</acronym> hex 
+dump and writes the data described into a 
+<application>libpcap</application>-style capture file.</para>
+</sect3>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/basicnet/netutils/ethereal.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/basicnet/netutils/netutils.xml
===================================================================
--- trunk/BOOK/basicnet/netutils/netutils.xml	2004-09-25 01:52:30 UTC (rev 2751)
+++ trunk/BOOK/basicnet/netutils/netutils.xml	2004-09-26 15:12:40 UTC (rev 2752)
@@ -16,5 +16,6 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nmap.xml"/>  
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="whois.xml"/>  
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bind-utils.xml"/>  
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ethereal.xml"/>  
 
 </chapter>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-09-25 01:52:30 UTC (rev 2751)
+++ trunk/BOOK/general.ent	2004-09-26 15:12:40 UTC (rev 2752)
@@ -1,4 +1,4 @@
-<!ENTITY day          "24">
+<!ENTITY day          "26">
 <!ENTITY month        "09">
 <!ENTITY year         "2004">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -180,6 +180,7 @@
 <!ENTITY nmap-version                 "3.70">  
 <!ENTITY whois-version                "4.6.21">
 <!ENTITY bind-version                 "9.2.3"> 
+<!ENTITY ethereal-version             "0.10.6"> 
                                   
 <!-- Chapter 20 -->               
 <!ENTITY nail-version                 "11.7"> 

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-09-25 01:52:30 UTC (rev 2751)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-09-26 15:12:40 UTC (rev 2752)
@@ -22,6 +22,9 @@
 
 <itemizedlist>
 
+<listitem><para>September 26th, 2004 [Randy]: Added new package 
+Ethereal-0.10.6.</para></listitem>
+
 <listitem><para>September 24th, 2004 [larry]: Updated to
 PCRE-5.0 and Postfix-2.1.5.</para></listitem>
 

Modified: trunk/BOOK/template/template.xml
===================================================================
--- trunk/BOOK/template/template.xml	2004-09-25 01:52:30 UTC (rev 2751)
+++ trunk/BOOK/template/template.xml	2004-09-26 15:12:40 UTC (rev 2752)
@@ -10,6 +10,7 @@
 
   <!ENTITY template-download-http "http://">
   <!ENTITY template-download-ftp  "ftp://">
+  <!ENTITY template-md5sum        "MD5 Sum">
   <!ENTITY template-size          "?? MB">
   <!ENTITY template-buildsize     "?? MB">
   <!ENTITY template-time          "?? SBU">
@@ -23,7 +24,6 @@
 <?dbhtml filename="template.html"?>
 <title>template-&template-version;</title>
 
-
 <sect2>
 <title>Introduction to <application>template</application></title>
 
@@ -33,6 +33,7 @@
 <itemizedlist spacing="compact">
 <listitem><para>Download (HTTP): <ulink url="&template-download-http;"/></para></listitem>
 <listitem><para>Download (FTP): <ulink url="&template-download-ftp;"/></para></listitem>
+<listitem><para>MD5 Sum: &template-md5sum;</para></listitem>
 <listitem><para>Download size: &template-size;</para></listitem>
 <listitem><para>Estimated Disk space required: &template-buildsize;</para></listitem>
 <listitem><para>Estimated build time: &template-time;</para></listitem></itemizedlist>
@@ -41,14 +42,18 @@
 <sect3><title>Additional downloads</title>
 <itemizedlist spacing="compact">
 <listitem><para>Required Patch: <ulink
-url="&patch-root;/template-&template-version;-patch_name-patch_version.patch"/></para></listitem>
-</itemizedlist></sect3>
+url="&patch-root;/template-&template-version;-patch_name-patch_version.patch"/></para>
+</listitem></itemizedlist>
+</sect3>
 
 <sect3><title><application>template</application> dependencies</title>
 <sect4><title>Required</title>
-<para>DEPENDENCE LIST</para></sect4>
+<para><xref linkend="BLFS DEPENDENCY"/></para>
+</sect4>
+
 <sect4><title>Optional</title>
-<para>OPTIONAL LIST</para></sect4>
+<para><ulink url="http://www.some.url/">EXTERNAL DEPENDENCY</ulink></para>
+</sect4>
 </sect3>
 
 </sect2>
@@ -56,9 +61,12 @@
 <sect2>
 <title>Installation of <application>template</application></title>
 
-<para>Install <application>template</application> by running the following commands:</para>
+<para>Install <application>template</application> by running the following 
+commands:</para>
 
-<screen><userinput><command>./configure </command></userinput></screen>
+<screen><userinput><command>./configure --prefix=/usr &&
+make &&
+make install</command></userinput></screen>
 
 </sect2>
 
@@ -91,8 +99,8 @@
 <sect2>
 <title>Contents</title>
 
-<para>The <application>template</application> package contains <command>
-LISTOFEXEC</command>, <filename>LISTOFFILES</filename>.</para>
+<para>The <application>template</application> package contains 
+<command>LISTOFEXEC</command>, <filename>LISTOFFILES</filename>.</para>
 
 </sect2>
 


Property changes on: trunk/BOOK/template/template.xml
___________________________________________________________________
Name: svn:keywords
   - Date LastChangedBy
   + LastChangedBy Date




More information about the blfs-book mailing list