DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

owner(D4sdi)


owner -- specify target driver device claims structure

Synopsis

   #include <sys/sdi.h>
   #include <sys/ddi.h>

Description

owner structures are used to maintain information about the target drivers currently claiming a given device. Because the SDI system must be able to allow serial sharing of devices among multiple target drivers, the owner structure identifies the target drivers that are using the device.

Structure definition

The owner structure, defined as struct owner, contains the following members:
   struct owner                *next;
   struct sdi_edt              *edtp;
   struct drv_majors           maj;
   void                        (*fault)();
   int                         (*target_rm_dev)();
   long                        flt_parm;
   struct owner                *target_link;
   struct sdi_driver_desc      *ow_sddp;
   char                        *name;

Structure members


next

edtp
Back pointer to the EDT entry.

maj
Owner's major/minor number information, used for DDI versions prior to version 8. For DDI 8 drivers, this is unset.

fault
Routine to call after an asynchronous event. This routine executes in interrupt context and must be coded accordingly.

target_rm_dev
Routine to call to disclaim the device.

flt_parm
Parameter to the routine specified in the fault member.

target_link
Target driver's list of owners.

ow_sddp
Pointer to a sdi_driver_desc(D4sdi) structure.

name
Owner's name.

Usage

The owner structures are added dynamically to the device EDT entry, as HBA drivers and target drivers are initialized. During HBA driver initialization, the HBA's start(D2sdi) routine calls the sdi_register(D3sdi) function which calls each of the target driver's rinit(D2sdi) routines. This allows the target driver to claim newly added devices.

owner structures should not be allocated directly by drivers. They will be passed to the drivers from SDI.

Applicable hardware

All.

Version applicability

sdi: 2, 3, 4

Differences between versions

The ow_sddp member is supported only on SVR5 and later operating system releases.

References

drv_majors(D4sdi), rinit(D2sdi), sb(D4sdi), sdi_edt(D4sdi), sdi_register(D3sdi), start(D2sdi)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005