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 */
44struct 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 */
54struct 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 */
66struct 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 */
76struct virtio_scsi_ctrl_tmf_req {
77 __virtio32 type;
78 __virtio32 subtype;
79 __u8 lun[8];
80 __virtio64 tag;
81} __attribute__((packed));
82
83struct virtio_scsi_ctrl_tmf_resp {
84 __u8 response;
85} __attribute__((packed));
86
87/* Asynchronous notification query/subscription */
88struct virtio_scsi_ctrl_an_req {
89 __virtio32 type;
90 __u8 lun[8];
91 __virtio32 event_requested;
92} __attribute__((packed));
93
94struct virtio_scsi_ctrl_an_resp {
95 __virtio32 event_actual;
96 __u8 response;
97} __attribute__((packed));
98
99struct virtio_scsi_event {
100 __virtio32 event;
101 __u8 lun[8];
102 __virtio32 reason;
103} __attribute__((packed));
104
105struct virtio_scsi_config {
106 __u32 num_queues;
107 __u32 seg_max;
108 __u32 max_sectors;
109 __u32 cmd_per_lun;
110 __u32 event_info_size;
111 __u32 sense_size;
112 __u32 cdb_size;
113 __u16 max_channel;
114 __u16 max_target;
115 __u32 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