Changeset ce49ad6

Timestamp:

03/08/2023 05:17:41 PM (14 months ago)

Author:

Thomas Trepl <thomas@…>

Branches:

multilib

Children:

2858f02

Parents:

d09e490 (diff), d0a9bda4 (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:

Automatic merge of trunk into multilib

Files:

• chapter02/hostreqs.xml (modified) (2 diffs)
• chapter08/binutils.xml (modified) (1 diff)
• chapter08/expect.xml (modified) (1 diff)
• chapter10/kernel.xml (modified) (5 diffs)

chapter02/hostreqs.xml

@@ -105 +105 @@
       compiling the kernel and configuring the boot loader (assuming the host
       uses GRUB) are located in <xref linkend="chapter-bootable"/>.</para>
+
+      <para>We require the host kernel to support UNIX 98 pseudo terminal
+      (PTY).  It should be enabled on all desktop or server distros shipping
+      Linux &min-kernel; or a newer kernel. If you are building a custom
+      host kernel, ensure <option>CONFIG_UNIX98_PTYS</option> is set to
+      <literal>y</literal> in the kernel configuration.</para>
 
     </listitem>
@@ -231 +237 @@
 ver_kernel &min-kernel;
 
+if mount | grep -q 'devpts on /dev/pts' &amp;&amp; [ -e /dev/ptmx ]
+then echo "OK:    Linux Kernel supports UNIX 98 PTY";
+else echo "ERROR: Linux Kernel does NOT support UNIX 98 PTY"; fi
+
 alias_check() {
    if $1 --version 2>&amp;1 | grep -qi $2

chapter08/binutils.xml

@@ -42 +42 @@
     <title>Installation of Binutils</title>
 
-    <para>Verify that the PTYs are working properly inside the chroot
-    environment by performing a simple test:</para>
-
-<screen><userinput remap="test">expect -c "spawn ls"</userinput></screen>
-
-    <para>This command should output the following:</para>
-
-<screen><computeroutput>spawn ls</computeroutput></screen>
-
-    <para>If, instead, the output includes the message below, then the environment
-    is not set up for proper PTY operation.  This issue needs to be resolved before
-    running the test suites for Binutils and GCC:</para>
-
-<screen><computeroutput>The system has no more ptys.
-Ask your system administrator to create more.</computeroutput></screen>
-<!-- Fixed in binutils-2.39
-    <para>
-      Now make a fix identified upstream that affects building some packages:
-     </para>
-
-<screen><userinput remap="pre">sed -e '/R_386_TLS_LE /i \   || (TYPE) == R_386_TLS_IE \\' \
-    -i ./bfd/elfxx-x86.h</userinput></screen>
--->
     <para>The Binutils documentation recommends building Binutils
     in a dedicated build directory:</para>

chapter08/expect.xml

@@ -83 +83 @@
 <screen><userinput remap="make">make</userinput></screen>
 
+    <important>
+      <para>The test suite for Expect is considered critical.
+      Do not skip it under any circumstances.</para>
+    </important>
+
     <para>To test the results, issue:</para>
 
 <screen><userinput remap="test">make test</userinput></screen>
+
+    <para>If any test fails with the message
+    <quote><computeroutput>The system has no more ptys.  Ask your system
+    administrator to create more</computeroutput></quote>, it indicates
+    you've not mounted the
+    <systemitem class="filesystem">devpts</systemitem> file system
+    correctly.  You need to exit from the chroot environment, read
+    <xref linkend='ch-tools-kernfs'/> again, and ensure the
+    <systemitem class="filesystem">devpts</systemitem> file system (and
+    other virtual kernel file systems) mounted correctly.  Then reenter
+    the chroot environment following <xref linkend='ch-tools-chroot'/>.
+    This issue needs to be resolved before continuing.</para>
 
     <para>Install the package:</para>

chapter10/kernel.xml

@@ -97 +97 @@
     <ulink url="http://www.kroah.com/lkn/"/> </para>
 
-    <note>
+    <caution>
       <para>A good starting place for setting up the kernel configuration is to
       run <command>make defconfig</command>. This will set the base
@@ -103 +103 @@
       into account.</para>
 
+      <para>Do not disable any option enabled by <command>make
+      defconfig</command> unless the following note explicitly makes it
+      disabled or you really know what you are doing.</para>
+    </caution>
+
+    <note>
       <para>Be sure to enable/disable/set the following features or the system might
       not work correctly or boot at all:</para>
@@ -112 +118 @@
    [ ] Compile the kernel with warnings as errors [CONFIG_WERROR]
    &lt; &gt; Enable kernel headers through /sys/kernel/kheaders.tar.xz [CONFIG_IKHEADERS]
+   [ ] Configure standard kernel features (expert users) [CONFIG_EXPERT]
 General architecture-dependent options  ---&gt;
    [*] Stack Protector buffer overflow detection [CONFIG_STACKPROTECTOR]
@@ -138 +145 @@
       [*] Memory controller [CONFIG_MEMCG]
    [ ] Enable deprecated sysfs features to support old userspace tools [CONFIG_SYSFS_DEPRECATED]
-   [*] Configure standard kernel features (expert users) [CONFIG_EXPERT] ---&gt;
-      [*] open by fhandle syscalls [CONFIG_FHANDLE]
+   [ ] Configure standard kernel features (expert users) [CONFIG_EXPERT]
 General architecture-dependent options  ---&gt;
    [*] Enable seccomp to safely compute untrusted bytecode [CONFIG_SECCOMP]
@@ -270 +276 @@
 
       <varlistentry>
+        <term>
+          <parameter>
+            Configure standard kernel features (expert users)
+          </parameter>
+        </term>
+        <listitem>
+          <para>This will make some options show up in the configuration
+          interface but changing those options may be dangerous.  Do not use
+          this unless you know what you are doing.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
         <term><parameter>Strong Stack Protector</parameter></term>
         <listitem>