scsi_asc_key_strings(9s) [opensolaris man page]

scsi_asc_key_strings(9S)				    Data Structures for Drivers 				  scsi_asc_key_strings(9S)

NAME

       scsi_asc_key_strings - SCSI ASC ASCQ to message structure

SYNOPSIS

       #include <sys/scsi/scsi.h>

INTERFACE LEVEL

	Solaris DDI specific (Solaris DDI).

DESCRIPTION

       The scsi_asc_key_strings structure stores the ASC and ASCQ codes and a pointer to the related ASCII string.

STRUCTURE MEMBERS

	 ushort_t asc;		 /* ASC code */
	 ushort_t ascq; 	 /* ASCQ code */
	 char	 *message;	 /* ASCII message string */

	 asc		   Contains the ASC key code.

	 ascq		   Contains the ASCQ code.

	 message	   Points to the NULL terminated ASCII string
			   describing the asc and ascq condition

SEE ALSO

       scsi_vu_errmsg(9F)

       ANSI Small Computer System Interface-2 (SCSI-2)

       Writing Device Drivers

SunOS 5.11							    24 Feb 1998 					  scsi_asc_key_strings(9S)

scsi_sense_key(9F)					   Kernel Functions for Drivers 					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 qualifier (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() function returns the additional sense code qualifier (ASCQ) from the sense  buf-
       fer.

CONTEXT

       The scsi_sense_key(), scsi_sense_asc(), and scsi_sense_ascq() functions can be called from user or interrupt context.

SEE ALSO

       scsi_ext_sense_fields(9F),    scsi_find_sense_descr(9F),    scsi_sense_cmdspecific_uint64(9F),	 scsi_sense_info_uint64(9F),	scsi_vali-
       date_sense(9F)

SunOS 5.11							    28 Jun 2006 						scsi_sense_key(9F)