Technical article 105893

What is SLS OSS467A, the Maxspeed and Boundless Multiconsole Supplement for OpenServer 5.0.4?

OpenServer 5.0.4

Written · Last revised

Problem

Loading the drivers supplied by Boundless or Maxspeed causes X display corruption when I start the X server.

Cause

Boundless or Maxspeed terminal emulation requires the MAP_CLASS ioctl to turn off console video memory and provide a pointer to map memory for direct video writing. The SCO OpenServer 5.0.4 Xserver uses mmap(S) to implement this functionality instead of the MAP_CLASS ioctl. This results in display problems.

Solution

Support Level Supplement (SLS) OSS467A provides a patch to the OpenServer 5.0.4 Xserver to correct this problem.

See the attached cover letter that accompanies this SLS for more information, including installation instructions.

NOTES:    Boundless Technologies, Inc. was formerly known as SunRiver, and
          in some cases may still be referred to as such.

Maxspeed Corporation was formerly known as Maxpeed Corporation.

This problem occurs only on SCO OpenServer 5.0.4.

See also

TA105821, "Boundless (formerly SunRiver) terminal emulation disables the Serial Manager under OpenServer 5.0.4."

TA105823, "Boundless (formerly SunRiver) or Maxspeed terminal emulation causes X server display problems under OpenServer 5.0.4."

Dear SCO Customer,

The enclosed Support Level Supplement (SLS) OSS467A, the Maxspeed and Boundless Multiconsole Supplement, corrects a problem with the SCO XServer when used with Maxspeed or Boundless multiconsoles.

SLS OSS467A is intended for use on these products:

SCO OpenServer Enterprise System Release 5.0.4 SCO OpenServer Desktop System Release 5.0.4 SCO OpenServer Host System Release 5.0.4 SCO OpenServer Internet FastStart Release 5.0.4

SLS OSS467A uses the presence of the file /usr/lib/vidconf/.multiconsole to determine how the XServer maps its memory. If /usr/lib/vidconf/.multiconsole is present, the XServer will revert to the old way of mapping memory. Maxspeed and Boundless multiconsoles will function correctly in this manner, however, kernel links will be required for changes to video configuration. If /usr/lib/vidconf/.multiconsole is not present, the XServer will continue to use the 5.0.4 method of memory mapping, which does not require kernel re-links for video configuration changes, but does not function correctly with Maxspeed or Boundless multiconsoles.

I. INSTALLING SLS OSS467A
1. Prepare the media for installation.

Download the OSS467A media image file (oss467a.Z file), place the file in the /tmp directory, uncompress and rename the file by typing the following commands:

uncompress /tmp/oss467a.Z
mv /tmp/oss467a /tmp/VOL.000.000

2. Run the Software Manager with the command:

# scoadmin software

or double-click on the Software Manager icon in the desktop.

3. Pull down the "Software" menu and select "Install New".

4. When prompted for the host to install from, choose the local machine and then "Continue".

5. When prompted to select the media device:

If you are installing this SLS from diskette media, select the appropriate floppy disk drive and then "Continue". Proceed to step 6.

If you are installing this SLS from media images per step 1, select
"Media Images", then "Continue".  When prompted for the "Image
Directory", enter "/tmp" (or the directory where you placed the VOL
file in step 1) and then select "OK".

6. When prompted to select software to install, ensure that the "OSS467A" entry is highlighted. Choose "Install".

7. Once the installation finishes, quit the Software Manager. Installation of SLS OSS467A is now complete. The changes will take effect the next time you start the XServer.

II. REMOVING SLS OSS467A
Note: Patches must be rolled back in the reverse order in which they
      were installed on a per-component basis.  The OSS467A Maxspeed and
      Boundless Multiconsole Supplement consists of a patch to the SCO
      XServer and Vidconf components. If either of these components was
      patched after OSS467A was installed, then you will have to roll back
      the later patch before you can roll back the SLS OSS467A patch.
1. Log in as root.
2. Execute the command:
# scoadmin software

or double-click on the Software Manager icon in the desktop.

3. Highlight "OSS467A: Supplement for Maxspeed and Boundless Multiconsoles".

4. Pull down the "Software" menu and select "Remove Software".

5. Once the removal finishes, quit the Software Manager.  Removal of
   SLS OSS467A is now complete. The changes will take effect the next
   time you start the XServer.
III. PRESERVING CUSTOMIZED FILES

SLS OSS467A backs up the following user-configurable file and then replaces it:

/etc/conf/cf.d/vuifile
If you have customized this file, you can restore your changes from
the backed-up copy after you install this SLS.  The file is backed
up to:
/usr/lib/custom/oss467a.sav/etc/conf/cf.d/vuifile

If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier.

We appreciate your business.
SCO Support Services

From the Xinuos technical article database, record 105893. Reproduced with permission. The original is at www.sco.com/ta/105893, which is reachable but blocked from search engines. Xinuos marks this article against a retired product line. That refers to the product’s lifecycle, not to whether the advice still works — plenty of it still applies to running systems.

Next step

Need this fixed rather than explained?

Tell us the release, what the system runs and what it is doing. We will reply by email with what we would do next.

  • You deal with the people who do the work
  • No obligation, and no upgrade required before we will help
  • We tell you plainly if something is not worth doing

Send an enquiry

We reply by email. If a server is down, say so in the first line. You can also write to help@scoexpert.com.