Make scan_num() reëntrant, as suggested in
[p5sagit/p5-mst-13.2.git] / README.aix
1 If you read this file _as_is_, just ignore the funny characters you see.
2 It is written in the POD format (see pod/perlpod.pod) which is specially
3 designed to be readable as is.
4
5 =head1 NAME
6
7 README.aix - Perl version 5 on IBM Unix (AIX) systems
8
9 =head1 DESCRIPTION
10
11 This document describes various features of IBM's Unix operating system
12 (AIX) that will affect how Perl version 5 (hereafter just Perl) is
13 compiled and/or runs.
14
15 =head2 Compiling Perl 5 on AIX
16
17 When compiling Perl, you must use an ANSI C compiler. AIX does not shif
18 an ANSI compliant C-compiler with AIX by default, but binary builds of
19 gcc for AIX are widely available.
20
21 At the moment of writing, AIX supports two different native C compilers,
22 for which you have to pay: B<xlc> and B<VAC>. If you decide to use eiter
23 of these two (which is quite a lot easier than using gcc), be sure to
24 upgrade 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
29 Perl can be compiled with either IBM's ANSI C compiler or with gcc.  The
30 former is recommended, as not only can it compile Perl with no
31 difficulty, but also can take advantage of features listed later that
32 require the use of IBM compiler-specific command-line flags.
33
34 If you decide to use gcc, make sure your installation is recent and
35 complete, and be sure to read the Perl README file for more gcc-specific
36 details.
37
38 =head2 OS level
39
40 Before installing the patches to the IBM C-compiler you need to know the
41 level of patching for the Operating System. IBM's command 'oslevel' will
42 show 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
53 AIX supports dynamically loadable libraries (shared libraries).
54 Shared libraries end with the suffix .a, which is a bit misleading,
55 cause *all* libraries are shared ;-).
56
57 =head2 The IBM ANSI C Compiler
58
59 All defaults for Configure can be used.
60
61 If you've chosen to use vac 4, be sure to run 4.4.0.3. Older versions
62 will turn up nasty later on.
63
64 =head2 Using GNU's gcc for building perl
65
66 ... ?
67
68 Wait, 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
92 H.Merijn Brand <h.m.brand@hccnet.nl>
93
94 Structure copied from README.hpux
95
96 =head1 DATE
97
98 Version 0.0.1: 16-10-2000
99
100 =cut