FPC AIX Port: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		# Overview
2	2
3	3		As of revision 20851, FPC svn trunk supports targeting the AIX operating system.
4	4
5	5		AIX is a UNIX platform and hence treated like one by FPC. As of revision 21053, FPC can create both AIX/PowerPC 32 bit and AIX/PowerPC64 applications and libraries. Note that gcc and xlc on AIX by default generate 32 bit code. The reason is that on PowerPC, 32 bit programs are usually faster and use less memory than 64 bit ones.
6	6
7	7		# Snapshots
8	8
9	9		An initial snapshot is available in two flavours: a native AIX compiler, and a cross-compiler from Windows. Note that these are not compiled from the version that was committed to svn, but from a slightly older version. It is unlikely that future binary snapshots will be created (unless someone volunteers), but as of the next major release, (native) AIX compilers will be included;
10	10
11	11		- [Native AIX/PowerPC snapshot](ftp://ftp.freepascal.org/pub/fpc/contrib/aix/fpc-2.7.1.powerpc-aix-native-snapshot1.tbz)
12	12		- [Win32-\>AIX/PowerPC cross-snapshot](ftp://ftp.freepascal.org/pub/fpc/contrib/aix/fpc-2.7.1.powerpc-aix-win32.zip) (including cross-binutils -- Warning: FPC 3.0 and later require [newer binutils](ftp://ftp.freepascal.org/pub/fpc/contrib/aix/binutils%202.25.1-powerpc-aix-win32.zip))
13	13
14	14		# Port information
15	15
16	16		## Required helper tools
17	17
18	18		To compile the compiler on AIX, you must have the AIX assembler and linker installed, as well as GNU diffutils and GNU make.
19	19
20	20		To cross-compile from other platforms, you need the GNU BinUtils configured as follows:
21	21
22		-	~~` ./configure --target=powerpc-ibm-aix5.3 --with-sysroot`~~
	22	+	```text
	23	+	./configure --target=powerpc-ibm-aix5.3 --with-sysroot
	24	+	```
23	25
24	26		Note that the extra "5.3" at the end is required. Afterwards, rename the generated binaries from powerpc-ibm-aix5.3-as etc to powerpc-aix-as, as those are the names that the compiler expects (-XPpowerpc-ibm-aix5.3- won't work, as the compiler currently does not support dots in prefixes).
25	27
26	28		## Debugger
27	29
28	30		AIX uses its own debugging format, Stabx. As the name implies, this is a variant of the regular Stabs format, but it has some differences. GDB on AIX does not fully support the Stabx format, but instead supports a hybrid format between regular Stabs and Stabx, which is also generated by GCC. FPC generates this same hybrid information. The result is that FPC-generated binaries compiled with debug information can be debugged by GDB on AIX, but not (fully) by DBX, the native AIX debugger.
29	31
30	32		The default GDB compiles without any problems on AIX. A compiled version of GDB 7.3.1 for AIX can also be downloaded from [our ftp site](ftp://ftp.freepascal.org/pub/fpc/contrib/aix/gdb-7.3.1-aix5.3.tar.bz2).
31	33
32	34		## Line info unit for symbolicating backtraces
33	35
34	36		No support has been added (yet) for the AIX debugging format (Stabx) to the lineinfo unit. Instead, when compiling with -gl, the resulting binary will launch gdb to symbolicate backtraces. This can cause trouble if you are debugging a program compiled with -gl, since this newly launched will not be able to attach to the process in that case. The reason is that a process can only be debugged by one debugger at a time.
35	37
36	38		## Assembler/linker
37	39
38	40		When compiling/linking an AIX program/library on a platform other than AIX, FPC assumes that the used assembler and linker are from the GNU BinUtils. When compiling/linking an AIX program/library on AIX itself, only the native AIX assembler and linker are supported. The reason is that the native and GNU BinUtils linker require the object files to be specified in a different way, and we differentiate between the two based on the target OS on which the program has to be linked.
39	41
40	42		## Cross-compiling
41	43
42	44		When cross-compiling, you not only need cross-BinUtils as explained above, but also a copy of the AIX libraries from the target system. These libraries are located in /usr/lib on the AIX system. On your build system, create a directory hierarchy like this:
43	45
44		-	~~` aixroot/`\~~
45		-	~~` aixroot/usr/`\~~
46		-	~~` aixroot/usr/lib/`~~
	46	+	```text
	47	+	aixroot/
	48	+	aixroot/usr/
	49	+	aixroot/usr/lib/
	50	+	```
47	51
48	52		After copying the contents of /usr/lib on the AIX system to aixroot/usr/lib to your build system, create a symbolic link called lib in the aixroot directory that points to usr/lib. If you are on a system that does not support symbolic links, you can simply create a directory called lib in aixroot and copy usr/lib/.o* into this lib directory.
49	53
50	54		Finally, when compiling for AIX always specify the full path to this aixroot directory via -XR/full/path/to/aixroot to the compiler.
51	55
52	56		## Supported OS versions
53	57
54	58		IBM supports backward compatibility as long as you only use the system libraries for OS interfacing, which is what FPC does. The compiler and test suite have been verified as working on AIX 5.3, and hence should work on AIX 5.3 and later.
55	59
56	60		# AIX quirks
57	61
58	62		## Reading from NULL pointers
59	63
60	64		AIX does not raise an exception when reading from NULL pointers and other low addresses (up to 16KB on a test system, but there is no documentation about the upper limit). The reason is that this allows compilers to speculatively dereference pointers while scheduling code before NULL pointer checks. Writing to NULL pointers or other low addresses will still result in segmentation faults like on other supported platforms.
61	65
62	66		There is no system option to disable this behaviour. Since IBM's compiler makes extensive use of this property, doing so would result in many application crashes anyway since the system libraries have been compiled with this assumption.
63	67
64	68		FPC has added an extra code generation option titled -CN that instructs the compiler to add additional code to check that memory reads do not load data from such low addresses. If such an access is detected, a run time error 216 will be raised.
65	69
66	70		## Unicode/code page support
67	71
68	72		Like on other UNIX and UNIX-like platforms, for unicodestring support FPC requires that libiconv functionality is available. On AIX, this library is not always installed by default. If it is not available, you can install it using the bos.rte.iconv package. Also install the bos.iconv.ucs.pc package if you want to support common Windows code pages.
69	73
70	74		AIX' libiconv is somewhat more limited than libiconv on most other platforms. In particular, its libiconv supports code page 866 only when converting from or to ISO-8859-5. These code pages both support the same Cyrillic characters, but are different in terms of special characters. This means that converting from UTF-8/16/32 to code page 866 will be lossy as far as those special characters are concerned.
71	75
72	76		## Maximum number of processes/threads
73	77
74	78		By default, the maximum number of processes per user may be fairly limited (128 on a test system). Individual threads count as a process in this context. You can increase this limit by executing smit chgsys as superuser and then changing the Maximum number of PROCESSES allowed per user setting.
75	79
76	80		## Maximum amount of memory per process
77	81
78	82		By default, the maximum amount of memory that a single process can allocate may be fairly limited (128MB on a test system). You can increase this amount by setting the LDR_CNTRL environment variable. E.g., export LDR_CNTRL=MAXDATA=0x20000000 in a Bourne sh-compatible shell will increase this amount to 256MB. See [IBM's site](http://publib.boulder.ibm.com/infocenter/javasdk/v6r0/index.jsp?topic=%2Fcom.ibm.java.doc.user.aix32.60%2Fuser%2Faix_auto_ldr_cntrl.html) for more information.
79	83
80	84		## Shared library initialisation order
81	85
82	86		AIX does not guarantee the order in which dynamic libraries are loaded and initialised. In particular, its dynamic linker/loader does not follow library dependency chains and will not automatically initialise dependent libraries before others. AIX does however allow you to manually [define priorities](http://publib.boulder.ibm.com/infocenter/comphelp/v111v131/index.jsp?topic=%2Fcom.ibm.xlcpp111.aix.doc%2Fproguide%2Finit_module.html) for each library to influence this initialization order. Getting this to work properly is however not easy.
83	87
84	88		# Getting access to an AIX system
85	89
86	90		## Via the GCC compile farm
87	91
88	92		The [GCC compile farm](http://gcc.gnu.org/wiki/CompileFarm) offers free accounts to all developers of free and open source software packages for testing. Recently they added an AIX server to the pool of available machines. Note that many of the GNU utilities required to build and test FPC are not installed on that machine. You can work around that by adding /home/muller/bin to your path :)
89	93
90	94		## Via IBM
91	95
92	96		Companies can register (for free) to become a member of the [IBM PartnerWorld program](http://www.ibm.com/partnerworld). The only downside is that you cannot disable getting their (regular) commercial emails on your primary contact address.
93	97
94	98		Once you are a PartnerWorld member, you can (for free) make use of their [Power Development Program](http://www.ibm.com/partnerworld/wps/pub/systems/vlp). This program provides you with remote access via VPN to virtual machines running various versions of or Linux and AIX on various kinds of POWER processors (POWER 5, 6, 7 and 8). You have full root access to these VMs, and they can run continuously for up to 14 days at a time. You can however (automatically) save the contents of your virtual disk image on IBM's servers for use during subsequent reservations.
95	99
96	100		---
97	101		From the Free Pascal wiki, page "FPC AIX Port", as it stood on 2016-01-21 after a change by Jonas, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
98	102		Category: AIX
99	103		Category: FPC

Back to history