| Index: chrome/browser/child_process_host.h
|
| ===================================================================
|
| --- chrome/browser/child_process_host.h (revision 51385)
|
| +++ chrome/browser/child_process_host.h (working copy)
|
| @@ -1,161 +0,0 @@
|
| -// Copyright (c) 2009 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 CHROME_BROWSER_CHILD_PROCESS_HOST_H_
|
| -#define CHROME_BROWSER_CHILD_PROCESS_HOST_H_
|
| -
|
| -#include <list>
|
| -#include <string>
|
| -
|
| -// Must be included early (e.g. before chrome/common/plugin_messages.h)
|
| -#include "ipc/ipc_logging.h"
|
| -
|
| -#include "base/basictypes.h"
|
| -#include "base/scoped_ptr.h"
|
| -#include "chrome/browser/child_process_launcher.h"
|
| -#include "chrome/browser/renderer_host/resource_dispatcher_host.h"
|
| -#include "ipc/ipc_channel.h"
|
| -
|
| -class CommandLine;
|
| -class NotificationType;
|
| -
|
| -// Plugins/workers and other child processes that live on the IO thread should
|
| -// derive from this class.
|
| -//
|
| -// [Browser]RenderProcessHost is the main exception that doesn't derive from
|
| -// this class. That project lives on the UI thread.
|
| -class ChildProcessHost : public ResourceDispatcherHost::Receiver,
|
| - public IPC::Channel::Listener,
|
| - public ChildProcessLauncher::Client {
|
| - public:
|
| - virtual ~ChildProcessHost();
|
| -
|
| - // Returns the pathname to be used for a child process. If a subprocess
|
| - // pathname was specified on the command line, that will be used. Otherwise,
|
| - // the default child process pathname will be returned. On most platforms,
|
| - // this will be the same as the currently-executing process.
|
| - //
|
| - // The argument allow_self is used on Linux to indicate that we allow us to
|
| - // fork from /proc/self/exe rather than using the "real" app path. This
|
| - // prevents autoupdate from confusing us if it changes the file out from
|
| - // under us. You will generally want to set this to true, except when there
|
| - // is an override to the command line (for example, we're forking a renderer
|
| - // in gdb). In this case, you'd use GetChildPath to get the real executable
|
| - // file name, and then prepend the GDB command to the command line.
|
| - //
|
| - // On failure, returns an empty FilePath.
|
| - static FilePath GetChildPath(bool allow_self);
|
| -
|
| - // Prepares command_line for crash reporting as appropriate. On Linux and
|
| - // Mac, a command-line flag to enable crash reporting in the child process
|
| - // will be appended if needed, because the child process may not have access
|
| - // to the data that determines the status of crash reporting in the
|
| - // currently-executing process. This function is a no-op on Windows.
|
| - static void SetCrashReporterCommandLine(CommandLine* command_line);
|
| -
|
| - // Terminates all child processes and deletes each ChildProcessHost instance.
|
| - static void TerminateAll();
|
| -
|
| - // ResourceDispatcherHost::Receiver implementation:
|
| - virtual bool Send(IPC::Message* msg);
|
| -
|
| - // The Iterator class allows iteration through either all child processes, or
|
| - // ones of a specific type, depending on which constructor is used. Note that
|
| - // this should be done from the IO thread and that the iterator should not be
|
| - // kept around as it may be invalidated on subsequent event processing in the
|
| - // event loop.
|
| - class Iterator {
|
| - public:
|
| - Iterator();
|
| - explicit Iterator(ProcessType type);
|
| - ChildProcessHost* operator->() { return *iterator_; }
|
| - ChildProcessHost* operator*() { return *iterator_; }
|
| - ChildProcessHost* operator++();
|
| - bool Done();
|
| -
|
| - private:
|
| - bool all_;
|
| - ProcessType type_;
|
| - std::list<ChildProcessHost*>::iterator iterator_;
|
| - };
|
| -
|
| - protected:
|
| - // The resource_dispatcher_host may be NULL to indicate none is needed for
|
| - // this process type.
|
| - ChildProcessHost(ProcessType type,
|
| - ResourceDispatcherHost* resource_dispatcher_host);
|
| -
|
| - // Derived classes call this to launch the child process asynchronously.
|
| - void Launch(
|
| -#if defined(OS_WIN)
|
| - const FilePath& exposed_dir,
|
| -#elif defined(OS_POSIX)
|
| - bool use_zygote,
|
| - const base::environment_vector& environ,
|
| -#endif
|
| - CommandLine* cmd_line);
|
| -
|
| - // Derived classes return true if it's ok to shut down the child process.
|
| - virtual bool CanShutdown() = 0;
|
| -
|
| - // Send the shutdown message to the child process, and remove this host from
|
| - // the host list. Does not check if CanShutdown is true.
|
| - void ForceShutdown();
|
| -
|
| - // Creates the IPC channel. Returns true iff it succeeded.
|
| - bool CreateChannel();
|
| -
|
| - // Notifies us that an instance has been created on this child process.
|
| - void InstanceCreated();
|
| -
|
| - // IPC::Channel::Listener implementation:
|
| - virtual void OnMessageReceived(const IPC::Message& msg) { }
|
| - virtual void OnChannelConnected(int32 peer_pid) { }
|
| - virtual void OnChannelError() { }
|
| -
|
| - // ChildProcessLauncher::Client implementation.
|
| - virtual void OnProcessLaunched() {}
|
| -
|
| - // Derived classes can override this to know if the process crashed.
|
| - virtual void OnProcessCrashed() {}
|
| -
|
| - bool opening_channel() { return opening_channel_; }
|
| - const std::string& channel_id() { return channel_id_; }
|
| -
|
| - virtual bool DidChildCrash();
|
| -
|
| - // Called when the child process goes away.
|
| - virtual void OnChildDied();
|
| -
|
| - private:
|
| - // Sends the given notification to the notification service on the UI thread.
|
| - void Notify(NotificationType type);
|
| -
|
| - // By using an internal class as the IPC::Channel::Listener, we can intercept
|
| - // OnMessageReceived/OnChannelConnected and do our own processing before
|
| - // calling the subclass' implementation.
|
| - class ListenerHook : public IPC::Channel::Listener,
|
| - public ChildProcessLauncher::Client {
|
| - public:
|
| - explicit ListenerHook(ChildProcessHost* host);
|
| - virtual void OnMessageReceived(const IPC::Message& msg);
|
| - virtual void OnChannelConnected(int32 peer_pid);
|
| - virtual void OnChannelError();
|
| - virtual void OnProcessLaunched();
|
| - private:
|
| - ChildProcessHost* host_;
|
| - };
|
| -
|
| - ListenerHook listener_;
|
| -
|
| - // May be NULL if this current process has no resource dispatcher host.
|
| - ResourceDispatcherHost* resource_dispatcher_host_;
|
| -
|
| - bool opening_channel_; // True while we're waiting the channel to be opened.
|
| - scoped_ptr<IPC::Channel> channel_;
|
| - std::string channel_id_;
|
| - scoped_ptr<ChildProcessLauncher> child_process_;
|
| -};
|
| -
|
| -#endif // CHROME_BROWSER_CHILD_PROCESS_HOST_H_
|
|
|