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 #ifndef MOJO_EDK_SYSTEM_CORE_H_ | 5 #ifndef MOJO_EDK_SYSTEM_CORE_H_ |
6 #define MOJO_EDK_SYSTEM_CORE_H_ | 6 #define MOJO_EDK_SYSTEM_CORE_H_ |
7 | 7 |
8 #include <stdint.h> | 8 #include <stdint.h> |
9 | 9 |
10 #include "base/callback.h" | 10 #include "base/callback.h" |
(...skipping 21 matching lines...) Expand all Loading... |
32 class Dispatcher; | 32 class Dispatcher; |
33 struct HandleSignalsState; | 33 struct HandleSignalsState; |
34 | 34 |
35 // |Core| is an object that implements the Mojo system calls. All public methods | 35 // |Core| is an object that implements the Mojo system calls. All public methods |
36 // are thread-safe. | 36 // are thread-safe. |
37 class MOJO_SYSTEM_IMPL_EXPORT Core { | 37 class MOJO_SYSTEM_IMPL_EXPORT Core { |
38 public: | 38 public: |
39 // --------------------------------------------------------------------------- | 39 // --------------------------------------------------------------------------- |
40 | 40 |
41 // These methods are only to be used by via the embedder API (and internally): | 41 // These methods are only to be used by via the embedder API (and internally): |
42 | 42 explicit Core(scoped_ptr<embedder::PlatformSupport> platform_support); |
43 // |*platform_support| must outlive this object. | |
44 explicit Core(embedder::PlatformSupport* platform_support); | |
45 virtual ~Core(); | 43 virtual ~Core(); |
46 | 44 |
47 // Adds |dispatcher| to the handle table, returning the handle for it. Returns | 45 // Adds |dispatcher| to the handle table, returning the handle for it. Returns |
48 // |MOJO_HANDLE_INVALID| on failure, namely if the handle table is full. | 46 // |MOJO_HANDLE_INVALID| on failure, namely if the handle table is full. |
49 MojoHandle AddDispatcher(const scoped_refptr<Dispatcher>& dispatcher); | 47 MojoHandle AddDispatcher(const scoped_refptr<Dispatcher>& dispatcher); |
50 | 48 |
51 // Looks up the dispatcher for the given handle. Returns null if the handle is | 49 // Looks up the dispatcher for the given handle. Returns null if the handle is |
52 // invalid. | 50 // invalid. |
53 scoped_refptr<Dispatcher> GetDispatcher(MojoHandle handle); | 51 scoped_refptr<Dispatcher> GetDispatcher(MojoHandle handle); |
54 | 52 |
55 // Watches on the given handle for the given signals, calling |callback| when | 53 // Watches on the given handle for the given signals, calling |callback| when |
56 // a signal is satisfied or when all signals become unsatisfiable. |callback| | 54 // a signal is satisfied or when all signals become unsatisfiable. |callback| |
57 // must satisfy stringent requirements -- see |Awakable::Awake()| in | 55 // must satisfy stringent requirements -- see |Awakable::Awake()| in |
58 // awakable.h. In particular, it must not call any Mojo system functions. | 56 // awakable.h. In particular, it must not call any Mojo system functions. |
59 MojoResult AsyncWait(MojoHandle handle, | 57 MojoResult AsyncWait(MojoHandle handle, |
60 MojoHandleSignals signals, | 58 MojoHandleSignals signals, |
61 base::Callback<void(MojoResult)> callback); | 59 base::Callback<void(MojoResult)> callback); |
62 | 60 |
63 embedder::PlatformSupport* platform_support() const { | 61 embedder::PlatformSupport* platform_support() const { |
64 return platform_support_; | 62 return platform_support_.get(); |
65 } | 63 } |
66 | 64 |
67 // --------------------------------------------------------------------------- | 65 // --------------------------------------------------------------------------- |
68 | 66 |
69 // The following methods are essentially implementations of the Mojo Core | 67 // System calls implementation: |
70 // functions of the Mojo API, with the C interface translated to C++ by | |
71 // "mojo/edk/embedder/entrypoints.cc". The best way to understand the contract | |
72 // of these methods is to look at the header files defining the corresponding | |
73 // API functions, referenced below. | |
74 | |
75 // These methods correspond to the API functions defined in | |
76 // "mojo/public/c/system/functions.h": | |
77 MojoTimeTicks GetTimeTicksNow(); | 68 MojoTimeTicks GetTimeTicksNow(); |
78 MojoResult Close(MojoHandle handle); | 69 MojoResult Close(MojoHandle handle); |
79 MojoResult Wait(MojoHandle handle, | 70 MojoResult Wait(MojoHandle handle, |
80 MojoHandleSignals signals, | 71 MojoHandleSignals signals, |
81 MojoDeadline deadline, | 72 MojoDeadline deadline, |
82 UserPointer<MojoHandleSignalsState> signals_state); | 73 UserPointer<MojoHandleSignalsState> signals_state); |
83 MojoResult WaitMany(UserPointer<const MojoHandle> handles, | 74 MojoResult WaitMany(UserPointer<const MojoHandle> handles, |
84 UserPointer<const MojoHandleSignals> signals, | 75 UserPointer<const MojoHandleSignals> signals, |
85 uint32_t num_handles, | 76 uint32_t num_handles, |
86 MojoDeadline deadline, | 77 MojoDeadline deadline, |
87 UserPointer<uint32_t> result_index, | 78 UserPointer<uint32_t> result_index, |
88 UserPointer<MojoHandleSignalsState> signals_states); | 79 UserPointer<MojoHandleSignalsState> signals_states); |
89 | |
90 // These methods correspond to the API functions defined in | |
91 // "mojo/public/c/system/message_pipe.h": | |
92 MojoResult CreateMessagePipe( | 80 MojoResult CreateMessagePipe( |
93 UserPointer<const MojoCreateMessagePipeOptions> options, | 81 UserPointer<const MojoCreateMessagePipeOptions> options, |
94 UserPointer<MojoHandle> message_pipe_handle0, | 82 UserPointer<MojoHandle> message_pipe_handle0, |
95 UserPointer<MojoHandle> message_pipe_handle1); | 83 UserPointer<MojoHandle> message_pipe_handle1); |
96 MojoResult WriteMessage(MojoHandle message_pipe_handle, | 84 MojoResult WriteMessage(MojoHandle message_pipe_handle, |
97 UserPointer<const void> bytes, | 85 UserPointer<const void> bytes, |
98 uint32_t num_bytes, | 86 uint32_t num_bytes, |
99 UserPointer<const MojoHandle> handles, | 87 UserPointer<const MojoHandle> handles, |
100 uint32_t num_handles, | 88 uint32_t num_handles, |
101 MojoWriteMessageFlags flags); | 89 MojoWriteMessageFlags flags); |
102 MojoResult ReadMessage(MojoHandle message_pipe_handle, | 90 MojoResult ReadMessage(MojoHandle message_pipe_handle, |
103 UserPointer<void> bytes, | 91 UserPointer<void> bytes, |
104 UserPointer<uint32_t> num_bytes, | 92 UserPointer<uint32_t> num_bytes, |
105 UserPointer<MojoHandle> handles, | 93 UserPointer<MojoHandle> handles, |
106 UserPointer<uint32_t> num_handles, | 94 UserPointer<uint32_t> num_handles, |
107 MojoReadMessageFlags flags); | 95 MojoReadMessageFlags flags); |
108 | |
109 // These methods correspond to the API functions defined in | |
110 // "mojo/public/c/system/data_pipe.h": | |
111 MojoResult CreateDataPipe( | 96 MojoResult CreateDataPipe( |
112 UserPointer<const MojoCreateDataPipeOptions> options, | 97 UserPointer<const MojoCreateDataPipeOptions> options, |
113 UserPointer<MojoHandle> data_pipe_producer_handle, | 98 UserPointer<MojoHandle> data_pipe_producer_handle, |
114 UserPointer<MojoHandle> data_pipe_consumer_handle); | 99 UserPointer<MojoHandle> data_pipe_consumer_handle); |
115 MojoResult WriteData(MojoHandle data_pipe_producer_handle, | 100 MojoResult WriteData(MojoHandle data_pipe_producer_handle, |
116 UserPointer<const void> elements, | 101 UserPointer<const void> elements, |
117 UserPointer<uint32_t> num_bytes, | 102 UserPointer<uint32_t> num_bytes, |
118 MojoWriteDataFlags flags); | 103 MojoWriteDataFlags flags); |
119 MojoResult BeginWriteData(MojoHandle data_pipe_producer_handle, | 104 MojoResult BeginWriteData(MojoHandle data_pipe_producer_handle, |
120 UserPointer<void*> buffer, | 105 UserPointer<void*> buffer, |
121 UserPointer<uint32_t> buffer_num_bytes, | 106 UserPointer<uint32_t> buffer_num_bytes, |
122 MojoWriteDataFlags flags); | 107 MojoWriteDataFlags flags); |
123 MojoResult EndWriteData(MojoHandle data_pipe_producer_handle, | 108 MojoResult EndWriteData(MojoHandle data_pipe_producer_handle, |
124 uint32_t num_bytes_written); | 109 uint32_t num_bytes_written); |
125 MojoResult ReadData(MojoHandle data_pipe_consumer_handle, | 110 MojoResult ReadData(MojoHandle data_pipe_consumer_handle, |
126 UserPointer<void> elements, | 111 UserPointer<void> elements, |
127 UserPointer<uint32_t> num_bytes, | 112 UserPointer<uint32_t> num_bytes, |
128 MojoReadDataFlags flags); | 113 MojoReadDataFlags flags); |
129 MojoResult BeginReadData(MojoHandle data_pipe_consumer_handle, | 114 MojoResult BeginReadData(MojoHandle data_pipe_consumer_handle, |
130 UserPointer<const void*> buffer, | 115 UserPointer<const void*> buffer, |
131 UserPointer<uint32_t> buffer_num_bytes, | 116 UserPointer<uint32_t> buffer_num_bytes, |
132 MojoReadDataFlags flags); | 117 MojoReadDataFlags flags); |
133 MojoResult EndReadData(MojoHandle data_pipe_consumer_handle, | 118 MojoResult EndReadData(MojoHandle data_pipe_consumer_handle, |
134 uint32_t num_bytes_read); | 119 uint32_t num_bytes_read); |
135 | |
136 // These methods correspond to the API functions defined in | |
137 // "mojo/public/c/system/buffer.h": | |
138 MojoResult CreateSharedBuffer( | 120 MojoResult CreateSharedBuffer( |
139 UserPointer<const MojoCreateSharedBufferOptions> options, | 121 UserPointer<const MojoCreateSharedBufferOptions> options, |
140 uint64_t num_bytes, | 122 uint64_t num_bytes, |
141 UserPointer<MojoHandle> shared_buffer_handle); | 123 UserPointer<MojoHandle> shared_buffer_handle); |
142 MojoResult DuplicateBufferHandle( | 124 MojoResult DuplicateBufferHandle( |
143 MojoHandle buffer_handle, | 125 MojoHandle buffer_handle, |
144 UserPointer<const MojoDuplicateBufferHandleOptions> options, | 126 UserPointer<const MojoDuplicateBufferHandleOptions> options, |
145 UserPointer<MojoHandle> new_buffer_handle); | 127 UserPointer<MojoHandle> new_buffer_handle); |
146 MojoResult MapBuffer(MojoHandle buffer_handle, | 128 MojoResult MapBuffer(MojoHandle buffer_handle, |
147 uint64_t offset, | 129 uint64_t offset, |
148 uint64_t num_bytes, | 130 uint64_t num_bytes, |
149 UserPointer<void*> buffer, | 131 UserPointer<void*> buffer, |
150 MojoMapBufferFlags flags); | 132 MojoMapBufferFlags flags); |
151 MojoResult UnmapBuffer(UserPointer<void> buffer); | 133 MojoResult UnmapBuffer(UserPointer<void> buffer); |
152 | 134 |
153 private: | 135 private: |
154 friend bool internal::ShutdownCheckNoLeaks(Core*); | 136 friend bool internal::ShutdownCheckNoLeaks(Core*); |
155 | 137 |
156 // Internal implementation of |Wait()| and |WaitMany()|; doesn't do basic | 138 // Internal implementation of |Wait()| and |WaitMany()|; doesn't do basic |
157 // validation of arguments. |*result_index| is only set if the result (whether | 139 // validation of arguments. |*result_index| is only set if the result (whether |
158 // success or failure) applies to a specific handle, so its value should be | 140 // success or failure) applies to a specific handle, so its value should be |
159 // preinitialized to |static_cast<uint32_t>(-1)|. | 141 // preinitialized to |static_cast<uint32_t>(-1)|. |
160 MojoResult WaitManyInternal(const MojoHandle* handles, | 142 MojoResult WaitManyInternal(const MojoHandle* handles, |
161 const MojoHandleSignals* signals, | 143 const MojoHandleSignals* signals, |
162 uint32_t num_handles, | 144 uint32_t num_handles, |
163 MojoDeadline deadline, | 145 MojoDeadline deadline, |
164 uint32_t* result_index, | 146 uint32_t* result_index, |
165 HandleSignalsState* signals_states); | 147 HandleSignalsState* signals_states); |
166 | 148 |
167 embedder::PlatformSupport* const platform_support_; | 149 const scoped_ptr<embedder::PlatformSupport> platform_support_; |
168 | 150 |
169 // TODO(vtl): |handle_table_lock_| should be a reader-writer lock (if only we | 151 // TODO(vtl): |handle_table_lock_| should be a reader-writer lock (if only we |
170 // had them). | 152 // had them). |
171 base::Lock handle_table_lock_; // Protects |handle_table_|. | 153 base::Lock handle_table_lock_; // Protects |handle_table_|. |
172 HandleTable handle_table_; | 154 HandleTable handle_table_; |
173 | 155 |
174 base::Lock mapping_table_lock_; // Protects |mapping_table_|. | 156 base::Lock mapping_table_lock_; // Protects |mapping_table_|. |
175 MappingTable mapping_table_; | 157 MappingTable mapping_table_; |
176 | 158 |
177 DISALLOW_COPY_AND_ASSIGN(Core); | 159 DISALLOW_COPY_AND_ASSIGN(Core); |
178 }; | 160 }; |
179 | 161 |
180 } // namespace system | 162 } // namespace system |
181 } // namespace mojo | 163 } // namespace mojo |
182 | 164 |
183 #endif // MOJO_EDK_SYSTEM_CORE_H_ | 165 #endif // MOJO_EDK_SYSTEM_CORE_H_ |
OLD | NEW |