OLD | NEW |
1 /* Copyright 2013 The Chromium Authors. All rights reserved. | 1 /* Copyright 2013 The Chromium Authors. All rights reserved. |
2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
4 */ | 4 */ |
5 | 5 |
6 /* From private/ppb_platform_verification_private.idl, | 6 /* From private/ppb_platform_verification_private.idl, |
7 * modified Thu Sep 12 11:48:28 2013. | 7 * modified Fri Oct 18 15:02:09 2013. |
8 */ | 8 */ |
9 | 9 |
10 #ifndef PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ | 10 #ifndef PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
11 #define PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ | 11 #define PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ |
12 | 12 |
13 #include "ppapi/c/pp_bool.h" | 13 #include "ppapi/c/pp_bool.h" |
14 #include "ppapi/c/pp_completion_callback.h" | 14 #include "ppapi/c/pp_completion_callback.h" |
15 #include "ppapi/c/pp_instance.h" | 15 #include "ppapi/c/pp_instance.h" |
16 #include "ppapi/c/pp_macros.h" | 16 #include "ppapi/c/pp_macros.h" |
17 #include "ppapi/c/pp_resource.h" | 17 #include "ppapi/c/pp_resource.h" |
18 #include "ppapi/c/pp_stdint.h" | 18 #include "ppapi/c/pp_stdint.h" |
19 #include "ppapi/c/pp_var.h" | 19 #include "ppapi/c/pp_var.h" |
20 | 20 |
21 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_1 \ | 21 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_2 \ |
22 "PPB_PlatformVerification_Private;0.1" | 22 "PPB_PlatformVerification_Private;0.2" |
23 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE \ | 23 #define PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE \ |
24 PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_1 | 24 PPB_PLATFORMVERIFICATION_PRIVATE_INTERFACE_0_2 |
25 | 25 |
26 /** | 26 /** |
27 * @file | 27 * @file |
28 * This file defines the API for platform verification. Currently, it only | 28 * This file defines the API for platform verification. Currently, it only |
29 * supports Chrome OS. | 29 * supports Chrome OS. |
30 */ | 30 */ |
31 | 31 |
32 | 32 |
33 /** | 33 /** |
34 * @addtogroup Interfaces | 34 * @addtogroup Interfaces |
35 * @{ | 35 * @{ |
36 */ | 36 */ |
37 /** | 37 /** |
38 * The <code>PPB_PlatformVerification_Private</code> interface allows authorized | 38 * The <code>PPB_PlatformVerification_Private</code> interface allows authorized |
39 * services to verify that the underlying platform is trusted. An example of a | 39 * services to verify that the underlying platform is trusted. An example of a |
40 * trusted platform is a Chrome OS device in verified boot mode. | 40 * trusted platform is a Chrome OS device in verified boot mode. |
41 */ | 41 */ |
42 struct PPB_PlatformVerification_Private_0_1 { | 42 struct PPB_PlatformVerification_Private_0_2 { |
43 /** | 43 /** |
44 * Create() creates a <code>PPB_PlatformVerification_Private</code> object. | 44 * Create() creates a <code>PPB_PlatformVerification_Private</code> object. |
45 * | 45 * |
46 * @pram[in] instance A <code>PP_Instance</code> identifying one instance of | 46 * @pram[in] instance A <code>PP_Instance</code> identifying one instance of |
47 * a module. | 47 * a module. |
48 * | 48 * |
49 * @return A <code>PP_Resource</code> corresponding to a | 49 * @return A <code>PP_Resource</code> corresponding to a |
50 * <code>PPB_PlatformVerification_Private</code> if successful, 0 if creation | 50 * <code>PPB_PlatformVerification_Private</code> if successful, 0 if creation |
51 * failed. | 51 * failed. |
52 */ | 52 */ |
53 PP_Resource (*Create)(PP_Instance instance); | 53 PP_Resource (*Create)(PP_Instance instance); |
54 /** | 54 /** |
55 * IsPlatformVerification() determines if the provided resource is a | 55 * IsPlatformVerification() determines if the provided resource is a |
56 * <code>PPB_PlatformVerification_Private</code>. | 56 * <code>PPB_PlatformVerification_Private</code>. |
57 * | 57 * |
58 * @param[in] resource A <code>PP_Resource</code> corresponding to a | 58 * @param[in] resource A <code>PP_Resource</code> corresponding to a |
59 * <code>PPB_PlatformVerification_Private</code>. | 59 * <code>PPB_PlatformVerification_Private</code>. |
60 * | 60 * |
61 * @return <code>PP_TRUE</code> if the resource is a | 61 * @return <code>PP_TRUE</code> if the resource is a |
62 * <code>PPB_PlatformVerification_Private</code>, <code>PP_FALSE</code> if the | 62 * <code>PPB_PlatformVerification_Private</code>, <code>PP_FALSE</code> if the |
63 * resource is invalid or some type other than | 63 * resource is invalid or some type other than |
64 * <code>PPB_PlatformVerification_Private</code>. | 64 * <code>PPB_PlatformVerification_Private</code>. |
65 */ | 65 */ |
66 PP_Bool (*IsPlatformVerification)(PP_Resource resource); | 66 PP_Bool (*IsPlatformVerification)(PP_Resource resource); |
67 /** | 67 /** |
68 * Check if the underlying host platform can be challenged; i.e., verified as | |
69 * a trusted platform. Useful for avoiding unnecessary work on platforms | |
70 * which will always fail; i.e. dev mode Chrome OS. | |
71 * | |
72 * @param[out] can_challenge_platform A <code>PP_Bool</code> which is set to | |
73 * <code>PP_TRUE</code> if a platform challenge might pass and | |
74 * <code>PP_FALSE</code> if it definitely won't. | |
75 * | |
76 * @param[in] callback A <code>PP_CompletionCallback</code> to be called after | |
77 * the method has been completed. This callback will only run if the return | |
78 * code is <code>PP_OK_COMPLETIONPENDING</code>. | |
79 * | |
80 * @return An int32_t containing an error code from <code>pp_errors.h</code>. | |
81 */ | |
82 int32_t (*CanChallengePlatform)(PP_Resource instance, | |
83 PP_Bool* can_challenge_platform, | |
84 struct PP_CompletionCallback callback); | |
85 /** | |
86 * Requests a platform challenge for a given service id. | 68 * Requests a platform challenge for a given service id. |
87 * | 69 * |
88 * @param[in] service_id A <code>PP_Var</code> of type | 70 * @param[in] service_id A <code>PP_Var</code> of type |
89 * <code>PP_VARTYPE_STRING</code> containing the service_id for the challenge. | 71 * <code>PP_VARTYPE_STRING</code> containing the service_id for the challenge. |
90 * | 72 * |
91 * @param[in] challenge A <code>PP_Var</code> of type | 73 * @param[in] challenge A <code>PP_Var</code> of type |
92 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the challenge data. | 74 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the challenge data. |
93 * | 75 * |
94 * @param[out] signed_data A <code>PP_Var</code> of type | 76 * @param[out] signed_data A <code>PP_Var</code> of type |
95 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the data signed by the | 77 * <code>PP_VARTYPE_ARRAY_BUFFER</code> that contains the data signed by the |
(...skipping 15 matching lines...) Expand all Loading... |
111 */ | 93 */ |
112 int32_t (*ChallengePlatform)(PP_Resource instance, | 94 int32_t (*ChallengePlatform)(PP_Resource instance, |
113 struct PP_Var service_id, | 95 struct PP_Var service_id, |
114 struct PP_Var challenge, | 96 struct PP_Var challenge, |
115 struct PP_Var* signed_data, | 97 struct PP_Var* signed_data, |
116 struct PP_Var* signed_data_signature, | 98 struct PP_Var* signed_data_signature, |
117 struct PP_Var* platform_key_certificate, | 99 struct PP_Var* platform_key_certificate, |
118 struct PP_CompletionCallback callback); | 100 struct PP_CompletionCallback callback); |
119 }; | 101 }; |
120 | 102 |
121 typedef struct PPB_PlatformVerification_Private_0_1 | 103 typedef struct PPB_PlatformVerification_Private_0_2 |
122 PPB_PlatformVerification_Private; | 104 PPB_PlatformVerification_Private; |
123 /** | 105 /** |
124 * @} | 106 * @} |
125 */ | 107 */ |
126 | 108 |
127 #endif /* PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ */ | 109 #endif /* PPAPI_C_PRIVATE_PPB_PLATFORM_VERIFICATION_PRIVATE_H_ */ |
128 | 110 |
OLD | NEW |