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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
/*
* Copyright (c) 2014, STMicroelectronics International N.V.
* Copyright (c) 2017, Linaro Limited
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef TEE_TA_MANAGER_H
#define TEE_TA_MANAGER_H
#include <types_ext.h>
#include <sys/queue.h>
#include <tee_api_types.h>
#include <utee_types.h>
#include <kernel/tee_common.h>
#include <kernel/mutex.h>
#include <tee_api_types.h>
#include <user_ta_header.h>
/* Magic TEE identity pointer: set when teecore requests a TA close */
#define KERN_IDENTITY ((TEE_Identity *)-1)
/* Operation is initiated by a client (non-secure) app */
#define NSAPP_IDENTITY (NULL)
TAILQ_HEAD(tee_ta_session_head, tee_ta_session);
TAILQ_HEAD(tee_ta_ctx_head, tee_ta_ctx);
struct mobj;
struct param_val {
uint32_t a;
uint32_t b;
};
struct param_mem {
struct mobj *mobj;
size_t size;
size_t offs;
};
struct tee_ta_param {
uint32_t types;
union {
struct param_val val;
struct param_mem mem;
} u[TEE_NUM_PARAMS];
};
struct tee_ta_ctx;
struct user_ta_ctx;
struct pseudo_ta_ctx;
struct tee_ta_ops {
TEE_Result (*enter_open_session)(struct tee_ta_session *s,
struct tee_ta_param *param, TEE_ErrorOrigin *eo);
TEE_Result (*enter_invoke_cmd)(struct tee_ta_session *s, uint32_t cmd,
struct tee_ta_param *param, TEE_ErrorOrigin *eo);
void (*enter_close_session)(struct tee_ta_session *s);
void (*dump_state)(struct tee_ta_ctx *ctx);
void (*destroy)(struct tee_ta_ctx *ctx);
uint32_t (*get_instance_id)(struct tee_ta_ctx *ctx);
};
#if defined(CFG_TA_GPROF_SUPPORT)
struct sample_buf {
uint32_t nsamples; /* Size of @samples array in uint16_t */
uint32_t offset; /* Passed from user mode */
uint32_t scale; /* Passed from user mode */
uint32_t count; /* Number of samples taken */
bool enabled; /* Sampling enabled? */
uint16_t *samples;
uint64_t usr; /* Total user CPU time for this session */
uint64_t usr_entered; /* When this session last entered user mode */
uint32_t freq; /* @usr divided by @freq is in seconds */
};
#endif
/* Context of a loaded TA */
struct tee_ta_ctx {
TEE_UUID uuid;
const struct tee_ta_ops *ops;
uint32_t flags; /* TA_FLAGS from TA header */
TAILQ_ENTRY(tee_ta_ctx) link;
uint32_t panicked; /* True if TA has panicked, written from asm */
uint32_t panic_code; /* Code supplied for panic */
uint32_t ref_count; /* Reference counter for multi session TA */
bool busy; /* context is busy and cannot be entered */
struct condvar busy_cv; /* CV used when context is busy */
};
struct tee_ta_session {
TAILQ_ENTRY(tee_ta_session) link;
TAILQ_ENTRY(tee_ta_session) link_tsd;
struct tee_ta_ctx *ctx; /* TA context */
TEE_Identity clnt_id; /* Identify of client */
bool cancel; /* True if TAF is cancelled */
bool cancel_mask; /* True if cancel is masked */
TEE_Time cancel_time; /* Time when to cancel the TAF */
void *user_ctx; /* ??? */
uint32_t ref_count; /* reference counter */
struct condvar refc_cv; /* CV used to wait for ref_count to be 0 */
struct condvar lock_cv; /* CV used to wait for lock */
int lock_thread; /* Id of thread holding the lock */
bool unlink; /* True if session is to be unlinked */
#if defined(CFG_TA_GPROF_SUPPORT)
struct sample_buf *sbuf; /* Profiling data (PC sampling) */
#endif
};
/* Registered contexts */
extern struct tee_ta_ctx_head tee_ctxes;
extern struct mutex tee_ta_mutex;
TEE_Result tee_ta_open_session(TEE_ErrorOrigin *err,
struct tee_ta_session **sess,
struct tee_ta_session_head *open_sessions,
const TEE_UUID *uuid,
const TEE_Identity *clnt_id,
uint32_t cancel_req_to,
struct tee_ta_param *param);
TEE_Result tee_ta_invoke_command(TEE_ErrorOrigin *err,
struct tee_ta_session *sess,
const TEE_Identity *clnt_id,
uint32_t cancel_req_to, uint32_t cmd,
struct tee_ta_param *param);
TEE_Result tee_ta_cancel_command(TEE_ErrorOrigin *err,
struct tee_ta_session *sess,
const TEE_Identity *clnt_id);
bool tee_ta_session_is_cancelled(struct tee_ta_session *s, TEE_Time *curr_time);
/*-----------------------------------------------------------------------------
* Function called to close a TA.
* Parameters:
* id - The session id (in)
* Returns:
* TEE_Result
*---------------------------------------------------------------------------*/
TEE_Result tee_ta_close_session(struct tee_ta_session *sess,
struct tee_ta_session_head *open_sessions,
const TEE_Identity *clnt_id);
TEE_Result tee_ta_get_current_session(struct tee_ta_session **sess);
void tee_ta_push_current_session(struct tee_ta_session *sess);
struct tee_ta_session *tee_ta_pop_current_session(void);
struct tee_ta_session *tee_ta_get_calling_session(void);
TEE_Result tee_ta_get_client_id(TEE_Identity *id);
struct tee_ta_session *tee_ta_get_session(uint32_t id, bool exclusive,
struct tee_ta_session_head *open_sessions);
void tee_ta_put_session(struct tee_ta_session *sess);
void tee_ta_dump_current(void);
#if defined(CFG_TA_GPROF_SUPPORT)
void tee_ta_gprof_sample_pc(vaddr_t pc);
void tee_ta_update_session_utime_suspend(void);
void tee_ta_update_session_utime_resume(void);
#else
static inline void tee_ta_gprof_sample_pc(vaddr_t pc __unused) {}
static inline void tee_ta_update_session_utime_suspend(void) {}
static inline void tee_ta_update_session_utime_resume(void) {}
#endif
#endif
|
