opensolaris man page for tran_tgt_probe

tran_tgt_probe(9E)						Driver Entry Points						tran_tgt_probe(9E)

NAME
       tran_tgt_probe - request to probe SCSI bus for a particular target

SYNOPSIS
       #include <sys/scsi/scsi.h>

       int prefixtran_tgt_probe(struct scsi_device *sd, int (*waitfunc,
	    void)););

INTERFACE LEVEL
       Solaris architecture specific (Solaris DDI).

PARAMETERS
       sd	    Pointer to a  scsi_device(9S) structure.

       waitfunc     Pointer to either  NULL_FUNC or SLEEP_FUNC.

DESCRIPTION
       The tran_tgt_probe() vector in the scsi_hba_tran(9S) structure may be initialized during the HBA driver's attach(9E) to point to a function
       to be called by scsi_probe(9F) when called by a target driver during probe(9E) and attach(9E) to probe for a particular SCSI target on  the
       bus.  In  the  absence  of  an  HBA-specific   tran_tgt_probe()	function,  the default scsi_probe(9F) behavior is supplied by the function
       scsi_hba_probe(9F).

       The possible choices the HBA driver may make are:

	   o	  Initialize the tran_tgt_probe vector to point to scsi_hba_probe(9F), which results in the same behavior.

	   o	  Initialize the tran_tgt_probe vector to point to a private function in the HBA, which  may  call  scsi_hba_probe(9F)	before	or
		  after any necessary processing, as long as all the defined scsi_probe(9F) semantics are preserved.

       waitfunc indicates what tran_tgt_probe() should do when resources are not available:

       NULL_FUNC      Do not wait for resources.  See  scsi_probe(9F) for defined return values if no resources are available.

       SLEEP_FUNC     Wait indefinitely for resources.

SEE ALSO
       attach(9E), probe(9E), tran_tgt_free(9E), tran_tgt_init(9E), scsi_hba_probe(9F), scsi_probe(9F), scsi_device(9S), scsi_hba_tran(9S)

       Writing Device Drivers

SunOS 5.11							    1 Nov 1993							tran_tgt_probe(9E)