master
  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
 17struct siw_uresp_create_cq {
 18	__u32 cq_id;
 19	__u32 num_cqe;
 20	__aligned_u64 cq_key;
 21};
 22
 23struct 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
 32struct siw_ureq_reg_mr {
 33	__u8 stag_key;
 34	__u8 reserved[3];
 35	__u32 pad;
 36};
 37
 38struct siw_uresp_reg_mr {
 39	__u32 stag;
 40	__u32 pad;
 41};
 42
 43struct siw_uresp_create_srq {
 44	__u32 num_rqe;
 45	__u32 pad;
 46	__aligned_u64 srq_key;
 47};
 48
 49struct siw_uresp_alloc_ctx {
 50	__u32 dev_id;
 51	__u32 pad;
 52};
 53
 54enum 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 */
 79struct 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
 96enum 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 */
107struct 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 */
125struct 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
138enum 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
147enum 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
161struct 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 */
182struct siw_cq_ctrl {
183	__u32 flags;
184	__u32 pad;
185};
186#endif