Removed (with "svn rm", not commented out, because commenting out conflicts

with restructuring of the book) WvDial, WvStreams, and RP-PPPoE.

Restructured the book so that the "Connecting to a Network" part became a
chapter in the "Basic Networking" part.



git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7288 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Alexander E. Patrakov 2008-03-18 15:49:58 +00:00
parent 3b03fd4470
commit a3244038ee
18 changed files with 64 additions and 988 deletions

View File

@ -16,6 +16,7 @@ $Date$
<title>Basic Networking</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="connect/connect.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="netlibs/netlibs.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="textweb/textweb.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="netprogs/netprogs.xml"/>

View File

@ -0,0 +1,38 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<!--
$LastChangedBy$
$Date$
-->
<chapter id="basicnet-connect">
<?dbhtml filename="connect.html"?>
<title>Connecting to a Network</title>
<para>The LFS book covers setting up networking by connecting to a LAN
with a static IP address. There are other methods used to obtain an IP
address and connect to a LAN and other networks (such as the Internet).
The most popular methods (DHCP and PPP) are covered in this chapter.</para>
<para>DHCP stands for Dynamic Host Configuration Protocol. It is a protocol
used by many sites to automatically provide information such as IP addresses,
subnet masks and routing information to computers. If your network uses
DHCP, you will need a DHCP client in order to connect to it.</para>
<para>PPP stands for Potint-to-Point Protocol. It is data link protocol
commonly used for establishing an authenticated IP connections over
a phone line with a modem, or over radio waves with a cellular phone. There
is also a variant (PPPoE) that works over Ethernet and is used by cable
providers to authenticate the Internet connections.</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcpcd.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp-client.xml"/>
</chapter>

View File

@ -157,10 +157,11 @@ instal -m644 scripts/pon.1 /usr/share/man/man1</userinput></screen>
configuration. The main trick is scripting the connection.
For dialup and GPRS connections, this can be done
either using the <command>chat</command> program which comes with
this package, or by using external tools such as <xref linkend="wvdial"/>
this package, or by using external tools such as
<ulink url="http://alumnit.ca/wiki/?WvDial">WvDial</ulink>
or <application>KPPP</application> from
<xref linkend="kdenetwork"/>. The text below explains how to set up
PPPoE, dialup and GPRS connections using only tools provided with
dialup and GPRS and PPPoE connections using only tools provided with
the <application>PPP</application> package. All configuration steps
in this section are executed as
<systemitem class="username">root</systemitem> user.</para>
@ -383,7 +384,7 @@ usepeerdns</literal>
<para>In order to configure a PPPoE connection, only the peer file
has to be created:</para>
<screen role="root"><userinput>cat &gt;/etc/ppp/peers/adsl &lt;&lt;"EOF"</userinput>
<screen role="root"><userinput>cat &gt;/etc/ppp/peers/<replaceable>adsl</replaceable> &lt;&lt;"EOF"</userinput>
<literal>plugin rp-pppoe.so
# Ethernet interface name
<replaceable>eth0</replaceable>

View File

@ -22,7 +22,6 @@ $Date$
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="curl.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvstreams.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gnet.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libsoup.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libpcap.xml"/>

View File

@ -1,322 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY wvstreams-download-http "http://open.nit.ca/download/wvstreams-&wvstreams-version;.tar.gz">
<!ENTITY wvstreams-download-ftp " ">
<!ENTITY wvstreams-md5sum "103230cb9926cb8f3f4d8dc8584f3b9c">
<!ENTITY wvstreams-size "1.2 MB">
<!ENTITY wvstreams-buildsize "46 MB (additional 44 MB to install documentation)">
<!ENTITY wvstreams-time "0.8 SBU (additional 1.9 SBU to build documentation)">
]>
<sect1 id="wvstreams" xreflabel="WvStreams-&wvstreams-version;">
<?dbhtml filename="wvstreams.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>WvStreams-&wvstreams-version;</title>
<indexterm zone="wvstreams">
<primary sortas="a-WvStreams">WvStreams</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to WvStreams</title>
<para><application>WvStreams</application> is a library suite containing
platform-independent C++ networking and utilities libraries for rapid
application development.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Download (HTTP): <ulink url="&wvstreams-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&wvstreams-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &wvstreams-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &wvstreams-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &wvstreams-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &wvstreams-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">WvStreams Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="openssl"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pkgconfig"/>,
<xref linkend="gamin"/>,
<!-- <xref linkend="db"/>, -->
<xref linkend="linux-pam"/>,
<xref linkend="tcl"/>,
<xref linkend="qt"/>,
<xref linkend="speex"/>,
<xref linkend="libvorbis"/>,
<xref linkend="doxygen"/>,
<ulink url="http://www.fftw.org/">FFTW-2.<replaceable>&lt;X&gt;</replaceable></ulink>,
<ulink url="http://www.swig.org">SWIG</ulink>,
<ulink url="http://qdbm.sourceforge.net/">QDBM</ulink>,
<ulink url="http://www.openslp.org/">OpenSLP</ulink>,
<ulink url="http://xplc.sourceforge.net/">XPLC</ulink>,
<ulink url="http://valgrind.kde.org/">Valgrind</ulink>, and
<ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/wvstreams"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of WvStreams</title>
<para>If you have <application>Tcl</application> and
<application>SWIG</application> installed and wish to utilize them, run the
following:</para>
<screen><userinput>sed -i -e "s/8_3/8_4/" -e "s/8\.3/8.4/" \
configure{,.ac} include/wvautoconf.h.in bindings/rules.mk</userinput></screen>
<para>Install <application>WvStreams</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc --localstatedir=/var &amp;&amp;
make</userinput></screen>
<para>If <application>Doxygen</application> is installed and you wish to build
the API documentation, issue the following command:</para>
<screen><userinput>make doxygen</userinput></screen>
<para>To test the results, issue: <command>make test</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role='root'><userinput>make install</userinput></screen>
<para>If you built the API documentation, install it using the following commands:</para>
<screen role='root'><userinput>install -v -d -m755 /usr/share/doc/wvstreams-&wvstreams-version;/doxy-html &amp;&amp;
install -v -m644 Docs/doxy-html/* \
/usr/share/doc/wvstreams-&wvstreams-version;/doxy-html</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i ...</command>: Change to tcl8.4 from tcl8.3.</para>
<para><parameter>--sysconfdir=/etc</parameter>: This parameter places
configuration files in <filename class='directory'>/etc</filename> instead of
<filename class='directory'>/usr/etc</filename>.</para>
<para><parameter>--localstatedir=/var</parameter>: This parameter places
<command>uniconfd</command> run-time files in
<filename class='directory'>/var/lib</filename> instead of
<filename class='directory'>/usr/var/lib</filename>.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring WvStreams</title>
<sect3 id="wvstreams-config">
<title>Config Files</title>
<para><filename>/etc/uniconf.conf</filename></para>
<indexterm zone="wvstreams wvstreams-config">
<primary sortas="e-etc-uniconf.conf">/etc/uniconf.conf</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/lib-config.xml"/>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>uni and uniconfd</seg>
<seg>libuniconf.{so,a}, libwvbase.{so,a}, libwvfft.{so,a},
libwvoggspeex.{so,a}, libwvoggvorbis.{so,a}, libwvqt.{so,a},
libwvstreams.{so,a}, libwvtelephony.{so,a}, libwvutils.{so,a} and
libxplc-cxx.a</seg>
<seg>/usr/include/wvstreams, /usr/share/doc/wvstreams-&wvstreams-version; and
/var/lib/uniconf</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="uni">
<term><command>uni</command></term>
<listitem>
<para>is a program to interface with the UniConf configuration system.</para>
<indexterm zone="wvstreams uni">
<primary sortas="b-uni">uni</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uniconfd">
<term><command>uniconfd</command></term>
<listitem>
<para>is a daemon program for the UniConf configuration system.</para>
<indexterm zone="wvstreams uniconfd">
<primary sortas="b-uniconfd">uniconfd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libuniconf">
<term><filename class='libraryfile'>libuniconf.{so,a}</filename></term>
<listitem>
<para>contains functions that define a hierarchical registry
abstraction in the UniConf configuration system.</para>
<indexterm zone="wvstreams libuniconf">
<primary sortas="c-libuniconf">libuniconf.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvbase">
<term><filename class='libraryfile'>libwvbase.{so,a}</filename></term>
<listitem>
<para>contains the Base64 encoder and decoder implementations functions.</para>
<indexterm zone="wvstreams libwvbase">
<primary sortas="c-libwvbase">libwvbase.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvfft">
<term><filename class='libraryfile'>libwvfft.{so,a}</filename></term>
<listitem>
<para>enables <application>WvStreams</application> programs to
easily handle Fast-Fourier transforms, instead of forcing the programmer to
use the much harder to use <filename class="libraryfile">libfftw</filename>
interface.</para>
<indexterm zone="wvstreams libwvfft">
<primary sortas="c-libwvfft">libwvfft.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvoggspeex">
<term><filename class='libraryfile'>libwvoggspeex.{so,a}</filename></term>
<listitem>
<para>enables quick and painless creation of audio streams using
the <application>Speex</application> Voice over
IP CODEC.</para>
<indexterm zone="wvstreams libwvoggspeex">
<primary sortas="c-libwvoggspeex">libwvoggspeex.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvoggvorbis">
<term><filename class='libraryfile'>libwvoggvorbis.{so,a}</filename></term>
<listitem>
<para>enables quick and painless creation of audio streams using
the OggVorbis CODEC.</para>
<indexterm zone="wvstreams libwvoggvorbis">
<primary sortas="c-libwvoggvorbis">libwvoggvorbis.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvqt">
<term><filename class='libraryfile'>libwvqt.{so,a}</filename></term>
<listitem>
<para>enables <application>WvStreams</application> to act as the
I/O and configuration back end for <application>Qt</application> and
<application>KDE</application>.</para>
<indexterm zone="wvstreams libwvqt">
<primary sortas="c-libwvqt">libwvqt.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvstreams">
<term><filename class='libraryfile'>libwvstreams.{so,a}</filename></term>
<listitem>
<para>provides functions for basic streaming I/O support.</para>
<indexterm zone="wvstreams libwvstreams">
<primary sortas="c-libwvstreams">libwvstreams.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libtelephony">
<term><filename class='libraryfile'>libtelephony.{so,a}</filename></term>
<listitem>
<para>contains telephony function routines such as echo
cancellation, dc offset removal, automatic gain control, etc.</para>
<indexterm zone="wvstreams libtelephony">
<primary sortas="c-libtelephony">libtelephony.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwvutils">
<term><filename class='libraryfile'>libwvutils.{so,a}</filename></term>
<listitem>
<para>contains functions required by the
<application>WvStreams</application> libraries and utility programs.</para>
<indexterm zone="wvstreams libwvutils">
<primary sortas="c-libwvutils">libwvutils.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libxplc-cxx">
<term><filename class='libraryfile'>libxplc-cxx.a</filename></term>
<listitem>
<para>contains helper functions for the C++
<application>WvStreams</application> bindings.</para>
<indexterm zone="wvstreams libxplc-cxx">
<primary sortas="c-libxplc-cxx">libxplc-cxx.a</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -1,29 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<!--
$LastChangedBy$
$Date$
-->
<part id="connect" xreflabel="Connecting to a Network">
<?dbhtml filename="connect.html" dir="connect"?>
<title>Connecting to a Network</title>
<partintro>
<para>The LFS book covers setting up networking by connecting to a LAN
with a static IP address. There are other methods used to connect to
a LAN and other networks (such as the Internet). The most popular methods
are covered in this chapter.</para>
</partintro>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dialup/dialup.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp/dhcp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/>
</part>

View File

@ -1,35 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<!--
$LastChangedBy$
$Date$
-->
<chapter id="connect-dhcp">
<?dbhtml filename="dhcp.html"?>
<title>DHCP Clients</title>
<para>DHCP stands for Dynamic Host Configuration Protocol. It is a protocol
used by many sites to automatically provide information such as IP addresses,
subnet masks and routing information to computers. If your network uses
DHCP, you will need a DHCP client in order to connect to it.
DHCP is also used by some cable modems.</para>
<para>BLFS currently provides installation instructions for
two DHCP clients, <command>dhclient</command> (from the
<application>dhcp</application> package) and <command>dhcpcd</command>.
BLFS presents both sets of installation instructions and
discusses how to create an appropriate service script to work with the
<command>network</command> bootscript and the DHCP
client of your choice.</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp-client.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcpcd.xml"/>
</chapter>

View File

@ -1,23 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<!--
$LastChangedBy$
$Date$
-->
<chapter id="connect-dialup">
<?dbhtml filename="dialup.html"?>
<title>Dial-up Networking</title>
<para>This chapter provides utilities for system interaction with a modem.</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvdial.xml"/>
</chapter>

View File

@ -1,193 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!-- Inserted as a reminder to do this. The mention of a test suite
is usually right before the root user installation commands. Please
delete these 12 (including one blank) lines after you are done.-->
<!-- Use one of the two mentions below about a test suite,
delete the line that is not applicable. Of course, if the
test suite uses syntax other than "make check", revise the
line to reflect the actual syntax to run the test suite -->
<!-- <para>This package does not come with a test suite.</para> -->
<!-- <para>To test the results, issue: <command>make check</command>.</para> -->
<!ENTITY wvdial-download-http "http://open.nit.ca/download/wvdial-&wvdial-version;.tar.gz">
<!ENTITY wvdial-download-ftp "ftp://ftp.us.debian.org/debian/pool/main/w/wvdial/wvdial_&wvdial-version;.orig.tar.gz">
<!ENTITY wvdial-md5sum "8648c044305fc66ee33ecc55d36f8c8b">
<!ENTITY wvdial-size "66 KB">
<!ENTITY wvdial-buildsize "2.7 MB">
<!ENTITY wvdial-time "0.06 SBU">
]>
<sect1 id="wvdial" xreflabel="WvDial-&wvdial-version;">
<?dbhtml filename="wvdial.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>WvDial-&wvdial-version;</title>
<indexterm zone="wvdial">
<primary sortas="a-WvDial">WvDial</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to WvDial</title>
<para>The <application>WvDial</application> package contains a no-nonsense,
quick and easy to use alternative to <command>chat</command> and
<command>pppd</command> scripts. If you simply want to dial a modem
without the fuss and hassle of <command>chat</command> issues, then you'll
want this.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&wvdial-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&wvdial-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &wvdial-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &wvdial-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &wvdial-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &wvdial-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">WvDial Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="wvstreams"/> and
<xref linkend="ppp"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/WvDial"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of WvDial</title>
<para>Install <application>WvDial</application> by running the following
commands:</para>
<screen><userinput>make PREFIX=/usr</userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make PREFIX=/usr install</userinput></screen>
</sect2>
<sect2 role="configuration">
<title>Configuring WvDial</title>
<sect3 id="wvdial-config">
<title>Config Files</title>
<para><filename>/etc/wvdial.conf</filename> and
<filename>/etc/ppp/peers/*</filename></para>
<indexterm zone="wvdial wvdial-config">
<primary sortas="e-etc-wvdial.conf">/etc/wvdial.conf</primary>
</indexterm>
<indexterm zone="wvdial wvdial-config">
<primary sortas="e-etc-ppp-peers">/etc/ppp/peers/*</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>Perform the following two commands as the
<systemitem class="username">root</systemitem> user:</para>
<screen role='root'><userinput>touch /etc/wvdial.conf &amp;&amp;
wvdialconf /etc/wvdial.conf</userinput></screen>
<para><command>wvdialconf</command> will test that you have a working modem
and try to determine its exact setup. You will then need to enter your
ISP's phone number, login name and password into the
<filename>/etc/wvdial.conf</filename> file.</para>
<para>You then start <command>wvdial</command> with:</para>
<screen><userinput>wvdial</userinput></screen>
<para>For more information, examine the <command>wvdialconf</command>,
<filename>wvdial.conf</filename> and <command>wvdial</command> man
pages.</para>
<!-- Commented out 20060401 as the link is broken
Also, have a look at <ulink
url="http://www.electronicschat.org/nonroot-dialout/index.html">the
Non-Root Dial Out HOWTO</ulink> if you want to give non-root users
access to <command>wvdial</command>.</para> -->
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>wvdial and wvdialconf</seg>
<seg>None</seg>
<seg>/etc/ppp/peers</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="wvdial-prog">
<term><command>wvdial</command></term>
<listitem>
<para>starts a PPP connection.</para>
<indexterm zone="wvdial wvdial-prog">
<primary sortas="b-wvdial">wvdial</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wvdialconf">
<term><command>wvdialconf</command></term>
<listitem>
<para>automates the configuration of
<command>wvdial</command>.</para>
<indexterm zone="wvdial wvdialconf">
<primary sortas="b-wvdialconf">wvdialconf</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -1,26 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<!--
$LastChangedBy$
$Date$
-->
<chapter id="connect-other">
<?dbhtml filename="other.html"?>
<title>Other Connections</title>
<para>Other methods to connect to large networks are through ISDN
and PPPoE interfaces, among others. PPPoE is discussed here.
Pages written for ISDN (or others as the need arises) are always welcome
and will be included in future books, if the information becomes
available.</para>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pppoe.xml"/>
</chapter>

View File

@ -1,344 +0,0 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY pppoe-download-http "http://www.roaringpenguin.com/files/download/rp-pppoe-&pppoe-version;.tar.gz">
<!ENTITY pppoe-download-ftp " ">
<!ENTITY pppoe-md5sum "0e32760f498f9cde44081ee6aafc823b">
<!ENTITY pppoe-size "212 KB">
<!ENTITY pppoe-buildsize "2.4 MB">
<!ENTITY pppoe-time "less than 0.1 SBU">
]>
<sect1 id="pppoe" xreflabel="RP-PPPoE-&pppoe-version;">
<?dbhtml filename="pppoe.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>RP-PPPoE-&pppoe-version;</title>
<indexterm zone="pppoe">
<primary sortas="a-RP-PPPoE">RP-PPPoE</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to RP-PPPoE</title>
<para>The Roaring Penguin <application>PPPoE</application>
package contains both a client and a server component that works with the
client. The client allows you to connect to large networks that use the
PPPoE protocol, common among ADSL providers. The server component
runs alongside the client, allowing you to configure other clients that send
out a configuration request.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pppoe-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pppoe-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pppoe-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pppoe-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pppoe-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pppoe-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">RP-PPPoE Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="ppp"/> and
<xref linkend="net-tools"/> (you may omit
<application>Net-tools</application> by using the following patch to
utilize <application>IPRoute2</application> instead: <ulink
url="&patch-root;/rp-pppoe-&pppoe-version;-iproute2-1.patch"/>)</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/RP-PPPoE"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of RP-PPPoE</title>
<note id="pppoe-kernel">
<para>If you plan on using kernel-mode PPPoE, this package is no longer explicitly
needed, however, it is recommended for ease of configuration. Additional information
about kernel mode PPPoE can be found in
<filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para>
</note>
<indexterm zone="pppoe pppoe-kernel">
<primary sortas="d-Kernel-mode-PPPoE">Kernel-mode PPPoE</primary>
</indexterm>
<!-- Commenting out for now as LFS no longer moves this file to /bin,
therefore we don't need this hack
<para>Fix the location of the logger executable in several PPPoE scripts:</para>
<screen><userinput>sed -i s%/usr/bin/logger%/bin/logger% \
scripts/pppoe-{connect,setup,stop}.in</userinput></screen>
-->
<para>Install <application>RP-PPPoE</application> by running the following
commands:</para>
<screen><userinput>cd src &amp;&amp;
./configure &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>These are the standard installation commands that will install the
package into the <filename class="directory">/usr</filename> prefix. You
can optionally use the <command>go</command> script in the root of the
source tree to run the same commands, which are then immediately followed
by the <command>pppoe-setup</command> script.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring RP-PPPoE</title>
<sect3 id="pppoe-config">
<title>Config Files</title>
<para><filename>/etc/ppp/pppoe.conf</filename>,
<filename>/etc/ppp/firewall-standalone</filename>,
<filename>/etc/ppp/firewall-masq</filename>,
<filename>/etc/ppp/pppoe-server-options</filename>,
<filename>/etc/resolv.conf</filename>,
<filename>/etc/ppp/pap-secrets</filename>,
<filename>/etc/ppp/chap-secrets</filename></para>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-pppoe.conf">/etc/ppp/pppoe.conf</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-firewall-standalone">/etc/ppp/firewall-standalone</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-firewall-masq">/etc/ppp/firewall-masq</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-pppoe-server-options">/etc/ppp/pppoe-server-options</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-pap-secrets">/etc/ppp/pap-secrets</primary>
</indexterm>
<indexterm zone="pppoe pppoe-config">
<primary sortas="e-etc-ppp-chap-secrets">/etc/ppp/chap-secrets</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>To configure <application>RP-PPPoE</application> after installation,
you should run the <command>pppoe-setup</command> script.</para>
<para>When configuring your connection, you will need to have your
ISP's nameserver information available, as well as your
username and password. You will also be asked whether to configure a
dial-on-demand or a constant connection. If your service provider does not
charge by the minute, it is usually good to have a bootscript handle the
connection for you. You can, of course, choose not to install the
following script, and start your connection manually with the
<command>pppoe-start</command> script.</para>
<para id="pppoe-init"><emphasis>Optionally</emphasis> install the
<filename>/etc/sysconfig/network-devices/services/pppoe</filename> service
script included with the <xref linkend="bootscripts"/>
package (as user <systemitem class="username">root</systemitem>).</para>
<indexterm zone="pppoe pppoe-init">
<primary sortas="f-pppoe-service-script">pppoe (service script)</primary>
</indexterm>
<screen role='root'><userinput>make install-service-pppoe</userinput></screen>
<para id="pppoe-config2">Now create the config file for use with the
<filename>pppoe</filename> service script (as user <systemitem
class="username">root</systemitem>):</para>
<indexterm zone="pppoe pppoe-config2">
<primary sortas="e-etc-sysconfig-pppoe">/etc/sysconfig/.../pppoe</primary>
</indexterm>
<note>
<para>If you have previously configured the network interface that
will now use PPPoE, you should remove the interface
configuration files for that interface (as user <systemitem
class="username">root</systemitem>):</para>
<screen role='root'><userinput>rm -v /etc/sysconfig/network-devices/ifconfig.eth0/*</userinput></screen>
</note>
<screen role='root'><userinput>install -v -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/pppoe &lt;&lt; "EOF"
<literal>ONBOOT="yes"
SERVICE="pppoe"</literal>
EOF</userinput></screen>
<!-- A TYPE="[user/kernel]" will be added at a later date when kernel
mode pppoe is described here. -->
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>pppoe-connect, pppoe-setup, pppoe-start, pppoe-status, pppoe-stop, pppoe,
pppoe-relay, pppoe-server and pppoe-sniff</seg>
<seg>None</seg>
<seg>/etc/ppp/plugins and /usr/share/doc/rp-pppoe-&pppoe-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="pppoe-connect">
<term><command>pppoe-connect</command></term>
<listitem>
<para>is a shell script which manages an PPPoE
connection using the user-space PPPoE client.</para>
<indexterm zone="pppoe pppoe-connect">
<primary sortas="b-pppoe-connect">pppoe-connect</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-setup">
<term><command>pppoe-setup</command></term>
<listitem>
<para>is a script for configuring the client. Configuration is
then stored in <filename>/etc/ppp/pppoe.conf</filename>.</para>
<indexterm zone="pppoe pppoe-setup">
<primary sortas="b-pppoe-setup">pppoe-setup</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-start">
<term><command>pppoe-start</command></term>
<listitem>
<para>starts the client using the options specified in
<filename>/etc/ppp/pppoe.conf</filename>.</para>
<indexterm zone="pppoe pppoe-start">
<primary sortas="b-pppoe-start">pppoe-start</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-status">
<term><command>pppoe-status</command></term>
<listitem>
<para>displays the status of the PPPoE
connection.</para>
<indexterm zone="pppoe pppoe-status">
<primary sortas="b-pppoe-status">pppoe-status</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-stop">
<term><command>pppoe-stop</command></term>
<listitem>
<para>stops the client.</para>
<indexterm zone="pppoe pppoe-stop">
<primary sortas="b-pppoe-stop">pppoe-stop</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-prog">
<term><command>pppoe</command></term>
<listitem>
<para>is the client program. Generally it should not be started on
its own.</para>
<indexterm zone="pppoe pppoe-prog">
<primary sortas="b-pppoe">pppoe</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-relay">
<term><command>pppoe-relay</command></term>
<listitem>
<para>starts the server relay agent.</para>
<indexterm zone="pppoe pppoe-relay">
<primary sortas="b-pppoe-relay">pppoe-relay</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-server">
<term><command>pppoe-server</command></term>
<listitem>
<para>starts the server component.</para>
<indexterm zone="pppoe pppoe-server">
<primary sortas="b-pppoe-server">pppoe-server</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pppoe-sniff">
<term><command>pppoe-sniff</command></term>
<listitem>
<para>is a small network sniffer designed to assist in setting
<envar>PPPOE_EXTRA</envar> settings.</para>
<indexterm zone="pppoe pppoe-sniff">
<primary sortas="b-pppoe-sniff">pppoe-sniff</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

View File

@ -3,7 +3,7 @@ $LastChangedBy$
$Date$
-->
<!ENTITY day "17"> <!-- Always 2 digits -->
<!ENTITY day "18"> <!-- Always 2 digits -->
<!ENTITY month "03"> <!-- Always 2 digits -->
<!ENTITY year "2008">
<!ENTITY version "svn-&year;&month;&day;">

View File

@ -18,7 +18,6 @@ $Date$
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction/introduction.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/postlfs.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="general/general.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="connect/connect.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="basicnet/basicnet.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="server/server.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="x/x.xml"/>

View File

@ -41,6 +41,18 @@
-->
<listitem>
<para>March 18th, 2008</para>
<itemizedlist>
<listitem>
<para>[alexander] - Removed WvDial, WvStreams and RP-PPPoE, as
alternative instructions are available on the PPP page. Moved the
remaining packages from the Connecting to a Network part to a
chapter with the same name in the Basic Networking part.</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>March 17th, 2008</para>
<itemizedlist>
@ -138,7 +150,7 @@
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>March 12th, 2008</para>
<itemizedlist>
@ -240,8 +252,8 @@
<itemizedlist>
<listitem>
<para>[ken] - Updated to gnumeric-1.8.1, with goffice-0.6.1,
libgsf-1.14.7, and warning that gnucash-2.2.0 needs an older
version of goffice.</para>
libgsf-1.14.7, and warning that gnucash-2.2.0 needs an older
version of goffice.</para>
</listitem>
<listitem>
<para>[dj] - Updated to gamin-0.1.9.</para>

View File

@ -48,12 +48,10 @@
it depends upon so you can choose the program you want to install and see
what it needs.</para>
<para>Likewise, most people will probably want to look at the <xref
linkend="connect"/> and <xref linkend="basicnet"/> parts. The first of
these deals with connecting to the Internet or your LAN
using a variety of methods such as DHCP
(<xref linkend="connect-dhcp"/>) and Dial-Up Connections (<xref
linkend="connect-dialup"/>). The second of these parts deals with items
<para>Likewise, most people will probably want to look at the
<xref linkend="basicnet"/> part. It deals with connecting to the Internet
or your LAN (<xref linkend="basicnet-connect"/>)
using a variety of methods such as DHCP and PPP, and with items
such as Networking Libraries (<xref linkend="basicnet-netlibs"/>) and various
basic networking programs and utilities.</para>

View File

@ -164,7 +164,7 @@ make</userinput></screen>
<title>Configuration Information</title>
<para>Information on configuring the DHCP client can be
found in <xref linkend="connect-dhcp"/>.</para>
found in <xref linkend="basicnet-connect"/>.</para>
<para>Note that you only need the DHCP server if you want to issue
LAN addresses over your network. The DHCP client doesn't need this