SVR5 and SCO OpenServer

Intro(D2str)

Intro -- introduction to STREAMS driver entry point routines

Synopsis

   #include <sys/types.h>
   #include <sys/stream.h>
   #include <sys/stropts.h>
   #include <sys/ddi.h>

Description

This section includes STREAMS specific manual pages for the standard driver entry points that are documented in the DDI Section D2 manual pages in Section D2 manual pages for SVR5, and in the ODDI Section D2oddi manual pages in Section D2oddi manual pages for SCO OpenServer, This section provides a complete list of all entry point routines that can be used in STREAMS drivers. For standard routines, the pages in this section provide supplementary usage information that pertains just to STREAMS drivers and modules.

Entry points

The following table compares the entry point routine set that are commonly used when implementing STREAMS drivers and modules for DDI 7, DDI 8 and ODDI.

Comparison of (STREAMS DDI 7, DDI 8, and ODDI entry point routines)

Routine Context DDI 7 DDI 8 ODDI All

Notes

close(D2str) blockable rn r rn syntax varies

config(D2str) blockable -- rh --

devinfo(D2str) blockable on r -- syntax varies

init(D2str) initalization on -- r

intr(D2str) interrupt oh oh oh syntax varies

_load(D2str) blockable o r --

open(D2str) blockable rn r r syntax varies

put(D2str) interrupt rn r r

srv(D2str) interrupt on o o

_unload(D2str) blockable o r --

KEY:

Routine	Context	DDI 7	DDI 8	ODDI	All
Notes
close(D2str)	blockable	rn	r	rn	syntax varies
config(D2str)	blockable	--	rh	--
devinfo(D2str)	blockable	on	r	--	syntax varies
init(D2str)	initalization	on	--	r
intr(D2str)	interrupt	oh	oh	oh	syntax varies
_load(D2str)	blockable	o	r	--
open(D2str)	blockable	rn	r	r	syntax varies
put(D2str)	interrupt	rn	r	r
srv(D2str)	interrupt	on	o	o
_unload(D2str)	blockable	o	r	--

o: Optional.
r: Required.
h: Hardware drivers only.
n: Named entry point (pre-DDI 8 and ODDI only).

Usage

streamtab(D4str) structure that contains pointers to qinit(D4str) structures.

DDI 8 STREAMS drivers can use streamtab for all entry point routines or can use the drvops(D4) structure used to declare non-STREAMS entry points for standard entry point routines like open( ) and close( ) and use the streamtab structure only for STREAMS-specific entry points like put(D2str) and srv(D2str).

See Section D2mdi manual pages in Section D2mdi manual pages for additional details about using these entry points in MDI drivers on both SVR5 and SCO OpenServer drivers.

References

Intro(D2), Intro(D2mdi), Intro(D2oddi)

Developing STREAMS modules and drivers in Developing STREAMS modules and drivers

``Context of a driver'' in HDK Technical Reference
``DDI interface versioning'' in HDK Technical Reference
``ODDI driver interface version for SCO OpenServer 5'' in HDK Technical Reference
``STREAMS in DDI 8'' in Developing STREAMS modules and drivers