Changeset 82fc053 for BOOK/bootscripts/common

Timestamp:

May 14, 2014, 1:21:04 AM (11 years ago)

Author:

Chris Staub <chris@…>

Branches:

clfs-3.0.0-sysvinit, sysvinit

Children:

056e32f4

Parents:

db71344

Message:

Created sysvinit branch

Location:

BOOK/bootscripts/common

Files:

• bootscripts.xml (added)
• console.xml (added)
• eudev.xml (moved) (moved from BOOK/system-config/common/udev.xml ) (15 diffs)
• inputrc.xml (moved) (moved from BOOK/system-config/common/inputrc.xml )
• introduction.xml (added)
• locale.xml (moved) (moved from BOOK/system-config/common/locale.xml ) (5 diffs)
• profile.xml (moved) (moved from BOOK/system-config/common/profile.xml ) (1 diff)
• setclock.xml (added)
• symlinks.xml (moved) (moved from BOOK/system-config/common/symlinks.xml ) (3 diffs)
• usage.xml (added)

BOOK/bootscripts/common/eudev.xml

@@ -6 +6 @@
 ]>
 
-<sect1 id="ch-scripts-udev">
-  <?dbhtml filename="udev.html"?>
+<sect1 id="ch-scripts-eudev">
+  <?dbhtml filename="eudev.html"?>
 
   <title>Device and Module Handling on a CLFS System</title>
 
-  <indexterm zone="ch-scripts-udev">
-    <primary sortas="a-systemd">Systemd</primary>
-    <secondary>udev usage</secondary>
+  <indexterm zone="ch-scripts-eudev">
+    <primary sortas="a-Eudev">Eudev</primary>
+    <secondary>usage</secondary>
   </indexterm>
 
-  <para>In <xref linkend="chapter-building-system"/>, we installed systemd,
-  which contains systemd-udevd, previously known as Udev. Before we go into
-  the details regarding how this works, a brief history of previous methods of
-  handling devices is in order.</para>
+  <para>In <xref linkend="chapter-building-system"/>, we installed the Eudev
+  package. Before we go into the details regarding how this works,
+  a brief history of previous methods of handling devices is in
+  order.</para>
 
   <para>Linux systems in general traditionally use a static device creation
@@ -30 +30 @@
   the world.</para>
 
-  <para>Using the Udev method, only those devices which are detected by the
+  <para>Using the Eudev method, only those devices which are detected by the
   kernel get device nodes created for them. Because these device nodes will be
   created each time the system boots, they will be stored on a <systemitem
@@ -71 +71 @@
 
   <sect2>
-    <title>Udev Implementation</title>
+    <title>Eudev Implementation</title>
 
     <sect3>
@@ -93 +93 @@
 
     <sect3>
+      <title>Eudev Bootscript</title>
+
+      <para>The <command>S10udev</command> initscript takes care of creating
+      device nodes when Linux is booted. The script unsets the uevent handler
+      from the default of <command>/sbin/hotplug</command>.  This is done
+      because the kernel no longer needs to call out to an external binary.
+      Instead <command>udevd</command> will listen on a netlink socket for
+      uevents that the kernel raises. Next, the bootscript copies any static
+      device nodes that exist in <filename
+      class="directory">/lib/udev/devices</filename> to <filename
+      class="directory">/dev</filename>. This is necessary because some devices,
+      directories, and symlinks are needed before the dynamic device handling
+      processes are available during the early stages of booting a system.
+      Creating static device nodes in <filename
+      class="directory">/lib/udev/devices</filename> also provides an easy
+      workaround for devices that are not supported by the dynamic device
+      handling infrastructure. The bootscript then starts the Eudev daemon,
+      <command>udevd</command>, which will act on any uevents it receives.
+      Finally, the bootscript forces the kernel to replay uevents for any
+      devices that have already been registered and then waits for
+      <command>udevd</command> to handle them.</para>
+
+    </sect3>
+
+    <sect3>
       <title>Device Node Creation</title>
 
-      <para>To obtain the right major and minor number for a device, Udev relies
+      <para>To obtain the right major and minor number for a device, Eudev relies
       on the information provided by <systemitem
       class="filesystem">sysfs</systemitem> in <filename
@@ -104 +129 @@
       <emphasis>0</emphasis>. The names and permissions of the nodes created
       under the <filename class="directory">/dev</filename> directory are
-      determined by rules specified in the files within the
-      <filename class="directory">/lib/udev/rules.d</filename> and <filename
-      class="directory">/etc/udev/rules.d/</filename> directories. These files
-      have names that start with numbers, and are evaluated in numerical order.
-      If <command>udevd</command> can't find a rule for the device it is
-      creating, it will default permissions to <emphasis>660</emphasis> and
-      ownership to <emphasis>root:root</emphasis>. </para>
+      determined by rules specified in the files within the <filename
+      class="directory">/etc/udev/rules.d/</filename> directory. These are
+      numbered in a similar fashion to the CLFS-Bootscripts package. If
+      <command>udevd</command> can't find a rule for the device it is creating,
+      it will default permissions to <emphasis>660</emphasis> and ownership to
+      <emphasis>root:root</emphasis>. Documentation on the syntax of the Eudev
+      rules configuration files is available in
+      <filename>/usr/share/doc/udev/writing_udev_rules/index.html</filename></para>
 
     </sect3>
@@ -129 +155 @@
       might contain the string
       <quote>pci:v00001319d00000801sv00001319sd00001319bc04sc01i00</quote>.
-      The default rules provided by Udev will cause <command>udevd</command>
+      The default rules provided by Eudev will cause <command>udevd</command>
       to call out to <command>/sbin/modprobe</command> with the contents of the
       <envar>MODALIAS</envar> uevent environment variable (that should be the
@@ -168 +194 @@
       <title>A kernel module is not loaded automatically</title>
 
-      <para>Udev will only load a module if it has a bus-specific alias and the
+      <para>Eudev will only load a module if it has a bus-specific alias and the
       bus driver properly exports the necessary aliases to <systemitem
       class="filesystem">sysfs</systemitem>. In other cases, one should
-      arrange module loading by other means. With Linux-&linux-version;, Udev is
+      arrange module loading by other means. With Linux-&linux-version;, Eudev is
       known to load properly-written drivers for INPUT, IDE, PCI, USB, SCSI,
       SERIO and FireWire devices.</para>
 
       <para>To determine if the device driver you require has the necessary
-      support for Udev, run <command>modinfo</command> with the module name as
+      support for Eudev, run <command>modinfo</command> with the module name as
       the argument.  Now try locating the device directory under
       <filename class="directory">/sys/bus</filename> and check whether there is
@@ -184 +210 @@
       class="filesystem">sysfs</systemitem>, the driver supports the device and
       can talk to it directly, but doesn't have the alias, it is a bug in the
-      driver. Load the driver without the help from Udev and expect the issue
+      driver. Load the driver without the help from Eudev and expect the issue
       to be fixed later.</para>
 
@@ -193 +219 @@
       busses. Expect this issue to be fixed in later kernel versions.</para>
 
-      <para>Udev is not intended to load <quote>wrapper</quote> drivers such as
+      <para>Eudev is not intended to load <quote>wrapper</quote> drivers such as
       <emphasis>snd-pcm-oss</emphasis> and non-hardware drivers such as
       <emphasis>loop</emphasis> at all.</para>
@@ -200 +226 @@
 
     <sect3>
-      <title>A kernel module is not loaded automatically, and Udev is not
+      <title>A kernel module is not loaded automatically, and Eudev is not
       intended to load it</title>
 
@@ -207 +233 @@
       enhances the functionality of <emphasis>snd-pcm</emphasis> by making the
       sound cards available to OSS applications), configure
-      <command>modprobe</command> to load the wrapper after Udev loads the
-      wrapped module. To do this, add an <quote>install</quote> line to a file
-      in <filename>/etc/modprobe.d</filename>. For example:</para>
+      <command>modprobe</command> to load the wrapper after Eudev loads the
+      wrapped module. To do this, add an <quote>install</quote> line in
+      <filename>/etc/modprobe.conf</filename>. For example:</para>
 
 <screen role="nodump"><literal>install snd-pcm /sbin/modprobe -i snd-pcm ; \
     /sbin/modprobe snd-pcm-oss ; true</literal></screen>
 
-    </sect3>
-
-    <sect3>
-      <title>Udev loads some unwanted module</title>
+      <para>If the module in question is not a wrapper and is useful by itself,
+      configure the <command>S05modules</command> bootscript to load this
+      module on system boot. To do this, add the module name to the
+      <filename>/etc/sysconfig/modules</filename> file on a separate line.
+      This works for wrapper modules too, but is suboptimal in that case.</para>
+
+    </sect3>
+
+    <sect3>
+      <title>Eudev loads some unwanted module</title>
 
       <para>Either don't build the module, or blacklist it in
-      <filename>/etc/modprobe.d</filename> file as done with the
+      <filename>/etc/modprobe.conf</filename> file as done with the
       <emphasis>forte</emphasis> module in the example below:</para>
 
@@ -231 +263 @@
 
     <sect3>
-      <title>Udev creates a device incorrectly, or makes a wrong symlink</title>
+      <title>Eudev creates a device incorrectly, or makes a wrong symlink</title>
 
       <para>This usually happens if a rule unexpectedly matches a device. For
@@ -242 +274 @@
 
     <sect3>
-      <title>Udev rule works unreliably</title>
+      <title>Eudev rule works unreliably</title>
 
       <para>This may be another manifestation of the previous problem. If not,
@@ -256 +288 @@
 
     <sect3>
-      <title>Udev does not create a device</title>
+      <title>Eudev does not create a device</title>
 
       <para>Further text assumes that the driver is built statically into the
       kernel or already loaded as a module, and that you have already checked
-      that Udev doesn't create a misnamed device.</para>
-
-      <para>Udev has no information needed to create a device node if a kernel
+      that Eudev doesn't create a misnamed device.</para>
+
+      <para>Eudev has no information needed to create a device node if a kernel
       driver does not export its data to <systemitem
       class="filesystem">sysfs</systemitem>.
@@ -279 +311 @@
       <title>Device naming order changes randomly after rebooting</title>
 
-      <para>This is due to the fact that Udev, by design, handles uevents and
+      <para>This is due to the fact that Eudev, by design, handles uevents and
       loads modules in parallel, and thus in an unpredictable order. This will
       never be <quote>fixed</quote>. You should not rely upon the kernel device
       names being stable. Instead, create your own rules that make symlinks with
       stable names based on some stable attributes of the device, such as a
-      serial number or the output of various *_id utilities installed by Udev.
+      serial number or the output of various *_id utilities installed by Eudev.
       See <xref linkend="ch-scripts-symlinks"/> and
       <xref linkend="chapter-network"/> for examples.</para>

BOOK/bootscripts/common/locale.xml

@@ -11 +11 @@
 
   <indexterm zone="ch-scripts-locale">
-    <primary sortas="e-/etc/locale.conf">/etc/locale.conf</primary>
+    <primary sortas="e-/etc/profile">/etc/profile</primary>
   </indexterm>
 
-  <para>The <filename>/etc/locale.conf</filename> below sets some environment
-  variables necessary for native language support. Setting them properly
-  results in:</para>
+  <para>The base <filename>/etc/profile</filename> below sets some
+  environment variables necessary for native language support. Setting
+  them properly results in:</para>
 
   <itemizedlist>
@@ -23 +23 @@
     </listitem>
     <listitem>
-      <para>Correct classification of characters into letters, digits and other
-      classes. This is necessary for <command>bash</command> to properly accept
-      non-ASCII characters in command lines in non-English locales</para>
+      <para>Correct classification of characters into letters, digits and
+      other classes. This is necessary for <command>bash</command> to
+      properly accept non-ASCII characters in command lines in non-English
+      locales</para>
     </listitem>
     <listitem>
@@ -38 +39 @@
   </itemizedlist>
 
+  <para>This script also sets the <envar>INPUTRC</envar> environment variable
+  that makes Bash and Readline use the <filename>/etc/inputrc</filename> file
+  created earlier.</para>
+
   <para>Replace <replaceable>[ll]</replaceable> below with the
   two-letter code for the desired language (e.g., <quote>en</quote>) and
   <replaceable>[CC]</replaceable> with the two-letter code for the
-  appropriate country (e.g., <quote>GB</quote> or <quote>US</quote>).
+  appropriate country (e.g., <quote>GB</quote>).
   <replaceable>[charmap]</replaceable> should be replaced with the
-  canonical charmap for your chosen locale. Optional modifiers such as
-  <quote>@euro</quote> may also be present.</para>
+  canonical charmap for your chosen locale.</para>
 
   <para>The list of all locales supported by Glibc can be obtained by running
@@ -67 +71 @@
 
   <para>This results in a final locale setting of <quote>en_US.UTF-8</quote>.
-  It is important that the locale found using the heuristic above is tested
-  prior to it being added to <filename>/etc/locale.conf</filename>:</para>
+  It is important that the locale found using the heuristic above is tested prior
+  to it being added to the Bash startup files:</para>
 
-<screen role="nodump"><userinput>LC_ALL=[locale name] locale territory
+<screen role="nodump"><userinput>LC_ALL=[locale name] locale territory 
 LC_ALL=[locale name] locale language
 LC_ALL=[locale name] locale charmap
@@ -104 +108 @@
 
   <para>Other packages can also function incorrectly (but may not necessarily
-  display any error messages) if the locale name does not meet their
-  expectations. In those cases, investigating how other Linux distributions
-  support your locale might provide some useful information.</para>
+  display any error messages) if the locale name does not meet their expectations.
+  In those cases, investigating how other Linux distributions support your locale
+  might provide some useful information.</para>
 
   <para>Once the proper locale settings have been determined, create the
-  <filename>/etc/locale.conf</filename> file:</para>
+  <filename>/etc/profile</filename> file:</para>
 
-<screen><userinput>cat &gt; /etc/locale.conf &lt;&lt; "EOF"
-<literal># Begin /etc/locale.conf
+<screen><userinput>cat &gt; /etc/profile &lt;&lt; "EOF"
+<literal># Begin /etc/profile
 
-LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable><replaceable>[@modifiers]</replaceable>
+export LANG=<replaceable>[ll]</replaceable>_<replaceable>[CC]</replaceable>.<replaceable>[charmap]</replaceable>
+export INPUTRC=/etc/inputrc
 
-# End /etc/locale.conf</literal>
+# End /etc/profile</literal>
 EOF</userinput></screen>
 
-  <para>Note that you can modify <filename>/etc/locale.conf</filename> with
-  systemd's <command>localectl</command> utility. To use
-  <command>localectl</command> for the example above, run:</para>
-
-<screen role="nodump"><userinput>localectl set-locale LANG="<replaceable>[ll]_[CC][charmap][@modifiers]</replaceable>"</userinput></screen>
-
-  <para>You can also specify other language specific environment variables such
-  as <envar>LANG</envar>, <envar>LC_CTYPE</envar>, <envar>LC_NUMERIC</envar> or
-  any other environment variable from <command>locale</command> output. Just
-  separate them with a space. An example where <envar>LANG</envar> is set as
-  en_US.UTF-8 but <envar>LC_CTYPE</envar> is set as just en_US is:</para>
-
-<screen role="nodump"><userinput>localectl set-locale LANG="en_US.UTF-8" LC_CTYPE="en_US"</userinput></screen>
-
-  <note><para>Please note that <command>localectl</command> command can
-  be used  only on a system booted with systemd.</para></note>
   <para>Setting the keyboard layout, screen font, and locale-related
   environment variables are the only internationalization steps needed to

BOOK/bootscripts/common/profile.xml

@@ -38 +38 @@
   <para>The files <filename>/etc/profile</filename> and
   <filename>~/.bash_profile</filename> are read when the shell is
-  invoked as an interactive login shell. Create a base
-  <filename>/etc/profile</filename> that will setup locale information and load
-  any bash auto completion files that may be on the system. This script also
-  sets the <envar>INPUTRC</envar> environment variable that makes Bash and
-  Readline use <filename>/etc/inputrc</filename>.</para>
-
-<screen><userinput>cat &gt; /etc/profile &lt;&lt; "EOF"
-<literal># Begin /etc/profile
-
-source /etc/locale.conf
-for f in /etc/bash_completion.d/*.sh; do source $f; done; unset f
-export INPUTRC=/etc/inputrc
-
-# End /etc/profile</literal>
-EOF</userinput></screen>
+  invoked as an interactive login shell. In the next section, a base
+  <filename>/etc/profile</filename> will be created to set up locale
+  information.</para>
 
 </sect1>

BOOK/bootscripts/common/symlinks.xml

@@ -45 +45 @@
     <note>
       <para>Although the examples in this book work properly, be aware
-      that Udev does not recognize the backslash for line continuation.
-      If modifying Udev rules with an editor, be sure to leave each rule
+      that Eudev does not recognize the backslash for line continuation.
+      If modifying Eudev rules with an editor, be sure to leave each rule
       on one physical line.</para>
     </note>
@@ -89 +89 @@
     <title>Dealing with duplicate devices</title>
 
-    <para>As explained in <xref linkend="ch-scripts-udev"/>, the order in
+    <para>As explained in <xref linkend="ch-scripts-eudev"/>, the order in
     which devices with the same function appear in
     <filename class="directory">/dev</filename> is essentially random.
@@ -134 +134 @@
     device.</para>
 
+    <para>More information on writing Eudev rules can be found in
+    <filename>/usr/share/doc/udev/writing_udev_rules/index.html</filename>.</para>
+
  </sect2>