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