ODDI driver interface version for SCO OpenServer

The ODDI driver version is a pseudo-versioning scheme used to document the primary SCO OpenServer kernel/driver interface. True interface versioning is not implemented in the SCO OpenServer 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 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

 O/S release                 |  Supported versions
 Pre-3.2v4                   |  oddi: 1
 UNIX 3.2v4 and ODT 3        |  oddi: 1, 2, 2mp
 SCO OpenServer 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

*

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 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 Release 5 drivers; the "Difference between versions" field of the manual page describes what to use instead for SCO OpenServer 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:

• Section D2oddi manual pages -- Driver entry point routines

• Section D3oddi manual pages -- Kernel functions

• Section D4oddi manual pages -- Kernel structures

• The eisa(D5), mca(D5), and pci(D5) manual pages provide information that is relevant to ODDI as well as DDI.

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

• Section D2str manual pages -- STREAMS entry point routines

• Section D3str manual pages -- STREAMS kernel functions

• Section D4str manual pages -- STREAMS kernel structures

SCO OpenServer 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 UnixWare versioning scheme, although it is mostly a documentation convention rather than a scheme that is enforced by the software. UnixWare 7 drivers can not be run on SCO OpenServer systems, nor can SCO OpenServer drivers be run on UnixWare 7 systems. See ``UDI (Uniform Driver Interface)'' for information about a driver interface that is under development for both UnixWare 7 and SCO OpenServer systems as well as a number of other platforms.