summaryrefslogtreecommitdiff
path: root/chromium/content/browser/child_process_launcher.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromium/content/browser/child_process_launcher.h')
-rw-r--r--chromium/content/browser/child_process_launcher.h85
1 files changed, 85 insertions, 0 deletions
diff --git a/chromium/content/browser/child_process_launcher.h b/chromium/content/browser/child_process_launcher.h
new file mode 100644
index 00000000000..5a6e1f96e26
--- /dev/null
+++ b/chromium/content/browser/child_process_launcher.h
@@ -0,0 +1,85 @@
+// Copyright (c) 2012 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 CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_
+#define CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_
+
+#include "base/basictypes.h"
+#include "base/memory/ref_counted.h"
+#include "base/process/kill.h"
+#include "base/process/launch.h"
+#include "content/common/content_export.h"
+
+class CommandLine;
+
+namespace content {
+class SandboxedProcessLauncherDelegate;
+
+// Launches a process asynchronously and notifies the client of the process
+// handle when it's available. It's used to avoid blocking the calling thread
+// on the OS since often it can take > 100 ms to create the process.
+class CONTENT_EXPORT ChildProcessLauncher {
+ public:
+ class CONTENT_EXPORT Client {
+ public:
+ // Will be called on the thread that the ChildProcessLauncher was
+ // constructed on.
+ virtual void OnProcessLaunched() = 0;
+
+ protected:
+ virtual ~Client() {}
+ };
+
+ // Launches the process asynchronously, calling the client when the result is
+ // ready. Deleting this object before the process is created is safe, since
+ // the callback won't be called. If the process is still running by the time
+ // this object destructs, it will be terminated.
+ // Takes ownership of cmd_line.
+ ChildProcessLauncher(
+#if defined(OS_WIN)
+ SandboxedProcessLauncherDelegate* delegate,
+#elif defined(OS_POSIX)
+ bool use_zygote,
+ const base::EnvironmentVector& environ,
+ int ipcfd,
+#endif
+ CommandLine* cmd_line,
+ int child_process_id,
+ Client* client);
+ ~ChildProcessLauncher();
+
+ // True if the process is being launched and so the handle isn't available.
+ bool IsStarting();
+
+ // Getter for the process handle. Only call after the process has started.
+ base::ProcessHandle GetHandle();
+
+ // Call this when the child process exits to know what happened to it.
+ // |known_dead| can be true if we already know the process is dead as it can
+ // help the implemention figure the proper TerminationStatus.
+ // |exit_code| is the exit code of the process if it exited (e.g. status from
+ // waitpid if on posix, from GetExitCodeProcess on Windows). |exit_code| may
+ // be NULL.
+ base::TerminationStatus GetChildTerminationStatus(bool known_dead,
+ int* exit_code);
+
+ // Changes whether the process runs in the background or not. Only call
+ // this after the process has started.
+ void SetProcessBackgrounded(bool background);
+
+ // Controls whether the child process should be terminated on browser
+ // shutdown.
+ void SetTerminateChildOnShutdown(bool terminate_on_shutdown);
+
+ private:
+ class Context;
+
+ scoped_refptr<Context> context_;
+
+ DISALLOW_COPY_AND_ASSIGN(ChildProcessLauncher);
+};
+
+} // namespace content
+
+#endif // CONTENT_BROWSER_CHILD_PROCESS_LAUNCHER_H_