Debian Codegraph @

upstream/debian-unstable/man1/perllinux.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 "PERLLINUX 1"
58 .TH PERLLINUX 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 perllinux \- Perl version 5 on Linux systems
65 .SH DESCRIPTION
66 .IX Header "DESCRIPTION"
67 This document describes various features of Linux that will affect how Perl
68 version 5 (hereafter just Perl) is compiled and/or runs.
69 .SS "Deploying Perl on Linux"
70 .IX Subsection "Deploying Perl on Linux"
71 Normally one can install \fI/usr/bin/perl\fR on Linux using your distribution's
72 package manager (e.g: \f(CW\*(C`sudo apt\-get install perl\*(C'\fR, or
73 \&\f(CW\*(C`sudo dnf install perl\*(C'\fR). Note that sometimes one needs to install some
74 extra system packages in order to be able to use CPAN frontends, and that
75 messing with the system's perl is not always recommended. One can use
76 perlbrew <https://perlbrew.pl/> to avoid such issues.
77 .PP
78 Otherwise, perl should build fine on Linux using the mainstream compilers
79 GCC and clang, while following the usual instructions.
80 .SS "Experimental Support for Sun Studio Compilers for Linux OS"
81 .IX Subsection "Experimental Support for Sun Studio Compilers for Linux OS"
82 Sun Microsystems has released a port of their Sun Studio compilers for
83 Linux. As of May 2019, the last stable release took place on 2017, and one can
84 buy support contracts for them.
85 .PP
86 There are some special instructions for building Perl with Sun Studio on
87 Linux. Following the normal \f(CW\*(C`Configure\*(C'\fR, you have to run make as follows:
88 .PP
89 .Vb 1
90 \& LDLOADLIBS=\-lc make
91 .Ve
92 .PP
93 \&\f(CW\*(C`LDLOADLIBS\*(C'\fR is an environment variable used by the linker to link
94 \&\f(CW\*(C`/ext\*(C'\fR modules to glibc. Currently, that environment variable is not getting
95 populated by a combination of \f(CW\*(C`Config\*(C'\fR entries and \f(CW\*(C`ExtUtil::MakeMaker\*(C'\fR.
96 While there may be a bug somewhere in Perl's configuration or
97 \&\f(CW\*(C`ExtUtil::MakeMaker\*(C'\fR causing the problem, the most likely cause is an
98 incomplete understanding of Sun Studio by this author. Further investigation
99 is needed to get this working better.
100 .SH AUTHOR
101 .IX Header "AUTHOR"
102 Steve Peters <[email protected]>
103 .PP
104 Please report any errors, updates, or suggestions to
105 <https://github.com/Perl/perl5/issues>.