tran_tgt_init(9e) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

tran_tgt_init(9e)

tran_tgt_init(9E)             Driver Entry Points            tran_tgt_init(9E)

NAME
       tran_tgt_init - request to initialize HBA resources on behalf of a par‐
       ticular target

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

       int prefix_tran_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 de‐
                   vice 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, consisting of the
                   HBA's transport vectors.


       sd          Pointer to a scsi_device(9S) structure, describing the tar‐
                   get.


DESCRIPTION
       The tran_tgt_init() vector in the scsi_hba_tran(9S)  structure  may  be
       initialized  during the HBA driver's attach(9E) to point to an HBA dri‐
       ver function to be called by the system 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 de‐
       vice 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 dur‐
       ing 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 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 initialization 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 in Oracle Solaris 11.4

Oracle Solaris 11.4            9 September 2024              tran_tgt_init(9E)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3