This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
I wonder what a 64-bot is?
[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
7README.irix - Perl version 5 on Irix systems
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
14=head2 Building 32-bit
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
24853e07 25=head2 Building 64-bit
469e7be4
JH
26
27Use
28
29 sh Configure -Dcc='cc -64'
30
31to compiler Perl 64-bit.
32
33=head2 About Compiler Versions
34
35Some IRIX cc versions, e.g. 7.3.1.1m (try cc -version) have been known
36to 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
38you didn't use that, then try adjusting other optimization options
39(-LNO, -INLINE, -O3 to -O2, etcetera). The compiler bug has been
40reported to SGI. (Allen Smith <easmith@beatrice.rutgers.edu>)
41
42=head2 Linker Problems
43
44If you get complaints about so_locations then search in the file
45hints/irix_6.sh for "lddflags" and do the suggested adjustments.
46(David Billinghurst <David.Billinghurst@riotinto.com.au>)
47
48=head2 Malloc
49
50Do not try to use Perl's malloc, this will lead into very mysterious
51errors (especially with -Duse64bitall).
52
53=head2 Building with threads
54
55For IRIX 6.2, you have to have the following patches installed:
56
57 1404 Irix 6.2 Posix 1003.1b man pages
58 1645 IRIX 6.2 & 6.3 POSIX header file updates
59 2000 Irix 6.2 Posix 1003.1b support modules
60 2254 Pthread library fixes
61 2401 6.2 all platform kernel rollup
62
63IMPORTANT: Without patch 2401, a kernel bug in IRIX 6.2 will cause
64your machine to panic and crash when running threaded perl. IRIX 6.3
65and later are okay.
66
67=head1 AUTHOR
68
69Jarkko Hietaniemi <jhi@iki.fi>
70
71Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
72