scsi_reset_notify(9F)

NAME

     scsi_reset_notify - notify target driver of bus resets

SYNOPSIS

     #include <sys/scsi/scsi.h>

     void scsi_reset_notify(struct scsi_address  *ap,  int  flag,
     void (*callback)(caddr_t), caddr_t arg);

INTERFACE LEVEL

     Solaris DDI specific (Solaris DDI).

PARAMETERS

     ap    Pointer to the scsi_address structure.

     flag  A flag indicating registration or cancellation of  the
           notification request.

     callback
           A pointer to the target  driver's  reset  notification
           function.

     arg   The callback function argument.

DESCRIPTION

     scsi_reset_notify() is used by a target driver when it needs
     to be notified of a bus reset. The bus reset could be issued
     by the transport layer (e.g.  the  host  bus  adapter  (HBA)
     driver or controller) or by another initiator.

     The  argument flag is used to register or cancel the notifi-
     cation.  The supported values for  flag are as follows:

          SCSI_RESET_NOTIFY
                Register callback as the reset notification func-
                tion for the target driver.

          SCSI_RESET_CANCEL
                Cancel the reset notification request.

     Target drivers can find out whether the  HBA driver and con-
     troller  support  reset notification by checking the  reset-
     notification capability using the   scsi_ifgetcap(9F)  func-
     tion.

RETURN VALUES

     If  flag is  SCSI_RESET_NOTIFY, scsi_reset_notify() returns:

          DDI_SUCCESS
                The notification request has been accepted.

          DDI_FAILURE
                The transport layer does not support reset notif-
                ication  or could not accept this request.

     If flag is  SCSI_RESET_CANCEL, scsi_reset_notify() returns:

          DDI_SUCCESS
                The notification request has been canceled.

          DDI_FAILURE
                No notification request was registered.

CONTEXT

     scsi_reset_notify() can be called  from  user  or  interrupt
     context.

SEE ALSO

     scsi_address(9S), scsi_ifgetcap(9F)

     Writing Device Drivers