DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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