1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
/* From private/ppb_nacl_private.idl modified Thu Jan 10 15:59:03 2013. */
#ifndef PPAPI_C_PRIVATE_PPB_NACL_PRIVATE_H_
#define PPAPI_C_PRIVATE_PPB_NACL_PRIVATE_H_
#include "ppapi/c/pp_bool.h"
#include "ppapi/c/pp_instance.h"
#include "ppapi/c/pp_macros.h"
#include "ppapi/c/pp_stdint.h"
#define PPB_NACL_PRIVATE_INTERFACE_1_0 "PPB_NaCl_Private;1.0"
#define PPB_NACL_PRIVATE_INTERFACE PPB_NACL_PRIVATE_INTERFACE_1_0
/**
* @file
* This file contains NaCl private interfaces. */
#include "ppapi/c/private/pp_file_handle.h"
/**
* @addtogroup Enums
* @{
*/
/**
* The <code>PP_NaClResult</code> enum contains NaCl result codes.
*/
typedef enum {
/** Successful NaCl call */
PP_NACL_OK = 0,
/** Unspecified NaCl error */
PP_NACL_FAILED = 1,
/** Error creating the module */
PP_NACL_ERROR_MODULE = 2,
/** Error creating and initializing the instance */
PP_NACL_ERROR_INSTANCE = 3
} PP_NaClResult;
PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_NaClResult, 4);
/** NaCl-specific errors that should be reported to the user */
typedef enum {
/**
* The manifest program element does not contain a program usable on the
* user's architecture
*/
PP_NACL_MANIFEST_MISSING_ARCH = 0
} PP_NaClError;
/**
* @}
*/
/**
* @addtogroup Interfaces
* @{
*/
/* PPB_NaCl_Private */
struct PPB_NaCl_Private_1_0 {
/* Launches NaCl's sel_ldr process. Returns PP_NACL_OK on success and
* writes a nacl::Handle to imc_handle. Returns PP_NACL_FAILED on failure.
* The |enable_ppapi_dev| parameter controls whether GetInterface
* returns 'Dev' interfaces to the NaCl plugin. The |uses_ppapi| flag
* indicates that the nexe run by sel_ldr will use the PPAPI APIs.
* This implies that LaunchSelLdr is run from the main thread. If a nexe
* does not need PPAPI, then it can run off the main thread.
* The |uses_irt| flag indicates whether the IRT should be loaded in this
* NaCl process. This is true for ABI stable nexes.
*/
PP_NaClResult (*LaunchSelLdr)(PP_Instance instance,
const char* alleged_url,
PP_Bool uses_irt,
PP_Bool uses_ppapi,
PP_Bool enable_ppapi_dev,
void* imc_handle);
/* This function starts the IPC proxy so the nexe can communicate with the
* browser. Returns PP_NACL_OK on success, otherwise a result code indicating
* the failure. PP_NACL_FAILED is returned if LaunchSelLdr wasn't called with
* the instance. PP_NACL_ERROR_MODULE is returned if the module can't be
* initialized. PP_NACL_ERROR_INSTANCE is returned if the instance can't be
* initialized. PP_NACL_USE_SRPC is returned if the plugin should use SRPC.
*/
PP_NaClResult (*StartPpapiProxy)(PP_Instance instance);
/* On POSIX systems, this function returns the file descriptor of
* /dev/urandom. On non-POSIX systems, this function returns 0.
*/
int32_t (*UrandomFD)(void);
/* Whether the Pepper 3D interfaces should be disabled in the NaCl PPAPI
* proxy. This is so paranoid admins can effectively prevent untrusted shader
* code to be processed by the graphics stack.
*/
PP_Bool (*Are3DInterfacesDisabled)(void);
/* Enables the creation of sel_ldr processes off of the main thread.
*/
void (*EnableBackgroundSelLdrLaunch)(void);
/* This is Windows-specific. This is a replacement for DuplicateHandle() for
* use inside the Windows sandbox. Note that we provide this via dependency
* injection only to avoid the linkage problems that occur because the NaCl
* plugin is built as a separate DLL/DSO
* (see http://code.google.com/p/chromium/issues/detail?id=114439#c8).
*/
int32_t (*BrokerDuplicateHandle)(PP_FileHandle source_handle,
uint32_t process_id,
PP_FileHandle* target_handle,
uint32_t desired_access,
uint32_t options);
/* Returns a read-only file descriptor of a file rooted in the Pnacl
* component directory, or -1 on error.
* Do we want this to take a completion callback and be async, or
* could we make this happen on another thread?
*/
PP_FileHandle (*GetReadonlyPnaclFd)(const char* filename);
/* This creates a temporary file that will be deleted by the time
* the last handle is closed (or earlier on POSIX systems), and
* returns a posix handle to that temporary file.
*/
PP_FileHandle (*CreateTemporaryFile)(PP_Instance instance);
/* Return true if we are off the record.
*/
PP_Bool (*IsOffTheRecord)(void);
/* Return true if PNaCl is turned on.
*/
PP_Bool (*IsPnaclEnabled)(void);
/* Display a UI message to the user. */
PP_NaClResult (*ReportNaClError)(PP_Instance instance,
PP_NaClError message_id);
};
typedef struct PPB_NaCl_Private_1_0 PPB_NaCl_Private;
/**
* @}
*/
#endif /* PPAPI_C_PRIVATE_PPB_NACL_PRIVATE_H_ */
|
