Debian Codegraph @

upstream/debian-unstable/man1/perlirix.1

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "PERLIRIX 1"
58 .TH PERLIRIX 1 2025-11-16 "perl v5.40.1" "Perl Programmers Reference Guide"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SH NAME
64 perlirix \- Perl version 5 on Irix systems
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes various features of Irix that will affect how Perl
68 version 5 (hereafter just Perl) is compiled and/or runs.
69 .SS "Building 32\-bit Perl in Irix"
70 .IX Subsection "Building 32-bit Perl in Irix"
71 Use
72 .PP
73 .Vb 1
74 \& sh Configure \-Dcc=\*(Aqcc \-n32\*(Aq
75 .Ve
76 .PP
77 to compile Perl 32\-bit. Don't bother with \-n32 unless you have 7.1
78 or later compilers (use cc \-version to check).
79 .PP
80 (Building 'cc \-n32' is the default.)
81 .SS "Building 64\-bit Perl in Irix"
82 .IX Subsection "Building 64-bit Perl in Irix"
83 Use
84 .PP
85 .Vb 1
86 \& sh Configure \-Dcc=\*(Aqcc \-64\*(Aq \-Duse64bitint
87 .Ve
88 .PP
89 This requires require a 64\-bit MIPS CPU (R8000, R10000, ...)
90 .PP
91 You can also use
92 .PP
93 .Vb 1
94 \& sh Configure \-Dcc=\*(Aqcc \-64\*(Aq \-Duse64bitall
95 .Ve
96 .PP
97 but that makes no difference compared with the \-Duse64bitint because
98 of the \f(CW\*(C`cc \-64\*(C'\fR.
99 .PP
100 You can also do
101 .PP
102 .Vb 1
103 \& sh Configure \-Dcc=\*(Aqcc \-n32\*(Aq \-Duse64bitint
104 .Ve
105 .PP
106 to use long longs for the 64\-bit integer type, in case you don't
107 have a 64\-bit CPU.
108 .PP
109 If you are using gcc, just
110 .PP
111 .Vb 1
112 \& sh Configure \-Dcc=gcc \-Duse64bitint
113 .Ve
114 .PP
115 should be enough, the Configure should automatically probe for the
116 correct 64\-bit settings.
117 .SS "About Compiler Versions of Irix"
118 .IX Subsection "About Compiler Versions of Irix"
119 Some Irix cc versions, e.g. 7.3.1.1m (try cc \-version) have been known
120 to have issues (coredumps) when compiling perl.c. If you've used
121 \&\-OPT:fast_io=ON and this happens, try removing it. If that fails, or
122 you didn't use that, then try adjusting other optimization options
123 (\-LNO, \-INLINE, \-O3 to \-O2, et cetera). The compiler bug has been
124 reported to SGI. (Allen Smith <[email protected]>)
125 .SS "Linker Problems in Irix"
126 .IX Subsection "Linker Problems in Irix"
127 If you get complaints about so_locations then search in the file
128 hints/irix_6.sh for "lddflags" and do the suggested adjustments.
129 (David Billinghurst <[email protected]>)
130 .SS "Malloc in Irix"
131 .IX Subsection "Malloc in Irix"
132 Do not try to use Perl's malloc, this will lead into very mysterious
133 errors (especially with \-Duse64bitall).
134 .SS "Building with threads in Irix"
135 .IX Subsection "Building with threads in Irix"
136 Run Configure with \-Duseithreads which will configure Perl with
137 the Perl 5.8.0 "interpreter threads", see threads.
138 .PP
139 For Irix 6.2 with perl threads, you have to have the following
140 patches installed:
141 .PP
142 .Vb 5
143 \& 1404 Irix 6.2 Posix 1003.1b man pages
144 \& 1645 Irix 6.2 & 6.3 POSIX header file updates
145 \& 2000 Irix 6.2 Posix 1003.1b support modules
146 \& 2254 Pthread library fixes
147 \& 2401 6.2 all platform kernel rollup
148 .Ve
149 .PP
150 \&\fBIMPORTANT\fR: Without patch 2401, a kernel bug in Irix 6.2 will cause
151 your machine to panic and crash when running threaded perl. Irix 6.3
152 and later are okay.
153 .PP
154 .Vb 2
155 \& Thanks to Hannu Napari <[email protected]> for the IRIX
156 \& pthreads patches information.
157 .Ve
158 .SS "Irix 5.3"
159 .IX Subsection "Irix 5.3"
160 While running Configure and when building, you are likely to get
161 quite a few of these warnings:
162 .PP
163 .Vb 3
164 \& ld:
165 \& The shared object /usr/lib/libm.so did not resolve any symbols.
166 \& You may want to remove it from your link line.
167 .Ve
168 .PP
169 Ignore them: in IRIX 5.3 there is no way to quieten ld about this.
170 .PP
171 During compilation you will see this warning from toke.c:
172 .PP
173 .Vb 3
174 \& uopt: Warning: Perl_yylex: this procedure not optimized because it
175 \& exceeds size threshold; to optimize this procedure, use \-Olimit
176 \& option with value >= 4252.
177 .Ve
178 .PP
179 Ignore the warning.
180 .PP
181 In IRIX 5.3 and with Perl 5.8.1 (Perl 5.8.0 didn't compile in IRIX 5.3)
182 the following failures are known.
183 .PP
184 .Vb 8
185 \& Failed Test Stat Wstat Total Fail Failed|Failing List
186 \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
187 \& ../ext/List/Util/t/shuffle.t 0 139 ?? ?? % ??
188 \& ../lib/Math/Trig.t 255 65280 29 12 41.38% 24\-29
189 \& ../lib/sort.t 0 138 119 72 60.50% 48\-119
190 \& 56 tests and 474 subtests skipped.
191 \& Failed 3/811 test scripts, 99.63% okay. 78/75813 subtests failed,
192 \& 99.90% okay.
193 .Ve
194 .PP
195 They are suspected to be compiler errors (at least the shuffle.t
196 failure is known from some IRIX 6 setups) and math library errors
197 (the Trig.t failure), but since IRIX 5 is long since end-of-lifed,
198 further fixes for the IRIX are unlikely. If you can get gcc for 5.3,
199 you could try that, too, since gcc in IRIX 6 is a known workaround for
200 at least the shuffle.t and sort.t failures.
201 .SH AUTHOR
202 .IX Header "AUTHOR"
203 Jarkko Hietaniemi <[email protected]>
204 .PP
205 Please report any errors, updates, or suggestions to
206 <https://github.com/Perl/perl5/issues>.