Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 89724 - Bad instructions re: net.lo in draft handbook / Gentoo Network Configuration
Summary: Bad instructions re: net.lo in draft handbook / Gentoo Network Configuration
Status: RESOLVED INVALID
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-04-19 15:29 UTC by tar
Modified: 2005-04-19 16:08 UTC (History)
0 users

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 tar 2005-04-19 15:29:14 UTC
The Gentoo Handbook draft, part 4 chapter 1, starts out with these instructions:

To get started configuring your network card, you need to tell the Gentoo RC system about it. This is done by creating a symbolic link from net.lo to net.eth0 in /etc/init.d

Code Listing 1

# cd /etc/init.d
# ln -s net.lo net.eth0

This is wrong.  net.lo is not suitable for starting other network interfaces.  net.eth0 is installed in the base layout, so it ought to be present.

Reproducible: Always
Steps to Reproduce:
1. Browse to http://www.gentoo.org/doc/en/handbook/draft/handbook-x86.xml?part=4&chap=1
2. Follow the instructions for setting up net.eth0
3. Execute /etc/init.d/net.eth0, observe that the loopback device is started instead

Actual Results:  
The eth0 network interface was not started.  The documentation gave bad instruction.

Expected Results:  
The eth0 network interface should have been started.  The documentation should
give good instructions.

$ emerge info
Portage 2.0.51.19 (default-linux/x86/2005.0, gcc-3.4.3-20050110,
glibc-2.3.4.20041102-r1, 2.6.11-hardened-r1 i686)
=================================================================
System uname: 2.6.11-hardened-r1 i686 Mobile Intel(R) Pentium(R) 4 - M CPU 2.40GHz
Gentoo Base System version 1.4.16
Python:              dev-lang/python-2.3.4-r1 [2.3.4 (#1, Feb  7 2005, 08:39:33)]
dev-lang/python:     2.3.4-r1
sys-devel/autoconf:  2.59-r6, 2.13
sys-devel/automake:  1.7.9-r1, 1.8.5-r3, 1.5, 1.4_p6, 1.6.3, 1.9.4
sys-devel/binutils:  2.15.92.0.2-r7
sys-devel/libtool:   1.5.14
virtual/os-headers:  2.6.8.1-r2
ACCEPT_KEYWORDS="x86"
AUTOCLEAN="yes"
CFLAGS="-O2 -march=pentium4 -fomit-frame-pointer -pipe"
CHOST="i686-pc-linux-gnu"
CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3.3/env
/usr/kde/3.3/share/config /usr/kde/3.3/shutdown /usr/kde/3/share/config
/usr/lib/X11/xkb /usr/lib/mozilla/defaults/pref /usr/share/config /var/bind
/var/qmail/control"
CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d"
CXXFLAGS="-O2 -march=pentium4 -fomit-frame-pointer -pipe"
DISTDIR="/usr/portage/distfiles"
FEATURES="autoaddcvs autoconfig ccache distlocks fixpackages sandbox sfperms
strict userpriv"
GENTOO_MIRRORS="http://gentoo.chem.wisc.edu/gentoo/
ftp://ftp.ussg.iu.edu/pub/linux/gentoo/ http://cudlug.cudenver.edu/gentoo/
http://mirrors.tds.net/gentoo/ http://csociety-ftp.ecn.purdue.edu/pub/gentoo/"
LDFLAGS="-Wl,-O1"
MAKEOPTS="-j2"
PKGDIR="/usr/portage/packages"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/usr/local/portage"
SYNC="rsync://rsync.gentoo.org/gentoo-portage"
USE="x86 X acpi alsa arts avi berkdb bitmap-fonts cdr crypt cups curl dga dvd
dvdr emboss encode esd evo fam flac foomaticdb fortran gdbm gif gnome gpm gps
gstreamer gtk gtk2 imagemagick imap imlib ipv6 java jpeg junit kde
kdeenablefinal ldap libg++ libwww mad mikmod mmx mmx2 motif mozilla mp3 mpeg
ncurses nls offensive ogg oggvorbis opengl oss pam pcmcia pda pdflib perl png
ppds python qt quicktime readline samba sasl sdl slang slp snmp spell sqlite sse
ssl svga tcpd tiff truetype truetype-fonts type1-fonts usb vorbis wifi xface xml
xml2 xmms xprint xv zlib"
Unset:  ASFLAGS, CBUILD, CTARGET, LANG, LC_ALL, LINGUAS
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2005-04-19 15:39:25 UTC
No, net.eth0 is not installed in new (still unstable) baselayout - check the ebuilds. :-)
Comment 2 SpanKY gentoo-dev 2005-04-19 15:42:35 UTC
yeah, i think the draft covers the unstable versions of baselayout, in which case there is just one net.lo script and all other interfaces are symlinked to it
Comment 3 Roy Marples (RETIRED) gentoo-dev 2005-04-19 16:08:33 UTC
The draft is for baselayout-1.11.x which is stated in the second Note section at the top of the page in the URL referenced.

baselayout-1.11.x just provides net.lo which caters for any net.eth0 et all.