tran_reset_notify(9E)						Driver Entry Points					     tran_reset_notify(9E)

NAME

       tran_reset_notify - request to notify SCSI target of bus reset

SYNOPSIS

       #include <sys/scsi/scsi.h>

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

INTERFACE LEVEL

       Solaris architecture specific (Solaris DDI).

PARAMETERS

       ap	    Pointer to the scsi_address(9S) structure.

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

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

       arg	    The callback function argument.

DESCRIPTION

       The tran_reset_notify() entry point is called when a target driver requests notification of a bus reset.

       The  tran_reset_notify()  vector  in the scsi_hba_tran(9S) structure may be initialized in the  HBA driver's attach(9E) routine to point to
       the HBA entry point to be called when a target driver calls scsi_reset_notify(9F).

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

       SCSI_RESET_NOTIFY     Register callback as the reset notification function for the target.

       SCSI_RESET_CANCEL     Cancel the reset notification request for the target.

       The  HBA driver maintains a list of reset notification requests	registered by the target drivers.   When a  bus  reset	occurs,  the   HBA
       driver notifies registered target drivers by calling the callback routine, callback, with the argument, arg, for each registered target.

RETURN VALUES

       For  SCSI_RESET_NOTIFY requests,  tran_reset_notify() must return DDI_SUCCESS if the notification request has been accepted, and  DDI_FAIL-
       URE otherwise.

       For SCSI_RESET_CANCEL requests,	tran_reset_notify() must return DDI_SUCCESS if the notification request has been canceled, and DDI_FAILURE
       otherwise.

SEE ALSO

       attach(9E), scsi_ifgetcap(9F), scsi_reset_notify(9F), scsi_address(9S), scsi_hba_tran(9S)

       Writing Device Drivers

SunOS 5.11							    30 Aug 1995 					     tran_reset_notify(9E)