SCSI_VALIDATE_SENSE(9F)SCSI_VALIDATE_SENSE(9F)NAME
scsi_validate_sense - find descriptor in SCSI sense data
SYNOPSIS
#include <sys/scsi/scsi.h>
int scsi_validate_sense(uint8_t *sense_buffer, int sense_buf_len,
int *flags);
INTERFACE LEVEL
Solaris DDI specific (Solaris DDI).
PARAMETERS
sense_buffer
Pointer to a buffer containing SCSI sense data. The
sense data is expected in wire format starting at the
response code.
sense_buf_len
Length of sense buffer in bytes.
flags
Returns additional properties of the sense data.
DESCRIPTION
The scsi_validate_sense() function returns the format of the sense data
contained in the provided sense buffer. If the response code field in
the sense data is not recognized or if there is not enough sense data
to include sense key, asc, and ascq then scsi_validate_sense() returns
SENSE_UNUSABLE. If the buffer contains usable sense data in fixed for‐
mat, the function returns SENSE_FIXED_FORMAT. If the buffer contains
usable sense data in descriptor format, the function returns
SENSE_DESCR_FORMAT.
The following flags may be set as appropriate depending on the sense
data:
SNS_BUF_OVERFLOW
The sense data buffer provided for the request is
too small to hold all the sense data.
SNS_BUF_DEFERRED
The sense data contained in the buffer relates to
an error that has occurred during the processing of
a successfully completed command, such as a cached
write that could not be commited to the media.
RETURN VALUES
SENSE_UNUSABLE
The response code from the sense data is unrecog‐
nized or not enough sense data present to provide
the sense key, asc, and ascq.
SENSE_FIXED_FORMAT
The sense data in the buffer is in "fixed for‐
mat".
SENSE_DESCR_FORMAT
The sense data in the buffer is in "descriptor
format".
CONTEXT
The scsi_validate_sense() function can be called from user or interrupt
context.
SEE ALSOscsi_ext_sense_fields(9F), scsi_find_sense_descr(9F),
scsi_sense_asc(9F), scsi_sense_ascq(9F), scsi_sense_cmdspe‐
cific_uint64(9F), scsi_sense_info_uint64(9F), scsi_sense_key(9F)
Jun 29, 2006 SCSI_VALIDATE_SENSE(9F)