xref: /openbmc/linux/drivers/tee/tee_private.h (revision 82e6fdd6)
1 /*
2  * Copyright (c) 2015-2016, Linaro Limited
3  *
4  * This software is licensed under the terms of the GNU General Public
5  * License version 2, as published by the Free Software Foundation, and
6  * may be copied, distributed, and modified under those terms.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11  * GNU General Public License for more details.
12  *
13  */
14 #ifndef TEE_PRIVATE_H
15 #define TEE_PRIVATE_H
16 
17 #include <linux/cdev.h>
18 #include <linux/completion.h>
19 #include <linux/device.h>
20 #include <linux/kref.h>
21 #include <linux/mutex.h>
22 #include <linux/types.h>
23 
24 /**
25  * struct tee_shm_pool - shared memory pool
26  * @private_mgr:	pool manager for shared memory only between kernel
27  *			and secure world
28  * @dma_buf_mgr:	pool manager for shared memory exported to user space
29  */
30 struct tee_shm_pool {
31 	struct tee_shm_pool_mgr *private_mgr;
32 	struct tee_shm_pool_mgr *dma_buf_mgr;
33 };
34 
35 #define TEE_DEVICE_FLAG_REGISTERED	0x1
36 #define TEE_MAX_DEV_NAME_LEN		32
37 
38 /**
39  * struct tee_device - TEE Device representation
40  * @name:	name of device
41  * @desc:	description of device
42  * @id:		unique id of device
43  * @flags:	represented by TEE_DEVICE_FLAG_REGISTERED above
44  * @dev:	embedded basic device structure
45  * @cdev:	embedded cdev
46  * @num_users:	number of active users of this device
47  * @c_no_user:	completion used when unregistering the device
48  * @mutex:	mutex protecting @num_users and @idr
49  * @idr:	register of shared memory object allocated on this device
50  * @pool:	shared memory pool
51  */
52 struct tee_device {
53 	char name[TEE_MAX_DEV_NAME_LEN];
54 	const struct tee_desc *desc;
55 	int id;
56 	unsigned int flags;
57 
58 	struct device dev;
59 	struct cdev cdev;
60 
61 	size_t num_users;
62 	struct completion c_no_users;
63 	struct mutex mutex;	/* protects num_users and idr */
64 
65 	struct idr idr;
66 	struct tee_shm_pool *pool;
67 };
68 
69 int tee_shm_init(void);
70 
71 int tee_shm_get_fd(struct tee_shm *shm);
72 
73 bool tee_device_get(struct tee_device *teedev);
74 void tee_device_put(struct tee_device *teedev);
75 
76 void teedev_ctx_get(struct tee_context *ctx);
77 void teedev_ctx_put(struct tee_context *ctx);
78 
79 #endif /*TEE_PRIVATE_H*/
80