sdi_register(D3I) sdi_register(D3I)
NAME
sdi_register - register a Host Bus Adapter (HBA) with SDI
SYNOPSIS
#include <sys/sdi.h>
#include <sys/ddi.h>
int sdi_register(struct hba_info *infop, struct hba_idata *idatap);
Arguments
infop Pointer to the HBA driver's information structure,
hba_info(D4I).
idatap
Pointer to the instance data in the structure
hba_idata(D4I) for the specific device being registered.
DESCRIPTION
sdi_register registers an HBA with SDI.
This routine causes a series of SCSI inquiry commands to be
sent to the HBA to identify the devices attached to it. All
devices found are entered into the equipped device table
(EDT).
Return Values
Upon successful completion, sdi_register returns the
controller number to which the HBA is registered. If the
value in idatap->cntlr is invalid, or the hardware is not
installed in the machine, a negative value is returned
indicating the error. If no devices are found and HBA_MP is
not set in infop->hba_flag then a negative value is returned
indicating the error. If no devices are found and HBA_MP is
set then zero is returned and it is not considered an error.
USAGE
This function is typically called by the start(D2I) routines
of HBA drivers to register configured device instances of the
given HBA.
The controller number to which the device is to be registered
must be placed in the cntlr field of the hba_idata(D4I)
structure before the sdi_register call. This value should
have been obtained from, or validated by, the
sdi_gethbano(D3I) routine.
Copyright 1994 Novell, Inc. Page 1
sdi_register(D3I) sdi_register(D3I)
Level
Base only.
REFERENCES
hba_idata(D4I), hba_info(D4I), sdi_gethbano(D3I)
NOTICES
Applicability
sdi: 1, 2
Copyright 1994 Novell, Inc. Page 2