| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 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_EMBEDDER_EMBEDDER_H_ | 5 #ifndef MOJO_EDK_EMBEDDER_EMBEDDER_H_ |
| 6 #define MOJO_EDK_EMBEDDER_EMBEDDER_H_ | 6 #define MOJO_EDK_EMBEDDER_EMBEDDER_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/callback.h" | 10 #include "base/callback.h" |
| (...skipping 150 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 161 // | 161 // |
| 162 // There are two channel creation APIs: |CreateChannelOnIOThread()| creates a | 162 // There are two channel creation APIs: |CreateChannelOnIOThread()| creates a |
| 163 // channel synchronously and must be called from the I/O thread, while | 163 // channel synchronously and must be called from the I/O thread, while |
| 164 // |CreateChannel()| is asynchronous and may be called from any thread. | 164 // |CreateChannel()| is asynchronous and may be called from any thread. |
| 165 // |DestroyChannel()| is used to destroy the channel in either case and may be | 165 // |DestroyChannel()| is used to destroy the channel in either case and may be |
| 166 // called from any thread, but completes synchronously when called from the I/O | 166 // called from any thread, but completes synchronously when called from the I/O |
| 167 // thread. | 167 // thread. |
| 168 // | 168 // |
| 169 // Both creation functions have a |platform_handle| argument, which should be an | 169 // Both creation functions have a |platform_handle| argument, which should be an |
| 170 // OS-dependent handle to one side of a suitable bidirectional OS "pipe" (e.g., | 170 // OS-dependent handle to one side of a suitable bidirectional OS "pipe" (e.g., |
| 171 // a file descriptor to a socket on POSIX, a handle to a named pipe on Windows); | 171 // a file descriptor to a Unix domain socket); this "pipe" should be connected |
| 172 // this "pipe" should be connected and ready for operation (e.g., to be written | 172 // and ready for operation (e.g., to be written to or read from). |
| 173 // to or read from). | |
| 174 // | 173 // |
| 175 // Both (synchronously) return a handle to the bootstrap message pipe on the | 174 // Both (synchronously) return a handle to the bootstrap message pipe on the |
| 176 // channel that was (or is to be) created, or |MOJO_HANDLE_INVALID| on error | 175 // channel that was (or is to be) created, or |MOJO_HANDLE_INVALID| on error |
| 177 // (but note that this will happen only if, e.g., the handle table is full). | 176 // (but note that this will happen only if, e.g., the handle table is full). |
| 178 // This message pipe may be used immediately, but since channel operation | 177 // This message pipe may be used immediately, but since channel operation |
| 179 // actually begins asynchronously, other errors may still occur (e.g., if the | 178 // actually begins asynchronously, other errors may still occur (e.g., if the |
| 180 // other end of the "pipe" is closed) and be reported in the usual way to the | 179 // other end of the "pipe" is closed) and be reported in the usual way to the |
| 181 // returned handle. | 180 // returned handle. |
| 182 // | 181 // |
| 183 // (E.g., a message written immediately to the returned handle will be queued | 182 // (E.g., a message written immediately to the returned handle will be queued |
| (...skipping 50 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 234 | 233 |
| 235 // Inform the channel that it will soon be destroyed (doing so is optional). | 234 // Inform the channel that it will soon be destroyed (doing so is optional). |
| 236 // This may be called from any thread, but the caller must ensure that this is | 235 // This may be called from any thread, but the caller must ensure that this is |
| 237 // called before |DestroyChannel()|. | 236 // called before |DestroyChannel()|. |
| 238 MOJO_SYSTEM_IMPL_EXPORT void WillDestroyChannelSoon(ChannelInfo* channel_info); | 237 MOJO_SYSTEM_IMPL_EXPORT void WillDestroyChannelSoon(ChannelInfo* channel_info); |
| 239 | 238 |
| 240 } // namespace embedder | 239 } // namespace embedder |
| 241 } // namespace mojo | 240 } // namespace mojo |
| 242 | 241 |
| 243 #endif // MOJO_EDK_EMBEDDER_EMBEDDER_H_ | 242 #endif // MOJO_EDK_EMBEDDER_EMBEDDER_H_ |
| OLD | NEW |