1 /**
2  * Copyright(c) 2011 Trusted Logic.   All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  *  * Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *  * Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in
12  *    the documentation and/or other materials provided with the
13  *    distribution.
14  *  * Neither the name Trusted Logic nor the names of its
15  *    contributors may be used to endorse or promote products derived
16  *    from this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30 
31 /*
32  * This header file contains extensions to the TEE Client API that are
33  * specific to the Trusted Foundations implementations
34  */
35 #ifndef   __TEE_CLIENT_API_EX_H__
36 #define   __TEE_CLIENT_API_EX_H__
37 
38 /* Implementation defined Login types  */
39 #define TEEC_LOGIN_AUTHENTICATION      0x80000000
40 #define TEEC_LOGIN_PRIVILEGED          0x80000002
41 
42 /* Type definitions */
43 
44 typedef struct
45 {
46    uint32_t x;
47    uint32_t y;
48 }
49 TEEC_TimeLimit;
50 
51 typedef struct
52 {
53    char apiDescription[65];
54    char commsDescription[65];
55    char TEEDescription[65];
56 }
57 TEEC_ImplementationInfo;
58 
59 typedef struct
60 {
61    uint32_t pageSize;
62    uint32_t tmprefMaxSize;
63    uint32_t sharedMemMaxSize;
64    uint32_t nReserved3;
65    uint32_t nReserved4;
66    uint32_t nReserved5;
67    uint32_t nReserved6;
68    uint32_t nReserved7;
69 }
70 TEEC_ImplementationLimits;
71 
72 void TEEC_EXPORT TEEC_GetImplementationInfo(
73    TEEC_Context*            context,
74    TEEC_ImplementationInfo* description);
75 
76 void TEEC_EXPORT TEEC_GetImplementationLimits(
77    TEEC_ImplementationLimits* limits);
78 
79 void TEEC_EXPORT TEEC_GetTimeLimit(
80     TEEC_Context*    context,
81     uint32_t         timeout,
82     TEEC_TimeLimit*  timeLimit);
83 
84 TEEC_Result TEEC_EXPORT TEEC_OpenSessionEx (
85     TEEC_Context*         context,
86     TEEC_Session*         session,
87     const TEEC_TimeLimit* timeLimit,
88     const TEEC_UUID*      destination,
89     uint32_t              connectionMethod,
90     void*                 connectionData,
91     TEEC_Operation*       operation,
92     uint32_t*             errorOrigin);
93 
94 TEEC_Result TEEC_EXPORT TEEC_InvokeCommandEx(
95     TEEC_Session*         session,
96     const TEEC_TimeLimit* timeLimit,
97     uint32_t              commandID,
98     TEEC_Operation*       operation,
99     uint32_t*             errorOrigin);
100 
101 TEEC_Result TEEC_EXPORT TEEC_ReadSignatureFile(
102    void**    ppSignatureFile,
103    uint32_t* pnSignatureFileLength);
104 
105 #endif /* __TEE_CLIENT_API_EX_H__ */
106