OLD | NEW |
| (Empty) |
1 // Copyright 2016 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef MOJO_EDK_EMBEDDER_NAMED_PLATFORM_CHANNEL_PAIR_H_ | |
6 #define MOJO_EDK_EMBEDDER_NAMED_PLATFORM_CHANNEL_PAIR_H_ | |
7 | |
8 #include <string> | |
9 | |
10 #include "base/macros.h" | |
11 #include "base/strings/string16.h" | |
12 #include "build/build_config.h" | |
13 #include "mojo/edk/embedder/scoped_platform_handle.h" | |
14 #include "mojo/edk/system/system_impl_export.h" | |
15 | |
16 namespace base { | |
17 class CommandLine; | |
18 } | |
19 | |
20 namespace mojo { | |
21 namespace edk { | |
22 | |
23 // This is used to create a named bidirectional pipe to connect new child | |
24 // processes. The resulting server handle should be passed to the EDK, and the | |
25 // child end passed as a pipe name on the command line to the child process. The | |
26 // child process can then retrieve the pipe name from the command line and | |
27 // resolve it into a client handle. | |
28 class MOJO_SYSTEM_IMPL_EXPORT NamedPlatformChannelPair { | |
29 public: | |
30 NamedPlatformChannelPair(); | |
31 ~NamedPlatformChannelPair(); | |
32 | |
33 // Note: It is NOT acceptable to use this handle as a generic pipe channel. It | |
34 // MUST be passed to mojo::edk::ChildProcessLaunched() only. | |
35 ScopedPlatformHandle PassServerHandle(); | |
36 | |
37 // To be called in the child process, after the parent process called | |
38 // |PrepareToPassClientHandleToChildProcess()| and launched the child (using | |
39 // the provided data), to create a client handle connected to the server | |
40 // handle (in the parent process). | |
41 static ScopedPlatformHandle PassClientHandleFromParentProcess( | |
42 const base::CommandLine& command_line); | |
43 | |
44 // Prepares to pass the client channel to a new child process, to be launched | |
45 // using |LaunchProcess()| (from base/launch.h). Modifies |*command_line| and | |
46 // |*handle_passing_info| as needed. | |
47 // Note: For Windows, this method only works on Vista and later. | |
48 void PrepareToPassClientHandleToChildProcess( | |
49 base::CommandLine* command_line) const; | |
50 | |
51 private: | |
52 ScopedPlatformHandle server_handle_; | |
53 | |
54 #if defined(OS_WIN) | |
55 base::string16 pipe_name_; | |
56 #endif | |
57 | |
58 DISALLOW_COPY_AND_ASSIGN(NamedPlatformChannelPair); | |
59 }; | |
60 | |
61 } // namespace edk | |
62 } // namespace mojo | |
63 | |
64 #endif // MOJO_EDK_EMBEDDER_NAMED_PLATFORM_CHANNEL_PAIR_H_ | |
OLD | NEW |