cxl.h (3951B)
1/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2/* 3 * Copyright 2014 IBM Corp. 4 * 5 * This program is free software; you can redistribute it and/or 6 * modify it under the terms of the GNU General Public License 7 * as published by the Free Software Foundation; either version 8 * 2 of the License, or (at your option) any later version. 9 */ 10 11#ifndef _UAPI_MISC_CXL_H 12#define _UAPI_MISC_CXL_H 13 14#include <linux/types.h> 15#include <linux/ioctl.h> 16 17 18struct cxl_ioctl_start_work { 19 __u64 flags; 20 __u64 work_element_descriptor; 21 __u64 amr; 22 __s16 num_interrupts; 23 __u16 tid; 24 __s32 reserved1; 25 __u64 reserved2; 26 __u64 reserved3; 27 __u64 reserved4; 28 __u64 reserved5; 29}; 30 31#define CXL_START_WORK_AMR 0x0000000000000001ULL 32#define CXL_START_WORK_NUM_IRQS 0x0000000000000002ULL 33#define CXL_START_WORK_ERR_FF 0x0000000000000004ULL 34#define CXL_START_WORK_TID 0x0000000000000008ULL 35#define CXL_START_WORK_ALL (CXL_START_WORK_AMR |\ 36 CXL_START_WORK_NUM_IRQS |\ 37 CXL_START_WORK_ERR_FF |\ 38 CXL_START_WORK_TID) 39 40 41/* Possible modes that an afu can be in */ 42#define CXL_MODE_DEDICATED 0x1 43#define CXL_MODE_DIRECTED 0x2 44 45/* possible flags for the cxl_afu_id flags field */ 46#define CXL_AFUID_FLAG_SLAVE 0x1 /* In directed-mode afu is in slave mode */ 47 48struct cxl_afu_id { 49 __u64 flags; /* One of CXL_AFUID_FLAG_X */ 50 __u32 card_id; 51 __u32 afu_offset; 52 __u32 afu_mode; /* one of the CXL_MODE_X */ 53 __u32 reserved1; 54 __u64 reserved2; 55 __u64 reserved3; 56 __u64 reserved4; 57 __u64 reserved5; 58 __u64 reserved6; 59}; 60 61/* base adapter image header is included in the image */ 62#define CXL_AI_NEED_HEADER 0x0000000000000001ULL 63#define CXL_AI_ALL CXL_AI_NEED_HEADER 64 65#define CXL_AI_HEADER_SIZE 128 66#define CXL_AI_BUFFER_SIZE 4096 67#define CXL_AI_MAX_ENTRIES 256 68#define CXL_AI_MAX_CHUNK_SIZE (CXL_AI_BUFFER_SIZE * CXL_AI_MAX_ENTRIES) 69 70struct cxl_adapter_image { 71 __u64 flags; 72 __u64 data; 73 __u64 len_data; 74 __u64 len_image; 75 __u64 reserved1; 76 __u64 reserved2; 77 __u64 reserved3; 78 __u64 reserved4; 79}; 80 81/* ioctl numbers */ 82#define CXL_MAGIC 0xCA 83/* AFU devices */ 84#define CXL_IOCTL_START_WORK _IOW(CXL_MAGIC, 0x00, struct cxl_ioctl_start_work) 85#define CXL_IOCTL_GET_PROCESS_ELEMENT _IOR(CXL_MAGIC, 0x01, __u32) 86#define CXL_IOCTL_GET_AFU_ID _IOR(CXL_MAGIC, 0x02, struct cxl_afu_id) 87/* adapter devices */ 88#define CXL_IOCTL_DOWNLOAD_IMAGE _IOW(CXL_MAGIC, 0x0A, struct cxl_adapter_image) 89#define CXL_IOCTL_VALIDATE_IMAGE _IOW(CXL_MAGIC, 0x0B, struct cxl_adapter_image) 90 91#define CXL_READ_MIN_SIZE 0x1000 /* 4K */ 92 93/* Events from read() */ 94enum cxl_event_type { 95 CXL_EVENT_RESERVED = 0, 96 CXL_EVENT_AFU_INTERRUPT = 1, 97 CXL_EVENT_DATA_STORAGE = 2, 98 CXL_EVENT_AFU_ERROR = 3, 99 CXL_EVENT_AFU_DRIVER = 4, 100}; 101 102struct cxl_event_header { 103 __u16 type; 104 __u16 size; 105 __u16 process_element; 106 __u16 reserved1; 107}; 108 109struct cxl_event_afu_interrupt { 110 __u16 flags; 111 __u16 irq; /* Raised AFU interrupt number */ 112 __u32 reserved1; 113}; 114 115struct cxl_event_data_storage { 116 __u16 flags; 117 __u16 reserved1; 118 __u32 reserved2; 119 __u64 addr; 120 __u64 dsisr; 121 __u64 reserved3; 122}; 123 124struct cxl_event_afu_error { 125 __u16 flags; 126 __u16 reserved1; 127 __u32 reserved2; 128 __u64 error; 129}; 130 131struct cxl_event_afu_driver_reserved { 132 /* 133 * Defines the buffer passed to the cxl driver by the AFU driver. 134 * 135 * This is not ABI since the event header.size passed to the user for 136 * existing events is set in the read call to sizeof(cxl_event_header) 137 * + sizeof(whatever event is being dispatched) and the user is already 138 * required to use a 4K buffer on the read call. 139 * 140 * Of course the contents will be ABI, but that's up the AFU driver. 141 */ 142 __u32 data_size; 143 __u8 data[]; 144}; 145 146struct cxl_event { 147 struct cxl_event_header header; 148 union { 149 struct cxl_event_afu_interrupt irq; 150 struct cxl_event_data_storage fault; 151 struct cxl_event_afu_error afu_error; 152 struct cxl_event_afu_driver_reserved afu_driver_event; 153 }; 154}; 155 156#endif /* _UAPI_MISC_CXL_H */