Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ././../../../../../../usr/man/man3ima/IMA_LuInquiry.3ima
Real path: /usr/share/man/man3ima/IMA_LuInquiry.3ima
Zurück

'\" te
.\" Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
.TH IMA_LuInquiry 3IMA "26 July 2016" "Oracle Solaris 11.4" "iSCSI Management API"
.SH NAME
IMA_LuInquiry \- Gets the specified SCSI INQUIRY data for a specified logical unit
.SH SYNOPSIS

.LP
.nf
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
);
.fi
.SH PARAMETERS

.sp
.ne 2
.mk
.na
\fB\fIdeviceOid\fR\fR
.ad
.RS 23n
.rt
The object ID of the target or logical unit (LU) whose \fBSCSI INQUIRY\fR data is to be retrieved. If the object ID specifies a target, then the command will be sent to \fBLUN 0\fR of the target. 
.RE

.sp
.ne 2
.mk
.na
\fB\fIevpd\fR\fR
.ad
.RS 23n
.rt
A boolean indicating if the \fBEVPD\fR bit is set.
.RE

.sp
.ne 2
.mk
.na
\fB\fIcmddt\fR\fR
.ad
.RS 23n
.rt
 A boolean indicating if the \fBCMDDT\fR bit is set.
.RE

.sp
.ne 2
.mk
.na
\fB\fIpageCode\fR\fR
.ad
.RS 23n
.rt
The value to be placed in the page or the operation code byte.
.RE

.sp
.ne 2
.mk
.na
\fB\fIpOutputBuffer\fR\fR
.ad
.RS 23n
.rt
A pointer to the memory location, which, on successful completion contains the data returned by the logical unit.
.RE

.sp
.ne 2
.mk
.na
\fB\fIpOutputBufferLength\fR\fR
.ad
.RS 23n
.rt
On entry, this argument points to the length, in bytes, of the memory area specified by the \fIpOutputBuffer\fR argument.
.sp
If returned successfully, this argument points to the number of bytes that were placed into the output buffer.
.RE

.sp
.ne 2
.mk
.na
\fB\fIpSenseBuffer\fR\fR
.ad
.RS 23n
.rt
A pointer to a memory location, which, if the \fBSCSI INQUIRY\fR command fails with a \fBCHECK CONDITION\fR status, contains the sense data received from the logical unit. 
.sp
If this parameter is \fBNULL\fR, no sense data will be transferred to the client if the \fBSCSI INQUIRY\fR command fails with a \fBCHECK CONDITION\fR status.
.RE

.sp
.ne 2
.mk
.na
\fB\fIpSenseBufferLength\fR\fR
.ad
.RS 23n
.rt
A pointer to the sense buffer length. On entry to the function, this argument points to a variable containing the maximum length, in bytes, of the \fIpSenseBuffer\fR argument. 
.sp
If the API returns the value, \fBIMA_ERROR_SCSI_STATUS_CHECK_CONDITION\fR, then, on exit, the \fIpSenseBufferLength\fR argument contains the number of sense data bytes returned in the \fIpSenseBuffer\fR argument. 
.sp
If the \fIpSenseBuffer\fR argument is \fBNULL\fR, then the \fIpSenseBufferLength\fR argument value is 0. If any other value is returned by the API, then, on exit this value remains the same as on entry.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBIMA_LuInquiry()\fR API gets the specified \fBSCSI INQUIRY\fR data for a specified logical unit.
.SH RETURN VALUES

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INVALID_PARAMETER\fR\fR
.ad
.br
.sp .6
.RS 4n
.RS +4
.TP
.ie t \(bu
.el o
Returned if the \fIpOutputBuffer\fR argument is \fBNULL\fR, or specifies a memory area to which the \fIpOutputBufferLength\fR argument bytes cannot be written.

.RE
.RS +4
.TP
.ie t \(bu
.el o
Returned if the \fIpOutputBufferLength\fR argument is 0.

.RE
.RS +4
.TP
.ie t \(bu
.el o
Returned if the \fIpSenseBufferLength\fR argument is greater than zero and the \fIpSenseBuffer\fR argument specifies a memory area to which the \fIpSenseBufferLength\fR argument bytes cannot be written.

.RE
.RS +4
.TP
.ie t \(bu
.el o
Returned if the \fIevpd\fR or \fIcmddt\fR argument have a value other than the value, \fBIMA_TRUE\fR or the value, \fBIMA_FALSE\fR.

.RE
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INVALID_OBJECT_TYPE\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fIdeviceOid\fR argument does not specify a valid object type.
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INCORRECT_OBJECT_TYPE\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fIdeviceOid\fR argument does not specify a target or LU object. 
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_OBJECT_NOT_FOUND\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fIdeviceOid\fR argument does not specify a target or LU known to the system.
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_SCSI_STATUS_CHECK_CONDITION\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fBSCSI INQUIRY\fR command failed with a \fBCHECK CONDITION\fR status. If this value is returned, and if the \fIpSenseBuffer\fR argument is not \fBNULL\fR, it will contain the sense data returned by the logical unit.
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_TARGET_TIMEOUT\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the target associated with the specified LU failed to respond to an iSCSI login request from an initiator.
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_LOGIN_REJECTED\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the target associated with the specified LU rejected an iSCSI login request from an initiator.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Availability
\fBsystem/library/storage/snia-ima\fR
_
Interface Stability
Volatile
_
MT-Level
Safe
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBlibima\fR(3LIB), \fBattributes\fR(7), \fBIMA_LuReadCapacity\fR(3IMA), \fBIMA_LuReportLuns\fR(3IMA)