Changeset ddd5542 for chapter06/udev.xml
- Timestamp:
- 02/10/2006 07:05:30 PM (19 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 12.2, 12.2-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/loongarch-12.2, xry111/mips64el, xry111/multilib, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 3bf7cb6
- Parents:
- 3f3931b0
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter06/udev.xml
r3f3931b0 rddd5542 1 1 <?xml version="1.0" encoding="ISO-8859-1"?> 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ 3 4 <!ENTITY % general-entities SYSTEM "../general.ent"> 4 5 %general-entities; 5 6 ]> 7 6 8 <sect1 id="ch-system-udev" role="wrap"> 7 <title>Udev-&udev-version;</title> 8 <?dbhtml filename="udev.html"?> 9 10 <indexterm zone="ch-system-udev"><primary sortas="a-Udev">Udev</primary></indexterm> 11 12 <sect2 role="package"><title/> 13 <para>The Udev package contains programs for dynamic creation of device nodes.</para> 14 15 <segmentedlist> 16 <segtitle>&buildtime;</segtitle> 17 <segtitle>&diskspace;</segtitle> 18 <seglistitem><seg>0.1 SBU</seg><seg>3.8 MB</seg></seglistitem> 19 </segmentedlist> 20 21 <segmentedlist> 22 <segtitle>&dependencies;</segtitle> 23 <seglistitem><seg>Coreutils and Make</seg></seglistitem> 24 </segmentedlist> 25 26 </sect2> 27 28 <sect2 role="installation"> 29 <title>Installation of Udev</title> 30 31 <para>Compile the package:</para> 9 <?dbhtml filename="udev.html"?> 10 11 <title>Udev-&udev-version;</title> 12 13 <indexterm zone="ch-system-udev"> 14 <primary sortas="a-Udev">Udev</primary> 15 </indexterm> 16 17 <sect2 role="package"> 18 <title/> 19 20 <para>The Udev package contains programs for dynamic creation of device 21 nodes.</para> 22 23 <segmentedlist> 24 <segtitle>&buildtime;</segtitle> 25 <segtitle>&diskspace;</segtitle> 26 27 <seglistitem> 28 <seg>0.1 SBU</seg> 29 <seg>3.8 MB</seg> 30 </seglistitem> 31 </segmentedlist> 32 33 <segmentedlist> 34 <segtitle>&dependencies;</segtitle> 35 36 <seglistitem> 37 <seg>Coreutils and Make</seg> 38 </seglistitem> 39 </segmentedlist> 40 41 </sect2> 42 43 <sect2 role="installation"> 44 <title>Installation of Udev</title> 45 46 <para>Compile the package:</para> 32 47 33 48 <screen><userinput>make EXTRAS=extras/run_directory</userinput></screen> 34 49 35 <para>The meaning of the make option:</para> 36 37 <variablelist> 38 <varlistentry> 39 <term><parameter>EXTRAS=extras/run_directory</parameter> 40 </term> 41 <listitem> 42 <para>This builds the <command>udev_run_devd</command> and 43 <command>udev_run_hotplugd</command> binaries, which are required for 44 correct handling of hotpluggable devices. 45 </para> 46 </listitem> 47 </varlistentry> 48 </variablelist> 49 50 <para>To test the results, issue: 51 <userinput>make test</userinput>.</para> 52 53 <para>Install the package:</para> 50 <variablelist> 51 <title>The meaning of the make option:</title> 52 53 <varlistentry> 54 <term><parameter>EXTRAS=extras/run_directory</parameter></term> 55 <listitem> 56 <para>This builds the <command>udev_run_devd</command> and 57 <command>udev_run_hotplugd</command> binaries, which are required 58 for correct handling of hotpluggable devices.</para> 59 </listitem> 60 </varlistentry> 61 62 </variablelist> 63 64 <para>To test the results, issue: 65 <userinput>make test</userinput>.</para> 66 67 <para>Install the package:</para> 54 68 55 69 <screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen> 56 70 57 <para>The meaning of the make option:</para> 58 59 <variablelist> 60 <varlistentry> 61 <term><parameter>DESTDIR=/</parameter> 62 </term> 63 <listitem> 64 <para>This prevents the Udev build process from killing any 65 <command>udevd</command> processes that may be running on the host 66 system. 67 </para> 68 </listitem> 69 </varlistentry> 70 </variablelist> 71 72 <para>Udev's configuration is far from ideal by default, so install 73 the configuration files here:</para> 71 <variablelist> 72 <title>The meaning of the make parameter:</title> 73 74 <varlistentry> 75 <term><parameter>DESTDIR=/</parameter></term> 76 <listitem> 77 <para>This prevents the Udev build process from killing any 78 <command>udevd</command> processes that may be running on the 79 host system.</para> 80 </listitem> 81 </varlistentry> 82 83 </variablelist> 84 85 <para>Udev's configuration is far from ideal by default, so install 86 the configuration files here:</para> 74 87 75 88 <screen><userinput>cp -v ../&udev-config-file; /etc/udev/rules.d/25-lfs.rules</userinput></screen> 76 89 77 <para>Install the documentation that explains how to create Udev rules:</para>90 <para>Install the documentation that explains how to create Udev rules:</para> 78 91 79 92 <screen><userinput>install -m644 -D -v docs/writing_udev_rules/index.html /usr/share/doc/udev-&udev-version;/index.html</userinput></screen> 80 93 81 <!-- Not for the LiveCD -->82 <!-- Edit Me -->83 <para>Run the <command>udevstart</command> program to create our full84 complement of device nodes.</para>94 <!-- Not for the LiveCD --> 95 <!-- Edit Me --> 96 <para>Run the <command>udevstart</command> program to create our full 97 complement of device nodes.</para> 85 98 86 99 <screen><userinput>/sbin/udevstart</userinput></screen> 87 100 88 </sect2> 89 90 <sect2 id="contents-udev" role="content"><title>Contents of Udev</title> 91 92 <segmentedlist> 93 <segtitle>Installed programs</segtitle> 94 <segtitle>Installed directory</segtitle> 95 <seglistitem><seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, 96 udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> 97 <seg>/etc/udev</seg></seglistitem> 98 </segmentedlist> 99 100 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> 101 <?dbfo list-presentation="list"?> 102 <?dbhtml list-presentation="table"?> 103 104 <varlistentry id="udev"> 105 <term><command>udev</command></term> 106 <listitem> 107 <para>Creates device nodes in <filename 108 class="directory">/dev</filename> or renames network interfaces (not 109 in LFS) in response to hotplug events</para> 110 <indexterm zone="ch-system-udev udev"><primary sortas="b-udev">udev</primary></indexterm> 111 </listitem></varlistentry> 112 113 <varlistentry id="udev_run_devd"> 114 <term><command>udev_run_devd</command></term> 115 <listitem> 116 <para>Executes programs and scripts in the 117 <filename class="directory">/etc/dev.d/</filename> directory in response 118 to hotplug events 119 </para> 120 <indexterm zone="ch-system-udev udev_run_devd"> 121 <primary sortas="b-udev_run_devd">udev_run_devd</primary> 122 </indexterm> 123 </listitem> 124 </varlistentry> 125 126 <varlistentry id="udev_run_hotplugd"> 127 <term><command>udev_run_hotplugd</command></term> 128 <listitem> 129 <para>Executes programs and scripts in the 130 <filename class="directory">/etc/hotplug.d/</filename> directory in 131 response to hotplug events 132 </para> 133 <indexterm zone="ch-system-udev udev_run_hotplugd"> 134 <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> 135 </indexterm> 136 </listitem> 137 </varlistentry> 138 139 <varlistentry id="udevcontrol"> 140 <term><command>udevcontrol</command></term> 141 <listitem> 142 <para>Configures a number of options for the running <command>udevd</command> 143 daemon, such as the log level.</para> 144 <indexterm zone="ch-system-udev udevcontrol"><primary sortas="b-udevcontrol">udevcontrol</primary> 145 </indexterm> 146 </listitem></varlistentry> 147 148 <varlistentry id="udevd"> 149 <term><command>udevd</command></term> 150 <listitem> 151 <para>A daemon that reorders hotplug events before submitting them to 152 <command>udev</command>, 153 thus avoiding various race conditions</para> 154 <indexterm zone="ch-system-udev udevd"><primary sortas="b-udevd">udevd</primary></indexterm> 155 </listitem></varlistentry> 156 157 <varlistentry id="udevinfo"> 158 <term><command>udevinfo</command></term> 159 <listitem> 160 <para>Allows users to query the <command>udev</command> database for 161 information on any device currently present on the system; it also 162 provides a way to query any device in the <systemitem 163 class="filesystem">sysfs</systemitem> tree to help create udev 164 rules</para> 165 <indexterm zone="ch-system-udev udevinfo"><primary sortas="b-udevinfo">udevinfo</primary></indexterm> 166 </listitem></varlistentry> 167 168 <varlistentry id="udevmonitor"> 169 <term><command>udevmonitor</command></term> 170 <listitem> 171 <para>Prints the event received from the kernel and the event which 172 <command>udev</command> sends out after rule processing</para> 173 <indexterm zone="ch-system-udev udevmonitor"><primary sortas="b-udevmonitor">udevmonitor</primary> 174 </indexterm> 175 </listitem></varlistentry> 176 177 <varlistentry id="udevsend"> 178 <term><command>udevsend</command></term> 179 <listitem> 180 <para>Delivers hotplug events to <command>udevd</command></para> 181 <indexterm zone="ch-system-udev udevsend"><primary sortas="b-udevsend">udevsend</primary></indexterm> 182 </listitem></varlistentry> 183 184 <varlistentry id="udevstart"> 185 <term><command>udevstart</command></term> 186 <listitem> 187 <para>Creates device nodes in <filename 188 class="directory">/dev</filename> that correspond to drivers compiled directly 189 into the kernel; it performs that task by simulating hotplug events presumably 190 dropped by the kernel before invocation of this program (e.g., because the root 191 filesystem has not been mounted) and submitting such synthetic hotplug events 192 to <command>udev</command></para> 193 <indexterm zone="ch-system-udev udevstart"><primary sortas="b-udevstart">udevstart</primary></indexterm> 194 </listitem> 195 </varlistentry> 196 197 <varlistentry id="udevtest"> 198 <term><command>udevtest</command></term> 199 <listitem> 200 <para>Simulates a <command>udev</command> run for the given device, 201 and prints out the name of the node the real <command>udev</command> would 202 have created or (not in LFS) the name of the renamed network interface</para> 203 <indexterm zone="ch-system-udev udevtest"><primary sortas="b-udevtest">udevtest</primary></indexterm> 204 </listitem></varlistentry> 205 206 <varlistentry id="etc-udev"> 207 <term><filename class="directory">/etc/udev</filename></term> 208 <listitem> 209 <para>Contains <command>udev</command> configuation files, 210 device permissions, and rules for device naming</para> 211 <indexterm zone="ch-system-udev etc-udev"><primary sortas="e-/etc/udev">/etc/udev</primary></indexterm> 212 </listitem></varlistentry> 213 </variablelist> 214 </sect2> 101 </sect2> 102 103 <sect2 id="contents-udev" role="content"> 104 <title>Contents of Udev</title> 105 106 <segmentedlist> 107 <segtitle>Installed programs</segtitle> 108 <segtitle>Installed directory</segtitle> 109 110 <seglistitem> 111 <seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, 112 udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> 113 <seg>/etc/udev</seg> 114 </seglistitem> 115 </segmentedlist> 116 117 <variablelist> 118 <bridgehead renderas="sect3">Short Descriptions</bridgehead> 119 <?dbfo list-presentation="list"?> 120 <?dbhtml list-presentation="table"?> 121 122 <varlistentry id="udev"> 123 <term><command>udev</command></term> 124 <listitem> 125 <para>Creates device nodes in <filename class="directory">/dev</filename> 126 or renames network interfaces (not in LFS) in response to hotplug 127 events</para> 128 <indexterm zone="ch-system-udev udev"> 129 <primary sortas="b-udev">udev</primary> 130 </indexterm> 131 </listitem> 132 </varlistentry> 133 134 <varlistentry id="udev_run_devd"> 135 <term><command>udev_run_devd</command></term> 136 <listitem> 137 <para>Executes programs and scripts in the <filename 138 class="directory">/etc/dev.d/</filename> directory in response to 139 hotplug events</para> 140 <indexterm zone="ch-system-udev udev_run_devd"> 141 <primary sortas="b-udev_run_devd">udev_run_devd</primary> 142 </indexterm> 143 </listitem> 144 </varlistentry> 145 146 <varlistentry id="udev_run_hotplugd"> 147 <term><command>udev_run_hotplugd</command></term> 148 <listitem> 149 <para>Executes programs and scripts in the <filename 150 class="directory">/etc/hotplug.d/</filename> directory in response 151 to hotplug events</para> 152 <indexterm zone="ch-system-udev udev_run_hotplugd"> 153 <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> 154 </indexterm> 155 </listitem> 156 </varlistentry> 157 158 <varlistentry id="udevcontrol"> 159 <term><command>udevcontrol</command></term> 160 <listitem> 161 <para>Configures a number of options for the running 162 <command>udevd</command> daemon, such as the log level.</para> 163 <indexterm zone="ch-system-udev udevcontrol"> 164 <primary sortas="b-udevcontrol">udevcontrol</primary> 165 </indexterm> 166 </listitem> 167 </varlistentry> 168 169 <varlistentry id="udevd"> 170 <term><command>udevd</command></term> 171 <listitem> 172 <para>A daemon that reorders hotplug events before submitting them to 173 <command>udev</command>, thus avoiding various race conditions</para> 174 <indexterm zone="ch-system-udev udevd"> 175 <primary sortas="b-udevd">udevd</primary> 176 </indexterm> 177 </listitem> 178 </varlistentry> 179 180 <varlistentry id="udevinfo"> 181 <term><command>udevinfo</command></term> 182 <listitem> 183 <para>Allows users to query the <command>udev</command> database for 184 information on any device currently present on the system; it also 185 provides a way to query any device in the <systemitem 186 class="filesystem">sysfs</systemitem> tree to help create udev 187 rules</para> 188 <indexterm zone="ch-system-udev udevinfo"> 189 <primary sortas="b-udevinfo">udevinfo</primary> 190 </indexterm> 191 </listitem> 192 </varlistentry> 193 194 <varlistentry id="udevmonitor"> 195 <term><command>udevmonitor</command></term> 196 <listitem> 197 <para>Prints the event received from the kernel and the event which 198 <command>udev</command> sends out after rule processing</para> 199 <indexterm zone="ch-system-udev udevmonitor"> 200 <primary sortas="b-udevmonitor">udevmonitor</primary> 201 </indexterm> 202 </listitem> 203 </varlistentry> 204 205 <varlistentry id="udevsend"> 206 <term><command>udevsend</command></term> 207 <listitem> 208 <para>Delivers hotplug events to <command>udevd</command></para> 209 <indexterm zone="ch-system-udev udevsend"> 210 <primary sortas="b-udevsend">udevsend</primary> 211 </indexterm> 212 </listitem> 213 </varlistentry> 214 215 <varlistentry id="udevstart"> 216 <term><command>udevstart</command></term> 217 <listitem> 218 <para>Creates device nodes in <filename class="directory">/dev</filename> 219 that correspond to drivers compiled directly into the kernel; it 220 performs that task by simulating hotplug events presumably dropped by 221 the kernel before invocation of this program (e.g., because the root 222 filesystem has not been mounted) and submitting such synthetic hotplug 223 events to <command>udev</command></para> 224 <indexterm zone="ch-system-udev udevstart"> 225 <primary sortas="b-udevstart">udevstart</primary> 226 </indexterm> 227 </listitem> 228 </varlistentry> 229 230 <varlistentry id="udevtest"> 231 <term><command>udevtest</command></term> 232 <listitem> 233 <para>Simulates a <command>udev</command> run for the given device, 234 and prints out the name of the node the real <command>udev</command> 235 would have created or (not in LFS) the name of the renamed network 236 interface</para> 237 <indexterm zone="ch-system-udev udevtest"> 238 <primary sortas="b-udevtest">udevtest</primary> 239 </indexterm> 240 </listitem> 241 </varlistentry> 242 243 <varlistentry id="etc-udev"> 244 <term><filename class="directory">/etc/udev</filename></term> 245 <listitem> 246 <para>Contains <command>udev</command> configuation files, 247 device permissions, and rules for device naming</para> 248 <indexterm zone="ch-system-udev etc-udev"> 249 <primary sortas="e-/etc/udev">/etc/udev</primary> 250 </indexterm> 251 </listitem> 252 </varlistentry> 253 254 </variablelist> 255 256 </sect2> 215 257 216 258 </sect1> 217
Note:
See TracChangeset
for help on using the changeset viewer.