Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Driver Entry Pointstran_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_FAILURE 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.9Go To TopLast Changed 30 Aug 1995

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.