Changeset 246c904 for connect/other


Ignore:
Timestamp:
06/12/2004 01:11:39 AM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, 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:
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

Location:
connect/other
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • 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>
Note: See TracChangeset for help on using the changeset viewer.