.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\" ========================================================================
.de Sh \" Subsection heading
.de Sp \" Vertical space (when we can't use .PP)
.de Vb \" Begin verbatim text
.de Ve \" End verbatim text
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
. tm Index:\\$1\t\\n%\t"\\$2"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. \" simple accents for nroff and troff
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
.\" ========================================================================
.TH PERLIRIX 1 "2006-01-07" "perl v5.8.8" "Perl Programmers Reference Guide"
README.irix \- Perl version 5 on Irix systems
This document describes various features of Irix that will affect how Perl
version 5 (hereafter just Perl) is compiled and/or runs.
.Sh "Building 32\-bit Perl in Irix"
.IX Subsection "Building 32-bit Perl in Irix"
\& 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.)
.Sh "Building 64\-bit Perl in Irix"
.IX Subsection "Building 64-bit Perl in Irix"
\& sh Configure -Dcc='cc -64' -Duse64bitint
This requires require a 64\-bit \s-1MIPS\s0 \s-1CPU\s0 (R8000, R10000, ...)
\& sh Configure -Dcc='cc -64' -Duse64bitall
but that makes no difference compared with the \-Duse64bitint because
of the \f(CW\*(C`cc \-64\*(C'\fR.
\& 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 \s-1CPU\s0.
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.
.Sh "About Compiler Versions of Irix"
.IX Subsection "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 \s-1SGI\s0. (Allen Smith <easmith@beatrice.rutgers.edu>)
.Sh "Linker Problems in Irix"
.IX Subsection "Linker Problems in Irix"
If you get complaints about so_locations then search in the file
hints/irix_6.sh for \*(L"lddflags\*(R" and do the suggested adjustments.
(David Billinghurst <David.Billinghurst@riotinto.com.au>)
.IX Subsection "Malloc in Irix"
Do not try to use Perl's malloc, this will lead into very mysterious
errors (especially with \-Duse64bitall).
.Sh "Building with threads in Irix"
.IX Subsection "Building with threads in Irix"
Run Configure with \-Duseithreads which will configure Perl with
the new Perl 5.8.0 \*(L"interpreter threads\*(R", see threads.
The old Perl 5.005 threads is obsolete, unmaintained, and its use is
discouraged. If you really want it, run Configure with the
\&\-Dusethreads \-Duse5005threads options as described in \s-1INSTALL\s0.
For either thread model and for Irix 6.2, 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
\&\fB\s-1IMPORTANT\s0\fR: 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
\& Thanks to Hannu Napari <Hannu.Napari@hut.fi> for the IRIX
\& pthreads patches information.
.IX Subsection "Irix 5.3"
While running Configure and when building, you are likely to get
quite a few of these warnings:
\& 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 \s-1IRIX\s0 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
In \s-1IRIX\s0 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in \s-1IRIX\s0 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 \s-1IRIX\s0 6 setups) and math library errors
(the Trig.t failure), but since \s-1IRIX\s0 5 is long since end\-of\-lifed,
further fixes for the \s-1IRIX\s0 are unlikely. If you can get gcc for 5.3,
you could try that, too, since gcc in \s-1IRIX\s0 6 is a known workaround for
at least the shuffle.t and sort.t failures.
Jarkko Hietaniemi <jhi@iki.fi>
Please report any errors, updates, or suggestions to \fIperlbug@perl.org\fR.