| 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' -Duse64bitint |
| 30 | |
| 31 | This requires require a 64-bit MIPS CPU (R8000, R10000, ...) |
| 32 | |
| 33 | You can also use |
| 34 | |
| 35 | sh Configure -Dcc='cc -64' -Duse64bitall |
| 36 | |
| 37 | but that makes no difference compared with the -Duse64bitint because |
| 38 | of the C<cc -64>. |
| 39 | |
| 40 | You can also do |
| 41 | |
| 42 | sh Configure -Dcc='cc -n32' -Duse64bitint |
| 43 | |
| 44 | to use long longs for the 64-bit integer type, in case you don't |
| 45 | have a 64-bit CPU. |
| 46 | |
| 47 | If you are using gcc, just |
| 48 | |
| 49 | sh Configure -Dcc=gcc -Duse64bitint |
| 50 | |
| 51 | should be enough, the Configure should automatically probe for the |
| 52 | correct 64-bit settings. |
| 53 | |
| 54 | =head2 About Compiler Versions of Irix |
| 55 | |
| 56 | Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known |
| 57 | to 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 |
| 59 | you didn't use that, then try adjusting other optimization options |
| 60 | (-LNO, -INLINE, -O3 to -O2, etcetera). The compiler bug has been |
| 61 | reported to SGI. (Allen Smith <easmith@beatrice.rutgers.edu>) |
| 62 | |
| 63 | =head2 Linker Problems in Irix |
| 64 | |
| 65 | If you get complaints about so_locations then search in the file |
| 66 | hints/irix_6.sh for "lddflags" and do the suggested adjustments. |
| 67 | (David Billinghurst <David.Billinghurst@riotinto.com.au>) |
| 68 | |
| 69 | =head2 Malloc in Irix |
| 70 | |
| 71 | Do not try to use Perl's malloc, this will lead into very mysterious |
| 72 | errors (especially with -Duse64bitall). |
| 73 | |
| 74 | =head2 Building with threads in Irix |
| 75 | |
| 76 | Run Configure with -Duseithreads which will configure Perl with |
| 77 | the Perl 5.8.0 "interpreter threads", see L<threads>. |
| 78 | |
| 79 | For Irix 6.2 with perl threads, you have to have the following |
| 80 | patches installed: |
| 81 | |
| 82 | 1404 Irix 6.2 Posix 1003.1b man pages |
| 83 | 1645 Irix 6.2 & 6.3 POSIX header file updates |
| 84 | 2000 Irix 6.2 Posix 1003.1b support modules |
| 85 | 2254 Pthread library fixes |
| 86 | 2401 6.2 all platform kernel rollup |
| 87 | |
| 88 | B<IMPORTANT>: Without patch 2401, a kernel bug in Irix 6.2 will cause |
| 89 | your machine to panic and crash when running threaded perl. Irix 6.3 |
| 90 | and later are okay. |
| 91 | |
| 92 | Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX |
| 93 | pthreads patches information. |
| 94 | |
| 95 | =head2 Irix 5.3 |
| 96 | |
| 97 | While running Configure and when building, you are likely to get |
| 98 | quite 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 | |
| 104 | Ignore them: in IRIX 5.3 there is no way to quieten ld about this. |
| 105 | |
| 106 | During 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 | |
| 112 | Ignore the warning. |
| 113 | |
| 114 | In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3) |
| 115 | the 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 ?? ?? % ?? |
| 120 | ../lib/Math/Trig.t 255 65280 29 12 41.38% 24-29 |
| 121 | ../lib/sort.t 0 138 119 72 60.50% 48-119 |
| 122 | 56 tests and 474 subtests skipped. |
| 123 | Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed, 99.90% okay. |
| 124 | |
| 125 | They are suspected to be compiler errors (at least the shuffle.t |
| 126 | failure 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, |
| 128 | further fixes for the IRIX are unlikely. If you can get gcc for 5.3, |
| 129 | you could try that, too, since gcc in IRIX 6 is a known workaround for |
| 130 | at least the shuffle.t and sort.t failures. |
| 131 | |
| 132 | =head1 AUTHOR |
| 133 | |
| 134 | Jarkko Hietaniemi <jhi@iki.fi> |
| 135 | |
| 136 | Please report any errors, updates, or suggestions to F<perlbug@perl.org>. |
| 137 | |