hc
2023-12-06 08f87f769b595151be1afeff53e144f543faa614
kernel/drivers/gpu/arm/bifrost/mali_kbase_js_ctx_attr.h
....@@ -1,7 +1,7 @@
11 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
22 /*
33 *
4
- * (C) COPYRIGHT 2012-2015, 2018, 2020-2021 ARM Limited. All rights reserved.
4
+ * (C) COPYRIGHT 2012-2015, 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,7 +27,8 @@
2727 #define _KBASE_JS_CTX_ATTR_H_
2828
2929 /**
30
- * Retain all attributes of a context
30
+ * kbasep_js_ctx_attr_runpool_retain_ctx - Retain all attributes of a context
31
+ *
3132 * @kbdev: KBase device
3233 * @kctx: KBase context
3334 *
....@@ -42,7 +43,8 @@
4243 void kbasep_js_ctx_attr_runpool_retain_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
4344
4445 /**
45
- * Release all attributes of a context
46
+ * kbasep_js_ctx_attr_runpool_release_ctx - Release all attributes of a context
47
+ *
4648 * @kbdev: KBase device
4749 * @kctx: KBase context
4850 *
....@@ -54,16 +56,17 @@
5456 * - runpool_irq spinlock
5557 * - ctx->is_scheduled is true
5658 *
57
- * @return true indicates a change in ctx attributes state of the runpool.
59
+ * Return: true indicates a change in ctx attributes state of the runpool.
5860 * In this state, the scheduler might be able to submit more jobs than
5961 * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
6062 * or similar is called sometime later.
61
- * @return false indicates no change in ctx attributes state of the runpool.
63
+ * false indicates no change in ctx attributes state of the runpool.
6264 */
6365 bool kbasep_js_ctx_attr_runpool_release_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
6466
6567 /**
66
- * Retain all attributes of an atom
68
+ * kbasep_js_ctx_attr_ctx_retain_atom - Retain all attributes of an atom
69
+ *
6770 * @kbdev: KBase device
6871 * @kctx: KBase context
6972 * @katom: Atom
....@@ -77,7 +80,9 @@
7780 void kbasep_js_ctx_attr_ctx_retain_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbase_jd_atom *katom);
7881
7982 /**
80
- * Release all attributes of an atom, given its retained state.
83
+ * kbasep_js_ctx_attr_ctx_release_atom - Release all attributes of an atom,
84
+ * given its retained state.
85
+ *
8186 * @kbdev: KBase device
8287 * @kctx: KBase context
8388 * @katom_retained_state: Retained state
....@@ -90,11 +95,11 @@
9095 *
9196 * This is a no-op when \a katom_retained_state is invalid.
9297 *
93
- * @return true indicates a change in ctx attributes state of the runpool.
98
+ * Return: true indicates a change in ctx attributes state of the runpool.
9499 * In this state, the scheduler might be able to submit more jobs than
95100 * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
96101 * or similar is called sometime later.
97
- * @return false indicates no change in ctx attributes state of the runpool.
102
+ * false indicates no change in ctx attributes state of the runpool.
98103 */
99104 bool kbasep_js_ctx_attr_ctx_release_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbasep_js_atom_retained_state *katom_retained_state);
100105