From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-dev+bounces-59352-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
	by finch.gentoo.org (Postfix) with ESMTP id E7A51138010
	for <garchives@archives.gentoo.org>; Fri, 29 Mar 2013 08:11:09 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 37953E08A0;
	Fri, 29 Mar 2013 08:11:05 +0000 (UTC)
Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183])
	(using TLSv1 with cipher AECDH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by pigeon.gentoo.org (Postfix) with ESMTPS id 3C596E0893
	for <gentoo-dev@lists.gentoo.org>; Fri, 29 Mar 2013 08:11:04 +0000 (UTC)
Received: from [10.185.119.106] (85-76-134-97-nat.elisa-mobile.fi [85.76.134.97])
	(using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	(Authenticated sender: ssuominen)
	by smtp.gentoo.org (Postfix) with ESMTPSA id E41E133DBE1
	for <gentoo-dev@lists.gentoo.org>; Fri, 29 Mar 2013 08:11:02 +0000 (UTC)
Message-ID: <51554C37.4000508@gentoo.org>
Date: Fri, 29 Mar 2013 10:09:27 +0200
From: Samuli Suominen <ssuominen@gentoo.org>
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130327 Thunderbird/17.0.4
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
To: gentoo-dev <gentoo-dev@lists.gentoo.org>
Subject: [gentoo-dev] Request of news item review: 2013-03-29-udev-predictable-network-interface-names.en.txt
Content-Type: multipart/mixed;
 boundary="------------040009000300070801080900"
X-Archives-Salt: bd600093-e3f0-4715-8804-2ecb615f84b1
X-Archives-Hash: eb02c32bcc9ebd5ee748c06680d78c93

This is a multi-part message in MIME format.
--------------040009000300070801080900
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

This is required for stabilizing new udev (bug #463614)
And required otherwise too as people are still confused from what I have 
seen in forums
I hope this isn't too much of an hand holding

Will push it tomorrow'ish if noone complains (and fix grammar later too 
if required)

Thanks for looking into it!



--------------040009000300070801080900
Content-Type: text/plain; charset=UTF-8;
 name="2013-03-29-udev-predictable-network-interface-names.en.txt"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
 filename*0="2013-03-29-udev-predictable-network-interface-names.en.txt"

Title: The new default predictable network interface naming with udev
Author: Samuli Suominen <ssuominen@gentoo.org>
Content-Type: text/plain
Posted: 2013-03-29
Revision: 1
News-Item-Format: 1.0
Display-If-Installed: <sys-fs/udev-201

If you still have network interface renaming rules in /etc/udev/rules.d,
like 70-persistent-net.rules, you will need to modify or remove them.

If you choose to modify them, you will need to pick a free namespace (like
net* or internet*) that is not reserved by the kernel (like eth* or wlan*)
because in-place renaming has been deprecated[1].
You should also rename the file to something else, like 70-my-network.rules
to silence the deprecation warning coming from when you emerge udev.

This is old format:

SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx",
NAME="eth0"
SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy",
NAME="eth1"

This is new format:

SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx",
NAME="net0"
SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy",
NAME="net1"

With the new predictable network interface naming scheme which upstream enabled
by default you don't have to rename anymore because the names will be static
and not randomly rename when you, for example, upgrade the kernel. This can be
very important aspect, for example, security in mind.

If /etc/udev/rules.d/80-net-name-slot.rules is a empty file, or if it's a
symlink to /dev/null, the new names will be disabled and kernel will do
all the interface naming, which will be random.

The new names can also be disabled using net.ifnames=0 kernel option.

In normal new installation there is no files put in /etc/udev/rules.d and if
you haven't edited any files you have in there, you should most likely delete
(backup) them all out of the way.

You can find out using udevadm command what your interfaces will be called
before booting to make necessary changes, such as changing net.* symlinks
in /etc/init.d.

This is the example command:

# udevadm test-builtin net_id /sys/class/net/eth0 2> /dev/null

The output could be (and I'm only picking the most important line for this
example):

ID_NET_NAME_PATH=enp2s0f0

This would mean your eth0 will be called enp2s0f0 if there is no previously
mentioned files blocking the new names taking place in /etc/udev/rules.d.

This is documented more throughly at upstream wiki[2] which everyone should
read at least once.

This feature will also replace the functionality of sys-apps/biosdevname which
you should uninstall. However, you can still keep using sys-apps/biosdevname
if you want.

[1] http://www.kernel.org/doc/htmldocs/device-drivers/API-device-rename.html
[2] http://www.freedesktop.org/wiki/Software/systemd/
    PredictableNetworkInterfaceNames

--------------040009000300070801080900--