IMA_LuInquiry(3ima) 맨 페이지 - 윈디하나의 솔라나라

개요

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

IMA_LuInquiry(3ima)

IMA_LuInquiry(3IMA)          iSCSI Management API          IMA_LuInquiry(3IMA)



NAME
       IMA_LuInquiry  -  Gets  the specified SCSI INQUIRY data for a specified
       logical unit

SYNOPSIS
       cc [ flag... ] file... -lima [ library... ]
       #include <ima.h>

       IMA_STATUS IMA_LuInquiry(
           /* in */       IMA_OID deviceOid,
           /* in */       IMA_BOOL evpd,
           /* in */       IMA_BOOL cmddt,
           /* in */       IMA_BYTE pageCode,
           /* out */      IMA_BYTE *pOutputBuffer,
           /* in, out */ IMA_UINT *pOutputBufferLength,
           /* out */      IMA_BYTE *pSenseBuffer,
           /* in, out */ IMA_UINT *pSenseBufferLength
       );

PARAMETERS
       deviceOid              The object ID of the target or logical unit (LU)
                              whose  SCSI  INQUIRY data is to be retrieved. If
                              the object ID specifies a target, then the  com‐
                              mand will be sent to LUN 0 of the target.


       evpd                   A boolean indicating if the EVPD bit is set.


       cmddt                   A boolean indicating if the CMDDT bit is set.


       pageCode               The value to be placed in the page or the opera‐
                              tion code byte.


       pOutputBuffer          A pointer to the memory location, which, on suc‐
                              cessful completion contains the data returned by
                              the logical unit.


       pOutputBufferLength    On entry, this argument points to the length, in
                              bytes, of the memory area specified by the pOut‐
                              putBuffer argument.

                              If returned successfully, this  argument  points
                              to the number of bytes that were placed into the
                              output buffer.


       pSenseBuffer           A pointer to a memory location,  which,  if  the
                              SCSI  INQUIRY  command fails with a CHECK CONDI‐
                              TION status, contains the  sense  data  received
                              from the logical unit.

                              If this parameter is NULL, no sense data will be
                              transferred to the client if  the  SCSI  INQUIRY
                              command fails with a CHECK CONDITION status.


       pSenseBufferLength     A  pointer  to the sense buffer length. On entry
                              to the function, this argument points to a vari‐
                              able containing the maximum length, in bytes, of
                              the pSenseBuffer argument.

                              If    the     API     returns     the     value,
                              IMA_ERROR_SCSI_STATUS_CHECK_CONDITION,  then, on
                              exit, the pSenseBufferLength  argument  contains
                              the  number  of sense data bytes returned in the
                              pSenseBuffer argument.

                              If the pSenseBuffer argument is NULL,  then  the
                              pSenseBufferLength  argument  value is 0. If any
                              other value is returned by  the  API,  then,  on
                              exit this value remains the same as on entry.



DESCRIPTION
       The  IMA_LuInquiry()  API  gets  the  specified SCSI INQUIRY data for a
       specified logical unit.

RETURN VALUES
       IMA_ERROR_INVALID_PARAMETER


               o      Returned if the pOutputBuffer argument is NULL, or spec‐
                      ifies  a  memory  area  to which the pOutputBufferLength
                      argument bytes cannot be written.


               o      Returned if the pOutputBufferLength argument is 0.


               o      Returned if the pSenseBufferLength argument  is  greater
                      than zero and the pSenseBuffer argument specifies a mem‐
                      ory area to which the pSenseBufferLength argument  bytes
                      cannot be written.


               o      Returned  if  the  evpd  or  cmddt argument have a value
                      other than the value, IMA_TRUE or the value, IMA_FALSE.



       IMA_ERROR_INVALID_OBJECT_TYPE

           Returned if the deviceOid argument does not specify a valid  object
           type.


       IMA_ERROR_INCORRECT_OBJECT_TYPE

           Returned  if the deviceOid argument does not specify a target or LU
           object.


       IMA_ERROR_OBJECT_NOT_FOUND

           Returned if the deviceOid argument does not specify a target or  LU
           known to the system.


       IMA_ERROR_SCSI_STATUS_CHECK_CONDITION

           Returned  if the SCSI INQUIRY command failed with a CHECK CONDITION
           status. If this value is returned, and if the pSenseBuffer argument
           is not NULL, it will contain the sense data returned by the logical
           unit.


       IMA_ERROR_TARGET_TIMEOUT

           Returned if the target associated with the specified LU  failed  to
           respond to an iSCSI login request from an initiator.


       IMA_ERROR_LOGIN_REJECTED

           Returned if the target associated with the specified LU rejected an
           iSCSI login request from an initiator.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/library/storage/snia-ima _ Interface
       StabilityVolatile _ MT-LevelSafe


SEE ALSO
       libima(3LIB),   attributes(7),   IMA_LuReadCapacity(3IMA),    IMA_LuRe‐
       portLuns(3IMA)



Oracle Solaris 11.4              26 July 2016              IMA_LuInquiry(3IMA)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3