| .. | .. |
|---|
| 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 | |
|---|