.. | .. |
---|
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 |
---|
.. | .. |
---|
27 | 27 | */ |
---|
28 | 28 | |
---|
29 | 29 | /** |
---|
30 | | - * Check whether a ctx has a certain attribute, and if so, retain that |
---|
31 | | - * attribute on the runpool. |
---|
| 30 | + * kbasep_js_ctx_attr_runpool_retain_attr - Check whether a ctx has a certain attribute |
---|
| 31 | + * and if so, retain that attribute on the runpool. |
---|
| 32 | + * |
---|
32 | 33 | * @kbdev: Device pointer |
---|
33 | 34 | * @kctx: KBase context |
---|
34 | 35 | * @attribute: Atribute to check/retain |
---|
.. | .. |
---|
38 | 39 | * - runpool_irq spinlock |
---|
39 | 40 | * - ctx is scheduled on the runpool |
---|
40 | 41 | * |
---|
41 | | - * @return true indicates a change in ctx attributes state of the runpool. |
---|
| 42 | + * Return: true indicates a change in ctx attributes state of the runpool. |
---|
42 | 43 | * In this state, the scheduler might be able to submit more jobs than |
---|
43 | 44 | * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock() |
---|
44 | 45 | * or similar is called sometime later. |
---|
45 | | - * @return false indicates no change in ctx attributes state of the runpool. |
---|
| 46 | + * false indicates no change in ctx attributes state of the runpool. |
---|
46 | 47 | */ |
---|
47 | 48 | static bool kbasep_js_ctx_attr_runpool_retain_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute) |
---|
48 | 49 | { |
---|
.. | .. |
---|
76 | 77 | } |
---|
77 | 78 | |
---|
78 | 79 | /** |
---|
79 | | - * Check whether a ctx has a certain attribute, and if so, release that |
---|
80 | | - * attribute on the runpool. |
---|
| 80 | + * kbasep_js_ctx_attr_runpool_release_attr - Check whether a ctx has a certain attribute, |
---|
| 81 | + * and if so, release that attribute on the runpool. |
---|
| 82 | + * |
---|
81 | 83 | * @kbdev: Device pointer |
---|
82 | 84 | * @kctx: KBase context |
---|
83 | 85 | * @attribute: Atribute to release |
---|
.. | .. |
---|
87 | 89 | * - runpool_irq spinlock |
---|
88 | 90 | * - ctx is scheduled on the runpool |
---|
89 | 91 | * |
---|
90 | | - * @return true indicates a change in ctx attributes state of the runpool. |
---|
| 92 | + * Return: true indicates a change in ctx attributes state of the runpool. |
---|
91 | 93 | * In this state, the scheduler might be able to submit more jobs than |
---|
92 | 94 | * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock() |
---|
93 | 95 | * or similar is called sometime later. |
---|
94 | | - * @return false indicates no change in ctx attributes state of the runpool. |
---|
| 96 | + * false indicates no change in ctx attributes state of the runpool. |
---|
95 | 97 | */ |
---|
96 | 98 | static bool kbasep_js_ctx_attr_runpool_release_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute) |
---|
97 | 99 | { |
---|
.. | .. |
---|
124 | 126 | } |
---|
125 | 127 | |
---|
126 | 128 | /** |
---|
127 | | - * Retain a certain attribute on a ctx, also retaining it on the runpool |
---|
128 | | - * if the context is scheduled. |
---|
| 129 | + * kbasep_js_ctx_attr_ctx_retain_attr - Retain a certain attribute on a ctx, |
---|
| 130 | + * also retaining it on the runpool if the context is scheduled. |
---|
| 131 | + * |
---|
129 | 132 | * @kbdev: Device pointer |
---|
130 | 133 | * @kctx: KBase context |
---|
131 | 134 | * @attribute: Atribute to retain |
---|
.. | .. |
---|
134 | 137 | * - jsctx mutex |
---|
135 | 138 | * - If the context is scheduled, then runpool_irq spinlock must also be held |
---|
136 | 139 | * |
---|
137 | | - * @return true indicates a change in ctx attributes state of the runpool. |
---|
| 140 | + * Return: true indicates a change in ctx attributes state of the runpool. |
---|
138 | 141 | * This may allow the scheduler to submit more jobs than previously. |
---|
139 | | - * @return false indicates no change in ctx attributes state of the runpool. |
---|
| 142 | + * false indicates no change in ctx attributes state of the runpool. |
---|
140 | 143 | */ |
---|
141 | 144 | static bool kbasep_js_ctx_attr_ctx_retain_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute) |
---|
142 | 145 | { |
---|
.. | .. |
---|
164 | 167 | } |
---|
165 | 168 | |
---|
166 | 169 | /** |
---|
167 | | - * Release a certain attribute on a ctx, also releasing it from the runpool |
---|
168 | | - * if the context is scheduled. |
---|
| 170 | + * kbasep_js_ctx_attr_ctx_release_attr - Release a certain attribute on a ctx, |
---|
| 171 | + * also releasing it from the runpool if the context is scheduled. |
---|
| 172 | + * |
---|
169 | 173 | * @kbdev: Device pointer |
---|
170 | 174 | * @kctx: KBase context |
---|
171 | 175 | * @attribute: Atribute to release |
---|
.. | .. |
---|
174 | 178 | * - jsctx mutex |
---|
175 | 179 | * - If the context is scheduled, then runpool_irq spinlock must also be held |
---|
176 | 180 | * |
---|
177 | | - * @return true indicates a change in ctx attributes state of the runpool. |
---|
| 181 | + * Return: true indicates a change in ctx attributes state of the runpool. |
---|
178 | 182 | * This may allow the scheduler to submit more jobs than previously. |
---|
179 | | - * @return false indicates no change in ctx attributes state of the runpool. |
---|
| 183 | + * false indicates no change in ctx attributes state of the runpool. |
---|
180 | 184 | */ |
---|
181 | 185 | static bool kbasep_js_ctx_attr_ctx_release_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute) |
---|
182 | 186 | { |
---|