xref: /optee_os/core/include/tee/tee_svc.h (revision 41d714301703bb2e26fe4cd9a6049330972640d8)
1 /*
2  * Copyright (c) 2014, STMicroelectronics International N.V.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright notice,
9  * this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright notice,
12  * this list of conditions and the following disclaimer in the documentation
13  * and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
19  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25  * POSSIBILITY OF SUCH DAMAGE.
26  */
27 #ifndef TEE_SVC_H
28 #define TEE_SVC_H
29 
30 #include <stdint.h>
31 #include <kernel/tee_common_unpg.h>	/* tee_uaddr_t */
32 #include <tee_api_types.h>
33 #include <utee_types.h>
34 #include <assert.h>
35 
36 extern vaddr_t tee_svc_uref_base;
37 
38 struct tee_ta_session;
39 
40 /* TA Properties */
41 struct tee_props {
42 	const char *name;
43 
44 	/* prop_type is of type enum user_ta_prop_type*/
45 	const uint32_t prop_type;
46 
47 	/* either get_prop_func or both data and len */
48 	TEE_Result (*get_prop_func)(struct tee_ta_session *sess,
49 				    void *buf, size_t *blen);
50 	const void *data;
51 	const size_t len;
52 };
53 
54 struct tee_vendor_props {
55 	const struct tee_props *props;
56 	size_t len;
57 };
58 void syscall_sys_return(unsigned long ret);
59 
60 void syscall_log(const void *buf, size_t len);
61 
62 void syscall_panic(unsigned long code);
63 
64 TEE_Result syscall_not_supported(void);
65 
66 uint32_t syscall_dummy(uint32_t *a);
67 uint32_t syscall_dummy_7args(unsigned long a1, unsigned long a2,
68 			unsigned long a3, unsigned long a4, unsigned long a5,
69 			unsigned long a6, unsigned long a7);
70 
71 uint32_t syscall_nocall(void);
72 
73 TEE_Result syscall_get_property_obsolete(unsigned long prop, void *buf,
74 					 size_t blen);
75 
76 /* prop_set defined by enum utee_property */
77 TEE_Result syscall_get_property(unsigned long prop_set,
78 				unsigned long index,
79 				void *name, uint32_t *name_len,
80 				void *buf, uint32_t *blen,
81 				uint32_t *prop_type);
82 TEE_Result syscall_get_property_name_to_index(unsigned long prop_set,
83 					      void *name,
84 					      unsigned long name_len,
85 					      uint32_t *index);
86 
87 TEE_Result syscall_open_ta_session(const TEE_UUID *dest,
88 			unsigned long cancel_req_to, struct utee_params *params,
89 			uint32_t *sess, uint32_t *ret_orig);
90 
91 TEE_Result syscall_close_ta_session(unsigned long sess);
92 
93 TEE_Result syscall_invoke_ta_command(unsigned long sess,
94 			unsigned long cancel_req_to, unsigned long cmd_id,
95 			struct utee_params *params, uint32_t *ret_orig);
96 
97 TEE_Result syscall_check_access_rights(unsigned long flags, const void *buf,
98 				       size_t len);
99 
100 TEE_Result tee_svc_copy_from_user(struct tee_ta_session *sess, void *kaddr,
101 				  const void *uaddr, size_t len);
102 TEE_Result tee_svc_copy_to_user(struct tee_ta_session *sess, void *uaddr,
103 				const void *kaddr, size_t len);
104 
105 TEE_Result tee_svc_copy_kaddr_to_uref(struct tee_ta_session *sess,
106 			uint32_t *uref, void *kaddr);
107 
108 static inline uint32_t tee_svc_kaddr_to_uref(void *kaddr)
109 {
110 	assert(((vaddr_t)kaddr - tee_svc_uref_base) < UINT32_MAX);
111 	return (vaddr_t)kaddr - tee_svc_uref_base;
112 }
113 
114 static inline vaddr_t tee_svc_uref_to_vaddr(uint32_t uref)
115 {
116 	return tee_svc_uref_base + uref;
117 }
118 
119 static inline void *tee_svc_uref_to_kaddr(uint32_t uref)
120 {
121 	return (void *)tee_svc_uref_to_vaddr(uref);
122 }
123 
124 TEE_Result syscall_get_cancellation_flag(uint32_t *cancel);
125 
126 TEE_Result syscall_unmask_cancellation(uint32_t *old_mask);
127 
128 TEE_Result syscall_mask_cancellation(uint32_t *old_mask);
129 
130 TEE_Result syscall_wait(unsigned long timeout);
131 
132 TEE_Result syscall_get_time(unsigned long cat, TEE_Time *time);
133 TEE_Result syscall_set_ta_time(const TEE_Time *time);
134 
135 #endif /* TEE_SVC_H */
136