1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2007 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _SYS_SCSI_IMPL_SENSE_H
#define _SYS_SCSI_IMPL_SENSE_H
#pragma ident "%Z%%M% %I% %E% SMI"
#ifdef __cplusplus
extern "C" {
#endif
/*
* Implementation Variant defines
* for SCSI Sense Information
*/
/*
* These are 'pseudo' sense keys for common Sun implementation driver
* detected errors. Note that they start out as being higher than the
* legal key numbers for standard SCSI.
*/
#define SUN_KEY_FATAL 0x10 /* driver, scsi handshake failure */
#define SUN_KEY_TIMEOUT 0x11 /* driver, command timeout */
#define SUN_KEY_EOF 0x12 /* driver, eof hit */
#define SUN_KEY_EOT 0x13 /* driver, eot hit */
#define SUN_KEY_LENGTH 0x14 /* driver, length error */
#define SUN_KEY_BOT 0x15 /* driver, bot hit */
#define SUN_KEY_WRONGMEDIA 0x16 /* driver, wrong tape media */
#define NUM_IMPL_SENSE_KEYS 7 /* seven extra keys */
/*
* Common sense length allocation sufficient for this implementation.
*/
#define SENSE_LENGTH \
(roundup(sizeof (struct scsi_extended_sense), sizeof (int)))
/*
* Per SPC-3 standard, the maximum length of sense data is 252 bytes.
*/
#define MAX_SENSE_LENGTH 252
/*
* Minimum useful Sense Length value
*/
#define SUN_MIN_SENSE_LENGTH 4
/*
* Specific variants to the Extended Sense structure.
*
* Defines for:
* Emulex MD21 SCSI/ESDI Controller
* Emulex MT02 SCSI/QIC-36 Controller.
*
* 1) The Emulex controllers put error class and error code into the byte
* right after the 'additional sense length' field in Extended Sense.
*
* 2) Except that some people state that this isn't so for the MD21- only
* the MT02.
*/
#define emulex_ercl_ercd es_cmd_info[0]
/*
* 2) These are valid on Extended Sense for the MD21, FORMAT command only:
*/
#define emulex_cyl_msb es_info_1
#define emulex_cyl_lsb es_info_2
#define emulex_head_num es_info_3
#define emulex_sect_num es_info_4
struct scsi_descr_template {
uchar_t sdt_descr_type;
uchar_t sdt_addl_length;
};
/*
* Function prototypes for descriptor-format sense data functions
*/
uint8_t *scsi_find_sense_descr(uint8_t *sense_buffer, int sense_buf_len,
int descr_type);
/*
* Function prototypes for format-neutral sense data functions
*/
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);
boolean_t scsi_sense_info_uint64(uint8_t *sense_buffer,
int sense_buf_len, uint64_t *information);
boolean_t scsi_sense_cmdspecific_uint64(uint8_t *sense_buffer,
int sense_buf_len, uint64_t *cmd_spec_info);
void scsi_ext_sense_fields(uint8_t *sense_buffer, int sense_buf_len,
uint8_t **information, uint8_t **cmd_spec_info, uint8_t **fru_code,
uint8_t **sk_specific, uint8_t **stream_flags);
int scsi_validate_sense(uint8_t *sense_buffer, int sense_buf_len, int *flags);
/*
* Return codes for scsi_validate_sense
*/
#define SENSE_UNUSABLE 0
#define SENSE_FIXED_FORMAT 1
#define SENSE_DESCR_FORMAT 2
/*
* Flags from scsi_validate_sense
*/
#define SNS_BUF_OVERFLOW 1 /* Sense buffer too small */
#define SNS_BUF_DEFERRED 2 /* Sense data is for prior operation */
#ifdef __cplusplus
}
#endif
#endif /* _SYS_SCSI_IMPL_SENSE_H */
|
