[gentoo-doc-cvs] cvs commit: hb-net-modules.xml

[Josh Saddler]

nightmorph    07/04/08 01:28:11

  Modified:             hb-net-modules.xml
  Log:
  new ADSL/PPP setup, bug 171584. note that i went ahead and did the major version number bump a day or so ahead of the release schedule. i figure, why not. early is better.

Revision  Changes    Path
1.22                 xml/htdocs/doc/en/handbook/hb-net-modules.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.22&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?rev=1.22&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml?r1=1.21&r2=1.22

Index: hb-net-modules.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-net-modules.xml	4 Jan 2007 06:03:26 -0000	1.21
+++ hb-net-modules.xml	8 Apr 2007 01:28:11 -0000	1.22
@@ -4,7 +4,7 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.21 2007/01/04 06:03:26 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-net-modules.xml,v 1.22 2007/04/08 01:28:11 nightmorph Exp $ -->
 
 <sections>
 
@@ -13,8 +13,8 @@
 different DHCP clients, setting up bonding, bridging, VLANs and more.
 </abstract>
 
-<version>7.1</version>
-<date>2007-01-04</date>
+<version>8.0</version>
+<date>2007-04-07</date>
 
 <section>
 <title>Network Modules</title>
@@ -211,35 +211,49 @@
 First we need to install the ADSL software.
 </p>
 
-<pre caption="Install the rp-pppoe package">
-# <i>emerge net-dialup/rp-pppoe</i>
+<pre caption="Install the ppp package">
+# <i>emerge net-dialup/ppp</i>
 </pre>
 
-<warn>
-<c>baselayout-1.11.x</c> supports PPPoE only. Hopefully future versions will
-support PPPoA.
-</warn>
+<note>
+If you need PPPoA, then you need to use >=<c>baselayout-1.12.x</c>.
+</note>
+
+<p>
+Second, create the PPP net script:
+</p>
+
+<pre caption="Creating the PPP net script">
+# <i>ln -s /etc/init.d/net.lo /etc/init.d/net.ppp0</i>
+</pre>
 
 <p>
-Now we need to configure <c>eth0</c> to be an ADSL interface and enter our 
-username by updating <path>/etc/conf.d/net</path>.
+Now we need to configure <path>/etc/conf.d/net</path>.
 </p>
 
-<pre caption="Configure eth0 for ADSL in /etc/conf.d/net">
-config_eth0=( "adsl" )
-adsl_user_eth0="username"
+<pre caption="A basic PPPoE setup">
+config_ppp0=( "ppp" )
+link_ppp0="eth0" <comment>(For PPPoE users; replace eth0 with your actual PPP interface)</comment>
+plugins_ppp0=( "pppoe" )
+username_ppp0='user'
+password_ppp0='password'
 </pre>
 
 <p>
-Finally you need to define your username and password in
-<path>/etc/ppp/pap-secrets</path>.
+You can also set your password in <path>/etc/ppp/pap-secrets</path>.
 </p>
 
-<pre caption="sample /etc/ppp/pap-secrets">
+<pre caption="Sample /etc/ppp/pap-secrets">
 <comment># The * is important</comment>
 "username"  *  "password"
 </pre>
 
+<impo>
+Please carefully read the section on ADSL and PPP in
+<path>/etc/conf.d/net.example</path>. It contains many more detailed
+explanations of all the settings your particular PPP setup will likely need.
+</impo>
+
 </body>
 </section>
 <section id="apipa">



-- 
gentoo-doc-cvs@g.o mailing list