Create a broker interface for the new Mojo EDK so that the browser can create and duplicate messa...

mojo/edk/embedder/embedder.h

 // Copyright 2014 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.
 
 #ifndef MOJO_EDK_EMBEDDER_EMBEDDER_H_
 #define MOJO_EDK_EMBEDDER_EMBEDDER_H_
 
 #include <string>
 
 #include "base/callback.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
+#include "base/process/process.h"
 #include "base/task_runner.h"
 #include "mojo/edk/embedder/scoped_platform_handle.h"
 #include "mojo/edk/system/system_impl_export.h"
 #include "mojo/public/cpp/system/message_pipe.h"
 
 namespace mojo {
 namespace edk {
 
 class ProcessDelegate;
 
 // Basic configuration/initialization ------------------------------------------
 
 // |Init()| sets up the basic Mojo system environment, making the |Mojo...()|
 // functions available and functional. This is never shut down (except in tests
 // -- see test_embedder.h).
 
 // Allows changing the default max message size. Must be called before Init.
 MOJO_SYSTEM_IMPL_EXPORT void SetMaxMessageSize(size_t bytes);
 
+#if defined(OS_WIN)
+// Must be called before Init in the parent (unsandboxed) process.
+MOJO_SYSTEM_IMPL_EXPORT void PreInitializeParentProcess();
+
+// Must be called before Init in the child (sandboxed) process.
+MOJO_SYSTEM_IMPL_EXPORT void PreInitializeChildProcess();
+
+// Called in the parent process for each child process that is launched. The
+// returned handle must be sent to the child process which then calls
+// SetParentPipeHandle.
+MOJO_SYSTEM_IMPL_EXPORT HANDLE ChildProcessLaunched(HANDLE child_process);
+// Like above, except used when the embedder establishes the pipe between the
+// parent and child processes itself.
+MOJO_SYSTEM_IMPL_EXPORT void ChildProcessLaunched(HANDLE child_process,
+                                                  HANDLE server_pipe);
+
+// Should be called as early as possible in the child process with the handle
+// that the parent received from ChildProcessLaunched.
+MOJO_SYSTEM_IMPL_EXPORT void SetParentPipeHandle(HANDLE pipe);
+#endif
+
 // Must be called first, or just after setting configuration parameters, to
 // initialize the (global, singleton) system.
 MOJO_SYSTEM_IMPL_EXPORT void Init();
 
 // Basic functions -------------------------------------------------------------
 
 // The functions in this section are available once |Init()| has been called.
 
 // Start waiting on the handle asynchronously. On success, |callback| will be
 // called exactly once, when |handle| satisfies a signal in |signals| or it
@@ skipping 58 matching lines @@
 MOJO_SYSTEM_IMPL_EXPORT void ShutdownIPCSupportAndWaitForNoChannels();
 
 // Creates a message pipe from a platform handle. Safe to call from any thread.
 MOJO_SYSTEM_IMPL_EXPORT ScopedMessagePipeHandle
 CreateMessagePipe(ScopedPlatformHandle platform_handle);
 
 }  // namespace edk
 }  // namespace mojo
 
 #endif  // MOJO_EDK_EMBEDDER_EMBEDDER_H_