This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
better messages from malloc()
[perl5.git] / README.aix
CommitLineData
20d11268
MB
1If you read this file _as_is_, just ignore the funny characters you see.
2It is written in the POD format (see pod/perlpod.pod) which is specially
3designed to be readable as is.
4
5=head1 NAME
6
7README.aix - Perl version 5 on IBM Unix (AIX) systems
8
9=head1 DESCRIPTION
10
11This document describes various features of IBM's Unix operating system
12(AIX) that will affect how Perl version 5 (hereafter just Perl) is
13compiled and/or runs.
14
15=head2 Compiling Perl 5 on AIX
16
d5d9880c 17When compiling Perl, you must use an ANSI C compiler. AIX does not ship
20d11268
MB
18an ANSI compliant C-compiler with AIX by default, but binary builds of
19gcc for AIX are widely available.
20
21At the moment of writing, AIX supports two different native C compilers,
22for which you have to pay: B<xlc> and B<VAC>. If you decide to use eiter
23of these two (which is quite a lot easier than using gcc), be sure to
24upgrade to the latest available patch level. Currently:
25
26 xlC.C 3.1.4.0
27 vac.C 4.4.0.3 (5.0 is already available)
28
29Perl can be compiled with either IBM's ANSI C compiler or with gcc. The
30former is recommended, as not only can it compile Perl with no
31difficulty, but also can take advantage of features listed later that
32require the use of IBM compiler-specific command-line flags.
33
34If you decide to use gcc, make sure your installation is recent and
35complete, and be sure to read the Perl README file for more gcc-specific
36details.
37
38=head2 OS level
39
40Before installing the patches to the IBM C-compiler you need to know the
41level of patching for the Operating System. IBM's command 'oslevel' will
42show the base, but is not allways complete:
43
44 # oslevel
45 4.3.0.0
46 # lslpp -l | grep 'bos.rte '
47 bos.rte 4.3.2.1 COMMITTED Base Operating System Runtime
48 bos.rte 4.3.2.0 COMMITTED Base Operating System Runtime
49 #
50
51=head2 Building Dynamic Extensions on AIX
52
53AIX supports dynamically loadable libraries (shared libraries).
54Shared libraries end with the suffix .a, which is a bit misleading,
55cause *all* libraries are shared ;-).
56
57=head2 The IBM ANSI C Compiler
58
59All defaults for Configure can be used.
60
61If you've chosen to use vac 4, be sure to run 4.4.0.3. Older versions
62will turn up nasty later on.
63
64=head2 Using GNU's gcc for building perl
65
66... ?
67
68Wait, I'll have to scan perlbug ...
69
70=head2 Using Large Files with Perl
71
72... ?
73
74=head2 Threaded Perl
75
76... ?
77
78=head2 64-bit Perl
79
80... ?
81
82=head2 GDBM and Threads
83
84... ?
85
86=head2 NFS filesystems and utime(2)
87
88... ?
89
90=head1 AUTHOR
91
92H.Merijn Brand <h.m.brand@hccnet.nl>
93
94Structure copied from README.hpux
95
96=head1 DATE
97
98Version 0.0.1: 16-10-2000
99
100=cut