Add the bsg_uring_cmd structure to the BSG UAPI header to support io_uring-based SCSI passthrough operations via IORING_OP_URING_CMD. Signed-off-by: Yang Xiuwei --- include/uapi/linux/bsg.h | 49 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/include/uapi/linux/bsg.h b/include/uapi/linux/bsg.h index cd6302def5ed..757118660d86 100644 --- a/include/uapi/linux/bsg.h +++ b/include/uapi/linux/bsg.h @@ -63,5 +63,54 @@ struct sg_io_v4 { __u32 padding; }; +struct bsg_uring_cmd { + __u64 request; /* [i], [*i] command descriptor address */ + __u32 request_len; /* [i] command descriptor length in bytes */ + __u32 protocol; /* [i] protocol type (BSG_PROTOCOL_*) */ + __u32 subprotocol; /* [i] subprotocol type (BSG_SUB_PROTOCOL_*) */ + __u32 max_response_len; /* [i] response buffer size in bytes */ + + __u64 response; /* [i], [*o] response data address */ + __u64 dout_xferp; /* [i], [*i] */ + __u32 dout_xfer_len; /* [i] bytes to be transferred to device */ + __u32 dout_iovec_count; /* [i] 0 -> "flat" dout transfer else + * dout_xferp points to array of iovec + */ + __u64 din_xferp; /* [i], [*o] */ + __u32 din_xfer_len; /* [i] bytes to be transferred from device */ + __u32 din_iovec_count; /* [i] 0 -> "flat" din transfer */ + + __u32 timeout_ms; /* [i] timeout in milliseconds */ + __u8 reserved[12]; /* reserved for future extension */ +}; + +/* + * SCSI BSG io_uring completion (res2, 64-bit) + * + * When using BSG_PROTOCOL_SCSI + BSG_SUB_PROTOCOL_SCSI_CMD with + * IORING_OP_URING_CMD, the completion queue entry (CQE) contains: + * - result: errno (0 on success) + * - res2: packed SCSI status; see macros below to decode. + * + * res2 bit layout: + * [0..7] device_status (SCSI status byte, e.g. CHECK_CONDITION) + * [8..15] driver_status (e.g. DRIVER_SENSE when sense data is valid) + * [16..23] host_status (e.g. DID_OK, DID_TIME_OUT) + * [24..31] sense_len_wr (bytes of sense data written to response buffer) + * [32..63] resid_len (residual transfer length) + */ +#define BSG_SCSI_RES2_DEVICE_STATUS(res2) ((__u8)((__u64)(res2) & 0xff)) +#define BSG_SCSI_RES2_DRIVER_STATUS(res2) ((__u8)((__u64)(res2) >> 8)) +#define BSG_SCSI_RES2_HOST_STATUS(res2) ((__u8)((__u64)(res2) >> 16)) +#define BSG_SCSI_RES2_SENSE_LEN(res2) ((__u8)((__u64)(res2) >> 24)) +#define BSG_SCSI_RES2_RESID_LEN(res2) ((__u32)((__u64)(res2) >> 32)) + +#define BSG_SCSI_RES2_BUILD(device_status, driver_status, host_status, \ + sense_len_wr, resid_len) \ + (((__u64)(__u32)(resid_len) << 32) | \ + ((__u64)(__u8)(sense_len_wr) << 24) | \ + ((__u64)(__u8)(host_status) << 16) | \ + ((__u64)(__u8)(driver_status) << 8) | \ + ((__u64)(__u8)(device_status))) #endif /* _UAPIBSG_H */ -- 2.25.1