sdi_rxedt(D3sdi)
sdi_rxedt --
search the EDT for an extended entry
Synopsis
#include <sys/types.h>
#include <sys/sdi.h>
#include <sys/ddi.h>
struct sdi_edt *sdi_rxedt(int hba, int bus,
int scsi_id, int lun);
Description
sdi_redt-
search the EDT for an entry (Not in current SDI version)
sdi_rxedt( )
returns a pointer to an Equipped Device Table
(EDT) entry
for the device specified by
the hba, bus,
scsi_id, and lun given
if such an entry exists.
If the EDT is empty
or no matching entry exists,
a NULL pointer is returned.
Arguments
hba-
HBA number for the device.
The value for hba used
must be the same as the value returned by the
sdi_gethbano(D3sdi)
function
when the Host Bus Adapter (HBA) was initialized.
bus-
SCSI channel of this device on the HBA
scsi_id-
target number of this device on the given bus and HBA
lun-
logical unit number of this device on
the given target, bus, and HBA
Return values
On success,
sdi_rxedt( )
returns a pointer to an
sdi_edt(D4sdi)
structure.
A NULL return indicates
that no matching entry exists.
Usage
sdi_rxedt( )
is typically used in a global
open/close/command routine.
Rather than maintaining a local table of
valid hba:scsi_id:lun tuples,
SDI drivers should use the existing EDT
(either the
scsi_edt(D4sdi)
or
scsi_xedt(D4sdi)
structure)
through this function to determine the
validity of such a tuple.
sdi_rxedt( )
is also the approved interface
for obtaining a pointer
to an existing sdi_edt structure.
This pointer can then be used for calls to
sdi_wedt(D3sdi)
to modify an EDT entry.
Context and sensitivity
Blockable
context.
Applicable hardware
x86/Pentium compatible architectures
Version applicability
For
sdi_rxedt,( )
sdi:
4
HBA and target drivers.
Differences between versions
Drivers written for SDI versions
prior to version 4 can use the
sdi_redt( )
function instead of
sdi_rxedt.( )
The synopsis is:
struct sdi_edt * sdi_redt(int hba, int scsi_id,
int lun);
References
sdi_edt(D4sdi),
sdi_gethbano(D3sdi)
``Extended SCSI addressing scheme'' in HDK Technical Reference
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005