DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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 --  

 Routine        | Context       ||DDI 7 | DDI 8 | ODDI | All
 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:

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


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