Gentoo Archives: gentoo-commits

From: William Hubbs <williamh@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/gentoo-news:master commit in: 2013/2013-03-29-udev-upgrade/
Date: Sat, 30 Mar 2013 21:05:47
Message-Id: 1364677521.cb17596416c100d7c8e18323cdfeb31c2cf4129b.williamH@gentoo
1 commit: cb17596416c100d7c8e18323cdfeb31c2cf4129b
2 Author: William Hubbs <williamh <AT> gentoo <DOT> org>
3 AuthorDate: Sat Mar 30 21:05:21 2013 +0000
4 Commit: William Hubbs <williamh <AT> gentoo <DOT> org>
5 CommitDate: Sat Mar 30 21:05:21 2013 +0000
6 URL: http://sources.gentoo.org/gitweb/?p=proj/gentoo-news.git;a=commit;h=cb175964
7
8 clean up udev upgrade news item
9
10 ---
11 .../2013-03-29-udev-upgrade.en.txt | 96 ++++++++++----------
12 .../2013-03-29-udev-upgrade.en.txt.asc | 10 +--
13 2 files changed, 49 insertions(+), 57 deletions(-)
14
15 diff --git a/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt b/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt
16 index bc99e28..c21692d 100644
17 --- a/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt
18 +++ b/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt
19 @@ -2,35 +2,36 @@ Title: Upgrading udev to version >=200
20 Author: Samuli Suominen <ssuominen@g.o>
21 Content-Type: text/plain
22 Posted: 2013-03-29
23 -Revision: 1
24 +Revision: 2
25 News-Item-Format: 1.0
26 Display-If-Installed: <sys-fs/udev-201
27
28 -This will replace the earlier news item of udev 197 upgrade,
29 -and describe the predictable networking names to more detail.
30 +This replaces the earlier news item about the udev 197 upgrade and
31 +describes the predictable network interface names in more detail.
32 +
33 +If you skip anything in this news item, your system will not be
34 +bootable, or your networking will be down, or both.
35
36 -If you skip these four phases, either your system won't boot or
37 -networking will be down, or both.
38 Pay attention also to every message printed by emerge of sys-fs/udev
39 and sys-fs/udev-init-scripts as this news item may not be complete.
40
41 -1. Removed init script:
42 -
43 -Remove udev-postmount init script from runlevels.
44 +1. udev-postmount init script:
45
46 -2. DEVTMPFS support, both kernel and fstab:
47 +Remove the udev-postmount init script from your runlevels.
48
49 -CONFIG_DEVTMPFS=y kernel option must be enabled (and for that you need
50 -at least kernel 2.6.32) see gentoo udev guide[1] for menuconfig
51 -example.
52 +2. devtmpfs support:
53
54 -If you have own line for /dev in /etc/fstab, make sure it's also
55 -fstype 'devtmpfs' and not fstype 'tmpfs' or remove the entire line
56 -since it's automounted without entry there anyway.
57 +You need at least version 2.6.32 of the kernel for devtmpfs
58 +functionality. Once you have this, make sure CONFIG_DEVTMPFS=y is set
59 +in the kernel configuration. See the gentoo udev guide for the option in
60 +make menuconfig [1].
61
62 -[1] http://www.gentoo.org/doc/en/udev-guide.xml
63 +If you have a line for /dev in /etc/fstab, make sure it is configured
64 +for file system type devtmpfs (not tmpfs or any other type). Also, you
65 +can remove this line if you prefer, since devtmpfs is mounted
66 +automatically.
67
68 -3. Old networking rules:
69 +3. Old interface naming rules:
70
71 If the system still has old network interface renaming rules in
72 /etc/udev/rules.d, like 70-persistent-net.rules, those will need
73 @@ -39,68 +40,63 @@ to be either modified or removed.
74 If you choose to modify them, you must use free namespace (like net*
75 or internet*) instead of kernel namespace (like eth* or wlan*)
76 because in-place renaming has been deprecated, see small
77 -documentation of it if you like[1]
78 +documentation of it if you like[2].
79
80 The file 70-persistent-net.rules, like the 70-persistent-cd.rules
81 should be removed, so if you modify, rename the file also to something
82 else like 70-my-network.rules to silence the deprecation warning coming
83 -from end of sys-fs/udev emerge.
84 +from the end of the sys-fs/udev emerge.
85
86 This is the old format with reserved namespace:
87
88 -SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx",
89 -NAME="eth0"
90 -SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy",
91 -NAME="eth1"
92 +SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx", NAME="eth0"
93 +SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy", NAME="eth1"
94
95 This is the new format with free namespace:
96
97 -SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx",
98 -NAME="net0"
99 -SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy",
100 -NAME="net1"
101 +SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="xx:xx:xx:xx:xx:xx", NAME="net0"
102 +SUBSYSTEM=="net", ACTION=="add", ATTR{address}=="yy:yy:yy:yy:yy:yy", NAME="net1"
103
104 -4. The predictable network interface naming:
105 +4. predictable network interface names:
106
107 -If /etc/udev/rules.d/80-net-name-slot.rules is a empty file, or if it's
108 -a symlink to /dev/null, the new names will be disabled and kernel will
109 -do all the interface naming, and the resulting names will vary by kernel
110 -and hardware configuration, and may vary by kernel version.
111 +If /etc/udev/rules.d/80-net-name-slot.rules is an empty file or a
112 +symlink to /dev/null, the new names will be disabled and the kernel will
113 +do all the interface naming, and the resulting names may vary by kernel
114 +configuration, hardware configuration and kernel version.
115
116 Also, the forementioned old 70-persistent-net.rules might interfere with
117 -the new enabling of the new predictable interface names!
118 +the new predictable interface names.
119
120 -You can get attributes of your networking interfaces using following
121 -example command (replace eth0 with your current interface name):
122 +You can get attributes of your network interfaces using a command like
123 +the following (replace eth0 with the name of the appropriate interface):
124
125 # udevadm test-builtin net_id /sys/class/net/eth0 2> /dev/null
126
127 You can copy /lib/udev/rules.d/80-net-name-slot.rules to
128 -/etc/udev/rules.d and specify what attributes and in which order
129 -gets used for naming. See upstream wiki[2] for detailed list
130 +/etc/udev/rules.d and specify the attributes and in which order
131 +they will be used for naming. See upstream wiki[3] for detailed list
132 of options.
133
134 -You can prepare the system this way for the new names before booting,
135 -like renaming /etc/init.d/net.* symlinks.
136 +You can prepare the system for the new names before booting for example
137 +by renaming /etc/init.d/net.* symlinks, editing /etc/conf.d/net, etc.
138
139 -The feature can also be completely disabled using net.ifnames=0 kernel
140 -commandline option.
141 +The feature can also be completely disabled using net.ifnames=0on the
142 +kernel command line.
143
144 If you only have one interface card, you don't necessarily have much
145 use for this feature as the name almost always stays at eth0, you can
146 easily disable it using forementioned methods.
147
148 +This feature can also replace the functionality of sys-apps/biosdevname,
149 +but you can still keep using it if you want.
150 +
151 In a normal new installation there are no files in /etc/udev/rules.d
152 and if you haven't edited any files you have in there, you should most
153 likely backup and delete them all if they don't belong to any packages.
154
155 -This feature can also replace the functionality of sys-apps/biosdevname,
156 -but you can still keep using it if you want.
157 +The official wiki has a dedicated page for udev upgrade notes[4].
158
159 -The official wiki has dedicated page for udev upgrade notes[3].
160 -
161 -[1] http://www.kernel.org/doc/htmldocs/device-drivers/
162 - API-device-rename.html
163 -[2] http://www.freedesktop.org/wiki/Software/systemd/
164 - PredictableNetworkInterfaceNames
165 -[3] http://wiki.gentoo.org/wiki/Udev/upgrade
166 +[1] http://www.gentoo.org/doc/en/udev-guide.xml
167 +[2] http://www.kernel.org/doc/htmldocs/device-drivers/API-device-rename.html
168 +[3] http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames
169 +[4] http://wiki.gentoo.org/wiki/Udev/upgrade
170
171 diff --git a/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt.asc b/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt.asc
172 index 5275d57..e6de00a 100644
173 --- a/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt.asc
174 +++ b/2013/2013-03-29-udev-upgrade/2013-03-29-udev-upgrade.en.txt.asc
175 @@ -1,11 +1,7 @@
176 -----BEGIN PGP SIGNATURE-----
177 Version: GnuPG v2.0.19 (GNU/Linux)
178
179 -iQEcBAABAgAGBQJRVvIfAAoJEEdUh39IaPFNe6MH/jLqOxaJV6yw8YcoLjb8r8xP
180 -wJhsnPoh3BYwBr6pS3tCt7WPd4+UStJLHoJZmX7f8vuZTnTkMB3UMwvxDNmXwhpl
181 -Jt5DX7t0NYw30ofyW2YJt3rhYyTnvrfGTYdiOA+4nIMYLTPb3CZ4CgA3AiPH/nSU
182 -AVUa7OBHIpS04ngV4Ym8jKhpdGk4C92ZXf33d7djascEwSwZJO8HvImB+1FN+WH7
183 -wA520HzuGTmUeB+EYueBkZKmwJU6URObqxedhxYYqW5P+ab+Vvkz6RE32J4hfg00
184 -5ndwD5LoWlkdQbvm4YyWnfOfbxS6wABvc0dtzm39SFXsfOwNDWwiDxlHIgDz3UQ=
185 -=OVlU
186 +iEYEABECAAYFAlFXUtwACgkQblQW9DDEZTg9/gCgqBBMeGsnlhkZT8SFM3jWsvnX
187 +Hr0AnRySs7hPn9dUhyTP4LHG7H1Lfub/
188 +=QIIB
189 -----END PGP SIGNATURE-----