1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */ 2 /* 3 * Copyright 2014-2022 Advanced Micro Devices, Inc. 4 * 5 * Permission is hereby granted, free of charge, to any person obtaining a 6 * copy of this software and associated documentation files (the "Software"), 7 * to deal in the Software without restriction, including without limitation 8 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 9 * and/or sell copies of the Software, and to permit persons to whom the 10 * Software is furnished to do so, subject to the following conditions: 11 * 12 * The above copyright notice and this permission notice shall be included in 13 * all copies or substantial portions of the Software. 14 * 15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 18 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 19 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 20 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 21 * OTHER DEALINGS IN THE SOFTWARE. 22 */ 23 24 #ifndef KFD_EVENTS_H_INCLUDED 25 #define KFD_EVENTS_H_INCLUDED 26 27 #include <linux/kernel.h> 28 #include <linux/hashtable.h> 29 #include <linux/types.h> 30 #include <linux/list.h> 31 #include <linux/wait.h> 32 #include "kfd_priv.h" 33 #include <uapi/linux/kfd_ioctl.h> 34 35 /* 36 * IDR supports non-negative integer IDs. Small IDs are used for 37 * signal events to match their signal slot. Use the upper half of the 38 * ID space for non-signal events. 39 */ 40 #define KFD_FIRST_NONSIGNAL_EVENT_ID ((INT_MAX >> 1) + 1) 41 #define KFD_LAST_NONSIGNAL_EVENT_ID INT_MAX 42 43 /* 44 * Written into kfd_signal_slot_t to indicate that the event is not signaled. 45 * Since the event protocol may need to write the event ID into memory, this 46 * must not be a valid event ID. 47 * For the sake of easy memset-ing, this must be a byte pattern. 48 */ 49 #define UNSIGNALED_EVENT_SLOT ((uint64_t)-1) 50 51 struct kfd_event_waiter; 52 struct signal_page; 53 54 struct kfd_event { 55 u32 event_id; 56 57 bool signaled; 58 bool auto_reset; 59 60 int type; 61 62 wait_queue_head_t wq; /* List of event waiters. */ 63 64 /* Only for signal events. */ 65 uint64_t __user *user_signal_address; 66 67 /* type specific data */ 68 union { 69 struct kfd_hsa_memory_exception_data memory_exception_data; 70 struct kfd_hsa_hw_exception_data hw_exception_data; 71 }; 72 }; 73 74 #define KFD_EVENT_TIMEOUT_IMMEDIATE 0 75 #define KFD_EVENT_TIMEOUT_INFINITE 0xFFFFFFFFu 76 77 /* Matching HSA_EVENTTYPE */ 78 #define KFD_EVENT_TYPE_SIGNAL 0 79 #define KFD_EVENT_TYPE_HW_EXCEPTION 3 80 #define KFD_EVENT_TYPE_DEBUG 5 81 #define KFD_EVENT_TYPE_MEMORY 8 82 83 extern void kfd_signal_event_interrupt(u32 pasid, uint32_t partial_id, 84 uint32_t valid_id_bits); 85 86 #endif 87