This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: Remove per-thread section; move to real scns
[perl5.git] / README.linux
CommitLineData
6452e86c
SP
1If you read this file _as_is_, just ignore the funny characters you
2see. It is written in the POD format (see pod/perlpod.pod) which is
3specifically designed to be readable as is.
4
5=head1 NAME
6
de2902a6 7perllinux - Perl version 5 on Linux systems
6452e86c
SP
8
9=head1 DESCRIPTION
10
11This document describes various features of Linux that will affect how Perl
12version 5 (hereafter just Perl) is compiled and/or runs.
13
9ffb8441
SF
14=head2 Deploying Perl on Linux
15
16Normally one can install F</usr/bin/perl> on Linux using your distribution's
17package manager (e.g: C<sudo apt-get install perl>, or
18C<sudo dnf install perl>). Note that sometimes one needs to install some
19extra system packages in order to be able to use CPAN frontends, and that
20messing with the system's perl is not always recommended. One can use
21L<perlbrew|https://perlbrew.pl/> to avoid such issues.
22
23Otherwise, perl should build fine on Linux using the mainstream compilers
24GCC and clang, while following the usual instructions.
25
6452e86c
SP
26=head2 Experimental Support for Sun Studio Compilers for Linux OS
27
f858446f 28Sun Microsystems has released a port of their Sun Studio compilers for
9ffb8441
SF
29Linux. As of May 2019, the last stable release took place on 2017, and one can
30buy support contracts for them.
6452e86c 31
9ffb8441
SF
32There are some special instructions for building Perl with Sun Studio on
33Linux. Following the normal C<Configure>, you have to run make as follows:
6452e86c
SP
34
35 LDLOADLIBS=-lc make
36
9ffb8441 37C<LDLOADLIBS> is an environment variable used by the linker to link
6452e86c
SP
38C</ext> modules to glibc. Currently, that environment variable is not getting
39populated by a combination of C<Config> entries and C<ExtUtil::MakeMaker>.
40While there may be a bug somewhere in Perl's configuration or
41C<ExtUtil::MakeMaker> causing the problem, the most likely cause is an
42incomplete understanding of Sun Studio by this author. Further investigation
43is needed to get this working better.
44
45=head1 AUTHOR
46
47Steve Peters <steve@fisharerojo.org>
48
8166b4e0
DB
49Please report any errors, updates, or suggestions to
50L<https://github.com/Perl/perl5/issues>.
6452e86c 51