source: connect/other/pppoe.xml@ 68dc29a7

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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 68dc29a7 was 68dc29a7, checked in by Igor Živković <igor@…>, 17 years ago

Tags correction.

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

  • Property mode set to 100644
File size: 7.0 KB
Line 
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
14<sect1 id="pppoe" xreflabel="RP-PPPoE-&pppoe-version;">
15<sect1info>
16<othername>$LastChangedBy$</othername>
17<date>$Date$</date>
18</sect1info>
19<?dbhtml filename="pppoe.html"?>
20<title>RP-PPPoE-&pppoe-version;</title>
21
22<sect2>
23<title>Introduction to <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
24
25<para>The Roaring Penguin <application><acronym>PPPoE</acronym></application>
26package contains both a client and a server component that works with the
27client. The client allows you to connect to large networks that use the
28<acronym>PPPoE</acronym> protocol, common among <acronym>ADSL</acronym>
29providers. The server component runs alongside the client,
30allowing you to configure other clients that send out a configuration
31request.</para>
32
33<sect3><title>Package information</title>
34<itemizedlist spacing='compact'>
35<listitem><para>Download (HTTP): <ulink
36url="&pppoe-download-http;"/></para></listitem>
37<listitem><para>Download (FTP): <ulink
38url="&pppoe-download-ftp;"/></para></listitem>
39<listitem><para>Download size: &pppoe-size;</para></listitem>
40<listitem><para>Estimated Disk space required:
41&pppoe-buildsize;</para></listitem>
42<listitem><para>Estimated build time:
43&pppoe-time;</para></listitem></itemizedlist>
44</sect3>
45
46<sect3><title><application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> dependencies</title>
47<sect4><title>Required</title>
48<para><xref linkend="ppp"/> and <xref linkend="net-tools"/></para></sect4>
49</sect3>
50
51
52</sect2>
53
54<sect2>
55<title>Installation of <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
56
57<note><para>If you plan on using kernel-mode PPPoE,
58this package is no longer explicitly needed. However, it is recomended
59for ease of configuration. Additional information about kernel mode
60<acronym>PPPoE</acronym> can be found in
61<filename>rp-pppoe-&pppoe-version;/doc/KERNEL-MODE-PPPOE</filename>.</para></note>
62
63<para>Install <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> by running
64the following commands:</para>
65
66<screen><userinput><command>cd src &amp;&amp;
67./configure &amp;&amp;
68make &amp;&amp;
69make install</command></userinput></screen>
70
71</sect2>
72
73<sect2>
74<title>Command explanations</title>
75
76<para>These are the standard installation commands that will install into
77the <filename>/usr</filename> prefix. You can optionally use the
78<command>go</command> script in the root of the source tree, to
79run the same commands, which are then immediately followed by the
80<command>adsl-setup</command> script.</para>
81
82</sect2>
83
84<sect2>
85<title>Configuring <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application></title>
86
87<sect3><title>Config files</title>
88<para><filename>/etc/ppp/pppoe.conf</filename>,
89<filename>/etc/ppp/firewall-standalone</filename>,
90<filename>/etc/ppp/firewall-masq</filename>,
91<filename>/etc/ppp/pppoe-server-options</filename>,
92<filename>/etc/resolv.conf</filename>,
93<filename>/etc/ppp/pap-seecrets</filename>,
94<filename>/etc/ppp/chap-secrets</filename></para></sect3>
95
96<sect3><title>Configuration Information</title>
97
98<para>To configure <application><acronym>RP</acronym>-<acronym>PPPoE</acronym>
99</application> after installation, you should run the <command>adsl-setup
100</command> script.</para>
101
102<para>When configuring your connection, you will need to have your
103<acronym>ISP</acronym>'s nameserver information available, as well as your
104username and password. You will also be asked whether to configure a
105dial-on-demand or a constant connection. If your service provider does not
106charge by the minute, it is usually good to have a bootscript handle the
107connection for you. You can, of course, choose not to install the
108following script, and start your connection manually with the
109<command>adsl-start</command> script.</para>
110
111<para><emphasis>Optionally</emphasis> install the
112<filename>/etc/sysconfig/network-devices/services/pppoe</filename> service
113script included with the <xref linkend="intro-important-bootscripts"/>
114package.</para>
115
116<screen><userinput><command>make install-service-pppoe</command></userinput></screen>
117
118<para>Now create the config file for use with the <filename>pppoe</filename>
119service script:</para>
120
121<note><para>If you have previously configured the network interface that
122will now
123use <acronym>PPPoE</acronym>, you should remove the interface
124configuration
125files for that interface:
126<command><userinput>rm /etc/sysconfig/network-devices/ifconfig.eth0/*</userinput></command>.</para></note>
127
128<screen><userinput><command>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
129cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/pppoe &lt;&lt; "EOF"</command>
130ONBOOT="yes"
131SERVICE="pppoe"
132<command>EOF</command></userinput></screen>
133
134<!-- A TYPE="[user/kernel]" will be added at a later date when kernel
135mode pppoe is described here. -->
136
137</sect3>
138
139</sect2>
140
141<sect2>
142<title>Contents</title>
143
144<para>The <application><acronym>RP</acronym>-<acronym>PPPoE</acronym></application> package
145contains <command>adsl-setup</command>, <command>adsl-start</command>,
146<command>adsl-status</command>, <command>adsl-stop</command>, <command>
147pppoe</command>, <command>pppoe-relay</command>, <command>pppoe-server
148</command> and <command>pppoe-sniff</command>.</para>
149
150</sect2>
151
152<sect2><title>Description</title>
153
154<sect3><title>adsl-setup</title>
155<para>A script for configuring the client. Configuration is then stored
156in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3>
157
158<sect3><title>adsl-start</title>
159<para><command>adsl-start</command> starts the client using the options
160specified in <filename>/etc/ppp/pppoe.conf</filename>.</para></sect3>
161
162<sect3><title>adsl-status</title>
163<para><command>adsl-status</command> displays the status of the
164<acronym>ADSL</acronym> connection.</para></sect3>
165
166<sect3><title>adsl-stop</title>
167<para><command>adsl-stop</command> stops the client.</para></sect3>
168
169<sect3><title>pppoe</title>
170<para>This is the client itself. Generally it should not be started on its
171own.</para></sect3>
172
173<sect3><title>pppoe-relay</title>
174<para><command>pppoe-relay</command> starts the server relay agent.</para></sect3>
175
176<sect3><title>pppoe-server</title>
177<para><command>pppoe-server</command> starts the server component.</para></sect3>
178
179<sect3><title>pppoe-sniff</title>
180<para>A small network sniffer designed to assist in setting <envar>PPPOE_EXTRA
181</envar> settings.</para></sect3>
182
183</sect2>
184
185</sect1>
186
Note: See TracBrowser for help on using the repository browser.