OpenServer 5 NFB Graphics Driver Development Kit

The O5xlinkit package includes utilities, #include files, libraries, and makefiles for developing a NFB graphics driver on OpenServer:

X11/server/README
Describes how to get started

X11/xmkddx
Script to create templates for your driver

X11/server/ddx/ports/nte
Sample driver source

Version 7.1.0a of the O5xlinkit package differs from previous versions in the following ways:

  • Fixed compilation of statically linked Xsco binary when debugging is enabled. Debuggers like dbx and dbxtra now work correctly and no longer get the error message: 'invalid line number table' when run.
  • Updated X11/server/README with additonal debugging hints.

For current information about the entire UnixWare/OpenServer Hardware Developers Kit (HDK) release, see the HDK Release Notes.

Note: Documentation references on this page link to the Product Documentation.

System requirements

This package has no installation dependencies. The package can be installed on either UnixWare 7 or OpenServer 5 (Release 5.0.5 and later) although the tools can only be used to build and install NFB graphics drivers on OpenServer 5 systems. The xlinkkit contains similar tools for developing NFB graphics drivers on UnixWare 7 systems.

The following must be installed on your OpenServer 5 system before using the O5xlinkit development tools to develop a graphics driver:

devsys
OpenServer Development System product

Do not use the UnixWare/OpenServer Development Kit (UDK) when developing a graphics driver. The UDK contains X11R6 libraries, while the OpenServer X server must link with X11R5 libraries. Ensure that /udk is not in your PATH when running xmkddx or make.

Installation

Before installing this version of the O5xlinkit package on your system, you must remove any earlier versions.

To install the package from:

downloaded files

  1. Log in as root.
  2. Download the package to an installation directory; for example, /tmp.
  3. Use the pkgadd(ADM) command to install it by entering:
    pkgadd  -d  /tmp/O5xlinkit

media distribution

  1. Log in as root.
  2. Insert the CD-ROM in the drive.
  3. Create a cdrom directory if it does not already exist:
    mkdir  /cdrom
  4. Mount the CD-ROM by typing:
    mount  -r  /dev/cd0  /cdrom
  5. Use the pkgadd(ADM) command to install it by entering:
    pkgadd  -d  /cdrom/O5xlinkit

Configuration

Read the instructions in X11/server/README before running X11/xmkddx.

Known limitations

The following limitations exist in this release:

  • When testing your driver with the xtests package, you must use the UnixWare/OpenServer Development Kit instead of the OpenServer Development System product. See the xtests package for more information.

For more information

More information concerning NFB graphics drivers may be found in Developing NFB graphics adapter driver.

The xtests package contains test suites that can be used to test NFB graphics drivers on both OpenServer and UnixWare 7 systems.