README.linux

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