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:

• 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 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.