X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/c5252117ef781e5b19e029b3fa56e46f18bd573a..25cf9644e6dfb6b7cb9e767b3f52baa4b81a7df0:/README.aix diff --git a/README.aix b/README.aix index 7b6dbcf..be28327 100644 --- a/README.aix +++ b/README.aix @@ -4,22 +4,23 @@ designed to be readable as is. =head1 NAME -README.aix - Perl version 5 on IBM Unix (AIX) systems +perlaix - Perl version 5 on IBM AIX (UNIX) systems =head1 DESCRIPTION -This document describes various features of IBM's Unix operating -system (AIX) that will affect how Perl version 5 (hereafter just Perl) +This document describes various features of IBM's UNIX operating +system AIX that will affect how Perl version 5 (hereafter just Perl) is compiled and/or runs. =head2 Compiling Perl 5 on AIX -For information on compilers on older versions of AIX, see L. When compiling Perl, you must use an ANSI C compiler. AIX does not ship -an ANSI compliant C-compiler with AIX by default, but binary builds of -gcc for AIX are widely available. +an ANSI compliant C compiler with AIX by default, but binary builds of +gcc for AIX are widely available. A version of gcc is also included in +the AIX Toolbox which is shipped with AIX. =head2 Supported Compilers @@ -30,66 +31,90 @@ works on your system. If you plan to link Perl to any module that requires thread-support, like DBD::Oracle, it is better to use the _r version of the compiler. This will not build a threaded Perl, but a thread-enabled Perl. See -also L later on. +also L later on. + +As of writing (2010-09) only the I or I compiler is supported by IBM on AIX 5L/6.1/7.1. -As of writing (2008-11) only the IBM XL C for AIX or XL C/C++ for AIX -compiler is supported by IBM on AIX 5L/6.1. +The following compiler versions are currently supported by IBM: -The following compiler versions are supported by IBM: + IBM XL C and IBM XL C/C++ V8, V9, V10, V11 -XL C and XL C/C++ V7, V8, V9, V10 +The XL C for AIX is integrated in the XL C/C++ for AIX compiler and +therefore also supported. -The XL C for AIX is integrated in the XL C/C++ for AIX compiler. +If you choose XL C/C++ V9 you need APAR IZ35785 installed +otherwise the integrated SDBM_File do not compile correctly due +to an optimization bug. You can circumvent this problem by +adding -qipa to the optimization flags (-Doptimize='-O -qipa'). +The PTF for APAR IZ35785 which solves this problem is available +from IBM (April 2009 PTF for XL C/C++ Enterprise Edition for AIX, V9.0). -If you choose XL C/C++ V9 you need APAR IZ35785 installed -otherwise the integrated SDBM_File do not compile correctly due -to an optimization bug. You can circumvent this problem by -adding -qipa to the optimization flags (-Doptimize='-O -qipa'). -The PTF for APAR IZ35785 which solves this problem will be available -in 1Q 2009. IBM does provide an emergency fix for this problem. +If you choose XL C/C++ V11 you need the April 2010 PTF (or newer) +installed otherwise you will not get a working Perl version. -Perl can be compiled with either IBM's ANSI C compiler or with gcc. -The former is recommended, as not only it can compile Perl with no -difficulty, but also can take advantage of features listed later +Perl can be compiled with either IBM's ANSI C compiler or with gcc. +The former is recommended, as not only it can compile Perl with no +difficulty, but also can take advantage of features listed later that require the use of IBM compiler-specific command-line flags. -If you decide to use gcc, make sure your installation is recent and -complete, and be sure to read the Perl INSTALL file for more gcc-specific -details. Please report any hoops you had to jump through to the +If you decide to use gcc, make sure your installation is recent and +complete, and be sure to read the Perl INSTALL file for more gcc-specific +details. Please report any hoops you had to jump through to the development team. -=head2 Perl 5.8.9 was successfully compiled and tested on: - - AIX Level | Compiler Level | w th | w/o th - --------------------------+-------------------------+------+------- - 5.1 TL9 32 bit | XL C/C++ V7 | OK | OK - 5.1 TL9 32 bit | gcc 3.2.2 | OK | OK - 5.1 TL9 64 bit | XL C/C++ V7 | OK | OK - 5.2 TL10 32 bit | XL C/C++ V8 | OK | OK - 5.2 TL10 64 bit | XL C/C++ V8 | OK | OK - 5.3 TL7 32 bit | XL C/C++ V9 + IZ35785 | OK | OK - 5.3 TL7 32 bit | gcc 4.2.4 | OK | OK - 5.3 TL7 64 bit | XL C/C++ V9 + IZ35785 | OK | OK - 6.1 TL1 32 bit | XL C/C++ V10 | OK | OK - 6.1 TL1 64 bit + IZ39077 | XL C/C++ V10 | OK | OK - - w th = with thread - w/o th = without thread - -Successfully tested means that all make test runs with an result of 100% OK. -All tests were conducted with -Duseshrplib set. +=head2 Incompatibility with AIX Toolbox lib gdbm + +If the AIX Toolbox version of lib gdbm < 1.8.3-5 is installed on your +system then Perl will not work. This library contains the header files +/opt/freeware/include/gdbm/dbm.h|ndbm.h which conflict with the AIX +system versions. The lib gdbm will be automatically removed from the +wanted libraries if the presence of one of these two header files is +detected. If you want to build Perl with GDBM support then please install +at least gdbm-devel-1.8.3-5 (or higher). + +=head2 Perl 5 was successfully compiled and tested on: + + Perl | AIX Level | Compiler Level | w th | w/o th + -------+---------------------+-------------------------+------+------- + 5.12.2 |5.1 TL9 32 bit | XL C/C++ V7 | OK | OK + 5.12.2 |5.1 TL9 64 bit | XL C/C++ V7 | OK | OK + 5.12.2 |5.2 TL10 SP8 32 bit | XL C/C++ V8 | OK | OK + 5.12.2 |5.2 TL10 SP8 32 bit | gcc 3.2.2 | OK | OK + 5.12.2 |5.2 TL10 SP8 64 bit | XL C/C++ V8 | OK | OK + 5.12.2 |5.3 TL8 SP8 32 bit | XL C/C++ V9 + IZ35785 | OK | OK + 5.12.2 |5.3 TL8 SP8 32 bit | gcc 4.2.4 | OK | OK + 5.12.2 |5.3 TL8 SP8 64 bit | XL C/C++ V9 + IZ35785 | OK | OK + 5.12.2 |5.3 TL10 SP3 32 bit | XL C/C++ V11 + Apr 2010 | OK | OK + 5.12.2 |5.3 TL10 SP3 64 bit | XL C/C++ V11 + Apr 2010 | OK | OK + 5.12.2 |6.1 TL1 SP7 32 bit | XL C/C++ V10 | OK | OK + 5.12.2 |6.1 TL1 SP7 64 bit | XL C/C++ V10 | OK | OK + 5.13 |7.1 TL0 SP1 32 bit | XL C/C++ V11 + Jul 2010 | OK | OK + 5.13 |7.1 TL0 SP1 64 bit | XL C/C++ V11 + Jul 2010 | OK | OK + + w th = with thread support + w/o th = without thread support + OK = tested + +Successfully tested means that all "make test" runs finish with a +result of 100% OK. All tests were conducted with -Duseshrplib set. + +All tests were conducted on the oldest supported AIX technology level +with the latest support package applied. If the tested AIX version is +out of support (AIX 4.3.3, 5.1, 5.2) then the last available support +level was used. =head2 Building Dynamic Extensions on AIX -Starting from Perl 5.7.2 (and consequently 5.8.x / 5.10.x) and AIX 4.3 -or newer Perl uses the AIX native dynamic loading interface in the so -called runtime linking mode instead of the emulated interface that was -used in Perl releases 5.6.1 and earlier or, for AIX releases 4.2 and -earlier. This change does break backward compatibility with compiled -modules from earlier Perl releases. The change was made to make Perl -more compliant with other applications like Apache/mod_perl which are -using the AIX native interface. This change also enables the use of -C++ code with static constructors and destructors in Perl extensions, +Starting from Perl 5.7.2 (and consequently 5.8.x / 5.10.x / 5.12.x) +and AIX 4.3 or newer Perl uses the AIX native dynamic loading interface +in the so called runtime linking mode instead of the emulated interface +that was used in Perl releases 5.6.1 and earlier or, for AIX releases +4.2 and earlier. This change does break backward compatibility with +compiled modules from earlier Perl releases. The change was made to make +Perl more compliant with other applications like Apache/mod_perl which are +using the AIX native interface. This change also enables the use of +C++ code with static constructors and destructors in Perl extensions, which was not possible using the emulated interface. It is highly recommended to use the new interface. @@ -100,23 +125,25 @@ Should yield no problems. =head2 Threaded Perl -Should yield no problems with AIX 5.1 / 5.2 / 5.3 and 6.1. +Should yield no problems with AIX 5.1 / 5.2 / 5.3 / 6.1 / 7.1. IBM uses the AIX system Perl (V5.6.0 on AIX 5.1 and V5.8.2 on -AIX 5.2 / 5.3 and 6.1) for some AIX -system scripts. If you switch the links in /usr/bin from the -AIX system Perl (/usr/opt/perl5) to the newly build Perl then you -get the same features as with the IBM AIX system Perl if the -threaded options are used. +AIX 5.2 / 5.3 and 6.1; V5.8.8 on AIX 5.3 TL11 and AIX 6.1 TL4; V5.10.1 +on AIX 7.1) for some AIX system scripts. If you switch the links in +/usr/bin from the AIX system Perl (/usr/opt/perl5) to the newly build +Perl then you get the same features as with the IBM AIX system Perl if +the threaded options are used. The threaded Perl build works also on AIX 5.1 but the IBM Perl build (Perl v5.6.0) is not threaded on AIX 5.1. +Perl 5.12 an newer is not compatible with the IBM fileset perl.libext. + =head2 64-bit Perl If your AIX system is installed with 64-bit support, you can expect 64-bit configurations to work. If you want to use 64-bit Perl on AIX 6.1 -you need a APAR for a libc.a bug which affects (n)dbm_XXX functions. +you need an APAR for a libc.a bug which affects (n)dbm_XXX functions. The APAR number for this problem is IZ39077. If you need more memory (larger data segment) for your Perl programs you @@ -124,12 +151,29 @@ can set: /etc/security/limits default: (or your user) - data = -1 (default is 262144 * 512 byte) + data = -1 (default is 262144 * 512 byte) With the default setting the size is limited to 128MB. -The -1 removes this limit. +The -1 removes this limit. If the "make test" fails please change +your /etc/security/limits as stated above. + +=head2 Long doubles + +IBM calls its implementation of long doubles 128-bit, but it is not +the IEEE 128-bit ("quadruple precision") which would give 116 bit of +mantissa (nor it is implemented in hardware), instead it's a special +software implementation called "double-double", which gives 106 bits +of mantissa. -=head2 Recommended Options AIX 5.1/5.2/5.3 and 6.1 (threaded/32-bit) +There seem to be various problems in this long double implementation. +If Configure detects this brokenness, it will disable the long double support. +This can be overriden with explicit C<-Duselongdouble> (or C<-Dusemorebits>, +which enables both long doubles and 64 bit integers). If you decide to +enable long doubles, for most of the broken things Perl has implemented +workarounds, but the handling of the special values infinity and NaN +remains badly broken: for example infinity plus zero results in NaN. + +=head2 Recommended Options AIX 5.1/5.2/5.3/6.1 and 7.1 (threaded/32-bit) With the following options you get a threaded Perl version which passes all make tests in threaded 32-bit mode, which is the default @@ -146,7 +190,7 @@ configuration for the Perl builds that AIX ships with. The -Dprefix option will install Perl in a directory parallel to the IBM AIX system Perl installation. -=head2 Recommended Options AIX 5.1/5.2/5.3 and 6.1 (32-bit) +=head2 Recommended Options AIX 5.1/5.2/5.3/6.1 and 7.1 (32-bit) With the following options you get a Perl version which passes all make tests in 32-bit mode. @@ -161,51 +205,60 @@ all make tests in 32-bit mode. The -Dprefix option will install Perl in a directory parallel to the IBM AIX system Perl installation. -=head2 Recommended Options AIX 5.1/5.2/5.3 and 6.1 (threaded/64-bit) +=head2 Recommended Options AIX 5.1/5.2/5.3/6.1 and 7.1 (threaded/64-bit) With the following options you get a threaded Perl version which passes all make tests in 64-bit mode. - export OBJECT_MODE=64 / setenv OBJECT_MODE 64 (depending on your shell) + export OBJECT_MODE=64 / setenv OBJECT_MODE 64 (depending on your shell) - rm config.sh - ./Configure \ - -d \ - -Dcc=cc_r \ - -Duseshrplib \ - -Dusethreads \ - -Duse64bitall \ - -Dprefix=/usr/opt/perl5_64 + rm config.sh + ./Configure \ + -d \ + -Dcc=cc_r \ + -Duseshrplib \ + -Dusethreads \ + -Duse64bitall \ + -Dprefix=/usr/opt/perl5_64 -=head2 Recommended Options AIX 5.1/5.2/5.3 and 6.1(64-bit) +=head2 Recommended Options AIX 5.1/5.2/5.3/6.1 and 7.1 (64-bit) -With the following options you get a Perl version which passes all +With the following options you get a Perl version which passes all make tests in 64-bit mode. - export OBJECT_MODE=64 / setenv OBJECT_MODE 64 (depending on your shell) - - rm config.sh - ./Configure \ - -d \ - -Dcc=cc_r \ - -Duseshrplib \ - -Duse64bitall \ - -Dprefix=/usr/opt/perl5_64 + export OBJECT_MODE=64 / setenv OBJECT_MODE 64 (depending on your shell) -The -Dprefix option will install Perl in a directory parallel to the + rm config.sh + ./Configure \ + -d \ + -Dcc=cc_r \ + -Duseshrplib \ + -Duse64bitall \ + -Dprefix=/usr/opt/perl5_64 + +The -Dprefix option will install Perl in a directory parallel to the IBM AIX system Perl installation. -If you choose gcc to compile 64-bit Perl then you need to use the -following options: +If you choose gcc to compile 64-bit Perl then you need to add the +following option: -Dcc='gcc -maix64' +=head2 Compiling Perl 5 on AIX 7.1.0 + +A regression in AIX 7 causes a failure in make test in Time::Piece during +daylight savings time. APAR IV16514 provides the fix for this. A quick +test to see if it's required, assuming it is currently daylight savings +in Eastern Time, would be to run C< TZ=EST5 date +%Z >. This will come +back with C normally, but nothing if you have the problem. + + =head2 Compiling Perl 5 on older AIX versions up to 4.3.3 -Due to the fact that AIX 4.3.3 reached end-of-service in December 31, -2003 this information is provided as is. The Perl versions prior to -Perl 5.8.9 could be compiled on AIX up to 4.3.3 with the following +Due to the fact that AIX 4.3.3 reached end-of-service in December 31, +2003 this information is provided as is. The Perl versions prior to +Perl 5.8.9 could be compiled on AIX up to 4.3.3 with the following settings (your mileage may vary): When compiling Perl, you must use an ANSI C compiler. AIX does not ship @@ -266,7 +319,7 @@ cannot be built without bos.adt.syscalls and bos.adt.libm installed bos.adt.syscalls 5.1.0.36 COMMITTED System Calls Application # -=head2 Building Dynamic Extensions on AIX +=head2 Building Dynamic Extensions on AIX E 5L AIX supports dynamically loadable objects as well as shared libraries. Shared libraries by convention end with the suffix .a, which is a bit @@ -304,7 +357,8 @@ in the developer snapshots of Perl), or to one version up where the cumulative. vac.C.4.4.0.1 => vac.C.4.4.0.3 is OK (vac.C.4.4.0.2 not needed) - xlC.C.3.1.3.3 => xlC.C.3.1.4.10 is NOT OK (xlC.C.3.1.4.0 is not available) + xlC.C.3.1.3.3 => xlC.C.3.1.4.10 is NOT OK (xlC.C.3.1.4.0 is not + available) # ftp ftp.software.ibm.com Connected to service.boulder.ibm.com. @@ -336,16 +390,16 @@ On AIX 4.2 using xlC, we continue: xlC.C 3.1.4.9 COMMITTED C for AIX Compiler xlC.C 3.1.4.0 COMMITTED C for AIX Compiler # grep 'xlC.C.3.1.4.*.bff' xlc.ll - -rw-r--r-- 1 45776101 1 6286336 Jul 22 1996 xlC.C.3.1.4.1.bff - -rw-rw-r-- 1 45776101 1 6173696 Aug 24 1998 xlC.C.3.1.4.10.bff - -rw-r--r-- 1 45776101 1 6319104 Aug 14 1996 xlC.C.3.1.4.2.bff - -rw-r--r-- 1 45776101 1 6316032 Oct 21 1996 xlC.C.3.1.4.3.bff - -rw-r--r-- 1 45776101 1 6315008 Dec 20 1996 xlC.C.3.1.4.4.bff - -rw-rw-r-- 1 45776101 1 6178816 Mar 28 1997 xlC.C.3.1.4.5.bff - -rw-rw-r-- 1 45776101 1 6188032 May 22 1997 xlC.C.3.1.4.6.bff - -rw-rw-r-- 1 45776101 1 6191104 Sep 5 1997 xlC.C.3.1.4.7.bff - -rw-rw-r-- 1 45776101 1 6185984 Jan 13 1998 xlC.C.3.1.4.8.bff - -rw-rw-r-- 1 45776101 1 6169600 May 27 1998 xlC.C.3.1.4.9.bff + -rw-r--r-- 1 45776101 1 6286336 Jul 22 1996 xlC.C.3.1.4.1.bff + -rw-rw-r-- 1 45776101 1 6173696 Aug 24 1998 xlC.C.3.1.4.10.bff + -rw-r--r-- 1 45776101 1 6319104 Aug 14 1996 xlC.C.3.1.4.2.bff + -rw-r--r-- 1 45776101 1 6316032 Oct 21 1996 xlC.C.3.1.4.3.bff + -rw-r--r-- 1 45776101 1 6315008 Dec 20 1996 xlC.C.3.1.4.4.bff + -rw-rw-r-- 1 45776101 1 6178816 Mar 28 1997 xlC.C.3.1.4.5.bff + -rw-rw-r-- 1 45776101 1 6188032 May 22 1997 xlC.C.3.1.4.6.bff + -rw-rw-r-- 1 45776101 1 6191104 Sep 5 1997 xlC.C.3.1.4.7.bff + -rw-rw-r-- 1 45776101 1 6185984 Jan 13 1998 xlC.C.3.1.4.8.bff + -rw-rw-r-- 1 45776101 1 6169600 May 27 1998 xlC.C.3.1.4.9.bff # wget ftp://ftp.software.ibm.com/aix/fixes/v4/xlc/xlC.C.3.1.4.10.bff # @@ -355,10 +409,10 @@ On AIX 4.3 using vac, we continue: vac.C 5.0.2.2 COMMITTED C for AIX Compiler vac.C 5.0.2.0 COMMITTED C for AIX Compiler # grep 'vac.C.5.0.2.*.bff' other.ll - -rw-rw-r-- 1 45776101 1 13592576 Apr 16 2001 vac.C.5.0.2.0.bff - -rw-rw-r-- 1 45776101 1 14133248 Apr 9 2002 vac.C.5.0.2.3.bff - -rw-rw-r-- 1 45776101 1 14173184 May 20 2002 vac.C.5.0.2.4.bff - -rw-rw-r-- 1 45776101 1 14192640 Nov 22 2002 vac.C.5.0.2.6.bff + -rw-rw-r-- 1 45776101 1 13592576 Apr 16 2001 vac.C.5.0.2.0.bff + -rw-rw-r-- 1 45776101 1 14133248 Apr 9 2002 vac.C.5.0.2.3.bff + -rw-rw-r-- 1 45776101 1 14173184 May 20 2002 vac.C.5.0.2.4.bff + -rw-rw-r-- 1 45776101 1 14192640 Nov 22 2002 vac.C.5.0.2.6.bff # wget ftp://ftp.software.ibm.com/aix/fixes/v4/other/vac.C.5.0.2.6.bff # @@ -392,7 +446,8 @@ causes error like this ld: 0711-317 ERROR: Undefined symbol: .setresuid ld: 0711-317 ERROR: Undefined symbol: .setresgid ld: 0711-317 ERROR: Undefined symbol: .setproctitle - ld: 0711-345 Use the -bloadmap or -bnoquiet option to obtain more information. + ld: 0711-345 Use the -bloadmap or -bnoquiet option to obtain more + information. you could retry with @@ -414,18 +469,19 @@ Linux compatibility packages, available here: http://www.ibm.com/servers/aix/products/aixos/linux/ -=head2 Using Large Files with Perl +=head2 Using Large Files with Perl E 5L Should yield no problems. -=head2 Threaded Perl +=head2 Threaded Perl E 5L Threads seem to work OK, though at the moment not all tests pass when threads are used in combination with 64-bit configurations. You may get a warning when doing a threaded build: - "pp_sys.c", line 4640.39: 1506-280 (W) Function argument assignment between types "unsigned char*" and "const void*" is not allowed. + "pp_sys.c", line 4640.39: 1506-280 (W) Function argument assignment + between types "unsigned char*" and "const void*" is not allowed. The exact line number may vary, but if the warning (W) comes from a line line this @@ -437,7 +493,7 @@ is caused by the reentrant variant of gethostbyaddr() having a slightly different prototype than its non-reentrant variant, but the difference is not really significant here. -=head2 64-bit Perl +=head2 64-bit Perl E 5L If your AIX is installed with 64-bit support, you can expect 64-bit configurations to work. In combination with threads some tests might @@ -455,11 +511,6 @@ therefore in AIX 4.2 Perl is not linked against the libC_r. =head1 AUTHORS -H.Merijn Brand Rainer Tammer -=head1 DATE - -Version 0.0.8: 01 Dec 2008 - =cut