From 990ba6b8b89ff0170273e073f29577d580495fc4 Mon Sep 17 00:00:00 2001
From: Greg Schafer <greg@linuxfromscratch.org>
Date: Tue, 23 Sep 2003 05:08:35 +0000
Subject: Chapter 5 - GCC Pass 2: Add check for properly functioning PTYs.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2870 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter05/gcc-pass2-inst.xml | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

(limited to 'chapter05/gcc-pass2-inst.xml')

diff --git a/chapter05/gcc-pass2-inst.xml b/chapter05/gcc-pass2-inst.xml
index 430671688..02f342f5c 100644
--- a/chapter05/gcc-pass2-inst.xml
+++ b/chapter05/gcc-pass2-inst.xml
@@ -3,13 +3,26 @@
 <sect2>
 <title>Re-installation of GCC</title>
 
-<para>The tools required to test GCC and Binutils are installed now
-(Expect, Tcl and DejaGnu). We can continue on rebuilding GCC and Binutils,
-link them against the new Glibc, and test them properly. One thing to note,
-however, is that these test suites are highly dependent on the features
-supported by your host distribution.  Most notably, a host distribution
-which does not properly support the devpts filesystem will cause most of
-these tests to fail.</para>
+<para>The tools required to test GCC and Binutils are installed now (Tcl, Expect
+and DejaGnu). We can continue on rebuilding GCC and Binutils, link them against
+the new Glibc, and test them properly. One thing to note, however, is that these
+test suites are highly dependent on properly functioning pseudo terminals (PTYs)
+which are provided by your host distribution. These days, PTYs are most commonly
+implemented via the <emphasis>devpts</emphasis> file system. You can quickly
+check if your host system is set up correctly in this regard by performing a
+simple test:</para>
+
+<para><screen><userinput>expect -c "spawn ls"</userinput></screen></para>
+
+<para>If you receive the message:</para>
+
+<para><screen>The system has no more ptys.  Ask your system administrator to create more.</screen></para>
+
+<para>Your host distribution is not set up for proper PTY operation. In this
+case there is no point in running the test suites for GCC and Binutils until you
+are able to resolve the issue. You can consult the LFS Wiki at
+<ulink url="http://wiki.linuxfromscratch.org"/> for more information on how to
+get PTYs working.</para>
 
 <note><para>It's worth pointing out that the GCC test suite we run in this
 section is considered not as critical as the one we run in Chapter 6.</para></note>
-- 
cgit v1.2.3-54-g00ecf