1 /*- 2 * Largely written by Julian Elischer (julian@tfs.com) 3 * for TRW Financial Systems. 4 * 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. 10 * 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. 14 * 15 * Ported to run under 386BSD by Julian Elischer (julian@tfs.com) Sept 1992 16 * 17 * $FreeBSD$ 18 */ 19 20 /* 21 * SCSI general interface description 22 */ 23 24 #ifndef _SCSI_SCSI_ALL_H 25 #define _SCSI_SCSI_ALL_H 1 26 27 #include <sys/cdefs.h> 28 #include <machine/stdarg.h> 29 30 #ifdef _KERNEL 31 /* 32 * This is the number of seconds we wait for devices to settle after a SCSI 33 * bus reset. 34 */ 35 extern int scsi_delay; 36 #endif /* _KERNEL */ 37 38 /* 39 * SCSI command format 40 */ 41 42 /* 43 * Define dome bits that are in ALL (or a lot of) scsi commands 44 */ 45 #define SCSI_CTL_LINK 0x01 46 #define SCSI_CTL_FLAG 0x02 47 #define SCSI_CTL_VENDOR 0xC0 48 #define SCSI_CMD_LUN 0xA0 /* these two should not be needed */ 49 #define SCSI_CMD_LUN_SHIFT 5 /* LUN in the cmd is no longer SCSI */ 50 51 #define SCSI_MAX_CDBLEN 16 /* 52 * 16 byte commands are in the 53 * SCSI-3 spec 54 */ 55 #if defined(CAM_MAX_CDBLEN) && (CAM_MAX_CDBLEN < SCSI_MAX_CDBLEN) 56 #error "CAM_MAX_CDBLEN cannot be less than SCSI_MAX_CDBLEN" 57 #endif 58 59 /* 6byte CDBs special case 0 length to be 256 */ 60 #define SCSI_CDB6_LEN(len) ((len) == 0 ? 256 : len) 61 62 /* 63 * This type defines actions to be taken when a particular sense code is 64 * received. Right now, these flags are only defined to take up 16 bits, 65 * but can be expanded in the future if necessary. 66 */ 67 typedef enum { 68 SS_NOP = 0x000000, /* Do nothing */ 69 SS_RETRY = 0x010000, /* Retry the command */ 70 SS_FAIL = 0x020000, /* Bail out */ 71 SS_START = 0x030000, /* Send a Start Unit command to the device, 72 * then retry the original command. 73 */ 74 SS_TUR = 0x040000, /* Send a Test Unit Ready command to the 75 * device, then retry the original command. 76 */ 77 SS_REQSENSE = 0x050000, /* Send a RequestSense command to the 78 * device, then retry the original command. 79 */ 80 SS_MASK = 0xff0000 81 } scsi_sense_action; 82 83 typedef enum { 84 SSQ_NONE = 0x0000, 85 SSQ_DECREMENT_COUNT = 0x0100, /* Decrement the retry count */ 86 SSQ_MANY = 0x0200, /* send lots of recovery commands */ 87 SSQ_RANGE = 0x0400, /* 88 * This table entry represents the 89 * end of a range of ASCQs that 90 * have identical error actions 91 * and text. 92 */ 93 SSQ_PRINT_SENSE = 0x0800, 94 SSQ_MASK = 0xff00 95 } scsi_sense_action_qualifier; 96 97 /* Mask for error status values */ 98 #define SS_ERRMASK 0xff 99 100 /* The default, retyable, error action */ 101 #define SS_RDEF SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE|EIO 102 103 /* The retyable, error action, with table specified error code */ 104 #define SS_RET SS_RETRY|SSQ_DECREMENT_COUNT|SSQ_PRINT_SENSE 105 106 /* Fatal error action, with table specified error code */ 107 #define SS_FATAL SS_FAIL|SSQ_PRINT_SENSE 108 109 struct scsi_generic 110 { 111 u_int8_t opcode; 112 u_int8_t bytes[11]; 113 }; 114 115 struct scsi_request_sense 116 { 117 u_int8_t opcode; 118 u_int8_t byte2; 119 #define SRS_DESC 0x01 120 u_int8_t unused[2]; 121 u_int8_t length; 122 u_int8_t control; 123 }; 124 125 struct scsi_test_unit_ready 126 { 127 u_int8_t opcode; 128 u_int8_t byte2; 129 u_int8_t unused[3]; 130 u_int8_t control; 131 }; 132 133 struct scsi_receive_diag { 134 uint8_t opcode; 135 uint8_t byte2; 136 #define SRD_PCV 0x01 137 uint8_t page_code; 138 uint8_t length[2]; 139 uint8_t control; 140 }; 141 142 struct scsi_send_diag { 143 uint8_t opcode; 144 uint8_t byte2; 145 #define SSD_UNITOFFL 0x01 146 #define SSD_DEVOFFL 0x02 147 #define SSD_SELFTEST 0x04 148 #define SSD_PF 0x10 149 #define SSD_SELF_TEST_CODE_MASK 0xE0 150 #define SSD_SELF_TEST_CODE_SHIFT 5 151 #define SSD_SELF_TEST_CODE_NONE 0x00 152 #define SSD_SELF_TEST_CODE_BG_SHORT 0x01 153 #define SSD_SELF_TEST_CODE_BG_EXTENDED 0x02 154 #define SSD_SELF_TEST_CODE_BG_ABORT 0x04 155 #define SSD_SELF_TEST_CODE_FG_SHORT 0x05 156 #define SSD_SELF_TEST_CODE_FG_EXTENDED 0x06 157 uint8_t reserved; 158 uint8_t length[2]; 159 uint8_t control; 160 }; 161 162 struct scsi_sense 163 { 164 u_int8_t opcode; 165 u_int8_t byte2; 166 u_int8_t unused[2]; 167 u_int8_t length; 168 u_int8_t control; 169 }; 170 171 struct scsi_inquiry 172 { 173 u_int8_t opcode; 174 u_int8_t byte2; 175 #define SI_EVPD 0x01 176 #define SI_CMDDT 0x02 177 u_int8_t page_code; 178 u_int8_t reserved; 179 u_int8_t length; 180 u_int8_t control; 181 }; 182 183 struct scsi_mode_sense_6 184 { 185 u_int8_t opcode; 186 u_int8_t byte2; 187 #define SMS_DBD 0x08 188 u_int8_t page; 189 #define SMS_PAGE_CODE 0x3F 190 #define SMS_VENDOR_SPECIFIC_PAGE 0x00 191 #define SMS_DISCONNECT_RECONNECT_PAGE 0x02 192 #define SMS_FORMAT_DEVICE_PAGE 0x03 193 #define SMS_GEOMETRY_PAGE 0x04 194 #define SMS_CACHE_PAGE 0x08 195 #define SMS_PERIPHERAL_DEVICE_PAGE 0x09 196 #define SMS_CONTROL_MODE_PAGE 0x0A 197 #define SMS_PROTO_SPECIFIC_PAGE 0x19 198 #define SMS_INFO_EXCEPTIONS_PAGE 0x1C 199 #define SMS_ALL_PAGES_PAGE 0x3F 200 #define SMS_PAGE_CTRL_MASK 0xC0 201 #define SMS_PAGE_CTRL_CURRENT 0x00 202 #define SMS_PAGE_CTRL_CHANGEABLE 0x40 203 #define SMS_PAGE_CTRL_DEFAULT 0x80 204 #define SMS_PAGE_CTRL_SAVED 0xC0 205 u_int8_t subpage; 206 #define SMS_SUBPAGE_PAGE_0 0x00 207 #define SMS_SUBPAGE_ALL 0xff 208 u_int8_t length; 209 u_int8_t control; 210 }; 211 212 struct scsi_mode_sense_10 213 { 214 u_int8_t opcode; 215 u_int8_t byte2; /* same bits as small version */ 216 #define SMS10_LLBAA 0x10 217 u_int8_t page; /* same bits as small version */ 218 u_int8_t subpage; 219 u_int8_t unused[3]; 220 u_int8_t length[2]; 221 u_int8_t control; 222 }; 223 224 struct scsi_mode_select_6 225 { 226 u_int8_t opcode; 227 u_int8_t byte2; 228 #define SMS_SP 0x01 229 #define SMS_PF 0x10 230 u_int8_t unused[2]; 231 u_int8_t length; 232 u_int8_t control; 233 }; 234 235 struct scsi_mode_select_10 236 { 237 u_int8_t opcode; 238 u_int8_t byte2; /* same bits as small version */ 239 u_int8_t unused[5]; 240 u_int8_t length[2]; 241 u_int8_t control; 242 }; 243 244 /* 245 * When sending a mode select to a tape drive, the medium type must be 0. 246 */ 247 struct scsi_mode_hdr_6 248 { 249 u_int8_t datalen; 250 u_int8_t medium_type; 251 u_int8_t dev_specific; 252 u_int8_t block_descr_len; 253 }; 254 255 struct scsi_mode_hdr_10 256 { 257 u_int8_t datalen[2]; 258 u_int8_t medium_type; 259 u_int8_t dev_specific; 260 u_int8_t reserved[2]; 261 u_int8_t block_descr_len[2]; 262 }; 263 264 struct scsi_mode_block_descr 265 { 266 u_int8_t density_code; 267 u_int8_t num_blocks[3]; 268 u_int8_t reserved; 269 u_int8_t block_len[3]; 270 }; 271 272 struct scsi_per_res_in 273 { 274 u_int8_t opcode; 275 u_int8_t action; 276 #define SPRI_RK 0x00 277 #define SPRI_RR 0x01 278 #define SPRI_RC 0x02 279 #define SPRI_RS 0x03 280 u_int8_t reserved[5]; 281 u_int8_t length[2]; 282 u_int8_t control; 283 }; 284 285 struct scsi_per_res_in_header 286 { 287 u_int8_t generation[4]; 288 u_int8_t length[4]; 289 }; 290 291 struct scsi_per_res_key 292 { 293 u_int8_t key[8]; 294 }; 295 296 struct scsi_per_res_in_keys 297 { 298 struct scsi_per_res_in_header header; 299 struct scsi_per_res_key keys[0]; 300 }; 301 302 struct scsi_per_res_cap 303 { 304 uint8_t length[2]; 305 uint8_t flags1; 306 #define SPRI_CRH 0x10 307 #define SPRI_SIP_C 0x08 308 #define SPRI_ATP_C 0x04 309 #define SPRI_PTPL_C 0x01 310 uint8_t flags2; 311 #define SPRI_TMV 0x80 312 #define SPRI_PTPL_A 0x01 313 uint8_t type_mask[2]; 314 #define SPRI_TM_WR_EX_AR 0x8000 315 #define SPRI_TM_EX_AC_RO 0x4000 316 #define SPRI_TM_WR_EX_RO 0x2000 317 #define SPRI_TM_EX_AC 0x0800 318 #define SPRI_TM_WR_EX 0x0200 319 #define SPRI_TM_EX_AC_AR 0x0001 320 uint8_t reserved[2]; 321 }; 322 323 struct scsi_per_res_in_rsrv_data 324 { 325 uint8_t reservation[8]; 326 uint8_t obsolete1[4]; 327 uint8_t reserved; 328 uint8_t scopetype; 329 #define SPRT_WE 0x01 330 #define SPRT_EA 0x03 331 #define SPRT_WERO 0x05 332 #define SPRT_EARO 0x06 333 #define SPRT_WEAR 0x07 334 #define SPRT_EAAR 0x08 335 uint8_t obsolete2[2]; 336 }; 337 338 struct scsi_per_res_in_rsrv 339 { 340 struct scsi_per_res_in_header header; 341 struct scsi_per_res_in_rsrv_data data; 342 }; 343 344 struct scsi_per_res_out 345 { 346 u_int8_t opcode; 347 u_int8_t action; 348 #define SPRO_REGISTER 0x00 349 #define SPRO_RESERVE 0x01 350 #define SPRO_RELEASE 0x02 351 #define SPRO_CLEAR 0x03 352 #define SPRO_PREEMPT 0x04 353 #define SPRO_PRE_ABO 0x05 354 #define SPRO_REG_IGNO 0x06 355 #define SPRO_REG_MOVE 0x07 356 #define SPRO_ACTION_MASK 0x1f 357 u_int8_t scope_type; 358 #define SPR_SCOPE_MASK 0xf0 359 #define SPR_LU_SCOPE 0x00 360 #define SPR_TYPE_MASK 0x0f 361 #define SPR_TYPE_WR_EX 0x01 362 #define SPR_TYPE_EX_AC 0x03 363 #define SPR_TYPE_WR_EX_RO 0x05 364 #define SPR_TYPE_EX_AC_RO 0x06 365 #define SPR_TYPE_WR_EX_AR 0x07 366 #define SPR_TYPE_EX_AC_AR 0x08 367 u_int8_t reserved[2]; 368 u_int8_t length[4]; 369 u_int8_t control; 370 }; 371 372 struct scsi_per_res_out_parms 373 { 374 struct scsi_per_res_key res_key; 375 u_int8_t serv_act_res_key[8]; 376 u_int8_t obsolete1[4]; 377 u_int8_t flags; 378 #define SPR_SPEC_I_PT 0x08 379 #define SPR_ALL_TG_PT 0x04 380 #define SPR_APTPL 0x01 381 u_int8_t reserved1; 382 u_int8_t obsolete2[2]; 383 }; 384 385 386 struct scsi_log_sense 387 { 388 u_int8_t opcode; 389 u_int8_t byte2; 390 #define SLS_SP 0x01 391 #define SLS_PPC 0x02 392 u_int8_t page; 393 #define SLS_PAGE_CODE 0x3F 394 #define SLS_ALL_PAGES_PAGE 0x00 395 #define SLS_OVERRUN_PAGE 0x01 396 #define SLS_ERROR_WRITE_PAGE 0x02 397 #define SLS_ERROR_READ_PAGE 0x03 398 #define SLS_ERROR_READREVERSE_PAGE 0x04 399 #define SLS_ERROR_VERIFY_PAGE 0x05 400 #define SLS_ERROR_NONMEDIUM_PAGE 0x06 401 #define SLS_ERROR_LASTN_PAGE 0x07 402 #define SLS_SELF_TEST_PAGE 0x10 403 #define SLS_IE_PAGE 0x2f 404 #define SLS_PAGE_CTRL_MASK 0xC0 405 #define SLS_PAGE_CTRL_THRESHOLD 0x00 406 #define SLS_PAGE_CTRL_CUMULATIVE 0x40 407 #define SLS_PAGE_CTRL_THRESH_DEFAULT 0x80 408 #define SLS_PAGE_CTRL_CUMUL_DEFAULT 0xC0 409 u_int8_t reserved[2]; 410 u_int8_t paramptr[2]; 411 u_int8_t length[2]; 412 u_int8_t control; 413 }; 414 415 struct scsi_log_select 416 { 417 u_int8_t opcode; 418 u_int8_t byte2; 419 /* SLS_SP 0x01 */ 420 #define SLS_PCR 0x02 421 u_int8_t page; 422 /* SLS_PAGE_CTRL_MASK 0xC0 */ 423 /* SLS_PAGE_CTRL_THRESHOLD 0x00 */ 424 /* SLS_PAGE_CTRL_CUMULATIVE 0x40 */ 425 /* SLS_PAGE_CTRL_THRESH_DEFAULT 0x80 */ 426 /* SLS_PAGE_CTRL_CUMUL_DEFAULT 0xC0 */ 427 u_int8_t reserved[4]; 428 u_int8_t length[2]; 429 u_int8_t control; 430 }; 431 432 struct scsi_log_header 433 { 434 u_int8_t page; 435 u_int8_t reserved; 436 u_int8_t datalen[2]; 437 }; 438 439 struct scsi_log_param_header { 440 u_int8_t param_code[2]; 441 u_int8_t param_control; 442 #define SLP_LP 0x01 443 #define SLP_LBIN 0x02 444 #define SLP_TMC_MASK 0x0C 445 #define SLP_TMC_ALWAYS 0x00 446 #define SLP_TMC_EQUAL 0x04 447 #define SLP_TMC_NOTEQUAL 0x08 448 #define SLP_TMC_GREATER 0x0C 449 #define SLP_ETC 0x10 450 #define SLP_TSD 0x20 451 #define SLP_DS 0x40 452 #define SLP_DU 0x80 453 u_int8_t param_len; 454 }; 455 456 struct scsi_control_page { 457 u_int8_t page_code; 458 u_int8_t page_length; 459 u_int8_t rlec; 460 #define SCP_RLEC 0x01 /*Report Log Exception Cond*/ 461 #define SCP_GLTSD 0x02 /*Global Logging target 462 save disable */ 463 #define SCP_DSENSE 0x04 /*Descriptor Sense */ 464 #define SCP_DPICZ 0x08 /*Disable Prot. Info Check 465 if Prot. Field is Zero */ 466 #define SCP_TMF_ONLY 0x10 /*TM Functions Only*/ 467 #define SCP_TST_MASK 0xE0 /*Task Set Type Mask*/ 468 #define SCP_TST_ONE 0x00 /*One Task Set*/ 469 #define SCP_TST_SEPARATE 0x20 /*Separate Task Sets*/ 470 u_int8_t queue_flags; 471 #define SCP_QUEUE_ALG_MASK 0xF0 472 #define SCP_QUEUE_ALG_RESTRICTED 0x00 473 #define SCP_QUEUE_ALG_UNRESTRICTED 0x10 474 #define SCP_QUEUE_ERR 0x02 /*Queued I/O aborted for CACs*/ 475 #define SCP_QUEUE_DQUE 0x01 /*Queued I/O disabled*/ 476 u_int8_t eca_and_aen; 477 #define SCP_EECA 0x80 /*Enable Extended CA*/ 478 #define SCP_RAENP 0x04 /*Ready AEN Permission*/ 479 #define SCP_UAAENP 0x02 /*UA AEN Permission*/ 480 #define SCP_EAENP 0x01 /*Error AEN Permission*/ 481 u_int8_t reserved; 482 u_int8_t aen_holdoff_period[2]; 483 }; 484 485 struct scsi_cache_page { 486 u_int8_t page_code; 487 #define SCHP_PAGE_SAVABLE 0x80 /* Page is savable */ 488 u_int8_t page_length; 489 u_int8_t cache_flags; 490 #define SCHP_FLAGS_WCE 0x04 /* Write Cache Enable */ 491 #define SCHP_FLAGS_MF 0x02 /* Multiplication factor */ 492 #define SCHP_FLAGS_RCD 0x01 /* Read Cache Disable */ 493 u_int8_t rw_cache_policy; 494 u_int8_t dis_prefetch[2]; 495 u_int8_t min_prefetch[2]; 496 u_int8_t max_prefetch[2]; 497 u_int8_t max_prefetch_ceil[2]; 498 }; 499 500 /* 501 * XXX KDM 502 * Updated version of the cache page, as of SBC. Update this to SBC-3 and 503 * rationalize the two. 504 */ 505 struct scsi_caching_page { 506 uint8_t page_code; 507 #define SMS_CACHING_PAGE 0x08 508 uint8_t page_length; 509 uint8_t flags1; 510 #define SCP_IC 0x80 511 #define SCP_ABPF 0x40 512 #define SCP_CAP 0x20 513 #define SCP_DISC 0x10 514 #define SCP_SIZE 0x08 515 #define SCP_WCE 0x04 516 #define SCP_MF 0x02 517 #define SCP_RCD 0x01 518 uint8_t ret_priority; 519 uint8_t disable_pf_transfer_len[2]; 520 uint8_t min_prefetch[2]; 521 uint8_t max_prefetch[2]; 522 uint8_t max_pf_ceiling[2]; 523 uint8_t flags2; 524 #define SCP_FSW 0x80 525 #define SCP_LBCSS 0x40 526 #define SCP_DRA 0x20 527 #define SCP_VS1 0x10 528 #define SCP_VS2 0x08 529 uint8_t cache_segments; 530 uint8_t cache_seg_size[2]; 531 uint8_t reserved; 532 uint8_t non_cache_seg_size[3]; 533 }; 534 535 struct scsi_info_exceptions_page { 536 u_int8_t page_code; 537 #define SIEP_PAGE_SAVABLE 0x80 /* Page is savable */ 538 u_int8_t page_length; 539 u_int8_t info_flags; 540 #define SIEP_FLAGS_PERF 0x80 541 #define SIEP_FLAGS_EBF 0x20 542 #define SIEP_FLAGS_EWASC 0x10 543 #define SIEP_FLAGS_DEXCPT 0x08 544 #define SIEP_FLAGS_TEST 0x04 545 #define SIEP_FLAGS_EBACKERR 0x02 546 #define SIEP_FLAGS_LOGERR 0x01 547 u_int8_t mrie; 548 u_int8_t interval_timer[4]; 549 u_int8_t report_count[4]; 550 }; 551 552 struct scsi_proto_specific_page { 553 u_int8_t page_code; 554 #define SPSP_PAGE_SAVABLE 0x80 /* Page is savable */ 555 u_int8_t page_length; 556 u_int8_t protocol; 557 #define SPSP_PROTO_FC 0x00 558 #define SPSP_PROTO_SPI 0x01 559 #define SPSP_PROTO_SSA 0x02 560 #define SPSP_PROTO_1394 0x03 561 #define SPSP_PROTO_RDMA 0x04 562 #define SPSP_PROTO_ISCSI 0x05 563 #define SPSP_PROTO_SAS 0x06 564 #define SPSP_PROTO_ADT 0x07 565 #define SPSP_PROTO_ATA 0x08 566 #define SPSP_PROTO_NONE 0x0f 567 }; 568 569 struct scsi_reserve 570 { 571 u_int8_t opcode; 572 u_int8_t byte2; 573 #define SR_EXTENT 0x01 574 #define SR_ID_MASK 0x0e 575 #define SR_3RDPTY 0x10 576 #define SR_LUN_MASK 0xe0 577 u_int8_t resv_id; 578 u_int8_t length[2]; 579 u_int8_t control; 580 }; 581 582 struct scsi_reserve_10 { 583 uint8_t opcode; 584 uint8_t byte2; 585 #define SR10_3RDPTY 0x10 586 #define SR10_LONGID 0x02 587 #define SR10_EXTENT 0x01 588 uint8_t resv_id; 589 uint8_t thirdparty_id; 590 uint8_t reserved[3]; 591 uint8_t length[2]; 592 uint8_t control; 593 }; 594 595 596 struct scsi_release 597 { 598 u_int8_t opcode; 599 u_int8_t byte2; 600 u_int8_t resv_id; 601 u_int8_t unused[1]; 602 u_int8_t length; 603 u_int8_t control; 604 }; 605 606 struct scsi_release_10 { 607 uint8_t opcode; 608 uint8_t byte2; 609 uint8_t resv_id; 610 uint8_t thirdparty_id; 611 uint8_t reserved[3]; 612 uint8_t length[2]; 613 uint8_t control; 614 }; 615 616 struct scsi_prevent 617 { 618 u_int8_t opcode; 619 u_int8_t byte2; 620 u_int8_t unused[2]; 621 u_int8_t how; 622 u_int8_t control; 623 }; 624 #define PR_PREVENT 0x01 625 #define PR_ALLOW 0x00 626 627 struct scsi_sync_cache 628 { 629 u_int8_t opcode; 630 u_int8_t byte2; 631 #define SSC_IMMED 0x02 632 #define SSC_RELADR 0x01 633 u_int8_t begin_lba[4]; 634 u_int8_t reserved; 635 u_int8_t lb_count[2]; 636 u_int8_t control; 637 }; 638 639 struct scsi_sync_cache_16 640 { 641 uint8_t opcode; 642 uint8_t byte2; 643 uint8_t begin_lba[8]; 644 uint8_t lb_count[4]; 645 uint8_t reserved; 646 uint8_t control; 647 }; 648 649 struct scsi_format { 650 uint8_t opcode; 651 uint8_t byte2; 652 #define SF_LONGLIST 0x20 653 #define SF_FMTDATA 0x10 654 #define SF_CMPLIST 0x08 655 #define SF_FORMAT_MASK 0x07 656 #define SF_FORMAT_BLOCK 0x00 657 #define SF_FORMAT_LONG_BLOCK 0x03 658 #define SF_FORMAT_BFI 0x04 659 #define SF_FORMAT_PHYS 0x05 660 uint8_t vendor; 661 uint8_t interleave[2]; 662 uint8_t control; 663 }; 664 665 struct scsi_format_header_short { 666 uint8_t reserved; 667 #define SF_DATA_FOV 0x80 668 #define SF_DATA_DPRY 0x40 669 #define SF_DATA_DCRT 0x20 670 #define SF_DATA_STPF 0x10 671 #define SF_DATA_IP 0x08 672 #define SF_DATA_DSP 0x04 673 #define SF_DATA_IMMED 0x02 674 #define SF_DATA_VS 0x01 675 uint8_t byte2; 676 uint8_t defect_list_len[2]; 677 }; 678 679 struct scsi_format_header_long { 680 uint8_t reserved; 681 uint8_t byte2; 682 uint8_t reserved2[2]; 683 uint8_t defect_list_len[4]; 684 }; 685 686 struct scsi_changedef 687 { 688 u_int8_t opcode; 689 u_int8_t byte2; 690 u_int8_t unused1; 691 u_int8_t how; 692 u_int8_t unused[4]; 693 u_int8_t datalen; 694 u_int8_t control; 695 }; 696 697 struct scsi_read_buffer 698 { 699 u_int8_t opcode; 700 u_int8_t byte2; 701 #define RWB_MODE 0x07 702 #define RWB_MODE_HDR_DATA 0x00 703 #define RWB_MODE_VENDOR 0x01 704 #define RWB_MODE_DATA 0x02 705 #define RWB_MODE_DOWNLOAD 0x04 706 #define RWB_MODE_DOWNLOAD_SAVE 0x05 707 u_int8_t buffer_id; 708 u_int8_t offset[3]; 709 u_int8_t length[3]; 710 u_int8_t control; 711 }; 712 713 struct scsi_write_buffer 714 { 715 u_int8_t opcode; 716 u_int8_t byte2; 717 u_int8_t buffer_id; 718 u_int8_t offset[3]; 719 u_int8_t length[3]; 720 u_int8_t control; 721 }; 722 723 struct scsi_rw_6 724 { 725 u_int8_t opcode; 726 u_int8_t addr[3]; 727 /* only 5 bits are valid in the MSB address byte */ 728 #define SRW_TOPADDR 0x1F 729 u_int8_t length; 730 u_int8_t control; 731 }; 732 733 struct scsi_rw_10 734 { 735 u_int8_t opcode; 736 #define SRW10_RELADDR 0x01 737 /* EBP defined for WRITE(10) only */ 738 #define SRW10_EBP 0x04 739 #define SRW10_FUA 0x08 740 #define SRW10_DPO 0x10 741 u_int8_t byte2; 742 u_int8_t addr[4]; 743 u_int8_t reserved; 744 u_int8_t length[2]; 745 u_int8_t control; 746 }; 747 748 struct scsi_rw_12 749 { 750 u_int8_t opcode; 751 #define SRW12_RELADDR 0x01 752 #define SRW12_FUA 0x08 753 #define SRW12_DPO 0x10 754 u_int8_t byte2; 755 u_int8_t addr[4]; 756 u_int8_t length[4]; 757 u_int8_t reserved; 758 u_int8_t control; 759 }; 760 761 struct scsi_rw_16 762 { 763 u_int8_t opcode; 764 #define SRW16_RELADDR 0x01 765 #define SRW16_FUA 0x08 766 #define SRW16_DPO 0x10 767 u_int8_t byte2; 768 u_int8_t addr[8]; 769 u_int8_t length[4]; 770 u_int8_t reserved; 771 u_int8_t control; 772 }; 773 774 struct scsi_write_verify_10 775 { 776 uint8_t opcode; 777 uint8_t byte2; 778 #define SWV_BYTCHK 0x02 779 #define SWV_DPO 0x10 780 #define SWV_WRPROECT_MASK 0xe0 781 uint8_t addr[4]; 782 uint8_t group; 783 uint8_t length[2]; 784 uint8_t control; 785 }; 786 787 struct scsi_write_verify_12 788 { 789 uint8_t opcode; 790 uint8_t byte2; 791 uint8_t addr[4]; 792 uint8_t length[4]; 793 uint8_t group; 794 uint8_t control; 795 }; 796 797 struct scsi_write_verify_16 798 { 799 uint8_t opcode; 800 uint8_t byte2; 801 uint8_t addr[8]; 802 uint8_t length[4]; 803 uint8_t group; 804 uint8_t control; 805 }; 806 807 808 struct scsi_start_stop_unit 809 { 810 u_int8_t opcode; 811 u_int8_t byte2; 812 #define SSS_IMMED 0x01 813 u_int8_t reserved[2]; 814 u_int8_t how; 815 #define SSS_START 0x01 816 #define SSS_LOEJ 0x02 817 #define SSS_PC_MASK 0xf0 818 #define SSS_PC_START_VALID 0x00 819 #define SSS_PC_ACTIVE 0x10 820 #define SSS_PC_IDLE 0x20 821 #define SSS_PC_STANDBY 0x30 822 #define SSS_PC_LU_CONTROL 0x70 823 #define SSS_PC_FORCE_IDLE_0 0xa0 824 #define SSS_PC_FORCE_STANDBY_0 0xb0 825 u_int8_t control; 826 }; 827 828 struct ata_pass_12 { 829 u_int8_t opcode; 830 u_int8_t protocol; 831 #define AP_MULTI 0xe0 832 u_int8_t flags; 833 #define AP_T_LEN 0x03 834 #define AP_BB 0x04 835 #define AP_T_DIR 0x08 836 #define AP_CK_COND 0x20 837 #define AP_OFFLINE 0x60 838 u_int8_t features; 839 u_int8_t sector_count; 840 u_int8_t lba_low; 841 u_int8_t lba_mid; 842 u_int8_t lba_high; 843 u_int8_t device; 844 u_int8_t command; 845 u_int8_t reserved; 846 u_int8_t control; 847 }; 848 849 struct scsi_maintenance_in 850 { 851 uint8_t opcode; 852 uint8_t byte2; 853 #define SERVICE_ACTION_MASK 0x1f 854 #define SA_RPRT_TRGT_GRP 0x0a 855 uint8_t reserved[4]; 856 uint8_t length[4]; 857 uint8_t reserved1; 858 uint8_t control; 859 }; 860 861 struct ata_pass_16 { 862 u_int8_t opcode; 863 u_int8_t protocol; 864 #define AP_EXTEND 0x01 865 u_int8_t flags; 866 u_int8_t features_ext; 867 u_int8_t features; 868 u_int8_t sector_count_ext; 869 u_int8_t sector_count; 870 u_int8_t lba_low_ext; 871 u_int8_t lba_low; 872 u_int8_t lba_mid_ext; 873 u_int8_t lba_mid; 874 u_int8_t lba_high_ext; 875 u_int8_t lba_high; 876 u_int8_t device; 877 u_int8_t command; 878 u_int8_t control; 879 }; 880 881 #define SC_SCSI_1 0x01 882 #define SC_SCSI_2 0x03 883 884 /* 885 * Opcodes 886 */ 887 888 #define TEST_UNIT_READY 0x00 889 #define REQUEST_SENSE 0x03 890 #define READ_6 0x08 891 #define WRITE_6 0x0A 892 #define INQUIRY 0x12 893 #define MODE_SELECT_6 0x15 894 #define MODE_SENSE_6 0x1A 895 #define START_STOP_UNIT 0x1B 896 #define START_STOP 0x1B 897 #define RESERVE 0x16 898 #define RELEASE 0x17 899 #define RECEIVE_DIAGNOSTIC 0x1C 900 #define SEND_DIAGNOSTIC 0x1D 901 #define PREVENT_ALLOW 0x1E 902 #define READ_CAPACITY 0x25 903 #define READ_10 0x28 904 #define WRITE_10 0x2A 905 #define POSITION_TO_ELEMENT 0x2B 906 #define WRITE_VERIFY_10 0x2E 907 #define SYNCHRONIZE_CACHE 0x35 908 #define READ_DEFECT_DATA_10 0x37 909 #define WRITE_BUFFER 0x3B 910 #define READ_BUFFER 0x3C 911 #define CHANGE_DEFINITION 0x40 912 #define LOG_SELECT 0x4C 913 #define LOG_SENSE 0x4D 914 #define MODE_SELECT_10 0x55 915 #define RESERVE_10 0x56 916 #define RELEASE_10 0x57 917 #define MODE_SENSE_10 0x5A 918 #define PERSISTENT_RES_IN 0x5E 919 #define PERSISTENT_RES_OUT 0x5F 920 #define ATA_PASS_16 0x85 921 #define READ_16 0x88 922 #define WRITE_16 0x8A 923 #define WRITE_VERIFY_16 0x8E 924 #define SYNCHRONIZE_CACHE_16 0x91 925 #define SERVICE_ACTION_IN 0x9E 926 #define REPORT_LUNS 0xA0 927 #define ATA_PASS_12 0xA1 928 #define MAINTENANCE_IN 0xA3 929 #define MAINTENANCE_OUT 0xA4 930 #define MOVE_MEDIUM 0xA5 931 #define READ_12 0xA8 932 #define WRITE_12 0xAA 933 #define WRITE_VERIFY_12 0xAE 934 #define READ_ELEMENT_STATUS 0xB8 935 936 /* Maintenance In Service Action Codes */ 937 #define REPORT_IDENTIFYING_INFRMATION 0x05 938 #define REPORT_TARGET_PORT_GROUPS 0x0A 939 #define REPORT_ALIASES 0x0B 940 #define REPORT_SUPPORTED_OPERATION_CODES 0x0C 941 #define REPORT_SUPPORTED_TASK_MANAGEMENT_FUNCTIONS 0x0D 942 #define REPORT_PRIORITY 0x0E 943 #define REPORT_TIMESTAMP 0x0F 944 #define MANAGEMENT_PROTOCOL_IN 0x10 945 /* Maintenance Out Service Action Codes */ 946 #define SET_IDENTIFY_INFORMATION 0x06 947 #define SET_TARGET_PORT_GROUPS 0x0A 948 #define CHANGE_ALIASES 0x0B 949 #define SET_PRIORITY 0x0E 950 #define SET_TIMESTAMP 0x0F 951 #define MANGAEMENT_PROTOCOL_OUT 0x10 952 953 /* 954 * Device Types 955 */ 956 #define T_DIRECT 0x00 957 #define T_SEQUENTIAL 0x01 958 #define T_PRINTER 0x02 959 #define T_PROCESSOR 0x03 960 #define T_WORM 0x04 961 #define T_CDROM 0x05 962 #define T_SCANNER 0x06 963 #define T_OPTICAL 0x07 964 #define T_CHANGER 0x08 965 #define T_COMM 0x09 966 #define T_ASC0 0x0a 967 #define T_ASC1 0x0b 968 #define T_STORARRAY 0x0c 969 #define T_ENCLOSURE 0x0d 970 #define T_RBC 0x0e 971 #define T_OCRW 0x0f 972 #define T_OSD 0x11 973 #define T_ADC 0x12 974 #define T_NODEVICE 0x1f 975 #define T_ANY 0xff /* Used in Quirk table matches */ 976 977 #define T_REMOV 1 978 #define T_FIXED 0 979 980 /* 981 * This length is the initial inquiry length used by the probe code, as 982 * well as the legnth necessary for scsi_print_inquiry() to function 983 * correctly. If either use requires a different length in the future, 984 * the two values should be de-coupled. 985 */ 986 #define SHORT_INQUIRY_LENGTH 36 987 988 struct scsi_inquiry_data 989 { 990 u_int8_t device; 991 #define SID_TYPE(inq_data) ((inq_data)->device & 0x1f) 992 #define SID_QUAL(inq_data) (((inq_data)->device & 0xE0) >> 5) 993 #define SID_QUAL_LU_CONNECTED 0x00 /* 994 * The specified peripheral device 995 * type is currently connected to 996 * logical unit. If the target cannot 997 * determine whether or not a physical 998 * device is currently connected, it 999 * shall also use this peripheral 1000 * qualifier when returning the INQUIRY 1001 * data. This peripheral qualifier 1002 * does not mean that the device is 1003 * ready for access by the initiator. 1004 */ 1005 #define SID_QUAL_LU_OFFLINE 0x01 /* 1006 * The target is capable of supporting 1007 * the specified peripheral device type 1008 * on this logical unit; however, the 1009 * physical device is not currently 1010 * connected to this logical unit. 1011 */ 1012 #define SID_QUAL_RSVD 0x02 1013 #define SID_QUAL_BAD_LU 0x03 /* 1014 * The target is not capable of 1015 * supporting a physical device on 1016 * this logical unit. For this 1017 * peripheral qualifier the peripheral 1018 * device type shall be set to 1Fh to 1019 * provide compatibility with previous 1020 * versions of SCSI. All other 1021 * peripheral device type values are 1022 * reserved for this peripheral 1023 * qualifier. 1024 */ 1025 #define SID_QUAL_IS_VENDOR_UNIQUE(inq_data) ((SID_QUAL(inq_data) & 0x08) != 0) 1026 u_int8_t dev_qual2; 1027 #define SID_QUAL2 0x7F 1028 #define SID_IS_REMOVABLE(inq_data) (((inq_data)->dev_qual2 & 0x80) != 0) 1029 u_int8_t version; 1030 #define SID_ANSI_REV(inq_data) ((inq_data)->version & 0x07) 1031 #define SCSI_REV_0 0 1032 #define SCSI_REV_CCS 1 1033 #define SCSI_REV_2 2 1034 #define SCSI_REV_SPC 3 1035 #define SCSI_REV_SPC2 4 1036 #define SCSI_REV_SPC3 5 1037 #define SCSI_REV_SPC4 6 1038 1039 #define SID_ECMA 0x38 1040 #define SID_ISO 0xC0 1041 u_int8_t response_format; 1042 #define SID_AENC 0x80 1043 #define SID_TrmIOP 0x40 1044 #define SID_NormACA 0x20 1045 #define SID_HiSup 0x10 1046 u_int8_t additional_length; 1047 #define SID_ADDITIONAL_LENGTH(iqd) \ 1048 ((iqd)->additional_length + \ 1049 __offsetof(struct scsi_inquiry_data, additional_length) + 1) 1050 u_int8_t spc3_flags; 1051 #define SPC3_SID_PROTECT 0x01 1052 #define SPC3_SID_3PC 0x08 1053 #define SPC3_SID_TPGS_MASK 0x30 1054 #define SPC3_SID_TPGS_IMPLICIT 0x10 1055 #define SPC3_SID_TPGS_EXPLICIT 0x20 1056 #define SPC3_SID_ACC 0x40 1057 #define SPC3_SID_SCCS 0x80 1058 u_int8_t spc2_flags; 1059 #define SPC2_SID_ADDR16 0x01 1060 #define SPC2_SID_MChngr 0x08 1061 #define SPC2_SID_MultiP 0x10 1062 #define SPC2_SID_EncServ 0x40 1063 #define SPC2_SID_BQueue 0x80 1064 1065 #define INQ_DATA_TQ_ENABLED(iqd) \ 1066 ((SID_ANSI_REV(iqd) < SCSI_REV_SPC2)? ((iqd)->flags & SID_CmdQue) : \ 1067 (((iqd)->flags & SID_CmdQue) && !((iqd)->spc2_flags & SPC2_SID_BQueue)) || \ 1068 (!((iqd)->flags & SID_CmdQue) && ((iqd)->spc2_flags & SPC2_SID_BQueue))) 1069 1070 u_int8_t flags; 1071 #define SID_SftRe 0x01 1072 #define SID_CmdQue 0x02 1073 #define SID_Linked 0x08 1074 #define SID_Sync 0x10 1075 #define SID_WBus16 0x20 1076 #define SID_WBus32 0x40 1077 #define SID_RelAdr 0x80 1078 #define SID_VENDOR_SIZE 8 1079 char vendor[SID_VENDOR_SIZE]; 1080 #define SID_PRODUCT_SIZE 16 1081 char product[SID_PRODUCT_SIZE]; 1082 #define SID_REVISION_SIZE 4 1083 char revision[SID_REVISION_SIZE]; 1084 /* 1085 * The following fields were taken from SCSI Primary Commands - 2 1086 * (SPC-2) Revision 14, Dated 11 November 1999 1087 */ 1088 #define SID_VENDOR_SPECIFIC_0_SIZE 20 1089 u_int8_t vendor_specific0[SID_VENDOR_SPECIFIC_0_SIZE]; 1090 /* 1091 * An extension of SCSI Parallel Specific Values 1092 */ 1093 #define SID_SPI_IUS 0x01 1094 #define SID_SPI_QAS 0x02 1095 #define SID_SPI_CLOCK_ST 0x00 1096 #define SID_SPI_CLOCK_DT 0x04 1097 #define SID_SPI_CLOCK_DT_ST 0x0C 1098 #define SID_SPI_MASK 0x0F 1099 u_int8_t spi3data; 1100 u_int8_t reserved2; 1101 /* 1102 * Version Descriptors, stored 2 byte values. 1103 */ 1104 u_int8_t version1[2]; 1105 u_int8_t version2[2]; 1106 u_int8_t version3[2]; 1107 u_int8_t version4[2]; 1108 u_int8_t version5[2]; 1109 u_int8_t version6[2]; 1110 u_int8_t version7[2]; 1111 u_int8_t version8[2]; 1112 1113 u_int8_t reserved3[22]; 1114 1115 #define SID_VENDOR_SPECIFIC_1_SIZE 160 1116 u_int8_t vendor_specific1[SID_VENDOR_SPECIFIC_1_SIZE]; 1117 }; 1118 1119 /* 1120 * This structure is more suited to initiator operation, because the 1121 * maximum number of supported pages is already allocated. 1122 */ 1123 struct scsi_vpd_supported_page_list 1124 { 1125 u_int8_t device; 1126 u_int8_t page_code; 1127 #define SVPD_SUPPORTED_PAGE_LIST 0x00 1128 #define SVPD_SUPPORTED_PAGES_HDR_LEN 4 1129 u_int8_t reserved; 1130 u_int8_t length; /* number of VPD entries */ 1131 #define SVPD_SUPPORTED_PAGES_SIZE 251 1132 u_int8_t list[SVPD_SUPPORTED_PAGES_SIZE]; 1133 }; 1134 1135 /* 1136 * This structure is more suited to target operation, because the 1137 * number of supported pages is left to the user to allocate. 1138 */ 1139 struct scsi_vpd_supported_pages 1140 { 1141 u_int8_t device; 1142 u_int8_t page_code; 1143 u_int8_t reserved; 1144 #define SVPD_SUPPORTED_PAGES 0x00 1145 u_int8_t length; 1146 u_int8_t page_list[0]; 1147 }; 1148 1149 1150 struct scsi_vpd_unit_serial_number 1151 { 1152 u_int8_t device; 1153 u_int8_t page_code; 1154 #define SVPD_UNIT_SERIAL_NUMBER 0x80 1155 u_int8_t reserved; 1156 u_int8_t length; /* serial number length */ 1157 #define SVPD_SERIAL_NUM_SIZE 251 1158 u_int8_t serial_num[SVPD_SERIAL_NUM_SIZE]; 1159 }; 1160 1161 struct scsi_vpd_device_id 1162 { 1163 u_int8_t device; 1164 u_int8_t page_code; 1165 #define SVPD_DEVICE_ID 0x83 1166 #define SVPD_DEVICE_ID_MAX_SIZE 252 1167 #define SVPD_DEVICE_ID_HDR_LEN \ 1168 __offsetof(struct scsi_vpd_device_id, desc_list) 1169 u_int8_t length[2]; 1170 u_int8_t desc_list[]; 1171 }; 1172 1173 struct scsi_vpd_id_descriptor 1174 { 1175 u_int8_t proto_codeset; 1176 #define SCSI_PROTO_FC 0x00 1177 #define SCSI_PROTO_SPI 0x01 1178 #define SCSI_PROTO_SSA 0x02 1179 #define SCSI_PROTO_1394 0x03 1180 #define SCSI_PROTO_RDMA 0x04 1181 #define SCSI_PROTO_iSCSI 0x05 1182 #define SCSI_PROTO_SAS 0x06 1183 #define SVPD_ID_PROTO_SHIFT 4 1184 #define SVPD_ID_CODESET_BINARY 0x01 1185 #define SVPD_ID_CODESET_ASCII 0x02 1186 #define SVPD_ID_CODESET_MASK 0x0f 1187 u_int8_t id_type; 1188 #define SVPD_ID_PIV 0x80 1189 #define SVPD_ID_ASSOC_LUN 0x00 1190 #define SVPD_ID_ASSOC_PORT 0x10 1191 #define SVPD_ID_ASSOC_TARGET 0x20 1192 #define SVPD_ID_ASSOC_MASK 0x30 1193 #define SVPD_ID_TYPE_VENDOR 0x00 1194 #define SVPD_ID_TYPE_T10 0x01 1195 #define SVPD_ID_TYPE_EUI64 0x02 1196 #define SVPD_ID_TYPE_NAA 0x03 1197 #define SVPD_ID_TYPE_RELTARG 0x04 1198 #define SVPD_ID_TYPE_TPORTGRP 0x05 1199 #define SVPD_ID_TYPE_LUNGRP 0x06 1200 #define SVPD_ID_TYPE_MD5_LUN_ID 0x07 1201 #define SVPD_ID_TYPE_SCSI_NAME 0x08 1202 #define SVPD_ID_TYPE_MASK 0x0f 1203 u_int8_t reserved; 1204 u_int8_t length; 1205 #define SVPD_DEVICE_ID_DESC_HDR_LEN \ 1206 __offsetof(struct scsi_vpd_id_descriptor, identifier) 1207 u_int8_t identifier[]; 1208 }; 1209 1210 struct scsi_vpd_id_t10 1211 { 1212 u_int8_t vendor[8]; 1213 u_int8_t vendor_spec_id[0]; 1214 }; 1215 1216 struct scsi_vpd_id_eui64 1217 { 1218 u_int8_t ieee_company_id[3]; 1219 u_int8_t extension_id[5]; 1220 }; 1221 1222 struct scsi_vpd_id_naa_basic 1223 { 1224 uint8_t naa; 1225 /* big endian, packed: 1226 uint8_t naa : 4; 1227 uint8_t naa_desig : 4; 1228 */ 1229 #define SVPD_ID_NAA_NAA_SHIFT 4 1230 #define SVPD_ID_NAA_IEEE_EXT 0x02 1231 #define SVPD_ID_NAA_LOCAL_REG 0x03 1232 #define SVPD_ID_NAA_IEEE_REG 0x05 1233 #define SVPD_ID_NAA_IEEE_REG_EXT 0x06 1234 uint8_t naa_data[]; 1235 }; 1236 1237 struct scsi_vpd_id_naa_ieee_extended_id 1238 { 1239 uint8_t naa; 1240 uint8_t vendor_specific_id_a; 1241 uint8_t ieee_company_id[3]; 1242 uint8_t vendor_specific_id_b[4]; 1243 }; 1244 1245 struct scsi_vpd_id_naa_local_reg 1246 { 1247 uint8_t naa; 1248 uint8_t local_value[7]; 1249 }; 1250 1251 struct scsi_vpd_id_naa_ieee_reg 1252 { 1253 uint8_t naa; 1254 uint8_t reg_value[7]; 1255 /* big endian, packed: 1256 uint8_t naa_basic : 4; 1257 uint8_t ieee_company_id_0 : 4; 1258 uint8_t ieee_company_id_1[2]; 1259 uint8_t ieee_company_id_2 : 4; 1260 uint8_t vendor_specific_id_0 : 4; 1261 uint8_t vendor_specific_id_1[4]; 1262 */ 1263 }; 1264 1265 struct scsi_vpd_id_naa_ieee_reg_extended 1266 { 1267 uint8_t naa; 1268 uint8_t reg_value[15]; 1269 /* big endian, packed: 1270 uint8_t naa_basic : 4; 1271 uint8_t ieee_company_id_0 : 4; 1272 uint8_t ieee_company_id_1[2]; 1273 uint8_t ieee_company_id_2 : 4; 1274 uint8_t vendor_specific_id_0 : 4; 1275 uint8_t vendor_specific_id_1[4]; 1276 uint8_t vendor_specific_id_ext[8]; 1277 */ 1278 }; 1279 1280 struct scsi_vpd_id_rel_trgt_port_id 1281 { 1282 uint8_t obsolete[2]; 1283 uint8_t rel_trgt_port_id[2]; 1284 }; 1285 1286 struct scsi_vpd_id_trgt_port_grp_id 1287 { 1288 uint8_t reserved[2]; 1289 uint8_t trgt_port_grp[2]; 1290 }; 1291 1292 struct scsi_vpd_id_lun_grp_id 1293 { 1294 uint8_t reserved[2]; 1295 uint8_t log_unit_grp[2]; 1296 }; 1297 1298 struct scsi_vpd_id_md5_lun_id 1299 { 1300 uint8_t lun_id[16]; 1301 }; 1302 1303 struct scsi_vpd_id_scsi_name 1304 { 1305 uint8_t name_string[256]; 1306 }; 1307 1308 struct scsi_service_action_in 1309 { 1310 uint8_t opcode; 1311 uint8_t service_action; 1312 uint8_t action_dependent[13]; 1313 uint8_t control; 1314 }; 1315 1316 struct scsi_read_capacity 1317 { 1318 u_int8_t opcode; 1319 u_int8_t byte2; 1320 #define SRC_RELADR 0x01 1321 u_int8_t addr[4]; 1322 u_int8_t unused[2]; 1323 u_int8_t pmi; 1324 #define SRC_PMI 0x01 1325 u_int8_t control; 1326 }; 1327 1328 struct scsi_read_capacity_16 1329 { 1330 uint8_t opcode; 1331 #define SRC16_SERVICE_ACTION 0x10 1332 uint8_t service_action; 1333 uint8_t addr[8]; 1334 uint8_t alloc_len[4]; 1335 #define SRC16_PMI 0x01 1336 #define SRC16_RELADR 0x02 1337 uint8_t reladr; 1338 uint8_t control; 1339 }; 1340 1341 struct scsi_read_capacity_data 1342 { 1343 u_int8_t addr[4]; 1344 u_int8_t length[4]; 1345 }; 1346 1347 struct scsi_read_capacity_data_long 1348 { 1349 uint8_t addr[8]; 1350 uint8_t length[4]; 1351 }; 1352 1353 struct scsi_report_luns 1354 { 1355 uint8_t opcode; 1356 uint8_t reserved1; 1357 #define RPL_REPORT_DEFAULT 0x00 1358 #define RPL_REPORT_WELLKNOWN 0x01 1359 #define RPL_REPORT_ALL 0x02 1360 uint8_t select_report; 1361 uint8_t reserved2[3]; 1362 uint8_t length[4]; 1363 uint8_t reserved3; 1364 uint8_t control; 1365 }; 1366 1367 struct scsi_report_luns_lundata { 1368 uint8_t lundata[8]; 1369 #define RPL_LUNDATA_PERIPH_BUS_MASK 0x3f 1370 #define RPL_LUNDATA_FLAT_LUN_MASK 0x3f 1371 #define RPL_LUNDATA_FLAT_LUN_BITS 0x06 1372 #define RPL_LUNDATA_LUN_TARG_MASK 0x3f 1373 #define RPL_LUNDATA_LUN_BUS_MASK 0xe0 1374 #define RPL_LUNDATA_LUN_LUN_MASK 0x1f 1375 #define RPL_LUNDATA_EXT_LEN_MASK 0x30 1376 #define RPL_LUNDATA_EXT_EAM_MASK 0x0f 1377 #define RPL_LUNDATA_EXT_EAM_WK 0x01 1378 #define RPL_LUNDATA_EXT_EAM_NOT_SPEC 0x0f 1379 #define RPL_LUNDATA_ATYP_MASK 0xc0 /* MBZ for type 0 lun */ 1380 #define RPL_LUNDATA_ATYP_PERIPH 0x00 1381 #define RPL_LUNDATA_ATYP_FLAT 0x40 1382 #define RPL_LUNDATA_ATYP_LUN 0x80 1383 #define RPL_LUNDATA_ATYP_EXTLUN 0xc0 1384 }; 1385 1386 struct scsi_report_luns_data { 1387 u_int8_t length[4]; /* length of LUN inventory, in bytes */ 1388 u_int8_t reserved[4]; /* unused */ 1389 /* 1390 * LUN inventory- we only support the type zero form for now. 1391 */ 1392 struct scsi_report_luns_lundata luns[0]; 1393 }; 1394 1395 struct scsi_target_group 1396 { 1397 uint8_t opcode; 1398 uint8_t service_action; 1399 #define STG_PDF_LENGTH 0x00 1400 #define RPL_PDF_EXTENDED 0x20 1401 uint8_t reserved1[4]; 1402 uint8_t length[4]; 1403 uint8_t reserved2; 1404 uint8_t control; 1405 }; 1406 1407 struct scsi_target_port_descriptor { 1408 uint8_t reserved[2]; 1409 uint8_t relative_target_port_identifier[2]; 1410 uint8_t desc_list[]; 1411 }; 1412 1413 struct scsi_target_port_group_descriptor { 1414 uint8_t pref_state; 1415 #define TPG_PRIMARY 0x80 1416 #define TPG_ASYMMETRIC_ACCESS_STATE_MASK 0xf 1417 #define TPG_ASYMMETRIC_ACCESS_OPTIMIZED 0x0 1418 #define TPG_ASYMMETRIC_ACCESS_NONOPTIMIZED 0x1 1419 #define TPG_ASYMMETRIC_ACCESS_STANDBY 0x2 1420 #define TPG_ASYMMETRIC_ACCESS_UNAVAILABLE 0x3 1421 #define TPG_ASYMMETRIC_ACCESS_LBA_DEPENDENT 0x4 1422 #define TPG_ASYMMETRIC_ACCESS_OFFLINE 0xE 1423 #define TPG_ASYMMETRIC_ACCESS_TRANSITIONING 0xF 1424 uint8_t support; 1425 #define TPG_AO_SUP 0x01 1426 #define TPG_AN_SUP 0x02 1427 #define TPG_S_SUP 0x04 1428 #define TPG_U_SUP 0x08 1429 #define TPG_LBD_SUP 0x10 1430 #define TPG_O_SUP 0x40 1431 #define TPG_T_SUP 0x80 1432 uint8_t target_port_group[2]; 1433 uint8_t reserved; 1434 uint8_t status; 1435 #define TPG_UNAVLBL 0 1436 #define TPG_SET_BY_STPG 0x01 1437 #define TPG_IMPLICIT 0x02 1438 uint8_t vendor_specific; 1439 uint8_t target_port_count; 1440 struct scsi_target_port_descriptor descriptors[]; 1441 }; 1442 1443 struct scsi_target_group_data { 1444 uint8_t length[4]; /* length of returned data, in bytes */ 1445 struct scsi_target_port_group_descriptor groups[]; 1446 }; 1447 1448 struct scsi_target_group_data_extended { 1449 uint8_t length[4]; /* length of returned data, in bytes */ 1450 uint8_t format_type; /* STG_PDF_LENGTH or RPL_PDF_EXTENDED */ 1451 uint8_t implicit_transition_time; 1452 uint8_t reserved[2]; 1453 struct scsi_target_port_group_descriptor groups[]; 1454 }; 1455 1456 1457 typedef enum { 1458 SSD_TYPE_NONE, 1459 SSD_TYPE_FIXED, 1460 SSD_TYPE_DESC 1461 } scsi_sense_data_type; 1462 1463 typedef enum { 1464 SSD_ELEM_NONE, 1465 SSD_ELEM_SKIP, 1466 SSD_ELEM_DESC, 1467 SSD_ELEM_SKS, 1468 SSD_ELEM_COMMAND, 1469 SSD_ELEM_INFO, 1470 SSD_ELEM_FRU, 1471 SSD_ELEM_STREAM, 1472 SSD_ELEM_MAX 1473 } scsi_sense_elem_type; 1474 1475 1476 struct scsi_sense_data 1477 { 1478 uint8_t error_code; 1479 /* 1480 * SPC-4 says that the maximum length of sense data is 252 bytes. 1481 * So this structure is exactly 252 bytes log. 1482 */ 1483 #define SSD_FULL_SIZE 252 1484 uint8_t sense_buf[SSD_FULL_SIZE - 1]; 1485 /* 1486 * XXX KDM is this still a reasonable minimum size? 1487 */ 1488 #define SSD_MIN_SIZE 18 1489 /* 1490 * Maximum value for the extra_len field in the sense data. 1491 */ 1492 #define SSD_EXTRA_MAX 244 1493 }; 1494 1495 /* 1496 * Fixed format sense data. 1497 */ 1498 struct scsi_sense_data_fixed 1499 { 1500 u_int8_t error_code; 1501 #define SSD_ERRCODE 0x7F 1502 #define SSD_CURRENT_ERROR 0x70 1503 #define SSD_DEFERRED_ERROR 0x71 1504 #define SSD_ERRCODE_VALID 0x80 1505 u_int8_t segment; 1506 u_int8_t flags; 1507 #define SSD_KEY 0x0F 1508 #define SSD_KEY_NO_SENSE 0x00 1509 #define SSD_KEY_RECOVERED_ERROR 0x01 1510 #define SSD_KEY_NOT_READY 0x02 1511 #define SSD_KEY_MEDIUM_ERROR 0x03 1512 #define SSD_KEY_HARDWARE_ERROR 0x04 1513 #define SSD_KEY_ILLEGAL_REQUEST 0x05 1514 #define SSD_KEY_UNIT_ATTENTION 0x06 1515 #define SSD_KEY_DATA_PROTECT 0x07 1516 #define SSD_KEY_BLANK_CHECK 0x08 1517 #define SSD_KEY_Vendor_Specific 0x09 1518 #define SSD_KEY_COPY_ABORTED 0x0a 1519 #define SSD_KEY_ABORTED_COMMAND 0x0b 1520 #define SSD_KEY_EQUAL 0x0c 1521 #define SSD_KEY_VOLUME_OVERFLOW 0x0d 1522 #define SSD_KEY_MISCOMPARE 0x0e 1523 #define SSD_KEY_COMPLETED 0x0f 1524 #define SSD_ILI 0x20 1525 #define SSD_EOM 0x40 1526 #define SSD_FILEMARK 0x80 1527 u_int8_t info[4]; 1528 u_int8_t extra_len; 1529 u_int8_t cmd_spec_info[4]; 1530 u_int8_t add_sense_code; 1531 u_int8_t add_sense_code_qual; 1532 u_int8_t fru; 1533 u_int8_t sense_key_spec[3]; 1534 #define SSD_SCS_VALID 0x80 1535 #define SSD_FIELDPTR_CMD 0x40 1536 #define SSD_BITPTR_VALID 0x08 1537 #define SSD_BITPTR_VALUE 0x07 1538 u_int8_t extra_bytes[14]; 1539 #define SSD_FIXED_IS_PRESENT(sense, length, field) \ 1540 ((length >= (offsetof(struct scsi_sense_data_fixed, field) + \ 1541 sizeof(sense->field))) ? 1 :0) 1542 #define SSD_FIXED_IS_FILLED(sense, field) \ 1543 ((((offsetof(struct scsi_sense_data_fixed, field) + \ 1544 sizeof(sense->field)) - \ 1545 (offsetof(struct scsi_sense_data_fixed, extra_len) + \ 1546 sizeof(sense->extra_len))) <= sense->extra_len) ? 1 : 0) 1547 }; 1548 1549 /* 1550 * Descriptor format sense data definitions. 1551 * Introduced in SPC-3. 1552 */ 1553 struct scsi_sense_data_desc 1554 { 1555 uint8_t error_code; 1556 #define SSD_DESC_CURRENT_ERROR 0x72 1557 #define SSD_DESC_DEFERRED_ERROR 0x73 1558 uint8_t sense_key; 1559 uint8_t add_sense_code; 1560 uint8_t add_sense_code_qual; 1561 uint8_t reserved[3]; 1562 /* 1563 * Note that SPC-4, section 4.5.2.1 says that the extra_len field 1564 * must be less than or equal to 244. 1565 */ 1566 uint8_t extra_len; 1567 uint8_t sense_desc[0]; 1568 #define SSD_DESC_IS_PRESENT(sense, length, field) \ 1569 ((length >= (offsetof(struct scsi_sense_data_desc, field) + \ 1570 sizeof(sense->field))) ? 1 :0) 1571 }; 1572 1573 struct scsi_sense_desc_header 1574 { 1575 uint8_t desc_type; 1576 uint8_t length; 1577 }; 1578 /* 1579 * The information provide in the Information descriptor is device type or 1580 * command specific information, and defined in a command standard. 1581 * 1582 * Note that any changes to the field names or positions in this structure, 1583 * even reserved fields, should be accompanied by an examination of the 1584 * code in ctl_set_sense() that uses them. 1585 * 1586 * Maximum descriptors allowed: 1 (as of SPC-4) 1587 */ 1588 struct scsi_sense_info 1589 { 1590 uint8_t desc_type; 1591 #define SSD_DESC_INFO 0x00 1592 uint8_t length; 1593 uint8_t byte2; 1594 #define SSD_INFO_VALID 0x80 1595 uint8_t reserved; 1596 uint8_t info[8]; 1597 }; 1598 1599 /* 1600 * Command-specific information depends on the command for which the 1601 * reported condition occured. 1602 * 1603 * Note that any changes to the field names or positions in this structure, 1604 * even reserved fields, should be accompanied by an examination of the 1605 * code in ctl_set_sense() that uses them. 1606 * 1607 * Maximum descriptors allowed: 1 (as of SPC-4) 1608 */ 1609 struct scsi_sense_command 1610 { 1611 uint8_t desc_type; 1612 #define SSD_DESC_COMMAND 0x01 1613 uint8_t length; 1614 uint8_t reserved[2]; 1615 uint8_t command_info[8]; 1616 }; 1617 1618 /* 1619 * Sense key specific descriptor. The sense key specific data format 1620 * depends on the sense key in question. 1621 * 1622 * Maximum descriptors allowed: 1 (as of SPC-4) 1623 */ 1624 struct scsi_sense_sks 1625 { 1626 uint8_t desc_type; 1627 #define SSD_DESC_SKS 0x02 1628 uint8_t length; 1629 uint8_t reserved1[2]; 1630 uint8_t sense_key_spec[3]; 1631 #define SSD_SKS_VALID 0x80 1632 uint8_t reserved2; 1633 }; 1634 1635 /* 1636 * This is used for the Illegal Request sense key (0x05) only. 1637 */ 1638 struct scsi_sense_sks_field 1639 { 1640 uint8_t byte0; 1641 #define SSD_SKS_FIELD_VALID 0x80 1642 #define SSD_SKS_FIELD_CMD 0x40 1643 #define SSD_SKS_BPV 0x08 1644 #define SSD_SKS_BIT_VALUE 0x07 1645 uint8_t field[2]; 1646 }; 1647 1648 1649 /* 1650 * This is used for the Hardware Error (0x04), Medium Error (0x03) and 1651 * Recovered Error (0x01) sense keys. 1652 */ 1653 struct scsi_sense_sks_retry 1654 { 1655 uint8_t byte0; 1656 #define SSD_SKS_RETRY_VALID 0x80 1657 uint8_t actual_retry_count[2]; 1658 }; 1659 1660 /* 1661 * Used with the NO Sense (0x00) or Not Ready (0x02) sense keys. 1662 */ 1663 struct scsi_sense_sks_progress 1664 { 1665 uint8_t byte0; 1666 #define SSD_SKS_PROGRESS_VALID 0x80 1667 uint8_t progress[2]; 1668 #define SSD_SKS_PROGRESS_DENOM 0x10000 1669 }; 1670 1671 /* 1672 * Used with the Copy Aborted (0x0a) sense key. 1673 */ 1674 struct scsi_sense_sks_segment 1675 { 1676 uint8_t byte0; 1677 #define SSD_SKS_SEGMENT_VALID 0x80 1678 #define SSD_SKS_SEGMENT_SD 0x20 1679 #define SSD_SKS_SEGMENT_BPV 0x08 1680 #define SSD_SKS_SEGMENT_BITPTR 0x07 1681 uint8_t field[2]; 1682 }; 1683 1684 /* 1685 * Used with the Unit Attention (0x06) sense key. 1686 * 1687 * This is currently used to indicate that the unit attention condition 1688 * queue has overflowed (when the overflow bit is set). 1689 */ 1690 struct scsi_sense_sks_overflow 1691 { 1692 uint8_t byte0; 1693 #define SSD_SKS_OVERFLOW_VALID 0x80 1694 #define SSD_SKS_OVERFLOW_SET 0x01 1695 uint8_t reserved[2]; 1696 }; 1697 1698 /* 1699 * This specifies which component is associated with the sense data. There 1700 * is no standard meaning for the fru value. 1701 * 1702 * Maximum descriptors allowed: 1 (as of SPC-4) 1703 */ 1704 struct scsi_sense_fru 1705 { 1706 uint8_t desc_type; 1707 #define SSD_DESC_FRU 0x03 1708 uint8_t length; 1709 uint8_t reserved; 1710 uint8_t fru; 1711 }; 1712 1713 /* 1714 * Used for Stream commands, defined in SSC-4. 1715 * 1716 * Maximum descriptors allowed: 1 (as of SPC-4) 1717 */ 1718 1719 struct scsi_sense_stream 1720 { 1721 uint8_t desc_type; 1722 #define SSD_DESC_STREAM 0x04 1723 uint8_t length; 1724 uint8_t reserved; 1725 uint8_t byte3; 1726 #define SSD_DESC_STREAM_FM 0x80 1727 #define SSD_DESC_STREAM_EOM 0x40 1728 #define SSD_DESC_STREAM_ILI 0x20 1729 }; 1730 1731 /* 1732 * Used for Block commands, defined in SBC-3. 1733 * 1734 * This is currently (as of SBC-3) only used for the Incorrect Length 1735 * Indication (ILI) bit, which says that the data length requested in the 1736 * READ LONG or WRITE LONG command did not match the length of the logical 1737 * block. 1738 * 1739 * Maximum descriptors allowed: 1 (as of SPC-4) 1740 */ 1741 struct scsi_sense_block 1742 { 1743 uint8_t desc_type; 1744 #define SSD_DESC_BLOCK 0x05 1745 uint8_t length; 1746 uint8_t reserved; 1747 uint8_t byte3; 1748 #define SSD_DESC_BLOCK_ILI 0x20 1749 }; 1750 1751 /* 1752 * Used for Object-Based Storage Devices (OSD-3). 1753 * 1754 * Maximum descriptors allowed: 1 (as of SPC-4) 1755 */ 1756 struct scsi_sense_osd_objid 1757 { 1758 uint8_t desc_type; 1759 #define SSD_DESC_OSD_OBJID 0x06 1760 uint8_t length; 1761 uint8_t reserved[6]; 1762 /* 1763 * XXX KDM provide the bit definitions here? There are a lot of 1764 * them, and we don't have an OSD driver yet. 1765 */ 1766 uint8_t not_init_cmds[4]; 1767 uint8_t completed_cmds[4]; 1768 uint8_t partition_id[8]; 1769 uint8_t object_id[8]; 1770 }; 1771 1772 /* 1773 * Used for Object-Based Storage Devices (OSD-3). 1774 * 1775 * Maximum descriptors allowed: 1 (as of SPC-4) 1776 */ 1777 struct scsi_sense_osd_integrity 1778 { 1779 uint8_t desc_type; 1780 #define SSD_DESC_OSD_INTEGRITY 0x07 1781 uint8_t length; 1782 uint8_t integ_check_val[32]; 1783 }; 1784 1785 /* 1786 * Used for Object-Based Storage Devices (OSD-3). 1787 * 1788 * Maximum descriptors allowed: 1 (as of SPC-4) 1789 */ 1790 struct scsi_sense_osd_attr_id 1791 { 1792 uint8_t desc_type; 1793 #define SSD_DESC_OSD_ATTR_ID 0x08 1794 uint8_t length; 1795 uint8_t reserved[2]; 1796 uint8_t attr_desc[0]; 1797 }; 1798 1799 /* 1800 * Used with Sense keys No Sense (0x00) and Not Ready (0x02). 1801 * 1802 * Maximum descriptors allowed: 32 (as of SPC-4) 1803 */ 1804 struct scsi_sense_progress 1805 { 1806 uint8_t desc_type; 1807 #define SSD_DESC_PROGRESS 0x0a 1808 uint8_t length; 1809 uint8_t sense_key; 1810 uint8_t add_sense_code; 1811 uint8_t add_sense_code_qual; 1812 uint8_t reserved; 1813 uint8_t progress[2]; 1814 }; 1815 1816 /* 1817 * This is typically forwarded as the result of an EXTENDED COPY command. 1818 * 1819 * Maximum descriptors allowed: 2 (as of SPC-4) 1820 */ 1821 struct scsi_sense_forwarded 1822 { 1823 uint8_t desc_type; 1824 #define SSD_DESC_FORWARDED 0x0c 1825 uint8_t length; 1826 uint8_t byte2; 1827 #define SSD_FORWARDED_FSDT 0x80 1828 #define SSD_FORWARDED_SDS_MASK 0x0f 1829 #define SSD_FORWARDED_SDS_UNK 0x00 1830 #define SSD_FORWARDED_SDS_EXSRC 0x01 1831 #define SSD_FORWARDED_SDS_EXDST 0x02 1832 }; 1833 1834 /* 1835 * Vendor-specific sense descriptor. The desc_type field will be in the 1836 * range bewteen MIN and MAX inclusive. 1837 */ 1838 struct scsi_sense_vendor 1839 { 1840 uint8_t desc_type; 1841 #define SSD_DESC_VENDOR_MIN 0x80 1842 #define SSD_DESC_VENDOR_MAX 0xff 1843 uint8_t length; 1844 uint8_t data[0]; 1845 }; 1846 1847 struct scsi_mode_header_6 1848 { 1849 u_int8_t data_length; /* Sense data length */ 1850 u_int8_t medium_type; 1851 u_int8_t dev_spec; 1852 u_int8_t blk_desc_len; 1853 }; 1854 1855 struct scsi_mode_header_10 1856 { 1857 u_int8_t data_length[2];/* Sense data length */ 1858 u_int8_t medium_type; 1859 u_int8_t dev_spec; 1860 u_int8_t unused[2]; 1861 u_int8_t blk_desc_len[2]; 1862 }; 1863 1864 struct scsi_mode_page_header 1865 { 1866 u_int8_t page_code; 1867 #define SMPH_PS 0x80 1868 #define SMPH_SPF 0x40 1869 #define SMPH_PC_MASK 0x3f 1870 u_int8_t page_length; 1871 }; 1872 1873 struct scsi_mode_page_header_sp 1874 { 1875 uint8_t page_code; 1876 uint8_t subpage; 1877 uint8_t page_length[2]; 1878 }; 1879 1880 1881 struct scsi_mode_blk_desc 1882 { 1883 u_int8_t density; 1884 u_int8_t nblocks[3]; 1885 u_int8_t reserved; 1886 u_int8_t blklen[3]; 1887 }; 1888 1889 #define SCSI_DEFAULT_DENSITY 0x00 /* use 'default' density */ 1890 #define SCSI_SAME_DENSITY 0x7f /* use 'same' density- >= SCSI-2 only */ 1891 1892 1893 /* 1894 * Status Byte 1895 */ 1896 #define SCSI_STATUS_OK 0x00 1897 #define SCSI_STATUS_CHECK_COND 0x02 1898 #define SCSI_STATUS_COND_MET 0x04 1899 #define SCSI_STATUS_BUSY 0x08 1900 #define SCSI_STATUS_INTERMED 0x10 1901 #define SCSI_STATUS_INTERMED_COND_MET 0x14 1902 #define SCSI_STATUS_RESERV_CONFLICT 0x18 1903 #define SCSI_STATUS_CMD_TERMINATED 0x22 /* Obsolete in SAM-2 */ 1904 #define SCSI_STATUS_QUEUE_FULL 0x28 1905 #define SCSI_STATUS_ACA_ACTIVE 0x30 1906 #define SCSI_STATUS_TASK_ABORTED 0x40 1907 1908 struct scsi_inquiry_pattern { 1909 u_int8_t type; 1910 u_int8_t media_type; 1911 #define SIP_MEDIA_REMOVABLE 0x01 1912 #define SIP_MEDIA_FIXED 0x02 1913 const char *vendor; 1914 const char *product; 1915 const char *revision; 1916 }; 1917 1918 struct scsi_static_inquiry_pattern { 1919 u_int8_t type; 1920 u_int8_t media_type; 1921 char vendor[SID_VENDOR_SIZE+1]; 1922 char product[SID_PRODUCT_SIZE+1]; 1923 char revision[SID_REVISION_SIZE+1]; 1924 }; 1925 1926 struct scsi_sense_quirk_entry { 1927 struct scsi_inquiry_pattern inq_pat; 1928 int num_sense_keys; 1929 int num_ascs; 1930 struct sense_key_table_entry *sense_key_info; 1931 struct asc_table_entry *asc_info; 1932 }; 1933 1934 struct sense_key_table_entry { 1935 u_int8_t sense_key; 1936 u_int32_t action; 1937 const char *desc; 1938 }; 1939 1940 struct asc_table_entry { 1941 u_int8_t asc; 1942 u_int8_t ascq; 1943 u_int32_t action; 1944 const char *desc; 1945 }; 1946 1947 struct op_table_entry { 1948 u_int8_t opcode; 1949 u_int32_t opmask; 1950 const char *desc; 1951 }; 1952 1953 struct scsi_op_quirk_entry { 1954 struct scsi_inquiry_pattern inq_pat; 1955 int num_ops; 1956 struct op_table_entry *op_table; 1957 }; 1958 1959 typedef enum { 1960 SSS_FLAG_NONE = 0x00, 1961 SSS_FLAG_PRINT_COMMAND = 0x01 1962 } scsi_sense_string_flags; 1963 1964 struct ccb_scsiio; 1965 struct cam_periph; 1966 union ccb; 1967 #ifndef _KERNEL 1968 struct cam_device; 1969 #endif 1970 1971 extern const char *scsi_sense_key_text[]; 1972 1973 struct sbuf; 1974 1975 __BEGIN_DECLS 1976 void scsi_sense_desc(int sense_key, int asc, int ascq, 1977 struct scsi_inquiry_data *inq_data, 1978 const char **sense_key_desc, const char **asc_desc); 1979 scsi_sense_action scsi_error_action(struct ccb_scsiio* csio, 1980 struct scsi_inquiry_data *inq_data, 1981 u_int32_t sense_flags); 1982 const char * scsi_status_string(struct ccb_scsiio *csio); 1983 1984 void scsi_desc_iterate(struct scsi_sense_data_desc *sense, u_int sense_len, 1985 int (*iter_func)(struct scsi_sense_data_desc *sense, 1986 u_int, struct scsi_sense_desc_header *, 1987 void *), void *arg); 1988 uint8_t *scsi_find_desc(struct scsi_sense_data_desc *sense, u_int sense_len, 1989 uint8_t desc_type); 1990 void scsi_set_sense_data(struct scsi_sense_data *sense_data, 1991 scsi_sense_data_type sense_format, int current_error, 1992 int sense_key, int asc, int ascq, ...) ; 1993 void scsi_set_sense_data_va(struct scsi_sense_data *sense_data, 1994 scsi_sense_data_type sense_format, 1995 int current_error, int sense_key, int asc, 1996 int ascq, va_list ap); 1997 int scsi_get_sense_info(struct scsi_sense_data *sense_data, u_int sense_len, 1998 uint8_t info_type, uint64_t *info, 1999 int64_t *signed_info); 2000 int scsi_get_sks(struct scsi_sense_data *sense_data, u_int sense_len, 2001 uint8_t *sks); 2002 int scsi_get_block_info(struct scsi_sense_data *sense_data, u_int sense_len, 2003 struct scsi_inquiry_data *inq_data, 2004 uint8_t *block_bits); 2005 int scsi_get_stream_info(struct scsi_sense_data *sense_data, u_int sense_len, 2006 struct scsi_inquiry_data *inq_data, 2007 uint8_t *stream_bits); 2008 void scsi_info_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len, 2009 struct scsi_inquiry_data *inq_data, uint64_t info); 2010 void scsi_command_sbuf(struct sbuf *sb, uint8_t *cdb, int cdb_len, 2011 struct scsi_inquiry_data *inq_data, uint64_t csi); 2012 void scsi_progress_sbuf(struct sbuf *sb, uint16_t progress); 2013 int scsi_sks_sbuf(struct sbuf *sb, int sense_key, uint8_t *sks); 2014 void scsi_fru_sbuf(struct sbuf *sb, uint64_t fru); 2015 void scsi_stream_sbuf(struct sbuf *sb, uint8_t stream_bits, uint64_t info); 2016 void scsi_block_sbuf(struct sbuf *sb, uint8_t block_bits, uint64_t info); 2017 void scsi_sense_info_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2018 u_int sense_len, uint8_t *cdb, int cdb_len, 2019 struct scsi_inquiry_data *inq_data, 2020 struct scsi_sense_desc_header *header); 2021 2022 void scsi_sense_command_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2023 u_int sense_len, uint8_t *cdb, int cdb_len, 2024 struct scsi_inquiry_data *inq_data, 2025 struct scsi_sense_desc_header *header); 2026 void scsi_sense_sks_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2027 u_int sense_len, uint8_t *cdb, int cdb_len, 2028 struct scsi_inquiry_data *inq_data, 2029 struct scsi_sense_desc_header *header); 2030 void scsi_sense_fru_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2031 u_int sense_len, uint8_t *cdb, int cdb_len, 2032 struct scsi_inquiry_data *inq_data, 2033 struct scsi_sense_desc_header *header); 2034 void scsi_sense_stream_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2035 u_int sense_len, uint8_t *cdb, int cdb_len, 2036 struct scsi_inquiry_data *inq_data, 2037 struct scsi_sense_desc_header *header); 2038 void scsi_sense_block_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2039 u_int sense_len, uint8_t *cdb, int cdb_len, 2040 struct scsi_inquiry_data *inq_data, 2041 struct scsi_sense_desc_header *header); 2042 void scsi_sense_progress_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2043 u_int sense_len, uint8_t *cdb, int cdb_len, 2044 struct scsi_inquiry_data *inq_data, 2045 struct scsi_sense_desc_header *header); 2046 void scsi_sense_generic_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2047 u_int sense_len, uint8_t *cdb, int cdb_len, 2048 struct scsi_inquiry_data *inq_data, 2049 struct scsi_sense_desc_header *header); 2050 void scsi_sense_desc_sbuf(struct sbuf *sb, struct scsi_sense_data *sense, 2051 u_int sense_len, uint8_t *cdb, int cdb_len, 2052 struct scsi_inquiry_data *inq_data, 2053 struct scsi_sense_desc_header *header); 2054 scsi_sense_data_type scsi_sense_type(struct scsi_sense_data *sense_data); 2055 2056 void scsi_sense_only_sbuf(struct scsi_sense_data *sense, u_int sense_len, 2057 struct sbuf *sb, char *path_str, 2058 struct scsi_inquiry_data *inq_data, uint8_t *cdb, 2059 int cdb_len); 2060 2061 #ifdef _KERNEL 2062 int scsi_command_string(struct ccb_scsiio *csio, struct sbuf *sb); 2063 int scsi_sense_sbuf(struct ccb_scsiio *csio, struct sbuf *sb, 2064 scsi_sense_string_flags flags); 2065 char * scsi_sense_string(struct ccb_scsiio *csio, 2066 char *str, int str_len); 2067 void scsi_sense_print(struct ccb_scsiio *csio); 2068 int scsi_interpret_sense(union ccb *ccb, 2069 u_int32_t sense_flags, 2070 u_int32_t *relsim_flags, 2071 u_int32_t *reduction, 2072 u_int32_t *timeout, 2073 scsi_sense_action error_action); 2074 #else /* _KERNEL */ 2075 int scsi_command_string(struct cam_device *device, 2076 struct ccb_scsiio *csio, struct sbuf *sb); 2077 int scsi_sense_sbuf(struct cam_device *device, 2078 struct ccb_scsiio *csio, struct sbuf *sb, 2079 scsi_sense_string_flags flags); 2080 char * scsi_sense_string(struct cam_device *device, 2081 struct ccb_scsiio *csio, 2082 char *str, int str_len); 2083 void scsi_sense_print(struct cam_device *device, 2084 struct ccb_scsiio *csio, FILE *ofile); 2085 int scsi_interpret_sense(struct cam_device *device, 2086 union ccb *ccb, 2087 u_int32_t sense_flags, 2088 u_int32_t *relsim_flags, 2089 u_int32_t *reduction, 2090 u_int32_t *timeout, 2091 scsi_sense_action error_action); 2092 #endif /* _KERNEL */ 2093 2094 #define SF_RETRY_UA 0x01 2095 #define SF_NO_PRINT 0x02 2096 #define SF_QUIET_IR 0x04 /* Be quiet about Illegal Request reponses */ 2097 #define SF_PRINT_ALWAYS 0x08 2098 2099 2100 const char * scsi_op_desc(u_int16_t opcode, 2101 struct scsi_inquiry_data *inq_data); 2102 char * scsi_cdb_string(u_int8_t *cdb_ptr, char *cdb_string, 2103 size_t len); 2104 2105 void scsi_print_inquiry(struct scsi_inquiry_data *inq_data); 2106 2107 u_int scsi_calc_syncsrate(u_int period_factor); 2108 u_int scsi_calc_syncparam(u_int period); 2109 2110 typedef int (*scsi_devid_checkfn_t)(uint8_t *); 2111 int scsi_devid_is_naa_ieee_reg(uint8_t *bufp); 2112 int scsi_devid_is_sas_target(uint8_t *bufp); 2113 uint8_t * scsi_get_devid(struct scsi_vpd_device_id *id, uint32_t len, 2114 scsi_devid_checkfn_t ck_fn); 2115 2116 void scsi_test_unit_ready(struct ccb_scsiio *csio, u_int32_t retries, 2117 void (*cbfcnp)(struct cam_periph *, 2118 union ccb *), 2119 u_int8_t tag_action, 2120 u_int8_t sense_len, u_int32_t timeout); 2121 2122 void scsi_request_sense(struct ccb_scsiio *csio, u_int32_t retries, 2123 void (*cbfcnp)(struct cam_periph *, 2124 union ccb *), 2125 void *data_ptr, u_int8_t dxfer_len, 2126 u_int8_t tag_action, u_int8_t sense_len, 2127 u_int32_t timeout); 2128 2129 void scsi_inquiry(struct ccb_scsiio *csio, u_int32_t retries, 2130 void (*cbfcnp)(struct cam_periph *, union ccb *), 2131 u_int8_t tag_action, u_int8_t *inq_buf, 2132 u_int32_t inq_len, int evpd, u_int8_t page_code, 2133 u_int8_t sense_len, u_int32_t timeout); 2134 2135 void scsi_mode_sense(struct ccb_scsiio *csio, u_int32_t retries, 2136 void (*cbfcnp)(struct cam_periph *, 2137 union ccb *), 2138 u_int8_t tag_action, int dbd, 2139 u_int8_t page_code, u_int8_t page, 2140 u_int8_t *param_buf, u_int32_t param_len, 2141 u_int8_t sense_len, u_int32_t timeout); 2142 2143 void scsi_mode_sense_len(struct ccb_scsiio *csio, u_int32_t retries, 2144 void (*cbfcnp)(struct cam_periph *, 2145 union ccb *), 2146 u_int8_t tag_action, int dbd, 2147 u_int8_t page_code, u_int8_t page, 2148 u_int8_t *param_buf, u_int32_t param_len, 2149 int minimum_cmd_size, u_int8_t sense_len, 2150 u_int32_t timeout); 2151 2152 void scsi_mode_select(struct ccb_scsiio *csio, u_int32_t retries, 2153 void (*cbfcnp)(struct cam_periph *, 2154 union ccb *), 2155 u_int8_t tag_action, int scsi_page_fmt, 2156 int save_pages, u_int8_t *param_buf, 2157 u_int32_t param_len, u_int8_t sense_len, 2158 u_int32_t timeout); 2159 2160 void scsi_mode_select_len(struct ccb_scsiio *csio, u_int32_t retries, 2161 void (*cbfcnp)(struct cam_periph *, 2162 union ccb *), 2163 u_int8_t tag_action, int scsi_page_fmt, 2164 int save_pages, u_int8_t *param_buf, 2165 u_int32_t param_len, int minimum_cmd_size, 2166 u_int8_t sense_len, u_int32_t timeout); 2167 2168 void scsi_log_sense(struct ccb_scsiio *csio, u_int32_t retries, 2169 void (*cbfcnp)(struct cam_periph *, union ccb *), 2170 u_int8_t tag_action, u_int8_t page_code, 2171 u_int8_t page, int save_pages, int ppc, 2172 u_int32_t paramptr, u_int8_t *param_buf, 2173 u_int32_t param_len, u_int8_t sense_len, 2174 u_int32_t timeout); 2175 2176 void scsi_log_select(struct ccb_scsiio *csio, u_int32_t retries, 2177 void (*cbfcnp)(struct cam_periph *, 2178 union ccb *), u_int8_t tag_action, 2179 u_int8_t page_code, int save_pages, 2180 int pc_reset, u_int8_t *param_buf, 2181 u_int32_t param_len, u_int8_t sense_len, 2182 u_int32_t timeout); 2183 2184 void scsi_prevent(struct ccb_scsiio *csio, u_int32_t retries, 2185 void (*cbfcnp)(struct cam_periph *, union ccb *), 2186 u_int8_t tag_action, u_int8_t action, 2187 u_int8_t sense_len, u_int32_t timeout); 2188 2189 void scsi_read_capacity(struct ccb_scsiio *csio, u_int32_t retries, 2190 void (*cbfcnp)(struct cam_periph *, 2191 union ccb *), u_int8_t tag_action, 2192 struct scsi_read_capacity_data *, 2193 u_int8_t sense_len, u_int32_t timeout); 2194 void scsi_read_capacity_16(struct ccb_scsiio *csio, uint32_t retries, 2195 void (*cbfcnp)(struct cam_periph *, 2196 union ccb *), uint8_t tag_action, 2197 uint64_t lba, int reladr, int pmi, 2198 struct scsi_read_capacity_data_long 2199 *rcap_buf, uint8_t sense_len, 2200 uint32_t timeout); 2201 2202 void scsi_report_luns(struct ccb_scsiio *csio, u_int32_t retries, 2203 void (*cbfcnp)(struct cam_periph *, 2204 union ccb *), u_int8_t tag_action, 2205 u_int8_t select_report, 2206 struct scsi_report_luns_data *rpl_buf, 2207 u_int32_t alloc_len, u_int8_t sense_len, 2208 u_int32_t timeout); 2209 2210 void scsi_report_target_group(struct ccb_scsiio *csio, u_int32_t retries, 2211 void (*cbfcnp)(struct cam_periph *, 2212 union ccb *), u_int8_t tag_action, 2213 u_int8_t pdf, 2214 void *buf, 2215 u_int32_t alloc_len, u_int8_t sense_len, 2216 u_int32_t timeout); 2217 2218 void scsi_set_target_group(struct ccb_scsiio *csio, u_int32_t retries, 2219 void (*cbfcnp)(struct cam_periph *, 2220 union ccb *), u_int8_t tag_action, void *buf, 2221 u_int32_t alloc_len, u_int8_t sense_len, 2222 u_int32_t timeout); 2223 2224 void scsi_synchronize_cache(struct ccb_scsiio *csio, 2225 u_int32_t retries, 2226 void (*cbfcnp)(struct cam_periph *, 2227 union ccb *), u_int8_t tag_action, 2228 u_int32_t begin_lba, u_int16_t lb_count, 2229 u_int8_t sense_len, u_int32_t timeout); 2230 2231 void scsi_receive_diagnostic_results(struct ccb_scsiio *csio, u_int32_t retries, 2232 void (*cbfcnp)(struct cam_periph *, 2233 union ccb*), 2234 uint8_t tag_action, int pcv, 2235 uint8_t page_code, uint8_t *data_ptr, 2236 uint16_t allocation_length, 2237 uint8_t sense_len, uint32_t timeout); 2238 2239 void scsi_send_diagnostic(struct ccb_scsiio *csio, u_int32_t retries, 2240 void (*cbfcnp)(struct cam_periph *, union ccb *), 2241 uint8_t tag_action, int unit_offline, 2242 int device_offline, int self_test, int page_format, 2243 int self_test_code, uint8_t *data_ptr, 2244 uint16_t param_list_length, uint8_t sense_len, 2245 uint32_t timeout); 2246 2247 void scsi_read_write(struct ccb_scsiio *csio, u_int32_t retries, 2248 void (*cbfcnp)(struct cam_periph *, union ccb *), 2249 u_int8_t tag_action, int readop, u_int8_t byte2, 2250 int minimum_cmd_size, u_int64_t lba, 2251 u_int32_t block_count, u_int8_t *data_ptr, 2252 u_int32_t dxfer_len, u_int8_t sense_len, 2253 u_int32_t timeout); 2254 2255 void scsi_start_stop(struct ccb_scsiio *csio, u_int32_t retries, 2256 void (*cbfcnp)(struct cam_periph *, union ccb *), 2257 u_int8_t tag_action, int start, int load_eject, 2258 int immediate, u_int8_t sense_len, u_int32_t timeout); 2259 2260 int scsi_inquiry_match(caddr_t inqbuffer, caddr_t table_entry); 2261 int scsi_static_inquiry_match(caddr_t inqbuffer, 2262 caddr_t table_entry); 2263 int scsi_devid_match(uint8_t *rhs, size_t rhs_len, 2264 uint8_t *lhs, size_t lhs_len); 2265 2266 void scsi_extract_sense(struct scsi_sense_data *sense, int *error_code, 2267 int *sense_key, int *asc, int *ascq); 2268 void scsi_extract_sense_len(struct scsi_sense_data *sense, 2269 u_int sense_len, int *error_code, int *sense_key, 2270 int *asc, int *ascq, int show_errors); 2271 int scsi_get_sense_key(struct scsi_sense_data *sense, u_int sense_len, 2272 int show_errors); 2273 int scsi_get_asc(struct scsi_sense_data *sense, u_int sense_len, 2274 int show_errors); 2275 int scsi_get_ascq(struct scsi_sense_data *sense, u_int sense_len, 2276 int show_errors); 2277 static __inline void scsi_ulto2b(u_int32_t val, u_int8_t *bytes); 2278 static __inline void scsi_ulto3b(u_int32_t val, u_int8_t *bytes); 2279 static __inline void scsi_ulto4b(u_int32_t val, u_int8_t *bytes); 2280 static __inline void scsi_u64to8b(u_int64_t val, u_int8_t *bytes); 2281 static __inline uint32_t scsi_2btoul(const uint8_t *bytes); 2282 static __inline uint32_t scsi_3btoul(const uint8_t *bytes); 2283 static __inline int32_t scsi_3btol(const uint8_t *bytes); 2284 static __inline uint32_t scsi_4btoul(const uint8_t *bytes); 2285 static __inline uint64_t scsi_8btou64(const uint8_t *bytes); 2286 static __inline void *find_mode_page_6(struct scsi_mode_header_6 *mode_header); 2287 static __inline void *find_mode_page_10(struct scsi_mode_header_10 *mode_header); 2288 2289 static __inline void 2290 scsi_ulto2b(u_int32_t val, u_int8_t *bytes) 2291 { 2292 2293 bytes[0] = (val >> 8) & 0xff; 2294 bytes[1] = val & 0xff; 2295 } 2296 2297 static __inline void 2298 scsi_ulto3b(u_int32_t val, u_int8_t *bytes) 2299 { 2300 2301 bytes[0] = (val >> 16) & 0xff; 2302 bytes[1] = (val >> 8) & 0xff; 2303 bytes[2] = val & 0xff; 2304 } 2305 2306 static __inline void 2307 scsi_ulto4b(u_int32_t val, u_int8_t *bytes) 2308 { 2309 2310 bytes[0] = (val >> 24) & 0xff; 2311 bytes[1] = (val >> 16) & 0xff; 2312 bytes[2] = (val >> 8) & 0xff; 2313 bytes[3] = val & 0xff; 2314 } 2315 2316 static __inline void 2317 scsi_u64to8b(u_int64_t val, u_int8_t *bytes) 2318 { 2319 2320 bytes[0] = (val >> 56) & 0xff; 2321 bytes[1] = (val >> 48) & 0xff; 2322 bytes[2] = (val >> 40) & 0xff; 2323 bytes[3] = (val >> 32) & 0xff; 2324 bytes[4] = (val >> 24) & 0xff; 2325 bytes[5] = (val >> 16) & 0xff; 2326 bytes[6] = (val >> 8) & 0xff; 2327 bytes[7] = val & 0xff; 2328 } 2329 2330 static __inline uint32_t 2331 scsi_2btoul(const uint8_t *bytes) 2332 { 2333 uint32_t rv; 2334 2335 rv = (bytes[0] << 8) | 2336 bytes[1]; 2337 return (rv); 2338 } 2339 2340 static __inline uint32_t 2341 scsi_3btoul(const uint8_t *bytes) 2342 { 2343 uint32_t rv; 2344 2345 rv = (bytes[0] << 16) | 2346 (bytes[1] << 8) | 2347 bytes[2]; 2348 return (rv); 2349 } 2350 2351 static __inline int32_t 2352 scsi_3btol(const uint8_t *bytes) 2353 { 2354 uint32_t rc = scsi_3btoul(bytes); 2355 2356 if (rc & 0x00800000) 2357 rc |= 0xff000000; 2358 2359 return (int32_t) rc; 2360 } 2361 2362 static __inline uint32_t 2363 scsi_4btoul(const uint8_t *bytes) 2364 { 2365 uint32_t rv; 2366 2367 rv = (bytes[0] << 24) | 2368 (bytes[1] << 16) | 2369 (bytes[2] << 8) | 2370 bytes[3]; 2371 return (rv); 2372 } 2373 2374 static __inline uint64_t 2375 scsi_8btou64(const uint8_t *bytes) 2376 { 2377 uint64_t rv; 2378 2379 rv = (((uint64_t)bytes[0]) << 56) | 2380 (((uint64_t)bytes[1]) << 48) | 2381 (((uint64_t)bytes[2]) << 40) | 2382 (((uint64_t)bytes[3]) << 32) | 2383 (((uint64_t)bytes[4]) << 24) | 2384 (((uint64_t)bytes[5]) << 16) | 2385 (((uint64_t)bytes[6]) << 8) | 2386 bytes[7]; 2387 return (rv); 2388 } 2389 2390 /* 2391 * Given the pointer to a returned mode sense buffer, return a pointer to 2392 * the start of the first mode page. 2393 */ 2394 static __inline void * 2395 find_mode_page_6(struct scsi_mode_header_6 *mode_header) 2396 { 2397 void *page_start; 2398 2399 page_start = (void *)((u_int8_t *)&mode_header[1] + 2400 mode_header->blk_desc_len); 2401 2402 return(page_start); 2403 } 2404 2405 static __inline void * 2406 find_mode_page_10(struct scsi_mode_header_10 *mode_header) 2407 { 2408 void *page_start; 2409 2410 page_start = (void *)((u_int8_t *)&mode_header[1] + 2411 scsi_2btoul(mode_header->blk_desc_len)); 2412 2413 return(page_start); 2414 } 2415 2416 __END_DECLS 2417 2418 #endif /*_SCSI_SCSI_ALL_H*/ 2419