Manual Pages for UNIX Operating System command usage for man tran_tgt_init

Driver Entry Points                             tran_tgt_init(9E)



NAME
     tran_tgt_init -  request  to  initialize  HBA  resources  on
     behalf of a particular target

SYNOPSIS
     #include 



     void prefixtran_tgt_init(dev_info_t *hba_dip, dev_info_t *tgt_dip,
          scsi_hba_tran_t *hba_tran, struct scsi_device *sd);


INTERFACE LEVEL
     Solaris architecture specific (Solaris DDI).

PARAMETERS
     hba_dip      Pointer to a  dev_info_t  structure,  referring
                  to the HBA device instance.


     tgt_dip      Pointer to a dev_info_t structure, referring to
                  the target device instance.


     hba_tran     Pointer to a  scsi_hba_tran(9S) structure, con-
                  sisting of the HBA's transport vectors.


     sd           Pointer  to   a    scsi_device(9S)   structure,
                  describing the target.


DESCRIPTION
     The tran_tgt_init() vector in the  scsi_hba_tran(9S)  struc-
     ture  may  be initialized during the HBA driver's attach(9E)
     to point to an HBA driver function to be called by the  sys-
     tem  when  an  instance of a target device is being created.
     The tran_tgt_init() vector, if not  NULL,is called after the
     dev_info  node  structure  is created for this target device
     instance, but before probe(9E) for this instance is  called.
     Before  receiving  transport requests from the target driver
     instance, the HBA may perform  any  initialization  required
     for   this   particular   target  during  the  call  of  the
     tran_tgt_init() vector.


     Note that hba_tran will  point  to  a  cloned  copy  of  the
     scsi_hba_tran_t structure allocated by the HBA driver if the
     SCSI_HBA_TRAN_CLONE  flag  was  specified  in  the  call  to
     scsi_hba_attach(9F). In this case, the HBA driver may choose
     to initialize the tran_tgt_private field  in  the  structure



SunOS 5.11           Last change: 1 Nov 1993                    1






Driver Entry Points                             tran_tgt_init(9E)



     pointed to by hba_tran, to point to the data specific to the
     particular target device instance.

RETURN VALUES
     tran_tgt_init() must return:

     DDI_SUCCESS     the HBA driver  can  support  the  addressed
                     target,  and  was  able  to  initialize per-
                     target resources.


     DDI_FAILURE     the HBA driver cannot support the  addressed
                     target,  or  was  unable  to initialize per-
                     target resources. In this  event,  the  ini-
                     tialization  of  this instance of the target
                     device will not  be  continued,  the  target
                     driver's  probe(9E)  will not be called, and
                     the tgt_dip structure destroyed.


SEE ALSO
     attach(9E),          probe(9E),           tran_tgt_free(9E),
     tran_tgt_probe(9E),               scsi_hba_attach_setup(9F),
     scsi_device(9S), scsi_hba_tran(9S)


     Writing Device Drivers




























SunOS 5.11           Last change: 1 Nov 1993                    2