XFree86 and LessTif for LynxOS Release Notes
XFree 86 and LessTif Release 4.0 LynxOS Release 4.0

DOC-0628-01

Product names mentioned in XFree86 and LessTif for LynxOS Release Notes are trademarks of their respective manufacturers and are used here for identification purposes only.
Copyright 1987 - 2006, LynuxWorks, Inc. All rights reserved. U.S. Patents 5,469,571; 5,594,903; 6,075,939; 7,047,521
Printed in the United States of America. All rights reserved. No part of XFree86 and LessTif for LynxOS Release Notes may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photographic, magnetic, or otherwise, without the prior written permission of LynuxWorks, Inc. LynuxWorks, Inc. makes no representations, express or implied, with respect to this documentation or the software it describes, including (with no limitation) any implied warranties of utility or fitness for any particular purpose; all such warranties are expressly disclaimed. Neither LynuxWorks, Inc., nor its distributors, nor its dealers shall be liable for any indirect, incidental, or consequential damages under any circumstances. (The exclusion of implied warranties may not apply in all cases under some statutes, and thus the above exclusion may not apply. This warranty provides the purchaser with specific legal rights. There may be other purchaser rights which vary from state to state within the United States of America.)

Contents

CHAPTER 1
OVERVIEW... 1 Components Overview and Source Baseline... 2 Libraries Linkage... 2 Utilities Linkage.... 2 Multithreaded Library Support.. 2 Supported LynxOS 4.0 BSPs... 3 Supported Hardware... 3 Graphics Adapter Support.. 3 Mouse Support.... 5 Keyboard Support... 6 CD-ROM Contents... 9 INSTALLING XFREE86 AND LESSTIF.. 13 Overview... 13 Before Installing.... 13 Disk Space Requirements... 14 Graphics Adapter Requirements.. 14 Monitor Requirements... 14 Mouse Requirements... 15 Keyboard Requirements... 15 Updating uparam.h... 15 Moving the Linux ABI X11 Libraries from the /usr/X11R6/lib Directory.... 16 Replacing Any Previous Version of the Install.XM/Uninstall.XM Scripts with the Most Recent Version.. 17 Removing Previous XFree86 and LessTif (or MetroX) Installation. 17 Installing XFree86 and LessTif with the Install.XM Utility.. 20 XFree86 and LessTif Installation Main Menu.. 21
XFree86 and LessTif for LynxOS Release Notes iii

CHAPTER 2

Modify Default Values... 22 Choose Products to Install... 24 Software Configuration Menu Options.. 24 Advanced Installation Options... 25 Advanced Installation Menu Options... 25 Completing XFree86 and LessTif Installation.. 25 Location of the XFree86 and LessTif Components in the System. 27 Miscellaneous Admin Menu Options.. 29 CHAPTER 3 X SERVER CONFIGURATION... 31 Overview... 31 Navigating xf86cfg... 32 Using a Mouse or Special Keys... 32 Using a Mouse with xf86cfg... 32 Using the Keyboard with xf86cfg... 32 Starting X Server Configuration... 34 Setting Color Depth and Monitor Resolution.. 35 Configuring the Extended PS/2 Mouse Wheel... 41 Selecting a Keyboard Model... 44 Setting Horizontal Sync and Vertical Refresh Frequencies (for PowerPC Boards Only).... 46 Configuring the Dual-Head Video Card... 49 Completing X Server Configuration... 76 Starting an X Session... 76 Stopping an X Session... 77 Rebooting the System from an X Session... 77 Mouse Support.... 77 Audio Bell.... 77 Default Configuration Files... 78 Switching Between Resolutions... 78 Using the LessTif MWM Pager... 78 BUILDING NOTES... 79 Preparing the PowerPC LynxOS Environment.. 79 Building XFree86... 80 Building LessTif.... 80 Building GLib... 81

Table 1-8 lists the contents of the VMPC Platform Binary Distribution CD-ROM.
Table 1-8: VMPC Platform Binary Distribution CD-ROM Filename /tar_images/<media_num>.xfree_vmpc.tar.gz /tar_images/<media_num>.lesstif.tar.gz /tar_images/<media_num>.glib.tar.gz /tar_images/<media_num>.gtk.tar.gz Contents
XFree86 distribution LessTif distribution GLib distribution GTK+ distribution
Table 1-8: VMPC Platform Binary Distribution CD-ROM (Continued) Filename /tar_images/<media_num>.pd.tar.gz /scripts/Install.XM /scripts/Uninstall.XM Contents
Posix Desktop distribution Installation script Uninstallation script
Table 1-9 lists the contents of the Optional XFree86 Source Distribution CD-ROM.
Table 1-9: Optional XFree86 Source Distribution CD-ROM Filename /tar_images/<media_num>.xfree86_src.tar.gz /tar_images/<media_num>.lesstif_src.tar.gz /tar_images/<media_num>.glib_src.tar.gz /tar_images/<media_num>.gtk_src.tar.gz Contents
Table 1-10 lists the contents of the Optional Posix Desktop Source Distribution CD-ROM.
Table 1-10: Optional Posix Desktop Source Distribution CD-ROM Filename /tar_images/<media_num>.pd_src.tar.gz Contents
Posix Desktop distribution
Installing XFree86 and LessTif
This chapter provides detailed installation instructions for the XFree86 and LessTif Development Package for the x86 and Power PC (PPC) platforms.
The installation process for the XFree86 and LessTif Development Package involves the following steps: 1. Ensuring that system requirements are met 2. Saving installed Linux ABI X11 libraries 3. Replacing any previous version of the Install.XM/Uninstall.XM scripts with the most recent version 4. Removing any previous XFree86 and LessTif installation or an obsolete Metro Link X and Motif (MetroX) installation 5. Running the XFree86 and LessTif installation script, Install.XM 6. Configuring the X server with xf86cfg The following sections describe these steps in full detail. The xf86cfg utility is described in Chapter 4, X Server Configuration.

Before Installing

Before proceeding with the actual installation of the XFree86 and LessTif Development Package, ensure that the following system requirements are met: The complete installation of the XFree86 and LessTif Development Package requires at least 272 MB of free disk space on the system.
XFree86 and LessTif for LynxOS Release Notes 13
Chapter 2 - Installing XFree86 and LessTif
The system should have a minimum of 16 MB of RAM; however, 32 MB is recommended. The system must include a supported monitor, graphics adapter, and pointing device.
These requirements are discussed in more detail in the following sections.

Disk Space Requirements

The XFree86 and LessTif Development Package requires approximately 272 MB of free disk space for installation. Table 2-1 describes disk space requirements in a per-component basis.
Table 2-1: Disk Space Requirements for the XFree86 and LessTif Development Package Components Component Free Disk Space
XFree86 LessTif GLib GTK+ Posix Desk
176 MB 38 MB 2 MB 22 MB 34 MB
Graphics Adapter Requirements
The system must include one of the supported monitors listed in Graphics Adapter Support on page 3.

Monitor Requirements

The XFree86 and LessTif Development Package requires a video monitor that is compatible with the systems video graphics adapter and capable of supporting the desired display resolution. Consult the manufacturers documentation of the video graphics adapter for specific monitor requirements.

Mouse Requirements

The system must include a pointing device for one of the supported mouse protocols listed in Mouse Support on page 5.
Installing the PS/2 Mouse Driver
If the PS/2 mouse driver was not installed during the LynxOS installation, the
Install.ps2mouse installation script can be used to install a PS/2 mouse driver.
To install the PS/2 mouse driver, perform the following steps: 1. Run the Install.ps2mouse script by entering the following command:
# /usr/bin/Install.ps2mouse
This script adds a PS/2 mouse driver and rebuilds the kernel. 2. Reboot the system by entering the following command:

# reboot -aN

The system boots with the PS/2 mouse driver support.

Keyboard Requirements

The system must include one of the supported keyboards listed in Keyboard Support on page 6.

Updating uparam.h

To increase the maximum number of X applications running on the system at the same time, the /sys/lynx.os/uparam.h file must be updated and the kernel rebuilt. The parameters that must be increased, as well as sample tested values, are described in Table 2-2.

Table 2-2: The uparam.h File Parameters Parameter NPROC USR_NFDS Default Value Sample Value1 Sample Value2 Description

150 64

512 512
512 Maximum number of processes 512 Maximum number of open files per process
Table 2-2: The uparam.h File Parameters (Continued) Parameter NFILES Default Value Sample Value1 Sample Value2 Description

100 40

1024 4096
2560 Maximum number of open files in system 1024 Maximum number of pipes 1024 Maximum number of sockets 40 Maximum number of POSIX shared memory objects

NPIPES NSOCKETS NSHM

1. These values allow running more than 200 xclock applications on LynxOS 4.0 PowerPC Patch Level 80 and higher or LynxOS 4.0 x86 Patch Level 26 and higher. 2. These values allow running more than 200 xclock applications on LynxOS 4.0 PowerPC before Patch Level 80 or LynxOS 4.0 x86 before Patch Level 26.
NOTE: After the /sys/lynx.os/uparam.h file has been updated, rebuild and install the kernel, then reboot the system using the following commands:
# cd /sys/lynx.os # make install # reboot -aN
Moving the Linux ABI X11 Libraries from the /usr/X11R6/lib Directory
Because the Linux ABI X11 libraries and the XFree86 and LessTif shared libraries have the same names and are installed into the same directory, /usr/X11R6/lib, the already installed Linux ABI X11 libraries should be moved from the /usr/X11R6/lib directory prior to installing the XFree86 and LessTif Distribution Package. If the libraries are not saved in a directory other than /usr/X11R6/lib, the Linux ABI X11 libraries will be replaced with the XFree86 and LessTif ones. For instance, if the /usr/lib/X11R6 directory is selected to store the Linux ABI X11 libraries, enter the following commands to move the libraries:
# mkdir -p /usr/lib/X11R6 # mv /usr/X11R6/lib/*.so* /usr/lib/X11R6
Replacing Any Previous Version of the Install.XM/Uninstall.XM Scripts with the Most Recent Version
To start a Linux X application, the LD_LIBRARY_PATH environment variable should be defined in such a way that the path to the location of the Linux ABI X11 libraries (/usr/lib/X11R6 in the above example) precedes the path to /usr/X11R6/lib before running the application. For instance:
# export LD_LIBRARY_PATH=/usr/lib/X11R6:$LD_LIBRARY_PATH
NOTE: The Linux ABI package must be installed before the XFree86 and LessTif Development Package.
Before proceeding with any manipulations of the XFree86 and LessTif distribution, perform the following steps to replace any previous version of the Install.XM and Uninstall.XM scripts with the most recent version of these scripts provided with the XFree86 and LessTif binary distribution: 1. Insert the XFree86 and LessTif binary distribution CD-ROM and mount it:

Modify Default Values

Modify Default Values Menu:
opens XFree86 and LessTif Uninstallation Configuration
*** Configuration Menu *** 1) XFree86 and LessTif Directory Q)uit Un-Installation R)eturn to Previous Menu Enter Option: [R] : /
Figure 2-3: XFree86 and LessTif Uninstallation Configuration Menu
XFree86 and LessTif Uninstallation Configuration Menu Options
The Configuration Menu options are as follows:
XFree86 and LessTif DirectoryUse this option to specify the absolute pathname to the directory containing XFree86 and LessTif files.
Return to the XFree86 and LessTif Uninstallation Main Menu and choose B to uninstall XFree86 and LessTif (or MetroX). The Uninstall.XM script informs the user about invoked steps, such as editing system files, deleting XFree86 and LessTif (or MetroX) components, and rebuilding the kernel.
Removing MetroX Installation
If the Uninstall.XM script is used to remove a MetroX installation, Uninstall.XM displays the following:
No XFree86 or LessTif files found under /. Please select: 1) Change XFree86 and LessTif Directory Q)uit Un-Installation C)ontinue Un-Installation: XFree86 and LessTif will not be fully Uninstalled Enter Option: [1]
After C is entered, the following information is displayed:
Checking if the MetroX distribution is installed. yes The following MetroX directories are detected: /usr/bin/X11 /usr/include/Exm /usr/include/Mrm /usr/include/uil /usr/include/Wc /usr/include/X11 /usr/include/Xm /usr/include/Xmp /usr/lib/X11 /usr/lib/Xm /usr/man/motif /usr/man/X11 /usr/src/motif The MetroX directories/files will be removed or renamed using a.MetroX extension. Do you wish to continue Un-Installation (y/n) ? [y] :
If n is specified, the uninstallation procedure is terminated. If y is specified, the Uninstall.XM script allows the user to choose whether the MetroX components have to be deleted or renamed:
Do you wish to remove the MetroX directories/files (y-remove/n-rename) ? [y] :
If n is specified, the MetroX components are renamed using a.MetroX extension. If y is specified, the MetroX components are removed.
Installing XFree86 and LessTif with the Install.XM Utility

Before installing XFree86 and LessTif, users must select the destination directory, specific components to be installed, and where the XFree86 and LessTif distribution is located. The provided installation script, Install.XM, must be run to set the options and install XFree86 and LessTif. To set up the installation options and start the installation, perform the following steps: 1. Insert the XFree86 and LessTif binary distribution CD-ROM and mount it:
2. Log in to the system as root and enter the following command:

# /usr/bin/Install.XM

XFree86 and LessTif Installation Main Menu
The following sections describe the XFree86 and LessTif installation menu options.
After Install.XM runs, the main menu is displayed:
*********** Main Menu ************ XFree86 and LessTif Installation ********************************** 1) Modify Default Values 2) Choose Products to Install Please make sure the Default Values and Products to Install are correct before Beginning the Installation. Q)uit Installation B)egin Installation Enter Option: [1]
Figure 2-4: XFree86 and LessTif Installation Main Menu
The Main Menu provide the following options:
Modify Default ValuesAllows the selection of various parameters related

to hardware.

Choose Products to InstallAllows
selections of the products to be

installed.

Quit InstallationUse
this option to exit the installation utility.
Begin InstallationUse this option to start the automated installation process using the current configuration.
These menu options are described in more detail in the following sections. After XFree86 is installed, the Install.XM utility provides an additional option for use in administrative configuration tasks:
Miscellaneous AdminThis option includes miscellaneous administration
management. For more information, see Miscellaneous Admin Menu Options on page 29.
The Modify Default Values option opens the Hardware Configuration Menu:
*** Hardware Configuration Menu *** 1) Install Directory 2) Installation Media Q)uit Installation R)eturn to Previous Menu Enter Option: [R] : / : /dev/ide.1
Figure 2-5: Hardware Configuration Menu
Hardware Configuration Menu Options
The Hardware Configuration Menu options are as follows:
Install DirectoryUse this option to specify the absolute pathname of the base installation directory. The default base installation directory is /.
NOTE: LynuxWorks recommends that the XFree86 and LessTif Development Package be installed in the root (/) directory. The distribution can be installed in any directory or file system as required. The file system in which the XFree86 and LessTif Development Package is installed should have enough disk space for future expansion. All components of the XFree86 and LessTif Development Package must be installed in the same file system and directory.

Installation MediaUse this option to specify the name of the media device that contains the product distribution. The default device is an IDE CD-ROM (/dev/ide.1). For more information about device naming in LynxOS, see the LynxOS Users Guide. This option opens the Installation Media Menu.
The Installation Media Selection Menu selects the device that contains the XFree86 and LessTif distribution media:
*** Installation Media Selection Menu *** Installing From: /dev/ide.1 1) 2) 3) 4) 5) SCSI Tape SCSI CD-ROM IDE CD-ROM (x86 and PowerPC only) 1.44MB Floppy Disk (x86 only) Other SCSI devices
6) From distribution tar files 7) Install pre-extracted distribution Q)uit Installation R)eturn to Previous Menu Enter Option: [R]
Figure 2-6: Installation Media Selection Menu
From distribution tar filesXFree86 and LessTif can be installed from a tar archive of the distribution by choosing option 6 (From distribution tar files). This option can be used to install XFree86 and LessTif from an NFS-mounted directory. Install pre-extracted distributionXFree86 and LessTif tar files are included on the CD-ROM in the tar_images directory. Select this option if the tar files have already been extracted onto the development system.
Choose Products to Install
Option 2 from the Main Menu, Choose Products to Install opens the Software Configuration Menu:
*** Software Configuration Menu *** 1) 2) 3) 4) 5) Install XFree86 (y/n) : y Install LessTif (y/n) : y Install GLib (y/n) : y Install GTK+ (y/n) : y Install Posix Works Desktop (y/n) : y Selecting (y) will cause the Posix Works Desktop environment to be run by default. Selecting (n) will result in a basic mwm or twm environment to be run instead. 6) Advanced Installation options Q)uit Installation R)eturn to Previous Menu Enter Option: [R]
Figure 2-7: Software Configuration Menu
Software Configuration Menu Options
The Software Configuration Menu options are as follows:
Install XFree86Use this option to toggle the install state for the XFree86
components of the XFree86 and LessTif Development Package.
Install LessTifUse this option to toggle the install state for the LessTif components of the XFree86 and LessTif Development Package. Install GLibUse
this option to toggle the install state for the GLib components of the XFree86 and LessTif Development Package.
Install GTK+Use this option to toggle the install state for the GTK+ components of the XFree86 and LessTif Development Package. Install Posix Works DesktopUse this option to toggle the install state for the PosixWorks Desktop to be used with the XFree86 product. PosixWorks Desktop is available only for native LynxOS installations. Advanced Installation OptionsUse

this option to rebuild the LynxOS kernel after the XFree86 and LessTif installation (recommended). This option also sets xf86cfg to run after the XFree86 and LessTif installation.
Advanced Installation Options
Option 6 from the Software Configuration Menu, Advanced Installation options opens Advanced Installation Menu:
*** Advanced Installation Menu *** 1) Rebuild and Install a New LynxOS Kernel 2) Run the X Server Configuration Utility Q)uit Installation R)eturn to Previous Menu Enter Option: [R] : y : y
Figure 2-8: Advanced Installation Menu
Advanced Installation Menu Options
The Advanced Installation Menu options are as follows:
Rebuild and Install a New LynxOS KernelUse
this option to rebuild and install the LynxOS kernel after the XFree86 and LessTif installation (recommended). this option to run the
Run the X Server Configuration UtilityUse
xf86cfg X server configuration utility after the XFree86 and LessTif

installation.

Completing XFree86 and LessTif Installation
Return to the XFree86 and LessTif Installation Main Menu and choose B to install XFree86 and LessTif.

MetroX Uninstallation

If a MetroX distribution is still installed on the system, the Install.XM script displays the following:
Checking if the MetroX distribution is installed. yes The following MetroX directories are detected: /usr/bin/X11 /usr/include/Exm /usr/include/Mrm /usr/include/uil
/usr/include/Wc /usr/include/X11 /usr/include/Xm /usr/include/Xmp /usr/lib/X11 /usr/lib/Xm /usr/man/motif /usr/man/X11 /usr/src/motif The MetroX directories/files will be removed or renamed using a.MetroX extension. Do you wish to continue Installation (y/n) ? [y] :
If n is specified, the installation procedure is terminated. If y is specified, the Install.XM script allows the user to choose whether the MetroX components have to be deleted or renamed:

Linux ABI X11 Libraries

If the Linux ABI package is already installed on the system, the Install.XM script displays the following:
Checking if the Linux ABI X11 libraries are installed. yes The Linux ABI X11 libraries are detected in the /usr/X11R6/lib directory. XFree86 will over-write these libraries. Do you wish to copy the Linux ABI X11 libraries to a different directory (y/n) ? [y] :

Figure 3-10: The Mouse Options Window with the Buttons 5 Option Specified
b. Specify the ZAxisMapping option and save it by pressing the add button.
Figure 3-11: The Mouse Options Window with the ZAxisMapping Option Specified
c. Close the mouse options window and save the settings by clicking the Popdown dialog button.
Selecting a Keyboard Model
By default, the X server configures the keyboard device as a generic 101-key PC keyboard. To select a different keyboard model, perform the following steps: 1. Place the mouse pointer over the keyboard image in the layout diagram in the main window and press the right button to open the keyboard configuration menu. 2. Keeping the mouse button pressed, go to the configure item.
Figure 3-12: The Layout Diagram with the Opened Keyboard Configuration Menu
3. Release the mouse button. The keyboard configuration window appears.
Figure 3-13: The Keyboard Configuration Window
4. In the keyboard configuration window, do the following: a. Open the window with the list of supported keyboard models by clicking the Keyboard model button.
b. Keeping the mouse button pressed, select a keyboard model.
Figure 3-14: The Keyboard Configuration Window with the Opened Window Containing the List of Supported Keyboard Models
c. Release the mouse button. d. Close the keyboard configuration window and save the settings by clicking the Ok button.
Setting Horizontal Sync and Vertical Refresh Frequencies (for PowerPC Boards Only)
NOTE: The steps described in this section are PowerPC-specific and should be skipped for x86 boards. Since the X server on PowerPC boards does not support the mechanism to autodetect the hardware parameters of the connected monitor, the horizontal sync and vertical refresh frequencies supported by the monitor should be set using the xf86cfg utility.
To set the horizontal and vertical frequencies, perform the following steps: 1. Place the mouse pointer over the monitor image in the layout diagram in the main window and press the right button to open the monitor configuration menu. 2. Keeping the mouse button pressed, go to the configure item.
Figure 3-15: The Layout Diagram with the Opened Monitor Configuration Menu
3. Release the mouse button. The monitor configuration window appears.
Figure 3-16: The Monitor Configuration Window
Configuring the Dual-Head Video Card
4. In the monitor configuration window, do the following: a. Select horizontal and vertical frequencies by clicking the respective items in the Horizontal sync and Vertical sync windows.

Figure 3-32: The Layout Diagram with the Opened Second Monitor Configuration Menu
23. Release the mouse button. The second monitor configuration window appears.
Figure 3-33: The Second Monitor Configuration Window
24. In the second monitor configuration window, do the following: a. Select horizontal and vertical frequencies supported by the connected monitor by clicking the respective items in the Horizontal sync and Vertical sync windows. NOTE: To determine horizontal and vertical frequencies supported by the connected monitor, refer to the monitor specification. b. Open the window with the list of video cards available in the current layout by clicking the Select card connected to monitor button.
c. Keeping the mouse button pressed, select the Card1 item.
Figure 3-34: The Second Monitor Configuration Window with the Selected Horizontal and Vertical Sync Frequencies and the Opened Window Containing the List of Video Cards Available in the Current Layout
d. Release the mouse button.
e. Close the second monitor configuration window and save the settings by clicking the Ok button. The layout diagram in the main window reflects that the second monitor is connected to the second video card.
Figure 3-35: The Layout Diagram with the Second Monitor Connected to the Second Video Card
25. Press the Configure Layout button in the main window to open the general configuration menu. 26. Keeping the mouse button pressed, go to the Configure Screen item.
Figure 3-36: The xf86cfg Main Window with the Opened General Configuration Menu
27. Release the mouse button The screen diagram containing the images of two monitors replaces the layout diagram in the main window.
Figure 3-37: The Screen Diagram with the Images of Two Monitors in the xf86cfg Main Window (Second Monitor to Right of First Monitor)
28. Move the monitor images in the screen diagram to obtain the desired dual-monitor geometry configuration. For instance, to configure monitors to the second monitor below first monitor mode, the screen diagram should look as follows:
Figure 3-38: The Screen Diagram with the Images of Two Monitors in the xf86cfg Main Window (Second Monitor Below First Monitor)
29. Set a custom color depth and monitor resolution for each monitor as described in Setting Color Depth and Monitor Resolution on page 35.
30. Click the Expert Mode button in the main window to display the Expert window.

# tar zxf <media_num>.xfree86_src.tar.gz # cd XFree86-4.3.0 #./int/XFbuild.sh
where <media_num> is a LynuxWorks-assigned unique number. The XFree86 binary distribution is created in the current directory.

Building LessTif

To build the LessTif binary distribution, copy the
<media_num>.lesstif_src.tar.gz source distribution to the LynxOS 4.0 native target and enter the following commands as root: # tar zxf <media_num>.lesstif_src.tar.gz # cd LessTif-0.93.36 #./int/LTbuild.sh
where <media_num> is a LynuxWorks-assigned unique number. The LessTif binary distribution is created in the current directory.

Building GLib

To build the GLib binary distribution, copy the <media_num>.glib_src.tar.gz source distribution to the LynxOS 4.0 native target and enter the following commands as root:
# tar zxf <media_num>.glib_src.tar.gz # cd GLib-1.2.10/ #./int/GLbuild.sh
where <media_num> is a LynuxWorks-assigned unique number. The GLib binary distribution is created in the current directory.

Building GTK+

To build the GTK+ binary distribution, copy the
<media_num>.gtk_src.tar.gz source distribution to the LynxOS 4.0 native target and enter the following commands as root: # tar zxf <media_num>.gtk_src.tar.gz # cd GTK+-1.2.10 #./int/GTKbuild.sh
where <media_num> is a LynuxWorks-assigned unique number. The GTK+ binary distribution is created in the current directory.
Building PosixWorks Desktop
To build the PosixWorks Desktop binary distribution, copy the <media_num>.pd_src.tar.gz source distribution to the LynxOS 4.0 native target and enter the following commands as root:
# tar zxf <media_num>.pd_src.tar.gz # cd PosixDesk-2.16 # make OS=lynxos LYNXOS_RELEASE=4.0.0 \ XFREE=YES EXCLUDE_MOSAIC=NO # make OS=lynxos LYNXOS_RELEASE=4.0.0 \ XFREE=YES EXCLUDE_MOSAIC=NO build # cd install/<platform>/4.0.0 # tar zcf <media_num>.pd.tar.gz./usr
where <platform> is the name of the development host platform (x86 or ppc) and <media_num> is a LynuxWorks-assigned unique number.

CHAPTER 5

Known Problems and Limitations
This chapter describes known problems and limitations of this release.

Common Problems

MWM Window Manager MWM Application Menu
Closing any X application window (for example, the xterm window) using the Close <Alt><F4> item of the MWM application menu (menu activated by clicking the left mouse button on the knob in the upper left corner of the application frame) may result in the menu window remaining in the upper left corner of the root window after the application window has been closed. Clicking the left mouse button in a free space of the root window closes the menu window. Clicking the left mouse button inside any X application window (for example, the xterm window) with the opened MWM application menu results in closing the MWM application menu and opening the MWM Root Menu menu (this menu is ordered to be activated by clicking the left mouse button in a free space if the root window) at the clicking point. All subsequent clicking inside the application window has the same effect. Clicking the left mouse button in the upper panel of the application window frame resolves the problem.

Matrox G45FMDHA32DB G450 and Matrox G55MDHA32DB G550 Video Cards
The X server fails to start if the 8 bpp color depth is used.
Sapphire Radeon 9000 Pro and ATI Radeon 9700 Pro Video Cards
LynxOS hangs returning from the graphics mode to the text mode if both (primary and secondary) monitors are connected to the video card. As a result, the XF86Config X server configuration file is not created while exiting from the xf86cfg utility. To properly configure the video card in the dual-head mode using the xf86cfg utility, the following workaround can be used: 1. Power off the board. Connect the monitor to the primary (DVI) video connector (make sure that no monitor is connected to the secondary video connector). 2. Power on the board. Start the xf86cfg utility and configure the video card to work in the dual-head mode. Refer to the LynxOS Installation Guide for more information. 3. Power off the board. Connect the second monitor to the secondary video connector. 4. Power on the board and start the X session.
PowerPC Platform Problems
Concurrent Technologies IO PMC/030 Asiliant Technologies 69030 Video Card
Graphical acceleration is not supported by this release. Colormap is corrupted for 16 bpp and 24 bpp color depths. Colormap may not be restored upon switching to text mode from graphical mode.
Asiliant Technologies 69000 Video Chip Integrated into the Radstone PPC7A Board

Thales VMPC6c Board

The mouse and the keyboard have not been tested on the VMPC6c board.

Thales VMPC7a Board

Use remote display to run an X application for the Thales VMPC7a board.

xedit Utility

The xedit utility crashes.
The Mosaic utility fails to start.
XFree86 and LessTif for LynxOS Testing
This release has been tested with the following x86 board: Intel D845GBV Motherboard with Pentium 4 2.4 (the x86_at and x86_drm BSPs).
This release has been tested with the following PowerPC boards: Motorola MCP750 (the cpi_drm BSP) Radstone PPC7A (the radppc7 BSP) Thales VMPC6c (the vmpc BSP)
This release has been tested with the following keyboard: Generic 104-key PC keyboard
This release has been tested with the following monitors: Sony Multiscan E400 Roverscan Optima 171
Appendix A - XFree86 and LessTif for LynxOS Testing

C BiT SYSTEM AMD VALUE

Computer Boulevard Inc.

www.cbit.ca or

September 16, 2003
www.computerboulevard.ca (W/ 2000+ & 256MB )(52X Burner) CB NEBULA SYSTEM (W/8x AGP Video & 52X Burner & 16x DVD) CB QUANTUM SINGULARITY SYSTEM (W/ 52x Burner & 16x DVD)
Motherboard: MSI (K7N2 Delta-L) (NForce2 SPP) 400Mhz FSB / Dual Channel (1-8x AGP / 5 PCI / 3DDR / USB 2.0) Processor: see below Memory: 333Mhz 256MB DDR Cooling Fan: (Combo H) B/B Heavy Duty Video: 128MB DDR / Geforce 4 MX440 / 8x AGP / TV Out / Video Card Sound: 3D Audio (OMB) Network: 10/100 Mbps Ethernet (OMB) 8x AGP MB Modem: None 8X AGP Video Hard Drive: 80GB / 7200RPM / UDMA133 System Optical Drive: 52x/24x/52x CDRW (Burn Proof) Optical Drive: 16X DVD Rom Floppy Drive: Panasonic 1.44MB Keyboard: Logitech Deluxe Access Internet PS/2 Keyboard Mouse: Logitech Optical Scroll Mouse & Pad Speaker: LUXOR (SK-A-21) 600W PMPO Sub + 2 Speakers Monitor: Daewoo (17PF) 17" /.25 / NI / Digital / Perfect Flat Tower Case: (728-W-R) 17" ATX (350W P.4 P.S.) Tower Case / USB 2.0 + Audio / (Two Tone Color (Silver and Ivory) Software: Windows XP Home (OEM + CD) Others: Additional 2nd B/B Fan

Computer Systems

Motherboard: ASROCK (K-7VM4)(VIA KM400) (3 PCI / 1- 8X AGP / 2 DDR 333Mhz / MAX 2.0GB) Processor: AMD XP 2000+ Memory: PC-2700 256MB DDR 333MHz Cooling Fan: Heavy Duty Heatsink / Fan Combo Video: 64 MB (Memory Sharing) AMD 2000+ Sound: 5.1 Audio (O.M.B.) w/ 8X AGP M/B Network: 10/100 Mbps (O.M.B.) Hard Drive: 40GB (7200RPM) Optical Drive: 52X / 24X / 52X CD-RW (Burn Proof) Floppy Drive: Panasonic 3.5" 1.44MB Keyboard: Asound PS/2 KEYBOARD Mouse: Harma PS/2 SCROLL MOUSE Speaker: HP(2000) 240w PMPO) Speakers T ower Case: 17" (0309-K) ATX (P.4 350W P.S.) w/ USB2.0 + Audio Software: Windows XP Home (OEM + CD) Other: Additional 2nd B/B Case Fan Misc: Microsoft Works & Money 2002

A LU E EAT V GR

Upgrade Option
Add Daytek (DT-77A) 17" Monitor & Tsunami PS/2 Keyboard, & PS/2 Scroll Mouse & 240W PC Speakers Add $149.00 OR

$639.00

Limited Quantity - While Supplies Last! W/ AMD XP 2200+..$659.00 XP 2400+..$679.00 XP 2500+..$695.00
30. 2001 Motherboard: Gigabyte (GA-7N400L) (Nforce2) Socket A / 40OFSB 400Mhz DDR / 8X AGP / USB 2.0 / ATX 8x AGP MB (5PCI / 1AGP / 4DDR / ATA133) 8X AGP Video Processor: see below System Memory: PC 3200 256MB DDR 400 Cooling Fan: (Combo H) Ceramics fan with Aluminum Heat Sink Video: 128MB DDR / Pandex Geforce FX5200 / 8X AGP Sound: 5.1 Channel Audio (O.M.B.) BLACK TOWER Network: 10 / 100 MBPS (O.M.B.) MONITOR Modem: Intel V90 / 56K / I / F / D PCI KEYBOARD Hard Drive: 80GB / 7200RPM / UDMA133 OPTICAL MOUSE DVD Drive: 16X DVD (Black) CD-RW + DVD-ROM Optical Drive: 52x / 32x / 52X CD-RW (Black) SPEAKERS Floppy Drive: Panasonic 1.44MB (Black) Keyboard: QTronix (Black) Keyboard Mouse: Logitech Optical Scroll Mouse + Pad (Black) Speaker: Luxor (680H) 1600W PMPO / 5.1 Sub + 5 Speakers (Blk) Monitor: TTX (1777B) 17" /.25 / Black / Perfect Flat T ower Case: (728-B-R) 17" Tower Case w/ P4 350w P.S. / USB2.0 + Audio / (T Tone (Silver + Black) w/ Side Window wo Software: Windows XP Home (OEM + CD) Others: Additional CPU Case Cooling Fan

Options:

w/ XP 2200.$1,099.00 w/ XP 2400.$1,119.00 w/ w/ w/ w/ XP XP XP XP (333Mhz) (333Mhz) (333Mhz) (333Mhz).$1,139.00.$1,159.00.$1,219.00.$1,289.00
w/ XP 2200.$1,299.00 w/ XP 2400.$1,319.00 w/ XP2500 (333Mhz).$1,339.00
Add Daytek (77A) 17" monitor..Add $135.00
w/ XP 2600 (333Mhz).$1,359.00 w/ XP 2700 (333Mhz).$1,419.00 w/ XP 2800 (333Mhz).$1,489.00 w/ XP 3000 (333Mhz).$1,609.00

AVAILABLE UPGRADES FOR ALL PACKAGES

MICROSOFT

OFFICE XP SMALL BUSINESS
WORKS SUITE 2003 *WORD 2002 *MONEY 2002 *ENCARTA ENCYCLOPEDIA 2002 *PICTURE IT! PHOTO 2002 *STREET & TRIPS 2002
Wordperfect Office 11 (2003) *Wordperfect 11 *Quattro 11 *Presentation 11

SYSTEM WORKS 2003 PRO.

NORTON
*Microsoft Word 2002 *Microsoft Excel 2002 *Microsoft Outlook 2002 *Microsoft Publisher 2002

$279.95

$114.95

$37.95

$27.95
INTERNET SEC. 2003 Standard
*ANTI VIRUS 2003 *CLEAN SWEEP *NORTON UTILITIES 2003 *GOBACK/SYSTEM RECOVERY * & MORE
*ANTI VIRUS 2003 *PERSONAL FIREWALL *PRIVACY CONTROL *SPAM ALERT *PARENTAL CONTROL

$39.95

ANTI VIRUS 2003
$18.95 SYMANTEC WINFAX PRO 10.0 $24.95

upg. upg. upg.

w/ Daytek 755DF Monitor.ADD $28 to Daytek DT-95P Monitor.ADD $58.00 w/ Daytek DT-95P Monitor..ADD $73 to Daytek 963DF Monitor.ADD $127.00 w/ Daytek 953DF Monitor.ADD $167 to Daytek (MV150) 15" LCD Flat Panel Monitor.ADD $225.00 (MV173) 17" LCD Flat Panel Monitor.ADD $369.00
INTEL VALUE SYSTEM (Intel Celeron 2.20Ghz W/52X Burner & 16X DVD)
Motherboard: ECS (P4VXASD2+) 533Mhz FSB (1AGP / 4PCI / 2DIMM / 2DDR / USB2.0) Processor: INTEL CELERON 2.20Ghz Cooling Fan: INTEL H/D B/B COOLING FAN Memory: PC 2700 256MB 333Mhz DDR Video: GEFORCE 2 MX400 / 64MB / AGP Sound: 3D AUDIO (OMB) Network: 10 / 100 MBPS (OMB) Pentium 4 Ready Hard Drive: 40GB (7200RPM) Celeron 2.2Ghz Optical Drive: 52X / 24X / 52X CD-RW Optical Drive: 16X DVD Rom Floppy Drive: 1.44MB PANASONIC Keyboard: Asound PS/2 KEYBOARD Mouse: HARMA OPTICAL SCROLL MOUSE Speaker: LUXOR (SKA-21) 600W PMPO SUB + 2 SPEAKERS Monitor: Daewoo (17PF) 17" /.25 / NI / Digital / Perfect Flat Tower Case: (0309-K) 17" (P4-350W P.S.) Tower Cas ew/USB 2.0 & Audio Software: WINDOWS XP HOME EDITION (OEM +CD) Others: ADDITIONAL CASE FAN Misc: Microsoft Works & Money 2002
CB PENTIUM 4 ANOMALY SYSTEM (W/52X Burner & 16X DVD Rom)
Motherboard: Processor: Memory: Cooling Fan: Video: Sound: Network: Modem: Hard Drive: Optical Drive: Optical Drive: Floppy Drive: Keyboard: Mouse: Speaker: Monitor: T ower Case: Software: ASUS (P4S533-MX) 533Mhz / USB 2.0 (1AGP/3PCI/2DDR/2DIMM) see below 256MB DIMM Intel Original CPU Cooling Fan 64MB Video (Memory Sharing) (O.M.B.) Direct 3D (O.M.B.) 10 / 100Mbps Ethernet (O.M.B.) Intel V90 / 56K / I / F / D / PCI 80GB / 7200RPM / UDMA133 52x24x52 CDRW (Burn Proof) 16x DVD ROM Panasonic 1.44MB Logitech Deluxe Access Internet PS/2 Keyboard Harma Optical Scroll Mouse Luxor (SKA-21) 600w PMPO Sub & 2 Speakers
CB PENTIUM 4 GALAXY SYSTEM (W/ 52x Burner & 16x DVD)
Motherboard: Gigabyte (GA-8IE1000-L) (Intel 865PE) P4-478 / 800Mhz FSB / 8X AGP
/ Dual Channel / Serial ATA (5PCI/1-8x AGP/4DDR)

P4 (533Mhz)

P4 (800Mhz)

$899.00

LU E G R E AT VA
Daewoo (17PF) 17" /.25 / NI / Digital / Perfect Flat (728-W-R) 17" ATX (350W P.4 P.S.) Tower Case / USB 2.0 + Audio / (Two Tone Color (Silver and Ivory)
Windows XP Home (OEM + CD)
Processor: Memory: Cooling Fan: Video: Sound: Network: Modem: Hard Drive: DVD Drive: Optical Drive: Floppy Drive: Keyboard: Mouse: Speaker: Monitor: T ower Case:
w/ P.4 1.8G(512K).$1,129.00
w/ P4 2.4G (533FSB).$1,179.00 w/ P4 2.66G(533FSB).$1,199.00 w/ P4 2.80G(533FSB).$1,299.00
see below PC-3200 256MB DDR 400 Intel Heavy Duty CPU Cooling Fan 128MB DDR / Pandex Geforce FX5200 / 8X AGP 5.1 Channel Audio (O.M.B.) 10-100Mbps PCI Ethernet 800Mhz FSB Intel V90 / I / F / D / Spk-Phone 8x AGP MB 80GB / 7200RPM / UDMA133 16X DVD 8X AGP Video 52x/24x/52x CDRW (Burn Proof) Panasonic 1.44MB Logitech Deluxe Access Internet PS/2 Keyboard Logitech Optical Scroll Mouse & Pad Luxor (680H) 1600W PMPO / 5.1 Sub + 5 Speakers Daewoo (17PF) 17" /.25 / NI / Digital / Perfect Flat (728-B-R) 17" Tower Case w/ P4 350w P.S. / USB2.0 + Audio / (T Tone (Silver + Black) w/ Side Window wo Software: Windows XP HOME (OEM + CD)
2.40G.$1,419.00 2.60G.$1,465.00 2.80G.$1,549.00 2.40G.$1,439.00 2.60G.$1,499.00 with ASUS P4P800 2.80G.$1,589.00 Motherboard. Add $45
w/ Intel Celeron 2.4 Ghz.Add $25 w/ Intel Pent. 4 1.8GB (256K).Add $79
Pent. 4 (512K) CPU 1.80G CPU.$1,379.00
Limited Quantity - While Supplies Last!
No Payment, No Interest For 6 Months O.A.C. (Consumer Financing only)
Unit B - 1250 St. James St. Winnipeg, Manitoba R3H 0L1 Phone: (204) 772 - 1088 Fax: (204) 775 - 3202 Out of T own : 1-866-255-0099