disable FB

hc

2024-01-04 1543e317f1da31b75942316931e8f491a8920811

 kernel/drivers/gpu/arm/bifrost/mali_kbase_debug_job_fault.h
..
..
@@ -1,7 +1,7 @@
1
1
 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2
2
 /*
3
3
  *
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.
5
5
  *
6
6
  * This program is free software and is provided to you under the terms of the
7
7
  * GNU General Public License version 2 as published by the Free Software
..
..
@@ -53,7 +53,7 @@
53
53
  * kbase_debug_job_fault_context_init - Initialize the relevant
54
54
  *		data structure per context
55
55
  * @kctx: KBase context pointer
56
- * @return 0 on success
56
+ * Return: 0 on success
57
57
  */
58
58
 int kbase_debug_job_fault_context_init(struct kbase_context *kctx);
59
59
 
..
..
@@ -68,31 +68,33 @@
68
68
  * kbase_debug_job_fault_kctx_unblock - Unblock the atoms blocked on job fault
69
69
  *					dumping on context termination.
70
70
  *
71
+ * @kctx: KBase context pointer
72
+ *
71
73
  * This function is called during context termination to unblock the atom for
72
74
  * which the job fault occurred and also the atoms following it. This is needed
73
75
  * otherwise the wait for zero jobs could timeout (leading to an assertion
74
76
  * failure, kernel panic in debug builds) in the pathological case where
75
77
  * although the thread/daemon capturing the job fault events is running,
76
78
  * but for some reasons has stopped consuming the events.
77
- *
78
- * @kctx: KBase context pointer
79
79
  */
80
80
 void kbase_debug_job_fault_kctx_unblock(struct kbase_context *kctx);
81
81
 
82
82
 /**
83
83
  * 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
+ *
89
85
  * @katom: The failed atom pointer
90
86
  * @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
92
95
  */
93
96
 bool kbase_debug_job_fault_process(struct kbase_jd_atom *katom,
94
97
 		u32 completion_code);
95
-
96
98
 
97
99
 /**
98
100
  * kbase_debug_job_fault_reg_snapshot_init - Set the interested registers
..
..
@@ -100,7 +102,8 @@
100
102
  *      be saved when a job fault happen
101
103
  * @kctx: KBase context pointer
102
104
  * @reg_range: Maximum register address space
103
- * @return true if initializing successfully
105
+ *
106
+ * Return: true if initializing successfully
104
107
  */
105
108
 bool kbase_debug_job_fault_reg_snapshot_init(struct kbase_context *kctx,
106
109
 		int reg_range);
..
..
@@ -108,8 +111,10 @@
108
111
 /**
109
112
  * kbase_job_fault_get_reg_snapshot - Read the interested registers for
110
113
  *      failed job dump
114
+ *
111
115
  * @kctx: KBase context pointer
112
- * @return true if getting registers successfully
116
+ *
117
+ * Return: true if getting registers successfully
113
118
  */
114
119
 bool kbase_job_fault_get_reg_snapshot(struct kbase_context *kctx);
115
120