Changeset e02afe0 for chapter06/udev.xml


Ignore:
Timestamp:
02/10/2006 07:38:49 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Children:
851829a
Parents:
529c103
Message:

Poerted r7369 from trunk to alphabetical branch.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/alphabetical/BOOK@7371 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/udev.xml

    r529c103 re02afe0  
    11<?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" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<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, GCC, Make, and Perl</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, GCC, Make, and Perl</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>
    3247
    3348<screen><userinput>make EXTRAS=extras/run_directory</userinput></screen>
    3449
    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>
    5468
    5569<screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen>
    5670
    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>
    7487
    7588<screen><userinput>cp -v ../&udev-config-file; /etc/udev/rules.d/25-lfs.rules</userinput></screen>
    7689
    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>
    7891
    7992<screen><userinput>install -m644 -D -v docs/writing_udev_rules/index.html /usr/share/doc/udev-&udev-version;/index.html</userinput></screen>
    8093
    81 <!-- Not for the LiveCD -->
    82 <!-- Edit Me -->
    83 <para>Run the <command>udevstart</command> program to create our full
    84 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>
    8598
    8699<screen><userinput>/sbin/udevstart</userinput></screen>
    87100
    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>
    215257
    216258</sect1>
    217 
Note: See TracChangeset for help on using the changeset viewer.