Changeset 68dcb2dd for connect


Ignore:
Timestamp:
04/30/2005 07:28:23 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
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:
f2c510ee
Parents:
84a779b
Message:

Finished connect.

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

Location:
connect
Files:
4 edited

Legend:

Unmodified
Added
Removed

  • connect/connect.xml

    r84a779b r68dcb2dd  
    77
    88<part id="connect" xreflabel="Connecting to a Network">
    9 <?dbhtml filename="connect.html" dir="connect"?>
    10 <title>Connecting to a Network</title>
    11 
    12 <partintro><para>The <acronym>LFS</acronym> book covers setting up networking
    13 by connecting to a <acronym>LAN</acronym> with a static
    14 <acronym>IP</acronym> address.  There are other methods used to connect to
    15 a <acronym>LAN</acronym> and other networks (such as the Internet).  We cover
    16 the most popular methods in this chapter.</para></partintro>
    17 
    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"/> 
     9  <?dbhtml filename="connect.html" dir="connect"?>
     10 
     11  <title>Connecting to a Network</title>
     12 
     13  <partintro>
     14    <para>The LFS book covers setting up networking by connecting to a LAN
     15    with a static IP address. There are other methods used to connect to
     16    a LAN and other networks (such as the Internet).  We cover
     17    the most popular methods in this chapter.</para>
     18  </partintro>
     19 
     20  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dialup/dialup.xml"/> 
     21  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp/dhcp.xml"/> 
     22  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/> 
    2123
    2224</part>

  • connect/dialup/wvdial.xml

    r84a779b r68dcb2dd  
    5858    </itemizedlist>
    5959   
    60     <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead>
     60    <bridgehead renderas="sect3">WvDial Dependencies</bridgehead>
    6161   
    6262    <bridgehead renderas="sect4">Required</bridgehead>

  • connect/other/other.xml

    r84a779b r68dcb2dd  
    77
    88<chapter id="connect-other">
    9 <?dbhtml filename="other.html"?>
    10 <title>Other Connections</title>
    11 
    12 <para>Other methods to connect to large networks are through <acronym>ISDN
    13 </acronym> and <acronym>PPPoE</acronym> interfaces, among others.
    14 <acronym>PPPoE</acronym> is discussed here.  Pages written
    15 for <acronym>ISDN</acronym> (or others as the need arises) are always welcome
    16 and will be included in future books, if available.</para>
    17 
    18 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pppoe.xml"/>
     9  <?dbhtml filename="other.html"?>
     10 
     11  <title>Other Connections</title>
     12 
     13  <para>Other methods to connect to large networks are through ISDN
     14  and PPPoE interfaces, among others. PPPoE is discussed here.
     15  Pages written for ISDN (or others as the need arises) are always welcome
     16  and will be included in future books, if available.</para>
     17 
     18  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pppoe.xml"/>
    1919
    2020</chapter>

  • connect/other/pppoe.xml

    r84a779b r68dcb2dd  
    1414
    1515<sect1 id="pppoe" xreflabel="RP-PPPoE-&pppoe-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="pppoe.html"?>
    21 <title>RP-PPPoE-&pppoe-version;</title>
    22 <indexterm zone="pppoe">
    23 <primary sortas="a-RP-PPPoE">RP-PPPoE</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to
    27 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
    28 
    29 <para>The Roaring Penguin <application><acronym>PPPoE</acronym></application>
    30 package contains both a client and a server component that works with the
    31 client. The client allows you to connect to large networks that use the
    32 <acronym>PPPoE</acronym> protocol, common among <acronym>ADSL</acronym>
    33 providers.  The server component runs alongside the client,
    34 allowing you to configure other clients that send out a configuration
    35 request.</para>
    36 
    37 <sect3><title>Package information</title>
    38 <itemizedlist spacing='compact'>
    39 <listitem><para>Download (HTTP): <ulink
    40 url="&pppoe-download-http;"/></para></listitem>
    41 <listitem><para>Download (FTP): <ulink
    42 url="&pppoe-download-ftp;"/></para></listitem>
    43 <listitem><para>Download MD5 sum: &pppoe-md5sum;</para></listitem>
    44 <listitem><para>Download size: &pppoe-size;</para></listitem>
    45 <listitem><para>Estimated disk space required:
    46 &pppoe-buildsize;</para></listitem>
    47 <listitem><para>Estimated build time:
    48 &pppoe-time;</para></listitem></itemizedlist>
    49 </sect3>
    50 
    51 <sect3><title>
    52 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application>
    53 dependencies</title>
    54 <sect4><title>Required</title>
    55 <para><xref linkend="ppp"/> and
    56 <xref linkend="net-tools"/> (you may omit
    57 <application>Net-tools</application> by using the following patch to
    58 utilize <application><acronym>IP</acronym>Route2</application>: <ulink
    59 url="&patch-root;/rp-pppoe-&pppoe-version;-iproute2-1.patch"/>)</para>
    60 </sect4>
    61 </sect3>
    62 
    63 </sect2>
    64 
    65 <sect2 id="pppoe-kernel">
    66 <title>Installation of
    67 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application>
    68 </title>
    69 
    70 <note><para>If you plan on using kernel-mode <acronym>PPPoE</acronym>,
    71 this package is no longer explicitly needed, however, it is recomended
    72 for ease of configuration.   Additional information about kernel mode
    73 <acronym>PPPoE</acronym> can be found in
    74 <filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para></note>
    75 <indexterm zone="pppoe pppoe-kernel">
    76 <primary sortas="d-Kernel-mode-PPPoE">Kernel-mode PPPoE</primary></indexterm>
    77 
    78 <para>Fix the location of the logger executable in several
    79 <acronym>ADSL</acronym> scripts:</para>
    80 
    81 <screen><userinput><command>sed -i s%/usr/bin/logger%/bin/logger% scripts/adsl-{connect,setup,stop}.in</command></userinput></screen>
    82 
    83 <para>Install
    84 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> by
    85 running the following commands:</para>
    86 
    87 <screen><userinput><command>cd src &amp;&amp;
     16  <?dbhtml filename="pppoe.html"?>
     17 
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22 
     23  <title>RP-PPPoE-&pppoe-version;</title>
     24 
     25  <indexterm zone="pppoe">
     26    <primary sortas="a-RP-PPPoE">RP-PPPoE</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to RP-PPPoE</title>
     31   
     32    <para>The Roaring Penguin <application>PPPoE</application>
     33    package contains both a client and a server component that works with the
     34    client. The client allows you to connect to large networks that use the
     35    PPPoE protocol, common among ADSL providers. The server component
     36    runs alongside the client, allowing you to configure other clients that send
     37    out a configuration request.</para>
     38   
     39    <bridgehead renderas="sect3">Package Information</bridgehead>
     40    <itemizedlist spacing="compact">
     41      <listitem>
     42        <para>Download (HTTP): <ulink url="&pppoe-download-http;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download (FTP): <ulink url="&pppoe-download-ftp;"/></para>
     46      </listitem>
     47      <listitem>
     48        <para>Download MD5 sum: &pppoe-md5sum;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Download size: &pppoe-size;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated disk space required: &pppoe-buildsize;</para>
     55      </listitem>
     56      <listitem>
     57        <para>Estimated build time: &pppoe-time;</para>
     58      </listitem>
     59    </itemizedlist>
     60   
     61    <bridgehead renderas="sect3">RP-PPPoE Dependencies</bridgehead>
     62   
     63    <bridgehead renderas="sect4">Required</bridgehead>
     64    <para><xref linkend="ppp"/> and
     65    <xref linkend="net-tools"/> (you may omit
     66    <application>Net-tools</application> by using the following patch to
     67    utilize <application>IPRoute2</application>: <ulink
     68    url="&patch-root;/rp-pppoe-&pppoe-version;-iproute2-1.patch"/>)</para>
     69   
     70  </sect2>
     71 
     72  <sect2 role="installation">
     73    <title>Installation of RP-PPPoE</title>
     74
     75    <note id="pppoe-kernel">
     76      <para>If you plan on using kernel-mode PPPoE, this package is no longer explicitly
     77      needed, however, it is recomended for ease of configuration. Additional information
     78      about kernel mode PPPoE can be found in
     79      <filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para>
     80    </note>
     81   
     82    <indexterm zone="pppoe pppoe-kernel">
     83      <primary sortas="d-Kernel-mode-PPPoE">Kernel-mode PPPoE</primary>
     84    </indexterm>
     85   
     86    <para>Fix the location of the logger executable in several ADSL scripts:</para>
     87
     88<screen><userinput>sed -i s%/usr/bin/logger%/bin/logger% scripts/adsl-{connect,setup,stop}.in</userinput></screen>
     89
     90    <para>Install <application>RP-PPPoE</application> by running the following
     91    commands:</para>
     92
     93<screen><userinput>cd src &amp;&amp;
    8894./configure &amp;&amp;
    89 make</command></userinput></screen>
    90 
    91 <para>This package does not come with a test suite.</para>
    92 
    93 <para>Now, as the root user:</para>
    94 
    95 <screen><userinput role='root'><command>make install</command></userinput></screen>
    96 
    97 </sect2>
    98 
    99 <sect2>
    100 <title>Command explanations</title>
    101 
    102 <para>These are the standard installation commands that will install into
    103 the <filename>/usr</filename> prefix.  You can optionally use the
    104 <command>go</command> script in the root of the source tree, to
    105 run the same commands, which are then immediately followed by the
    106 <command>adsl-setup</command> script.</para>
    107 
    108 </sect2>
    109 
    110 <sect2>
    111 <title>Configuring
    112 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application>
    113 </title>
    114 
    115 <sect3 id="pppoe-config"><title>Config files</title>
    116 <para><filename>/etc/ppp/pppoe.conf</filename>,
    117 <filename>/etc/ppp/firewall-standalone</filename>,
    118 <filename>/etc/ppp/firewall-masq</filename>,
    119 <filename>/etc/ppp/pppoe-server-options</filename>,
    120 <filename>/etc/resolv.conf</filename>,
    121 <filename>/etc/ppp/pap-secrets</filename>,
    122 <filename>/etc/ppp/chap-secrets</filename></para>
    123 <indexterm zone="pppoe pppoe-config"><primary
    124 sortas="e-etc-ppp-pppoe.conf">/etc/ppp/pppoe.conf</primary>
    125 </indexterm>
    126 <indexterm zone="pppoe pppoe-config"><primary
    127 sortas="e-etc-ppp-firewall-standalone">/etc/ppp/firewall-standalone</primary>
    128 </indexterm>
    129 <indexterm zone="pppoe pppoe-config"><primary
    130 sortas="e-etc-ppp-firewall-masq">/etc/ppp/firewall-masq</primary>
    131 </indexterm>
    132 <indexterm zone="pppoe pppoe-config"><primary
    133 sortas="e-etc-ppp-pppoe-server-options">/etc/ppp/pppoe-server-options</primary>
    134 </indexterm>
    135 <indexterm zone="pppoe pppoe-config"><primary
    136 sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
    137 </indexterm>
    138 <indexterm zone="pppoe pppoe-config"><primary
    139 sortas="e-etc-ppp-pap-secrets">/etc/ppp/pap-secrets</primary>
    140 </indexterm>
    141 <indexterm zone="pppoe pppoe-config"><primary
    142 sortas="e-etc-ppp-chap-secrets">/etc/ppp/chap-secrets</primary>
    143 </indexterm>
    144 </sect3>
    145 
    146 <sect3><title>Configuration Information</title>
    147 
    148 <para>To configure
    149 <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application>
    150 after installation, you should run the <command>adsl-setup</command>
    151 script.</para>
    152 
    153 <para>When configuring your connection, you will need to have your
    154 <acronym>ISP</acronym>'s nameserver information available, as well as your
    155 username and password.  You will also be asked whether to configure a
    156 dial-on-demand or a constant connection.  If your service provider does not
    157 charge by the minute, it is usually good to have a bootscript handle the
    158 connection for you.  You can, of course, choose not to install the
    159 following script, and start your connection manually with the
    160 <command>adsl-start</command> script.</para>
    161 
    162 <para id="pppoe-init"><emphasis>Optionally</emphasis> install the
    163 <filename>/etc/sysconfig/network-devices/services/pppoe</filename> service
    164 script included with the <xref linkend="intro-important-bootscripts"/>
    165 package (as user root).</para>
    166 <indexterm zone="pppoe pppoe-init">
    167 <primary sortas="f-pppoe-service-script">pppoe (service script)</primary>
    168 </indexterm>
    169 
    170 <screen><userinput role='root'><command>make install-service-pppoe</command></userinput></screen>
    171 
    172 <para id="pppoe-config2">Now create the config file for use with the
    173 <filename>pppoe</filename> service script (as user root):</para>
    174 <indexterm zone="pppoe pppoe-config2">
    175 <primary sortas="e-etc-sysconfig-pppoe">/etc/sysconfig/.../pppoe</primary>
    176 </indexterm>
    177 
    178 <note><para>If you have previously configured the network interface that
    179 will now use <acronym>PPPoE</acronym>, you should remove the interface
    180 configuration files for that interface (as user root):</para>
    181 
    182 <para><command><userinput role='root'>rm
    183 /etc/sysconfig/network-devices/ifconfig.eth0/*</userinput></command></para>
    184 </note>
    185 
    186 <screen><userinput role='root'><command>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
    187 cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/pppoe &lt;&lt; "EOF"</command>
    188 ONBOOT="yes"
    189 SERVICE="pppoe"
    190 <command>EOF</command></userinput></screen>
    191 
    192 <!-- A TYPE="[user/kernel]" will be added at a later date when kernel
    193 mode pppoe is described here. -->
    194 </sect3>
    195 
    196 </sect2>
    197 
    198 <sect2>
    199 <title>Contents</title>
    200 
    201 <segmentedlist>
    202 <segtitle>Installed Programs</segtitle>
    203 <segtitle>Installed Libraries</segtitle>
    204 <segtitle>Installed Directories</segtitle>
    205 
    206 <seglistitem>
    207 <seg>adsl-connect, adsl-setup, adsl-start, adsl-status, adsl-stop, pppoe,
    208 pppoe-relay, pppoe-server and pppoe-sniff</seg>
    209 <seg>None</seg>
    210 <seg>/etc/ppp/plugins and /usr/share/doc/rp-pppoe-&pppoe-version;</seg>
    211 </seglistitem>
    212 </segmentedlist>
    213 
    214 <variablelist>
    215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    216 <?dbfo list-presentation="list"?>
    217 
    218 <varlistentry id="adsl-connect">
    219 <term><command>adsl-connect</command></term>
    220 <listitem><para>is a shell script which manages an <acronym>ADSL</acronym>
    221 connection using the user-space <acronym>PPPoE</acronym> client.</para>
    222 <indexterm zone="pppoe adsl-connect">
    223 <primary sortas="b-adsl-connect">adsl-connect</primary>
    224 </indexterm></listitem>
    225 </varlistentry>
    226 
    227 <varlistentry id="adsl-setup">
    228 <term><command>adsl-setup</command></term>
    229 <listitem><para>is a script for configuring the client. Configuration is
    230 then stored in <filename>/etc/ppp/pppoe.conf</filename>.</para>
    231 <indexterm zone="pppoe adsl-setup">
    232 <primary sortas="b-adsl-setup">adsl-setup</primary>
    233 </indexterm></listitem>
    234 </varlistentry>
    235 
    236 <varlistentry id="adsl-start">
    237 <term><command>adsl-start</command></term>
    238 <listitem><para>starts the client using the options specified in
    239 <filename>/etc/ppp/pppoe.conf</filename>.</para>
    240 <indexterm zone="pppoe adsl-start">
    241 <primary sortas="b-adsl-start">adsl-start</primary>
    242 </indexterm></listitem>
    243 </varlistentry>
    244 
    245 <varlistentry id="adsl-status">
    246 <term><command>adsl-status</command></term>
    247 <listitem><para>displays the status of the <acronym>ADSL</acronym>
    248 connection.</para>
    249 <indexterm zone="pppoe adsl-status">
    250 <primary sortas="b-adsl-status">adsl-status</primary>
    251 </indexterm></listitem>
    252 </varlistentry>
    253 
    254 <varlistentry id="adsl-stop">
    255 <term><command>adsl-stop</command></term>
    256 <listitem><para>stops the client.</para>
    257 <indexterm zone="pppoe adsl-stop">
    258 <primary sortas="b-adsl-stop">adsl-stop</primary>
    259 </indexterm></listitem>
    260 </varlistentry>
    261 
    262 <varlistentry id="pppoe-prog">
    263 <term><command>pppoe</command></term>
    264 <listitem><para>is the client program. Generally it should not be started on
    265 its own.</para>
    266 <indexterm zone="pppoe pppoe-prog">
    267 <primary sortas="b-pppoe">pppoe</primary>
    268 </indexterm></listitem>
    269 </varlistentry>
    270 
    271 <varlistentry id="pppoe-relay">
    272 <term><command>pppoe-relay</command></term>
    273 <listitem><para>starts the server relay agent.</para>
    274 <indexterm zone="pppoe pppoe-relay">
    275 <primary sortas="b-pppoe-relay">pppoe-relay</primary>
    276 </indexterm></listitem>
    277 </varlistentry>
    278 
    279 <varlistentry id="pppoe-server">
    280 <term><command>pppoe-server</command></term>
    281 <listitem><para>starts the server component.</para>
    282 <indexterm zone="pppoe pppoe-server">
    283 <primary sortas="b-pppoe-server">pppoe-server</primary>
    284 </indexterm></listitem>
    285 </varlistentry>
    286 
    287 <varlistentry id="pppoe-sniff">
    288 <term><command>pppoe-sniff</command></term>
    289 <listitem><para>is a small network sniffer designed to assist in setting
    290 <envar>PPPOE_EXTRA</envar> settings.</para>
    291 <indexterm zone="pppoe pppoe-sniff">
    292 <primary sortas="b-pppoe-sniff">pppoe-sniff</primary>
    293 </indexterm></listitem>
    294 </varlistentry>
    295 </variablelist>
    296 
    297 </sect2>
     95make</userinput></screen>
     96
     97    <para>This package does not come with a test suite.</para>
     98   
     99    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     100   
     101<screen role="root"><userinput>make install</userinput></screen>
     102   
     103  </sect2>
     104 
     105  <sect2 role="commands">
     106    <title>Command Explanations</title>
     107
     108    <para>These are the standard installation commands that will install into
     109    the <filename class="directory">/usr</filename> prefix.  You can optionally use the
     110    <command>go</command> script in the root of the source tree, to
     111    run the same commands, which are then immediately followed by the
     112    <command>adsl-setup</command> script.</para>
     113   
     114  </sect2>
     115 
     116  <sect2 role="configuration">
     117    <title>Configuring RP-PPPoE</title>
     118
     119    <sect3 id="pppoe-config">
     120      <title>Config Files</title>
     121     
     122      <para><filename>/etc/ppp/pppoe.conf</filename>,
     123      <filename>/etc/ppp/firewall-standalone</filename>,
     124      <filename>/etc/ppp/firewall-masq</filename>,
     125      <filename>/etc/ppp/pppoe-server-options</filename>,
     126      <filename>/etc/resolv.conf</filename>,
     127      <filename>/etc/ppp/pap-secrets</filename>,
     128      <filename>/etc/ppp/chap-secrets</filename></para>
     129     
     130      <indexterm zone="pppoe pppoe-config">
     131        <primary sortas="e-etc-ppp-pppoe.conf">/etc/ppp/pppoe.conf</primary>
     132      </indexterm>
     133     
     134      <indexterm zone="pppoe pppoe-config">
     135        <primary sortas="e-etc-ppp-firewall-standalone">/etc/ppp/firewall-standalone</primary>
     136      </indexterm>
     137     
     138      <indexterm zone="pppoe pppoe-config">
     139        <primary sortas="e-etc-ppp-firewall-masq">/etc/ppp/firewall-masq</primary>
     140      </indexterm>
     141     
     142      <indexterm zone="pppoe pppoe-config">
     143        <primary sortas="e-etc-ppp-pppoe-server-options">/etc/ppp/pppoe-server-options</primary>
     144      </indexterm>
     145     
     146      <indexterm zone="pppoe pppoe-config">
     147        <primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary>
     148      </indexterm>
     149     
     150      <indexterm zone="pppoe pppoe-config">
     151        <primary sortas="e-etc-ppp-pap-secrets">/etc/ppp/pap-secrets</primary>
     152      </indexterm>
     153     
     154      <indexterm zone="pppoe pppoe-config">
     155        <primary sortas="e-etc-ppp-chap-secrets">/etc/ppp/chap-secrets</primary>
     156      </indexterm>
     157   
     158    </sect3>
     159
     160    <sect3>
     161      <title>Configuration Information</title>
     162
     163      <para>To configure <application>RP-PPPoE</application> after installation,
     164      you should run the <command>adsl-setup</command> script.</para>
     165     
     166      <para>When configuring your connection, you will need to have your
     167      ISP's nameserver information available, as well as your
     168      username and password.  You will also be asked whether to configure a
     169      dial-on-demand or a constant connection.  If your service provider does not
     170      charge by the minute, it is usually good to have a bootscript handle the
     171      connection for you.  You can, of course, choose not to install the
     172      following script, and start your connection manually with the
     173      <command>adsl-start</command> script.</para>
     174
     175      <para id="pppoe-init"><emphasis>Optionally</emphasis> install the
     176      <filename>/etc/sysconfig/network-devices/services/pppoe</filename> service
     177      script included with the <xref linkend="intro-important-bootscripts"/>
     178      package (as user <systemitem class="username">root</systemitem>).</para>
     179     
     180      <indexterm zone="pppoe pppoe-init">
     181        <primary sortas="f-pppoe-service-script">pppoe (service script)</primary>
     182      </indexterm>
     183
     184<screen role='root'><userinput>make install-service-pppoe</userinput></screen>
     185
     186      <para id="pppoe-config2">Now create the config file for use with the
     187      <filename>pppoe</filename> service script (as user <systemitem
     188      class="username">root</systemitem>):</para>
     189     
     190      <indexterm zone="pppoe pppoe-config2">
     191        <primary sortas="e-etc-sysconfig-pppoe">/etc/sysconfig/.../pppoe</primary>
     192      </indexterm>
     193     
     194      <note>
     195        <para>If you have previously configured the network interface that
     196        will now use PPPoE, you should remove the interface
     197        configuration files for that interface (as user <systemitem
     198        class="username">root</systemitem>):</para>
     199     
     200<screen role='root'><userinput>rm /etc/sysconfig/network-devices/ifconfig.eth0/*</userinput></screen>
     201      </note>
     202
     203<screen role='root'><userinput>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
     204cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/pppoe &lt;&lt; "EOF"
     205<literal>ONBOOT="yes"
     206SERVICE="pppoe"</literal>
     207EOF</userinput></screen>
     208
     209      <!-- A TYPE="[user/kernel]" will be added at a later date when kernel
     210      mode pppoe is described here. -->
     211     
     212    </sect3>
     213   
     214  </sect2>
     215 
     216  <sect2 role="content">
     217    <title>Contents</title>
     218
     219    <segmentedlist>
     220      <segtitle>Installed Programs</segtitle>
     221      <segtitle>Installed Libraries</segtitle>
     222      <segtitle>Installed Directories</segtitle>
     223     
     224      <seglistitem>
     225        <seg>adsl-connect, adsl-setup, adsl-start, adsl-status, adsl-stop, pppoe,
     226        pppoe-relay, pppoe-server and pppoe-sniff</seg>
     227        <seg>None</seg>
     228        <seg>/etc/ppp/plugins and /usr/share/doc/rp-pppoe-&pppoe-version;</seg>
     229      </seglistitem>
     230    </segmentedlist>
     231   
     232    <variablelist>
     233      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     234      <?dbfo list-presentation="list"?>
     235      <?dbhtml list-presentation="table"?>
     236     
     237      <varlistentry id="adsl-connect">
     238        <term><command>adsl-connect</command></term>
     239        <listitem>
     240          <para>is a shell script which manages an ADSL
     241          connection using the user-space PPPoE client.</para>
     242          <indexterm zone="pppoe adsl-connect">
     243            <primary sortas="b-adsl-connect">adsl-connect</primary>
     244          </indexterm>
     245        </listitem>
     246      </varlistentry>
     247     
     248      <varlistentry id="adsl-setup">
     249        <term><command>adsl-setup</command></term>
     250        <listitem>
     251          <para>is a script for configuring the client. Configuration is
     252          then stored in <filename>/etc/ppp/pppoe.conf</filename>.</para>
     253          <indexterm zone="pppoe adsl-setup">
     254            <primary sortas="b-adsl-setup">adsl-setup</primary>
     255          </indexterm>
     256        </listitem>
     257      </varlistentry>
     258     
     259      <varlistentry id="adsl-start">
     260        <term><command>adsl-start</command></term>
     261        <listitem>
     262          <para>starts the client using the options specified in
     263          <filename>/etc/ppp/pppoe.conf</filename>.</para>
     264          <indexterm zone="pppoe adsl-start">
     265            <primary sortas="b-adsl-start">adsl-start</primary>
     266          </indexterm>
     267        </listitem>
     268      </varlistentry>
     269     
     270      <varlistentry id="adsl-status">
     271        <term><command>adsl-status</command></term>
     272        <listitem>
     273          <para>displays the status of the ADSL
     274          connection.</para>
     275          <indexterm zone="pppoe adsl-status">
     276            <primary sortas="b-adsl-status">adsl-status</primary>
     277          </indexterm>
     278        </listitem>
     279      </varlistentry>
     280     
     281      <varlistentry id="adsl-stop">
     282        <term><command>adsl-stop</command></term>
     283        <listitem>
     284          <para>stops the client.</para>
     285          <indexterm zone="pppoe adsl-stop">
     286            <primary sortas="b-adsl-stop">adsl-stop</primary>
     287          </indexterm>
     288        </listitem>
     289      </varlistentry>
     290     
     291      <varlistentry id="pppoe-prog">
     292        <term><command>pppoe</command></term>
     293        <listitem>
     294          <para>is the client program. Generally it should not be started on
     295          its own.</para>
     296          <indexterm zone="pppoe pppoe-prog">
     297            <primary sortas="b-pppoe">pppoe</primary>
     298          </indexterm>
     299        </listitem>
     300      </varlistentry>
     301     
     302      <varlistentry id="pppoe-relay">
     303        <term><command>pppoe-relay</command></term>
     304        <listitem>
     305          <para>starts the server relay agent.</para>
     306          <indexterm zone="pppoe pppoe-relay">
     307            <primary sortas="b-pppoe-relay">pppoe-relay</primary>
     308          </indexterm>
     309        </listitem>
     310      </varlistentry>
     311     
     312      <varlistentry id="pppoe-server">
     313        <term><command>pppoe-server</command></term>
     314        <listitem>
     315          <para>starts the server component.</para>
     316          <indexterm zone="pppoe pppoe-server">
     317            <primary sortas="b-pppoe-server">pppoe-server</primary>
     318          </indexterm>
     319        </listitem>
     320      </varlistentry>
     321     
     322      <varlistentry id="pppoe-sniff">
     323        <term><command>pppoe-sniff</command></term>
     324        <listitem>
     325          <para>is a small network sniffer designed to assist in setting
     326          <envar>PPPOE_EXTRA</envar> settings.</para>
     327          <indexterm zone="pppoe pppoe-sniff">
     328            <primary sortas="b-pppoe-sniff">pppoe-sniff</primary>
     329          </indexterm>
     330        </listitem>
     331      </varlistentry>
     332   
     333    </variablelist>
     334
     335  </sect2>
    298336
    299337</sect1>
Note: See TracChangeset for help on using the changeset viewer.