Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed
  • BOOK/boot/common/eudev.xml

    rdafa360 r01b60c4  
    1616  </indexterm>
    1717
    18   <sect2 role="package">
    19     <title/>
    20 
    21     <para>The Eudev package contains programs for dynamic creation of device
    22     nodes.</para>
    23 
    24   </sect2>
     18  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     19  href="../../final-system/common/eudev.xml"
     20  xpointer="xpointer(//*[@role='package'])"/>
    2521
    2622  <sect2 role="installation">
    2723    <title>Installation of Eudev</title>
    2824
    29    <para os="a">Prepare Eudev for compilation:</para>
     25    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     26    href="../../final-system/common/eudev.xml"
     27    xpointer="xpointer(//*[@os='a'])"/>
    3028
    3129<screen os="b"><userinput>BLKID_CFLAGS="-I/tools/include" BLKID_LIBS="-L/tools/lib -lblkid" \
     
    3937    --enable-libkmod</userinput></screen>
    4038
    41     <para os="c">Compile the package:</para>
     39    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     40    href="../../final-system/common/eudev.xml"
     41    xpointer="xpointer(//*[@os='c'])"/>
    4242
    43 <screen os="d"><userinput>make</userinput></screen>
     43    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     44    href="../../final-system/common/eudev.xml"
     45    xpointer="xpointer(//*[@os='d'])"/>
    4446
    45     <para os="g">Install the package:</para>
     47    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     48    href="../../final-system/common/eudev.xml"
     49    xpointer="xpointer(//*[@os='g'])"/>
    4650
    4751<screen os="j"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
    4852
    49     <para os="i">Create a directory for storing firmware that can be
    50     loaded by <command>udev</command>:</para>
     53    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     54    href="../../final-system/common/eudev.xml"
     55    xpointer="xpointer(//*[@os='i'])"/>
    5156
    5257<screen os="k"><userinput>install -dv ${CLFS}/lib/firmware</userinput></screen>
    5358
    54     <para os="r1">Create a dummy rule so that Eudev will name ethernet devices properly for the system.</para>
     59    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     60    href="../../final-system/common/eudev.xml"
     61    xpointer="xpointer(//*[@os='r1'])"/>
    5562
    5663<screen os="r2"><userinput>echo "# dummy, so that network is once again on eth*" \
     
    5966 </sect2>
    6067
    61   <sect2 id="contents-eudev" role="content">
    62     <title>Contents of Eudev</title>
     68  <sect2 role="content">
     69    <title/>
    6370
    64     <segmentedlist>
    65       <segtitle>Installed programs</segtitle>
    66       <segtitle>Installed library</segtitle>
    67       <segtitle>Installed directories</segtitle>
    68 
    69       <seglistitem>
    70         <seg>ata_id, cdrom_id, collect, create_floppy_devices, edd_id,
    71         firmware.sh, fstab_import, path_id, scsi_id, udevadm, udevd, usb_id,
    72         v4l_id, write_cd_rules, write_net_rules</seg>
    73         <seg>libudev</seg>
    74         <seg>/etc/udev, /lib/firmware, /lib/udev, /usr/share/doc/udev</seg>
    75       </seglistitem>
    76     </segmentedlist>
    77 
    78     <variablelist>
    79       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    80       <?dbfo list-presentation="list"?>
    81       <?dbhtml list-presentation="table"?>
    82 
    83       <varlistentry id="udevadm">
    84         <term><command>udevadm</command></term>
    85         <listitem>
    86         <para>Controls the runtime behavior of Eudev, requests kernel
    87         events, manages the event queue, and provides simple debugging.</para>
    88           <indexterm zone="ch-boot-eudev udevadm">
    89             <primary sortas="b-udevadm">udevadm</primary>
    90           </indexterm>
    91         </listitem>
    92       </varlistentry>
    93 
    94       <varlistentry id="udevd">
    95         <term><command>udevd</command></term>
    96         <listitem>
    97           <para>A daemon that reorders hotplug events before submitting them to
    98           <command>udev</command>,
    99           thus avoiding various race conditions</para>
    100           <indexterm zone="ch-boot-eudev udevd">
    101             <primary sortas="b-udevd">udevd</primary>
    102           </indexterm>
    103         </listitem>
    104       </varlistentry>
    105 
    106  <!-- Start of Helpers -->
    107       <varlistentry id="ata_id">
    108         <term><command>ata_id</command></term>
    109         <listitem>
    110           <para>Provides Eudev with a unique string and additional
    111           information (uuid, label) for an ATA drive</para>
    112           <indexterm zone="ch-boot-eudev ata_id">
    113             <primary sortas="b-ata_id">ata_id</primary>
    114           </indexterm>
    115         </listitem>
    116       </varlistentry>
    117 
    118       <varlistentry id="cdrom_id">
    119         <term><command>cdrom_id</command></term>
    120         <listitem>
    121           <para>Prints the capabilities of a CDROM or DVDROM drive.</para>
    122           <indexterm zone="ch-boot-eudev cdrom_id">
    123             <primary sortas="b-cdrom_id">cdrom_id</primary>
    124           </indexterm>
    125         </listitem>
    126       </varlistentry>
    127 
    128       <varlistentry id="collect">
    129         <term><command>collect</command></term>
    130         <listitem>
    131           <para>Given an ID for the current uevent and a list of IDs
    132 (for all target uevents), registers the current ID and indicates whether
    133 all target IDs have been registered.</para>
    134           <indexterm zone="ch-boot-eudev collect">
    135             <primary sortas="b-collect">collect</primary>
    136           </indexterm>
    137         </listitem>
    138       </varlistentry>
    139 
    140       <varlistentry id="create_floppy_devices">
    141         <term><command>create_floppy_devices</command></term>
    142         <listitem>
    143           <para>Creates all possible floppy devices based on the CMOS type</para>
    144           <indexterm zone="ch-boot-eudev create_floppy_devices">
    145             <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
    146           </indexterm>
    147         </listitem>
    148       </varlistentry>
    149 
    150       <varlistentry id="edd_id">
    151         <term><command>edd_id</command></term>
    152         <listitem>
    153           <para>Identifies x86 disk drives from Enhanced Disk Drive calls</para>
    154           <indexterm zone="ch-boot-eudev edd_id">
    155             <primary sortas="b-edd_id">edd_id</primary>
    156           </indexterm>
    157         </listitem>
    158       </varlistentry>
    159 
    160       <varlistentry id="firmware.sh">
    161         <term><command>firmware.sh</command></term>
    162         <listitem>
    163           <para>Script to load firmware for a device</para>
    164           <indexterm zone="ch-boot-eudev firmware.sh">
    165             <primary sortas="b-firmware.sh">firmware.sh</primary>
    166           </indexterm>
    167         </listitem>
    168       </varlistentry>
    169 
    170       <varlistentry id="fstab_import">
    171         <term><command>fstab_import</command></term>
    172         <listitem>
    173           <para>Finds an entry in <filename>/etc/fstab</filename> that matches
    174 the current device, and provides its information to Udev.</para>
    175           <indexterm zone="ch-boot-eudev fstab_import">
    176             <primary sortas="b-fstab_import">fstab_import</primary>
    177           </indexterm>
    178         </listitem>
    179       </varlistentry>
    180 
    181       <varlistentry id="path_id">
    182         <term><command>path_id</command></term>
    183         <listitem>
    184           <para>Provides the shortest possible unique hardware path to a
    185           device</para>
    186           <indexterm zone="ch-boot-eudev path_id">
    187             <primary sortas="b-path_id">path_id</primary>
    188           </indexterm>
    189         </listitem>
    190       </varlistentry>
    191 
    192       <varlistentry id="scsi_id">
    193         <term><command>scsi_id</command></term>
    194         <listitem>
    195           <para>Retrieves or generates a unique SCSI identifier.</para>
    196           <indexterm zone="ch-boot-eudev scsi_id">
    197             <primary sortas="b-scsi_id">scsi_id</primary>
    198           </indexterm>
    199         </listitem>
    200       </varlistentry>
    201 
    202       <varlistentry id="usb_id">
    203         <term><command>usb_id</command></term>
    204         <listitem>
    205           <para>Identifies a USB block device.</para>
    206           <indexterm zone="ch-boot-eudev usb_id">
    207             <primary sortas="b-usb_id">usb_id</primary>
    208           </indexterm>
    209         </listitem>
    210       </varlistentry>
    211 
    212       <varlistentry id="v4l_id">
    213         <term><command>v4l_id</command></term>
    214         <listitem>
    215           <para>Determines V4L capabilities for a given device.</para>
    216           <indexterm zone="ch-boot-eudev v4l_id">
    217             <primary sortas="b-v4l_id">v4l_id</primary>
    218           </indexterm>
    219         </listitem>
    220       </varlistentry>
    221 
    222       <varlistentry id="write_cd_rules">
    223         <term><command>write_cd_rules</command></term>
    224         <listitem>
    225           <para>A script which generates Eudev rules to provide stable names
    226 for network interfaces.</para>
    227           <indexterm zone="ch-boot-eudev write_cd_rules">
    228             <primary sortas="b-write_cd_rules">write_cd_rules</primary>
    229           </indexterm>
    230         </listitem>
    231       </varlistentry>
    232 
    233       <varlistentry id="write_net_rules">
    234         <term><command>write_net_rules</command></term>
    235         <listitem>
    236           <para>A script which generates Eudev rules to provide stable names
    237 for network interfaces.</para>
    238           <indexterm zone="ch-boot-eudev write_net_rules">
    239             <primary sortas="b-write_net_rules">write_net_rules</primary>
    240           </indexterm>
    241         </listitem>
    242       </varlistentry>
    243 <!-- End of Helpers -->
    244 
    245       <varlistentry id="libudev">
    246         <term><filename class="libraryfile">libudev</filename></term>
    247         <listitem>
    248           <para>A library interface to eudev device information.</para>
    249           <indexterm zone="ch-boot-eudev libudev">
    250             <primary sortas="c-libudev">libudev</primary>
    251           </indexterm>
    252         </listitem>
    253       </varlistentry>
    254 
    255       <varlistentry id="etc-eudev">
    256         <term><filename class="directory">/etc/udev</filename></term>
    257         <listitem>
    258           <para>Contains <command>udev</command> configuration files,
    259           device permissions, and rules for device naming</para>
    260           <indexterm zone="ch-boot-eudev etc-eudev">
    261             <primary sortas="e-/etc/udev">/etc/udev</primary>
    262           </indexterm>
    263         </listitem>
    264       </varlistentry>
    265 
    266       <varlistentry id="lib-eudev">
    267         <term><filename class="directory">/lib/udev</filename></term>
    268         <listitem>
    269           <para>Contains <command>udev</command> helper programs
    270           and static devices which get copied to /dev when booted.</para>
    271           <indexterm zone="ch-boot-eudev lib-eudev">
    272             <primary sortas="e-/lib/udev">/lib/udev</primary>
    273           </indexterm>
    274         </listitem>
    275       </varlistentry>
    276     </variablelist>
     71    <para>Details on this package are located in <xref
     72    linkend="contents-eudev" role="."/></para>
    27773
    27874  </sect2>
Note: See TracChangeset for help on using the changeset viewer.