This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
inline.h: Fix comment
[perl5.git] / README.irix
CommitLineData
469e7be4
JH
1If you read this file _as_is_, just ignore the funny characters you
2see. It is written in the POD format (see pod/perlpod.pod) which is
3specifically designed to be readable as is.
4
5=head1 NAME
6
de2902a6 7perlirix - Perl version 5 on Irix systems
469e7be4
JH
8
9=head1 DESCRIPTION
10
11This document describes various features of Irix that will affect how Perl
12version 5 (hereafter just Perl) is compiled and/or runs.
13
3df9be30 14=head2 Building 32-bit Perl in Irix
469e7be4
JH
15
16Use
17
18 sh Configure -Dcc='cc -n32'
19
20to compile Perl 32-bit. Don't bother with -n32 unless you have 7.1
21or later compilers (use cc -version to check).
22
23(Building 'cc -n32' is the default.)
24
3df9be30 25=head2 Building 64-bit Perl in Irix
469e7be4
JH
26
27Use
d6fd60d6 28
538426ad 29 sh Configure -Dcc='cc -64' -Duse64bitint
469e7be4 30
538426ad
JH
31This requires require a 64-bit MIPS CPU (R8000, R10000, ...)
32
33You can also use
34
35 sh Configure -Dcc='cc -64' -Duse64bitall
36
37but that makes no difference compared with the -Duse64bitint because
38of the C<cc -64>.
39
40You can also do
41
42 sh Configure -Dcc='cc -n32' -Duse64bitint
43
44to use long longs for the 64-bit integer type, in case you don't
45have a 64-bit CPU.
46
47If you are using gcc, just
48
49 sh Configure -Dcc=gcc -Duse64bitint
50
51should be enough, the Configure should automatically probe for the
52correct 64-bit settings.
469e7be4 53
3df9be30 54=head2 About Compiler Versions of Irix
469e7be4 55
3df9be30 56Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
469e7be4
JH
57to 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
59you didn't use that, then try adjusting other optimization options
60(-LNO, -INLINE, -O3 to -O2, etcetera). The compiler bug has been
61reported to SGI. (Allen Smith <easmith@beatrice.rutgers.edu>)
62
3df9be30 63=head2 Linker Problems in Irix
469e7be4
JH
64
65If you get complaints about so_locations then search in the file
66hints/irix_6.sh for "lddflags" and do the suggested adjustments.
67(David Billinghurst <David.Billinghurst@riotinto.com.au>)
68
3df9be30 69=head2 Malloc in Irix
469e7be4
JH
70
71Do not try to use Perl's malloc, this will lead into very mysterious
72errors (especially with -Duse64bitall).
73
538426ad 74=head2 Building with threads in Irix
469e7be4 75
741e2d40 76Run Configure with -Duseithreads which will configure Perl with
294f22c5 77the Perl 5.8.0 "interpreter threads", see L<threads>.
741e2d40 78
294f22c5
MB
79For Irix 6.2 with perl threads, you have to have the following
80patches installed:
469e7be4
JH
81
82 1404 Irix 6.2 Posix 1003.1b man pages
3df9be30 83 1645 Irix 6.2 & 6.3 POSIX header file updates
469e7be4
JH
84 2000 Irix 6.2 Posix 1003.1b support modules
85 2254 Pthread library fixes
86 2401 6.2 all platform kernel rollup
87
538426ad 88B<IMPORTANT>: Without patch 2401, a kernel bug in Irix 6.2 will cause
3df9be30 89your machine to panic and crash when running threaded perl. Irix 6.3
469e7be4
JH
90and later are okay.
91
741e2d40
JH
92 Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
93 pthreads patches information.
94
271230c2
JH
95=head2 Irix 5.3
96
641ea345
JH
97While running Configure and when building, you are likely to get
98quite a few of these warnings:
99
100 ld:
101 The shared object /usr/lib/libm.so did not resolve any symbols.
102 You may want to remove it from your link line.
103
104Ignore them: in IRIX 5.3 there is no way to quieten ld about this.
105
106During compilation you will see this warning from toke.c:
107
108 uopt: Warning: Perl_yylex: this procedure not optimized because it
109 exceeds size threshold; to optimize this procedure, use -Olimit option
110 with value >= 4252.
111
112Ignore the warning.
113
271230c2
JH
114In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3)
115the following failures are known.
116
117 Failed Test Stat Wstat Total Fail Failed List of Failed
118 --------------------------------------------------------------------------
119 ../ext/List/Util/t/shuffle.t 0 139 ?? ?? % ??
641ea345 120 ../lib/Math/Trig.t 255 65280 29 12 41.38% 24-29
271230c2 121 ../lib/sort.t 0 138 119 72 60.50% 48-119
641ea345
JH
122 56 tests and 474 subtests skipped.
123 Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed, 99.90% okay.
271230c2 124
641ea345
JH
125They are suspected to be compiler errors (at least the shuffle.t
126failure is known from some IRIX 6 setups) and math library errors
127(the Trig.t failure), but since IRIX 5 is long since end-of-lifed,
128further fixes for the IRIX are unlikely. If you can get gcc for 5.3,
271230c2 129you could try that, too, since gcc in IRIX 6 is a known workaround for
641ea345 130at least the shuffle.t and sort.t failures.
271230c2 131
469e7be4
JH
132=head1 AUTHOR
133
134Jarkko Hietaniemi <jhi@iki.fi>
135
136Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
137