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