2 * Largely written by Julian Elischer (julian@tfs.com)
3 * for TRW Financial Systems.
5 * TRW Financial Systems, in accordance with their agreement with Carnegie
6 * Mellon University, makes this software available to CMU to distribute
7 * or use in any manner that they see fit as long as this message is kept with
8 * the software. For this reason TFS also grants any other persons or
9 * organisations permission to use or modify this software.
11 * TFS supplies this software to be publicly redistributed
12 * on the understanding that TFS is not responsible for the correct
13 * functioning of this software in any circumstances.
15 * Ported to run under 386BSD by Julian Elischer (julian@tfs.com) Sept 1992
17 * $FreeBSD: src/sys/cam/scsi/scsi_all.h,v 1.31 2008/08/07 17:25:05 jkim Exp $
18 * $DragonFly: src/sys/bus/cam/scsi/scsi_all.h,v 1.15 2008/08/23 22:27:27 pavalos Exp $
22 * SCSI general interface description
25 #ifndef _SCSI_SCSI_ALL_H
26 #define _SCSI_SCSI_ALL_H 1
29 #include <sys/cdefs.h>
31 #if !defined(_KERNEL) && !defined(_STDIO_H_)
32 #include <stdio.h> /* FILE for userland protos */
37 * This is the number of milliseconds we wait for devices to settle after a SCSI
40 extern int scsi_delay;
48 * Define dome bits that are in ALL (or a lot of) scsi commands
50 #define SCSI_CTL_LINK 0x01
51 #define SCSI_CTL_FLAG 0x02
52 #define SCSI_CTL_VENDOR 0xC0
53 #define SCSI_CMD_LUN 0xA0 /* these two should not be needed */
54 #define SCSI_CMD_LUN_SHIFT 5 /* LUN in the cmd is no longer SCSI */
56 #define SCSI_MAX_CDBLEN 16 /*
57 * 16 byte commands are in the
60 #if defined(CAM_MAX_CDBLEN) && (CAM_MAX_CDBLEN < SCSI_MAX_CDBLEN)
61 #error "CAM_MAX_CDBLEN cannot be less than SCSI_MAX_CDBLEN"
64 /* 6byte CDBs special case 0 length to be 256 */
65 #define SCSI_CDB6_LEN(len) ((len) == 0 ? 256 : len)
68 * This type defines actions to be taken when a particular sense code is
69 * received. Right now, these flags are only defined to take up 16 bits,
70 * but can be expanded in the future if necessary.
73 SS_NOP = 0x000000, /* Do nothing */
74 SS_RETRY = 0x010000, /* Retry the command */
75 SS_FAIL = 0x020000, /* Bail out */
76 SS_START = 0x030000, /* Send a Start Unit command to the device,
77 * then retry the original command.
79 SS_TUR = 0x040000, /* Send a Test Unit Ready command to the
80 * device, then retry the original command.
82 SS_REQSENSE = 0x050000, /* Send a RequestSense command to the
83 * device, then retry the original command.
90 SSQ_DECREMENT_COUNT = 0x0100, /* Decrement the retry count */
91 SSQ_MANY = 0x0200, /* send lots of recovery commands */
92 SSQ_RANGE = 0x0400, /*
93 * This table entry represents the
94 * end of a range of ASCQs that
95 * have identical error actions
98 SSQ_PRINT_SENSE = 0x0800,
100 } scsi_sense_action_qualifier;
102 /* Mask for error status values */
103 #define SS_ERRMASK 0xff
105 /* The default, retyable, error action */
106 #define SS_RDEF SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE|EIO
108 /* The retyable, error action, with table specified error code */
109 #define SS_RET SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE
111 /* Fatal error action, with table specified error code */
112 #define SS_FATAL SS_FAIL|SSQ_PRINT_SENSE
120 struct scsi_request_sense
129 struct scsi_test_unit_ready
137 struct scsi_send_diag
143 #define SSD_SELFTEST 0x04
146 u_int8_t paramlen[2];
170 struct scsi_mode_sense_6
176 #define SMS_PAGE_CODE 0x3F
177 #define SMS_VENDOR_SPECIFIC_PAGE 0x00
178 #define SMS_DISCONNECT_RECONNECT_PAGE 0x02
179 #define SMS_CACHE_PAGE 0x08
180 #define SMS_PERIPHERAL_DEVICE_PAGE 0x09
181 #define SMS_CONTROL_MODE_PAGE 0x0A
182 #define SMS_PROTO_SPECIFIC_PAGE 0x19
183 #define SMS_INFO_EXCEPTIONS_PAGE 0x1C
184 #define SMS_ALL_PAGES_PAGE 0x3F
185 #define SMS_PAGE_CTRL_MASK 0xC0
186 #define SMS_PAGE_CTRL_CURRENT 0x00
187 #define SMS_PAGE_CTRL_CHANGEABLE 0x40
188 #define SMS_PAGE_CTRL_DEFAULT 0x80
189 #define SMS_PAGE_CTRL_SAVED 0xC0
195 struct scsi_mode_sense_10
198 u_int8_t byte2; /* same bits as small version */
199 u_int8_t page; /* same bits as small version */
205 struct scsi_mode_select_6
216 struct scsi_mode_select_10
219 u_int8_t byte2; /* same bits as small version */
226 * When sending a mode select to a tape drive, the medium type must be 0.
228 struct scsi_mode_hdr_6
231 u_int8_t medium_type;
232 u_int8_t dev_specific;
233 u_int8_t block_descr_len;
236 struct scsi_mode_hdr_10
239 u_int8_t medium_type;
240 u_int8_t dev_specific;
241 u_int8_t reserved[2];
242 u_int8_t block_descr_len[2];
245 struct scsi_mode_block_descr
247 u_int8_t density_code;
248 u_int8_t num_blocks[3];
250 u_int8_t block_len[3];
253 struct scsi_log_sense
260 #define SLS_PAGE_CODE 0x3F
261 #define SLS_ALL_PAGES_PAGE 0x00
262 #define SLS_OVERRUN_PAGE 0x01
263 #define SLS_ERROR_WRITE_PAGE 0x02
264 #define SLS_ERROR_READ_PAGE 0x03
265 #define SLS_ERROR_READREVERSE_PAGE 0x04
266 #define SLS_ERROR_VERIFY_PAGE 0x05
267 #define SLS_ERROR_NONMEDIUM_PAGE 0x06
268 #define SLS_ERROR_LASTN_PAGE 0x07
269 #define SLS_SELF_TEST_PAGE 0x10
270 #define SLS_IE_PAGE 0x2f
271 #define SLS_PAGE_CTRL_MASK 0xC0
272 #define SLS_PAGE_CTRL_THRESHOLD 0x00
273 #define SLS_PAGE_CTRL_CUMULATIVE 0x40
274 #define SLS_PAGE_CTRL_THRESH_DEFAULT 0x80
275 #define SLS_PAGE_CTRL_CUMUL_DEFAULT 0xC0
276 u_int8_t reserved[2];
277 u_int8_t paramptr[2];
282 struct scsi_log_select
289 /* SLS_PAGE_CTRL_MASK 0xC0 */
290 /* SLS_PAGE_CTRL_THRESHOLD 0x00 */
291 /* SLS_PAGE_CTRL_CUMULATIVE 0x40 */
292 /* SLS_PAGE_CTRL_THRESH_DEFAULT 0x80 */
293 /* SLS_PAGE_CTRL_CUMUL_DEFAULT 0xC0 */
294 u_int8_t reserved[4];
299 struct scsi_log_header
306 struct scsi_log_param_header {
307 u_int8_t param_code[2];
308 u_int8_t param_control;
310 #define SLP_LBIN 0x02
311 #define SLP_TMC_MASK 0x0C
312 #define SLP_TMC_ALWAYS 0x00
313 #define SLP_TMC_EQUAL 0x04
314 #define SLP_TMC_NOTEQUAL 0x08
315 #define SLP_TMC_GREATER 0x0C
323 struct scsi_control_page {
325 u_int8_t page_length;
327 #define SCB_RLEC 0x01 /*Report Log Exception Cond*/
328 u_int8_t queue_flags;
329 #define SCP_QUEUE_ALG_MASK 0xF0
330 #define SCP_QUEUE_ALG_RESTRICTED 0x00
331 #define SCP_QUEUE_ALG_UNRESTRICTED 0x10
332 #define SCP_QUEUE_ERR 0x02 /*Queued I/O aborted for CACs*/
333 #define SCP_QUEUE_DQUE 0x01 /*Queued I/O disabled*/
334 u_int8_t eca_and_aen;
335 #define SCP_EECA 0x80 /*Enable Extended CA*/
336 #define SCP_RAENP 0x04 /*Ready AEN Permission*/
337 #define SCP_UAAENP 0x02 /*UA AEN Permission*/
338 #define SCP_EAENP 0x01 /*Error AEN Permission*/
340 u_int8_t aen_holdoff_period[2];
343 struct scsi_cache_page {
345 #define SCHP_PAGE_SAVABLE 0x80 /* Page is savable */
346 u_int8_t page_length;
347 u_int8_t cache_flags;
348 #define SCHP_FLAGS_WCE 0x04 /* Write Cache Enable */
349 #define SCHP_FLAGS_MF 0x02 /* Multiplication factor */
350 #define SCHP_FLAGS_RCD 0x01 /* Read Cache Disable */
351 u_int8_t rw_cache_policy;
352 u_int8_t dis_prefetch[2];
353 u_int8_t min_prefetch[2];
354 u_int8_t max_prefetch[2];
355 u_int8_t max_prefetch_ceil[2];
358 struct scsi_info_exceptions_page {
360 #define SIEP_PAGE_SAVABLE 0x80 /* Page is savable */
361 u_int8_t page_length;
363 #define SIEP_FLAGS_PERF 0x80
364 #define SIEP_FLAGS_EBF 0x20
365 #define SIEP_FLAGS_EWASC 0x10
366 #define SIEP_FLAGS_DEXCPT 0x08
367 #define SIEP_FLAGS_TEST 0x04
368 #define SIEP_FLAGS_EBACKERR 0x02
369 #define SIEP_FLAGS_LOGERR 0x01
371 u_int8_t interval_timer[4];
372 u_int8_t report_count[4];
375 struct scsi_proto_specific_page {
377 #define SPSP_PAGE_SAVABLE 0x80 /* Page is savable */
378 u_int8_t page_length;
380 #define SPSP_PROTO_FC 0x00
381 #define SPSP_PROTO_SPI 0x01
382 #define SPSP_PROTO_SSA 0x02
383 #define SPSP_PROTO_1394 0x03
384 #define SPSP_PROTO_RDMA 0x04
385 #define SPSP_PROTO_ISCSI 0x05
386 #define SPSP_PROTO_SAS 0x06
387 #define SPSP_PROTO_ADT 0x07
388 #define SPSP_PROTO_ATA 0x08
389 #define SPSP_PROTO_NONE 0x0f
418 #define PR_PREVENT 0x01
419 #define PR_ALLOW 0x00
421 struct scsi_sync_cache
425 u_int8_t begin_lba[4];
427 u_int8_t lb_count[2];
432 struct scsi_changedef
443 struct scsi_read_buffer
447 #define RWB_MODE 0x07
448 #define RWB_MODE_HDR_DATA 0x00
449 #define RWB_MODE_DATA 0x02
450 #define RWB_MODE_DOWNLOAD 0x04
451 #define RWB_MODE_DOWNLOAD_SAVE 0x05
458 struct scsi_write_buffer
472 /* only 5 bits are valid in the MSB address byte */
473 #define SRW_TOPADDR 0x1F
481 #define SRW10_RELADDR 0x01
482 /* EBP defined for WRITE(10) only */
483 #define SRW10_EBP 0x04
484 #define SRW10_FUA 0x08
485 #define SRW10_DPO 0x10
496 #define SRW12_RELADDR 0x01
497 #define SRW12_FUA 0x08
498 #define SRW12_DPO 0x10
509 #define SRW16_RELADDR 0x01
510 #define SRW16_FUA 0x08
511 #define SRW16_DPO 0x10
520 struct scsi_start_stop_unit
524 #define SSS_IMMED 0x01
525 u_int8_t reserved[2];
527 #define SSS_START 0x01
528 #define SSS_LOEJ 0x02
535 #define AP_MULTI 0xe0
537 #define AP_T_LEN 0x03
539 #define AP_T_DIR 0x08
540 #define AP_CK_COND 0x20
541 #define AP_OFFLINE 0x60
543 u_int8_t sector_count;
556 #define AP_EXTEND 0x01
558 u_int8_t features_ext;
560 u_int8_t sector_count_ext;
561 u_int8_t sector_count;
562 u_int8_t lba_low_ext;
564 u_int8_t lba_mid_ext;
566 u_int8_t lba_high_ext;
573 #define SC_SCSI_1 0x01
574 #define SC_SCSI_2 0x03
580 #define TEST_UNIT_READY 0x00
581 #define REQUEST_SENSE 0x03
585 #define MODE_SELECT_6 0x15
586 #define MODE_SENSE_6 0x1a
587 #define START_STOP_UNIT 0x1b
588 #define START_STOP 0x1b
591 #define RECEIVE_DIAGNOSTIC 0x1c
592 #define SEND_DIAGNOSTIC 0x1d
593 #define PREVENT_ALLOW 0x1e
594 #define READ_CAPACITY 0x25
596 #define WRITE_10 0x2a
597 #define POSITION_TO_ELEMENT 0x2b
598 #define SYNCHRONIZE_CACHE 0x35
599 #define READ_DEFECT_DATA_10 0x37
600 #define WRITE_BUFFER 0x3b
601 #define READ_BUFFER 0x3c
602 #define CHANGE_DEFINITION 0x40
604 #define LOG_SELECT 0x4c
605 #define LOG_SENSE 0x4d
606 #define MODE_SELECT_10 0x55
607 #define MODE_SENSE_10 0x5a
608 #define ATA_PASS_16 0x85
610 #define WRITE_16 0x8a
611 #define READ_CAPACITY_16 0x9e
612 #define SERVICE_ACTION_IN 0x9e
613 #define REPORT_LUNS 0xa0
614 #define ATA_PASS_12 0xa1
615 #define MOVE_MEDIUM 0xa5
617 #define WRITE_12 0xaa
618 #define READ_ELEMENT_STATUS 0xb8
623 #define T_DIRECT 0x00
624 #define T_SEQUENTIAL 0x01
625 #define T_PRINTER 0x02
626 #define T_PROCESSOR 0x03
629 #define T_SCANNER 0x06
630 #define T_OPTICAL 0x07
631 #define T_CHANGER 0x08
635 #define T_STORARRAY 0x0c
636 #define T_ENCLOSURE 0x0d
641 #define T_NODEVICE 0x1f
642 #define T_ANY 0xff /* Used in Quirk table matches */
648 * This length is the initial inquiry length used by the probe code, as
649 * well as the legnth necessary for scsi_print_inquiry() to function
650 * correctly. If either use requires a different length in the future,
651 * the two values should be de-coupled.
653 #define SHORT_INQUIRY_LENGTH 36
655 struct scsi_inquiry_data
658 #define SID_TYPE(inq_data) ((inq_data)->device & 0x1f)
659 #define SID_QUAL(inq_data) (((inq_data)->device & 0xE0) >> 5)
660 #define SID_QUAL_LU_CONNECTED 0x00 /*
661 * The specified peripheral device
662 * type is currently connected to
663 * logical unit. If the target cannot
664 * determine whether or not a physical
665 * device is currently connected, it
666 * shall also use this peripheral
667 * qualifier when returning the INQUIRY
668 * data. This peripheral qualifier
669 * does not mean that the device is
670 * ready for access by the initiator.
672 #define SID_QUAL_LU_OFFLINE 0x01 /*
673 * The target is capable of supporting
674 * the specified peripheral device type
675 * on this logical unit; however, the
676 * physical device is not currently
677 * connected to this logical unit.
679 #define SID_QUAL_RSVD 0x02
680 #define SID_QUAL_BAD_LU 0x03 /*
681 * The target is not capable of
682 * supporting a physical device on
683 * this logical unit. For this
684 * peripheral qualifier the peripheral
685 * device type shall be set to 1Fh to
686 * provide compatibility with previous
687 * versions of SCSI. All other
688 * peripheral device type values are
689 * reserved for this peripheral
692 #define SID_QUAL_IS_VENDOR_UNIQUE(inq_data) ((SID_QUAL(inq_data) & 0x08) != 0)
694 #define SID_QUAL2 0x7F
695 #define SID_IS_REMOVABLE(inq_data) (((inq_data)->dev_qual2 & 0x80) != 0)
697 #define SID_ANSI_REV(inq_data) ((inq_data)->version & 0x07)
699 #define SCSI_REV_CCS 1
701 #define SCSI_REV_SPC 3
702 #define SCSI_REV_SPC2 4
703 #define SCSI_REV_SPC3 5
705 #define SID_ECMA 0x38
707 u_int8_t response_format;
708 #define SID_AENC 0x80
709 #define SID_TrmIOP 0x40
710 u_int8_t additional_length;
711 #define SID_ADDITIONAL_LENGTH(iqd) \
712 ((iqd)->additional_length + \
713 offsetof(struct scsi_inquiry_data, additional_length) + 1)
716 #define SPC2_SID_MChngr 0x08
717 #define SPC2_SID_MultiP 0x10
718 #define SPC2_SID_EncServ 0x40
719 #define SPC2_SID_BQueue 0x80
721 #define INQ_DATA_TQ_ENABLED(iqd) \
722 ((SID_ANSI_REV(iqd) < SCSI_REV_SPC2)? ((iqd)->flags & SID_CmdQue) : \
723 (((iqd)->flags & SID_CmdQue) && !((iqd)->spc2_flags & SPC2_SID_BQueue)) || \
724 (!((iqd)->flags & SID_CmdQue) && ((iqd)->spc2_flags & SPC2_SID_BQueue)))
728 #define SID_SftRe 0x01
729 #define SID_CmdQue 0x02
730 #define SID_Linked 0x08
731 #define SID_Sync 0x10
732 #define SID_WBus16 0x20
733 #define SID_WBus32 0x40
734 #define SID_RelAdr 0x80
735 #define SID_VENDOR_SIZE 8
736 char vendor[SID_VENDOR_SIZE];
737 #define SID_PRODUCT_SIZE 16
738 char product[SID_PRODUCT_SIZE];
739 #define SID_REVISION_SIZE 4
740 char revision[SID_REVISION_SIZE];
742 * The following fields were taken from SCSI Primary Commands - 2
743 * (SPC-2) Revision 14, Dated 11 November 1999
745 #define SID_VENDOR_SPECIFIC_0_SIZE 20
746 u_int8_t vendor_specific0[SID_VENDOR_SPECIFIC_0_SIZE];
748 * An extension of SCSI Parallel Specific Values
750 #define SID_SPI_IUS 0x01
751 #define SID_SPI_QAS 0x02
752 #define SID_SPI_CLOCK_ST 0x00
753 #define SID_SPI_CLOCK_DT 0x04
754 #define SID_SPI_CLOCK_DT_ST 0x0C
755 #define SID_SPI_MASK 0x0F
759 * Version Descriptors, stored 2 byte values.
761 u_int8_t version1[2];
762 u_int8_t version2[2];
763 u_int8_t version3[2];
764 u_int8_t version4[2];
765 u_int8_t version5[2];
766 u_int8_t version6[2];
767 u_int8_t version7[2];
768 u_int8_t version8[2];
770 u_int8_t reserved3[22];
772 #define SID_VENDOR_SPECIFIC_1_SIZE 160
773 u_int8_t vendor_specific1[SID_VENDOR_SPECIFIC_1_SIZE];
776 struct scsi_vpd_supported_page_list
780 #define SVPD_SUPPORTED_PAGE_LIST 0x00
782 u_int8_t length; /* number of VPD entries */
783 #define SVPD_SUPPORTED_PAGES_SIZE 251
784 u_int8_t list[SVPD_SUPPORTED_PAGES_SIZE];
787 struct scsi_vpd_unit_serial_number
791 #define SVPD_UNIT_SERIAL_NUMBER 0x80
793 u_int8_t length; /* serial number length */
794 #define SVPD_SERIAL_NUM_SIZE 251
795 u_int8_t serial_num[SVPD_SERIAL_NUM_SIZE];
798 struct scsi_vpd_unit_devid
802 #define SVPD_UNIT_DEVID 0x83
805 /* extended by variable array of scsi_vpd_devid_hdr */
808 struct scsi_vpd_devid_hdr {
810 #define VPD_DEVID_PI(_f) (((_f) >> 4) & 0xf0)
811 #define VPD_DEVID_CODE(_f) (((_f) >> 0) & 0x0f)
812 #define VPD_DEVID_CODE_BINARY 0x1
813 #define VPD_DEVID_CODE_ASCII 0x2
814 #define VPD_DEVID_CODE_UTF8 0x3
816 #define VPD_DEVID_PIV 0x80
817 #define VPD_DEVID_ASSOC(_f) ((_f) & 0x30)
818 #define VPD_DEVID_ASSOC_LU 0x00
819 #define VPD_DEVID_ASSOC_PORT 0x10
820 #define VPD_DEVID_ASSOC_TARG 0x20
821 #define VPD_DEVID_TYPE(_f) ((_f) & 0x0f)
822 #define VPD_DEVID_TYPE_VENDOR 0x0
823 #define VPD_DEVID_TYPE_T10 0x1
824 #define VPD_DEVID_TYPE_EUI64 0x2
825 #define VPD_DEVID_TYPE_NAA 0x3
826 #define VPD_DEVID_TYPE_RELATIVE 0x4
827 #define VPD_DEVID_TYPE_PORT 0x5
828 #define VPD_DEVID_TYPE_LU 0x6
829 #define VPD_DEVID_TYPE_MD5 0x7
830 #define VPD_DEVID_TYPE_NAME 0x8
835 struct scsi_read_capacity
844 struct scsi_read_capacity_16
847 #define SRC16_SERVICE_ACTION 0x10
848 uint8_t service_action;
850 uint8_t alloc_len[4];
851 #define SRC16_PMI 0x01
852 #define SRC16_RELADR 0x02
857 struct scsi_read_capacity_data
863 struct scsi_read_capacity_data_16
867 u_int8_t p_type_prot;
868 u_int8_t logical_per_phys;
869 u_int8_t lowest_aligned[2];
870 u_int8_t reserved[16];
873 struct scsi_report_luns
877 #define RPL_REPORT_DEFAULT 0x00
878 #define RPL_REPORT_WELLKNOWN 0x01
879 #define RPL_REPORT_ALL 0x02
880 uint8_t select_report;
881 uint8_t reserved2[3];
887 struct scsi_report_luns_data {
888 u_int8_t length[4]; /* length of LUN inventory, in bytes */
889 u_int8_t reserved[4]; /* unused */
891 * LUN inventory- we only support the type zero form for now.
897 #define RPL_LUNDATA_PERIPH_BUS_MASK 0x3f
898 #define RPL_LUNDATA_FLAT_LUN_MASK 0x3f
899 #define RPL_LUNDATA_LUN_TARG_MASK 0x3f
900 #define RPL_LUNDATA_LUN_BUS_MASK 0xe0
901 #define RPL_LUNDATA_LUN_LUN_MASK 0x1f
902 #define RPL_LUNDATA_EXT_LEN_MASK 0x30
903 #define RPL_LUNDATA_EXT_EAM_MASK 0x0f
904 #define RPL_LUNDATA_EXT_EAM_WK 0x01
905 #define RPL_LUNDATA_EXT_EAM_NOT_SPEC 0x0f
906 #define RPL_LUNDATA_ATYP_MASK 0xc0 /* MBZ for type 0 lun */
907 #define RPL_LUNDATA_ATYP_PERIPH 0x00
908 #define RPL_LUNDATA_ATYP_FLAT 0x40
909 #define RPL_LUNDATA_ATYP_LUN 0x80
910 #define RPL_LUNDATA_ATYP_EXTLUN 0xc0
912 struct scsi_sense_data
915 #define SSD_ERRCODE 0x7F
916 #define SSD_CURRENT_ERROR 0x70
917 #define SSD_DEFERRED_ERROR 0x71
918 #define SSD_ERRCODE_VALID 0x80
922 #define SSD_KEY_NO_SENSE 0x00
923 #define SSD_KEY_RECOVERED_ERROR 0x01
924 #define SSD_KEY_NOT_READY 0x02
925 #define SSD_KEY_MEDIUM_ERROR 0x03
926 #define SSD_KEY_HARDWARE_ERROR 0x04
927 #define SSD_KEY_ILLEGAL_REQUEST 0x05
928 #define SSD_KEY_UNIT_ATTENTION 0x06
929 #define SSD_KEY_DATA_PROTECT 0x07
930 #define SSD_KEY_BLANK_CHECK 0x08
931 #define SSD_KEY_Vendor_Specific 0x09
932 #define SSD_KEY_COPY_ABORTED 0x0a
933 #define SSD_KEY_ABORTED_COMMAND 0x0b
934 #define SSD_KEY_EQUAL 0x0c
935 #define SSD_KEY_VOLUME_OVERFLOW 0x0d
936 #define SSD_KEY_MISCOMPARE 0x0e
937 #define SSD_KEY_RESERVED 0x0f
940 #define SSD_FILEMARK 0x80
943 u_int8_t cmd_spec_info[4];
944 u_int8_t add_sense_code;
945 u_int8_t add_sense_code_qual;
947 u_int8_t sense_key_spec[3];
948 #define SSD_SCS_VALID 0x80
949 #define SSD_FIELDPTR_CMD 0x40
950 #define SSD_BITPTR_VALID 0x08
951 #define SSD_BITPTR_VALUE 0x07
952 #define SSD_MIN_SIZE 18
953 u_int8_t extra_bytes[14];
954 #define SSD_FULL_SIZE sizeof(struct scsi_sense_data)
957 struct scsi_mode_header_6
959 u_int8_t data_length; /* Sense data length */
960 u_int8_t medium_type;
962 u_int8_t blk_desc_len;
965 struct scsi_mode_header_10
967 u_int8_t data_length[2];/* Sense data length */
968 u_int8_t medium_type;
971 u_int8_t blk_desc_len[2];
974 struct scsi_mode_page_header
977 u_int8_t page_length;
980 struct scsi_mode_blk_desc
988 #define SCSI_DEFAULT_DENSITY 0x00 /* use 'default' density */
989 #define SCSI_SAME_DENSITY 0x7f /* use 'same' density- >= SCSI-2 only */
995 #define SCSI_STATUS_OK 0x00
996 #define SCSI_STATUS_CHECK_COND 0x02
997 #define SCSI_STATUS_COND_MET 0x04
998 #define SCSI_STATUS_BUSY 0x08
999 #define SCSI_STATUS_INTERMED 0x10
1000 #define SCSI_STATUS_INTERMED_COND_MET 0x14
1001 #define SCSI_STATUS_RESERV_CONFLICT 0x18
1002 #define SCSI_STATUS_CMD_TERMINATED 0x22 /* Obsolete in SAM-2 */
1003 #define SCSI_STATUS_QUEUE_FULL 0x28
1004 #define SCSI_STATUS_ACA_ACTIVE 0x30
1005 #define SCSI_STATUS_TASK_ABORTED 0x40
1007 struct scsi_inquiry_pattern {
1009 u_int8_t media_type;
1010 #define SIP_MEDIA_REMOVABLE 0x01
1011 #define SIP_MEDIA_FIXED 0x02
1013 const char *product;
1014 const char *revision;
1017 struct scsi_static_inquiry_pattern {
1019 u_int8_t media_type;
1020 char vendor[SID_VENDOR_SIZE+1];
1021 char product[SID_PRODUCT_SIZE+1];
1022 char revision[SID_REVISION_SIZE+1];
1025 struct scsi_sense_quirk_entry {
1026 struct scsi_inquiry_pattern inq_pat;
1029 struct sense_key_table_entry *sense_key_info;
1030 struct asc_table_entry *asc_info;
1033 struct sense_key_table_entry {
1039 struct asc_table_entry {
1046 struct op_table_entry {
1052 struct scsi_op_quirk_entry {
1053 struct scsi_inquiry_pattern inq_pat;
1055 struct op_table_entry *op_table;
1059 SSS_FLAG_NONE = 0x00,
1060 SSS_FLAG_PRINT_COMMAND = 0x01
1061 } scsi_sense_string_flags;
1063 typedef union scsi_cdb {
1064 struct scsi_generic generic;
1065 struct scsi_sense sense;
1066 struct scsi_test_unit_ready test_unit_ready;
1067 struct scsi_send_diag send_diag;
1068 struct scsi_inquiry inquiry;
1069 struct scsi_mode_sense_6 mode_sense_6;
1070 struct scsi_mode_sense_10 mode_sense_10;
1071 struct scsi_mode_select_6 mode_select_6;
1072 struct scsi_mode_select_10 mode_select_10;
1073 struct scsi_log_sense log_sense;
1074 struct scsi_log_select log_select;
1075 struct scsi_reserve reserve;
1076 struct scsi_release release;
1077 struct scsi_prevent prevent;
1078 struct scsi_sync_cache sync_cache;
1079 struct scsi_changedef changedef;
1080 struct scsi_read_buffer read_buffer;
1081 struct scsi_write_buffer write_buffer;
1082 struct scsi_rw_6 rw_6;
1083 struct scsi_rw_10 rw_10;
1084 struct scsi_rw_12 rw_12;
1085 struct scsi_rw_16 rw_16;
1086 struct scsi_start_stop_unit start_stop_unit;
1087 struct ata_pass_12 ata_pass_12;
1088 struct ata_pass_16 ata_pass_16;
1089 struct scsi_read_capacity read_capacity;
1090 struct scsi_read_capacity_16 read_capacity_16;
1091 struct scsi_report_luns report_luns;
1094 typedef union scsi_data {
1095 struct scsi_mode_hdr_6 mode_hdr_6;
1096 struct scsi_mode_hdr_10 mode_hdr_10;
1097 struct scsi_mode_block_descr mode_block_descr;
1098 struct scsi_log_header log_header;
1099 struct scsi_log_param_header log_param_header;
1100 struct scsi_control_page control_page;
1101 struct scsi_cache_page cache_page;
1102 struct scsi_info_exceptions_page info_exceptions_page;
1103 struct scsi_proto_specific_page proto_specific_page;
1104 struct scsi_inquiry_data inquiry_data;
1105 struct scsi_vpd_supported_page_list vpd_supported_page_list;
1106 struct scsi_vpd_unit_serial_number vpd_unit_serial_number;
1107 struct scsi_vpd_unit_devid vpd_unit_devid;
1108 struct scsi_read_capacity_data read_capacity_data;
1109 struct scsi_read_capacity_data_16 read_capacity_data_16;
1110 struct scsi_report_luns_data report_luns_data;
1111 struct scsi_sense_data sense_data;
1112 struct scsi_mode_header_6 mode_header_6;
1113 struct scsi_mode_header_10 mode_header_10;
1114 struct scsi_mode_page_header mode_page_header;
1115 struct scsi_mode_blk_desc mode_blk_desc;
1116 struct scsi_inquiry_pattern inquiry_pattern;
1117 struct scsi_static_inquiry_pattern static_inquiry_pattern;
1127 extern const char *scsi_sense_key_text[];
1132 void scsi_sense_desc(int sense_key, int asc, int ascq,
1133 struct scsi_inquiry_data *inq_data,
1134 const char **sense_key_desc, const char **asc_desc);
1135 scsi_sense_action scsi_error_action(struct ccb_scsiio* csio,
1136 struct scsi_inquiry_data *inq_data,
1137 u_int32_t sense_flags);
1138 const char * scsi_status_string(struct ccb_scsiio *csio);
1140 int scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb);
1141 int scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb,
1142 scsi_sense_string_flags flags);
1143 char * scsi_sense_string(struct ccb_scsiio *csio,
1144 char *str, int str_len);
1145 void scsi_sense_print(struct ccb_scsiio *csio);
1146 int scsi_interpret_sense(union ccb *ccb,
1147 u_int32_t sense_flags,
1148 u_int32_t *relsim_flags,
1149 u_int32_t *reduction,
1151 scsi_sense_action error_action);
1153 int scsi_command_string(struct cam_device *device,
1154 struct ccb_scsiio *csio, struct sbuf *sb);
1155 int scsi_sense_sbuf(struct cam_device *device,
1156 struct ccb_scsiio *csio, struct sbuf *sb,
1157 scsi_sense_string_flags flags);
1158 char * scsi_sense_string(struct cam_device *device,
1159 struct ccb_scsiio *csio,
1160 char *str, int str_len);
1161 void scsi_sense_print(struct cam_device *device,
1162 struct ccb_scsiio *csio, FILE *ofile);
1163 int scsi_interpret_sense(struct cam_device *device,
1165 u_int32_t sense_flags,
1166 u_int32_t *relsim_flags,
1167 u_int32_t *reduction,
1169 scsi_sense_action error_action);
1170 #endif /* _KERNEL */
1172 #define SF_RETRY_UA 0x01
1173 #define SF_NO_PRINT 0x02
1174 #define SF_QUIET_IR 0x04 /* Be quiet about Illegal Request reponses */
1175 #define SF_PRINT_ALWAYS 0x08
1178 const char * scsi_op_desc(u_int16_t opcode,
1179 struct scsi_inquiry_data *inq_data);
1180 char * scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string,
1183 void scsi_print_inquiry(struct scsi_inquiry_data *inq_data);
1185 u_int scsi_calc_syncsrate(u_int period_factor);
1186 u_int scsi_calc_syncparam(u_int period);
1188 void scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries,
1189 void (*cbfcnp)(struct cam_periph *,
1191 u_int8_t tag_action,
1192 u_int8_t sense_len, u_int32_t timeout);
1194 void scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries,
1195 void (*cbfcnp)(struct cam_periph *,
1197 void *data_ptr, u_int8_t dxfer_len,
1198 u_int8_t tag_action, u_int8_t sense_len,
1201 #ifndef CAM_NO_SCSI_INQUIRY /* hack for cdparanoia */
1202 void scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries,
1203 void (*cbfcnp)(struct cam_periph *, union ccb *),
1204 u_int8_t tag_action, u_int8_t *inq_buf,
1205 u_int32_t inq_len, int evpd, u_int8_t page_code,
1206 u_int8_t sense_len, u_int32_t timeout);
1209 void scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries,
1210 void (*cbfcnp)(struct cam_periph *,
1212 u_int8_t tag_action, int dbd,
1213 u_int8_t page_code, u_int8_t page,
1214 u_int8_t *param_buf, u_int32_t param_len,
1215 u_int8_t sense_len, u_int32_t timeout);
1216 void scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries,
1217 void (*cbfcnp)(struct cam_periph *,
1219 u_int8_t tag_action, int dbd,
1220 u_int8_t page_code, u_int8_t page,
1221 u_int8_t *param_buf, u_int32_t param_len,
1222 int minimum_cmd_size, u_int8_t sense_len,
1225 void scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries,
1226 void (*cbfcnp)(struct cam_periph *,
1228 u_int8_t tag_action, int scsi_page_fmt,
1229 int save_pages, u_int8_t *param_buf,
1230 u_int32_t param_len, u_int8_t sense_len,
1233 void scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries,
1234 void (*cbfcnp)(struct cam_periph *,
1236 u_int8_t tag_action, int scsi_page_fmt,
1237 int save_pages, u_int8_t *param_buf,
1238 u_int32_t param_len, int minimum_cmd_size,
1239 u_int8_t sense_len, u_int32_t timeout);
1241 void scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries,
1242 void (*cbfcnp)(struct cam_periph *, union ccb *),
1243 u_int8_t tag_action, u_int8_t page_code,
1244 u_int8_t page, int save_pages, int ppc,
1245 u_int32_t paramptr, u_int8_t *param_buf,
1246 u_int32_t param_len, u_int8_t sense_len,
1249 void scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries,
1250 void (*cbfcnp)(struct cam_periph *,
1251 union ccb *), u_int8_t tag_action,
1252 u_int8_t page_code, int save_pages,
1253 int pc_reset, u_int8_t *param_buf,
1254 u_int32_t param_len, u_int8_t sense_len,
1257 void scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries,
1258 void (*cbfcnp)(struct cam_periph *, union ccb *),
1259 u_int8_t tag_action, u_int8_t action,
1260 u_int8_t sense_len, u_int32_t timeout);
1262 void scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries,
1263 void (*cbfcnp)(struct cam_periph *,
1264 union ccb *), u_int8_t tag_action,
1265 struct scsi_read_capacity_data *,
1266 u_int8_t sense_len, u_int32_t timeout);
1267 void scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries,
1268 void (*cbfcnp)(struct cam_periph *,
1269 union ccb *), uint8_t tag_action,
1270 uint64_t lba, int reladr, int pmi,
1271 struct scsi_read_capacity_data_16
1272 *rcap_buf, uint8_t sense_len,
1275 void scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries,
1276 void (*cbfcnp)(struct cam_periph *,
1277 union ccb *), u_int8_t tag_action,
1278 u_int8_t select_report,
1279 struct scsi_report_luns_data *rpl_buf,
1280 u_int32_t alloc_len, u_int8_t sense_len,
1283 void scsi_synchronize_cache(struct ccb_scsiio *csio,
1285 void (*cbfcnp)(struct cam_periph *,
1286 union ccb *), u_int8_t tag_action,
1287 u_int32_t begin_lba, u_int16_t lb_count,
1288 u_int8_t sense_len, u_int32_t timeout);
1290 void scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries,
1291 void (*cbfcnp)(struct cam_periph *, union ccb *),
1292 u_int8_t tag_action, int readop, u_int8_t byte2,
1293 int minimum_cmd_size, u_int64_t lba,
1294 u_int32_t block_count, u_int8_t *data_ptr,
1295 u_int32_t dxfer_len, u_int8_t sense_len,
1298 void scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries,
1299 void (*cbfcnp)(struct cam_periph *, union ccb *),
1300 u_int8_t tag_action, int start, int load_eject,
1301 int immediate, u_int8_t sense_len, u_int32_t timeout);
1303 int scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry);
1304 int scsi_static_inquiry_match(caddr_t inqbuffer,
1305 caddr_t table_entry);
1307 static __inline void scsi_extract_sense(struct scsi_sense_data *sense,
1308 int *error_code, int *sense_key,
1309 int *asc, int *ascq);
1310 static __inline void scsi_ulto2b(u_int32_t val, u_int8_t *bytes);
1311 static __inline void scsi_ulto3b(u_int32_t val, u_int8_t *bytes);
1312 static __inline void scsi_ulto4b(u_int32_t val, u_int8_t *bytes);
1313 static __inline void scsi_u64to8b(u_int64_t val, u_int8_t *bytes);
1314 static __inline u_int32_t scsi_2btoul(u_int8_t *bytes);
1315 static __inline u_int32_t scsi_3btoul(u_int8_t *bytes);
1316 static __inline int32_t scsi_3btol(u_int8_t *bytes);
1317 static __inline u_int32_t scsi_4btoul(u_int8_t *bytes);
1318 static __inline u_int64_t scsi_8btou64(u_int8_t *bytes);
1319 static __inline void *find_mode_page_6(struct scsi_mode_header_6 *mode_header);
1320 static __inline void *find_mode_page_10(struct scsi_mode_header_10 *mode_header);
1322 static __inline void
1323 scsi_extract_sense(struct scsi_sense_data *sense, int *error_code,
1324 int *sense_key, int *asc, int *ascq)
1326 *error_code = sense->error_code & SSD_ERRCODE;
1327 *sense_key = sense->flags & SSD_KEY;
1328 *asc = (sense->extra_len >= 5) ? sense->add_sense_code : 0;
1329 *ascq = (sense->extra_len >= 6) ? sense->add_sense_code_qual : 0;
1332 static __inline void
1333 scsi_ulto2b(u_int32_t val, u_int8_t *bytes)
1336 bytes[0] = (val >> 8) & 0xff;
1337 bytes[1] = val & 0xff;
1340 static __inline void
1341 scsi_ulto3b(u_int32_t val, u_int8_t *bytes)
1344 bytes[0] = (val >> 16) & 0xff;
1345 bytes[1] = (val >> 8) & 0xff;
1346 bytes[2] = val & 0xff;
1349 static __inline void
1350 scsi_ulto4b(u_int32_t val, u_int8_t *bytes)
1353 bytes[0] = (val >> 24) & 0xff;
1354 bytes[1] = (val >> 16) & 0xff;
1355 bytes[2] = (val >> 8) & 0xff;
1356 bytes[3] = val & 0xff;
1359 static __inline void
1360 scsi_u64to8b(u_int64_t val, u_int8_t *bytes)
1362 bytes[0] = (val >> 56) & 0xff;
1363 bytes[1] = (val >> 48) & 0xff;
1364 bytes[2] = (val >> 40) & 0xff;
1365 bytes[3] = (val >> 32) & 0xff;
1366 bytes[4] = (val >> 24) & 0xff;
1367 bytes[5] = (val >> 16) & 0xff;
1368 bytes[6] = (val >> 8) & 0xff;
1369 bytes[7] = val & 0xff;
1372 static __inline u_int32_t
1373 scsi_2btoul(u_int8_t *bytes)
1377 rv = (bytes[0] << 8) |
1382 static __inline uint64_t
1383 scsi_8btou64(uint8_t *bytes)
1387 rv = (((uint64_t)bytes[0]) << 56) |
1388 (((uint64_t)bytes[1]) << 48) |
1389 (((uint64_t)bytes[2]) << 40) |
1390 (((uint64_t)bytes[3]) << 32) |
1391 (((uint64_t)bytes[4]) << 24) |
1392 (((uint64_t)bytes[5]) << 16) |
1393 (((uint64_t)bytes[6]) << 8) |
1398 static __inline u_int32_t
1399 scsi_3btoul(u_int8_t *bytes)
1403 rv = (bytes[0] << 16) |
1409 static __inline int32_t
1410 scsi_3btol(u_int8_t *bytes)
1412 u_int32_t rc = scsi_3btoul(bytes);
1414 if (rc & 0x00800000)
1417 return (int32_t) rc;
1420 static __inline u_int32_t
1421 scsi_4btoul(u_int8_t *bytes)
1425 rv = (bytes[0] << 24) |
1433 * Given the pointer to a returned mode sense buffer, return a pointer to
1434 * the start of the first mode page.
1436 static __inline void *
1437 find_mode_page_6(struct scsi_mode_header_6 *mode_header)
1441 page_start = (void *)((u_int8_t *)&mode_header[1] +
1442 mode_header->blk_desc_len);
1447 static __inline void *
1448 find_mode_page_10(struct scsi_mode_header_10 *mode_header)
1452 page_start = (void *)((u_int8_t *)&mode_header[1] +
1453 scsi_2btoul(mode_header->blk_desc_len));
1460 #endif /*_SCSI_SCSI_ALL_H*/