hc
2023-12-06 08f87f769b595151be1afeff53e144f543faa614
kernel/drivers/gpu/arm/bifrost/mali_kbase_js_ctx_attr.c
....@@ -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
....@@ -27,8 +27,9 @@
2727 */
2828
2929 /**
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
+ *
3233 * @kbdev: Device pointer
3334 * @kctx: KBase context
3435 * @attribute: Atribute to check/retain
....@@ -38,11 +39,11 @@
3839 * - runpool_irq spinlock
3940 * - ctx is scheduled on the runpool
4041 *
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.
4243 * In this state, the scheduler might be able to submit more jobs than
4344 * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
4445 * 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.
4647 */
4748 static bool kbasep_js_ctx_attr_runpool_retain_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
4849 {
....@@ -76,8 +77,9 @@
7677 }
7778
7879 /**
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
+ *
8183 * @kbdev: Device pointer
8284 * @kctx: KBase context
8385 * @attribute: Atribute to release
....@@ -87,11 +89,11 @@
8789 * - runpool_irq spinlock
8890 * - ctx is scheduled on the runpool
8991 *
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.
9193 * In this state, the scheduler might be able to submit more jobs than
9294 * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
9395 * 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.
9597 */
9698 static bool kbasep_js_ctx_attr_runpool_release_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
9799 {
....@@ -124,8 +126,9 @@
124126 }
125127
126128 /**
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
+ *
129132 * @kbdev: Device pointer
130133 * @kctx: KBase context
131134 * @attribute: Atribute to retain
....@@ -134,9 +137,9 @@
134137 * - jsctx mutex
135138 * - If the context is scheduled, then runpool_irq spinlock must also be held
136139 *
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.
138141 * 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.
140143 */
141144 static bool kbasep_js_ctx_attr_ctx_retain_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
142145 {
....@@ -164,8 +167,9 @@
164167 }
165168
166169 /**
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
+ *
169173 * @kbdev: Device pointer
170174 * @kctx: KBase context
171175 * @attribute: Atribute to release
....@@ -174,9 +178,9 @@
174178 * - jsctx mutex
175179 * - If the context is scheduled, then runpool_irq spinlock must also be held
176180 *
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.
178182 * 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.
180184 */
181185 static bool kbasep_js_ctx_attr_ctx_release_attr(struct kbase_device *kbdev, struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
182186 {