diff options
author | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-10 19:05:30 +0000 |
---|---|---|
committer | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-10 19:05:30 +0000 |
commit | ddd554266cd757b9da553e430eeb408bf8bbc5c4 (patch) | |
tree | eadcaf24fd53730a285cddd18631dc26a39413f8 /chapter06/udev.xml | |
parent | 3f3931b0a87f6b5e217b5ffd8bbfcd758045f8c0 (diff) |
Finished the XML indentation plus few tags changes.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7369 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/udev.xml')
-rw-r--r-- | chapter06/udev.xml | 407 |
1 files changed, 224 insertions, 183 deletions
diff --git a/chapter06/udev.xml b/chapter06/udev.xml index 8b77b1b58..c53977ed2 100644 --- a/chapter06/udev.xml +++ b/chapter06/udev.xml @@ -1,217 +1,258 @@ <?xml version="1.0" encoding="ISO-8859-1"?> -<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ +<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY % general-entities SYSTEM "../general.ent"> %general-entities; ]> + <sect1 id="ch-system-udev" role="wrap"> -<title>Udev-&udev-version;</title> -<?dbhtml filename="udev.html"?> + <?dbhtml filename="udev.html"?> + + <title>Udev-&udev-version;</title> + + <indexterm zone="ch-system-udev"> + <primary sortas="a-Udev">Udev</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-udev"><primary sortas="a-Udev">Udev</primary></indexterm> + <para>The Udev package contains programs for dynamic creation of device + nodes.</para> -<sect2 role="package"><title/> -<para>The Udev package contains programs for dynamic creation of device nodes.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>3.8 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>3.8 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Coreutils and Make</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -</sect2> + <seglistitem> + <seg>Coreutils and Make</seg> + </seglistitem> + </segmentedlist> -<sect2 role="installation"> -<title>Installation of Udev</title> + </sect2> -<para>Compile the package:</para> + <sect2 role="installation"> + <title>Installation of Udev</title> + + <para>Compile the package:</para> <screen><userinput>make EXTRAS=extras/run_directory</userinput></screen> -<para>The meaning of the make option:</para> + <variablelist> + <title>The meaning of the make option:</title> + + <varlistentry> + <term><parameter>EXTRAS=extras/run_directory</parameter></term> + <listitem> + <para>This builds the <command>udev_run_devd</command> and + <command>udev_run_hotplugd</command> binaries, which are required + for correct handling of hotpluggable devices.</para> + </listitem> + </varlistentry> -<variablelist> - <varlistentry> - <term><parameter>EXTRAS=extras/run_directory</parameter> - </term> - <listitem> - <para>This builds the <command>udev_run_devd</command> and - <command>udev_run_hotplugd</command> binaries, which are required for - correct handling of hotpluggable devices. - </para> - </listitem> - </varlistentry> -</variablelist> + </variablelist> -<para>To test the results, issue: -<userinput>make test</userinput>.</para> + <para>To test the results, issue: + <userinput>make test</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen> -<para>The meaning of the make option:</para> + <variablelist> + <title>The meaning of the make parameter:</title> -<variablelist> - <varlistentry> - <term><parameter>DESTDIR=/</parameter> - </term> - <listitem> - <para>This prevents the Udev build process from killing any - <command>udevd</command> processes that may be running on the host - system. - </para> - </listitem> - </varlistentry> -</variablelist> + <varlistentry> + <term><parameter>DESTDIR=/</parameter></term> + <listitem> + <para>This prevents the Udev build process from killing any + <command>udevd</command> processes that may be running on the + host system.</para> + </listitem> + </varlistentry> -<para>Udev's configuration is far from ideal by default, so install -the configuration files here:</para> + </variablelist> + + <para>Udev's configuration is far from ideal by default, so install + the configuration files here:</para> <screen><userinput>cp -v ../&udev-config-file; /etc/udev/rules.d/25-lfs.rules</userinput></screen> -<para>Install the documentation that explains how to create Udev rules:</para> + <para>Install the documentation that explains how to create Udev rules:</para> <screen><userinput>install -m644 -D -v docs/writing_udev_rules/index.html /usr/share/doc/udev-&udev-version;/index.html</userinput></screen> -<!-- Not for the LiveCD --> -<!-- Edit Me --> -<para>Run the <command>udevstart</command> program to create our full -complement of device nodes.</para> + <!-- Not for the LiveCD --> + <!-- Edit Me --> + <para>Run the <command>udevstart</command> program to create our full + complement of device nodes.</para> <screen><userinput>/sbin/udevstart</userinput></screen> -</sect2> - -<sect2 id="contents-udev" role="content"><title>Contents of Udev</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<segtitle>Installed directory</segtitle> -<seglistitem><seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, -udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> -<seg>/etc/udev</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="udev"> -<term><command>udev</command></term> -<listitem> -<para>Creates device nodes in <filename -class="directory">/dev</filename> or renames network interfaces (not -in LFS) in response to hotplug events</para> -<indexterm zone="ch-system-udev udev"><primary sortas="b-udev">udev</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udev_run_devd"> - <term><command>udev_run_devd</command></term> - <listitem> - <para>Executes programs and scripts in the - <filename class="directory">/etc/dev.d/</filename> directory in response - to hotplug events - </para> - <indexterm zone="ch-system-udev udev_run_devd"> - <primary sortas="b-udev_run_devd">udev_run_devd</primary> - </indexterm> - </listitem> -</varlistentry> - -<varlistentry id="udev_run_hotplugd"> - <term><command>udev_run_hotplugd</command></term> - <listitem> - <para>Executes programs and scripts in the - <filename class="directory">/etc/hotplug.d/</filename> directory in - response to hotplug events - </para> - <indexterm zone="ch-system-udev udev_run_hotplugd"> - <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> - </indexterm> - </listitem> -</varlistentry> - -<varlistentry id="udevcontrol"> -<term><command>udevcontrol</command></term> -<listitem> -<para>Configures a number of options for the running <command>udevd</command> -daemon, such as the log level.</para> -<indexterm zone="ch-system-udev udevcontrol"><primary sortas="b-udevcontrol">udevcontrol</primary> -</indexterm> -</listitem></varlistentry> - -<varlistentry id="udevd"> -<term><command>udevd</command></term> -<listitem> -<para>A daemon that reorders hotplug events before submitting them to -<command>udev</command>, -thus avoiding various race conditions</para> -<indexterm zone="ch-system-udev udevd"><primary sortas="b-udevd">udevd</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevinfo"> -<term><command>udevinfo</command></term> -<listitem> -<para>Allows users to query the <command>udev</command> database for -information on any device currently present on the system; it also -provides a way to query any device in the <systemitem -class="filesystem">sysfs</systemitem> tree to help create udev -rules</para> -<indexterm zone="ch-system-udev udevinfo"><primary sortas="b-udevinfo">udevinfo</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevmonitor"> -<term><command>udevmonitor</command></term> -<listitem> -<para>Prints the event received from the kernel and the event which -<command>udev</command> sends out after rule processing</para> -<indexterm zone="ch-system-udev udevmonitor"><primary sortas="b-udevmonitor">udevmonitor</primary> -</indexterm> -</listitem></varlistentry> - -<varlistentry id="udevsend"> -<term><command>udevsend</command></term> -<listitem> -<para>Delivers hotplug events to <command>udevd</command></para> -<indexterm zone="ch-system-udev udevsend"><primary sortas="b-udevsend">udevsend</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevstart"> -<term><command>udevstart</command></term> -<listitem> -<para>Creates device nodes in <filename -class="directory">/dev</filename> that correspond to drivers compiled directly -into the kernel; it performs that task by simulating hotplug events presumably -dropped by the kernel before invocation of this program (e.g., because the root -filesystem has not been mounted) and submitting such synthetic hotplug events -to <command>udev</command></para> -<indexterm zone="ch-system-udev udevstart"><primary sortas="b-udevstart">udevstart</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="udevtest"> -<term><command>udevtest</command></term> -<listitem> -<para>Simulates a <command>udev</command> run for the given device, -and prints out the name of the node the real <command>udev</command> would -have created or (not in LFS) the name of the renamed network interface</para> -<indexterm zone="ch-system-udev udevtest"><primary sortas="b-udevtest">udevtest</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="etc-udev"> -<term><filename class="directory">/etc/udev</filename></term> -<listitem> -<para>Contains <command>udev</command> configuation files, -device permissions, and rules for device naming</para> -<indexterm zone="ch-system-udev etc-udev"><primary sortas="e-/etc/udev">/etc/udev</primary></indexterm> -</listitem></varlistentry> -</variablelist> -</sect2> + </sect2> + + <sect2 id="contents-udev" role="content"> + <title>Contents of Udev</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + <segtitle>Installed directory</segtitle> + + <seglistitem> + <seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, + udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> + <seg>/etc/udev</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="udev"> + <term><command>udev</command></term> + <listitem> + <para>Creates device nodes in <filename class="directory">/dev</filename> + or renames network interfaces (not in LFS) in response to hotplug + events</para> + <indexterm zone="ch-system-udev udev"> + <primary sortas="b-udev">udev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udev_run_devd"> + <term><command>udev_run_devd</command></term> + <listitem> + <para>Executes programs and scripts in the <filename + class="directory">/etc/dev.d/</filename> directory in response to + hotplug events</para> + <indexterm zone="ch-system-udev udev_run_devd"> + <primary sortas="b-udev_run_devd">udev_run_devd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udev_run_hotplugd"> + <term><command>udev_run_hotplugd</command></term> + <listitem> + <para>Executes programs and scripts in the <filename + class="directory">/etc/hotplug.d/</filename> directory in response + to hotplug events</para> + <indexterm zone="ch-system-udev udev_run_hotplugd"> + <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevcontrol"> + <term><command>udevcontrol</command></term> + <listitem> + <para>Configures a number of options for the running + <command>udevd</command> daemon, such as the log level.</para> + <indexterm zone="ch-system-udev udevcontrol"> + <primary sortas="b-udevcontrol">udevcontrol</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevd"> + <term><command>udevd</command></term> + <listitem> + <para>A daemon that reorders hotplug events before submitting them to + <command>udev</command>, thus avoiding various race conditions</para> + <indexterm zone="ch-system-udev udevd"> + <primary sortas="b-udevd">udevd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevinfo"> + <term><command>udevinfo</command></term> + <listitem> + <para>Allows users to query the <command>udev</command> database for + information on any device currently present on the system; it also + provides a way to query any device in the <systemitem + class="filesystem">sysfs</systemitem> tree to help create udev + rules</para> + <indexterm zone="ch-system-udev udevinfo"> + <primary sortas="b-udevinfo">udevinfo</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevmonitor"> + <term><command>udevmonitor</command></term> + <listitem> + <para>Prints the event received from the kernel and the event which + <command>udev</command> sends out after rule processing</para> + <indexterm zone="ch-system-udev udevmonitor"> + <primary sortas="b-udevmonitor">udevmonitor</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevsend"> + <term><command>udevsend</command></term> + <listitem> + <para>Delivers hotplug events to <command>udevd</command></para> + <indexterm zone="ch-system-udev udevsend"> + <primary sortas="b-udevsend">udevsend</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevstart"> + <term><command>udevstart</command></term> + <listitem> + <para>Creates device nodes in <filename class="directory">/dev</filename> + that correspond to drivers compiled directly into the kernel; it + performs that task by simulating hotplug events presumably dropped by + the kernel before invocation of this program (e.g., because the root + filesystem has not been mounted) and submitting such synthetic hotplug + events to <command>udev</command></para> + <indexterm zone="ch-system-udev udevstart"> + <primary sortas="b-udevstart">udevstart</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevtest"> + <term><command>udevtest</command></term> + <listitem> + <para>Simulates a <command>udev</command> run for the given device, + and prints out the name of the node the real <command>udev</command> + would have created or (not in LFS) the name of the renamed network + interface</para> + <indexterm zone="ch-system-udev udevtest"> + <primary sortas="b-udevtest">udevtest</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="etc-udev"> + <term><filename class="directory">/etc/udev</filename></term> + <listitem> + <para>Contains <command>udev</command> configuation files, + device permissions, and rules for device naming</para> + <indexterm zone="ch-system-udev etc-udev"> + <primary sortas="e-/etc/udev">/etc/udev</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |