.. | .. |
---|
1 | 1 | /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ |
---|
2 | 2 | /* |
---|
3 | 3 | * |
---|
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. |
---|
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 | #define _KBASE_JS_CTX_ATTR_H_ |
---|
28 | 28 | |
---|
29 | 29 | /** |
---|
30 | | - * Retain all attributes of a context |
---|
| 30 | + * kbasep_js_ctx_attr_runpool_retain_ctx - Retain all attributes of a context |
---|
| 31 | + * |
---|
31 | 32 | * @kbdev: KBase device |
---|
32 | 33 | * @kctx: KBase context |
---|
33 | 34 | * |
---|
.. | .. |
---|
42 | 43 | void kbasep_js_ctx_attr_runpool_retain_ctx(struct kbase_device *kbdev, struct kbase_context *kctx); |
---|
43 | 44 | |
---|
44 | 45 | /** |
---|
45 | | - * Release all attributes of a context |
---|
| 46 | + * kbasep_js_ctx_attr_runpool_release_ctx - Release all attributes of a context |
---|
| 47 | + * |
---|
46 | 48 | * @kbdev: KBase device |
---|
47 | 49 | * @kctx: KBase context |
---|
48 | 50 | * |
---|
.. | .. |
---|
54 | 56 | * - runpool_irq spinlock |
---|
55 | 57 | * - ctx->is_scheduled is true |
---|
56 | 58 | * |
---|
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. |
---|
58 | 60 | * In this state, the scheduler might be able to submit more jobs than |
---|
59 | 61 | * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock() |
---|
60 | 62 | * 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. |
---|
62 | 64 | */ |
---|
63 | 65 | bool kbasep_js_ctx_attr_runpool_release_ctx(struct kbase_device *kbdev, struct kbase_context *kctx); |
---|
64 | 66 | |
---|
65 | 67 | /** |
---|
66 | | - * Retain all attributes of an atom |
---|
| 68 | + * kbasep_js_ctx_attr_ctx_retain_atom - Retain all attributes of an atom |
---|
| 69 | + * |
---|
67 | 70 | * @kbdev: KBase device |
---|
68 | 71 | * @kctx: KBase context |
---|
69 | 72 | * @katom: Atom |
---|
.. | .. |
---|
77 | 80 | void kbasep_js_ctx_attr_ctx_retain_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbase_jd_atom *katom); |
---|
78 | 81 | |
---|
79 | 82 | /** |
---|
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 | + * |
---|
81 | 86 | * @kbdev: KBase device |
---|
82 | 87 | * @kctx: KBase context |
---|
83 | 88 | * @katom_retained_state: Retained state |
---|
.. | .. |
---|
90 | 95 | * |
---|
91 | 96 | * This is a no-op when \a katom_retained_state is invalid. |
---|
92 | 97 | * |
---|
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. |
---|
94 | 99 | * In this state, the scheduler might be able to submit more jobs than |
---|
95 | 100 | * previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock() |
---|
96 | 101 | * 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. |
---|
98 | 103 | */ |
---|
99 | 104 | 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); |
---|
100 | 105 | |
---|