1 /*
2  * Copyright (c) 2013, Google, Inc. All rights reserved
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining
5  * a copy of this software and associated documentation files
6  * (the "Software"), to deal in the Software without restriction,
7  * including without limitation the rights to use, copy, modify, merge,
8  * publish, distribute, sublicense, and/or sell copies of the Software,
9  * and to permit persons to whom the Software is furnished to do so,
10  * subject to the following conditions:
11  *
12  * The above copyright notice and this permission notice shall be
13  * included in all copies or substantial portions of the Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
18  * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
19  * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
20  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
21  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22  */
23 
24 #ifndef __LIB_TRUSTY_UCTX_H
25 #define __LIB_TRUSTY_UCTX_H
26 
27 #include <stdint.h>
28 #include <sys/types.h>
29 
30 #include <lib/trusty/handle.h>
31 #include <lib/trusty/sys_fd.h>
32 
33 struct uctx;
34 
35 typedef uint32_t handle_id_t;
36 
37 #define INVALID_HANDLE_ID ((handle_id_t)0xFFFFFFFF)
38 
39 int uctx_create(void* priv, struct uctx** ctx);
40 void uctx_destroy(struct uctx* ctx);
41 void* uctx_get_priv(struct uctx* ctx);
42 struct uctx* current_uctx(void);
43 
44 int uctx_handle_install(struct uctx* ctx,
45                         struct handle* handle,
46                         handle_id_t* id);
47 int uctx_handle_remove(struct uctx* ctx,
48                        handle_id_t handle_id,
49                        struct handle** handle_ptr);
50 int uctx_handle_get(struct uctx* ctx,
51                     handle_id_t handle_id,
52                     struct handle** handle_ptr);
53 
54 const struct sys_fd_ops* uctx_get_fd_ops(uint32_t fd);
55 
56 #endif
57