Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Platform Notes - X11

This page contains information about the X11 platforms Qt is currently known to run on, with links to platform-specific notes.

AIX - 5.1 or later

Qt has been built on a range of versions from 5.1 upwards, using both the AIX and GCC compilers.

xlCIf Qt is built correctly but all symbols are reported to be missing when you link an application, your makeC++SharedLib script might be out of date. Make sure you have the latest version from the IBM website.
GCCWe have tested Qt 4 successfully with GCC version 3.3 and above. Some versions of GCC may fail to link Qt with a "TOC overflow" message. Fix this by upgrading to the latest maintenance release of the dynamic linker. On AIX this is bos.rte.bind_cmds. Some versions of GCC may fail to build Qt with STL and large-file support enabled, due to a bug in GCC. Fix this by upgrading to the latest maintenance release of the compiler. It is also possible to work around this problem by running configure with either -no-stl or -no-largefile.


The system compiler on FreeBSD 4.x is gcc 2.95.4, which is not officially supported by Qt 4. We develop using and recommend ports/lang/gcc34. You will need to run configure with the -platform freebsd-g++34 arguments. Optionally, you may use ports/lang/icc.

The system compiler on FreeBSD 5.x and 6.x is gcc 3.4.4, which is officially supported by Qt. You do not need to add any special arguments when running configure. Optionally, you may use ports/lang/icc.

Note that we do not actively test FreeBSD 4.x and 5.x. Our developers migrated to 6.x after the Qt 4 launch. FreeBSD-CURRENT is not supported.


Qt supports HP-UX on both PA-RISC and the Itanium (IA64) architectures.

PA-RISC - B.11.11 or later

You can configure Qt for aCC in 32 and 64 bit mode (hpux-acc-64 or hpux-acc-32), or gcc in 32 bit mode (hpux-g++). The default platform is hpux-acc-32. The minimum required version for aCC (HP ANSI C++) on PA-RISC is A.03.57. The supported gcc compiler is gcc 3.4.3.

Itanium - B.11.23 or later

You can configure Qt for aCC in 32 and 64 bit mode (hpuxi-acc-64 or hpuxi-acc-32). gcc is currently unsupported. The default platform is hpuxi-acc-64. The minimum required version for aCC (HP ANSI C++) on Itanium is A.06.12.

IRIX - 6.5.x

Unpackaging and IRIX tar: Because of long filenames some files will be cut off incorrectly with IRIX tar. Please use GNU tar to unpack Qt packages.


There are no known problems with using Qt on production versions of Linux/x86, Linux/ppc, Linux/amd64 and Linux/ia64 (including Altix(R)). We do our Unix development mainly on Linux/x86.

For the gcc/g++ compiler, please also see the relevant compiler page.

Installation problems

See also the Installation FAQ.

If you experience problems when installing new Qt Open Source Edition versions, try to use the Qt Open Source Edition archives (e.g. RPM) provided by your Linux provider. If you need to install the source (.tgz) archive, be aware that you will probably end up with two different versions of the Qt library installed on your system, which will probably lead to link errors, like this:

 undefined reference to `_vt.11QPushButton'

Fix this by removing the old version of the library.

If you have problems installing a Qt Open Source Edition Linux archive (e.g. RPM), please consult your Linux provider (who made it), not us.

Some RPM versions have problems installing some of the Qt RPM archives where installation stops with an error message warning about a "Failed Dependency". Use the --nodeps option to rpm to workaround this problem.

Solaris - 9 or later

CC on Solaris

Be sure to check our Forte Developer / Sun Studio notes.

GCC on Solaris

Be sure to check the installation notes for GCC on Solaris. Do not use GCC with Sun's assembler/linker, this will result in link-time errors in shared libraries. Use GNU binutils instead.

GCC 3.2.* is known to miscompile Qt due to an optimizer bug that will cause the resulting binaries to hang.

GCC gives compilation error

 ANSI C++ forbids declaration ... with no type

on systems with old X11 header files. This is fixed by patches 108652-24 on Solaris 8, 108376-21 on Solaris 7, and 105633-56 on Solaris 2.6.

Solaris 2.6

A crash on resize of widgets example has been reported, but not reproduced. Patch 105633-21 is reported to solve the problem. We are interested in hearing more details from anyone who can reproduce and track this problem closer.

Copyright © 2008 Trolltech Trademarks
Qt 4.3.5