Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 484396 - Refer to enp5s0 instead of eth0, same for wlan0 and other deprecated names
Summary: Refer to enp5s0 instead of eth0, same for wlan0 and other deprecated names
Status: RESOLVED WORKSFORME
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-09-09 20:46 UTC by Martin Mokrejš
Modified: 2013-09-25 17:29 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 Martin Mokrejš 2013-09-09 20:46:02 UTC
Provided you have renamed the network interface names in baselayout you should fix the documentation as well.
Comment 1 eroen 2013-09-09 20:58:00 UTC
As I understand it, network interface names are given names like eth0 and wlan0 by the kernel, then they are (by default) renamed to something ("predictable") based on their physical location on the hardware buses of your box by udev. 

This means that different hardware setups give different names by default, so no "correct" name can be given in the handbook. The old naming is however still available by making simple configuration changes as documented on the wiki.[1] The "old" naming is still default if eudev, mdev or a static /dev is used.

My humble opinion is to keep the "unpredictable" names in the examples, but better document the high likelihood of interface names being different. A section on how to disable the renaming would be nice, but is not necessary.


1: http://wiki.gentoo.org/wiki/Udev/upgrade#udev_200
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2013-09-25 17:29:05 UTC
Our documents already state that the names can/will differ for installations, and that for the handbook we'll use eth0.

Also, when necessary, we re-iterate that eth0 is an example and that the reader needs to substitute it with the proper interface name.