Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(382)

Side by Side Diff: mojo/edk/embedder/platform_channel_pair.h

Issue 814543006: Move //mojo/{public, edk} underneath //third_party (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Rebase Created 5 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « mojo/edk/embedder/entrypoints.cc ('k') | mojo/edk/embedder/platform_channel_pair.cc » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
(Empty)
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
3 // found in the LICENSE file.
4
5 #ifndef MOJO_EDK_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_
6 #define MOJO_EDK_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_
7
8 #include "base/macros.h"
9 #include "base/memory/scoped_ptr.h"
10 #include "base/process/launch.h"
11 #include "build/build_config.h"
12 #include "mojo/edk/embedder/scoped_platform_handle.h"
13 #include "mojo/edk/system/system_impl_export.h"
14
15 namespace base {
16 class CommandLine;
17 }
18
19 namespace mojo {
20 namespace embedder {
21
22 // It would be nice to refactor base/process/launch.h to have a more platform-
23 // independent way of representing handles that are passed to child processes.
24 #if defined(OS_WIN)
25 typedef base::HandlesToInheritVector HandlePassingInformation;
26 #elif defined(OS_POSIX)
27 typedef base::FileHandleMappingVector HandlePassingInformation;
28 #else
29 #error "Unsupported."
30 #endif
31
32 // This is used to create a pair of |PlatformHandle|s that are connected by a
33 // suitable (platform-specific) bidirectional "pipe" (e.g., socket on POSIX,
34 // named pipe on Windows). The resulting handles can then be used in the same
35 // process (e.g., in tests) or between processes. (The "server" handle is the
36 // one that will be used in the process that created the pair, whereas the
37 // "client" handle is the one that will be used in a different process.)
38 //
39 // This class provides facilities for passing the client handle to a child
40 // process. The parent should call |PrepareToPassClientHandlelToChildProcess()|
41 // to get the data needed to do this, spawn the child using that data, and then
42 // call |ChildProcessLaunched()|. Note that on Windows this facility (will) only
43 // work on Vista and later (TODO(vtl)).
44 //
45 // Note: |PlatformChannelPair()|, |PassClientHandleFromParentProcess()| and
46 // |PrepareToPassClientHandleToChildProcess()| have platform-specific
47 // implementations.
48 //
49 // Note: On POSIX platforms, to write to the "pipe", use
50 // |PlatformChannel{Write,Writev}()| (from platform_channel_utils_posix.h)
51 // instead of |write()|, |writev()|, etc. Otherwise, you have to worry about
52 // platform differences in suppressing |SIGPIPE|.
53 class MOJO_SYSTEM_IMPL_EXPORT PlatformChannelPair {
54 public:
55 PlatformChannelPair();
56 ~PlatformChannelPair();
57
58 ScopedPlatformHandle PassServerHandle();
59
60 // For in-process use (e.g., in tests or to pass over another channel).
61 ScopedPlatformHandle PassClientHandle();
62
63 // To be called in the child process, after the parent process called
64 // |PrepareToPassClientHandleToChildProcess()| and launched the child (using
65 // the provided data), to create a client handle connected to the server
66 // handle (in the parent process).
67 static ScopedPlatformHandle PassClientHandleFromParentProcess(
68 const base::CommandLine& command_line);
69
70 // Prepares to pass the client channel to a new child process, to be launched
71 // using |LaunchProcess()| (from base/launch.h). Modifies |*command_line| and
72 // |*handle_passing_info| as needed.
73 // Note: For Windows, this method only works on Vista and later.
74 void PrepareToPassClientHandleToChildProcess(
75 base::CommandLine* command_line,
76 HandlePassingInformation* handle_passing_info) const;
77
78 // To be called once the child process has been successfully launched, to do
79 // any cleanup necessary.
80 void ChildProcessLaunched();
81
82 private:
83 static const char kMojoPlatformChannelHandleSwitch[];
84
85 ScopedPlatformHandle server_handle_;
86 ScopedPlatformHandle client_handle_;
87
88 DISALLOW_COPY_AND_ASSIGN(PlatformChannelPair);
89 };
90
91 } // namespace embedder
92 } // namespace mojo
93
94 #endif // MOJO_EDK_EMBEDDER_PLATFORM_CHANNEL_PAIR_H_
OLDNEW
« no previous file with comments | « mojo/edk/embedder/entrypoints.cc ('k') | mojo/edk/embedder/platform_channel_pair.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698