Home | History | Annotate | Download | only in linux
      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 	__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