The installation handbook is still instructing users to setup their ADSL using the old and deprecated ADSL module instead of the new ppp module. I leaved this bug as normal instead of enhancement because the ADSL module is deprecated.
*** Bug 172401 has been marked as a duplicate of this bug. ***
Thanks for reporting. Fixed in the upcoming 2007 drafts, as well as the existing Networking Modules chapter. In with the new (ppp), out with the old (rp-pppoe).
There are several settings you normally should have in your net configuration when you're using PPPoE: pppd_ppp0=( # "debug" # Enables syslog debugging "noauth" # Do not require the peer to authenticate itself "defaultroute" # Make this PPP interface the default route "usepeerdns" # Use the DNS settings provided by PPP #Use LCP echo to detect dead peer and restart the link "holdoff 3 lcp-echo-interval 15 lcp-echo-failure 3" # Completely disable compression noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp )
Sorry for double posting... I find "For PPPoE users; replace eth0 with your actual PPP interface" confusing. Users should set there the Ethernet interface used to connect to the PPPoE concentrator. PPPoE through a USB modem: you need the net-misc/br2684ctl utility. See /usr/portage/net-dialup/speedtouch-usb/files/README for more info. The documentation advise usage of baselayout-1.12.x for the PPPoA connections. This is the current version of baselayout, no need to tell users to install it. The title of the chapter (ADSL modem) is also confusing. Actually it should be called "PPPoE/PPPoA". Cable links are also using PPPoE. The difference between PPPoA and PPPoE from users pov is minimal. On PPPoE you have: plugins_ppp0=( "pppoe" ) link_ppp0=eth0 while on PPPoA you have plugins_ppp0=( "pppoa" ) link_ppp0=0.38 #Set here your VPI.VCI provided to you by your ISP
Lets recap what you should do in order to setup your connection. ################################################################## 1) PPPoA config_ppp0=( ppp ) plugins_ppp0=( 'pppoa' ) link_ppp0='0.38' #Set here the VPI.VCI provided to you by your ISP username_ppp0='username@isp.com' password_ppp0='password' # See man pppd for the complete set of available options pppd_ppp0=( # "debug" # Enables syslog debugging "noauth" # Do not require the peer to authenticate itself "defaultroute" # Make this PPP interface the default route "usepeerdns" # Use the DNS settings provided by PPP "child-timeout 60" # Wait for 60 seconds before killing ip-up/ip-down #Use LCP echo to detect dead peer and restart the link "holdoff 3 lcp-echo-interval 15 lcp-echo-failure 3" # Completely disable compression noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp ) # If your interface driver is compiled as a module, load it like this function preup() { if [[ "$1" = "ppp0" ]] ; then modprobe -q speedtch return 0 fi } ################################################################## 2) PPPoE # If your link goes through a real Ethernet interface, # you need to configure it at least with null # You can configure it with IP settings if you want to administer your # modem through network (e.g. telnet, http, snmp,..). config_eth0=( null ) # If your network interface is ATM, you need to configure a RFC2684 bridge, # using net-misc/br2684ctl utility config_nas0=( null ) br2684ctl_nas0="-e 0 -a 0.38" #-e mux -a VPI.VCI, # where mux can be LLC (0) or VC (1) # If your interface driver is compiled as a module, load it like this function preup() { if [[ "$1" = "nas0" ]] ; then modprobe -q speedtch return 0 fi } #The PPP part config_ppp0=( ppp ) plugins_ppp0=( 'pppoe' ) link_ppp0='eth0' # Or nas0 if you are using a RFC2684 bridge username_ppp0='username@isp.com' password_ppp0='password' # See man pppd for the complete set of available options pppd_ppp0=( # "debug" # Enables syslog debugging "noauth" # Do not require the peer to authenticate itself "defaultroute" # Make this PPP interface the default route "usepeerdns" # Use the DNS settings provided by PPP "child-timeout 60" # Wait for 60 seconds before killing ip-up/ip-down #Use LCP echo to detect dead peer and restart the link "holdoff 3 lcp-echo-interval 15 lcp-echo-failure 3" # Completely disable compression noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp ) depend_ppp0() { need net.eth0 } ################################################################## For PPPoA, you need to create only the /etc/init.d/net.ppp0 symlink. For PPPoE, you also need to create the proper /etc/init.d/net.${link_ppp0} symlink.
Righto. Finally added that stuff. Note, however, that I'll leave the advanced stuff, as well as the particulars of PPPoA, to the user docs in net.example and the speedtouch-usb README (a good source of material). Should all be fixed.