include/linux/tee_drv.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
3  * Copyright (c) 2015-2024 Linaro Limited
24  * struct tee_context - driver specific context on file pointer data
30  *              shared memory release.
32  *              wait for tee-supplicant daemon to be started if not present
35  *              non-blocking in nature.
36  * @cap_memref_null: flag indicating if the TEE Client support shared
37  *                   memory buffer with a NULL pointer.
49  * struct tee_shm - shared memory object
51  * @paddr:	physical address of the shared memory
52  * @kaddr:	virtual address of the shared memory
53  * @size:	size of shared memory
59  * @id:		unique id of a shared memory object on this device, shared
62  *		secure world assigned id of this shared memory object, not
100  * tee_shm_alloc_kernel_buf() - Allocate kernel shared memory for a
102  * @ctx:	The TEE context for shared memory allocation
103  * @size:	Shared memory allocation size
109  * tee_shm_register_kernel_buf() - Register kernel shared memory for a
111  * @ctx:	The TEE context for shared memory registration
120  * tee_shm_free() - Free shared memory
121  * @shm:	Handle to shared memory to free
126  * tee_shm_get_va() - Get virtual address of a shared memory plus an offset
127  * @shm:	Shared memory handle
128  * @offs:	Offset from start of this shared memory
129  * @returns virtual address of the shared memory + offs if offs is within
130  *	the bounds of this shared memory, else an ERR_PTR
135  * tee_shm_get_pa() - Get physical address of a shared memory plus an offset
136  * @shm:	Shared memory handle
137  * @offs:	Offset from start of this shared memory
139  * @returns 0 if offs is within the bounds of this shared memory, else an
145  * tee_shm_get_size() - Get size of shared memory buffer
146  * @shm:	Shared memory handle
147  * @returns size of shared memory
151 	return shm->size;  in tee_shm_get_size()
155  * tee_shm_get_pages() - Get list of pages that hold shared buffer
156  * @shm:	Shared memory handle
163 	*num_pages = shm->num_pages;  in tee_shm_get_pages()
164 	return shm->pages;  in tee_shm_get_pages()
168  * tee_shm_get_page_offset() - Get shared buffer offset from page start
169  * @shm:	Shared memory handle
170  * @returns page offset of shared buffer
174 	return shm->offset;  in tee_shm_get_page_offset()
178  * tee_client_open_context() - Open a TEE context
197  * tee_client_close_context() - Close a TEE context
206  * tee_client_get_version() - Query version of TEE
214  * tee_client_open_session() - Open a session to a Trusted Application
220  * Returns < 0 on error else see @arg->ret for result. If @arg->ret
221  * is TEEC_SUCCESS the session identifier is available in @arg->session.
228  * tee_client_close_session() - Close a session to a Trusted Application
238  * tee_client_system_session() - Declare session as a system session
252  * tee_client_invoke_func() - Invoke a function in a Trusted Application
258  * Returns < 0 on error else see @arg->ret for result.
265  * tee_client_cancel_req() - Request cancellation of the previous open-session
266  * or invoke-command operations in a Trusted Application
279  * struct tee_client_device - tee based device
291  * struct tee_client_driver - tee client driver