Changeset 1065a91 for basicnet/netutils/ethereal.xml
- Timestamp:
- 05/30/2005 09:28:37 PM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 5e9a7236
- Parents:
- 17e6d48
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
basicnet/netutils/ethereal.xml
r17e6d48 r1065a91 30 30 <title>Introduction to Ethereal</title> 31 31 32 <para>The <application>Ethereal</application> package contains a network 33 protocol analyzer, also known as a <quote>sniffer</quote>. This is useful 34 for analyzing data captured <quote>off the wire</quote> from a live network 35 connection, or data read from a capture file. 36 <application>Ethereal</application> provides both GUI and TTY-mode programs 37 for examining captured network packets from over 500 protocols, as well as 38 the capability to read capture files from many other popular network 32 <para>The <application>Ethereal</application> package contains a network 33 protocol analyzer, also known as a <quote>sniffer</quote>. This is useful 34 for analyzing data captured <quote>off the wire</quote> from a live network 35 connection, or data read from a capture file. 36 <application>Ethereal</application> provides both GUI and TTY-mode programs 37 for examining captured network packets from over 500 protocols, as well as 38 the capability to read capture files from many other popular network 39 39 analyzers.</para> 40 40 … … 64 64 65 65 <bridgehead renderas="sect4">Required</bridgehead> 66 <para><xref linkend="GLib"/> or <xref linkend="glib2"/> (to build the 66 <para><xref linkend="GLib"/> or <xref linkend="glib2"/> (to build the 67 67 TTY-mode front-end only)</para> 68 68 … … 71 71 72 72 <bridgehead renderas="sect4">Optional</bridgehead> 73 <para><xref linkend="pkgconfig"/>, 74 <xref linkend="GTK"/> or <xref linkend="gtk2"/> (to build the 75 GUI front-end), 76 <xref linkend="openssl"/>, 77 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>, 78 <xref linkend="python"/>, 79 <xref linkend="pcre"/>, 80 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink> and 73 <para><xref linkend="pkgconfig"/>, 74 <xref linkend="GTK"/> or <xref linkend="gtk2"/> (to build the 75 GUI front-end), 76 <xref linkend="openssl"/>, 77 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>, 78 <xref linkend="python"/>, 79 <xref linkend="pcre"/>, 80 <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink> and 81 81 <ulink url="http://www.gnu.org/software/adns/adns.html">adns</ulink></para> 82 82 83 <bridgehead renderas="sect4">Optional (to build additional 83 <bridgehead renderas="sect4">Optional (to build additional 84 84 documentation)</bridgehead> 85 85 <para><xref linkend="doxygen"/>, 86 <xref linkend="libxml"/>, 86 <xref linkend="libxml"/>, 87 87 <xref linkend="libxslt"/>, 88 88 <xref linkend="fop"/></para> … … 93 93 <title>Kernel Configuration</title> 94 94 95 <para>The kernel must have the Packet protocol enabled for 96 <application>Ethereal</application> to capture live packets from the 97 network. Enable the Packet protocol by choosing <quote>Y</quote> in the 95 <para>The kernel must have the Packet protocol enabled for 96 <application>Ethereal</application> to capture live packets from the 97 network. Enable the Packet protocol by choosing <quote>Y</quote> in the 98 98 <quote>Device Drivers</quote> – <quote>Networking support</quote> 99 – <quote>Networking options</quote> – 100 <quote>Packet socket</quote> configuration parameter. Alternatively, 101 build the af_packet module by choosing <quote>M</quote> in this 99 – <quote>Networking options</quote> – 100 <quote>Packet socket</quote> configuration parameter. Alternatively, 101 build the af_packet module by choosing <quote>M</quote> in this 102 102 parameter.</para> 103 103 104 104 <indexterm zone="ethereal ethereal-kernel"> 105 <primary sortas="d-Capturing-network-packets">Capturing network 105 <primary sortas="d-Capturing-network-packets">Capturing network 106 106 packets</primary> 107 107 </indexterm> … … 112 112 <title>Installation of Ethereal</title> 113 113 114 <para>Install <application>Ethereal</application> by running the following 114 <para>Install <application>Ethereal</application> by running the following 115 115 commands:</para> 116 116 … … 138 138 <title>Command Explanations</title> 139 139 140 <para><parameter>--enable-randpkt</parameter>: This parameter builds the 140 <para><parameter>--enable-randpkt</parameter>: This parameter builds the 141 141 random capture program.</para> 142 142 143 <para><parameter>--enable-threads</parameter>: This parameter enables the 143 <para><parameter>--enable-threads</parameter>: This parameter enables the 144 144 use of threads in <command>ethereal</command>.</para> 145 145 146 <para><option>--with-ssl</option>: This parameter enables the use of the 146 <para><option>--with-ssl</option>: This parameter enables the use of the 147 147 <application>OpenSSL</application> 148 148 <filename class='libraryfile'>libcrypto</filename> library.</para> … … 156 156 <title>Config Files</title> 157 157 158 <para><filename>/etc/ethereal.conf</filename> and 158 <para><filename>/etc/ethereal.conf</filename> and 159 159 <filename>~/.ethereal/preferences</filename></para> 160 160 … … 172 172 <title>Configuration Information</title> 173 173 174 <para>Though the default configuration parameters are very sane, 175 reference the configuration section of the 176 <ulink url="http://www.ethereal.com/docs/user-guide/">Ethereal User's 177 Guide</ulink> for configuration information. Most of 178 <application>Ethereal</application>'s configuration can be accomplished 174 <para>Though the default configuration parameters are very sane, 175 reference the configuration section of the 176 <ulink url="http://www.ethereal.com/docs/user-guide/">Ethereal User's 177 Guide</ulink> for configuration information. Most of 178 <application>Ethereal</application>'s configuration can be accomplished 179 179 using the menu options of the <command>ethereal</command> 180 180 GUI interface.</para> 181 181 182 182 <note> 183 <para>If you want to look at packets, make sure you don't filter 184 them out with <xref linkend="iptables"/>. If you want to exclude 185 certain classes of packets, it is more efficient to do it with 186 <application>iptables</application> than 183 <para>If you want to look at packets, make sure you don't filter 184 them out with <xref linkend="iptables"/>. If you want to exclude 185 certain classes of packets, it is more efficient to do it with 186 <application>iptables</application> than 187 187 <application>Ethereal</application>.</para> 188 188 </note> … … 201 201 202 202 <seglistitem> 203 <seg>capinfos, dftest, editcap, ethereal, idl2eth, mergecap, randpkt, 203 <seg>capinfos, dftest, editcap, ethereal, idl2eth, mergecap, randpkt, 204 204 tethereal and text2pcap</seg> 205 <seg>libethereal.so, libwiretap.so and numerous dissector plugin 205 <seg>libethereal.so, libwiretap.so and numerous dissector plugin 206 206 modules</seg> 207 <seg>/usr/lib/ethereal, /usr/share/ethereal and 207 <seg>/usr/lib/ethereal, /usr/share/ethereal and 208 208 /usr/share/pixmaps/ethereal</seg> 209 209 </seglistitem> … … 218 218 <term><command>capinfos</command></term> 219 219 <listitem> 220 <para>reads a saved capture file and returns any or all of several 221 statistics about that file. It is able to detect and read any capture 220 <para>reads a saved capture file and returns any or all of several 221 statistics about that file. It is able to detect and read any capture 222 222 supported by the <application>Ethereal</application> package.</para> 223 223 <indexterm zone="ethereal capinfos"> … … 240 240 <term><command>editcap</command></term> 241 241 <listitem> 242 <para>edits and/or translates the format of capture files. It knows 243 how to read <application>libpcap</application> capture files, 244 including those of <command>tcpdump</command>, 245 <application>Ethereal</application> and other tools that write 242 <para>edits and/or translates the format of capture files. It knows 243 how to read <application>libpcap</application> capture files, 244 including those of <command>tcpdump</command>, 245 <application>Ethereal</application> and other tools that write 246 246 captures in that format.</para> 247 247 <indexterm zone="ethereal editcap"> … … 254 254 <term><command>ethereal</command></term> 255 255 <listitem> 256 <para>is a GUI network protocol analyzer. It lets you interactively 257 browse packet data from a live network or from a previously 256 <para>is a GUI network protocol analyzer. It lets you interactively 257 browse packet data from a live network or from a previously 258 258 saved capture file.</para> 259 259 <indexterm zone="ethereal ethereal-prog"> … … 266 266 <term><command>idl2eth</command></term> 267 267 <listitem> 268 <para>takes a user specified CORBA 269 IDL file and generates <quote>C</quote> source code that 268 <para>takes a user specified CORBA 269 IDL file and generates <quote>C</quote> source code that 270 270 can be used to create an <application>Ethereal</application> 271 271 plugin.</para> … … 279 279 <term><command>mergecap</command></term> 280 280 <listitem> 281 <para>combines multiple saved capture files into a single output 281 <para>combines multiple saved capture files into a single output 282 282 file.</para> 283 283 <indexterm zone="ethereal mergecap"> … … 300 300 <term><command>tethereal</command></term> 301 301 <listitem> 302 <para>is a TTY-mode network protocol analyzer. It lets you capture 303 packet data from a live network or read packets from a 302 <para>is a TTY-mode network protocol analyzer. It lets you capture 303 packet data from a live network or read packets from a 304 304 previously saved capture file.</para> 305 305 <indexterm zone="ethereal tethereal"> … … 312 312 <term><command>text2pcap</command></term> 313 313 <listitem> 314 <para>reads in an ASCII hex dump and writes the 315 data described into a <application>libpcap</application>-style 314 <para>reads in an ASCII hex dump and writes the 315 data described into a <application>libpcap</application>-style 316 316 capture file.</para> 317 317 <indexterm zone="ethereal text2pcap"> … … 324 324 <term><filename class='libraryfile'>libethereal.so</filename></term> 325 325 <listitem> 326 <para>contains functions used by the 327 <application>Ethereal</application> programs to perform filtering and 326 <para>contains functions used by the 327 <application>Ethereal</application> programs to perform filtering and 328 328 packet capturing.</para> 329 329 <indexterm zone="ethereal libethereal"> … … 336 336 <term><filename class='libraryfile'>libwiretap.so</filename></term> 337 337 <listitem> 338 <para>is a library being developed as a future replacement for 339 <filename class='libraryfile'>libpcap</filename>, the current 340 standard Unix library for packet capturing. For more information, 341 see the <filename>README</filename> file in the source 338 <para>is a library being developed as a future replacement for 339 <filename class='libraryfile'>libpcap</filename>, the current 340 standard Unix library for packet capturing. For more information, 341 see the <filename>README</filename> file in the source 342 342 <filename class='directory'>wiretap</filename> directory.</para> 343 343 <indexterm zone="ethereal libwiretap">
Note:
See TracChangeset
for help on using the changeset viewer.