Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: udev-guide.xml
Date: Wed, 20 Mar 2013 20:44:17
Message-Id: 20130320204409.ECB412171D@flycatcher.gentoo.org
1 swift 13/03/20 20:44:09
2
3 Modified: udev-guide.xml
4 Log:
5 Further fix bug #462488 - Updates on udev guide
6
7 Revision Changes Path
8 1.58 xml/htdocs/doc/en/udev-guide.xml
9
10 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/udev-guide.xml?rev=1.58&view=markup
11 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/udev-guide.xml?rev=1.58&content-type=text/plain
12 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/udev-guide.xml?r1=1.57&r2=1.58
13
14 Index: udev-guide.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v
17 retrieving revision 1.57
18 retrieving revision 1.58
19 diff -u -r1.57 -r1.58
20 --- udev-guide.xml 20 Mar 2013 15:58:35 -0000 1.57
21 +++ udev-guide.xml 20 Mar 2013 20:44:09 -0000 1.58
22 @@ -1,6 +1,6 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v 1.57 2013/03/20 15:58:35 swift Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/udev-guide.xml,v 1.58 2013/03/20 20:44:09 swift Exp $ -->
27
28 <guide>
29 <title>Gentoo udev Guide</title>
30 @@ -23,7 +23,7 @@
31 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
32 <license/>
33
34 -<version>13</version>
35 +<version>14</version>
36 <date>2013-03-20</date>
37
38 <chapter>
39 @@ -136,113 +136,12 @@
40 </chapter>
41
42 <chapter>
43 -<title>Known Issues</title>
44 -<section>
45 -<title>No Consistent Naming between DevFS and udev</title>
46 -<body>
47 -
48 -<p>
49 -Even though our intention is to have a consistent naming scheme between both
50 -dynamical device management solutions, sometimes naming differences do occur.
51 -</p>
52 -
53 -<p>
54 -One reported clash is with a HP Smart Array 5i RAID controller (more precisely
55 -the <c>cciss</c> kernel module). With udev, the devices are named
56 -<path>/dev/cciss/cXdYpZ</path> with X, Y and Z regular numbers. With devfs, the
57 -devices are <path>/dev/hostX/targetY/partZ</path> or symlinked from
58 -<path>/dev/cciss/cXdY</path>.
59 -</p>
60 -
61 -<p>
62 -If this is the case, don't forget to update your <path>/etc/fstab</path> and
63 -bootloader configuration files accordingly.
64 -</p>
65 -
66 -<p>
67 -The same happens with all-round symlinks that used to exist in
68 -<path>/dev</path>, such as <path>/dev/mouse</path>, which <c>udev</c> doesn't
69 -create anymore. Be certain to check your X configuration file and see if the
70 -Device rule for your mouse points to an existing device file.
71 -</p>
72 -
73 -<p>
74 -Another issue is the difference in naming of terminals between devfs and udev.
75 -While devfs calls its terminals <c>tty</c>, udev calls them <c>vc</c> and
76 -<c>tty</c>. This could lead to a problem in case you are restricting root
77 -logins from consoles using <path>/etc/securetty</path>. You will need to make
78 -sure that both <c>tty1</c> and <c>vc/1</c> are listed in
79 -<path>/etc/securetty</path> to ensure that root can login using the console.
80 -</p>
81 -
82 -</body>
83 -</section>
84 -<section>
85 -<title>udev loads modules in an unpredictable order</title>
86 -<body>
87 -
88 -<p>
89 -Sometimes udev loads modules in an undesired, unpredictable, or seemingly random
90 -order. This is especially common for systems that have multiple devices of the
91 -same type, as well as multimedia devices. This can affect the assigned numbers
92 -of devices; for example, sound cards may sometimes swap numbers.
93 -</p>
94 -
95 -<p>
96 -There are a few solutions to fix device numbers and/or module load order.
97 -Ideally, you can just use module parameters to specify your desired device
98 -number. Some modules, such as ALSA, include the "index" parameter. Modules that
99 -use the index parameter can be adjusted as shown. This example is for a system
100 -with two sound cards. The card with an index of 0 is designated as the first
101 -card. Once the parameters are changed, the module config files must be updated.
102 -</p>
103 -
104 -<pre caption="Specifying module parameters">
105 -# <i>echo "option snd-ice1724 index=0" >> /etc/modprobe.d/alsa.conf</i>
106 -# <i>echo "option snd-ymfpci index=1" >> /etc/modprobe.d/alsa.conf</i>
107 -# <i>update-modules</i>
108 -</pre>
109 -
110 -<p>
111 -The above example is the preferred solution, but not all modules support
112 -parameters such as index. For these modules, you'll have to force the correct
113 -module load order. First, you must stop udev from autoloading the modules by
114 -blacklisting them. Be sure to use the exact name of the module being loaded.
115 -For PCI devices, you'll need to use the module names obtained from the output of
116 -<c>lspci -k</c>, available in the <c>pciutils</c> package. The following example
117 -uses DVB modules.
118 -</p>
119 -
120 -<pre caption="Blacklisting modules">
121 -# <i>echo "blacklist b2c2-flexcop-pci" >> /etc/modprobe.d/dvb</i>
122 -# <i>echo "blacklist budget" >> /etc/modprobe.d/dvb</i>
123 -# <i>update-modules</i>
124 -</pre>
125 -
126 -<p>
127 -Next, load the modules in the correct order. Add them to
128 -<path>/etc/conf.d/modules</path> <e>in the exact order you want
129 -them loaded</e>.
130 -</p>
131 -
132 -<pre caption="Loading modules in the correct order">
133 -# <i>nano -w /etc/conf.d/modules</i>
134 -
135 -modules="<i>budget b2c2-flexcop-pci</i>"
136 -</pre>
137 -
138 -</body>
139 -</section>
140 -</chapter>
141 -
142 -<chapter>
143 <title>Resources &amp; Acknowledgements</title>
144 <section>
145 <body>
146
147 <p>
148 -<uri link="http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames">
149 -Documentation for using the new predictable network interface names.</uri>
150 +Documentation for using <uri link="http://www.freedesktop.org/wiki/Software/systemd/PredictableNetworkInterfaceNames">the new predictable network interface names.</uri>
151 </p>
152
153 <p>