Debian Codegraph @

upstream/opensuse-tumbleweed/man1/perlirix.1

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