Changeset c2596a4 for chapter08

Timestamp:

04/23/2023 01:31:12 PM (15 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

xry111/arm64, xry111/arm64-12.0

Children:

45d1335

Parents:

1b61cd1 (diff), ed48f326 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge remote-tracking branch 'origin/trunk' into xry111/arm64

Location:

chapter08

Files:

• dbus.xml (modified) (2 diffs)
• eudev.xml (modified) (2 diffs)
• glibc.xml (modified) (3 diffs)
• groff.xml (modified) (2 diffs)
• libelf.xml (modified) (2 diffs)
• openssl.xml (modified) (1 diff)
• systemd.xml (modified) (2 diffs)
• util-linux.xml (modified) (1 diff)

chapter08/dbus.xml

@@ -80 +80 @@
 <screen><userinput remap="make">make</userinput></screen>
 
-    <para>This package does come with a test suite, but it requires several
+    <para>To test the results, issue:</para>
+
+<screen><userinput remap="test">make check</userinput></screen>
+
+    <para>Many tests are disabled because they require additional
     packages that are not included in LFS. Instructions for running the
-    test suite can be found in the BLFS book at
-    <ulink url="&blfs-book;general/dbus.html"/>.</para>
+    comprehensive test suite can be found in
+    <ulink url="&blfs-book;general/dbus.html">the BLFS book</ulink>.</para>
 
     <para>Install the package:</para>
@@ -108 +112 @@
         dbus-run-session, dbus-send, dbus-test-tool,
         dbus-update-activation-environment, and dbus-uuidgen</seg>
-        <seg>libdbus-1.{a,so}</seg>
+        <seg>libdbus-1.so</seg>
         <seg>/etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0,
         /usr/share/dbus-1, /usr/share/doc/dbus-&dbus-version;,

chapter08/eudev.xml

@@ -40 +40 @@
   <sect2 role="installation">
     <title>Installation of Eudev</title>
-
-    
 
     <para>First fix the location of udev rules in the .pc file:</para>
@@ -88 +86 @@
       <secondary>configuring</secondary>
     </indexterm>
+
+    <indexterm zone="conf-eudev">
+      <primary sortas="e-/etc/udev/rules.d/65-kvm.rules">/etc/udev/rules.d/65-kvm.rules</primary>
+    </indexterm>
+
+    <para>
+      The default udev rule installed by Eudev would allow all users to
+      access <filename class='devicefile'>/dev/kvm</filename>.  The editors
+      consider it dangerous.  Create a configuration file to override it:
+    </para>
+
+<screen><userinput remap="configure">cat > /etc/udev/rules.d/65-kvm.rules &lt;&lt; "EOF"
+<literal>KERNEL=="kvm", GROUP="kvm", MODE="0660", TAG+="uaccess"</literal>
+EOF</userinput></screen>
 
     <indexterm zone="conf-eudev">

chapter08/glibc.xml

@@ -778 +778 @@
         <term><filename class="libraryfile">libanl</filename></term>
         <listitem>
-          <para>An asynchronous name lookup library</para>
+          <para>Dummy library containing no functions.  Previously was the
+          asynchronous name lookup library, whose functions are now in
+          <filename class='libraryfile'>libc</filename></para>
           <indexterm zone="ch-system-glibc libanl">
             <primary sortas="c-libanl">libanl</primary>
@@ -919 +921 @@
           <para>Dummy library containing no functions. Previously contained
           functions providing most of the interfaces specified
-          by the POSIX.1b Realtime Extension, now the functions are in
-          <filename class="libraryfile">libc</filename></para>
+          by the POSIX.1c Threads Extensions and the semaphore interfaces
+          specified by the POSIX.1b Real-time Extensions, now the functions
+          are in <filename class="libraryfile">libc</filename></para>
           <indexterm zone="ch-system-glibc libpthread">
             <primary sortas="c-libpthread">libpthread</primary>
@@ -942 +945 @@
         <listitem>
           <para>Contains functions providing most of the interfaces specified
-          by the POSIX.1b Realtime Extension</para>
+          by the POSIX.1b Real-time Extensions</para>
           <indexterm zone="ch-system-glibc librt">
             <primary sortas="c-librt">librt</primary>

chapter08/groff.xml

@@ -169 +169 @@
         <term><command>gperl</command></term>
         <listitem>
-          <para>Preprocesor for groff, allowing the insertion of perl code
+          <para>Preprocessor for groff, allowing the insertion of perl code
           into groff files</para>
           <indexterm zone="ch-system-groff gperl">
@@ -180 +180 @@
         <term><command>gpinyin</command></term>
         <listitem>
-          <para>Preprocesor for groff, allowing the insertion of Pinyin
+          <para>Preprocessor for groff, allowing the insertion of Pinyin
           (Mandarin Chinese spelled with the Roman alphabet) into groff files.</para>
           <indexterm zone="ch-system-groff gpinyin">

chapter08/libelf.xml

@@ -76 +76 @@
       <seglistitem>
         <seg>
-          libelf.so (symlink) and libelf-&elfutils-version;.so
+          libelf.so 
         </seg>
         <seg>
@@ -91 +91 @@
 
       <varlistentry id="libelf">
-        <term><filename class="libraryfile">libelf</filename></term>
+        <term><filename class="libraryfile">libelf.so</filename></term>
         <listitem>
           <para>Contains API functions to handle ELF object files</para>

chapter08/openssl.xml

@@ -66 +66 @@
 <screen><userinput remap="test">make test</userinput></screen>
 
-    <para>One test, 30-test_afalg.t, is known to fail on some kernel
-    configurations (depending on inconsistent values of
-    CONFIG_CRYPTO_USER_API* settings.) If it fails, it can safely be
-    ignored.</para>
+    <para>One test, 30-test_afalg.t, is known to fail if the host kernel
+    does not have <option>CONFIG_CRYPTO_USER_API_SKCIPHER</option> enabled,
+    or does not have any options providing an AES with CBC implementation
+    (for example, the combination of <option>CONFIG_CRYPTO_AES</option>
+    and <option>CONFIG_CRYPTO_CBC</option>, or
+    <option>CONFIG_CRYPTO_AES_NI_INTEL</option> if the CPU supports AES-NI)
+    enabled.  If it fails, it can safely be ignored.</para>
 
     <para>Install the package:</para>

chapter08/systemd.xml

@@ -67 +67 @@
       -Dmode=release                \
       -Dpamconfdir=no               \
+      -Ddev-kvm-mode=0660           \
       -Ddocdir=/usr/share/doc/systemd-&systemd-version; \
       ..</userinput></screen>
@@ -166 +167 @@
           <para>Prevent the installation of a PAM configuration file not
           functional on LFS.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><parameter>-Ddev-kvm-mode=0660</parameter></term>
+        <listitem>
+          <para>The default udev rule would allow all users to access
+          <filename class='devicefile'>/dev/kvm</filename>.  The editors
+          consider it dangerous.  This option overrides it.</para>
         </listitem>
       </varlistentry>

chapter08/util-linux.xml

@@ -102 +102 @@
 
     <para>The <emphasis>hardlink</emphasis> tests will fail if the host's kernel
-    does not have the option CONFIG_CRYPTO_USER_API_HASH set. In addition,
+    does not have the option <option>CONFIG_CRYPTO_USER_API_HASH</option>
+    enabled or does not have any options providing a SHA256 implementation
+    (for example, <option>CONFIG_CRYPTO_SHA256</option>, or
+    <option>CONFIG_CRYPTO_SHA256_SSSE3</option> if the CPU supports
+    Supplemental SSE3) enabled. In addition,
     two sub-tests from misc: mbsencode and one sub-test from script: replay are 
     known to fail.</para>