diff options
author | Paul Olav Tvete <paul.tvete@digia.com> | 2012-10-11 14:23:28 +0200 |
---|---|---|
committer | Paul Olav Tvete <paul.tvete@digia.com> | 2012-11-19 13:34:13 +0100 |
commit | efe5d93817b556b5ee9261233f17f98a2300865b (patch) | |
tree | bf30cb6d11eaf3e2aa0610de3282dd871402c0b5 /doc/src/platforms/platform-notes-rtos.qdoc | |
parent | 95ebb971d60a08a70efc97ebf9d71f021ce9fedd (diff) | |
download | qtdoc-efe5d93817b556b5ee9261233f17f98a2300865b.tar.gz |
Remove outdated platform documentation
QWS does not exist anymore. If any of the other points are still relevant,
they should be re-added when the documentation is updated.
Change-Id: Ifc75dfe979627c2994a67eaed258213c59fa0517
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Diffstat (limited to 'doc/src/platforms/platform-notes-rtos.qdoc')
-rw-r--r-- | doc/src/platforms/platform-notes-rtos.qdoc | 289 |
1 files changed, 0 insertions, 289 deletions
diff --git a/doc/src/platforms/platform-notes-rtos.qdoc b/doc/src/platforms/platform-notes-rtos.qdoc index d7c9aa06..a9089d9e 100644 --- a/doc/src/platforms/platform-notes-rtos.qdoc +++ b/doc/src/platforms/platform-notes-rtos.qdoc @@ -34,106 +34,6 @@ \note VxWorks is a community supported platform. See the \l{Supported Platforms} page for more information. - This page contains information about the Qt for VxWorks port. More - information about the combinations of platforms and compilers supported - by Qt can be found on the \l{Supported Platforms} page. - - \tableofcontents - - \section1 Supported Versions - - Qt has been tested on WindRiver VxWorks 6.7 in kernel mode using the - vendor supplied GCC compiler, targetting both the x86 simulator - (simpentium) and Power-PC devices (ppc). - VxWorks' RTP mode is currently not supported. - - \section1 Limitations - - The VxWorks kernel has an optional POSIX compatibility layer, but this - layer does not implement all POSIX functionality needed for a complete - Qt port. - - \table - \header \li Function \li Notes - \row \li QProcess - \li Not available - VxWorks has no concept of processes. - \row \li QSharedMemory - \li Not available - VxWorks has only a global, flat address space. - \row \li QSystemSemaphore - \li Not available - VxWorks has no concept of processes. - \row \li QLibrary - \li QLibrary is only a small stub to make it possible to build - static plugins. - \row \li QCoreApplication - \li Can only be instantiated once. Qt's Q(CoreE)Application is - tightly coupled to one address space and process, while VxWorks - only supports one global address space and has no concept of - processes. - \endtable - - \section1 Build Instructions - - Qt for VxWorks needs to be \l{Cross-Compiling Qt for Embedded Linux - Applications}{cross-compiled} on a Linux host. \c configure and \c make - the build like you would with a standard \l{Cross-Compiling Qt for - Embedded Linux Applications}{embedded Linux cross build}. Building the - VxWorks simulator would be done like this: - - \code - <path/to/qt/sources>/configure -xplatform unsupported/vxworks-simpentium-g++ -embedded vxworks -exceptions -no-gfx-linuxfb -no-mouse-linuxtp -no-mouse-pc -no-kbd-tty - make - \endcode - - \list - \li \c{-xplatform unsupported/qws/vxworks-simpentium-g++} - selects the x86 simulator mkspec for VxWorks - \li \c{-embedded vxworks} - builds the embedded version of Qt and sets the architecture to VxWorks - \li \c{-exceptions} - see General Notes below - \li \c{-no-gfx-linuxfb}, \c{-no-mouse-linuxtp}, \c{-no-mouse-pc} and \c{-no-kbd-tty} are Linux specific and won't work on VxWorks - \endlist - - \section1 General Notes - - \list - - \li Configuring with \c{-exceptions} is necessary, because the VxWorks - 6.7 g++ headers require exceptions to be enabled when compiling C++ - code. - - \li Configure's \c{-xplatform} can be any of - \c{unsupported/vxworks-(simpentium|ppc)-(g++|dcc)}, but \c{dcc} - (WindRiver DIAB compiler) has not yet tested been tested with Qt 4.6 and - VxWorks 6.7. - - \li Building shared libraries with \c{-shared} (the default) doesn't - really build shared libraries, like e.g. on Linux, since these are not - supported by VxWorks. Instead, qmake will created partially linked - objects, that can be loaded at runtime with \c{ld}. - - \li Creating static builds with \c{-static} is fully supported. - - \li "Munching" (generating constructors/destructors for static C++ - objects) is done automatically by a special qmake extension (for both - shared libraries and executables) - - \li VxWorks does not have a file system layer, but the low level storage - drivers have to supply a file system like interface to the applications. - Since each driver implements a different subset of the functionality - supported by this interface, Qt's file system auto-tests show wildly - differing results running on different "file systems". The best results - can be achieved when running on a (writable) NFS mount, since that - provides the most Unix-ish interface. The worst results come from the - FTP file system driver, which may crash when accessed by a - \c{QFileInfo}. - - \li Keep in mind that VxWorks doesn't call your \c{main()} function with - the standard \c{argc}/\c{argv} parameters. So either add a special - \c{vxmain()} function or use a tool like \c{callmain} to translate - VxWorks' commandline arguments to an \c{argc}/\c{argv} array. - - \li Some example will fail to build, due to some missing dependencies - (e.g. shared memory) - this will be fixed in a later release. - - \endlist */ /*! @@ -145,95 +45,6 @@ \note QNX is a community supported platform. See the \l{Supported Platforms} page for more information. - This page contains information about the Qt for QNX port. More - information about the combinations of platforms and compilers supported - by Qt can be found on the \l{Supported Platforms} page. - - Note that Qt for QNX is currently based on \l{Qt for Embedded Linux}, which - contains its own windowing system. Mixing QNX's Photon environment with - Qt for QNX is currently not possible. Building Qt for QNX with Photon's - X11 embedded server is not recommended due to missing support for X11 extensions, - resulting in poor rendering quality. - - Qt for QNX contains experimental screen and input drivers based on QNX's - \c devi-hid and \c io-display. For more information, check the class documentation - for QQnxScreen, QWSQnxKeyboardHandler and QQnxMouseHandler. See the - \l{Porting Qt for Embedded Linux to a New Architecture} document for information - on how to add custom screen or input drivers. - - \tableofcontents - - \section1 Supported Versions - - Qt has been tested on QNX 6.4 on i386 and PowerPC targets with QNX's default - gcc compiler. - - \section1 Limitations - - Some of Qt's functionality is currently not available on QNX: - - \table - \header \li Function \li Notes - \row \li QProcess - \li Not available - QNX doesn't support mixing threads and processes. - \row \li QSharedMemory - \li Not available - QNX doesn't support SYSV style shared memory. - \row \li QSystemSemaphore - \li Not available - QNX doesn't support SYSV style system semaphores. - \row \li QWS Multi Process - \li QT_NO_QWS_MULTIPROCESS is always on due to missing shared memory support. - \endtable - - \section1 Build Instructions - - Qt for QNX needs to be built either on a QNX system, or \l{Cross-Compiling Qt - for Embedded Linux Applications}{cross-compiled} on a Linux host. In either - case, The QNX Software Development Platform must be installed. - - Example configure line for cross-compiling Qt for QNX on a Linux host for an - i386 QNX target: - - \code - configure -xplatform unsupported/qws/qnx-i386-g++ -embedded i386 -no-gfx-linuxfb -no-mouse-linuxtp -no-kbd-tty -qt-gfx-qnx -qt-mouse-qnx -qt-kbd-qnx -no-exceptions - \endcode - - \list - \li \c{-xplatform unsupported/qws/qnx-i386-g++} - selects the i386-g++ mkspec for QNX - \li \c{-embedded i386} - builds the embedded version of Qt and sets the architecture to i386 - \li \c{-no-gfx-linuxfb}, \c{-no-mouse-linuxtp} and \c{-no-kbd-tty} are Linux specific and won't work on QNX - \li \c{-no-exceptions} - reduces the size of the library by disabling exception support - \li \c{-qt-gfx-qnx} - enables the experimental \c{io-graphics} based display driver - \li \c{-qt-mouse-qnx} - enables the experimental \c{devi-hig} based mouse driver - \li \c{-qt-kbd-qnx} - enables the experimental \c{devi-hig} based keyboard driver - \endlist - - \section1 General Notes - - \list - \li To enable the experimental QNX display and input drivers, \c{io-display} needs to be - up and running. The \c devi-hid based Qt input drivers require \c devi-hid to run - in resource mode without Photon support. To enable a standard mouse and keyboard - combination, run \c devi-hid as follows: \c{/usr/photon/bin/devi-hid -Pr kbd mouse}. - Note that your current shell will not accept keyboard and mouse input anymore after - running that command, so run it either from a script that launches a Qt application - afterwards, or make sure to have remote login available to launch a Qt application. - In addition, the \c QWS_DISPLAY, \c QWS_MOUSE_PROTO and \c QWS_KEYBOARD environment - variables should all be set to \c{qnx} before running a Qt application. - - \li The 3rd party TIFF library currently doesn't build due to the missing \c inflateSync - symbol from QNX's \c{libz.so.2}. Workarounds would be to manually replace QNX's libz - with a newer version, or disable the TIFF plugin entierly by appending - \c{QT_CONFIG += no-tiff} to \c{.qmake.cache} after configuring Qt. - - \li Some of the tools and examples do not compile due to dependencies on QProcess - or other classes that are not available on QNX. - \endlist - - \section1 Platform Regressions - - Qt for QNX's behavior is mostly identical with \l{Qt for Embedded Linux}. However, - some regressions were spotted in QDateTime computation around year 0 and year 1970, - which have been tracked back to faulty time zone data on some QNX versions. */ /*! @@ -245,104 +56,4 @@ \note INTEGRITY is a community supported platform. See the \l{Supported Platforms} page for more information. - This page contains information about the Qt for INTEGRITY port. More - information about the combinations of platforms and compilers supported - by Qt can be found on the \l{Supported Platforms} page. - - Note that Qt for INTEGRITY is currently based on \l{Qt for Embedded Linux}, - which contains its own windowing system. - - Qt for INTEGRITY contains experimental screen and input drivers based on the - gh_FB Framebuffer API for graphics, a Connection-based mouse and keyboard - support. For information about these drivers, please refer to Green Hills - Software standard support. - - \tableofcontents - - \section1 Supported Versions - - Qt has been tested on INTEGRITY 10 on various PowerPC, ARM and x86 targets. - On some platforms a native graphics FrameBuffer driver is available and has - then been used for testing. On all other platforms, the default FrameBuffer - VNC driver is used. - - \section1 Limitations - - Some of Qt's functionality is currently not available on INTEGRITY: - - \table - \header \li Function \li Notes - \row \li QProcess - \li Not implemented. Volunteers welcome. - \row \li QSharedMemory - \li Not available - INTEGRITY doesn't support SYSV style shared memory. - \row \li QSystemSemaphore - \li Not available - INTEGRITY doesn't support SYSV style system semaphores. - \row \li QWS Multi Process - \li QT_NO_QWS_MULTIPROCESS is always on due to missing shared memory support. - \row \li QtScript - \li Not available - INTEGRITY's mmap() doesn't support allocating memory. - \endtable - - \section1 Build Instructions - - Qt for INTEGRITY can be built on either a Linux or Windows (with cygwin) host. - In both cases, a standard installation of INTEGRITY is required, with the - addition of the FrameBuffer API. - - Example configure line for cross-compiling Qt for INTEGRITY for an - ARM INTEGRITY target: - - \code - ./configure --hostprefix=$PWD -embedded integrity -xplatform unsupported/qws/integrity-arm-cxarm -static -qt-kbd-integrity -qt-mouse-integrity -no-mouse-linuxtp -no-mouse-pc -no-kbd-tty -qt-gfx-integrityfb -no-gfx-linuxfb -no-glib -no-openssl -no-largefile -little-endian -arch integrity -prefix / -opensource -no-feature-QWS_MULTIPROCESS -no-feature-SHAREDMEMORY -no-feature-PROCESS -no-feature-SYSTEMSEMAPHORE -no-feature-PRINTER -no-feature-QWS_QPF2 -no-libtiff -no-exceptions -no-scripttools - \endcode - - \list - \li \c{--hostprefix=$PWD} - specifies the current directory as the base source for Qt - \li \c{-arch integrity} - sets the architecture to INTEGRITY (for atomic operations) - \li \c{-embedded integrity} - builds the embedded version of Qt and sets the architecture to INTEGRITY - \li \c{-xplatform unsupported/qws/integrity-arm-cxarm} - selects the arm-cxarm mkspec for INTEGRITY - \li \c{-static} - specifies a static build of Qt - \li \c{-no-gfx-linuxfb}, \c{-no-mouse-linuxtp}, \c{-no-mouse-pc} and \c{-no-kbd-tty} are Linux specific and won't work on INTEGRITY - \li \c{-no-exceptions} - reduces the size of the library by disabling exception support - \li \c{-no-openssl} - disable support for OpenSSL - \li \c(-no-libtiff} - disable support for libTIFF - \li \c{-no-glib} - disable support for unavailable Glib - \li \c{-no-largefile} - disable support for large (> 2TB) files - \li \c{-no-scripttools} - disable support for QtScript tools - \li \c{-qt-gfx-integrity} - enables the experimental gh_FB based display driver - \li \c{-qt-mouse-integrity} - enables the experimental Connection-based mouse driver - \li \c{-qt-kbd-integrity} - enables the experimental Connection-based keyboard driver - \endlist - - The above script will generate MULTI .gpj Project files, not Makefiles. The - main benefit of using these project files is automatic dependency checking, - but this also provides an organization known to INTEGRITY customers. - For Qt libraries, the top-level file is projects.gpj. - - \section1 General Notes - - \list - \li Before you run the above configure line, you may want to modify the values - of INTEGRITY_DIR and INTEGRITY_BSP in unsupported/qws/integrity-arm-cxarm/qmake.conf. - If you do not do this, you will have to modify the resulting generated projects.gpj - - \li Compilation of native preprocessing tools (moc, rcc, uic) is not automatic. From - a Linux shell or a MingWin shell, you can run the following command to compile these tools : - \code - cd src/tools/bootstrap && make && cd ../rcc && make && cd ../moc && make && cd ../uic && make && cd ../../.. - \endcode - - \li GIF and TIFF support are currently not enabled. - - \li Default .int files are generated. You may want to modify the amount of heap assigned - to each example by modifying the HeapSize declaration in the specific example .int file. - - \li Some of the tools and examples do not compile due to dependencies on QProcess - or other classes that are not available on INTEGRITY. - - \endlist - - \section1 Platform Regressions - */ |