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)