Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 171584 - ADSL setup suggests the "old ADSL module" setup: new "ppp" module not mentioned
Summary: ADSL setup suggests the "old ADSL module" setup: new "ppp" module not mentioned
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: nm (RETIRED)
URL:
Whiteboard:
Keywords:
: 172401 (view as bug list)
Depends on:
Blocks: 170536
  Show dependency tree
 
Reported: 2007-03-20 16:03 UTC by Rodrigo Severo
Modified: 2007-04-14 02:40 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Rodrigo Severo 2007-03-20 16:03:27 UTC
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.
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2007-03-27 11:49:57 UTC
*** Bug 172401 has been marked as a duplicate of this bug. ***
Comment 2 nm (RETIRED) gentoo-dev 2007-04-08 01:29:39 UTC
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).
Comment 3 Alin Năstac (RETIRED) gentoo-dev 2007-04-09 07:13:19 UTC
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
)
Comment 4 Alin Năstac (RETIRED) gentoo-dev 2007-04-09 08:07:11 UTC
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
Comment 5 Alin Năstac (RETIRED) gentoo-dev 2007-04-10 07:43:39 UTC
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.
Comment 6 nm (RETIRED) gentoo-dev 2007-04-14 02:40:27 UTC
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.