hc
2024-05-16 8d2a02b24d66aa359e83eebc1ed3c0f85367a1cb
kernel/drivers/gpu/arm/bifrost/mali_kbase_debug_job_fault.h
....@@ -1,7 +1,7 @@
11 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
22 /*
33 *
4
- * (C) COPYRIGHT 2012-2016, 2018, 2020-2021 ARM Limited. All rights reserved.
4
+ * (C) COPYRIGHT 2012-2016, 2018, 2020-2022 ARM Limited. All rights reserved.
55 *
66 * This program is free software and is provided to you under the terms of the
77 * GNU General Public License version 2 as published by the Free Software
....@@ -53,7 +53,7 @@
5353 * kbase_debug_job_fault_context_init - Initialize the relevant
5454 * data structure per context
5555 * @kctx: KBase context pointer
56
- * @return 0 on success
56
+ * Return: 0 on success
5757 */
5858 int kbase_debug_job_fault_context_init(struct kbase_context *kctx);
5959
....@@ -68,31 +68,33 @@
6868 * kbase_debug_job_fault_kctx_unblock - Unblock the atoms blocked on job fault
6969 * dumping on context termination.
7070 *
71
+ * @kctx: KBase context pointer
72
+ *
7173 * This function is called during context termination to unblock the atom for
7274 * which the job fault occurred and also the atoms following it. This is needed
7375 * otherwise the wait for zero jobs could timeout (leading to an assertion
7476 * failure, kernel panic in debug builds) in the pathological case where
7577 * although the thread/daemon capturing the job fault events is running,
7678 * but for some reasons has stopped consuming the events.
77
- *
78
- * @kctx: KBase context pointer
7979 */
8080 void kbase_debug_job_fault_kctx_unblock(struct kbase_context *kctx);
8181
8282 /**
8383 * kbase_debug_job_fault_process - Process the failed job.
84
- * It will send a event and wake up the job fault waiting queue
85
- * Then create a work queue to wait for job dump finish
86
- * This function should be called in the interrupt handler and before
87
- * jd_done that make sure the jd_done_worker will be delayed until the
88
- * job dump finish
84
+ *
8985 * @katom: The failed atom pointer
9086 * @completion_code: the job status
91
- * @return true if dump is going on
87
+ *
88
+ * It will send a event and wake up the job fault waiting queue
89
+ * Then create a work queue to wait for job dump finish
90
+ * This function should be called in the interrupt handler and before
91
+ * jd_done that make sure the jd_done_worker will be delayed until the
92
+ * job dump finish
93
+ *
94
+ * Return: true if dump is going on
9295 */
9396 bool kbase_debug_job_fault_process(struct kbase_jd_atom *katom,
9497 u32 completion_code);
95
-
9698
9799 /**
98100 * kbase_debug_job_fault_reg_snapshot_init - Set the interested registers
....@@ -100,7 +102,8 @@
100102 * be saved when a job fault happen
101103 * @kctx: KBase context pointer
102104 * @reg_range: Maximum register address space
103
- * @return true if initializing successfully
105
+ *
106
+ * Return: true if initializing successfully
104107 */
105108 bool kbase_debug_job_fault_reg_snapshot_init(struct kbase_context *kctx,
106109 int reg_range);
....@@ -108,8 +111,10 @@
108111 /**
109112 * kbase_job_fault_get_reg_snapshot - Read the interested registers for
110113 * failed job dump
114
+ *
111115 * @kctx: KBase context pointer
112
- * @return true if getting registers successfully
116
+ *
117
+ * Return: true if getting registers successfully
113118 */
114119 bool kbase_job_fault_get_reg_snapshot(struct kbase_context *kctx);
115120