binmode(FH); to act like binmode(FH,":bytes") as well as
[p5sagit/p5-mst-13.2.git] / README.irix
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
14 =head2 Building 32-bit Perl in Irix
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
25 =head2 Building 64-bit Perl in Irix
26
27 Use
28         
29         sh Configure -Dcc='cc -64'
30
31 to compiler Perl 64-bit.
32
33 =head2 About Compiler Versions of Irix
34
35 Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
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
42 =head2 Linker Problems in Irix
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
48 =head2 Malloc in Irix
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
55 For 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
63 IMPORTANT: Without patch 2401, a kernel bug in Irix 6.2 will cause
64 your machine to panic and crash when running threaded perl.  Irix 6.3
65 and later are okay.
66
67 =head1 AUTHOR
68
69 Jarkko Hietaniemi <jhi@iki.fi>
70
71 Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
72