[mirror_smartmontools-debian.git] / scsicmds.h

/*
 * scsicmds.h
 *
 * Home page of code is: http://smartmontools.sourceforge.net
 *
 * Copyright (C) 2002-6 Bruce Allen <smartmontools-support@lists.sourceforge.net>
 * Copyright (C) 2000 Michael Cornwell <cornwell@acm.org>
 *
 * Additional SCSI work:
 * Copyright (C) 2003-6 Douglas Gilbert <dougg@torque.net>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * You should have received a copy of the GNU General Public License
 * (for example COPYING); if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 *
 * This code was originally developed as a Senior Thesis by Michael Cornwell
 * at the Concurrent Systems Laboratory (now part of the Storage Systems
 * Research Center), Jack Baskin School of Engineering, University of
 * California, Santa Cruz. http://ssrc.soe.ucsc.edu/
 *
 * N.B. What was formerly known as "SMART" are now called "informational
 * exceptions" in recent t10.org drafts (i.e. recent SCSI).
 *
 */


#ifndef SCSICMDS_H_
#define SCSICMDS_H_

#define SCSICMDS_H_CVSID "$Id: scsicmds.h,v 1.57 2006/04/12 14:54:28 ballen4705 Exp $\n"

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>

/* #define SCSI_DEBUG 1 */ /* Comment out to disable command debugging */

/* Following conditional defines bypass inclusion of scsi/scsi.h and
 * scsi/scsi_ioctl.h . Issue will be resolved later ... */
#ifndef TEST_UNIT_READY
#define TEST_UNIT_READY 0x0
#endif
#ifndef LOG_SENSE
#define LOG_SENSE 0x4d
#endif
#ifndef MODE_SENSE
#define MODE_SENSE 0x1a
#endif
#ifndef MODE_SENSE_10
#define MODE_SENSE_10 0x5a
#endif
#ifndef MODE_SELECT
#define MODE_SELECT 0x15
#endif
#ifndef MODE_SELECT_10
#define MODE_SELECT_10 0x55
#endif
#ifndef INQUIRY
#define INQUIRY 0x12
#endif
#ifndef REQUEST_SENSE
#define REQUEST_SENSE  0x03
#endif
#ifndef RECEIVE_DIAGNOSTIC
#define RECEIVE_DIAGNOSTIC  0x1c
#endif
#ifndef SEND_DIAGNOSTIC
#define SEND_DIAGNOSTIC  0x1d
#endif
#ifndef READ_DEFECT_10
#define READ_DEFECT_10  0x37
#endif

typedef unsigned char UINT8;
typedef char INT8;
typedef unsigned int UINT32;
typedef int INT32;

#define DXFER_NONE        0
#define DXFER_FROM_DEVICE 1
#define DXFER_TO_DEVICE   2

struct scsi_cmnd_io
{
    UINT8 * cmnd;       /* [in]: ptr to SCSI command block (cdb) */
    size_t  cmnd_len;   /* [in]: number of bytes in SCSI command */
    int dxfer_dir;      /* [in]: DXFER_NONE, DXFER_FROM_DEVICE, or 
                                 DXFER_TO_DEVICE */
    UINT8 * dxferp;     /* [in]: ptr to outgoing or incoming data buffer */
    size_t dxfer_len;   /* [in]: bytes to be transferred to/from dxferp */
    UINT8 * sensep;     /* [in]: ptr to sense buffer, filled when 
                                 CHECK CONDITION status occurs */
    size_t max_sense_len; /* [in]: max number of bytes to write to sensep */
    unsigned timeout;   /* [in]: seconds, 0-> default timeout (60 seconds?) */
    size_t resp_sense_len;  /* [out]: sense buffer length written */
    UINT8 scsi_status;  /* [out]: 0->ok, 2->CHECK CONDITION, etc ... */
    int resid;          /* [out]: Number of bytes requested to be transferred
                                  less actual number transferred (0 if not
                                   supported) */
};

struct scsi_sense_disect {
    UINT8 error_code;
    UINT8 sense_key;
    UINT8 asc; 
    UINT8 ascq;
};

/* Useful data from Informational Exception Control mode page (0x1c) */
#define SCSI_IECMP_RAW_LEN 64
struct scsi_iec_mode_page {
    UINT8 requestedCurrent;
    UINT8 gotCurrent;
    UINT8 requestedChangeable;
    UINT8 gotChangeable;
    UINT8 modese_len;   /* 0 (don't know), 6 or 10 */
    UINT8 raw_curr[SCSI_IECMP_RAW_LEN];
    UINT8 raw_chg[SCSI_IECMP_RAW_LEN];
};

/* Carrier for Error counter log pages (e.g. read, write, verify ...) */
struct scsiErrorCounter {
    UINT8 gotPC[7];
    UINT8 gotExtraPC;
    uint64_t counter[8];
};

/* Carrier for Non-medium error log page */
struct scsiNonMediumError {
    UINT8 gotPC0;
    UINT8 gotExtraPC;
    uint64_t counterPC0;
    UINT8 gotTFE_H;
    uint64_t counterTFE_H; /* Track following errors [Hitachi] */
    UINT8 gotPE_H;
    uint64_t counterPE_H;  /* Positioning errors [Hitachi] */
};

/* SCSI Peripheral types (of interest) */
#define SCSI_PT_DIRECT_ACCESS           0x0
#define SCSI_PT_SEQUENTIAL_ACCESS       0x1
#define SCSI_PT_CDROM                   0x5
#define SCSI_PT_MEDIUM_CHANGER          0x8
#define SCSI_PT_ENCLOSURE               0xd

/* ANSI SCSI-3 Log Pages retrieved by LOG SENSE. */
#define SUPPORTED_LPAGES                        0x00
#define BUFFER_OVERRUN_LPAGE                    0x01
#define WRITE_ERROR_COUNTER_LPAGE               0x02
#define READ_ERROR_COUNTER_LPAGE                0x03
#define READ_REVERSE_ERROR_COUNTER_LPAGE        0x04
#define VERIFY_ERROR_COUNTER_LPAGE              0x05
#define NON_MEDIUM_ERROR_LPAGE                  0x06
#define LAST_N_ERROR_LPAGE                      0x07
#define FORMAT_STATUS_LPAGE                     0x08
#define TEMPERATURE_LPAGE                       0x0d
#define STARTSTOP_CYCLE_COUNTER_LPAGE           0x0e
#define APPLICATION_CLIENT_LPAGE                0x0f
#define SELFTEST_RESULTS_LPAGE                  0x10
#define IE_LPAGE                                0x2f

/* Seagate vendor specific log pages. */
#define SEAGATE_CACHE_LPAGE                     0x37
#define SEAGATE_FACTORY_LPAGE                   0x3e

/* Log page response lengths */
#define LOG_RESP_SELF_TEST_LEN 0x194

/* See the SSC-2 document at www.t10.org . Earler note: From IBM 
Documentation, see http://www.storage.ibm.com/techsup/hddtech/prodspecs.htm */
#define TAPE_ALERTS_LPAGE                        0x2e

/* ANSI SCSI-3 Mode Pages */
#define VENDOR_UNIQUE_PAGE                       0x00
#define READ_WRITE_ERROR_RECOVERY_PAGE           0x01
#define DISCONNECT_RECONNECT_PAGE                0x02
#define FORMAT_DEVICE_PAGE                       0x03
#define RIGID_DISK_DRIVE_GEOMETRY_PAGE           0x04
#define FLEXIBLE_DISK_PAGE                       0x05
#define VERIFY_ERROR_RECOVERY_PAGE               0x07
#define CACHING_PAGE                             0x08
#define PERIPHERAL_DEVICE_PAGE                   0x09
#define XOR_CONTROL_MODE_PAGE                    0x10
#define CONTROL_MODE_PAGE                        0x0a
#define MEDIUM_TYPES_SUPPORTED_PAGE              0x0b
#define NOTCH_PAGE                               0x0c
#define CD_DEVICE_PAGE                           0x0d
#define CD_AUDIO_CONTROL_PAGE                    0x0e
#define DATA_COMPRESSION_PAGE                    0x0f
#define ENCLOSURE_SERVICES_MANAGEMENT_PAGE       0x14
#define PROTOCOL_SPECIFIC_LUN_PAGE               0x18
#define PROTOCOL_SPECIFIC_PORT_PAGE              0x19
#define POWER_CONDITION_PAGE                     0x1a
#define INFORMATIONAL_EXCEPTIONS_CONTROL_PAGE    0x1c
#define FAULT_FAILURE_REPORTING_PAGE             0x1c

#define ALL_MODE_PAGES                           0x3f

/* Mode page control field */
#define MPAGE_CONTROL_CURRENT               0
#define MPAGE_CONTROL_CHANGEABLE            1
#define MPAGE_CONTROL_DEFAULT               2
#define MPAGE_CONTROL_SAVED                 3

/* defines for useful SCSI Status codes */
#define SCSI_STATUS_CHECK_CONDITION     0x2

/* defines for useful Sense Key codes */
#define SCSI_SK_NOT_READY               0x2
#define SCSI_SK_MEDIUM_ERROR            0x3
#define SCSI_SK_HARDWARE_ERROR          0x4
#define SCSI_SK_ILLEGAL_REQUEST         0x5
#define SCSI_SK_UNIT_ATTENTION          0x6

/* defines for useful Additional Sense Codes (ASCs) */
#define SCSI_ASC_NOT_READY              0x4     /* more info in ASCQ code */
#define SCSI_ASC_NO_MEDIUM              0x3a    /* more info in ASCQ code */
#define SCSI_ASC_UNKNOWN_OPCODE         0x20
#define SCSI_ASC_UNKNOWN_FIELD          0x24
#define SCSI_ASC_UNKNOWN_PARAM          0x26
#define SCSI_ASC_WARNING                0xb
#define SCSI_ASC_IMPENDING_FAILURE      0x5d

/* Simplified error code (negative values as per errno) */
#define SIMPLE_NO_ERROR                 0
#define SIMPLE_ERR_NOT_READY            1
#define SIMPLE_ERR_BAD_OPCODE           2
#define SIMPLE_ERR_BAD_FIELD            3       /* in cbd */
#define SIMPLE_ERR_BAD_PARAM            4       /* in data */
#define SIMPLE_ERR_BAD_RESP             5       /* response fails sanity */
#define SIMPLE_ERR_NO_MEDIUM            6       /* no medium present */
#define SIMPLE_ERR_BECOMING_READY       7       /* device will be ready soon */
#define SIMPLE_ERR_TRY_AGAIN            8       /* some warning, try again */
#define SIMPLE_ERR_MEDIUM_HARDWARE      9       /* medium or hardware error */


/* defines for functioncode parameter in SENDDIAGNOSTIC function */
#define SCSI_DIAG_NO_SELF_TEST          0x00
#define SCSI_DIAG_DEF_SELF_TEST         0xff
#define SCSI_DIAG_BG_SHORT_SELF_TEST    0x01
#define SCSI_DIAG_BG_EXTENDED_SELF_TEST 0x02
#define SCSI_DIAG_FG_SHORT_SELF_TEST    0x05
#define SCSI_DIAG_FG_EXTENDED_SELF_TEST 0x06
#define SCSI_DIAG_ABORT_SELF_TEST       0x04


/* SCSI command timeout values (units are seconds) */
#define SCSI_TIMEOUT_DEFAULT    6               /* 6 seconds should be ample */
#define SCSI_TIMEOUT_SELF_TEST  (5 * 60 * 60)   /* allow max 5 hours for */
                                            /* extended foreground self test */


#define LOGPAGEHDRSIZE  4

void scsi_do_sense_disect(const struct scsi_cmnd_io * in,
                          struct scsi_sense_disect * out);

const char * scsiErrString(int scsiErr);

/* STANDARD SCSI Commands  */
int scsiTestUnitReady(int device);

int scsiStdInquiry(int device, UINT8 *pBuf, int bufLen);

int scsiInquiryVpd(int device, int vpd_page, UINT8 *pBuf, int bufLen);

int scsiLogSense(int device, int pagenum, UINT8 *pBuf, int bufLen,
                 int known_resp_len);

int scsiModeSense(int device, int pagenum, int pc, UINT8 *pBuf, int bufLen);

int scsiModeSelect(int device, int sp, UINT8 *pBuf, int bufLen);

int scsiModeSense10(int device, int pagenum, int pc, UINT8 *pBuf, int bufLen);

int scsiModeSelect10(int device, int sp, UINT8 *pBuf, int bufLen);

int scsiModePageOffset(const UINT8 * resp, int len, int modese_len);

int scsiRequestSense(int device, struct scsi_sense_disect * sense_info);

int scsiSendDiagnostic(int device, int functioncode, UINT8 *pBuf, int bufLen);

int scsiReceiveDiagnostic(int device, int pcv, int pagenum, UINT8 *pBuf,
                      int bufLen);

int scsiReadDefect10(int device, int req_plist, int req_glist, int dl_format,
                     UINT8 *pBuf, int bufLen);

/* SMART specific commands */
int scsiCheckIE(int device, int hasIELogPage, int hasTempLogPage, UINT8 *asc,
                UINT8 *ascq, UINT8 *currenttemp, UINT8 *triptemp);

int scsiFetchIECmpage(int device, struct scsi_iec_mode_page *iecp, 
                      int modese_len);
int scsi_IsExceptionControlEnabled(const struct scsi_iec_mode_page *iecp);
int scsi_IsWarningEnabled(const struct scsi_iec_mode_page *iecp);
int scsiSetExceptionControlAndWarning(int device, int enabled,
                            const struct scsi_iec_mode_page *iecp);
void scsiDecodeErrCounterPage(unsigned char * resp,
                              struct scsiErrorCounter *ecp);
void scsiDecodeNonMediumErrPage(unsigned char * resp,
                                struct scsiNonMediumError *nmep);
int scsiFetchExtendedSelfTestTime(int device, int * durationSec, 
                                  int modese_len);
int scsiCountFailedSelfTests(int fd, int noisy);
int scsiSelfTestInProgress(int fd, int * inProgress);
int scsiFetchControlGLTSD(int device, int modese_len, int current);
int scsiSetControlGLTSD(int device, int enabled, int modese_len);
int scsiFetchTransportProtocol(int device, int modese_len);

/* T10 Standard IE Additional Sense Code strings taken from t10.org */

const char* scsiGetIEString(UINT8 asc, UINT8 ascq);
int scsiGetTemp(int device, UINT8 *currenttemp, UINT8 *triptemp);


int scsiSmartIBMOfflineTest(int device);

int scsiSmartDefaultSelfTest(int device);
int scsiSmartShortSelfTest(int device);
int scsiSmartExtendSelfTest(int device);
int scsiSmartShortCapSelfTest(int device);
int scsiSmartExtendCapSelfTest(int device);
int scsiSmartSelfTestAbort(int device);

const char * scsiTapeAlertsTapeDevice(unsigned short code);
const char * scsiTapeAlertsChangerDevice(unsigned short code);

const char * scsi_get_opcode_name(UINT8 opcode);
void dStrHex(const char* str, int len, int no_ascii);

/* SCSI command transmission interface function declaration. Its
 * definition is target OS specific (see os_<OS>.c file).
 * Returns 0 if SCSI command successfully launched and response
 * received. Even when 0 is returned the caller should check
 * scsi_cmnd_io::scsi_status for SCSI defined errors and warnings
 * (e.g. CHECK CONDITION). If the SCSI command could not be issued
 * (e.g. device not present or not a SCSI device) or some other problem
 * arises (e.g. timeout) then returns a negative errno value. */
int do_scsi_cmnd_io(int dev_fd, struct scsi_cmnd_io * iop, int report);


/* This is Linux specific and will be generalized later. */
int isLinuxLibAta(unsigned char * vpd_di_buff, int len);

#endif
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
	35	#define SCSICMDS_H_CVSID "$Id: scsicmds.h,v 1.57 2006/04/12 14:54:28 ballen4705 Exp $\n"
	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
80	typedef unsigned char UINT8;
81	typedef char INT8;
82	typedef unsigned int UINT32;
83	typedef int INT32;
84
85	#define DXFER_NONE 0
86	#define DXFER_FROM_DEVICE 1
87	#define DXFER_TO_DEVICE 2
88
89	struct scsi_cmnd_io
90	{
91	UINT8 * cmnd; /* [in]: ptr to SCSI command block (cdb) */
92	size_t cmnd_len; /* [in]: number of bytes in SCSI command */
93	int dxfer_dir; /* [in]: DXFER_NONE, DXFER_FROM_DEVICE, or
94	DXFER_TO_DEVICE */
95	UINT8 * dxferp; /* [in]: ptr to outgoing or incoming data buffer */
96	size_t dxfer_len; /* [in]: bytes to be transferred to/from dxferp */
97	UINT8 * sensep; /* [in]: ptr to sense buffer, filled when
98	CHECK CONDITION status occurs */
99	size_t max_sense_len; /* [in]: max number of bytes to write to sensep */
100	unsigned timeout; /* [in]: seconds, 0-> default timeout (60 seconds?) */
101	size_t resp_sense_len; /* [out]: sense buffer length written */
102	UINT8 scsi_status; /* [out]: 0->ok, 2->CHECK CONDITION, etc ... */
103	int resid; /* [out]: Number of bytes requested to be transferred
104	less actual number transferred (0 if not
105	supported) */
106	};
107
108	struct scsi_sense_disect {
109	UINT8 error_code;
110	UINT8 sense_key;
111	UINT8 asc;
112	UINT8 ascq;
113	};
114
115	/* Useful data from Informational Exception Control mode page (0x1c) */
116	#define SCSI_IECMP_RAW_LEN 64
117	struct scsi_iec_mode_page {
118	UINT8 requestedCurrent;
119	UINT8 gotCurrent;
120	UINT8 requestedChangeable;
121	UINT8 gotChangeable;
122	UINT8 modese_len; /* 0 (don't know), 6 or 10 */
123	UINT8 raw_curr[SCSI_IECMP_RAW_LEN];
124	UINT8 raw_chg[SCSI_IECMP_RAW_LEN];
125	};
126
127	/* Carrier for Error counter log pages (e.g. read, write, verify ...) */
128	struct scsiErrorCounter {
129	UINT8 gotPC[7];
130	UINT8 gotExtraPC;
131	uint64_t counter[8];
132	};
133
134	/* Carrier for Non-medium error log page */
135	struct scsiNonMediumError {
136	UINT8 gotPC0;
137	UINT8 gotExtraPC;
138	uint64_t counterPC0;
139	UINT8 gotTFE_H;
140	uint64_t counterTFE_H; /* Track following errors [Hitachi] */
141	UINT8 gotPE_H;
142	uint64_t counterPE_H; /* Positioning errors [Hitachi] */
143	};
144
145	/* SCSI Peripheral types (of interest) */
146	#define SCSI_PT_DIRECT_ACCESS 0x0
147	#define SCSI_PT_SEQUENTIAL_ACCESS 0x1
148	#define SCSI_PT_CDROM 0x5
149	#define SCSI_PT_MEDIUM_CHANGER 0x8
150	#define SCSI_PT_ENCLOSURE 0xd
151
152	/* ANSI SCSI-3 Log Pages retrieved by LOG SENSE. */
153	#define SUPPORTED_LPAGES 0x00
154	#define BUFFER_OVERRUN_LPAGE 0x01
155	#define WRITE_ERROR_COUNTER_LPAGE 0x02
156	#define READ_ERROR_COUNTER_LPAGE 0x03
157	#define READ_REVERSE_ERROR_COUNTER_LPAGE 0x04
158	#define VERIFY_ERROR_COUNTER_LPAGE 0x05
159	#define NON_MEDIUM_ERROR_LPAGE 0x06
160	#define LAST_N_ERROR_LPAGE 0x07
161	#define FORMAT_STATUS_LPAGE 0x08
162	#define TEMPERATURE_LPAGE 0x0d
163	#define STARTSTOP_CYCLE_COUNTER_LPAGE 0x0e
164	#define APPLICATION_CLIENT_LPAGE 0x0f
165	#define SELFTEST_RESULTS_LPAGE 0x10
166	#define IE_LPAGE 0x2f
167
168	/* Seagate vendor specific log pages. */
169	#define SEAGATE_CACHE_LPAGE 0x37
170	#define SEAGATE_FACTORY_LPAGE 0x3e
171
172	/* Log page response lengths */
173	#define LOG_RESP_SELF_TEST_LEN 0x194
174
175	/* See the SSC-2 document at www.t10.org . Earler note: From IBM
176	Documentation, see http://www.storage.ibm.com/techsup/hddtech/prodspecs.htm */
177	#define TAPE_ALERTS_LPAGE 0x2e
178
179	/* ANSI SCSI-3 Mode Pages */
180	#define VENDOR_UNIQUE_PAGE 0x00
181	#define READ_WRITE_ERROR_RECOVERY_PAGE 0x01
182	#define DISCONNECT_RECONNECT_PAGE 0x02
183	#define FORMAT_DEVICE_PAGE 0x03
184	#define RIGID_DISK_DRIVE_GEOMETRY_PAGE 0x04
185	#define FLEXIBLE_DISK_PAGE 0x05
186	#define VERIFY_ERROR_RECOVERY_PAGE 0x07
187	#define CACHING_PAGE 0x08
188	#define PERIPHERAL_DEVICE_PAGE 0x09
189	#define XOR_CONTROL_MODE_PAGE 0x10
190	#define CONTROL_MODE_PAGE 0x0a
191	#define MEDIUM_TYPES_SUPPORTED_PAGE 0x0b
192	#define NOTCH_PAGE 0x0c
193	#define CD_DEVICE_PAGE 0x0d
194	#define CD_AUDIO_CONTROL_PAGE 0x0e
195	#define DATA_COMPRESSION_PAGE 0x0f
196	#define ENCLOSURE_SERVICES_MANAGEMENT_PAGE 0x14
197	#define PROTOCOL_SPECIFIC_LUN_PAGE 0x18
198	#define PROTOCOL_SPECIFIC_PORT_PAGE 0x19
199	#define POWER_CONDITION_PAGE 0x1a
200	#define INFORMATIONAL_EXCEPTIONS_CONTROL_PAGE 0x1c
201	#define FAULT_FAILURE_REPORTING_PAGE 0x1c
202
203	#define ALL_MODE_PAGES 0x3f
204
205	/* Mode page control field */
206	#define MPAGE_CONTROL_CURRENT 0
207	#define MPAGE_CONTROL_CHANGEABLE 1
208	#define MPAGE_CONTROL_DEFAULT 2
209	#define MPAGE_CONTROL_SAVED 3
210
211	/* defines for useful SCSI Status codes */
212	#define SCSI_STATUS_CHECK_CONDITION 0x2
213
214	/* defines for useful Sense Key codes */
215	#define SCSI_SK_NOT_READY 0x2
216	#define SCSI_SK_MEDIUM_ERROR 0x3
217	#define SCSI_SK_HARDWARE_ERROR 0x4
218	#define SCSI_SK_ILLEGAL_REQUEST 0x5
219	#define SCSI_SK_UNIT_ATTENTION 0x6
220
221	/* defines for useful Additional Sense Codes (ASCs) */
222	#define SCSI_ASC_NOT_READY 0x4 /* more info in ASCQ code */
223	#define SCSI_ASC_NO_MEDIUM 0x3a /* more info in ASCQ code */
224	#define SCSI_ASC_UNKNOWN_OPCODE 0x20
225	#define SCSI_ASC_UNKNOWN_FIELD 0x24
226	#define SCSI_ASC_UNKNOWN_PARAM 0x26
227	#define SCSI_ASC_WARNING 0xb
228	#define SCSI_ASC_IMPENDING_FAILURE 0x5d
229
230	/* Simplified error code (negative values as per errno) */
231	#define SIMPLE_NO_ERROR 0
232	#define SIMPLE_ERR_NOT_READY 1
233	#define SIMPLE_ERR_BAD_OPCODE 2
234	#define SIMPLE_ERR_BAD_FIELD 3 /* in cbd */
235	#define SIMPLE_ERR_BAD_PARAM 4 /* in data */
236	#define SIMPLE_ERR_BAD_RESP 5 /* response fails sanity */
237	#define SIMPLE_ERR_NO_MEDIUM 6 /* no medium present */
238	#define SIMPLE_ERR_BECOMING_READY 7 /* device will be ready soon */
239	#define SIMPLE_ERR_TRY_AGAIN 8 /* some warning, try again */
240	#define SIMPLE_ERR_MEDIUM_HARDWARE 9 /* medium or hardware error */
241
242
243	/* defines for functioncode parameter in SENDDIAGNOSTIC function */
244	#define SCSI_DIAG_NO_SELF_TEST 0x00
245	#define SCSI_DIAG_DEF_SELF_TEST 0xff
246	#define SCSI_DIAG_BG_SHORT_SELF_TEST 0x01
247	#define SCSI_DIAG_BG_EXTENDED_SELF_TEST 0x02
248	#define SCSI_DIAG_FG_SHORT_SELF_TEST 0x05
249	#define SCSI_DIAG_FG_EXTENDED_SELF_TEST 0x06
250	#define SCSI_DIAG_ABORT_SELF_TEST 0x04
251
252
253	/* SCSI command timeout values (units are seconds) */
254	#define SCSI_TIMEOUT_DEFAULT 6 /* 6 seconds should be ample */
255	#define SCSI_TIMEOUT_SELF_TEST (5 * 60 * 60) /* allow max 5 hours for */
256	/* extended foreground self test */
257
258
259
260	#define LOGPAGEHDRSIZE 4
261
262	void scsi_do_sense_disect(const struct scsi_cmnd_io * in,
263	struct scsi_sense_disect * out);
264
265	const char * scsiErrString(int scsiErr);
266
267	/* STANDARD SCSI Commands */
268	int scsiTestUnitReady(int device);
269
270	int scsiStdInquiry(int device, UINT8 *pBuf, int bufLen);
271
272	int scsiInquiryVpd(int device, int vpd_page, UINT8 *pBuf, int bufLen);
273
274	int scsiLogSense(int device, int pagenum, UINT8 *pBuf, int bufLen,
275	int known_resp_len);
276
277	int scsiModeSense(int device, int pagenum, int pc, UINT8 *pBuf, int bufLen);
278
279	int scsiModeSelect(int device, int sp, UINT8 *pBuf, int bufLen);
280
281	int scsiModeSense10(int device, int pagenum, int pc, UINT8 *pBuf, int bufLen);
282
283	int scsiModeSelect10(int device, int sp, UINT8 *pBuf, int bufLen);
284
285	int scsiModePageOffset(const UINT8 * resp, int len, int modese_len);
286
287	int scsiRequestSense(int device, struct scsi_sense_disect * sense_info);
288
289	int scsiSendDiagnostic(int device, int functioncode, UINT8 *pBuf, int bufLen);
290
291	int scsiReceiveDiagnostic(int device, int pcv, int pagenum, UINT8 *pBuf,
292	int bufLen);
293
294	int scsiReadDefect10(int device, int req_plist, int req_glist, int dl_format,
295	UINT8 *pBuf, int bufLen);
296
297	/* SMART specific commands */
298	int scsiCheckIE(int device, int hasIELogPage, int hasTempLogPage, UINT8 *asc,
299	UINT8 ascq, UINT8 currenttemp, UINT8 *triptemp);
300
301	int scsiFetchIECmpage(int device, struct scsi_iec_mode_page *iecp,
302	int modese_len);
303	int scsi_IsExceptionControlEnabled(const struct scsi_iec_mode_page *iecp);
304	int scsi_IsWarningEnabled(const struct scsi_iec_mode_page *iecp);
305	int scsiSetExceptionControlAndWarning(int device, int enabled,
306	const struct scsi_iec_mode_page *iecp);
307	void scsiDecodeErrCounterPage(unsigned char * resp,
308	struct scsiErrorCounter *ecp);
309	void scsiDecodeNonMediumErrPage(unsigned char * resp,
310	struct scsiNonMediumError *nmep);
311	int scsiFetchExtendedSelfTestTime(int device, int * durationSec,
312	int modese_len);
313	int scsiCountFailedSelfTests(int fd, int noisy);
314	int scsiSelfTestInProgress(int fd, int * inProgress);
315	int scsiFetchControlGLTSD(int device, int modese_len, int current);
316	int scsiSetControlGLTSD(int device, int enabled, int modese_len);
317	int scsiFetchTransportProtocol(int device, int modese_len);
318
319	/* T10 Standard IE Additional Sense Code strings taken from t10.org */
320
321	const char* scsiGetIEString(UINT8 asc, UINT8 ascq);
322	int scsiGetTemp(int device, UINT8 currenttemp, UINT8 triptemp);
323
324
325	int scsiSmartIBMOfflineTest(int device);
326
327	int scsiSmartDefaultSelfTest(int device);
328	int scsiSmartShortSelfTest(int device);
329	int scsiSmartExtendSelfTest(int device);
330	int scsiSmartShortCapSelfTest(int device);
331	int scsiSmartExtendCapSelfTest(int device);
332	int scsiSmartSelfTestAbort(int device);
333
334	const char * scsiTapeAlertsTapeDevice(unsigned short code);
335	const char * scsiTapeAlertsChangerDevice(unsigned short code);
336
337	const char * scsi_get_opcode_name(UINT8 opcode);
338	void dStrHex(const char* str, int len, int no_ascii);
339
340	/* SCSI command transmission interface function declaration. Its
341	* definition is target OS specific (see os_<OS>.c file).
342	* Returns 0 if SCSI command successfully launched and response
343	* received. Even when 0 is returned the caller should check
344	* scsi_cmnd_io::scsi_status for SCSI defined errors and warnings
345	* (e.g. CHECK CONDITION). If the SCSI command could not be issued
346	* (e.g. device not present or not a SCSI device) or some other problem
347	* arises (e.g. timeout) then returns a negative errno value. */
348	int do_scsi_cmnd_io(int dev_fd, struct scsi_cmnd_io * iop, int report);
349
350
351	/* This is Linux specific and will be generalized later. */
352	int isLinuxLibAta(unsigned char * vpd_di_buff, int len);
353
354	#endif
355