README.irix

   1 If you read this file _as_is_, just ignore the funny characters you
   2 see.  It is written in the POD format (see pod/perlpod.pod) which is
   3 specifically designed to be readable as is.
   4
   5 =head1 NAME
   6
   7 README.irix - Perl version 5 on Irix systems
   8
   9 =head1 DESCRIPTION
  10
  11 This document describes various features of Irix that will affect how Perl
  12 version 5 (hereafter just Perl) is compiled and/or runs.
  13
  14 =head2 Building 32-bit Perl in Irix
  15
  16 Use
  17
  18         sh Configure -Dcc='cc -n32'
  19
  20 to compile Perl 32-bit.  Don't bother with -n32 unless you have 7.1
  21 or later compilers (use cc -version to check).
  22
  23 (Building 'cc -n32' is the default.)
  24
  25 =head2 Building 64-bit Perl in Irix
  26
  27 Use
  28
  29         sh Configure -Dcc='cc -64'
  30
  31 to compiler Perl 64-bit.
  32
  33 =head2 About Compiler Versions of Irix
  34
  35 Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
  36 to have issues (coredumps) when compiling perl.c.  If you've used
  37 -OPT:fast_io=ON and this happens, try removing it.  If that fails, or
  38 you didn't use that, then try adjusting other optimization options
  39 (-LNO, -INLINE, -O3 to -O2, etcetera).  The compiler bug has been
  40 reported to SGI.  (Allen Smith <easmith@beatrice.rutgers.edu>)
  41
  42 =head2 Linker Problems in Irix
  43
  44 If you get complaints about so_locations then search in the file
  45 hints/irix_6.sh for "lddflags" and do the suggested adjustments.
  46 (David Billinghurst <David.Billinghurst@riotinto.com.au>)
  47
  48 =head2 Malloc in Irix
  49
  50 Do not try to use Perl's malloc, this will lead into very mysterious
  51 errors (especially with -Duse64bitall).
  52
  53 =head2 Building with threads
  54
  55 Run Configure with -Duseithreads which will configure Perl with
  56 the new Perl 5.8.0 "interpreter threads", see L<threads>.
  57
  58 The old Perl 5.005 threads is obsolete, unmaintained, and its use is
  59 discouraged.  If you really want it, run Configure with the
  60 -Dusethreads -Duse5005threads options as described in INSTALL.
  61
  62 For either thread model and for Irix 6.2, you have to have the
  63 following patches installed:
  64
  65         1404 Irix 6.2 Posix 1003.1b man pages
  66         1645 Irix 6.2 & 6.3 POSIX header file updates
  67         2000 Irix 6.2 Posix 1003.1b support modules
  68         2254 Pthread library fixes
  69         2401 6.2 all platform kernel rollup
  70
  71 IMPORTANT: Without patch 2401, a kernel bug in Irix 6.2 will cause
  72 your machine to panic and crash when running threaded perl.  Irix 6.3
  73 and later are okay.
  74
  75     Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
  76     pthreads patches information.
  77
  78 =head1 AUTHOR
  79
  80 Jarkko Hietaniemi <jhi@iki.fi>
  81
  82 Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
  83