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