Commit | Line | Data |
469e7be4 |
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 | |
3df9be30 |
14 | =head2 Building 32-bit Perl in Irix |
469e7be4 |
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 | |
3df9be30 |
25 | =head2 Building 64-bit Perl in Irix |
469e7be4 |
26 | |
27 | Use |
28 | |
29 | sh Configure -Dcc='cc -64' |
30 | |
31 | to compiler Perl 64-bit. |
32 | |
3df9be30 |
33 | =head2 About Compiler Versions of Irix |
469e7be4 |
34 | |
3df9be30 |
35 | Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known |
469e7be4 |
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 | |
3df9be30 |
42 | =head2 Linker Problems in Irix |
469e7be4 |
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 | |
3df9be30 |
48 | =head2 Malloc in Irix |
469e7be4 |
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 | |
741e2d40 |
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: |
469e7be4 |
64 | |
65 | 1404 Irix 6.2 Posix 1003.1b man pages |
3df9be30 |
66 | 1645 Irix 6.2 & 6.3 POSIX header file updates |
469e7be4 |
67 | 2000 Irix 6.2 Posix 1003.1b support modules |
68 | 2254 Pthread library fixes |
69 | 2401 6.2 all platform kernel rollup |
70 | |
3df9be30 |
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 |
469e7be4 |
73 | and later are okay. |
74 | |
741e2d40 |
75 | Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX |
76 | pthreads patches information. |
77 | |
469e7be4 |
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 | |