1Some notes for the AIX port
2===========================
3
41. Known problems
5-----------------
6
7There are the following known problems on AIX:
8
91) Shared libraries / embedded perl
10
11Up to (and including) net-snmp 5.4, configure forced a static build
12on AIX which caused embedded Perl to be disabled as well.
13
14Starting with net-snmp 5.4.1, we build shared libraries by default on AIX
15(like on any other platform) using run-time linking. configure forces the
16use of the required "-brtl" linker flag.
17
18With net-snmp 5.5 the shared library build is broken again but the there is
19no forced static build - use --disable-shared when building.
20
212) "grep: capacity exceeded" or "sed: Command line is too long" during configure
22
23The version of "grep" shipped with AIX versions up to (and including) 5.1
24has a known limitation of only supporting a maximum of 2048 characters per line.
25This may cause a significant number of "grep: capacity exceeded" errors during
26configure which breaks the build. See bug 1367794 for details. The fix is to
27either install GNU grep (and have it in PATH before the AIX grep) or to upgrade
28to AIX 5.2 or later.
29
30There's a similar issue with AIX /usr/bin/sed up to at least AIX 5.3 that
31causes a significant number of "sed: Command line is too long." errors during
32configure. The fix is to install GNU sed.
33
343) nlist errors with 64-bit kernels
35
36Accessing certain MIB objects on AIX 5.x machines running a 64-bit kernel will
37trigger nlist/klookup errors. Starting from net-snmp 5.4, you can avoid those
38by using
39
40   ./configure --without-kmem-usage ...
41
42
434) IPv6
44
45Starting with net-snmp 5.4 you can enable the UDPIPv6 and TCPIPv6 transports
46on AIX 5.x:
47
48   ./configure --enable-ipv6
49
50There's no support for the IPv6 MIBs, though.
51
525) Compiler for Perl
53
54In general, Perl modules need to be compiled with the same compiler and
55compiler options as Perl itself. configure detects some mismatches (gcc vs.
56vendor compiler), but treats different incarnations of the same compiler type
57as similar. If your version of Perl (e.g. the one supplied by IBM for AIX 5.x)
58has been compiled with cc_r on AIX, please make sure you also use CC=cc_r when
59building net-snmp. Building with xlc in this case is known to fail (see bug
60#1600099).
61
62
632. Patches
64----------
65
66You may want to have a look for existing AIX patches in our patches tracker
67(http://www.net-snmp.org/patches/). If you can offer patches yourself to
68improve the AIX support, please submit them there.
69
70
713. Feedback
72-----------
73
74Please also see README and PORTING.
75
76If you have questions, additional insights or (even better) patches regarding
77net-snmp on AIX, please refer to the net-snmp mailing lists (see
78http://www.net-snmp.org/lists).
79