aboutsummaryrefslogtreecommitdiffstats
path: root/chapter08
diff options
context:
space:
mode:
authorXi Ruoyao <xry111@xry111.site>2023-03-08 11:21:34 +0800
committerXi Ruoyao <xry111@xry111.site>2023-03-08 11:25:48 +0800
commit835e40ce16b6043f6349cc37ff83ee701d961ee5 (patch)
tree3972016c966ea5795947a3d62b64ed07f2cd4651 /chapter08
parente0fb1098a4b0f5059f029fd88eff78ca244beec1 (diff)
Adjustments for /dev/pts
1. Declare UNIX98 PTY requirement in host system requirements and check it in the script. All desktop or server distros should have it now, but let's stop anyone from building on a embedded distro w/o UNIX98 PTY early... 2. Use Expect test suite as a guard against mishandled $LFS/dev/pts. 3. No need to test the basic function of Expect in Binutils anymore because if ($LFS)/dev/pts is not good, the Expect test suite would have failed.
Diffstat (limited to 'chapter08')
-rw-r--r--chapter08/binutils.xml23
-rw-r--r--chapter08/expect.xml17
2 files changed, 17 insertions, 23 deletions
diff --git a/chapter08/binutils.xml b/chapter08/binutils.xml
index eb83563bb..cf1c4f895 100644
--- a/chapter08/binutils.xml
+++ b/chapter08/binutils.xml
@@ -41,29 +41,6 @@
<sect2 role="installation">
<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>
diff --git a/chapter08/expect.xml b/chapter08/expect.xml
index 6286d9033..7b6dac354 100644
--- a/chapter08/expect.xml
+++ b/chapter08/expect.xml
@@ -82,10 +82,27 @@
<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>
<screen><userinput remap="install">make install