xref: /linux/include/uapi/linux/idxd.h (revision 0ea5c948cb64bab5bc7a5516774eb8536f05aa0d)
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