1 #ifndef SCSI_UTILS_H 2 #define SCSI_UTILS_H 1 3 4 #ifdef CONFIG_LINUX 5 #include <scsi/sg.h> 6 #endif 7 8 #define SCSI_CMD_BUF_SIZE 16 9 #define SCSI_SENSE_LEN 18 10 #define SCSI_SENSE_LEN_SCANNER 32 11 #define SCSI_INQUIRY_LEN 36 12 13 enum SCSIXferMode { 14 SCSI_XFER_NONE, /* TEST_UNIT_READY, ... */ 15 SCSI_XFER_FROM_DEV, /* READ, INQUIRY, MODE_SENSE, ... */ 16 SCSI_XFER_TO_DEV, /* WRITE, MODE_SELECT, ... */ 17 }; 18 19 typedef struct SCSICommand { 20 uint8_t buf[SCSI_CMD_BUF_SIZE]; 21 int len; 22 size_t xfer; 23 uint64_t lba; 24 enum SCSIXferMode mode; 25 } SCSICommand; 26 27 typedef struct SCSISense { 28 uint8_t key; 29 uint8_t asc; 30 uint8_t ascq; 31 } SCSISense; 32 33 /* 34 * Predefined sense codes 35 */ 36 37 /* No sense data available */ 38 extern const struct SCSISense sense_code_NO_SENSE; 39 /* LUN not ready, Manual intervention required */ 40 extern const struct SCSISense sense_code_LUN_NOT_READY; 41 /* LUN not ready, Medium not present */ 42 extern const struct SCSISense sense_code_NO_MEDIUM; 43 /* LUN not ready, medium removal prevented */ 44 extern const struct SCSISense sense_code_NOT_READY_REMOVAL_PREVENTED; 45 /* Hardware error, internal target failure */ 46 extern const struct SCSISense sense_code_TARGET_FAILURE; 47 /* Illegal request, invalid command operation code */ 48 extern const struct SCSISense sense_code_INVALID_OPCODE; 49 /* Illegal request, LBA out of range */ 50 extern const struct SCSISense sense_code_LBA_OUT_OF_RANGE; 51 /* Illegal request, Invalid field in CDB */ 52 extern const struct SCSISense sense_code_INVALID_FIELD; 53 /* Illegal request, Invalid field in parameter list */ 54 extern const struct SCSISense sense_code_INVALID_PARAM; 55 /* Illegal request, Parameter list length error */ 56 extern const struct SCSISense sense_code_INVALID_PARAM_LEN; 57 /* Illegal request, LUN not supported */ 58 extern const struct SCSISense sense_code_LUN_NOT_SUPPORTED; 59 /* Illegal request, Saving parameters not supported */ 60 extern const struct SCSISense sense_code_SAVING_PARAMS_NOT_SUPPORTED; 61 /* Illegal request, Incompatible format */ 62 extern const struct SCSISense sense_code_INCOMPATIBLE_FORMAT; 63 /* Illegal request, medium removal prevented */ 64 extern const struct SCSISense sense_code_ILLEGAL_REQ_REMOVAL_PREVENTED; 65 /* Illegal request, Invalid Transfer Tag */ 66 extern const struct SCSISense sense_code_INVALID_TAG; 67 /* Command aborted, I/O process terminated */ 68 extern const struct SCSISense sense_code_IO_ERROR; 69 /* Command aborted, I_T Nexus loss occurred */ 70 extern const struct SCSISense sense_code_I_T_NEXUS_LOSS; 71 /* Command aborted, Logical Unit failure */ 72 extern const struct SCSISense sense_code_LUN_FAILURE; 73 /* Command aborted, Overlapped Commands Attempted */ 74 extern const struct SCSISense sense_code_OVERLAPPED_COMMANDS; 75 /* LUN not ready, Capacity data has changed */ 76 extern const struct SCSISense sense_code_CAPACITY_CHANGED; 77 /* LUN not ready, Medium not present */ 78 extern const struct SCSISense sense_code_UNIT_ATTENTION_NO_MEDIUM; 79 /* Unit attention, Power on, reset or bus device reset occurred */ 80 extern const struct SCSISense sense_code_RESET; 81 /* Unit attention, Medium may have changed*/ 82 extern const struct SCSISense sense_code_MEDIUM_CHANGED; 83 /* Unit attention, Reported LUNs data has changed */ 84 extern const struct SCSISense sense_code_REPORTED_LUNS_CHANGED; 85 /* Unit attention, Device internal reset */ 86 extern const struct SCSISense sense_code_DEVICE_INTERNAL_RESET; 87 /* Data Protection, Write Protected */ 88 extern const struct SCSISense sense_code_WRITE_PROTECTED; 89 /* Data Protection, Space Allocation Failed Write Protect */ 90 extern const struct SCSISense sense_code_SPACE_ALLOC_FAILED; 91 92 #define SENSE_CODE(x) sense_code_ ## x 93 94 int scsi_sense_to_errno(int key, int asc, int ascq); 95 int scsi_sense_buf_to_errno(const uint8_t *sense, size_t sense_size); 96 97 int scsi_convert_sense(uint8_t *in_buf, int in_len, 98 uint8_t *buf, int len, bool fixed); 99 const char *scsi_command_name(uint8_t cmd); 100 101 uint64_t scsi_cmd_lba(SCSICommand *cmd); 102 uint32_t scsi_data_cdb_xfer(uint8_t *buf); 103 uint32_t scsi_cdb_xfer(uint8_t *buf); 104 int scsi_cdb_length(uint8_t *buf); 105 106 /* Linux SG_IO interface. */ 107 #ifdef CONFIG_LINUX 108 #define SG_ERR_DRIVER_TIMEOUT 0x06 109 #define SG_ERR_DRIVER_SENSE 0x08 110 111 #define SG_ERR_DID_OK 0x00 112 #define SG_ERR_DID_NO_CONNECT 0x01 113 #define SG_ERR_DID_BUS_BUSY 0x02 114 #define SG_ERR_DID_TIME_OUT 0x03 115 116 #define SG_ERR_DRIVER_SENSE 0x08 117 #endif 118 119 #endif 120