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.
7 README.irix - Perl version 5 on Irix systems
11 This document describes various features of Irix that will affect how Perl
12 version 5 (hereafter just Perl) is compiled and/or runs.
14 =head2 Building 32-bit Perl in Irix
18 sh Configure -Dcc='cc -n32'
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).
23 (Building 'cc -n32' is the default.)
25 =head2 Building 64-bit Perl in Irix
29 sh Configure -Dcc='cc -64' -Duse64bitint
31 This requires require a 64-bit MIPS CPU (R8000, R10000, ...)
35 sh Configure -Dcc='cc -64' -Duse64bitall
37 but that makes no difference compared with the -Duse64bitint because
42 sh Configure -Dcc='cc -n32' -Duse64bitint
44 to use long longs for the 64-bit integer type, in case you don't
47 If you are using gcc, just
49 sh Configure -Dcc=gcc -Duse64bitint
51 should be enough, the Configure should automatically probe for the
52 correct 64-bit settings.
54 =head2 About Compiler Versions of Irix
56 Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
57 to have issues (coredumps) when compiling perl.c. If you've used
58 -OPT:fast_io=ON and this happens, try removing it. If that fails, or
59 you didn't use that, then try adjusting other optimization options
60 (-LNO, -INLINE, -O3 to -O2, etcetera). The compiler bug has been
61 reported to SGI. (Allen Smith <easmith@beatrice.rutgers.edu>)
63 =head2 Linker Problems in Irix
65 If you get complaints about so_locations then search in the file
66 hints/irix_6.sh for "lddflags" and do the suggested adjustments.
67 (David Billinghurst <David.Billinghurst@riotinto.com.au>)
71 Do not try to use Perl's malloc, this will lead into very mysterious
72 errors (especially with -Duse64bitall).
74 =head2 Building with threads in Irix
76 Run Configure with -Duseithreads which will configure Perl with
77 the new Perl 5.8.0 "interpreter threads", see L<threads>.
79 The old Perl 5.005 threads is obsolete, unmaintained, and its use is
80 discouraged. If you really want it, run Configure with the
81 -Dusethreads -Duse5005threads options as described in INSTALL.
83 For either thread model and for Irix 6.2, you have to have the
84 following patches installed:
86 1404 Irix 6.2 Posix 1003.1b man pages
87 1645 Irix 6.2 & 6.3 POSIX header file updates
88 2000 Irix 6.2 Posix 1003.1b support modules
89 2254 Pthread library fixes
90 2401 6.2 all platform kernel rollup
92 B<IMPORTANT>: Without patch 2401, a kernel bug in Irix 6.2 will cause
93 your machine to panic and crash when running threaded perl. Irix 6.3
96 Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
97 pthreads patches information.
101 While running Configure and when building, you are likely to get
102 quite a few of these warnings:
105 The shared object /usr/lib/libm.so did not resolve any symbols.
106 You may want to remove it from your link line.
108 Ignore them: in IRIX 5.3 there is no way to quieten ld about this.
110 During compilation you will see this warning from toke.c:
112 uopt: Warning: Perl_yylex: this procedure not optimized because it
113 exceeds size threshold; to optimize this procedure, use -Olimit option
118 In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3)
119 the following failures are known.
121 Failed Test Stat Wstat Total Fail Failed List of Failed
122 --------------------------------------------------------------------------
123 ../ext/List/Util/t/shuffle.t 0 139 ?? ?? % ??
124 ../lib/Math/Trig.t 255 65280 29 12 41.38% 24-29
125 ../lib/sort.t 0 138 119 72 60.50% 48-119
126 56 tests and 474 subtests skipped.
127 Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed, 99.90% okay.
129 They are suspected to be compiler errors (at least the shuffle.t
130 failure is known from some IRIX 6 setups) and math library errors
131 (the Trig.t failure), but since IRIX 5 is long since end-of-lifed,
132 further fixes for the IRIX are unlikely. If you can get gcc for 5.3,
133 you could try that, too, since gcc in IRIX 6 is a known workaround for
134 at least the shuffle.t and sort.t failures.
138 Jarkko Hietaniemi <jhi@iki.fi>
140 Please report any errors, updates, or suggestions to F<perlbug@perl.org>.