sdi_aen(D3I) sdi_aen(D3I)
NAME
sdi_aen - asynchronous event notification routine
SYNOPSIS
#include <sys/sdi.h>
void sdi_aen(int event, int hba, int scsi_id, int lun)
Arguments
event The code value of the asynchronous event which occurred
on the HBA device.
hba The HBA number of the device which experienced the
event.
scsi_id
The target ID of a specific device, or -1 if the event
affects all devices for the HBA driver.
lun The logical unit number of a specific device, or -1 if
the event affects all logical units for the HBA driver.
DESCRIPTION
sdi_aen calls the target driver fault handling routine to
signal an asynchronous event, such as bus error or device
error. Use of this routine is not required since many HBA
drivers handle errors without help from the target drivers.
Also target drivers are not required to provide a fault
handling routine.
Return Values
None.
USAGE
When some critical asynchronous event (a bus reset) occurs on
an HBA device which may require target driver actions, sdi_aen
is the provided mechanism to signal target drivers. A target
driver must provide a fault handling routine which is
associated with the EDT structure for the device. When an
event occurs, sdi_aen is called with the event code, the HBA
number, and the target ID and LUN. The target ID and LUN can
be -1 if all target drivers for devices connected to the HBA
should have their fault routines called.
Level
Interrupt only.
Copyright 1994 Novell, Inc. Page 1
sdi_aen(D3I) sdi_aen(D3I)
NOTICES
The sdi_aen originates in pre-PDI versions of the
architecture, when the devices involved required greater
interaction to keep them in a sane state. Current devices
require less intervention, so the need for sdi_aen has greatly
diminished. This routine is being considered for removal in a
future release.
NOTICES
Applicability
sdi: 1, 2
Copyright 1994 Novell, Inc. Page 2