HDK Technical Reference

ODDI driver interface version for SCO OpenServer 5

The ODDI driver version is a pseudo-versioning scheme used to document the primary SCO OpenServer 5 kernel/driver interface. True interface versioning is not implemented in the SCO OpenServer 5 kernel, but identifying functions by this pseudo-version provides a convenient scheme for identifying functions and practices that are obsolete and should not be used in new drivers, although they continue to be supported for older drivers.

ODDI version support

O/S release Supported versions
Pre-3.2v4 oddi: 1
UNIX 3.2v4 and ODT 3 oddi: 1, 2, 2mp
SCO OpenServer 5 Release 5.0.0 oddi: 1, 2, 2mp, 3, 3mp
SCO OpenServer Release 5.0.4 oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp
SCO OpenServer Release 5.0.5 oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp
SCO OpenServer Release 5.0.6 oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6*, 6mp
&harveywest; oddi: 1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6*, 6mp

The main feature added in ODDI Version 6 is support for the high-precision system clock discussed in ``Clock, system''. This functionality can be backported to earlier SCO OpenServer 5 releases by installing the ``KAMCLOCK TLS''. Drivers and applications that require this functionality and are supported on earlier operating system releases should install this TLS as part of the software package.

Each manual page for an entry point routine, function, or structure has a "Version applicability" field that defines the ODDI versions where this entity can be used. For example, the add_intr_handler(D3oddi) function is supported only for ODDI version 2, so it should be used for ODT 3 drivers but not for SCO OpenServer 5 Release 5 drivers; the "Difference between versions" field of the manual page describes what to use instead for SCO OpenServer 5 Release 5 drivers. Similarly, the TICKS(D3oddi) macros are supported only for ODDI versions 5, 5mp, 6, and 6mp so can be used only in drivers written for SCO OpenServer Release 5.0.5, SCO OpenServer Release 5.0.6, and later releases.

The ODDI interface is documented in the following manual page sections:

The ODDI STREAMS interface is documented in the same manual page sections used for the DDI STREAMS interface:

SCO OpenServer 5 systems also support all versions of the OSDI interface and version 1 of the MDI interface.

Note that the use of this pseudo-versioning scheme parallels the SVR5 versioning scheme, although it is mostly a documentation convention rather than a scheme that is enforced by the software. SVR5 drivers can not be run on SCO OpenServer 5 systems, nor can SCO OpenServer 5 drivers be run on SVR5 systems. See ``UDI (Uniform Driver Interface)'' for information about a driver interface that is under development for both SVR5 and SCO OpenServer 5 systems as well as a number of other platforms.

© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005