Changeset 246c904


Ignore:
Timestamp:
06/12/2004 01:11:39 AM (17 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 6.0, 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, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
a2d8572
Parents:
8e14c824
Message:

New XML Part IV (Chapters 13-15)

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2298 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
11 edited

Legend:

Unmodified
Added
Removed
  • connect/connect.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../general.ent">
     5  %general-entities;
     6]>
     7
    18<part id="connect" xreflabel="Connecting to a Network">
    29<?dbhtml filename="connect.html" dir="connect"?>
     
    916the most popular methods in this chapter.</para></partintro>
    1017
    11 &connect-dialup;
    12 &connect-dhcp;
    13 &connect-other;
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dialup/dialup.xml"/> 
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp/dhcp.xml"/> 
     20<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/> 
    1421
    1522</part>
  • connect/dhcp/dhcp-client.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<sect1 id="connect-dhcp-client">
    29<?dbhtml filename="dhcpclient.html"?>
  • connect/dhcp/dhcp.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="connect-dhcp">
    29<?dbhtml filename="dhcp.html"?>
     
    1926client of your choice.</para>
    2027
    21 &connect-dhcp-client;
    22 &dhcpcd;
     28<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp-client.xml"/> 
     29<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcpcd.xml"/> 
    2330
    2431</chapter>
  • connect/dhcp/dhcpcd.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6 
     7  <!ENTITY dhcpcd-download-http "http://www.phystech.com/ftp/dhcpcd-&dhcpcd-version;.tar.gz">
     8  <!ENTITY dhcpcd-download-ftp  "ftp://ftp.phystech.com/pub/dhcpcd-&dhcpcd-version;.tar.gz">
     9  <!ENTITY dhcpcd-size          "145 KB">
     10  <!ENTITY dhcpcd-buildsize     "868 KB">
     11  <!ENTITY dhcpcd-time          "0.04 SBU">
     12]>
     13
    114<sect1 id="dhcpcd" xreflabel="dhcpcd-&dhcpcd-version;">
    215<?dbhtml filename="dhcpcd.html"?>
    316<title>dhcpcd-&dhcpcd-version;</title>
    417
    5 &dhcpcd-intro;
    6 &dhcpcd-inst;
    7 &dhcpcd-exp;
    8 &dhcpcd-config;
    9 &dhcpcd-desc;
     18<sect2>
     19<title>Introduction to <application>dhcpcd</application></title>
     20
     21<para>The <application>dhcpcd</application> package contains the
     22<command>dhcpcd</command> client. This is useful for connecting your computer
     23to a network which uses <acronym>DHCP</acronym> to assign network addresses.
     24</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&dhcpcd-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&dhcpcd-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &dhcpcd-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&dhcpcd-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&dhcpcd-time;</para></listitem></itemizedlist>
     37</sect3>
     38
     39<sect3><title>Additional downloads</title>
     40<itemizedlist spacing='compact'>
     41<listitem><para>Required patch:
     42<ulink url="&patch-root;/dhcpcd-1.3.22-pl4-fhs-1.patch"/></para></listitem>
     43</itemizedlist>
     44</sect3>
     45
     46
     47</sect2>
     48
     49<sect2>
     50<title>Installation of <application>dhcpcd</application></title>
     51
     52<para>Install <application>dhcpcd</application> by running the following
     53commands:</para>
     54
     55<screen><userinput><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch &amp;&amp;
     56./configure --prefix="" --sysconfdir=/var/lib \
     57--mandir=/usr/share/man &amp;&amp;
     58make &amp;&amp;
     59make install</command></userinput></screen>
     60
     61
     62</sect2>
     63
     64<sect2>
     65<title>Command explanations</title>
     66
     67<para><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch
     68</command>: <application>Dhcpcd</application> unpatched puts all configuration
     69and temporary files in <filename>/etc/dhcpc</filename>. This becomes very
     70annoying when <application>dhcpcd</application> tells you it's running and it's
     71not.  You look in <filename class="directory">/var/run</filename> for
     72the <filename>PID</filename> file, but it's not
     73there, the <filename>PID</filename> file that needs deleting is in
     74<filename class="directory">/etc/dhcpc</filename>.
     75This patch brings this program into <acronym>FHS</acronym> compliance, but more
     76importantly, puts files where you expect them to be.</para>
     77
     78<para><parameter>--prefix=""</parameter>: There may be a good reason for
     79abandoning the normal <acronym>BLFS</acronym> convention of using
     80<parameter>--prefix=/usr</parameter> here.  If you are installing
     81<acronym>DHCP</acronym>, it is likely that it is
     82required during the boot process and
     83<filename class="directory">/usr</filename> may be network
     84mounted, in which case <command>dhcpcd</command> wouldn't be available due to
     85being on the network!  Therefore, depending on your situation, you may want it
     86to be installed in <filename class="directory">/sbin</filename> or
     87<filename class="directory">/usr/sbin</filename>.  This command installs to
     88<filename class="directory">/sbin</filename>.</para>
     89
     90<para><parameter>--sysconfdir=/var/lib</parameter>: This command installs
     91configuration files in the <filename class="directory">/var/lib</filename>
     92directory.</para>
     93
     94<para><parameter>--mandir=/usr/share/man</parameter>: This command
     95installs the man pages to the <filename class="directory">/usr/share/man</filename>
     96directory.</para>
     97
     98</sect2>
     99
     100<sect2>
     101<title>Configuring <application>dhcpcd</application></title>
     102
     103<sect3><title>Config files</title>
     104<para><filename>/var/lib/dhcpc/*</filename></para></sect3>
     105
     106<sect3><title>Configuration Information</title>
     107
     108<para>To configure <command>dhcpcd</command>, you need to first install
     109the network service script,
     110<filename>/etc/sysconfig/network-devices/services/dhcpcd</filename>
     111included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     112
     113<screen><userinput><command>make install-service-dhcpcd</command></userinput></screen>
     114
     115<para>Now create the <filename>ifconfig.eth0</filename> configuration
     116file using the following commands.  Adjust appropriately for additional
     117interfaces.</para>
     118
     119<para><emphasis>Note:</emphasis> This will overwrite any existing file.</para>
     120
     121<screen><userinput><command>cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0 &lt;&lt; "EOF"</command>
     122ONBOOT=yes
     123DHCP_START="<replaceable>[insert appropriate start options here]</replaceable>"
     124DHCP_STOP="-k <replaceable>[insert other stop options here]</replaceable>"
     125SERVICE=dhcpcd
     126<command>EOF</command></userinput></screen>
     127
     128<para>For more information on the appropriate
     129<envar>DHCP_START</envar> and <envar>DHCP_STOP</envar>
     130values, examine the man page for <command>dhcpcd</command>.</para>
     131
     132<para>Finally, if the <acronym>DHCP</acronym> configured interface is
     133used as your default gateway, you should remove the GATEWAY and GATEWAY_IF
     134variables from <filename>/etc/sysconfig/network</filename>: </para>
     135
     136<screen><userinput><command>sed -i "s/GATEWAY/#&amp;/" /etc/sysconfig/network</command></userinput></screen>
     137
     138</sect3>
     139
     140</sect2>
     141
     142<sect2>
     143<title>Contents</title>
     144
     145<para>The <application>dhcpcd</application> package contains <command>dhcpcd</command>.</para>
     146
     147</sect2>
     148
     149<sect2><title>Description</title>
     150
     151<sect3><title>dhcpcd</title>
     152<para><command>dhcpcd</command> is an implementation of the <acronym>DHCP
     153</acronym> client specified in <acronym>RFC</acronym>2131 and
     154<acronym>RFC</acronym>1541 (depending on which options are specified).</para>
     155</sect3>
     156
     157</sect2>
    10158
    11159</sect1>
  • connect/dialup/dialup.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="connect-dialup">
    29<?dbhtml filename="dialup.html"?>
    310<title>Dial-up networking</title>
    411
    5 &ppp;
    6 &wvdial;
     12<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ppp.xml"/>
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="wvdial.xml"/>
    714
    815</chapter>
  • connect/dialup/ppp.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6 
     7  <!ENTITY ppp-download-http "http://ccache.samba.org/ftp/ppp/ppp-&ppp-version;.tar.gz">
     8  <!ENTITY ppp-download-ftp  "ftp://ftp.samba.org/pub/ppp/ppp-&ppp-version;.tar.gz">
     9  <!ENTITY ppp-size          "757 KB">
     10  <!ENTITY ppp-buildsize     "7.4 MB">
     11  <!ENTITY ppp-time          "0.13 SBU">
     12]>
     13
    114<sect1 id="ppp" xreflabel="PPP-&ppp-version;">
    215<?dbhtml filename="ppp.html"?>
    316<title>PPP-&ppp-version;</title>
    417
    5 &ppp-intro;
    6 &ppp-inst;
    7 &ppp-config;
    8 &ppp-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>PPP</acronym></application></title>
     20
     21<para>The <application><acronym>PPP</acronym></application> package contains
     22the <command>pppd</command> daemon and the <command>chat</command> program.
     23This is used for connecting to other machines; often for connecting to
     24the Internet via a dial-up or <acronym>PPPoE</acronym> connection to an
     25<acronym>ISP</acronym>.</para>
     26
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&ppp-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&ppp-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &ppp-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&ppp-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&ppp-time;</para></listitem></itemizedlist>
     38</sect3>
     39
     40<sect3><title>Additional downloads</title>
     41<itemizedlist spacing='compact'>
     42<listitem><para>Required patch:
     43<ulink
     44url="&patch-root;/ppp-&ppp-version;-nobpf-3.patch"/></para></listitem>
     45</itemizedlist>
     46</sect3>
     47
     48<sect3><title><application>ppp</application> dependencies</title>
     49<sect4><title>Required</title>
     50<para><xref linkend="libpcap"/></para></sect4>
     51</sect3>
     52
     53</sect2>
     54
     55<sect2>
     56<title>Installation of <application><acronym>PPP</acronym></application></title>
     57
     58<note><para><application><acronym>PPP</acronym></application> support must be
     59compiled into the kernel or available as a kernel module.</para></note>
     60
     61<para>Install <application><acronym>PPP</acronym></application> by running the
     62following commands:</para>
     63
     64<screen><userinput><command>patch -Np1 -i ../ppp-&ppp-version;-nobpf-3.patch &amp;&amp;
     65./configure &amp;&amp;
     66make ETCDIR=/etc/ppp &amp;&amp;
     67make ETCDIR=/etc/ppp install</command></userinput></screen>
     68
     69</sect2>
     70
     71<sect2>
     72<title>Configuring <application><acronym>PPP</acronym></application></title>
     73
     74<sect3><title>Config files</title>
     75<para><filename>/etc/ppp/*</filename></para>
     76</sect3>
     77
     78<sect3><title>Configuration Information</title>
     79
     80<para>The <application><acronym>PPP</acronym></application> daemon
     81requires very little configuration.  The main trick is scripting the
     82connection.  This can be done either using the chat program which comes with
     83this package or by using <xref linkend="wvdial"/>.</para>
     84</sect3>
     85
     86</sect2>
     87
     88<sect2>
     89<title>Contents</title>
     90
     91<para>The <application><acronym>PPP</acronym></application> package contains
     92the <command>chat</command>,
     93<command>pppd</command>, <command>pppdump</command> and
     94<command>pppstats</command> programs.</para>
     95
     96</sect2>
     97
     98<sect2><title>Description</title>
     99
     100<sect3><title>chat</title>
     101<para>The <command>chat</command> program defines a conversational exchange
     102between the computer and the modem.  Its primary purpose is to establish the
     103connection between the Point-to-Point Protocol  Daemon
     104(<acronym>PPPD</acronym>)  and  the remote's <command>pppd</command> process.
     105</para></sect3>
     106
     107<sect3><title>pppd</title>
     108<para><command>pppd</command> is the Point to Point Protocol daemon.</para></sect3>
     109
     110<sect3><title>pppdump</title>
     111<para><command>pppdump</command> is used to convert
     112<application><acronym>PPP</acronym></application> record files
     113to a readable format.</para></sect3>
     114
     115<sect3><title>pppstats</title>
     116<para><command>pppstats</command> is used to print
     117<application><acronym>PPP</acronym></application> statistics.</para></sect3>
     118
     119</sect2>
    9120
    10121</sect1>
  • connect/dialup/wvdial.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6 
     7  <!ENTITY wvdial-download-http "http://open.nit.ca/download/wvdial-&wvdial-version;.tar.gz">
     8  <!ENTITY wvdial-download-ftp  "ftp://ftp.ing-steen.se/pub/unix/unsort/wvdial-&wvdial-version;.tar.gz">
     9  <!ENTITY wvdial-size          "66 KB">
     10  <!ENTITY wvdial-buildsize     "2.3 MB">
     11  <!ENTITY wvdial-time          "0.06 SBU">
     12]>
     13
    114<sect1 id="wvdial" xreflabel="WvDial-&wvdial-version;">
    215<?dbhtml filename="wvdial.html"?>
    316<title>WvDial-&wvdial-version;</title>
    417
    5 &wvdial-intro;
    6 &wvdial-inst;
    7 &wvdial-config;
    8 &wvdial-desc;
     18<sect2>
     19<title>Introduction to <application>WvDial</application></title>
     20
     21<para>The <application>WvDial</application> package contains a no-nonsense,
     22quick and easy to use alternative to <command>chat</command> and
     23<command>pppd</command> scripts. If you simply want to dial a modem
     24without the fuss and hassle of <command>chat</command> issues, then you'll
     25want this.</para>
     26
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&wvdial-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&wvdial-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &wvdial-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &wvdial-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &wvdial-time;</para></listitem></itemizedlist>
     34</sect3>
     35
     36<sect3><title><application>WvDial</application> dependencies</title>
     37<sect4><title>Required</title>
     38<para><xref linkend="wvstreams"/> and <xref linkend="ppp"/>
     39</para></sect4>
     40</sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>WvDial</application></title>
     46
     47<para>Install <application>WvDial</application> by running the following commands:</para>
     48
     49<screen><userinput><command>make PREFIX=/usr &amp;&amp;
     50make PREFIX=/usr install</command></userinput></screen>
     51
     52</sect2>
     53
     54<sect2>
     55<title>Configuring <application>WvDial</application></title>
     56
     57<sect3><title>Config files</title>
     58<para><filename>/etc/wvdial.conf</filename>,
     59<filename>/etc/ppp/peers/*</filename></para></sect3>
     60
     61<sect3><title>Configuration Information</title>
     62
     63<screen><userinput><command>touch /etc/wvdial.conf &amp;&amp;
     64wvdialconf /etc/wvdial.conf</command></userinput></screen>
     65<para><command>wvdialconf</command> will test that you have a working modem
     66and try to determine its exact setup. You will then need to enter your
     67<acronym>ISP</acronym>'s phone number, login name and password into the
     68<filename>/etc/wvdial.conf</filename> file.</para>
     69
     70<para>You then start wvdial with:</para>
     71<screen><userinput><command>wvdial</command></userinput></screen>
     72
     73<para>For more information, examine the wvdialconf, wvdial.conf and wvdial man pages.</para>
     74
     75</sect3>
     76
     77</sect2>
     78
     79<sect2>
     80<title>Contents</title>
     81
     82<para>The <application>WvDial</application> package contains the <command>
     83wvdial</command> and <command>wvdialconf</command> programs.</para>
     84
     85</sect2>
     86
     87<sect2><title>Description</title>
     88
     89<sect3><title>wvdial</title>
     90<para>Starts a <acronym>PPP</acronym> connection.</para></sect3>
     91
     92<sect3><title>wvdialconf</title>
     93<para>Automates the configuration of <command>wvdial</command>.</para></sect3>
     94
     95</sect2>
    996
    1097</sect1>
  • connect/other/other.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6]>
     7
    18<chapter id="connect-other">
    29<?dbhtml filename="other.html"?>
     
    916and will be included in future books, if available.</para>
    1017
    11 <!--&connect-other-isdn;-->
    12 &pppoe;
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pppoe.xml"/>
    1319
    1420</chapter>
  • connect/other/pppoe.xml

    r8e14c824 r246c904  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6 
     7  <!ENTITY pppoe-download-http "http://www.roaringpenguin.com/products/rp-pppoe/rp-pppoe-&pppoe-version;.tar.gz">
     8  <!ENTITY pppoe-download-ftp  "ftp://ftp.rutgers.edu/pub/slackware/slackware_source/n/rp-pppoe/rp-pppoe-&pppoe-version;.tar.gz">
     9  <!ENTITY pppoe-size          "185 KB">
     10  <!ENTITY pppoe-buildsize     "2.2 MB">
     11  <!ENTITY pppoe-time          "0.05 SBU">
     12]>
     13
    114<sect1 id="pppoe" xreflabel="RP-PPPoE-&pppoe-version;">
    215<?dbhtml filename="pppoe.html"?>
    316<title>RP-PPPoE-&pppoe-version;</title>
    417
    5 &pppoe-intro;
    6 &pppoe-inst;
    7 &pppoe-exp;
    8 &pppoe-config;
    9 &pppoe-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
     20
     21<para>The Roaring Penguin <application><acronym>PPPoE</acronym></application>
     22package contains both a client and a server component that works with the
     23client. The client allows you to connect to large networks that use the
     24<acronym>PPPoE</acronym> protocol, common among <acronym>ADSL</acronym>
     25providers.  The server component runs alongside the client,
     26allowing you to configure other clients that send out a configuration
     27request.</para>
     28
     29<sect3><title>Package information</title>
     30<itemizedlist spacing='compact'>
     31<listitem><para>Download (HTTP): <ulink
     32url="&pppoe-download-http;"/></para></listitem>
     33<listitem><para>Download (FTP): <ulink
     34url="&pppoe-download-ftp;"/></para></listitem>
     35<listitem><para>Download size: &pppoe-size;</para></listitem>
     36<listitem><para>Estimated Disk space required:
     37&pppoe-buildsize;</para></listitem>
     38<listitem><para>Estimated build time:
     39&pppoe-time;</para></listitem></itemizedlist>
     40</sect3>
     41                                                                               
     42<sect3><title><application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> dependencies</title>
     43<sect4><title>Required</title>
     44<para><xref linkend="ppp"/></para></sect4>
     45</sect3>
     46
     47
     48</sect2>
     49
     50<sect2>
     51<title>Installation of <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
     52
     53<para><emphasis>Note: </emphasis> If you plan on using kernel-mode PPPoE,
     54this package is no longer explicitly needed.  However, it is recomended
     55for ease of configuration.   Additional information about kernel mode
     56<acronym>PPPoE</acronym> can be found in
     57<filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para>
     58
     59<para>Install <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> by running
     60the following commands:</para>
     61
     62<screen><userinput><command>cd src &amp;&amp;
     63./configure &amp;&amp;
     64make &amp;&amp;
     65make install</command></userinput></screen>
     66
     67</sect2>
     68
     69<sect2>
     70<title>Command explanations</title>
     71
     72<para>These are the standard installation commands that will install into
     73the <filename>/usr</filename> prefix.  You can optionally use the
     74<command>go</command> script in the root of the source tree, to
     75run the same commands, which are then immediately followed by the
     76<command>adsl-setup</command> script.</para>
     77
     78</sect2>
     79
     80<sect2>
     81<title>Configuring <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
     82
     83<sect3><title>Config files</title>
     84<para><filename>/etc/ppp/pppoe.conf</filename>,
     85<filename>/etc/ppp/firewall-standalone</filename>,
     86<filename>/etc/ppp/firewall-masq</filename>,
     87<filename>/etc/ppp/pppoe-server-options</filename>,
     88<filename>/etc/resolv.conf</filename>,
     89<filename>/etc/ppp/pap-seecrets</filename>,
     90<filename>/etc/ppp/chap-secrets</filename></para></sect3>
     91
     92<sect3><title>Configuration Information</title>
     93
     94<para>To configure <application><acronym>RP</acronym>-<acronym>PPPoE</acronym>
     95</application> after installation, you should run the <command>adsl-setup
     96</command> script.</para>
     97
     98<para>When configuring your connection, you will need to have your
     99<acronym>ISP</acronym>'s nameserver information available, as well as your
     100username and password.  You will also be asked whether to configure a
     101dial-on-demand or a constant connection.  If your service provider does not
     102charge by the minute, it is usually good to have a bootscript handle the
     103connection for you.  You can, of course, choose not to install the
     104following script, and start your connection manually with the
     105<command>adsl-start</command> script.</para>
     106
     107<para><emphasis>Optionally</emphasis> install the
     108<filename>/etc/sysconfig/network-devices/services/pppoe</filename> service
     109script included with the <xref linkend="intro-important-bootscripts"/>
     110package.</para>
     111
     112<screen><userinput><command>make install-service-pppoe</command></userinput></screen>
     113
     114<para>Now create the config file for use with the <filename>pppoe</filename>
     115service script:</para>
     116
     117<screen><userinput><command>cat &gt; /etc/sysconfig/network-devices/ifconfig.pppoe &lt;&lt; "EOF"</command>
     118ONBOOT=yes
     119SERVICE=pppoe
     120<command>EOF</command></userinput></screen>
     121
     122<para>Also, if you had previously configured the network interface that will now
     123use <acronym>PPPoE</acronym>, you should remove the interface configuration
     124files for that interface:
     125<filename>/etc/sysconfig/network-devices/ifconfig.eth&lt;X&gt;
     126</filename>.</para>
     127
     128</sect3>
     129
     130</sect2>
     131
     132<sect2>
     133<title>Contents</title>
     134
     135<para>The <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> package
     136contains <command>adsl-setup</command>, <command>adsl-start</command>,
     137<command>adsl-status</command>, <command>adsl-stop</command>, <command>
     138pppoe</command>, <command>pppoe-relay</command>, <command>pppoe-server
     139</command> and <command>pppoe-sniff</command>.</para>
     140
     141</sect2>
     142
     143<sect2><title>Description</title>
     144
     145<sect3><title>adsl-setup</title>
     146<para>A script for configuring the client.  Configuration is then stored
     147in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3>
     148
     149<sect3><title>adsl-start</title>
     150<para><command>adsl-start</command> starts the client using the options
     151specified in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3>
     152
     153<sect3><title>adsl-status</title>
     154<para><command>adsl-status</command> displays the status of the
     155<acronym>ADSL</acronym> connection.</para></sect3>
     156
     157<sect3><title>adsl-stop</title>
     158<para><command>adsl-stop</command> stops the client.</para></sect3>
     159
     160<sect3><title>pppoe</title>
     161<para>This is the client itself. Generally it should not be started on its
     162own.</para></sect3>
     163
     164<sect3><title>pppoe-relay</title>
     165<para><command>pppoe-relay</command> starts the server relay agent.</para></sect3>
     166
     167<sect3><title>pppoe-server</title>
     168<para><command>pppoe-server</command> starts the server component.</para></sect3>
     169
     170<sect3><title>pppoe-sniff</title>
     171<para>A small network sniffer designed to assist in setting <envar>PPPOE_EXTRA
     172</envar> settings.</para></sect3>
     173
     174</sect2>
    10175
    11176</sect1>
  • general.ent

    r8e14c824 r246c904  
    4949<!-- Part III -->
    5050
     51<!-- Part IV -->
     52
     53<!-- Chapter 13 -->
     54<!ENTITY ppp-version       "2.4.2">
     55<!ENTITY wvdial-version    "1.53">
     56
     57<!-- Chapter 14 -->
     58<!ENTITY dhcp-version      "3.0pl2">
     59<!ENTITY dhcpcd-version    "1.3.22-pl4">   
     60
     61<!-- Chapter 15 -->
     62<!ENTITY pppoe-version     "3.5">
     63
     64
     65
    5166
    5267<!ENTITY gnome-version     "2.6">
  • index.xml

    r8e14c824 r246c904  
    3131%postlfs; -->
    3232%general;
    33 %connect;
     33<!-- %connect; -->
    3434%basicnet;
    3535%server;
     
    5757<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/postlfs.xml"/>
    5858&general;
    59 &connect;
     59
     60<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="connect/connect.xml"/>
    6061&basicnet;
    6162&server;
Note: See TracChangeset for help on using the changeset viewer.