UnixWare 7

prefix(D1)

prefix -- driver prefix

Synopsis (Not in current DDI version)

   int prefixclose();
   int prefixopen();
   . . .

Description

Every driver must define a unique prefix for symbol names. This enables the driver's named entry points to be identified by configuration software and decreases the possibility of global symbol collisions in the kernel.

Usage

The prefix is usually specified in a kernel module configuration file for the driver. The maximum length of the prefix is implementation-defined. Symbol names for named driver entry points are constructed by concatenating the driver prefix with the name for the entry point.

Examples

A DDI 7 character device driver using a driver prefix of ``xyz'' might define the following global functions to be used as its named entry points: xyzinit, xyzdevinfo, xyzopen, xyzclose, xyzread, xyzwrite, xyzioctl, and xyzintr. It would also define the variable xyzdevflag. Any other static and global symbols defined by this driver should also begin with ``xyz.''

Hardware applicability

All

Version applicability

ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp

External dependencies

On SCO UnixWare 1 and 2 systems, the driver prefix is specified in the ``prefix'' field of the driver's Master(4dsp) file and is limited to 8 characters.

References

devflag(D1), Intro(D2), drvops(D4)

``Entry-point routines''