sdi_notifyevent(D3I) sdi_notifyevent(D3I)
NAME
sdi_notifyevent - driver event notification routine
SYNOPSIS
#include <sys/scsi.h>
#include <sys/sdi.h>
#include <sys/ddi.h>
int sdi_notifyevent(int event, struct scsi_adr *scsi_adr, struct sb *sbp);
Arguments
event The event type code, as defined in sdi_event(D4I).
scsi_adr
Pointer to the SCSI address of the device for which the
event is being reported.
sb Pointer to the sb(D4I) (command block) structure (if
any) corresponding to the event being reported. It is
only used as an argument to the event-handling routine.
DESCRIPTION
sdi_notifyevent, together with sdi_addevent(D3I) and
sdi_rmevent(D3I), implements a driver-to-driver communication
mechanism for PDI SCSI drivers based on event codes and SCSI
device types.
Sdi_notifyevent calls all event-handling routines currently
registered by drivers which match the SCSI address, scsi_adr,
of the associated device type.
Return Values
On success, sdi_notifyevent returns SDI_RET_OK. On failure of
any of the event-handling routines being called, it returns
SDI_RET_ERR.
USAGE
Sdi_notifyevent will be called by a driver wishing to notify
other drivers of a particular event. The drivers wishing to
be notified need to register their corresponding event
handlers using sdi_addevent. An example of such an
interaction is when the disk driver needs to notify another
driver of the first open on a given disk. It will do so by
calling sdi_notifyevent with event set to SDI_FIRSTOPEN,
scsi_adr set to the address of the disk, and sb set to NULL.
Copyright 1994 Novell, Inc. Page 1
sdi_notifyevent(D3I) sdi_notifyevent(D3I)
Level
Base or Interrupt.
REFERENCES
sdi_addevent(D3I), sdi_event(D4I), sdi_event_alloc(D3I)
sdi_event_free(D3I), sdi_rmevent(D3I)
NOTICES
Applicability
sdi: 2
Copyright 1994 Novell, Inc. Page 2