Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 147314 - no current documentation for ADSL in current baselayouts!
Summary: no current documentation for ADSL in current baselayouts!
Alias: None
Product: [OLD] Docs on
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
Depends on:
Reported: 2006-09-12 06:38 UTC by Eric Brown
Modified: 2006-10-31 13:27 UTC (History)
0 users

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


Note You need to log in before you can comment on or make changes to this bug.
Description Eric Brown 2006-09-12 06:38:01 UTC
Background info:

On the 2006.1 liveCD, I can use my ADSL connection by modifying /etc/conf.d/net as follows:


(and then I modify /etc/ppp/chap-secrets)...

OK, that's nice, but I think it uses rp-pppoe, which according to /etc/conf.d/net.example, is deprecated in favor of net-dialup/ppp.

The problems with this are:

1) Usage of net-dialup/ppp is not documented AT ALL on, the liveCD doesn't even appear to use it

2) pppd's own documentation is not useful to people who get DSL connections working (reallly, the man page for pppd doesn't talk about using eth0 for the line, it has no good examples of ADSL usage, and it's filled with stuff that most users won't understand)

3) baselayout tried to include functionality and configuration files, but didn't include any documentation.  For example, init.d/net.ppp0 isn't a symlink to net.lo, it's apparently part of the net-dialup/ppp package.  configuration is done in conf.d/net.ppp0, a file which has default options for modem users, and no examples for ADSL users.

4) if conf.d/net.example is not clear about how net-dialup/ppp is to be used.  When I set the obvious options in conf.d/net, and changed init.d/net.ppp0 to a symlink to net.lo, i got some error about a missing so like /usr/lib/ppp/2.4.2/ (probably slightly wrong).  Using the net.ppp0 script that was there before produces lots of profound errors that appear to stem from options conf.d/net.ppp... Can't really tell what the right thing to do is... (obviously, it could be a bug with net-dialup/ppp, but even the liveCD doesn't have that .so...)
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2006-09-12 07:03:33 UTC
Comment 2 Eric Brown 2006-10-04 02:52:33 UTC
I am reopening this bug for the following reasons:

1) As of two weeks ago, baselayout is no longer compatible with rp-pppoe, the new method of getting DSL connections up is required

2) The only documentation on getting DSL connections up using the new method is what's in net.example, which is obviously insufficient (and hence I can't upgrade bsaelayout yet)

3) To complement the new forced changes in baselayout, the docs team should probably rewrite some of the stuff in the link you posted since the current contents are no longer relevant, right?

Comment 3 nm (RETIRED) gentoo-dev 2006-10-04 07:16:22 UTC
I don't think we'll need to rewrite anything; the handbook is for the stages released at the end of august -- and those don't change. they still use rp-pppoe, and are not dependent on future package changes.

We have no control over what changes in future versions of baselayout *not included on the CD and/or stage* -- the guide is designed to work with the available media. Put it another way -- GCC 4.1.1 is deprecated at some point in the future, but you still use it to install your system.
Comment 4 nm (RETIRED) gentoo-dev 2006-10-06 12:14:04 UTC
This should be looked into when and if that version of baselayout goes stable for the next release -- as it is, if we change the handbook now, we break compatibility with the existing installation media! Doing so is obviously unacceptable.
Comment 5 Eric Brown 2006-10-08 07:40:11 UTC
I'm sorry, I mean ppp-2.4.3-r16 went stable and it is not compatible with the current init script configurations.  Here's what it says:

 * Gentoo is moving toward common configuration file for all network
 * interfaces. Thus starting from >=ppp-2.4.3-r10 the following files
 * are obsoleted and should be removed to avoid future confusion:
 *     /etc/conf.d/net.ppp0 - conflict with baselayout
 *     /etc/init.d/net.ppp0 - conflict with baselayout
 *     /etc/ppp/chat-default - unused by this version
 *     /etc/ppp/options-pppoe - unused by this version
 *     /etc/ppp/options-pptp - unused by this version

 * If you use the old net.ppp0 script, you need to:
 *    - upgrade to >=sys-apps/baselayout-1.12.0_pre11
 *    - set ppp0 parameters in /etc/conf.d/net (see example file)
 *    - remove conflicting files
 *    - upgrade net-dialup/ppp

 * If you never used net.ppp0 script, just run the following commands:
 *     rm //etc/conf.d/net.ppp0 //etc/init.d/net.ppp0 //etc/ppp/chat-default //e tc/ppp/options-pppoe //etc/ppp/options-pptp
 *     emerge --resume

FYI, if I remove those files, rp-pppoe will not work in init scripts anymore.  In effect, it doesn't matter when rp-pppoe gets deprecated in baselayout, the stable version of ppp already forcefully does that.
Comment 6 nm (RETIRED) gentoo-dev 2006-10-31 13:27:38 UTC
>OK, that's nice, but I think it uses rp-pppoe, which according to
>/etc/conf.d/net.example, is deprecated in favor of net-dialup/ppp.

You need to read conf.d/net.example more carefully. It talks about deprecating some things related to ppp because it's using its own PPP *module*, not the ppp package itself. Even grepping for rp-pppoe shows that it's still supposed to be used for ADSL *according to net.example*. If rp-pppoe is actually removed from the tree in the next release, *then* the handbook will be changed. But we can't do that because it would break compatibility with the stage tarball.

Comment 7 nm (RETIRED) gentoo-dev 2006-10-31 13:27:57 UTC
Closing per above.