139 lines
4.3 KiB
Plaintext
139 lines
4.3 KiB
Plaintext
If you read this file _as_is_, just ignore the funny characters you
|
|
see. It is written in the POD format (see pod/perlpod.pod) which is
|
|
specifically designed to be readable as is.
|
|
|
|
=head1 NAME
|
|
|
|
perlirix - Perl version 5 on Irix systems
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
This document describes various features of Irix that will affect how Perl
|
|
version 5 (hereafter just Perl) is compiled and/or runs.
|
|
|
|
=head2 Building 32-bit Perl in Irix
|
|
|
|
Use
|
|
|
|
sh Configure -Dcc='cc -n32'
|
|
|
|
to compile Perl 32-bit. Don't bother with -n32 unless you have 7.1
|
|
or later compilers (use cc -version to check).
|
|
|
|
(Building 'cc -n32' is the default.)
|
|
|
|
=head2 Building 64-bit Perl in Irix
|
|
|
|
Use
|
|
|
|
sh Configure -Dcc='cc -64' -Duse64bitint
|
|
|
|
This requires require a 64-bit MIPS CPU (R8000, R10000, ...)
|
|
|
|
You can also use
|
|
|
|
sh Configure -Dcc='cc -64' -Duse64bitall
|
|
|
|
but that makes no difference compared with the -Duse64bitint because
|
|
of the C<cc -64>.
|
|
|
|
You can also do
|
|
|
|
sh Configure -Dcc='cc -n32' -Duse64bitint
|
|
|
|
to use long longs for the 64-bit integer type, in case you don't
|
|
have a 64-bit CPU.
|
|
|
|
If you are using gcc, just
|
|
|
|
sh Configure -Dcc=gcc -Duse64bitint
|
|
|
|
should be enough, the Configure should automatically probe for the
|
|
correct 64-bit settings.
|
|
|
|
=head2 About Compiler Versions of Irix
|
|
|
|
Some Irix cc versions, e.g. 7.3.1.1m (try cc -version) have been known
|
|
to have issues (coredumps) when compiling perl.c. If you've used
|
|
-OPT:fast_io=ON and this happens, try removing it. If that fails, or
|
|
you didn't use that, then try adjusting other optimization options
|
|
(-LNO, -INLINE, -O3 to -O2, etcetera). The compiler bug has been
|
|
reported to SGI. (Allen Smith <easmith@beatrice.rutgers.edu>)
|
|
|
|
=head2 Linker Problems in Irix
|
|
|
|
If you get complaints about so_locations then search in the file
|
|
hints/irix_6.sh for "lddflags" and do the suggested adjustments.
|
|
(David Billinghurst <David.Billinghurst@riotinto.com.au>)
|
|
|
|
=head2 Malloc in Irix
|
|
|
|
Do not try to use Perl's malloc, this will lead into very mysterious
|
|
errors (especially with -Duse64bitall).
|
|
|
|
=head2 Building with threads in Irix
|
|
|
|
Run Configure with -Duseithreads which will configure Perl with
|
|
the Perl 5.8.0 "interpreter threads", see L<threads>.
|
|
|
|
For Irix 6.2 with perl threads, you have to have the following
|
|
patches installed:
|
|
|
|
1404 Irix 6.2 Posix 1003.1b man pages
|
|
1645 Irix 6.2 & 6.3 POSIX header file updates
|
|
2000 Irix 6.2 Posix 1003.1b support modules
|
|
2254 Pthread library fixes
|
|
2401 6.2 all platform kernel rollup
|
|
|
|
B<IMPORTANT>: Without patch 2401, a kernel bug in Irix 6.2 will cause
|
|
your machine to panic and crash when running threaded perl. Irix 6.3
|
|
and later are okay.
|
|
|
|
Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
|
|
pthreads patches information.
|
|
|
|
=head2 Irix 5.3
|
|
|
|
While running Configure and when building, you are likely to get
|
|
quite a few of these warnings:
|
|
|
|
ld:
|
|
The shared object /usr/lib/libm.so did not resolve any symbols.
|
|
You may want to remove it from your link line.
|
|
|
|
Ignore them: in IRIX 5.3 there is no way to quieten ld about this.
|
|
|
|
During compilation you will see this warning from toke.c:
|
|
|
|
uopt: Warning: Perl_yylex: this procedure not optimized because it
|
|
exceeds size threshold; to optimize this procedure, use -Olimit
|
|
option with value >= 4252.
|
|
|
|
Ignore the warning.
|
|
|
|
In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3)
|
|
the following failures are known.
|
|
|
|
Failed Test Stat Wstat Total Fail Failed List of Failed
|
|
-----------------------------------------------------------------------
|
|
../ext/List/Util/t/shuffle.t 0 139 ?? ?? % ??
|
|
../lib/Math/Trig.t 255 65280 29 12 41.38% 24-29
|
|
../lib/sort.t 0 138 119 72 60.50% 48-119
|
|
56 tests and 474 subtests skipped.
|
|
Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed,
|
|
99.90% okay.
|
|
|
|
They are suspected to be compiler errors (at least the shuffle.t
|
|
failure is known from some IRIX 6 setups) and math library errors
|
|
(the Trig.t failure), but since IRIX 5 is long since end-of-lifed,
|
|
further fixes for the IRIX are unlikely. If you can get gcc for 5.3,
|
|
you could try that, too, since gcc in IRIX 6 is a known workaround for
|
|
at least the shuffle.t and sort.t failures.
|
|
|
|
=head1 AUTHOR
|
|
|
|
Jarkko Hietaniemi <jhi@iki.fi>
|
|
|
|
Please report any errors, updates, or suggestions to F<perlbug@perl.org>.
|
|
|