]>
Commit | Line | Data |
---|---|---|
832b75ed GG |
1 | /* |
2 | * scsicmds.h | |
3 | * | |
4 | * Home page of code is: http://smartmontools.sourceforge.net | |
5 | * | |
6 | * Copyright (C) 2002-6 Bruce Allen <smartmontools-support@lists.sourceforge.net> | |
7 | * Copyright (C) 2000 Michael Cornwell <cornwell@acm.org> | |
8 | * | |
9 | * Additional SCSI work: | |
10 | * Copyright (C) 2003-6 Douglas Gilbert <dougg@torque.net> | |
11 | * | |
12 | * This program is free software; you can redistribute it and/or modify | |
13 | * it under the terms of the GNU General Public License as published by | |
14 | * the Free Software Foundation; either version 2, or (at your option) | |
15 | * any later version. | |
16 | * | |
17 | * You should have received a copy of the GNU General Public License | |
18 | * (for example COPYING); if not, write to the Free | |
19 | * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | |
20 | * | |
21 | * This code was originally developed as a Senior Thesis by Michael Cornwell | |
22 | * at the Concurrent Systems Laboratory (now part of the Storage Systems | |
23 | * Research Center), Jack Baskin School of Engineering, University of | |
24 | * California, Santa Cruz. http://ssrc.soe.ucsc.edu/ | |
25 | * | |
26 | * N.B. What was formerly known as "SMART" are now called "informational | |
27 | * exceptions" in recent t10.org drafts (i.e. recent SCSI). | |
28 | * | |
29 | */ | |
30 | ||
31 | ||
32 | #ifndef SCSICMDS_H_ | |
33 | #define SCSICMDS_H_ | |
34 | ||
a37e7145 | 35 | #define SCSICMDS_H_CVSID "$Id: scsicmds.h,v 1.65 2007/03/23 03:45:34 dpgilbert Exp $\n" |
832b75ed GG |
36 | |
37 | #include <stdio.h> | |
38 | #include <stdlib.h> | |
39 | #include <string.h> | |
40 | #include <errno.h> | |
41 | ||
42 | /* #define SCSI_DEBUG 1 */ /* Comment out to disable command debugging */ | |
43 | ||
44 | /* Following conditional defines bypass inclusion of scsi/scsi.h and | |
45 | * scsi/scsi_ioctl.h . Issue will be resolved later ... */ | |
46 | #ifndef TEST_UNIT_READY | |
47 | #define TEST_UNIT_READY 0x0 | |
48 | #endif | |
49 | #ifndef LOG_SENSE | |
50 | #define LOG_SENSE 0x4d | |
51 | #endif | |
52 | #ifndef MODE_SENSE | |
53 | #define MODE_SENSE 0x1a | |
54 | #endif | |
55 | #ifndef MODE_SENSE_10 | |
56 | #define MODE_SENSE_10 0x5a | |
57 | #endif | |
58 | #ifndef MODE_SELECT | |
59 | #define MODE_SELECT 0x15 | |
60 | #endif | |
61 | #ifndef MODE_SELECT_10 | |
62 | #define MODE_SELECT_10 0x55 | |
63 | #endif | |
64 | #ifndef INQUIRY | |
65 | #define INQUIRY 0x12 | |
66 | #endif | |
67 | #ifndef REQUEST_SENSE | |
68 | #define REQUEST_SENSE 0x03 | |
69 | #endif | |
70 | #ifndef RECEIVE_DIAGNOSTIC | |
71 | #define RECEIVE_DIAGNOSTIC 0x1c | |
72 | #endif | |
73 | #ifndef SEND_DIAGNOSTIC | |
74 | #define SEND_DIAGNOSTIC 0x1d | |
75 | #endif | |
76 | #ifndef READ_DEFECT_10 | |
77 | #define READ_DEFECT_10 0x37 | |
78 | #endif | |
79 | ||
4d59bff9 GG |
80 | #ifndef SAT_ATA_PASSTHROUGH_12 |
81 | #define SAT_ATA_PASSTHROUGH_12 0xa1 | |
82 | #endif | |
83 | #ifndef SAT_ATA_PASSTHROUGH_16 | |
84 | #define SAT_ATA_PASSTHROUGH_16 0x85 | |
85 | #endif | |
86 | ||
832b75ed | 87 | typedef unsigned char UINT8; |
a37e7145 | 88 | typedef signed char INT8; |
832b75ed GG |
89 | typedef unsigned int UINT32; |
90 | typedef int INT32; | |
91 | ||
92 | #define DXFER_NONE 0 | |
93 | #define DXFER_FROM_DEVICE 1 | |
94 | #define DXFER_TO_DEVICE 2 | |
95 | ||
96 | struct scsi_cmnd_io | |
97 | { | |
98 | UINT8 * cmnd; /* [in]: ptr to SCSI command block (cdb) */ | |
99 | size_t cmnd_len; /* [in]: number of bytes in SCSI command */ | |
100 | int dxfer_dir; /* [in]: DXFER_NONE, DXFER_FROM_DEVICE, or | |
101 | DXFER_TO_DEVICE */ | |
102 | UINT8 * dxferp; /* [in]: ptr to outgoing or incoming data buffer */ | |
103 | size_t dxfer_len; /* [in]: bytes to be transferred to/from dxferp */ | |
104 | UINT8 * sensep; /* [in]: ptr to sense buffer, filled when | |
105 | CHECK CONDITION status occurs */ | |
106 | size_t max_sense_len; /* [in]: max number of bytes to write to sensep */ | |
107 | unsigned timeout; /* [in]: seconds, 0-> default timeout (60 seconds?) */ | |
108 | size_t resp_sense_len; /* [out]: sense buffer length written */ | |
109 | UINT8 scsi_status; /* [out]: 0->ok, 2->CHECK CONDITION, etc ... */ | |
110 | int resid; /* [out]: Number of bytes requested to be transferred | |
111 | less actual number transferred (0 if not | |
112 | supported) */ | |
113 | }; | |
114 | ||
115 | struct scsi_sense_disect { | |
116 | UINT8 error_code; | |
117 | UINT8 sense_key; | |
118 | UINT8 asc; | |
119 | UINT8 ascq; | |
120 | }; | |
121 | ||
122 | /* Useful data from Informational Exception Control mode page (0x1c) */ | |
123 | #define SCSI_IECMP_RAW_LEN 64 | |
124 | struct scsi_iec_mode_page { | |
125 | UINT8 requestedCurrent; | |
126 | UINT8 gotCurrent; | |
127 | UINT8 requestedChangeable; | |
128 | UINT8 gotChangeable; | |
129 | UINT8 modese_len; /* 0 (don't know), 6 or 10 */ | |
130 | UINT8 raw_curr[SCSI_IECMP_RAW_LEN]; | |
131 | UINT8 raw_chg[SCSI_IECMP_RAW_LEN]; | |
132 | }; | |
133 | ||
134 | /* Carrier for Error counter log pages (e.g. read, write, verify ...) */ | |
135 | struct scsiErrorCounter { | |
136 | UINT8 gotPC[7]; | |
137 | UINT8 gotExtraPC; | |
138 | uint64_t counter[8]; | |
139 | }; | |
140 | ||
141 | /* Carrier for Non-medium error log page */ | |
142 | struct scsiNonMediumError { | |
143 | UINT8 gotPC0; | |
144 | UINT8 gotExtraPC; | |
145 | uint64_t counterPC0; | |
146 | UINT8 gotTFE_H; | |
147 | uint64_t counterTFE_H; /* Track following errors [Hitachi] */ | |
148 | UINT8 gotPE_H; | |
149 | uint64_t counterPE_H; /* Positioning errors [Hitachi] */ | |
150 | }; | |
151 | ||
152 | /* SCSI Peripheral types (of interest) */ | |
153 | #define SCSI_PT_DIRECT_ACCESS 0x0 | |
154 | #define SCSI_PT_SEQUENTIAL_ACCESS 0x1 | |
155 | #define SCSI_PT_CDROM 0x5 | |
156 | #define SCSI_PT_MEDIUM_CHANGER 0x8 | |
157 | #define SCSI_PT_ENCLOSURE 0xd | |
158 | ||
159 | /* ANSI SCSI-3 Log Pages retrieved by LOG SENSE. */ | |
160 | #define SUPPORTED_LPAGES 0x00 | |
161 | #define BUFFER_OVERRUN_LPAGE 0x01 | |
162 | #define WRITE_ERROR_COUNTER_LPAGE 0x02 | |
163 | #define READ_ERROR_COUNTER_LPAGE 0x03 | |
164 | #define READ_REVERSE_ERROR_COUNTER_LPAGE 0x04 | |
165 | #define VERIFY_ERROR_COUNTER_LPAGE 0x05 | |
166 | #define NON_MEDIUM_ERROR_LPAGE 0x06 | |
167 | #define LAST_N_ERROR_LPAGE 0x07 | |
168 | #define FORMAT_STATUS_LPAGE 0x08 | |
169 | #define TEMPERATURE_LPAGE 0x0d | |
170 | #define STARTSTOP_CYCLE_COUNTER_LPAGE 0x0e | |
171 | #define APPLICATION_CLIENT_LPAGE 0x0f | |
172 | #define SELFTEST_RESULTS_LPAGE 0x10 | |
4d59bff9 | 173 | #define BACKGROUND_RESULTS_LPAGE 0x15 /* SBC-3 */ |
832b75ed GG |
174 | #define IE_LPAGE 0x2f |
175 | ||
176 | /* Seagate vendor specific log pages. */ | |
177 | #define SEAGATE_CACHE_LPAGE 0x37 | |
178 | #define SEAGATE_FACTORY_LPAGE 0x3e | |
179 | ||
180 | /* Log page response lengths */ | |
181 | #define LOG_RESP_SELF_TEST_LEN 0x194 | |
182 | ||
183 | /* See the SSC-2 document at www.t10.org . Earler note: From IBM | |
184 | Documentation, see http://www.storage.ibm.com/techsup/hddtech/prodspecs.htm */ | |
185 | #define TAPE_ALERTS_LPAGE 0x2e | |
186 | ||
187 | /* ANSI SCSI-3 Mode Pages */ | |
188 | #define VENDOR_UNIQUE_PAGE 0x00 | |
189 | #define READ_WRITE_ERROR_RECOVERY_PAGE 0x01 | |
190 | #define DISCONNECT_RECONNECT_PAGE 0x02 | |
191 | #define FORMAT_DEVICE_PAGE 0x03 | |
192 | #define RIGID_DISK_DRIVE_GEOMETRY_PAGE 0x04 | |
193 | #define FLEXIBLE_DISK_PAGE 0x05 | |
194 | #define VERIFY_ERROR_RECOVERY_PAGE 0x07 | |
195 | #define CACHING_PAGE 0x08 | |
196 | #define PERIPHERAL_DEVICE_PAGE 0x09 | |
197 | #define XOR_CONTROL_MODE_PAGE 0x10 | |
198 | #define CONTROL_MODE_PAGE 0x0a | |
199 | #define MEDIUM_TYPES_SUPPORTED_PAGE 0x0b | |
200 | #define NOTCH_PAGE 0x0c | |
201 | #define CD_DEVICE_PAGE 0x0d | |
202 | #define CD_AUDIO_CONTROL_PAGE 0x0e | |
203 | #define DATA_COMPRESSION_PAGE 0x0f | |
204 | #define ENCLOSURE_SERVICES_MANAGEMENT_PAGE 0x14 | |
205 | #define PROTOCOL_SPECIFIC_LUN_PAGE 0x18 | |
206 | #define PROTOCOL_SPECIFIC_PORT_PAGE 0x19 | |
207 | #define POWER_CONDITION_PAGE 0x1a | |
208 | #define INFORMATIONAL_EXCEPTIONS_CONTROL_PAGE 0x1c | |
209 | #define FAULT_FAILURE_REPORTING_PAGE 0x1c | |
210 | ||
4d59bff9 GG |
211 | /* Background control mode subpage is [0x1c,0x1] */ |
212 | #define BACKGROUND_CONTROL_M_SUBPAGE 0x1 /* SBC-2 */ | |
213 | ||
832b75ed GG |
214 | #define ALL_MODE_PAGES 0x3f |
215 | ||
216 | /* Mode page control field */ | |
217 | #define MPAGE_CONTROL_CURRENT 0 | |
218 | #define MPAGE_CONTROL_CHANGEABLE 1 | |
219 | #define MPAGE_CONTROL_DEFAULT 2 | |
220 | #define MPAGE_CONTROL_SAVED 3 | |
221 | ||
222 | /* defines for useful SCSI Status codes */ | |
223 | #define SCSI_STATUS_CHECK_CONDITION 0x2 | |
224 | ||
225 | /* defines for useful Sense Key codes */ | |
4d59bff9 GG |
226 | #define SCSI_SK_NO_SENSE 0x0 |
227 | #define SCSI_SK_RECOVERED_ERR 0x1 | |
832b75ed GG |
228 | #define SCSI_SK_NOT_READY 0x2 |
229 | #define SCSI_SK_MEDIUM_ERROR 0x3 | |
230 | #define SCSI_SK_HARDWARE_ERROR 0x4 | |
231 | #define SCSI_SK_ILLEGAL_REQUEST 0x5 | |
232 | #define SCSI_SK_UNIT_ATTENTION 0x6 | |
a37e7145 | 233 | #define SCSI_SK_ABORTED_COMMAND 0xb |
832b75ed GG |
234 | |
235 | /* defines for useful Additional Sense Codes (ASCs) */ | |
236 | #define SCSI_ASC_NOT_READY 0x4 /* more info in ASCQ code */ | |
237 | #define SCSI_ASC_NO_MEDIUM 0x3a /* more info in ASCQ code */ | |
238 | #define SCSI_ASC_UNKNOWN_OPCODE 0x20 | |
239 | #define SCSI_ASC_UNKNOWN_FIELD 0x24 | |
240 | #define SCSI_ASC_UNKNOWN_PARAM 0x26 | |
241 | #define SCSI_ASC_WARNING 0xb | |
242 | #define SCSI_ASC_IMPENDING_FAILURE 0x5d | |
243 | ||
4d59bff9 GG |
244 | #define SCSI_ASCQ_ATA_PASS_THROUGH 0x1d |
245 | ||
832b75ed GG |
246 | /* Simplified error code (negative values as per errno) */ |
247 | #define SIMPLE_NO_ERROR 0 | |
248 | #define SIMPLE_ERR_NOT_READY 1 | |
249 | #define SIMPLE_ERR_BAD_OPCODE 2 | |
250 | #define SIMPLE_ERR_BAD_FIELD 3 /* in cbd */ | |
251 | #define SIMPLE_ERR_BAD_PARAM 4 /* in data */ | |
252 | #define SIMPLE_ERR_BAD_RESP 5 /* response fails sanity */ | |
253 | #define SIMPLE_ERR_NO_MEDIUM 6 /* no medium present */ | |
254 | #define SIMPLE_ERR_BECOMING_READY 7 /* device will be ready soon */ | |
255 | #define SIMPLE_ERR_TRY_AGAIN 8 /* some warning, try again */ | |
256 | #define SIMPLE_ERR_MEDIUM_HARDWARE 9 /* medium or hardware error */ | |
a37e7145 GG |
257 | #define SIMPLE_ERR_UNKNOWN 10 /* unknown sense value */ |
258 | #define SIMPLE_ERR_ABORTED_COMMAND 11 /* most likely transport error */ | |
832b75ed GG |
259 | |
260 | ||
261 | /* defines for functioncode parameter in SENDDIAGNOSTIC function */ | |
262 | #define SCSI_DIAG_NO_SELF_TEST 0x00 | |
263 | #define SCSI_DIAG_DEF_SELF_TEST 0xff | |
264 | #define SCSI_DIAG_BG_SHORT_SELF_TEST 0x01 | |
265 | #define SCSI_DIAG_BG_EXTENDED_SELF_TEST 0x02 | |
266 | #define SCSI_DIAG_FG_SHORT_SELF_TEST 0x05 | |
267 | #define SCSI_DIAG_FG_EXTENDED_SELF_TEST 0x06 | |
268 | #define SCSI_DIAG_ABORT_SELF_TEST 0x04 | |
269 | ||
270 | ||
271 | /* SCSI command timeout values (units are seconds) */ | |
272 | #define SCSI_TIMEOUT_DEFAULT 6 /* 6 seconds should be ample */ | |
273 | #define SCSI_TIMEOUT_SELF_TEST (5 * 60 * 60) /* allow max 5 hours for */ | |
274 | /* extended foreground self test */ | |
275 | ||
276 | ||
277 | ||
278 | #define LOGPAGEHDRSIZE 4 | |
279 | ||
280 | void scsi_do_sense_disect(const struct scsi_cmnd_io * in, | |
281 | struct scsi_sense_disect * out); | |
282 | ||
4d59bff9 GG |
283 | int scsiSimpleSenseFilter(const struct scsi_sense_disect * sinfo); |
284 | ||
832b75ed GG |
285 | const char * scsiErrString(int scsiErr); |
286 | ||
287 | /* STANDARD SCSI Commands */ | |
288 | int scsiTestUnitReady(int device); | |
289 | ||
290 | int scsiStdInquiry(int device, UINT8 *pBuf, int bufLen); | |
291 | ||
292 | int scsiInquiryVpd(int device, int vpd_page, UINT8 *pBuf, int bufLen); | |
293 | ||
4d59bff9 GG |
294 | int scsiLogSense(int device, int pagenum, int subpagenum, UINT8 *pBuf, |
295 | int bufLen, int known_resp_len); | |
832b75ed | 296 | |
4d59bff9 GG |
297 | int scsiModeSense(int device, int pagenum, int subpagenum, int pc, |
298 | UINT8 *pBuf, int bufLen); | |
832b75ed GG |
299 | |
300 | int scsiModeSelect(int device, int sp, UINT8 *pBuf, int bufLen); | |
301 | ||
4d59bff9 GG |
302 | int scsiModeSense10(int device, int pagenum, int subpagenum, int pc, |
303 | UINT8 *pBuf, int bufLen); | |
832b75ed GG |
304 | |
305 | int scsiModeSelect10(int device, int sp, UINT8 *pBuf, int bufLen); | |
306 | ||
307 | int scsiModePageOffset(const UINT8 * resp, int len, int modese_len); | |
308 | ||
309 | int scsiRequestSense(int device, struct scsi_sense_disect * sense_info); | |
310 | ||
311 | int scsiSendDiagnostic(int device, int functioncode, UINT8 *pBuf, int bufLen); | |
312 | ||
313 | int scsiReceiveDiagnostic(int device, int pcv, int pagenum, UINT8 *pBuf, | |
314 | int bufLen); | |
315 | ||
316 | int scsiReadDefect10(int device, int req_plist, int req_glist, int dl_format, | |
317 | UINT8 *pBuf, int bufLen); | |
318 | ||
319 | /* SMART specific commands */ | |
320 | int scsiCheckIE(int device, int hasIELogPage, int hasTempLogPage, UINT8 *asc, | |
321 | UINT8 *ascq, UINT8 *currenttemp, UINT8 *triptemp); | |
322 | ||
323 | int scsiFetchIECmpage(int device, struct scsi_iec_mode_page *iecp, | |
324 | int modese_len); | |
325 | int scsi_IsExceptionControlEnabled(const struct scsi_iec_mode_page *iecp); | |
326 | int scsi_IsWarningEnabled(const struct scsi_iec_mode_page *iecp); | |
327 | int scsiSetExceptionControlAndWarning(int device, int enabled, | |
328 | const struct scsi_iec_mode_page *iecp); | |
329 | void scsiDecodeErrCounterPage(unsigned char * resp, | |
330 | struct scsiErrorCounter *ecp); | |
331 | void scsiDecodeNonMediumErrPage(unsigned char * resp, | |
332 | struct scsiNonMediumError *nmep); | |
333 | int scsiFetchExtendedSelfTestTime(int device, int * durationSec, | |
334 | int modese_len); | |
335 | int scsiCountFailedSelfTests(int fd, int noisy); | |
336 | int scsiSelfTestInProgress(int fd, int * inProgress); | |
337 | int scsiFetchControlGLTSD(int device, int modese_len, int current); | |
338 | int scsiSetControlGLTSD(int device, int enabled, int modese_len); | |
339 | int scsiFetchTransportProtocol(int device, int modese_len); | |
340 | ||
341 | /* T10 Standard IE Additional Sense Code strings taken from t10.org */ | |
342 | ||
343 | const char* scsiGetIEString(UINT8 asc, UINT8 ascq); | |
344 | int scsiGetTemp(int device, UINT8 *currenttemp, UINT8 *triptemp); | |
345 | ||
346 | ||
347 | int scsiSmartIBMOfflineTest(int device); | |
348 | ||
349 | int scsiSmartDefaultSelfTest(int device); | |
350 | int scsiSmartShortSelfTest(int device); | |
351 | int scsiSmartExtendSelfTest(int device); | |
352 | int scsiSmartShortCapSelfTest(int device); | |
353 | int scsiSmartExtendCapSelfTest(int device); | |
354 | int scsiSmartSelfTestAbort(int device); | |
355 | ||
356 | const char * scsiTapeAlertsTapeDevice(unsigned short code); | |
357 | const char * scsiTapeAlertsChangerDevice(unsigned short code); | |
358 | ||
359 | const char * scsi_get_opcode_name(UINT8 opcode); | |
360 | void dStrHex(const char* str, int len, int no_ascii); | |
4d59bff9 GG |
361 | inline void dStrHex(const unsigned char* str, int len, int no_ascii) |
362 | { dStrHex((const char *)str, len, no_ascii); } | |
363 | ||
832b75ed GG |
364 | |
365 | /* SCSI command transmission interface function declaration. Its | |
366 | * definition is target OS specific (see os_<OS>.c file). | |
367 | * Returns 0 if SCSI command successfully launched and response | |
368 | * received. Even when 0 is returned the caller should check | |
369 | * scsi_cmnd_io::scsi_status for SCSI defined errors and warnings | |
370 | * (e.g. CHECK CONDITION). If the SCSI command could not be issued | |
371 | * (e.g. device not present or not a SCSI device) or some other problem | |
372 | * arises (e.g. timeout) then returns a negative errno value. */ | |
373 | int do_scsi_cmnd_io(int dev_fd, struct scsi_cmnd_io * iop, int report); | |
374 | ||
375 | ||
832b75ed GG |
376 | #endif |
377 |