xref: /linux/include/uapi/rdma/vmw_pvrdma-abi.h (revision ab520be8cd5d56867fc95cfbc34b90880faf1f9d)
1 /*
2  * Copyright (c) 2012-2016 VMware, Inc.  All rights reserved.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of EITHER the GNU General Public License
6  * version 2 as published by the Free Software Foundation or the BSD
7  * 2-Clause License. This program is distributed in the hope that it
8  * will be useful, but WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED
9  * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
10  * See the GNU General Public License version 2 for more details at
11  * http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program available in the file COPYING in the main
15  * directory of this source tree.
16  *
17  * The BSD 2-Clause License
18  *
19  *     Redistribution and use in source and binary forms, with or
20  *     without modification, are permitted provided that the following
21  *     conditions are met:
22  *
23  *      - Redistributions of source code must retain the above
24  *        copyright notice, this list of conditions and the following
25  *        disclaimer.
26  *
27  *      - Redistributions in binary form must reproduce the above
28  *        copyright notice, this list of conditions and the following
29  *        disclaimer in the documentation and/or other materials
30  *        provided with the distribution.
31  *
32  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
35  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
36  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
37  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
38  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
39  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
41  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
42  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
43  * OF THE POSSIBILITY OF SUCH DAMAGE.
44  */
45 
46 #ifndef __VMW_PVRDMA_ABI_H__
47 #define __VMW_PVRDMA_ABI_H__
48 
49 #include <linux/types.h>
50 
51 #define PVRDMA_UVERBS_ABI_VERSION	3		/* ABI Version. */
52 #define PVRDMA_UAR_HANDLE_MASK		0x00FFFFFF	/* Bottom 24 bits. */
53 #define PVRDMA_UAR_QP_OFFSET		0		/* QP doorbell. */
54 #define PVRDMA_UAR_QP_SEND		BIT(30)		/* Send bit. */
55 #define PVRDMA_UAR_QP_RECV		BIT(31)		/* Recv bit. */
56 #define PVRDMA_UAR_CQ_OFFSET		4		/* CQ doorbell. */
57 #define PVRDMA_UAR_CQ_ARM_SOL		BIT(29)		/* Arm solicited bit. */
58 #define PVRDMA_UAR_CQ_ARM		BIT(30)		/* Arm bit. */
59 #define PVRDMA_UAR_CQ_POLL		BIT(31)		/* Poll bit. */
60 
61 enum pvrdma_wr_opcode {
62 	PVRDMA_WR_RDMA_WRITE,
63 	PVRDMA_WR_RDMA_WRITE_WITH_IMM,
64 	PVRDMA_WR_SEND,
65 	PVRDMA_WR_SEND_WITH_IMM,
66 	PVRDMA_WR_RDMA_READ,
67 	PVRDMA_WR_ATOMIC_CMP_AND_SWP,
68 	PVRDMA_WR_ATOMIC_FETCH_AND_ADD,
69 	PVRDMA_WR_LSO,
70 	PVRDMA_WR_SEND_WITH_INV,
71 	PVRDMA_WR_RDMA_READ_WITH_INV,
72 	PVRDMA_WR_LOCAL_INV,
73 	PVRDMA_WR_FAST_REG_MR,
74 	PVRDMA_WR_MASKED_ATOMIC_CMP_AND_SWP,
75 	PVRDMA_WR_MASKED_ATOMIC_FETCH_AND_ADD,
76 	PVRDMA_WR_BIND_MW,
77 	PVRDMA_WR_REG_SIG_MR,
78 };
79 
80 enum pvrdma_wc_status {
81 	PVRDMA_WC_SUCCESS,
82 	PVRDMA_WC_LOC_LEN_ERR,
83 	PVRDMA_WC_LOC_QP_OP_ERR,
84 	PVRDMA_WC_LOC_EEC_OP_ERR,
85 	PVRDMA_WC_LOC_PROT_ERR,
86 	PVRDMA_WC_WR_FLUSH_ERR,
87 	PVRDMA_WC_MW_BIND_ERR,
88 	PVRDMA_WC_BAD_RESP_ERR,
89 	PVRDMA_WC_LOC_ACCESS_ERR,
90 	PVRDMA_WC_REM_INV_REQ_ERR,
91 	PVRDMA_WC_REM_ACCESS_ERR,
92 	PVRDMA_WC_REM_OP_ERR,
93 	PVRDMA_WC_RETRY_EXC_ERR,
94 	PVRDMA_WC_RNR_RETRY_EXC_ERR,
95 	PVRDMA_WC_LOC_RDD_VIOL_ERR,
96 	PVRDMA_WC_REM_INV_RD_REQ_ERR,
97 	PVRDMA_WC_REM_ABORT_ERR,
98 	PVRDMA_WC_INV_EECN_ERR,
99 	PVRDMA_WC_INV_EEC_STATE_ERR,
100 	PVRDMA_WC_FATAL_ERR,
101 	PVRDMA_WC_RESP_TIMEOUT_ERR,
102 	PVRDMA_WC_GENERAL_ERR,
103 };
104 
105 enum pvrdma_wc_opcode {
106 	PVRDMA_WC_SEND,
107 	PVRDMA_WC_RDMA_WRITE,
108 	PVRDMA_WC_RDMA_READ,
109 	PVRDMA_WC_COMP_SWAP,
110 	PVRDMA_WC_FETCH_ADD,
111 	PVRDMA_WC_BIND_MW,
112 	PVRDMA_WC_LSO,
113 	PVRDMA_WC_LOCAL_INV,
114 	PVRDMA_WC_FAST_REG_MR,
115 	PVRDMA_WC_MASKED_COMP_SWAP,
116 	PVRDMA_WC_MASKED_FETCH_ADD,
117 	PVRDMA_WC_RECV = 1 << 7,
118 	PVRDMA_WC_RECV_RDMA_WITH_IMM,
119 };
120 
121 enum pvrdma_wc_flags {
122 	PVRDMA_WC_GRH			= 1 << 0,
123 	PVRDMA_WC_WITH_IMM		= 1 << 1,
124 	PVRDMA_WC_WITH_INVALIDATE	= 1 << 2,
125 	PVRDMA_WC_IP_CSUM_OK		= 1 << 3,
126 	PVRDMA_WC_WITH_SMAC		= 1 << 4,
127 	PVRDMA_WC_WITH_VLAN		= 1 << 5,
128 	PVRDMA_WC_FLAGS_MAX		= PVRDMA_WC_WITH_VLAN,
129 };
130 
131 struct pvrdma_alloc_ucontext_resp {
132 	__u32 qp_tab_size;
133 	__u32 reserved;
134 };
135 
136 struct pvrdma_alloc_pd_resp {
137 	__u32 pdn;
138 	__u32 reserved;
139 };
140 
141 struct pvrdma_create_cq {
142 	__u64 buf_addr;
143 	__u32 buf_size;
144 	__u32 reserved;
145 };
146 
147 struct pvrdma_create_cq_resp {
148 	__u32 cqn;
149 	__u32 reserved;
150 };
151 
152 struct pvrdma_resize_cq {
153 	__u64 buf_addr;
154 	__u32 buf_size;
155 	__u32 reserved;
156 };
157 
158 struct pvrdma_create_srq {
159 	__u64 buf_addr;
160 };
161 
162 struct pvrdma_create_srq_resp {
163 	__u32 srqn;
164 	__u32 reserved;
165 };
166 
167 struct pvrdma_create_qp {
168 	__u64 rbuf_addr;
169 	__u64 sbuf_addr;
170 	__u32 rbuf_size;
171 	__u32 sbuf_size;
172 	__u64 qp_addr;
173 };
174 
175 /* PVRDMA masked atomic compare and swap */
176 struct pvrdma_ex_cmp_swap {
177 	__u64 swap_val;
178 	__u64 compare_val;
179 	__u64 swap_mask;
180 	__u64 compare_mask;
181 };
182 
183 /* PVRDMA masked atomic fetch and add */
184 struct pvrdma_ex_fetch_add {
185 	__u64 add_val;
186 	__u64 field_boundary;
187 };
188 
189 /* PVRDMA address vector. */
190 struct pvrdma_av {
191 	__u32 port_pd;
192 	__u32 sl_tclass_flowlabel;
193 	__u8 dgid[16];
194 	__u8 src_path_bits;
195 	__u8 gid_index;
196 	__u8 stat_rate;
197 	__u8 hop_limit;
198 	__u8 dmac[6];
199 	__u8 reserved[6];
200 };
201 
202 /* PVRDMA scatter/gather entry */
203 struct pvrdma_sge {
204 	__u64   addr;
205 	__u32   length;
206 	__u32   lkey;
207 };
208 
209 /* PVRDMA receive queue work request */
210 struct pvrdma_rq_wqe_hdr {
211 	__u64 wr_id;		/* wr id */
212 	__u32 num_sge;		/* size of s/g array */
213 	__u32 total_len;	/* reserved */
214 };
215 /* Use pvrdma_sge (ib_sge) for receive queue s/g array elements. */
216 
217 /* PVRDMA send queue work request */
218 struct pvrdma_sq_wqe_hdr {
219 	__u64 wr_id;		/* wr id */
220 	__u32 num_sge;		/* size of s/g array */
221 	__u32 total_len;	/* reserved */
222 	__u32 opcode;		/* operation type */
223 	__u32 send_flags;	/* wr flags */
224 	union {
225 		__u32 imm_data;
226 		__u32 invalidate_rkey;
227 	} ex;
228 	__u32 reserved;
229 	union {
230 		struct {
231 			__u64 remote_addr;
232 			__u32 rkey;
233 			__u8 reserved[4];
234 		} rdma;
235 		struct {
236 			__u64 remote_addr;
237 			__u64 compare_add;
238 			__u64 swap;
239 			__u32 rkey;
240 			__u32 reserved;
241 		} atomic;
242 		struct {
243 			__u64 remote_addr;
244 			__u32 log_arg_sz;
245 			__u32 rkey;
246 			union {
247 				struct pvrdma_ex_cmp_swap  cmp_swap;
248 				struct pvrdma_ex_fetch_add fetch_add;
249 			} wr_data;
250 		} masked_atomics;
251 		struct {
252 			__u64 iova_start;
253 			__u64 pl_pdir_dma;
254 			__u32 page_shift;
255 			__u32 page_list_len;
256 			__u32 length;
257 			__u32 access_flags;
258 			__u32 rkey;
259 		} fast_reg;
260 		struct {
261 			__u32 remote_qpn;
262 			__u32 remote_qkey;
263 			struct pvrdma_av av;
264 		} ud;
265 	} wr;
266 };
267 /* Use pvrdma_sge (ib_sge) for send queue s/g array elements. */
268 
269 /* Completion queue element. */
270 struct pvrdma_cqe {
271 	__u64 wr_id;
272 	__u64 qp;
273 	__u32 opcode;
274 	__u32 status;
275 	__u32 byte_len;
276 	__u32 imm_data;
277 	__u32 src_qp;
278 	__u32 wc_flags;
279 	__u32 vendor_err;
280 	__u16 pkey_index;
281 	__u16 slid;
282 	__u8 sl;
283 	__u8 dlid_path_bits;
284 	__u8 port_num;
285 	__u8 smac[6];
286 	__u8 reserved2[7]; /* Pad to next power of 2 (64). */
287 };
288 
289 #endif /* __VMW_PVRDMA_ABI_H__ */
290