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

Side by Side Diff: content/browser/child_process_launcher.h

Issue 1022703007: Simplify ChildProcessLauncher (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@launcher
Patch Set: fix Android compile Created 5 years, 8 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
OLDNEW
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. 1 // Copyright (c) 2012 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 CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_ 5 #ifndef CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_
6 #define CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_ 6 #define CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_
7 7
8 #include "base/basictypes.h" 8 #include "base/basictypes.h"
9 #include "base/memory/ref_counted.h" 9 #include "base/files/scoped_file.h"
10 #include "base/memory/weak_ptr.h"
10 #include "base/process/kill.h" 11 #include "base/process/kill.h"
11 #include "base/process/launch.h" 12 #include "base/process/launch.h"
12 #include "base/process/process.h" 13 #include "base/process/process.h"
14 #include "base/threading/non_thread_safe.h"
13 #include "content/common/content_export.h" 15 #include "content/common/content_export.h"
16 #include "content/public/browser/browser_thread.h"
14 17
15 namespace base { 18 namespace base {
16 class CommandLine; 19 class CommandLine;
17 } 20 }
18 21
19 namespace content { 22 namespace content {
20 class SandboxedProcessLauncherDelegate; 23 class SandboxedProcessLauncherDelegate;
21 24
22 // Launches a process asynchronously and notifies the client of the process 25 // Launches a process asynchronously and notifies the client of the process
23 // handle when it's available. It's used to avoid blocking the calling thread 26 // handle when it's available. It's used to avoid blocking the calling thread
24 // on the OS since often it can take > 100 ms to create the process. 27 // on the OS since often it can take > 100 ms to create the process.
25 class CONTENT_EXPORT ChildProcessLauncher { 28 class CONTENT_EXPORT ChildProcessLauncher : public base::NonThreadSafe {
26 public: 29 public:
27 class CONTENT_EXPORT Client { 30 class CONTENT_EXPORT Client {
28 public: 31 public:
29 // Will be called on the thread that the ChildProcessLauncher was 32 // Will be called on the thread that the ChildProcessLauncher was
30 // constructed on. 33 // constructed on.
31 virtual void OnProcessLaunched() = 0; 34 virtual void OnProcessLaunched() = 0;
32 35
33 virtual void OnProcessLaunchFailed() {}; 36 virtual void OnProcessLaunchFailed() {};
34 37
35 protected: 38 protected:
36 virtual ~Client() {} 39 virtual ~Client() {}
37 }; 40 };
38 41
39 // Launches the process asynchronously, calling the client when the result is 42 // Launches the process asynchronously, calling the client when the result is
40 // ready. Deleting this object before the process is created is safe, since 43 // ready. Deleting this object before the process is created is safe, since
41 // the callback won't be called. If the process is still running by the time 44 // the callback won't be called. If the process is still running by the time
42 // this object destructs, it will be terminated. 45 // this object destructs, it will be terminated.
43 // Takes ownership of cmd_line. 46 // Takes ownership of cmd_line.
44 ChildProcessLauncher( 47 ChildProcessLauncher(
45 SandboxedProcessLauncherDelegate* delegate, 48 SandboxedProcessLauncherDelegate* delegate,
46 base::CommandLine* cmd_line, 49 base::CommandLine* cmd_line,
47 int child_process_id, 50 int child_process_id,
48 Client* client); 51 Client* client,
52 bool terminate_on_shutdown);
49 ~ChildProcessLauncher(); 53 ~ChildProcessLauncher();
50 54
51 // True if the process is being launched and so the handle isn't available. 55 // True if the process is being launched and so the handle isn't available.
52 bool IsStarting(); 56 bool IsStarting();
53 57
54 // Getter for the process. Only call after the process has started. 58 // Getter for the process. Only call after the process has started.
55 const base::Process& GetProcess() const; 59 const base::Process& GetProcess() const;
56 60
57 // Call this when the child process exits to know what happened to it. 61 // Call this when the child process exits to know what happened to it.
58 // |known_dead| can be true if we already know the process is dead as it can 62 // |known_dead| can be true if we already know the process is dead as it can
59 // help the implemention figure the proper TerminationStatus. 63 // help the implemention figure the proper TerminationStatus.
60 // On Linux, the use of |known_dead| is subtle and can be crucial if an 64 // On Linux, the use of |known_dead| is subtle and can be crucial if an
61 // accurate status is important. With |known_dead| set to false, a dead 65 // accurate status is important. With |known_dead| set to false, a dead
62 // process could be seen as running. With |known_dead| set to true, the 66 // process could be seen as running. With |known_dead| set to true, the
63 // process will be killed if it was still running. See ZygoteHostImpl for 67 // process will be killed if it was still running. See ZygoteHostImpl for
64 // more discussion of Linux implementation details. 68 // more discussion of Linux implementation details.
65 // |exit_code| is the exit code of the process if it exited (e.g. status from 69 // |exit_code| is the exit code of the process if it exited (e.g. status from
66 // waitpid if on posix, from GetExitCodeProcess on Windows). |exit_code| may 70 // waitpid if on posix, from GetExitCodeProcess on Windows). |exit_code| may
67 // be NULL. 71 // be NULL.
68 base::TerminationStatus GetChildTerminationStatus(bool known_dead, 72 base::TerminationStatus GetChildTerminationStatus(bool known_dead,
69 int* exit_code); 73 int* exit_code);
70 74
71 // Changes whether the process runs in the background or not. Only call 75 // Changes whether the process runs in the background or not. Only call
72 // this after the process has started. 76 // this after the process has started.
73 void SetProcessBackgrounded(bool background); 77 void SetProcessBackgrounded(bool background);
74 78
75 // Controls whether the child process should be terminated on browser
76 // shutdown.
77 void SetTerminateChildOnShutdown(bool terminate_on_shutdown);
78
79 // Replaces the ChildProcessLauncher::Client for testing purposes. Returns the 79 // Replaces the ChildProcessLauncher::Client for testing purposes. Returns the
80 // previous client. 80 // previous client.
81 Client* ReplaceClientForTest(Client* client); 81 Client* ReplaceClientForTest(Client* client);
82 82
83 private: 83 private:
84 class Context; 84 // Posts a task to the launcher thread to do the actual work.
85 void Launch(SandboxedProcessLauncherDelegate* delegate,
86 base::CommandLine* cmd_line,
87 int child_process_id);
85 88
86 scoped_refptr<Context> context_; 89 void UpdateTerminationStatus(bool known_dead);
90
91 // This is always called on the client thread after an attempt
92 // to launch the child process on the launcher thread.
93 // It makes sure we always perform the necessary cleanup if the
94 // client went away.
95 static void DidLaunch(base::WeakPtr<ChildProcessLauncher> instance,
96 bool terminate_on_shutdown,
97 bool zygote,
98 #if defined(OS_ANDROID)
99 base::ScopedFD ipcfd,
100 #endif
101 base::Process process);
102
103 // Notifies the client about the result of the operation.
104 void Notify(bool zygote,
105 #if defined(OS_ANDROID)
106 base::ScopedFD ipcfd,
107 #endif
108 base::Process process);
109
110 Client* client_;
111 BrowserThread::ID client_thread_id_;
112 base::Process process_;
113 base::TerminationStatus termination_status_;
114 int exit_code_;
115 bool zygote_;
116 bool starting_;
117 // Controls whether the child process should be terminated on browser
118 // shutdown. Default behavior is to terminate the child.
rvargas (doing something else) 2015/03/27 22:01:22 nit: There is no default behavior anymore. Note h
no sievers 2015/03/27 23:13:37 Good idea. Made it a default argument. (Unfortunat
119 const bool terminate_child_on_shutdown_;
120
121 base::WeakPtrFactory<ChildProcessLauncher> weak_factory_;
87 122
88 DISALLOW_COPY_AND_ASSIGN(ChildProcessLauncher); 123 DISALLOW_COPY_AND_ASSIGN(ChildProcessLauncher);
89 }; 124 };
90 125
91 } // namespace content 126 } // namespace content
92 127
93 #endif // CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_ 128 #endif // CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698