| Index: content/browser/utility_process_host.h
|
| ===================================================================
|
| --- content/browser/utility_process_host.h (revision 120256)
|
| +++ content/browser/utility_process_host.h (working copy)
|
| @@ -1,128 +0,0 @@
|
| -// 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_UTILITY_PROCESS_HOST_H_
|
| -#define CONTENT_BROWSER_UTILITY_PROCESS_HOST_H_
|
| -#pragma once
|
| -
|
| -#include <string>
|
| -#include <vector>
|
| -
|
| -#include "base/basictypes.h"
|
| -#include "base/memory/ref_counted.h"
|
| -#include "base/process_util.h"
|
| -#include "base/memory/weak_ptr.h"
|
| -#include "content/common/content_export.h"
|
| -#include "content/public/browser/browser_child_process_host_delegate.h"
|
| -#include "content/public/browser/browser_thread.h"
|
| -#include "ipc/ipc_message.h"
|
| -
|
| -class BrowserChildProcessHostImpl;
|
| -
|
| -// This class acts as the browser-side host to a utility child process. A
|
| -// utility process is a short-lived sandboxed process that is created to run
|
| -// a specific task. This class lives solely on the IO thread.
|
| -// If you need a single method call in the sandbox, use StartFooBar(p).
|
| -// If you need multiple batches of work to be done in the sandboxed process,
|
| -// use StartBatchMode(), then multiple calls to StartFooBar(p),
|
| -// then finish with EndBatchMode().
|
| -//
|
| -// Note: If your class keeps a ptr to an object of this type, grab a weak ptr to
|
| -// avoid a use after free. See http://crbug.com/108871.
|
| -class CONTENT_EXPORT UtilityProcessHost
|
| - : public content::BrowserChildProcessHostDelegate,
|
| - public IPC::Message::Sender,
|
| - public base::SupportsWeakPtr<UtilityProcessHost> {
|
| - public:
|
| - // An interface to be implemented by consumers of the utility process to
|
| - // get results back. All functions are called on the thread passed along
|
| - // to UtilityProcessHost.
|
| - class CONTENT_EXPORT Client : public base::RefCountedThreadSafe<Client> {
|
| - public:
|
| - Client();
|
| -
|
| - // Called when the process has crashed.
|
| - virtual void OnProcessCrashed(int exit_code);
|
| -
|
| - // Allow the client to filter IPC messages.
|
| - virtual bool OnMessageReceived(const IPC::Message& message);
|
| -
|
| - protected:
|
| - friend class base::RefCountedThreadSafe<Client>;
|
| -
|
| - virtual ~Client();
|
| -
|
| - private:
|
| - friend class UtilityProcessHost;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(Client);
|
| - };
|
| -
|
| - UtilityProcessHost(Client* client,
|
| - content::BrowserThread::ID client_thread_id);
|
| - virtual ~UtilityProcessHost();
|
| -
|
| - // IPC::Message::Sender implementation:
|
| - virtual bool Send(IPC::Message* message) OVERRIDE;
|
| -
|
| - // Starts utility process in batch mode. Caller must call EndBatchMode()
|
| - // to finish the utility process.
|
| - bool StartBatchMode();
|
| -
|
| - // Ends the utility process. Must be called after StartBatchMode().
|
| - void EndBatchMode();
|
| -
|
| - void set_exposed_dir(const FilePath& dir) { exposed_dir_ = dir; }
|
| - void set_no_sandbox(bool flag) { no_sandbox_ = flag; }
|
| - void set_child_flags(int flags) { child_flags_ = flags; }
|
| - void set_use_linux_zygote(bool flag) { use_linux_zygote_ = flag; }
|
| -#if defined(OS_POSIX)
|
| - void set_env(const base::environment_vector& env) { env_ = env; }
|
| -#endif
|
| -
|
| - protected:
|
| - // Allow these methods to be overridden for tests.
|
| - virtual FilePath GetUtilityProcessCmd();
|
| -
|
| - private:
|
| - // Starts a process if necessary. Returns true if it succeeded or a process
|
| - // has already been started via StartBatchMode().
|
| - bool StartProcess();
|
| -
|
| - // BrowserChildProcessHost:
|
| - virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
|
| - virtual void OnProcessCrashed(int exit_code) OVERRIDE;
|
| -
|
| - // A pointer to our client interface, who will be informed of progress.
|
| - scoped_refptr<Client> client_;
|
| - content::BrowserThread::ID client_thread_id_;
|
| - // True when running in batch mode, i.e., StartBatchMode() has been called
|
| - // and the utility process will run until EndBatchMode().
|
| - bool is_batch_mode_;
|
| -
|
| - // Allows a directory to be opened through the sandbox, in case it's needed by
|
| - // the operation.
|
| - FilePath exposed_dir_;
|
| -
|
| - // Whether to pass switches::kNoSandbox to the child.
|
| - bool no_sandbox_;
|
| -
|
| - // Flags defined in ChildProcessHost with which to start the process.
|
| - int child_flags_;
|
| -
|
| - // If the |no_sandbox_| flag is off, and we are on Linux, launch the
|
| - // utility process from the zygote. Defaults to false.
|
| - // Can only be used for tasks that do not require FS access.
|
| - bool use_linux_zygote_;
|
| -
|
| - base::environment_vector env_;
|
| -
|
| - bool started_;
|
| -
|
| - scoped_ptr<BrowserChildProcessHostImpl> process_;
|
| -
|
| - DISALLOW_COPY_AND_ASSIGN(UtilityProcessHost);
|
| -};
|
| -
|
| -#endif // CONTENT_BROWSER_UTILITY_PROCESS_HOST_H_
|
|
|