SCSI_SENSE_KEY(9F)SCSI_SENSE_KEY(9F)NAME
scsi_sense_key, scsi_sense_asc, scsi_sense_ascq - retrieve fields from
SCSI sense data
SYNOPSIS
#include <sys/scsi/scsi.h>
uint8_t scsi_sense_key(uint8_t *sense_buffer);
uint8_t scsi_sense_asc(uint8_t *sense_buffer);
uint8_t scsi_sense_ascq(uint8_t *sense_buffer);
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. It can be in either fixed or descriptor
format.
DESCRIPTION
The scsi_sense_key() function returns the sense key value from the
sense data contained in the sense_buffer.
The scsi_sense_asc() function returns the additional sense code (ASC)
value from the sense data contained in the sense_buffer.
The scsi_sense_ascq() function returns the additional sense code quali‐
fier (ASCQ) value from the sense data contained in the sense_buffer.
The scsi_sense_key(), scsi_sense_asc(), and scsi_sense_ascq() functions
are used to retrieve values from SCSI sense data, regardles of whether
the sense data is in fixed format or descriptor format.
Drivers should use scsi_validate_sense(9F) to ensure that valid sense
key, asc, and ascq values are present in the sense data.
RETURN VALUES
The scsi_sense_key() function returns the sense key value from the
sense buffer. The scsi_sense_asc() function returns the additional
sense code (ASC) from the sense buffer and the scsi_sense_ascq() func‐
tion returns the additional sense code qualifier (ASCQ) from the sense
buffer.
CONTEXT
The scsi_sense_key(), scsi_sense_asc(), and scsi_sense_ascq() functions
can be called from user or interrupt context.
SEE ALSOscsi_ext_sense_fields(9F), scsi_find_sense_descr(9F), scsi_sense_cmd‐
specific_uint64(9F), scsi_sense_info_uint64(9F), scsi_vali‐
date_sense(9F)
Jun 28, 2006 SCSI_SENSE_KEY(9F)
