This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Test::Harness 2.25 -> 2.26
[perl5.git] / README.irix
index 5164eac..9cafd26 100644 (file)
@@ -11,7 +11,7 @@ README.irix - Perl version 5 on Irix systems
 This document describes various features of Irix that will affect how Perl
 version 5 (hereafter just Perl) is compiled and/or runs.
 
-=head2 Building 32-bit
+=head2 Building 32-bit Perl in Irix
 
 Use
 
@@ -22,7 +22,7 @@ or later compilers (use cc -version to check).
 
 (Building 'cc -n32' is the default.)
 
-=head2 Building 64-bit
+=head2 Building 64-bit Perl in Irix
 
 Use
        
@@ -30,40 +30,51 @@ Use
 
 to compiler Perl 64-bit.
 
-=head2 About Compiler Versions
+=head2 About Compiler Versions of Irix
 
-Some IRIX cc versions, e.g. 7.3.1.1m (try cc -version) have been known
+Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
 to have issues (coredumps) when compiling perl.c.  If you've used
 -OPT:fast_io=ON and this happens, try removing it.  If that fails, or
 you didn't use that, then try adjusting other optimization options
 (-LNO, -INLINE, -O3 to -O2, etcetera).  The compiler bug has been
 reported to SGI.  (Allen Smith <easmith@beatrice.rutgers.edu>)
 
-=head2 Linker Problems
+=head2 Linker Problems in Irix
 
 If you get complaints about so_locations then search in the file
 hints/irix_6.sh for "lddflags" and do the suggested adjustments.
 (David Billinghurst <David.Billinghurst@riotinto.com.au>)
 
-=head2 Malloc
+=head2 Malloc in Irix
 
 Do not try to use Perl's malloc, this will lead into very mysterious
 errors (especially with -Duse64bitall).
 
 =head2 Building with threads
 
-For IRIX 6.2, you have to have the following patches installed:
+Run Configure with -Duseithreads which will configure Perl with
+the new Perl 5.8.0 "interpreter threads", see L<threads>.
+
+The old Perl 5.005 threads is obsolete, unmaintained, and its use is
+discouraged.  If you really want it, run Configure with the
+-Dusethreads -Duse5005threads options as described in INSTALL.
+
+For either thread model and for Irix 6.2, you have to have the
+following patches installed:
 
         1404 Irix 6.2 Posix 1003.1b man pages
-        1645 IRIX 6.2 & 6.3 POSIX header file updates
+        1645 Irix 6.2 & 6.3 POSIX header file updates
         2000 Irix 6.2 Posix 1003.1b support modules
         2254 Pthread library fixes
         2401 6.2 all platform kernel rollup
 
-IMPORTANT: Without patch 2401, a kernel bug in IRIX 6.2 will cause
-your machine to panic and crash when running threaded perl.  IRIX 6.3
+IMPORTANT: Without patch 2401, a kernel bug in Irix 6.2 will cause
+your machine to panic and crash when running threaded perl.  Irix 6.3
 and later are okay.
 
+    Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
+    pthreads patches information.
+
 =head1 AUTHOR
 
 Jarkko Hietaniemi <jhi@iki.fi>