1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
/*
*
* (C) COPYRIGHT 2012-2015, 2018, 2020-2022 ARM Limited. All rights reserved.
*
* This program is free software and is provided to you under the terms of the
* GNU General Public License version 2 as published by the Free Software
* Foundation, and any use by you of this program is subject to the terms
* of such GNU license.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you can access it online at
* http://www.gnu.org/licenses/gpl-2.0.html.
*
*/
/**
* DOC: Job Scheduler Context Attribute APIs
*/
#ifndef _KBASE_JS_CTX_ATTR_H_
#define _KBASE_JS_CTX_ATTR_H_
/**
* kbasep_js_ctx_attr_runpool_retain_ctx - Retain all attributes of a context
*
* @kbdev: KBase device
* @kctx: KBase context
*
* This occurs on scheduling in the context on the runpool (but after
* is_scheduled is set)
*
* Requires:
* - jsctx mutex
* - runpool_irq spinlock
* - ctx->is_scheduled is true
*/
void kbasep_js_ctx_attr_runpool_retain_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
/**
* kbasep_js_ctx_attr_runpool_release_ctx - Release all attributes of a context
*
* @kbdev: KBase device
* @kctx: KBase context
*
* This occurs on scheduling out the context from the runpool (but before
* is_scheduled is cleared)
*
* Requires:
* - jsctx mutex
* - runpool_irq spinlock
* - ctx->is_scheduled is true
*
* Return: true indicates a change in ctx attributes state of the runpool.
* In this state, the scheduler might be able to submit more jobs than
* previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
* or similar is called sometime later.
* false indicates no change in ctx attributes state of the runpool.
*/
bool kbasep_js_ctx_attr_runpool_release_ctx(struct kbase_device *kbdev, struct kbase_context *kctx);
/**
* kbasep_js_ctx_attr_ctx_retain_atom - Retain all attributes of an atom
*
* @kbdev: KBase device
* @kctx: KBase context
* @katom: Atom
*
* This occurs on adding an atom to a context
*
* Requires:
* - jsctx mutex
* - If the context is scheduled, then runpool_irq spinlock must also be held
*/
void kbasep_js_ctx_attr_ctx_retain_atom(struct kbase_device *kbdev, struct kbase_context *kctx, struct kbase_jd_atom *katom);
/**
* kbasep_js_ctx_attr_ctx_release_atom - Release all attributes of an atom,
* given its retained state.
*
* @kbdev: KBase device
* @kctx: KBase context
* @katom_retained_state: Retained state
*
* This occurs after (permanently) removing an atom from a context
*
* Requires:
* - jsctx mutex
* - If the context is scheduled, then runpool_irq spinlock must also be held
*
* This is a no-op when \a katom_retained_state is invalid.
*
* Return: true indicates a change in ctx attributes state of the runpool.
* In this state, the scheduler might be able to submit more jobs than
* previously, and so the caller should ensure kbasep_js_try_run_next_job_nolock()
* or similar is called sometime later.
* false indicates no change in ctx attributes state of the runpool.
*/
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);
/*
* Requires:
* - runpool_irq spinlock
*/
static inline s8 kbasep_js_ctx_attr_count_on_runpool(struct kbase_device *kbdev, enum kbasep_js_ctx_attr attribute)
{
struct kbasep_js_device_data *js_devdata;
KBASE_DEBUG_ASSERT(kbdev != NULL);
KBASE_DEBUG_ASSERT(attribute < KBASEP_JS_CTX_ATTR_COUNT);
js_devdata = &kbdev->js_data;
return js_devdata->runpool_irq.ctx_attr_ref_count[attribute];
}
/*
* Requires:
* - runpool_irq spinlock
*/
static inline bool kbasep_js_ctx_attr_is_attr_on_runpool(struct kbase_device *kbdev, enum kbasep_js_ctx_attr attribute)
{
/* In general, attributes are 'on' when they have a non-zero refcount (note: the refcount will never be < 0) */
return (bool) kbasep_js_ctx_attr_count_on_runpool(kbdev, attribute);
}
/*
* Requires:
* - jsctx mutex
*/
static inline bool kbasep_js_ctx_attr_is_attr_on_ctx(struct kbase_context *kctx, enum kbasep_js_ctx_attr attribute)
{
struct kbasep_js_kctx_info *js_kctx_info;
KBASE_DEBUG_ASSERT(kctx != NULL);
KBASE_DEBUG_ASSERT(attribute < KBASEP_JS_CTX_ATTR_COUNT);
js_kctx_info = &kctx->jctx.sched_info;
/* In general, attributes are 'on' when they have a refcount (which should never be < 0) */
return (bool) (js_kctx_info->ctx.ctx_attr_ref_count[attribute]);
}
#endif /* _KBASE_JS_DEFS_H_ */
|
