Getting Started


UDK Compatibility Modules for SCO UnixWare 2.1.X

UDK Compatibility Modules (also known as Binary Compatibility Modules or BCMs) for SCO® UnixWare® 2.1.X enable applications compiled on UnixWare 7 development environments to be run on SCO UnixWare 2.1.X systems.

Compatibility modules are created in conjunction with SCO UnixWare/OpenServer Development Kit (UDK) releases. For example, UW2compat.700 enables applications that were written and compiled with UDK Release 7.0.0. If you purchase an application that was compiled with a later UDK release, you must upgrade your compatibility module; consult your application vendor for compatibility module requirements.

In general, the latest release of the UW2compat module is usually the best one to use for your platform. However, certain applications will require a specific module, so be sure to check the system requirements for your application.

For technical details about the contents of the compatibility module, see ``How the BCM works on SCO UnixWare 2.1.X''.

For more information about the UDK, see the UDK documentation set on the SCO documentation server; click on Software Development.

System Requirements

Software: UW2compat.700 for SCO UnixWare Release 2.1, 2.1.1, 2.1.2 or 2.1.3
UW2compat.710 for SCO UnixWare Release 2.1.3
UW2compat.711 for SCO UnixWare Release 2.1.3
RAM: N/A
Disk Space: 10MB

Installation


NOTE: You must remove any previous UW2 module from your SCO UnixWare system before installing a newer version. To remove the older version, enter:

pkgrm UW2compat.version_string_if_any

If you have ptf4001 installed on your system, you must remove it before removing the UW2 module. It can then be re-installed after installing the new UW2 module. You should also note that a newer version of the ptf may be available from the Download page.


Perform the following steps as root:

  1. Download the product tar files from the Download page.

  2. Move the file to a preferred installation directory:
    mv filename*.tar /tmp

  3. Change to the installation directory:
    cd /tmp

  4. Using the tar(1) command, extract the installation images:
    tar xvf filename.tar

  5. If compressed, uncompress the files:
    uncompress *.Z

  6. Install the compatibility module:
    pkgadd -d `pwd`/UW2compat.version_string.pkg

Product Updates

The latest compatibility module release for your platform is available at this download site.

How the BCM works on SCO UnixWare 2.1.X

The SCO UnixWare 2.1.X compatibility module works by installing UnixWare 7 versions of the shared libraries loaded by an application on SCO UnixWare 2.1.X, as well as installing the UDK tools.

The SCO UnixWare 2.1.X BCM replaces existing libraries with UnixWare 7 libraries. After installing the SCO UnixWare 2.1.X BCM, all binaries are executed with the updated set of libraries, effectively extending the SCO UnixWare 2.1.X APIs to provide UnixWare 7 interfaces.

An example is the UnixWare 7 libc for SCO UnixWare 2.1.X, which maps data structures and constants that are different on the two platforms. There is no need to map system calls numbers and error returns, since the UnixWare 7 and SCO UnixWare 2.1.X implementations of these interfaces are similar.


Document version 710a
19 March 1999
© 1999 The Santa Cruz Operation, Inc. All rights reserved.