This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
missing export for PerlIO_pop (used in PerlIO::Via now)
[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
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
28
29 sh Configure -Dcc='cc -64'
30
31to compiler Perl 64-bit.
32
3df9be30 33=head2 About Compiler Versions of Irix
469e7be4 34
3df9be30 35Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
469e7be4
JH
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
3df9be30 42=head2 Linker Problems in Irix
469e7be4
JH
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
3df9be30 48=head2 Malloc in Irix
469e7be4
JH
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
741e2d40
JH
55Run Configure with -Duseithreads which will configure Perl with
56the new Perl 5.8.0 "interpreter threads", see L<threads>.
57
58The old Perl 5.005 threads is obsolete, unmaintained, and its use is
59discouraged. If you really want it, run Configure with the
60-Dusethreads -Duse5005threads options as described in INSTALL.
61
62For either thread model and for Irix 6.2, you have to have the
63following patches installed:
469e7be4
JH
64
65 1404 Irix 6.2 Posix 1003.1b man pages
3df9be30 66 1645 Irix 6.2 & 6.3 POSIX header file updates
469e7be4
JH
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
JH
71IMPORTANT: Without patch 2401, a kernel bug in Irix 6.2 will cause
72your machine to panic and crash when running threaded perl. Irix 6.3
469e7be4
JH
73and later are okay.
74
741e2d40
JH
75 Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
76 pthreads patches information.
77
469e7be4
JH
78=head1 AUTHOR
79
80Jarkko Hietaniemi <jhi@iki.fi>
81
82Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
83