Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 387697 - Handbook Part4 Ch 3.b says ifconfig is default when iproute2 is default
Summary: Handbook Part4 Ch 3.b says ifconfig is default when iproute2 is default
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-10-19 15:44 UTC by Grant Edwards
Modified: 2011-10-23 09:46 UTC (History)
1 user (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 Grant Edwards 2011-10-19 15:44:17 UTC
According to the Handbook Part 4 Ch 3:

   3.b. Interface Handlers

   We provide two interface handlers presently: ifconfig and iproute2.
   You need one of these to do any kind of network configuration.

   ifconfig is the current Gentoo default and it's included in the
   system profile. iproute2 is a more powerful and flexible package,
   but it's not included by default.

That's sort of misleading.  I think it needs to explain there are two
different "defaults": 1) what is installed by default 2) what is used
by default if both are installed.

The modular networking infrastructure will use iproute2 over ifconfig
unless a) the user overrides the default of iproute2 by specifying
"modules=ifconfig" or b) iproute2 is not installed.

From /usr/share/doc/openrc-0.7.0/net.example:

  ##############################################################################
  # INTERFACE HANDLERS
  #
  # We provide two interface handlers presently: ifconfig and iproute2.
  # You need one of these to do any kind of network configuration.
  # For ifconfig support, emerge sys-apps/net-tools
  # For iproute2 support, emerge sys-apps/iproute2
  #
  # If you don't specify an interface then we prefer iproute2 if it's installed
  # To prefer ifconfig over iproute2
  #modules="ifconfig"

I have both ifconfig and iproute2 installed and read the handbook as
meaning that ifconfig would be used by default.  This resulted in some
wasted time trying to troubleshoot my network configuration.  Once I
realized that iproute2 is preferred by default, I was able to figure
things out.





Reproducible: Always
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2011-10-23 09:46:38 UTC
Thanks! I've updated the document in CVS so it should show up in an hour or so on the site.