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

Mouse Support

The XFree86 and LessTif Development Package provides support for the following mouse protocols: Serial Mouse Protocols: AceCad GlidePoint IntelliMouse Logitech Microsoft MMHitTab MMSeries MouseMan MouseSystems ThinkingMouse
Standard PS/2 Mouse Protocols: GenericPS/2 PS/2
Extended PS/2 Mouse Protocols: ExplorerPS/2 GlidePointPS/2 IntelliMousePS/2 MouseManPlusPS/2 NetMousePS/2 NetScrollPS/2 ThinkingMousePS/2
NOTE: Bus mice are not supported.

Keyboard Support

The XFree86 and LessTif Development Package provides support for the following keyboards: Acer AirKey V ACPI Standard Advance Scorpius KI Brazilian ABNT2 Brother Internet Keyboard BTC 5113RF Multimedia BTC 5126T BTC 9000 BTC 9000A Cherry Blue Line CyBo@rd Cherry Blue Line CyBo@rd (alternate option) Chicony Internet Keyboard Chicony KB-9885 Compaq Easy Access Keyboard Compaq Internet Keyboard (7 keys) Compaq Internet Keyboard (13 keys) Compaq Internet Keyboard (18 keys) Compaq Internet Keyboard for laptop/notebook (for example, Presario) Compaq iPaq Keyboard Compaq Laptop Keyboard for laptop/notebook (for example, Armada) Dell Dell 101-key PC Dell Inspiron 8XXX laptop/notebook Diamond 9801/9802 series Dexxa Wireless Desktop Keyboard

Ennyah DKB-1008 Everex STEPnote Generic 101-key PC Generic 102-key (Intl) PC Generic 104-key PC Generic 105-key (Intl) PC Genius Comfy KB-16M/Genius MM Keyboard KWD-910 Hewlett-Packard Internet Keyboard Hewlett-Packard Omnibook 500 FA Hewlett-Packard Omnibook XE3 GC Hewlett-Packard Omnibook XE3 GF Hewlett-Packard Omnibook XT1000 Hewlett-Packard Pavilion ZT11XX Hewlett-Packard SK-2501 Multimedia Keyboard Hewlett-Packard SK-2505 Internet Keyboard Honeywell Euroboard IBM Rapid Access IBM Rapid Access II IBM Rapid Access II (alternate option) Japanese 106-key Keytronic FlexPro Logitech Cordless Desktop Logitech Cordless Desktop iTouch Logitech Cordless Desktop Navigator Logitech Cordless Desktop Optical Logitech Cordless Desktop Pro Logitech Cordless Desktop Pro (alternate option) Logitech Cordless Desktop Pro (alternate option2)

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.

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:
# mount -o ro /dev/<cdrom_device_id> /mnt
2. Log in to the system as root and copy the Install.XM and Uninstall.XM scripts from the CD-ROM to the /usr/bin directory:
# cp /mnt/[TBD]/Install.XM /usr/bin # cp /mnt/[TBD]/Uninstall.XM /usr/bin

3. Unmount the CD-ROM:

# umount /mnt
Removing Previous XFree86 and LessTif (or MetroX) Installation
Before installing the XFree86 and LessTif distribution, any previous version of XFree86 and LessTif must be removed, as well as any obsolete MetroX installation. To remove any existing XFree86 and LessTif (or MetroX) installation, log in to the system as root and enter the following command:

# /usr/bin/Uninstall.XM

The following sections describe the XFree86 and LessTif uninstallation menu options.
XFree86 and LessTif Uninstallation Main Menu
After running Uninstall.XM, the following info screen is displayed:
This script will remove all components of XFree86 and LessTif installed. If XFree86 and LessTif are installed in a directory other than /, then that directory will be removed. If XFree86 and LessTif have been installed in /, then /usr/X11R6, /etc/X11, /etc/fonts directories will be removed. All changes made to the various files during XFree86 and LessTif installation will be reversed. Press <Enter> to Continue:
Figure 2-1: XFree86 and LessTif Uninstallation Info Screen
After pressing Enter, the Main Menu is displayed:
************* Main Menu ************* XFree86 and LessTif Un-Installation ************************************* 1) Modify Default Values Please make sure the Default Values are correct before Beginning the Un-Installation. Q)uit Un-Installation B)egin Un-Installation Enter Option: [1]
Figure 2-2: XFree86 and LessTif Uninstallation Main Menu
The Main Menu provides the following options:
Modify Default ValuesAllows
the selections of various parameters

related to hardware.

Quit Un-InstallationUse
this option to exit the uninstallation utility.
Begin Un-InstallationUse this option to start the automated uninstallation process using the current configuration.
Completing XFree86 and LessTif (or MetroX) Uninstallation
These menu options are described in more detail in the following sections.

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:

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

Using a Mouse with xf86cfg
Since the xf86cfg utility automatically detects and configures the mouse device, no special actions are required to add mouse support to xf86cfg. NOTE: For instructions on installing the PS/2 driver for the generic PS/2 and the extended PS/2 mice, see Installing the PS/2 Mouse Driver on page 15.
Using the Keyboard with xf86cfg
The keyboard can be used instead of the mouse device to navigate through the
xf86cfg menus. The keys to emulate specific actions of the mouse device are shown in the accessx window of the xf86cfg utility (see Figure 3-1 on 35).
The navigation keys shown in the accessx window are described in the table below.
Table 3-1: Navigation Keys Button Action
Move the mouse pointer up and left.
Move the mouse pointer up.
Move the mouse pointer up and right.
Table 3-1: Navigation Keys (Continued) Button Action
Move the mouse pointer left.
Move the mouse pointer right.
Mouse pointer down and left.
Move the mouse pointer down.
Move the mouse pointer down and right.
Select the left mouse button (this button is selected by default). Select the middle mouse button.
Select the right mouse button.
Click a selected mouse button.
Double-click a selected mouse button.
Lock a selected mouse button.
Release a selected mouse button.
Starting X Server Configuration
The xf86cfg utility is installed in the /usr/X11R6/bin directory. To start xf86cfg, log in as root and enter the following command:

# /usr/X11R6/bin/xf86cfg

Figure 3-1 shows the two windows that appear on the screen: The xf86cfg main window (xf86cfg) shows the current configuration layout. The accessx window shows the navigation keys described in Table 3-1 on page 32.
Setting Color Depth and Monitor Resolution
Figure 3-1: The Main Window and the accessx Window of the xf86cfg Utility
By default, the X server (XFree86 version 4.3.0) uses the 8 bpp (bit per pixel) color depth and a monitor resolution that is the maximum for the detected monitor and video adapter hardware parameters. To set a custom color depth and monitor resolution, perform the following steps: 1. Press the Configure Layout button in the main window to open the general configuration menu.
2. Keeping the mouse button pressed, go to the Configure Screen item.
Figure 3-2: The xf86cfg Main Window with the Opened General Configuration Menu
3. Release the mouse button. The screen diagram replaces the layout diagram in the main window.
Figure 3-3: The Screen Diagram in the xf86cfg Main Window
4. Place the mouse pointer over the screen image and press the right mouse button to open the screen configuration menu.

b. Keeping the mouse button pressed, select the video driver obtained in Step 4 (refer to page 51).
Figure 3-25: The Second Video Card Configuration Window with the Opened Window Containing the List of the Video Drivers Supported by XFree86
c. Release the mouse button.
d. Specify the BusID parameter obtained in Step 4 on page 51.
Figure 3-26: The Second Video Card Configuration Window with the BusID Parameter Specified
e. Close the second video card configuration window and save settings by clicking the Ok button.
14. Place the mouse pointer over the second video card image in the layout diagram in the main window and press the right button to open the video card configuration menu. 15. Keeping the mouse button pressed, go to the enable item.
Figure 3-27: The Layout Diagram with the Opened Second Video Card Configuration Menu
16. Release the mouse button. The layout diagram in the main window reflects that the second video card is enabled.
Figure 3-28: The Layout Diagram with the Second Video Card Enabled
17. Place the mouse pointer over the monitor icon in the layout diagram in the main window and press the right button to open the multiple monitors configuration menu. 18. Keeping the mouse button pressed, go to the Add new monitor item.
Figure 3-29: The Layout Diagram with the Opened Multiple Monitors Configuration Menu
19. Release the mouse button. The image of the second monitor appears in the upper left corner of the layout diagram in the main window.
Figure 3-30: The Layout Diagram with the Second Monitor Image
20. To make the layout diagram more suitable for use, drag the image of the second monitor to a free space in the layout diagram.
Figure 3-31: The Layout Diagram with the Moved Second Monitor Image
21. Place the mouse pointer over the second monitor image in the layout diagram in the main window and press the right button to open the monitor configuration menu. 22. Keeping the mouse button pressed, go to the configure item.
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

b. Move the scroll bar on the left of the Expert window to show the Card1 items.
Figure 3-43: The Opened Device Configuration Menu in the Expert Window with the Card1 Items Shown
c. Clear the ChipID, ChipRev, and IRQ items of Card1. Set the Screen item of Card1 to 1.
Figure 3-44: The Opened Device Configuration Menu in the Expert Window with the Card1 Settings Corrected
d. Close the Expert window by clicking the Close button.
Completing X Server Configuration
To quit the xf86cfg utility and save the settings, click the Quit button in the main window. The first quit window appears.
Figure 3-45: The First xf86cfg quit Window
Close the window by clicking the Yes button. The second quit window appears.
Figure 3-46: The Second xf86cfg quit Window
Close the window by clicking the Yes button. The X server configuration is completed.

Starting an X Session

To start an X session, enter one of the following commands at the command line prompt:

startx xinit xdm

NOTE: In some situations (if the previous X session has not been terminated correctly), the.X0-lock file (the file used by the X server to lock an X session) may not be deleted from the /tmp directory, and this situation will prevent a

Stopping an X Session

NOTE: (Continued) new X session from a successful start. In this case, the user must manually remove the /tmp/.X0-lock before starting the X session:

# rm /tmp/.X0-lock

To stop an X session, use the Ctrl-Alt-Backspace key combination.
Rebooting the System from an X Session
To terminate the X session correctly and reboot the system, use either of the following methods: Reboot the system using the Reboot item from the mwm window manager Root Menu. (To display the mwm Root Menu, place the pointer on an empty space of the screen and click the left mouse button.) Stop the X Session using the Ctrl-Alt-Backspace key combination and then reboot the system from the command line.
The XFree86 X server automatically detects and configures the mouse device, including serial, generic PS/2, and extended PS/2 mice. Note that for the generic PS/2 and the extended PS/2 mice, the PS/2 mouse driver must be installed in LynxOS before it is available to xf86cfg (see Installing the PS/2 Mouse Driver on page 15).

Audio Bell

The default bell tone can be changed using the xset utility. Refer to the xset manual page for details.

Default Configuration Files
The default files /.xinitrc, /.xsession, /.mwmrc, and /.Xdefaults are provided in the XFree86 and LessTif distribution. These can be used as is or as examples to create custom configuration files. The default X resource file (/usr/X11R6/lib/X11/xdm/Xresources) is also provided.
Switching Between Resolutions
If more than one monitor resolution is available, the following key combination allows changing the resolution on the fly: To increase the resolution: Ctrl-Alt-+ To reduce the resolution: Ctrl-Alt--
Using the LessTif MWM Pager
Please note the following when using the LessTif MWM pager: To switch between logical screens, the user should click the middle mouse button in the free space of the selected logical screen image in the pager window. Note that the left mouse button works the same way as the middle button, but must be pressed for a longer period of time (for example, approximately 1 second). To move windows from one logical screen to another, the user should grab the selected window image in the pager window by pressing the middle mouse button and move the grabbed window through the pager logical screens while keeping mouse button pressed. To create a sliding logical screen (this screen can be located in any place between the real logical screens), the user should press the right mouse button in the pager window and place the opened sliding screen in the desired position between the real logical screens by moving the mouse pointer while keeping the mouse button pressed.

Building Notes

This chapter provides building notes for the XFree86 and LessTif Development Package. To build these packages requires purchase of the Optional XFree86 Source Distribution CD-ROM and Optional Posix Desktop Source Distribution CD-ROM.
Preparing the PowerPC LynxOS Environment
Before building the XFree86 and LessTif binary distributions, update the PowerPC LynxOS Environment by performing the following steps as root: 1. Edit the /etc/starttab file to set the data and stack limits to 65536. 2. Send the SIGHUP signal to the init process to allow the init process to obtain the changes in the /etc/starttab file:

# kill -HUP 1

Chapter 4 - Building Notes

Building XFree86

NOTE: To build the distribution for the radppc7 BSP, the BuildRADPPC7 flag must be set to YES in the XFree86-4.3.0/xc/config/cf/lynx.cf file before executing the XFbuild.sh script. To build the distribution for the vmpc BSP, the BuildVMPC6C flag must be set to YES in the XFree86-4.3.0/xc/config/cf/lynx.cf file before executing the XFbuild.sh script. To build the XFree86 binary distribution, copy the <media_num>.xfree86_src.tar.gz source distribution to the LynxOS 4.0 native target and enter the following commands as root:

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.
Chapter 5 - Known Problems and Limitations

MWM Pager

Attempting to close the MWM Pager by using the Close <Alt><F4> item of the menu activated by clicking the left mouse button on the knob in the upper left corner of the MWM Pager window frame does not have any effect.

3D Acceleration

The video card 3D acceleration features are not available on LynxOS 4.0 x86 and PowerPC because support of the video 3D acceleration in XFree86 is based on a Direct Rendering Interface (DRI) that is not supported by the LynxOS 4.0 kernel.

emacs Utility

The emacs utility (this is part of LynxOS) does not work with XFree86.

The xload Utility

The xload utility fails to start.

PosixWorks Desktop

The following problems exist for PosixWorks Desktop: The PosixWork Desktop Pager is not provided in this release. The moxfm utility does not work correctly: Drag-and-dropping the file icons from the moxfm window to the PosixWorks Desktop Editors or Print icons results in the pop-up of an error message dialog. Clicking on some icons in the moxfm application panel (activated by clicking the Moxfm AP item from the Appl menu) does not produce any action or displays an error message dialog.
The Restore layout and the Restore default layout commands from the PosixWorks Desktop Admin->Layout menu do not work properly.
XFree86 Shared Libraries Conflict with Linux ABI
The PosixWorks Desktop panels (Main, Networks, Appl, and Tools) may be shown using the decoration styles described in Table 5-1:
Table 5-1: PosixWorks Desktop Panels Decoration Styles Panel Style Separated icons Description
The panel is shown as a horizontal or vertical set of separated icons. The panel is shown as a horizontal or vertical set of icons united into undecorated (without the MWM border) window. The panel is shown as a horizontal or vertical set of icons united into decorated (with the MWM border) window. The panel is shown as a set of icons united into a decorated square window.

Undecorated panel

Decorated panel

Window

Attempting to show the Main panel as Undecorated panel or Decorated panel (by default, the Main panel is shown as Separated icons) using the Decorated panel or Undecorated panel commands from the Main panel mngr menu of the Admin icon results in the Print, Appl, Tools, Admin, Trash, and Help icons being lost. As workaround, show the Main panel as Window or Separated icons only. The menu of the PosixWorks Desktop Tools icon does not have the default item. As a result, clicking the left button on the Tools icon does not have any effect (clicking the left button on the Tools icon should result in appearing or disappearing of the Tools panel). As workaround, to activate or deactivate the Tools panel, use the Activate commands from the Tool panel mngr menu of the Tools icon.
panel and Deactivate panel
The Linux ABI X11 shared libraries and the XFree86 shared libraries for LynxOS 4.0 have the same names and are installed into the same directory, /usr/X11R6/lib. Without intervening user action, the Linux ABI X11 shared libraries will be replaced by the XFree86 shared libraries when the XFree86 binary
XFree86 and LessTif for LynxOS Release Notes 85
distribution in installed. To install and use both the Linux ABI and XFree86 and LessTif for LynxOS distributions successfully, perform the following steps: 1. Install the Linux ABI distribution from the Additional Components CD-ROM. Refer to the LynxOS Installation Guide for installation instructions. 2. Move the Linux ABI X11 libraries to a directory different from the /usr/X11R6/lib directory. For instance, the /usr/lib/X11R6 directory can be used:

Figure 5-15: The Opened Display Configuration Menu in the Expert Window with the Display with 16 Color Depth Shown
Figure 5-16: An Empty Modes Item Shown in the Expert Window
Figure 5-17: The Modes Item Shown in the Expert Window with the Monitor Resolution Set
Figure 5-18: The Modes Item Shown in the Expert Window with the Monitor Resolution Saved
9. Move the scroll bar on the left of the Expert window to show the Display button of the Screen0 configuration menu.
Figure 5-19: The Display Button of the Screen0 Configuration Menu Shown in the Expert Window
10. Click the Display button to close the Screen0 Display configuration menu.
Figure 5-20: The Opened Screen Configuration Menu in the Expert Window
11. Click the Display button in the Screen1 configuration menu. The new button appears.
Figure 5-21: The Opened Screen Configuration Menu in the Expert Window with the new Button Shown
12. Click the new button to open the Display configuration menu.
Figure 5-22: The Opened Display Configuration Menu in the Expert Window
13. Move the scroll bar on the left of the Expert window to show the Screen1 Display configuration menu item.
Figure 5-23: The Opened Display Configuration Menu in the Expert Window
14. Specify the color depth selected at Step 3 on page 100 (16 in this example) in the Depth item.
Figure 5-24: The Opened Display Configuration Menu in the Expert Window with the Color Depth Set
15. Specify the monitor resolution in the Modes item.
Figure 5-25: The Opened Display Configuration Menu in the Expert Window with the Monitor Resolution Set
Dual-Head Video Card in the Dual-Head Mode
16. Click the new button in the Modes item to save the monitor resolution.
Figure 5-26: The Opened Display Configuration Menu in the Expert Window with the Monitor Resolution Saved
17. Click the Close button to close the Expert window.
Dual-Head Video Card in the Dual-Head Mode Common Problems
The X server fails to start if different color depths (8 bpp/16 bpp, 8 bpp/24 bpp, and 16 bpp/24 bpp) are used for primary and secondary displays.
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.