.. | .. |
---|
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 | 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 | 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 | 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 | 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 | |
---|