GNU Linux-libre 6.9.2-gnu
[releases.git] / include / uapi / linux / virtio_scsi.h
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         __u8 lun[8];            /* Logical Unit Number */
46         __virtio64 tag;         /* Command identifier */
47         __u8 task_attr;         /* Task attribute */
48         __u8 prio;              /* SAM command priority field */
49         __u8 crn;
50         __u8 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         __u8 lun[8];            /* Logical Unit Number */
56         __virtio64 tag;         /* Command identifier */
57         __u8 task_attr;         /* Task attribute */
58         __u8 prio;              /* SAM command priority field */
59         __u8 crn;
60         __virtio32 pi_bytesout; /* DataOUT PI Number of bytes */
61         __virtio32 pi_bytesin;          /* DataIN PI Number of bytes */
62         __u8 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         __u8 status;            /* Command completion status */
71         __u8 response;          /* Response values */
72         __u8 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         __u8 lun[8];
80         __virtio64 tag;
81 } __attribute__((packed));
82
83 struct virtio_scsi_ctrl_tmf_resp {
84         __u8 response;
85 } __attribute__((packed));
86
87 /* Asynchronous notification query/subscription */
88 struct virtio_scsi_ctrl_an_req {
89         __virtio32 type;
90         __u8 lun[8];
91         __virtio32 event_requested;
92 } __attribute__((packed));
93
94 struct virtio_scsi_ctrl_an_resp {
95         __virtio32 event_actual;
96         __u8 response;
97 } __attribute__((packed));
98
99 struct virtio_scsi_event {
100         __virtio32 event;
101         __u8 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 */