1 /* 2 * This header is BSD licensed so anyone can use the definitions to implement 3 * compatible drivers/servers. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 */ 26 27 #ifndef _LINUX_VIRTIO_SCSI_H 28 #define _LINUX_VIRTIO_SCSI_H 29 30 #include <linux/virtio_types.h> 31 32 /* Default values of the CDB and sense data size configuration fields */ 33 #define VIRTIO_SCSI_CDB_DEFAULT_SIZE 32 34 #define VIRTIO_SCSI_SENSE_DEFAULT_SIZE 96 35 36 #ifndef VIRTIO_SCSI_CDB_SIZE 37 #define VIRTIO_SCSI_CDB_SIZE VIRTIO_SCSI_CDB_DEFAULT_SIZE 38 #endif 39 #ifndef VIRTIO_SCSI_SENSE_SIZE 40 #define VIRTIO_SCSI_SENSE_SIZE VIRTIO_SCSI_SENSE_DEFAULT_SIZE 41 #endif 42 43 /* SCSI command request, followed by data-out */ 44 struct virtio_scsi_cmd_req { 45 uint8_t lun[8]; /* Logical Unit Number */ 46 __virtio64 tag; /* Command identifier */ 47 uint8_t task_attr; /* Task attribute */ 48 uint8_t prio; /* SAM command priority field */ 49 uint8_t crn; 50 uint8_t cdb[VIRTIO_SCSI_CDB_SIZE]; 51 } __attribute__((packed)); 52 53 /* SCSI command request, followed by protection information */ 54 struct virtio_scsi_cmd_req_pi { 55 uint8_t lun[8]; /* Logical Unit Number */ 56 __virtio64 tag; /* Command identifier */ 57 uint8_t task_attr; /* Task attribute */ 58 uint8_t prio; /* SAM command priority field */ 59 uint8_t crn; 60 __virtio32 pi_bytesout; /* DataOUT PI Number of bytes */ 61 __virtio32 pi_bytesin; /* DataIN PI Number of bytes */ 62 uint8_t cdb[VIRTIO_SCSI_CDB_SIZE]; 63 } __attribute__((packed)); 64 65 /* Response, followed by sense data and data-in */ 66 struct virtio_scsi_cmd_resp { 67 __virtio32 sense_len; /* Sense data length */ 68 __virtio32 resid; /* Residual bytes in data buffer */ 69 __virtio16 status_qualifier; /* Status qualifier */ 70 uint8_t status; /* Command completion status */ 71 uint8_t response; /* Response values */ 72 uint8_t sense[VIRTIO_SCSI_SENSE_SIZE]; 73 } __attribute__((packed)); 74 75 /* Task Management Request */ 76 struct virtio_scsi_ctrl_tmf_req { 77 __virtio32 type; 78 __virtio32 subtype; 79 uint8_t lun[8]; 80 __virtio64 tag; 81 } __attribute__((packed)); 82 83 struct virtio_scsi_ctrl_tmf_resp { 84 uint8_t response; 85 } __attribute__((packed)); 86 87 /* Asynchronous notification query/subscription */ 88 struct virtio_scsi_ctrl_an_req { 89 __virtio32 type; 90 uint8_t lun[8]; 91 __virtio32 event_requested; 92 } __attribute__((packed)); 93 94 struct virtio_scsi_ctrl_an_resp { 95 __virtio32 event_actual; 96 uint8_t response; 97 } __attribute__((packed)); 98 99 struct virtio_scsi_event { 100 __virtio32 event; 101 uint8_t lun[8]; 102 __virtio32 reason; 103 } __attribute__((packed)); 104 105 struct virtio_scsi_config { 106 __virtio32 num_queues; 107 __virtio32 seg_max; 108 __virtio32 max_sectors; 109 __virtio32 cmd_per_lun; 110 __virtio32 event_info_size; 111 __virtio32 sense_size; 112 __virtio32 cdb_size; 113 __virtio16 max_channel; 114 __virtio16 max_target; 115 __virtio32 max_lun; 116 } __attribute__((packed)); 117 118 /* Feature Bits */ 119 #define VIRTIO_SCSI_F_INOUT 0 120 #define VIRTIO_SCSI_F_HOTPLUG 1 121 #define VIRTIO_SCSI_F_CHANGE 2 122 #define VIRTIO_SCSI_F_T10_PI 3 123 124 /* Response codes */ 125 #define VIRTIO_SCSI_S_OK 0 126 #define VIRTIO_SCSI_S_OVERRUN 1 127 #define VIRTIO_SCSI_S_ABORTED 2 128 #define VIRTIO_SCSI_S_BAD_TARGET 3 129 #define VIRTIO_SCSI_S_RESET 4 130 #define VIRTIO_SCSI_S_BUSY 5 131 #define VIRTIO_SCSI_S_TRANSPORT_FAILURE 6 132 #define VIRTIO_SCSI_S_TARGET_FAILURE 7 133 #define VIRTIO_SCSI_S_NEXUS_FAILURE 8 134 #define VIRTIO_SCSI_S_FAILURE 9 135 #define VIRTIO_SCSI_S_FUNCTION_SUCCEEDED 10 136 #define VIRTIO_SCSI_S_FUNCTION_REJECTED 11 137 #define VIRTIO_SCSI_S_INCORRECT_LUN 12 138 139 /* Controlq type codes. */ 140 #define VIRTIO_SCSI_T_TMF 0 141 #define VIRTIO_SCSI_T_AN_QUERY 1 142 #define VIRTIO_SCSI_T_AN_SUBSCRIBE 2 143 144 /* Valid TMF subtypes. */ 145 #define VIRTIO_SCSI_T_TMF_ABORT_TASK 0 146 #define VIRTIO_SCSI_T_TMF_ABORT_TASK_SET 1 147 #define VIRTIO_SCSI_T_TMF_CLEAR_ACA 2 148 #define VIRTIO_SCSI_T_TMF_CLEAR_TASK_SET 3 149 #define VIRTIO_SCSI_T_TMF_I_T_NEXUS_RESET 4 150 #define VIRTIO_SCSI_T_TMF_LOGICAL_UNIT_RESET 5 151 #define VIRTIO_SCSI_T_TMF_QUERY_TASK 6 152 #define VIRTIO_SCSI_T_TMF_QUERY_TASK_SET 7 153 154 /* Events. */ 155 #define VIRTIO_SCSI_T_EVENTS_MISSED 0x80000000 156 #define VIRTIO_SCSI_T_NO_EVENT 0 157 #define VIRTIO_SCSI_T_TRANSPORT_RESET 1 158 #define VIRTIO_SCSI_T_ASYNC_NOTIFY 2 159 #define VIRTIO_SCSI_T_PARAM_CHANGE 3 160 161 /* Reasons of transport reset event */ 162 #define VIRTIO_SCSI_EVT_RESET_HARD 0 163 #define VIRTIO_SCSI_EVT_RESET_RESCAN 1 164 #define VIRTIO_SCSI_EVT_RESET_REMOVED 2 165 166 #define VIRTIO_SCSI_S_SIMPLE 0 167 #define VIRTIO_SCSI_S_ORDERED 1 168 #define VIRTIO_SCSI_S_HEAD 2 169 #define VIRTIO_SCSI_S_ACA 3 170 171 172 #endif /* _LINUX_VIRTIO_SCSI_H */ 173