================================================================================ ================================================================================ Below you will find the last revision of the README file for AIX version 4.3.3. No further changes will be made with respect to 4.3.3. No further Toolbox images will be provided or updated for AIX Version 4.3.3 -- future images will be built for AIX 5L only. This file and most of the AIX 4.3.3 rpm images are still available for those who choose to stay on this older unsupported AIX level. There are no imminent plans to remove the 4.3.3 rpm images, however they are subject to removal at any time without notice. A file listing all of the final images for 4.3.3 rpms can be found at: ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/data/433.finallist ================================================================================ ================================================================================ AIX Toolbox for Linux Applications README Jan 13, 2004 ================================================================================ The freeware packages ("Code") provided here are distributed by IBM as a convenience to our customers. IBM does not own the Code, and did not develop or exhaustively test the Code. IBM does not provide support for the Code. IBM has compiled the Code so that it will run with AIX 4.3.3.0 and AIX 5L. Each Code package is distributed by IBM subject to the terms of the license that is included in the Code package. IBM has extracted the license information associated with the Code packages for viewing convenience, but in all cases the actual licenses delivered with the Code package govern the use of the Code package. By downloading a particular package you agree to accept and comply with the license terms that accompany such package. No Warranty: The Code is provided by IBM "AS IS." TO THE EXTENT PERMITTED BY APPLICABLE LAW, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTY OF NON-INFRINGEMENT AND THE IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE REGARDING THE CODE OR TECHNICAL SUPPORT, IF ANY. ' This exclusion also applies to any of IBM's subcontractors, suppliers, or program developers (collectively called "Suppliers"). Limitation of Liability: NEITHER IBM NOR ITS SUPPLIERS ARE LIABLE FOR ANY DIRECT OR INDIRECT DAMAGES, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST SAVINGS, OR ANY INCIDENTAL, SPECIAL, OR OTHER ECONOMIC CONSEQUENTIAL DAMAGES, EVEN IF IBM IS INFORMED OF THEIR POSSIBILITY. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE EXCLUSION OR LIMITATION MAY NOT APPLY TO YOU. ================================================================================ Information on the Web A public mailing list and bug reporting system is in place for the AIX Toolbox for Linux Applications ("the Toolbox"): http://oss.software.ibm.com/developerworks/projects/aixtoolbox Click on the "Lists" tab to subscribe. To send to the mailing list, send mail to aixtoolbox-list@oss.software.ibm.com. You must subscribe to the list in order to send mail to the list. New software and new versions of existing software will become available on a regular basis. The new files can be accessed via the AIX Toolbox web site at http://www.ibm.com/servers/aix/products/aixos/linux/. Only the most current versions are available for download through the web site. Older versions are retained, though not necessarily permanently, on the ftp site at ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox. ================================================================================ Testing Statement The software in the Toolbox is "as-is" and does not receive the extensive testing as AIX software, nor does the software necessarily have the same degree of support for standards, internationalization, accessibility, scalability as found with AIX software. ================================================================================ CONTENTS Included in this delivery are the RPM package manager (RPM), compilers (gcc and g++), a substantial number of GNU utilities, the GNOME desktop, the KDE desktop, and many other useful utilities, applications, shells, window managers, libraries, and languages. The current list of available packages may be found in the CONTENTS file in the top-level directory of the Toolbox (either on CD or at the ftp site). Included in this README are: REMOVE EXISTING RPMS IF rpm.rte INSTALLED AT LEVEL LESS THAN 3.0.5.20 Toolbox Installation Instructions Installing Additional Software Using GNOME as your desktop Using KDE as your desktop Some known problems Other Packages (not on the CD) Building against many libraries requires the use of run-time linking (-rtl) How to report problems How to submit suggestions AIX/Linux API and Commands Differences Build Environment Used to Produce Toolbox Applications Frequently Asked Questions ================================================================================ REMOVE EXISTING RPMS IF rpm.rte INSTALLED AT LEVEL LESS THAN 3.0.5.20 If you previously installed the AIX Toolbox from the beta marketing CD from December 2000 or downloaded from the web, then you will need to reinstall that software. If you run "lslpp -L rpm.rte" and the level is less than 3.0.5.20, then the existing software from the Toolbox will be incompatible with software from this delivery due to shared library changes. These changes will greatly improve compatibility with other freeware built for AIX, enable versioning support for shared objects, and align the Toolbox deliverables with future directions in open source shared object generation via the libtool utilities. A script is provided in the /contrib directory to perform this operation for you. The script will remove your installed RPM packages and the previously installed version of rpm.rte. Run "ksh contrib/destroyRPMS" from the Toolbox if you have rpm.rte installed at a level less than 3.0.5.20. You will see some error messages as described in the "Some Known Problems and Limitations" section. The script will produce a /var/adm/sw/removedrpms file which will record your previously installed RPMs to aid you in getting your system reinstalled. You can use the contrib/installremoved.sh utility to reinstall any remaining RPMS which were previously installed but which are not installed on the current system. You should read the "Toolbox Installation Instructions" section for information on installing the toolbox rather than simply attempting to reinstall new versions of the previously installed software. Background information: Many open source projects did not produce shared objects in a proper form for AIX without substantial modification. Some did produce shared objects with .so suffixes, but under normal circumstances the AIX 4.3 linker does not search for files with the .so extension when the -l flag is specified for library inclusion; it searches for libraries with a .a suffix. Since the linker does not require that the file truly be an archive, a decision was made to simply generate a link from the shared object to the base shared object name with a .a suffix. This required less build effort, exposed some amount of versioning (through symbolic links to objects with versioning present in the name), and was simple. Unfortunately, it did not permit future multi-version support and it caused existing utilities which were linked against versions of those shared libraries to fail to run. This delivery strives to eliminate those problems, though we certainly regret the inconvenience to the early Toolbox adopters. ================================================================================ Toolbox Installation Instructions NOTICE: If you are running AIX 4.3.3 or migrating from AIX 4.3.3 to AIX 5L, then you need to ensure you are using compatible software. See the previous section for details. The Toolbox does not work for AIX systems earlier than 4.3.3. You must have root authority to install the Toolbox. AIX 4.3.3 users: Prior to installation, either create a /opt/freeware filesystem in the rootvg volume group or provide a symbolic link /opt/freeware to a directory in the rootvg volume group where there is enough free space somewhere to cover the software which you decide to install - most will install under /opt/freeware. If you create a /opt/freeware directory, make a symbolic link to /usr/opt/freeware: ln -s /opt/freeware /usr/opt/freeware The installp image for rpm.rte will create /opt/freeware as a symbolic link to /usr/opt/freeware if you do not create /opt/freeware prior to the installation. RPM does not automatically expand filesystems. AIX 4.3.3 users should install from the RPMS/ppc-4.3.3 directory in order to get the proper versions of the compiler tools. AIX 5L users should install from RPMS/ppc. AIX 5L users: rpm.rte is automatically installed as part of your system installation along with other utilities which came from the Toolbox: cdrecord (CD creation), mkisofs (makes CD filesystems) and (on 5.1 only) mtools (for accessing PC files). If you chose to install GNOME or KDE as your base desktop, then you already have the packages required for that desktop. You can proceed to the "Installing Additional Software" section. Approximate installed /opt/freeware filesystem requirements on a system using the default 4k block sizes: rpm.rte: 3MB Base: 8MB Desktop Base: 12MB Cryptography Base: 4MB GNOME Base: 87MB GNOME Apps: 59MB KDE Base: 240MB KDE Apps: 148MB Application Development: 107MB You should have at least 10MB free for the RPM database in /var to install the "ezinstall" groups. If you install everything, you will require approximately 4150000 free 512-byte blocks in /opt/freeware on a system with 4k block sizes. More importantly, you will also require approximately 34000 blocks free in /var for the RPM database (in /var/opt/freeware/lib/rpm). Approximate space required for download of installation group from web: Base: 4MB Desktop Base: 4MB Cryptography Base: 2MB GNOME Base: 27MB GNOME Apps: 27MB KDE Base: 67MB KDE Apps: 55MB Application Development: 30MB 1. Create the installation directory: As the root user: Create a directory on your system to access the Toolbox software, either for mounting the CD or downloading the software from the web. The following sequence of instructions will mount a CD on /dev/cdrom: umask 022 mkdir -p /mnt/cdrom || : mount -vcdrfs -oro /dev/cd0 /mnt/cdrom If you have more than one CD device, the device name may be different. 2. Accessing Software License Information: CD: You may view extracted licenses associated with the available packages by mounting the Toolbox CD and pointing to /LICENSES/index.html from the CD mount point. For example, if you mount the cd on /mnt/cdrom, then you would open file:/mnt/cdrom/LICENSES/index.html from your browser. Web: See http://www.ibm.com/servers/aix/products/aixos/linux/download.html. 3. Installing additional required AIX software: Some Toolbox packages require AIX software which is not installed by default with AIX. You will need to install that support in order to install those Toolbox packages. Also, many Toolbox packages are graphics applications. If you did not install from a graphical console and you wish to install graphical applications, then you should install the basic graphical support from your AIX installation media using "smitty install_bundle". After selecting the installation device, choose the "Graphics-Startup" bundle and proceed to install the required support. AIX 4.3.3 customers: Install additional AIX support from your AIX installation media if required for your purpose: X11.adt.lib: Required for GNOME or KDE desktops and Enlightenment window manager X11.samples.apps.clients: Absolutely required for KDE desktop X11.apps.xdm: If you want a login manager for GNOME (optional) 4.3.3.50 maintenance level: If you are running GNOME on 4.3.3, your bos.rte, bos.rte.libc filesets must be at least at level 4.3.3.50. If you install this support after installing rpm.rte, you must run /usr/sbin/updtvpkg in order for the RPM package manager to see that the support has been installed. 4. Installing the RPM Package Manager: AIX 5L: rpm.rte is automatically installed with the operating system AIX 4.3.3: From unmounted CD: installp -qaXgd /dev/cd0 rpm.rte From mounted CD: installp -qaXgd /INSTALLP/ppc rpm.rte From web: ftp ftp.software.ibm.com Name> ftp Password> your e-mail address ftp> cd aix/freeSoftware/aixtoolbox/INSTALLP/ppc ftp> binary ftp> get rpm.rte ftp> quit installp -qaXgd rpm.rte rpm.rte 5. Installing AIX Toolbox Packages: -------------- At this point you may install the RPM packages in which you are interested. If you plan to install the GNOME or KDE desktop and it was not already installed with your system, then you will need to install the required supporting packages along with the desktops. The required packages to support the desktops have been grouped into "ezinstall" groups to aid in the installation. Some of the packages have been grouped together to simplify the installation steps. You may choose to install the packages separately - only a limited subset of the packages are included in these installation clusters. 6. Access the ezinstall groups: On CD: Mount CD as per previous instructions 5L: cd /ezinstall/ppc 4.3.3: cd /ezinstall/ppc-4.3.3 (and use "ezinstall/ppc-4.3.3" rather than "ezinstall/ppc" throughout this section). From the web: The easiest way to download the packages is to use the scripts available at the ftp site for downloading the installation groups. Install the wget RPM, then use wget to download the ezinstall installation scripts: mkdir -p ezinstall/ppc || : cd ezinstall/ppc ftp ftp.software.ibm.com Name> ftp Password> your e-mail address ftp> cd aix/freeSoftware/aixtoolbox/RPMS/ppc/wget ftp> binary ftp> get wget-1.8.1-1.aix4.3.ppc.rpm ftp> quit rpm -hUv wget-1.8.1-1.aix4.3.ppc.rpm wget -r -nd -g=on ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/ezinstall/ppc chmod +x get*.sh For each ezinstall bundle you wish to install (base, desktop.base, etc), run get.sh. It will create a directory named if required and download the required files into the directory. You can then use "rpm -hUv /*" to install that set of RPMS. To install GNOME or KDE, you will first need to install the base and desktop.base bundles. For GNOME, you then install gnome.base and optionally gnome.apps. For KDE, you will either install kde3.all or kde3.base and kde3.opt. kde3.all is simply the combined packages from kde3.base and kde3.opt. 7. rpm -Uhv ezinstall/ppc/base/* 8. If you want to install GNOME or KDE, install the desktop support packages: $ rpm -Uhv ezinstall/ppc/desktop.base/* 9a. If you want to install GNOME, install the base GNOME packages: $ rpm -Uhv ezinstall/ppc/gnome.base/* 9b. If you want to install various GNOME applications, install the GNOME apps: $ rpm -Uhv ezinstall/ppc/gnome.apps/* 10a. If you want to install KDE, you must do this step only if you are installing from the CD (the web site does not have this bundle): $ rpm -Uhv ezinstall/ppc/crypto.base/* 10b. Next, either install the full set of KDE packages: $ rpm -Uhv ezinstall/ppc/kde3.all/* 10c. or, install the base KDE packages and the optional KDE apps separately: $ rpm -Uhv ezinstall/ppc/kde3.base/* $ rpm -Uhv ezinstall/ppc/kde3.opt/* 11. If you want to install application development software, install the app-dev group: $ rpm -Uhv ezinstall/ppc/app-dev/* 12. Download and install any other software which you might be interested in $ rpm -Uhv ================================================================================ Installing Additional Software Quick guide to RPM: To install: rpm -i To upgrade (works for install as well): rpm -U To remove/deinstall: rpm -e # As in foo, not foo.ppc.rpm To query an installed package: rpm -q To query all installed packages: rpm -qa To list files in a package: rpm -ql To list requirements for a package: rpm -q --requires To find package providing requirements: rpm -q --whatprovides To query an uninstalled RPM: rpm -qp To get help: rpm --help Most RPM commands can be applied to an uninstalled binary RPM package file by use of the -p argument. For more information on using RPM to install and build packages, see the online version of "Maximum RPM," by Edward Bailey, at http://www.rpmdp.org/rpmbook/ Note: Most of the software will install into /opt/freeware, with links being added to /usr/bin and /usr/lib where conflicts with AIX would be avoided. To access a "Linux" version of a utility before the AIX utility, place /usr/linux/bin: at the beginning of your PATH. To access the man pages of the installed software, add /opt/freeware/man to your MANPATH variable or set an alias such as this: alias lman='MANPATH=/opt/freeware/man man' You may also find additional information using the 'info' command. If an RPM requires a shared library from AIX which was not installed at the time that rpm.rte was initially installed, then you can run /usr/sbin/updtvpkg to update RPM's reflection of the software installed by installp. If you already have older versions of Toolbox packages installed, and you just wish to update your images to the current levels on the new CD, there is a sample script on the CD called contrib/installnewer. It will examine the images on your system and then install only newer versions of those same packages, plus any new packages that the updated images may require. The usage is "installnewer /RPMS/ppc" for AIX 5L, or "installnewer /RPMS/ppc-4.3.3" for AIX 4.3.3. Set DEBUG=1 in your environment to get a list of RPMS to install without actually installing. ================================================================================ Using GNOME as your desktop 1. Install GNOME as per the instructions in the previous section. Review the "Known Problems" section below for known GNOME problems. 2. If you were previously running GNOME 1.2 or 1.4 from the Toolbox, you will need to remove all of your $HOME/.gnome* directories. These files are not compatible between the GNOME versions. rm -rf $HOME/.gnome* 3. If you wish to use xdm or xinit, you will need to do some preliminary setup: Modify the .xinitrc in your $HOME directory. If you don't have one: cp /usr/lpp/X11/defaults/xinitrc ~/.xinitrc Now edit $HOME/.xinitrc Remove the last three commands that look something like this: xsetroot -solid grey60 aixterm =80x25+0-0 & exec mwm -multiscreen -xrm "ShowFeedback: -quit" Add this command in their place: exec /usr/bin/gnome-session Then proceed to step 4a, 4b, 4c, or 4d. 4a. xinit - If you are running CDE, then from the CDE desktop login dialog, choose "Command Line Login", login, then type "xinit -- -T" 4b. If you wish to use the XDM login: As root from the command line login, run /usr/lib/X11/xdm/xdmconf This will kill dtlogin and remove from /etc/inittab, as well as starting xdm during a reboot. Now reboot, or just run this: /usr/bin/X11/xdm -daemon ; exit 4c. If you are running CDE on AIX 5.2 and up, then from the desktop login dialog, choose "Options", then "Sessions", then select "Gnome". Enter your user name and password just like logging in to the CDE desktop. 4d. If you wish to use the new Gnome login dialog: Make sure another login manager does not start at bootup. - for CDE run "/usr/dt/bin/dtconfig -d" - for xdm run "/usr/lib/X11/xdm/xdmconf -d" - for KDE edit /etc/inittab and remove the line that starts kdm. Then add the following line to the bottom of /etc/inittab: "gdm:2:once:/opt/freeware/bin/gdm" Kill any login manager processes from xdm, dtlogin or kdm and run this command "/opt/freeware/bin/gdm ; exit" or just reboot. ================================================================================ Using KDE as your desktop 1. Make sure that you have the required AIX software installed. Run the following command to see if the required software is installed: lslpp -L X11.samples.apps.clients If this is missing, install it from your AIX installation media. If you don't, the 'iceauth' program will be missing, which is required to successfully start kde3 - you'll see messages about dcopserver failing to start or even a multitude of restarting kdeinit processes. 2. AIX 4.3.3 customers: You must access and install X11 fixes from APAR IY15017 required to make KDE start reliably (approximately 7MB required for download): From CD: Mount CD as per previous instructions cd /fixes/ppc/4.3.3 From web: $ ftp ftp.software.ibm.com ftp> cd aix/fixes/v4/X11 ftp> bin ftp> prompt ftp> mget X11.base.lib.4.3.3.27.bff X11.base.rte.4.3.3.10.bff ftp> quit $ inutoc . # To save disk space, you may want to specify -qacXgd on the next line Then run the following command: installp -qaXgd . X11.base.lib 4.3.3.27 X11.base.rte 4.3.3.10 You may optionally had the -c flag to commit the fix to save disk space. 3. If you had previously installed the kde-1.1.2 desktop, then you have incompatible software installed. See the 'REMOVE EXISTING RPMS IF rpm.rte INSTALLED AT LEVEL LESS THAN 3.0.5.20' section for further information. 4. If you had previously installed a prior version of KDE, rename or remove the .kde directory from your $HOME directory: mv $HOME/.kde $HOME/.kde-old 5. Install KDE per the instructions in the Toolbox Installation section above. See also the section below, "Some Known Problems and Limitations", for information about some function of KDE that is not available. Once installed, there are basically two ways to start KDE: 6. From the command line. You can modify the .xinitrc in your $HOME directory to start KDE. Copy or reference the sample .xinitrc file: Web: ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/contrib/xinitrc.sample CD: contrib/xinitrc.sample If you are running CDE, from the desktop login dialog choose "Command Line Login," login, then type "xinit -- -T" to start. 7. From a display manager. To start the KDE display manager, kill any CDE desktop session and start kdm like so: $ ps -ef | grep dtlogin | grep -v grep | awk '{ print $2 }' | xargs kill -9 $ /opt/freeware/kde/bin/kdm If you would like the KDE display manager to also start at boot time, rather than dtlogin, then you will need to modify /etc/inittab. Replace this entry: 'dt:2:wait:/etc/rc.dt' with this entry: 'kdm:2:once:/opt/freeware/kde/bin/kdm' DO NOT SIMPLY COMMENT OUT THE dt LINE. Note: The xdm display manager which comes with AIX has been configured and customized for AIX, particularly with respect to non-en_US keyboard support. If you have a non-en_US keyboard, then you may need to copy the setup file from the AIX X11.apps.xdm fileset. If you wish for the KDE display manager to utilize a non-en_US keyboard, install the X11.apps.xdm fileset from your AIX installation media if it is not already installed, and use or modify its configuration files. For example, to enable non en_US keyboard initialization: cp /usr/lib/X11/xdm/Xsetup_0 /opt/freeware/kde/share/config/kdm echo "/opt/freeware/kde/bin/kdmdesktop" >> /opt/freeware/kde/share/config/kdm/Xsetup_0 ================================================================================ Some Known Problems and Limitations - Conflicts with AIX Expansion Pack - krb5.server.rte + krb5.server.rte (versions less than 1.3.0.0) ships a /usr/lib/libdb.a file which is not a Berkeley database library. This could cause problems when building open source software which requires the Berkeley database interfaces. The Berkely database interfaces may be found in /opt/freeware/lib. - General + Audio support is generally non-existent + Some AIX commands do not use full path to invoke programs which have counterparts in the Toolbox. If you have /usr/linux/bin or /opt/freeware/bin in your PATH ahead of /usr/bin, you may encounter some errors. Set /usr/bin ahead of /usr/linux/bin or /opt/freeware/bin if you get unexpected errors (usually involving unexpected options or syntax errors) to work around such a problem. + The Toolbox packages do not register information into the Trusted Computing Base (TCB). If you are running a TCB-enabled system, you might not want to install this software. - autoconf: + You must either install the Toolbox awk or just set AWK=/usr/bin/awk for it to add line numbers to the libtool configure script. - autoconf/automake/libtool: * These utilities have all been updated to the most recent levels as of February 2002; autoconf was again updated in June 2002. However, note that many of the applications in the toolbox predate these new utilities, and were built with earlier versions (autoconf-2.13 or 2.52, automake-1.4, and libtool-1.3.5). There are some key changes, particularly with libtool, that may prevent you from building a few applications directly from Toolbox SRPMS if these newer versions are installed. You may need to modify the SPEC files or install the older tool versions if you encounter errors from any of these commands. For example, libtool now no longer contains the 'ltconfig' script, so if you run 'libtoolize' and then the configure script tries to run 'ltconfig', it will fail. Future Toolbox packages will be built with the current levels of these tools. If you do not build your own RPMs, then this information is not important to you. - destroyRPMS and rpm -e + Some scripts which run on removal fail to execute since they are invoking programs or accessing directories removed earlier. You may see several error messages running destroyRPMS. + Removal of KDE results in many messages regarding failure to remove directories. See the note under KDE. + If you have any "csm" packages installed from AIX, you may not be able to deinstall the rpm.rte installp image. In fact, you may not want to run destroyRPMS in this case. If you do, you will probably see errors and will need to reinstall the rpm.rte image. - Enlightenment: + Installing themes does not work and hangs enlightenment - jabber: + The jabberd server daemon dies frequently, most frequently (but not always) when users disconnect from the server. - KDE: + koffice is not available here for KDE3. If you need to use koffice and cannot download and build your own, you will want to get the previous level, KDE 2.2.1, from the Toolbox FTP site, or visit KDE.org. + Sound applications are not functional + 3D screeensavers are not available as built + Non-en_US keyboards do not work with the default kdm Xsetup file. See the KDE installation section for workaround information. + Function keys F1-F4 do not work in default terminal mode - change Settings->Keyboard in terminal to xterm (XFree 3xx) or vt100 + kdelibs incorrectly lists system directories in the file lists. This causes surprising but harmless messages regarding directory removal failures when running "rpm -e" such as these: cannot remove /usr/lpp/X11/lib/X11/app-defaults - directory not empty cannot remove /usr/lib/X11/fonts/misc - directory not empty cannot remove /usr/lib/X11/fonts - directory not empty rmdir of /usr/lib/X11 failed: A parameter must be a directory. cannot remove /usr/lib - directory not empty rmdir of /usr failed: The requested resource is busy. rmdir of /opt/freeware failed: The requested resource is busy. - gaim: + Though instant messaging works, add-on plugins do not. - GNOME: + Some function keys do not work in a gnome-terminal. + Some screensaver previews do not work in the GNOME control center, though the settings do take effect. + Accessibility packages (gok, gnome-speech, gnopernicus) are under early development at gnome.org, and the versions presented here are only of alpha (pre-beta) quality. Do not expect them to work very well. In addition, gnome-speech requires the tts_access.base installp fileset, which is available for AIX 5.1 and greater. You can download it from: http://www-1.ibm.com/servers/aix/products/bonuspack/aix5l/wpcontent.html After installing, you will need to run /usr/sbin/updtvpkg before installing gnome-speech. Because this is only available for 5.1 and greater, neither gnome-speech nor gnopernicus are installable on 4.3.3. - gprof: + (in binutils pkg) Does not work properly. Doesn't recognize gmon.out. There is no known workaround. If performance is an issue, it is recommended to use the IBM VAC compiler and native AIX gprof. - proftpd: + Only one of either proftpd or wu-ftpd can be installed. Because of the package conflict, the proftpd RPM is found in a different directory on the CD, under RPMS/ppc-extra. This was done to allow the full contents of RPMS/ppc or RPMS/ppc-4.3.3 to be installed without encountering conflicts. + It is reported that proftpd does not work with tcp6. If adding to /etc/inetd.conf, use: ftp stream tcp nowait root /opt/freeware/sbin/in.proftpd in.proftpd - rpm.rte: + You will see errors when running lppchk -l rpm.rte if you install the RPMs which comprise rpm.rte (rpm, bzip2, gettext, gzip, popt, zlib), because the exact form of the symbolic links is not the same. The links are equivalent, but lppchk -l and rpm -V will report discrepancies because the links are not exactly the same. - webmin: + You must start webmin as root after installation by running /etc/webmin/start. ================================================================================ Other Packages (not on the CD) The web site has some additional packages beyond what is found on the CD. Please visit the web site to find additional images. OpenSSH (AIX 5L): The Toolbox DOES NOT contain an AIX 5L version of OpenSSH. Instead, there is an official installp image of OpenSSH for AIX 5L. The openssh rpm images in the RPMS/ppc-4.3.3 directory will install on AIX 4.3.3 only. AIX 5L users that want OpenSSH can find a supported installp image of OpenSSH on the AIX Bonus Pack CD. If you do not have the Bonus Pack or if you are reading this from the Web, please visit the AIX OpenSSH developerworks site to download the image: http://oss.software.ibm.com/developerworks/projects/opensshi Unlike the as-is Toolbox RPMs, the installp image is supported for AIX customers. If you have an AIX 5L system with an older "openssh" RPM image installed from the AIX Toolbox, please deinstall it before installing the installp image: # rpm -e openssh openssh-server openssh-clients Then use installp or "smit install" to install the OpenSSH installp image. OpenSSH (AIX 4.3.3): There is no supported OpenSSH installp image, so use the openssh images from the RPMS/ppc-4.3.3 directory, just as you would any other Toolbox RPMS. You need perl.rte (from your AIX install media), and prerequisite RPMS "prngd" and "openssl" installed, both also available in the AIX Toolbox. ================================================================================ Building against many libraries requires the use of run-time linking (-rtl) Due to cross-library codependencies, several of the libraries delivered with the Toolbox are built using run-time linking in order to allow the dependencies between libraries to be resolved at run-time. Some library references could not be resolved without employing run-time linking. When there is a shared object delivered with the toolbox which is not associated with a .a file, it is likely that it was built with run-time linking enabled. When you attempt to use one of these libraries you need to use the -rtl option to the linker (this is commonly enabled at the configure step by the use of LDFLAGS="-Wl,-brtl" for gcc, and LDFLAGS="-brtl" for vac/xlc). Unless you use -rtl, the linker will not search for the required .so files to resolve the shared object dependencies. The following packages were built using run-time linking technology: ORBit control-center enlightenment fnlib gdk-pixbuf gimp glade glib gnome-core gnome-libs gnome-pim gnome-print gnome-utils gnorpm gnotepad+ gnumeric gtk+ gtk-engines imlib kdeadmin kdebase kdegames kdegraphics kdelibs kdenetwork kdepim kdetoys kdeutils koffice libglade libgtop librep libtool mc ncftp python rep-gtk rpm sawfish So, if you are trying to use glib or gtk+, you must use run-time linking to link your program. ================================================================================ How to report problems This program is offered on an "as-is" basis, but you may report problems to the public mailing list at aixtoolbox-list@oss.software.ibm.com. You may also submit a bug report to the Toolbox development team via the AIX Toolbox project page at http://oss.software.ibm.com/developerworks/projects/aixtoolbox. ================================================================================ How to suggest additions to the Toolbox You may submit a program request to the Toolbox development team via the AIX Toolbox project page at: http://oss.software.ibm.com/developerworks/projects/aixtoolbox Use the bug report mechanism and use the category of "Request." Your request will be added to a request list; however, keep in mind that new package additions are expected to be rare for the forseeable future. ================================================================================ AIX/Linux API and Commands Differences A document has been written describing differences between AIX and Linux APIs and commands. The document may be accessed in the docs directory of the CD. ================================================================================ Build Environment Used to Produce Toolbox The Toolbox contents were generally created on an AIX 4.3.3.0 system with no modified system headers. Most C applications were first built with the gcc compiler packaged with the Toolbox, then rebuilt with the Visual Age C Compiler for performance considerations. The SPEC files will commonly check for the existence of the Visual Age Compiler (actually it looks for cc or xlc), then fall through to gcc. Links to the original source code location are provided in the AIX Toolbox website download tables. Additionally, the source RPMS are provided for those packages with licenses (such as GPL) which require source distribution. Some packages were required to build the KDE documentation which we were unable to get clearances for this delivery. If you build from the KDE SRPMs, you will need to find and build the packages described on the KDE documentation tools page at http://i18n.kde.org/doc/install/download.html. ================================================================================ Frequently Asked Questions A list of frequently asked questions is available on the ftp site at ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/FAQ. ================================================================================