* build.texinfo (Solaris 9): Add section describing workaround for

	Solaris 9 pty-close kernel bug.

ticket: 2195
tags: pullup

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@16078 dc483132-0cff-0310-8789-dd5450dbe970

diff --git a/doc/ChangeLog b/doc/ChangeLog
index ffe9724f7cf21acf982de7ee95bbdbee1390bb28..9ed888063c75e2b64fe07c00f9fc356183abc03c 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2004-02-13  Tom Yu  <tlyu@mit.edu>
+
+       * build.texinfo (Solaris 9): Add section describing workaround for
+       Solaris 9 pty-close kernel bug.
+
 2003-07-25  Ken Raeburn  <raeburn@mit.edu>
 
        * admin.texinfo (realms (krb5.conf)): Add description of

diff --git a/doc/build.texinfo b/doc/build.texinfo
index 4d5a4c691f8f2ed28bfec0ef33c361cd596bf075..14f284d2148c71b7aa93c70ab46c934b299ef09c 100644 (file)
--- a/doc/build.texinfo
+++ b/doc/build.texinfo
@@ -750,6 +750,7 @@ Thanks!
 * HPUX::                        
 * Solaris versions 2.0 through 2.3::  
 * Solaris 2.X::                 
+* Solaris 9::                   
 * SGI Irix 5.X::                
 * Ultrix 4.2/3::                
 @end menu
@@ -847,7 +848,7 @@ environment to break or behave differently.
 
 @end enumerate
 
-@node Solaris 2.X, SGI Irix 5.X, Solaris versions 2.0 through 2.3, OS Incompatibilities
+@node Solaris 2.X, Solaris 9, Solaris versions 2.0 through 2.3, OS Incompatibilities
 @subsection Solaris 2.X
 
 You @b{must} compile Kerberos V5 without the UCB compatibility
@@ -861,7 +862,24 @@ to configure with the option @code{CFLAGS="-D_XOPEN_SOURCE=500
 -D__EXTENSIONS__"}.  This is not well tested; at MIT we work primarily
 with the 32-bit execution environment.
 
-@node SGI Irix 5.X, Ultrix 4.2/3, Solaris 2.X, OS Incompatibilities
+@node Solaris 9, SGI Irix 5.X, Solaris 2.X, OS Incompatibilities
+@subsection Solaris 9
+
+Solaris 9 has a kernel race condition which causes the final output
+written to the slave side of a pty to be lost upon the final close()
+of the slave device.  This causes the dejagnu-based tests to fail
+intermittently.  A workaround exists, but requires some help from the
+scheduler, and the ``make check'' must be executed from a shell with
+elevated priority limits.
+
+Run something like
+
+@code{priocntl -s -c FX -m 30 -p 30 -i pid nnnn}
+
+as root, where @code{nnnn} is the pid of the shell whose priority
+limit you wish to raise.
+
+@node SGI Irix 5.X, Ultrix 4.2/3, Solaris 9, OS Incompatibilities
 @subsection SGI Irix 5.X
 
 If you are building in a tree separate from the source tree, the vendors