include/uapi/rdma/siw-abi.h

   1 /* SPDX-License-Identifier: (GPL-2.0 WITH Linux-syscall-note) or BSD-3-Clause */
   2
   3 /* Authors: Bernard Metzler <bmt@zurich.ibm.com> */
   4 /* Copyright (c) 2008-2019, IBM Corporation */
   5
   6 #ifndef _SIW_USER_H
   7 #define _SIW_USER_H
   8
   9 #include <linux/types.h>
  10
  11 #define SIW_NODE_DESC_COMMON "Software iWARP stack"
  12 #define SIW_ABI_VERSION 1
  13 #define SIW_MAX_SGE 6
  14 #define SIW_UOBJ_MAX_KEY 0x08FFFF
  15 #define SIW_INVAL_UOBJ_KEY (SIW_UOBJ_MAX_KEY + 1)
  16
  17 struct siw_uresp_create_cq {
  18         __u32 cq_id;
  19         __u32 num_cqe;
  20         __aligned_u64 cq_key;
  21 };
  22
  23 struct siw_uresp_create_qp {
  24         __u32 qp_id;
  25         __u32 num_sqe;
  26         __u32 num_rqe;
  27         __u32 pad;
  28         __aligned_u64 sq_key;
  29         __aligned_u64 rq_key;
  30 };
  31
  32 struct siw_ureq_reg_mr {
  33         __u8 stag_key;
  34         __u8 reserved[3];
  35         __u32 pad;
  36 };
  37
  38 struct siw_uresp_reg_mr {
  39         __u32 stag;
  40         __u32 pad;
  41 };
  42
  43 struct siw_uresp_create_srq {
  44         __u32 num_rqe;
  45         __u32 pad;
  46         __aligned_u64 srq_key;
  47 };
  48
  49 struct siw_uresp_alloc_ctx {
  50         __u32 dev_id;
  51         __u32 pad;
  52 };
  53
  54 enum siw_opcode {
  55         SIW_OP_WRITE,
  56         SIW_OP_READ,
  57         SIW_OP_READ_LOCAL_INV,
  58         SIW_OP_SEND,
  59         SIW_OP_SEND_WITH_IMM,
  60         SIW_OP_SEND_REMOTE_INV,
  61
  62         /* Unsupported */
  63         SIW_OP_FETCH_AND_ADD,
  64         SIW_OP_COMP_AND_SWAP,
  65
  66         SIW_OP_RECEIVE,
  67         /* provider internal SQE */
  68         SIW_OP_READ_RESPONSE,
  69         /*
  70          * below opcodes valid for
  71          * in-kernel clients only
  72          */
  73         SIW_OP_INVAL_STAG,
  74         SIW_OP_REG_MR,
  75         SIW_NUM_OPCODES
  76 };
  77
  78 /* Keep it same as ibv_sge to allow for memcpy */
  79 struct siw_sge {
  80         __aligned_u64 laddr;
  81         __u32 length;
  82         __u32 lkey;
  83 };
  84
  85 /*
  86  * Inline data are kept within the work request itself occupying
  87  * the space of sge[1] .. sge[n]. Therefore, inline data cannot be
  88  * supported if SIW_MAX_SGE is below 2 elements.
  89  */
  90 #define SIW_MAX_INLINE (sizeof(struct siw_sge) * (SIW_MAX_SGE - 1))
  91
  92 #if SIW_MAX_SGE < 2
  93 #error "SIW_MAX_SGE must be at least 2"
  94 #endif
  95
  96 enum siw_wqe_flags {
  97         SIW_WQE_VALID = 1,
  98         SIW_WQE_INLINE = (1 << 1),
  99         SIW_WQE_SIGNALLED = (1 << 2),
 100         SIW_WQE_SOLICITED = (1 << 3),
 101         SIW_WQE_READ_FENCE = (1 << 4),
 102         SIW_WQE_REM_INVAL = (1 << 5),
 103         SIW_WQE_COMPLETED = (1 << 6)
 104 };
 105
 106 /* Send Queue Element */
 107 struct siw_sqe {
 108         __aligned_u64 id;
 109         __u16 flags;
 110         __u8 num_sge;
 111         /* Contains enum siw_opcode values */
 112         __u8 opcode;
 113         __u32 rkey;
 114         union {
 115                 __aligned_u64 raddr;
 116                 __aligned_u64 base_mr;
 117         };
 118         union {
 119                 struct siw_sge sge[SIW_MAX_SGE];
 120                 __aligned_u64 access;
 121         };
 122 };
 123
 124 /* Receive Queue Element */
 125 struct siw_rqe {
 126         __aligned_u64 id;
 127         __u16 flags;
 128         __u8 num_sge;
 129         /*
 130          * only used by kernel driver,
 131          * ignored if set by user
 132          */
 133         __u8 opcode;
 134         __u32 unused;
 135         struct siw_sge sge[SIW_MAX_SGE];
 136 };
 137
 138 enum siw_notify_flags {
 139         SIW_NOTIFY_NOT = (0),
 140         SIW_NOTIFY_SOLICITED = (1 << 0),
 141         SIW_NOTIFY_NEXT_COMPLETION = (1 << 1),
 142         SIW_NOTIFY_MISSED_EVENTS = (1 << 2),
 143         SIW_NOTIFY_ALL = SIW_NOTIFY_SOLICITED | SIW_NOTIFY_NEXT_COMPLETION |
 144                          SIW_NOTIFY_MISSED_EVENTS
 145 };
 146
 147 enum siw_wc_status {
 148         SIW_WC_SUCCESS,
 149         SIW_WC_LOC_LEN_ERR,
 150         SIW_WC_LOC_PROT_ERR,
 151         SIW_WC_LOC_QP_OP_ERR,
 152         SIW_WC_WR_FLUSH_ERR,
 153         SIW_WC_BAD_RESP_ERR,
 154         SIW_WC_LOC_ACCESS_ERR,
 155         SIW_WC_REM_ACCESS_ERR,
 156         SIW_WC_REM_INV_REQ_ERR,
 157         SIW_WC_GENERAL_ERR,
 158         SIW_NUM_WC_STATUS
 159 };
 160
 161 struct siw_cqe {
 162         __aligned_u64 id;
 163         __u8 flags;
 164         __u8 opcode;
 165         __u16 status;
 166         __u32 bytes;
 167         union {
 168                 __aligned_u64 imm_data;
 169                 __u32 inval_stag;
 170         };
 171         /* QP number or QP pointer */
 172         union {
 173                 struct ib_qp *base_qp;
 174                 __aligned_u64 qp_id;
 175         };
 176 };
 177
 178 /*
 179  * Shared structure between user and kernel
 180  * to control CQ arming.
 181  */
 182 struct siw_cq_ctrl {
 183         __u32 flags;
 184         __u32 pad;
 185 };
 186 #endif