Kernel Functions for Drivers                scsiresetnotify(9F)



NAME
     scsiresetnotify - notify target driver of bus resets

SYNOPSIS
     #include 



     void scsiresetnotify(struct scsiaddress *ap, int flag,
          void (*callback)(caddrt), caddrt arg);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     ap          Pointer to the scsiaddress structure.


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


     callback    A pointer to the target driver's reset notifica-
                 tion function.


     arg         The callback function argument.


DESCRIPTION
     The scsiresetnotify() function 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:

     SCSIRESETNOTIFY    Register callback as the reset  notifi-
                          cation function for the target driver.


     SCSIRESETCANCEL    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  scsiifgetcap(9F)  func-
     tion.



SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                scsiresetnotify(9F)



RETURN VALUES
     If flag is SCSIRESETNOTIFY, scsiresetnotify() returns:

     DISUCES    The notification request has been accepted.


     DIFAILURE    The transport layer does  not  support  reset
                    notification   or   could   not  accept  this
                    request.



     If flag is SCSIRESETCANCEL, scsiresetnotify() returns:

     DISUCES    The notification request has been canceled.


     DIFAILURE    No notification request was registered.


CONTEXT
     The scsiresetnotify() function can be  called  from  user,
     interrupt, or kernel context.

SEE ALSO
     scsiaddress(9S), scsiifgetcap(9F)


     Writing Device Drivers


























SunOS 5.11          Last change: 16 Jan 2006                    2