Ignore:
File:
1 edited

Legend:

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

    ra988b8e r01b60c4  
    1313  <indexterm zone="ch-boot-eudev">
    1414    <primary sortas="a-Eudev">Eudev</primary>
     15    <secondary>boot</secondary>
    1516  </indexterm>
    1617
    17   <sect2 role="package">
    18     <title/>
    19 
    20     <para>The Eudev package contains programs for dynamic creation of device
    21     nodes.</para>
    22 
    23   </sect2>
     18  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
     19  href="../../final-system/common/eudev.xml"
     20  xpointer="xpointer(//*[@role='package'])"/>
    2421
    2522  <sect2 role="installation">
    2623    <title>Installation of Eudev</title>
    2724
    28    <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'])"/>
    2928
    3029<screen os="b"><userinput>BLKID_CFLAGS="-I/tools/include" BLKID_LIBS="-L/tools/lib -lblkid" \
    31     KMOD_CFLAGS="-I/tools/include/" KMOD_LIBS="-L/tools/lib -lkmod" \
    32     ./configure --prefix=/tools --build=${CLFS_HOST} --host=${CLFS_TARGET} \
    33     --disable-introspection --disable-gtk-doc-html \
     30KMOD_CFLAGS="-I/tools/include/" KMOD_LIBS="-L/tools/lib -lkmod" \
     31LDFLAGS="-Wl,-rpath,/tools/lib:/lib" ./configure --prefix=/usr \
     32    --build=${CLFS_HOST} --host=${CLFS_TARGET} \
     33    --with-rootprefix='' --enable-split-usr --sysconfdir=/etc \
     34    --libexecdir=/lib --bindir=/sbin --sbindir=/sbin --libdir=/usr/lib \
     35    --with-rootlibdir=/lib --disable-introspection --disable-gtk-doc-html \
    3436    --disable-gudev --disable-keymap --with-firmware-path=/lib/firmware \
    3537    --enable-libkmod</userinput></screen>
    3638
    37     <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'])"/>
    3842
    39 <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'])"/>
    4046
    41     <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'])"/>
    4250
    43 <screen os="j"><userinput>make install</userinput></screen>
     51<screen os="j"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
    4452
    45     <para os="i">Create a directory for storing firmware that can be
    46     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'])"/>
    4756
    48 <screen os="k"><userinput>install -dv /tools/lib/firmware</userinput></screen>
     57<screen os="k"><userinput>install -dv ${CLFS}/lib/firmware</userinput></screen>
    4958
    50     <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'])"/>
    5162
    52 <screen os="r2"><userinput>echo "# dummy, so that network is once again on eth*" > \
    53     /tools/etc/udev/rules.d/80-net-name-slot.rules</userinput></screen>
     63<screen os="r2"><userinput>echo "# dummy, so that network is once again on eth*" \
     64> ${CLFS}/etc/udev/rules.d/80-net-name-slot.rules</userinput></screen>
    5465
    5566 </sect2>
    5667
    57   <sect2 id="contents-eudev" role="content">
    58     <title>Contents of Eudev</title>
     68  <sect2 role="content">
     69    <title/>
    5970
    60     <segmentedlist>
    61       <segtitle>Installed programs</segtitle>
    62       <segtitle>Installed library</segtitle>
    63       <segtitle>Installed directories</segtitle>
    64 
    65       <seglistitem>
    66         <seg>ata_id, cdrom_id, collect, create_floppy_devices, edd_id,
    67         firmware.sh, fstab_import, path_id, scsi_id, udevadm, udevd, usb_id,
    68         v4l_id, write_cd_rules, write_net_rules</seg>
    69         <seg>libudev</seg>
    70         <seg>/tools/etc/udev, /tools/lib/firmware, /tools/lib/udev</seg>
    71       </seglistitem>
    72     </segmentedlist>
    73 
    74     <variablelist>
    75       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    76       <?dbfo list-presentation="list"?>
    77       <?dbhtml list-presentation="table"?>
    78 
    79       <varlistentry id="udevadm">
    80         <term><command>udevadm</command></term>
    81         <listitem>
    82         <para>Controls the runtime behavior of Eudev, requests kernel
    83         events, manages the event queue, and provides simple debugging.</para>
    84           <indexterm zone="ch-boot-eudev udevadm">
    85             <primary sortas="b-udevadm">udevadm</primary>
    86           </indexterm>
    87         </listitem>
    88       </varlistentry>
    89 
    90       <varlistentry id="udevd">
    91         <term><command>udevd</command></term>
    92         <listitem>
    93           <para>A daemon that reorders hotplug events before submitting them to
    94           <command>udev</command>,
    95           thus avoiding various race conditions</para>
    96           <indexterm zone="ch-boot-eudev udevd">
    97             <primary sortas="b-udevd">udevd</primary>
    98           </indexterm>
    99         </listitem>
    100       </varlistentry>
    101 
    102  <!-- Start of Helpers -->
    103       <varlistentry id="ata_id">
    104         <term><command>ata_id</command></term>
    105         <listitem>
    106           <para>Provides Eudev with a unique string and additional
    107           information (uuid, label) for an ATA drive</para>
    108           <indexterm zone="ch-boot-eudev ata_id">
    109             <primary sortas="b-ata_id">ata_id</primary>
    110           </indexterm>
    111         </listitem>
    112       </varlistentry>
    113 
    114       <varlistentry id="cdrom_id">
    115         <term><command>cdrom_id</command></term>
    116         <listitem>
    117           <para>Prints the capabilities of a CDROM or DVDROM drive.</para>
    118           <indexterm zone="ch-boot-eudev cdrom_id">
    119             <primary sortas="b-cdrom_id">cdrom_id</primary>
    120           </indexterm>
    121         </listitem>
    122       </varlistentry>
    123 
    124       <varlistentry id="collect">
    125         <term><command>collect</command></term>
    126         <listitem>
    127           <para>Given an ID for the current uevent and a list of IDs
    128 (for all target uevents), registers the current ID and indicates whether
    129 all target IDs have been registered.</para>
    130           <indexterm zone="ch-boot-eudev collect">
    131             <primary sortas="b-collect">collect</primary>
    132           </indexterm>
    133         </listitem>
    134       </varlistentry>
    135 
    136       <varlistentry id="create_floppy_devices">
    137         <term><command>create_floppy_devices</command></term>
    138         <listitem>
    139           <para>Creates all possible floppy devices based on the CMOS type</para>
    140           <indexterm zone="ch-boot-eudev create_floppy_devices">
    141             <primary sortas="b-create_floppy_devices">create_floppy_devices</primary>
    142           </indexterm>
    143         </listitem>
    144       </varlistentry>
    145 
    146       <varlistentry id="edd_id">
    147         <term><command>edd_id</command></term>
    148         <listitem>
    149           <para>Identifies x86 disk drives from Enhanced Disk Drive calls</para>
    150           <indexterm zone="ch-boot-eudev edd_id">
    151             <primary sortas="b-edd_id">edd_id</primary>
    152           </indexterm>
    153         </listitem>
    154       </varlistentry>
    155 
    156       <varlistentry id="firmware.sh">
    157         <term><command>firmware.sh</command></term>
    158         <listitem>
    159           <para>Script to load firmware for a device</para>
    160           <indexterm zone="ch-boot-eudev firmware.sh">
    161             <primary sortas="b-firmware.sh">firmware.sh</primary>
    162           </indexterm>
    163         </listitem>
    164       </varlistentry>
    165 
    166       <varlistentry id="fstab_import">
    167         <term><command>fstab_import</command></term>
    168         <listitem>
    169           <para>Finds an entry in <filename>/etc/fstab</filename> that matches
    170 the current device, and provides its information to Udev.</para>
    171           <indexterm zone="ch-boot-eudev fstab_import">
    172             <primary sortas="b-fstab_import">fstab_import</primary>
    173           </indexterm>
    174         </listitem>
    175       </varlistentry>
    176 
    177       <varlistentry id="path_id">
    178         <term><command>path_id</command></term>
    179         <listitem>
    180           <para>Provides the shortest possible unique hardware path to a
    181           device</para>
    182           <indexterm zone="ch-boot-eudev path_id">
    183             <primary sortas="b-path_id">path_id</primary>
    184           </indexterm>
    185         </listitem>
    186       </varlistentry>
    187 
    188       <varlistentry id="scsi_id">
    189         <term><command>scsi_id</command></term>
    190         <listitem>
    191           <para>Retrieves or generates a unique SCSI identifier.</para>
    192           <indexterm zone="ch-boot-eudev scsi_id">
    193             <primary sortas="b-scsi_id">scsi_id</primary>
    194           </indexterm>
    195         </listitem>
    196       </varlistentry>
    197 
    198       <varlistentry id="usb_id">
    199         <term><command>usb_id</command></term>
    200         <listitem>
    201           <para>Identifies a USB block device.</para>
    202           <indexterm zone="ch-boot-eudev usb_id">
    203             <primary sortas="b-usb_id">usb_id</primary>
    204           </indexterm>
    205         </listitem>
    206       </varlistentry>
    207 
    208       <varlistentry id="v4l_id">
    209         <term><command>v4l_id</command></term>
    210         <listitem>
    211           <para>Determines V4L capabilities for a given device.</para>
    212           <indexterm zone="ch-boot-eudev v4l_id">
    213             <primary sortas="b-v4l_id">v4l_id</primary>
    214           </indexterm>
    215         </listitem>
    216       </varlistentry>
    217 
    218       <varlistentry id="write_cd_rules">
    219         <term><command>write_cd_rules</command></term>
    220         <listitem>
    221           <para>A script which generates Eudev rules to provide stable names
    222 for network interfaces.</para>
    223           <indexterm zone="ch-boot-eudev write_cd_rules">
    224             <primary sortas="b-write_cd_rules">write_cd_rules</primary>
    225           </indexterm>
    226         </listitem>
    227       </varlistentry>
    228 
    229       <varlistentry id="write_net_rules">
    230         <term><command>write_net_rules</command></term>
    231         <listitem>
    232           <para>A script which generates Eudev rules to provide stable names
    233 for network interfaces.</para>
    234           <indexterm zone="ch-boot-eudev write_net_rules">
    235             <primary sortas="b-write_net_rules">write_net_rules</primary>
    236           </indexterm>
    237         </listitem>
    238       </varlistentry>
    239 <!-- End of Helpers -->
    240 
    241       <varlistentry id="libudev">
    242         <term><filename class="libraryfile">libudev</filename></term>
    243         <listitem>
    244           <para>A library interface to eudev device information.</para>
    245           <indexterm zone="ch-boot-eudev libudev">
    246             <primary sortas="c-libudev">libudev</primary>
    247           </indexterm>
    248         </listitem>
    249       </varlistentry>
    250 
    251       <varlistentry id="etc-eudev">
    252         <term><filename class="directory">/etc/udev</filename></term>
    253         <listitem>
    254           <para>Contains <command>udev</command> configuration files,
    255           device permissions, and rules for device naming</para>
    256           <indexterm zone="ch-boot-eudev etc-eudev">
    257             <primary sortas="e-/etc/udev">/etc/udev</primary>
    258           </indexterm>
    259         </listitem>
    260       </varlistentry>
    261 
    262       <varlistentry id="lib-eudev">
    263         <term><filename class="directory">/lib/udev</filename></term>
    264         <listitem>
    265           <para>Contains <command>udev</command> helper programs
    266           and static devices which get copied to /dev when booted.</para>
    267           <indexterm zone="ch-boot-eudev lib-eudev">
    268             <primary sortas="e-/lib/udev">/lib/udev</primary>
    269           </indexterm>
    270         </listitem>
    271       </varlistentry>
    272     </variablelist>
     71    <para>Details on this package are located in <xref
     72    linkend="contents-eudev" role="."/></para>
    27373
    27474  </sect2>
Note: See TracChangeset for help on using the changeset viewer.