Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 169029 - ifplugd section at Network Management isn't clear
Summary: ifplugd section at Network Management isn't clear
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:
Depends on:
Blocks:
 
Reported: 2007-03-02 18:11 UTC by Alexander Skwar
Modified: 2007-03-07 00:08 UTC (History)
2 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 Alexander Skwar 2007-03-02 18:11:26 UTC
In Section "6. Network Management", there's "6.b. ifplugd" which talks about ifplugd. It has:

> Configuration for ifplugd is fairly straightforward too. The configuration file is held in /etc/conf.d/ifplugd. Run man ifplugd for details on what the variables do.

After that, a list of variables follows. According to the installation documentation, these env. vars. should be explained in man ifplugd. But they aren't. For example, in the list on the installation documentation, there's:

AUTO="no"
BEEP="yes"

But in man ifplugd, there's no switch "--auto", there's only "--no-auto" and "--no-beep". If "AUTO=" refers to "--no-auto" and "BEEP=" to "--no-beep", then the documentation should say so.
Comment 1 Alexander Skwar 2007-03-02 18:35:13 UTC
Further, it's not quite clear (to me), where the configuration file for ifplugd is supposed to be. The installation documentation at http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=4&chap=6 says, that it's supposed to be /etc/conf.d/ifplugd. "man ifplugd" and "man ifplugd.conf" refer to a file called "/etc/ifplugd/ifplugd.conf", though.

What's the correct file? The one referenced in the installation documentation or the one in the man pages?

Either way, one of the documenations is wrong and should be fixed. Or if indeed both files are used, then something to that effect should be added to the man pages.

And finally, "man ifplugd" refers to /etc/init.d/ifplugd. This file does not exist on Gentoo.
Comment 2 nm (RETIRED) gentoo-dev 2007-03-02 19:08:09 UTC
Roy, you mentioned that this part of the handbook was out of date a couple of months ago, any input on what should be done to bring it up to date? Kick out ifplugd entirely? ;)
Comment 3 Roy Marples (RETIRED) gentoo-dev 2007-03-02 20:54:47 UTC
(In reply to comment #2)
> Roy, you mentioned that this part of the handbook was out of date a couple of
> months ago, any input on what should be done to bring it up to date? Kick out
> ifplugd entirely? ;)

Heh.

No, just mention that ifplugd options should be if ifplugd_eth0="..." in /etc/conf.d/net and the init script no longer exists. I'll update the man page for soon.

A lightweight to ifplugd it netplug, but it relies on the kernel driver working 100%, which a lot don't. No commandline options for it of note.

You may also want to mention resolvconf (net-dns/resolvconf-gentoo) to manage >1 dhcp client. This has a man page you can use for reference.

I would remove the reference to quickswitch.
Comment 4 nm (RETIRED) gentoo-dev 2007-03-07 00:08:16 UTC
Thanks for reporting, and to Roy for the pointers. Fixed in CVS.