xref: /linux/include/uapi/linux/idxd.h (revision ab1c247094e323177a578b38f0325bf79f0317ac)
1 /* SPDX-License-Identifier: LGPL-2.1 WITH Linux-syscall-note */
2 /* Copyright(c) 2019 Intel Corporation. All rights rsvd. */
3 #ifndef _USR_IDXD_H_
4 #define _USR_IDXD_H_
5 
6 #ifdef __KERNEL__
7 #include <linux/types.h>
8 #else
9 #include <stdint.h>
10 #endif
11 
12 /* Driver command error status */
13 enum idxd_scmd_stat {
14 	IDXD_SCMD_DEV_ENABLED = 0x80000010,
15 	IDXD_SCMD_DEV_NOT_ENABLED = 0x80000020,
16 	IDXD_SCMD_WQ_ENABLED = 0x80000021,
17 	IDXD_SCMD_DEV_DMA_ERR = 0x80020000,
18 	IDXD_SCMD_WQ_NO_GRP = 0x80030000,
19 	IDXD_SCMD_WQ_NO_NAME = 0x80040000,
20 	IDXD_SCMD_WQ_NO_SVM = 0x80050000,
21 	IDXD_SCMD_WQ_NO_THRESH = 0x80060000,
22 	IDXD_SCMD_WQ_PORTAL_ERR = 0x80070000,
23 	IDXD_SCMD_WQ_RES_ALLOC_ERR = 0x80080000,
24 	IDXD_SCMD_PERCPU_ERR = 0x80090000,
25 	IDXD_SCMD_DMA_CHAN_ERR = 0x800a0000,
26 	IDXD_SCMD_CDEV_ERR = 0x800b0000,
27 	IDXD_SCMD_WQ_NO_SWQ_SUPPORT = 0x800c0000,
28 	IDXD_SCMD_WQ_NONE_CONFIGURED = 0x800d0000,
29 	IDXD_SCMD_WQ_NO_SIZE = 0x800e0000,
30 	IDXD_SCMD_WQ_NO_PRIV = 0x800f0000,
31 	IDXD_SCMD_WQ_IRQ_ERR = 0x80100000,
32 	IDXD_SCMD_WQ_USER_NO_IOMMU = 0x80110000,
33 	IDXD_SCMD_DEV_EVL_ERR = 0x80120000,
34 	IDXD_SCMD_WQ_NO_DRV_NAME = 0x80200000,
35 };
36 
37 #define IDXD_SCMD_SOFTERR_MASK	0x80000000
38 #define IDXD_SCMD_SOFTERR_SHIFT	16
39 
40 /* Descriptor flags */
41 #define IDXD_OP_FLAG_FENCE	0x0001
42 #define IDXD_OP_FLAG_BOF	0x0002
43 #define IDXD_OP_FLAG_CRAV	0x0004
44 #define IDXD_OP_FLAG_RCR	0x0008
45 #define IDXD_OP_FLAG_RCI	0x0010
46 #define IDXD_OP_FLAG_CRSTS	0x0020
47 #define IDXD_OP_FLAG_CR		0x0080
48 #define IDXD_OP_FLAG_CC		0x0100
49 #define IDXD_OP_FLAG_ADDR1_TCS	0x0200
50 #define IDXD_OP_FLAG_ADDR2_TCS	0x0400
51 #define IDXD_OP_FLAG_ADDR3_TCS	0x0800
52 #define IDXD_OP_FLAG_CR_TCS	0x1000
53 #define IDXD_OP_FLAG_STORD	0x2000
54 #define IDXD_OP_FLAG_DRDBK	0x4000
55 #define IDXD_OP_FLAG_DSTS	0x8000
56 
57 /* IAX */
58 #define IDXD_OP_FLAG_RD_SRC2_AECS	0x010000
59 #define IDXD_OP_FLAG_RD_SRC2_2ND	0x020000
60 #define IDXD_OP_FLAG_WR_SRC2_AECS_COMP	0x040000
61 #define IDXD_OP_FLAG_WR_SRC2_AECS_OVFL	0x080000
62 #define IDXD_OP_FLAG_SRC2_STS		0x100000
63 #define IDXD_OP_FLAG_CRC_RFC3720	0x200000
64 
65 /* Opcode */
66 enum dsa_opcode {
67 	DSA_OPCODE_NOOP = 0,
68 	DSA_OPCODE_BATCH,
69 	DSA_OPCODE_DRAIN,
70 	DSA_OPCODE_MEMMOVE,
71 	DSA_OPCODE_MEMFILL,
72 	DSA_OPCODE_COMPARE,
73 	DSA_OPCODE_COMPVAL,
74 	DSA_OPCODE_CR_DELTA,
75 	DSA_OPCODE_AP_DELTA,
76 	DSA_OPCODE_DUALCAST,
77 	DSA_OPCODE_TRANSL_FETCH,
78 	DSA_OPCODE_CRCGEN = 0x10,
79 	DSA_OPCODE_COPY_CRC,
80 	DSA_OPCODE_DIF_CHECK,
81 	DSA_OPCODE_DIF_INS,
82 	DSA_OPCODE_DIF_STRP,
83 	DSA_OPCODE_DIF_UPDT,
84 	DSA_OPCODE_DIX_GEN = 0x17,
85 	DSA_OPCODE_CFLUSH = 0x20,
86 };
87 
88 enum iax_opcode {
89 	IAX_OPCODE_NOOP = 0,
90 	IAX_OPCODE_DRAIN = 2,
91 	IAX_OPCODE_MEMMOVE,
92 	IAX_OPCODE_DECOMPRESS = 0x42,
93 	IAX_OPCODE_COMPRESS,
94 	IAX_OPCODE_CRC64,
95 	IAX_OPCODE_ZERO_DECOMP_32 = 0x48,
96 	IAX_OPCODE_ZERO_DECOMP_16,
97 	IAX_OPCODE_ZERO_COMP_32 = 0x4c,
98 	IAX_OPCODE_ZERO_COMP_16,
99 	IAX_OPCODE_SCAN = 0x50,
100 	IAX_OPCODE_SET_MEMBER,
101 	IAX_OPCODE_EXTRACT,
102 	IAX_OPCODE_SELECT,
103 	IAX_OPCODE_RLE_BURST,
104 	IAX_OPCODE_FIND_UNIQUE,
105 	IAX_OPCODE_EXPAND,
106 };
107 
108 /* Completion record status */
109 enum dsa_completion_status {
110 	DSA_COMP_NONE = 0,
111 	DSA_COMP_SUCCESS,
112 	DSA_COMP_SUCCESS_PRED,
113 	DSA_COMP_PAGE_FAULT_NOBOF,
114 	DSA_COMP_PAGE_FAULT_IR,
115 	DSA_COMP_BATCH_FAIL,
116 	DSA_COMP_BATCH_PAGE_FAULT,
117 	DSA_COMP_DR_OFFSET_NOINC,
118 	DSA_COMP_DR_OFFSET_ERANGE,
119 	DSA_COMP_DIF_ERR,
120 	DSA_COMP_BAD_OPCODE = 0x10,
121 	DSA_COMP_INVALID_FLAGS,
122 	DSA_COMP_NOZERO_RESERVE,
123 	DSA_COMP_XFER_ERANGE,
124 	DSA_COMP_DESC_CNT_ERANGE,
125 	DSA_COMP_DR_ERANGE,
126 	DSA_COMP_OVERLAP_BUFFERS,
127 	DSA_COMP_DCAST_ERR,
128 	DSA_COMP_DESCLIST_ALIGN,
129 	DSA_COMP_INT_HANDLE_INVAL,
130 	DSA_COMP_CRA_XLAT,
131 	DSA_COMP_CRA_ALIGN,
132 	DSA_COMP_ADDR_ALIGN,
133 	DSA_COMP_PRIV_BAD,
134 	DSA_COMP_TRAFFIC_CLASS_CONF,
135 	DSA_COMP_PFAULT_RDBA,
136 	DSA_COMP_HW_ERR1,
137 	DSA_COMP_HW_ERR_DRB,
138 	DSA_COMP_TRANSLATION_FAIL,
139 	DSA_COMP_DRAIN_EVL = 0x26,
140 	DSA_COMP_BATCH_EVL_ERR,
141 };
142 
143 enum iax_completion_status {
144 	IAX_COMP_NONE = 0,
145 	IAX_COMP_SUCCESS,
146 	IAX_COMP_PAGE_FAULT_IR = 0x04,
147 	IAX_COMP_ANALYTICS_ERROR = 0x0a,
148 	IAX_COMP_OUTBUF_OVERFLOW,
149 	IAX_COMP_BAD_OPCODE = 0x10,
150 	IAX_COMP_INVALID_FLAGS,
151 	IAX_COMP_NOZERO_RESERVE,
152 	IAX_COMP_INVALID_SIZE,
153 	IAX_COMP_OVERLAP_BUFFERS = 0x16,
154 	IAX_COMP_INT_HANDLE_INVAL = 0x19,
155 	IAX_COMP_CRA_XLAT,
156 	IAX_COMP_CRA_ALIGN,
157 	IAX_COMP_ADDR_ALIGN,
158 	IAX_COMP_PRIV_BAD,
159 	IAX_COMP_TRAFFIC_CLASS_CONF,
160 	IAX_COMP_PFAULT_RDBA,
161 	IAX_COMP_HW_ERR1,
162 	IAX_COMP_HW_ERR_DRB,
163 	IAX_COMP_TRANSLATION_FAIL,
164 	IAX_COMP_PRS_TIMEOUT,
165 	IAX_COMP_WATCHDOG,
166 	IAX_COMP_INVALID_COMP_FLAG = 0x30,
167 	IAX_COMP_INVALID_FILTER_FLAG,
168 	IAX_COMP_INVALID_INPUT_SIZE,
169 	IAX_COMP_INVALID_NUM_ELEMS,
170 	IAX_COMP_INVALID_SRC1_WIDTH,
171 	IAX_COMP_INVALID_INVERT_OUT,
172 };
173 
174 #define DSA_COMP_STATUS_MASK		0x7f
175 #define DSA_COMP_STATUS_WRITE		0x80
176 #define DSA_COMP_STATUS(status)		((status) & DSA_COMP_STATUS_MASK)
177 
178 struct dsa_hw_desc {
179 	uint32_t	pasid:20;
180 	uint32_t	rsvd:11;
181 	uint32_t	priv:1;
182 	uint32_t	flags:24;
183 	uint32_t	opcode:8;
184 	uint64_t	completion_addr;
185 	union {
186 		uint64_t	src_addr;
187 		uint64_t	rdback_addr;
188 		uint64_t	pattern;
189 		uint64_t	desc_list_addr;
190 		uint64_t	pattern_lower;
191 		uint64_t	transl_fetch_addr;
192 	};
193 	union {
194 		uint64_t	dst_addr;
195 		uint64_t	rdback_addr2;
196 		uint64_t	src2_addr;
197 		uint64_t	comp_pattern;
198 	};
199 	union {
200 		uint32_t	xfer_size;
201 		uint32_t	desc_count;
202 		uint32_t	region_size;
203 	};
204 	uint16_t	int_handle;
205 	uint16_t	rsvd1;
206 	union {
207 		uint8_t		expected_res;
208 		/* create delta record */
209 		struct {
210 			uint64_t	delta_addr;
211 			uint32_t	max_delta_size;
212 			uint32_t 	delt_rsvd;
213 			uint8_t 	expected_res_mask;
214 		};
215 		uint32_t	delta_rec_size;
216 		uint64_t	dest2;
217 		/* CRC */
218 		struct {
219 			uint32_t	crc_seed;
220 			uint32_t	crc_rsvd;
221 			uint64_t	seed_addr;
222 		};
223 		/* DIF check or strip */
224 		struct {
225 			uint8_t		src_dif_flags;
226 			uint8_t		dif_chk_res;
227 			uint8_t		dif_chk_flags;
228 			uint8_t		dif_chk_res2[5];
229 			uint32_t	chk_ref_tag_seed;
230 			uint16_t	chk_app_tag_mask;
231 			uint16_t	chk_app_tag_seed;
232 		};
233 		/* DIF insert */
234 		struct {
235 			uint8_t		dif_ins_res;
236 			uint8_t		dest_dif_flag;
237 			uint8_t		dif_ins_flags;
238 			uint8_t		dif_ins_res2[13];
239 			uint32_t	ins_ref_tag_seed;
240 			uint16_t	ins_app_tag_mask;
241 			uint16_t	ins_app_tag_seed;
242 		};
243 		/* DIF update */
244 		struct {
245 			uint8_t		src_upd_flags;
246 			uint8_t		upd_dest_flags;
247 			uint8_t		dif_upd_flags;
248 			uint8_t		dif_upd_res[5];
249 			uint32_t	src_ref_tag_seed;
250 			uint16_t	src_app_tag_mask;
251 			uint16_t	src_app_tag_seed;
252 			uint32_t	dest_ref_tag_seed;
253 			uint16_t	dest_app_tag_mask;
254 			uint16_t	dest_app_tag_seed;
255 		};
256 
257 		/* Fill */
258 		uint64_t	pattern_upper;
259 
260 		/* Translation fetch */
261 		struct {
262 			uint64_t	transl_fetch_res;
263 			uint32_t	region_stride;
264 		};
265 
266 		/* DIX generate */
267 		struct {
268 			uint8_t		dix_gen_res;
269 			uint8_t		dest_dif_flags;
270 			uint8_t		dif_flags;
271 			uint8_t		dix_gen_res2[13];
272 			uint32_t	ref_tag_seed;
273 			uint16_t	app_tag_mask;
274 			uint16_t	app_tag_seed;
275 		};
276 
277 		uint8_t		op_specific[24];
278 	};
279 } __attribute__((packed));
280 
281 struct iax_hw_desc {
282 	uint32_t        pasid:20;
283 	uint32_t        rsvd:11;
284 	uint32_t        priv:1;
285 	uint32_t        flags:24;
286 	uint32_t        opcode:8;
287 	uint64_t        completion_addr;
288 	uint64_t        src1_addr;
289 	uint64_t        dst_addr;
290 	uint32_t        src1_size;
291 	uint16_t        int_handle;
292 	union {
293 		uint16_t        compr_flags;
294 		uint16_t        decompr_flags;
295 	};
296 	uint64_t        src2_addr;
297 	uint32_t        max_dst_size;
298 	uint32_t        src2_size;
299 	uint32_t	filter_flags;
300 	uint32_t	num_inputs;
301 } __attribute__((packed));
302 
303 struct dsa_raw_desc {
304 	uint64_t	field[8];
305 } __attribute__((packed));
306 
307 /*
308  * The status field will be modified by hardware, therefore it should be
309  * volatile and prevent the compiler from optimize the read.
310  */
311 struct dsa_completion_record {
312 	volatile uint8_t	status;
313 	union {
314 		uint8_t		result;
315 		uint8_t		dif_status;
316 	};
317 	uint8_t			fault_info;
318 	uint8_t			rsvd;
319 	union {
320 		uint32_t		bytes_completed;
321 		uint32_t		descs_completed;
322 	};
323 	uint64_t		fault_addr;
324 	union {
325 		/* common record */
326 		struct {
327 			uint32_t	invalid_flags:24;
328 			uint32_t	rsvd2:8;
329 		};
330 
331 		uint32_t	delta_rec_size;
332 		uint64_t	crc_val;
333 
334 		/* DIF check & strip */
335 		struct {
336 			uint32_t	dif_chk_ref_tag;
337 			uint16_t	dif_chk_app_tag_mask;
338 			uint16_t	dif_chk_app_tag;
339 		};
340 
341 		/* DIF insert */
342 		struct {
343 			uint64_t	dif_ins_res;
344 			uint32_t	dif_ins_ref_tag;
345 			uint16_t	dif_ins_app_tag_mask;
346 			uint16_t	dif_ins_app_tag;
347 		};
348 
349 		/* DIF update */
350 		struct {
351 			uint32_t	dif_upd_src_ref_tag;
352 			uint16_t	dif_upd_src_app_tag_mask;
353 			uint16_t	dif_upd_src_app_tag;
354 			uint32_t	dif_upd_dest_ref_tag;
355 			uint16_t	dif_upd_dest_app_tag_mask;
356 			uint16_t	dif_upd_dest_app_tag;
357 		};
358 
359 		/* DIX generate */
360 		struct {
361 			uint64_t	dix_gen_res;
362 			uint32_t	dix_ref_tag;
363 			uint16_t	dix_app_tag_mask;
364 			uint16_t	dix_app_tag;
365 		};
366 
367 		uint8_t		op_specific[16];
368 	};
369 } __attribute__((packed));
370 
371 struct dsa_raw_completion_record {
372 	uint64_t	field[4];
373 } __attribute__((packed));
374 
375 struct iax_completion_record {
376 	volatile uint8_t        status;
377 	uint8_t                 error_code;
378 	uint8_t			fault_info;
379 	uint8_t			rsvd;
380 	uint32_t                bytes_completed;
381 	uint64_t                fault_addr;
382 	uint32_t                invalid_flags;
383 	uint32_t                rsvd2;
384 	uint32_t                output_size;
385 	uint8_t                 output_bits;
386 	uint8_t                 rsvd3;
387 	uint16_t                xor_csum;
388 	uint32_t                crc;
389 	uint32_t                min;
390 	uint32_t                max;
391 	uint32_t                sum;
392 	uint64_t                rsvd4[2];
393 } __attribute__((packed));
394 
395 struct iax_raw_completion_record {
396 	uint64_t	field[8];
397 } __attribute__((packed));
398 
399 #endif
400