disable FB

hc

2024-01-04 1543e317f1da31b75942316931e8f491a8920811

 kernel/drivers/gpu/arm/bifrost/mali_kbase_js_ctx_attr.c
..
..
@@ -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
..
..
@@ -27,8 +27,9 @@
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,11 +39,11 @@
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,8 +77,9 @@
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,11 +89,11 @@
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,8 +126,9 @@
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,9 +137,9 @@
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,8 +167,9 @@
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,9 +178,9 @@
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
 {