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
3// found in the LICENSE file.
4
5#ifndef CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_
6#define CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_
7
8#include <string>
9
10#include "build/build_config.h"
11#include "content/common/content_export.h"
12
13template <typename>
14class ScopedVector;
15
16namespace content {
17
18class ContentBrowserClient;
19class ContentPluginClient;
20class ContentRendererClient;
21class ContentUtilityClient;
22class ZygoteForkDelegate;
23struct MainFunctionParams;
24
25class CONTENT_EXPORT ContentMainDelegate {
26 public:
27  virtual ~ContentMainDelegate() {}
28
29  // Tells the embedder that the absolute basic startup has been done, i.e.
30  // it's now safe to create singletons and check the command line. Return true
31  // if the process should exit afterwards, and if so, |exit_code| should be
32  // set. This is the place for embedder to do the things that must happen at
33  // the start. Most of its startup code should be in the methods below.
34  virtual bool BasicStartupComplete(int* exit_code);
35
36  // This is where the embedder puts all of its startup code that needs to run
37  // before the sandbox is engaged.
38  virtual void PreSandboxStartup() {}
39
40  // This is where the embedder can add startup code to run after the sandbox
41  // has been initialized.
42  virtual void SandboxInitialized(const std::string& process_type) {}
43
44  // Asks the embedder to start a process. Return -1 for the default behavior.
45  virtual int RunProcess(
46      const std::string& process_type,
47      const MainFunctionParams& main_function_params);
48
49  // Called right before the process exits.
50  virtual void ProcessExiting(const std::string& process_type) {}
51
52#if defined(OS_MACOSX) && !defined(OS_IOS)
53  // Returns true if the process registers with the system monitor, so that we
54  // can allocate an IO port for it before the sandbox is initialized. Embedders
55  // are called only for process types that content doesn't know about.
56  virtual bool ProcessRegistersWithSystemProcess(
57      const std::string& process_type);
58
59  // Used to determine if we should send the mach port to the parent process or
60  // not. The embedder usually sends it for all child processes, use this to
61  // override this behavior.
62  virtual bool ShouldSendMachPort(const std::string& process_type);
63
64  // Allows the embedder to override initializing the sandbox. This is needed
65  // because some processes might not want to enable it right away or might not
66  // want it at all.
67  virtual bool DelaySandboxInitialization(const std::string& process_type);
68
69#elif defined(OS_POSIX) && !defined(OS_ANDROID) && !defined(OS_IOS)
70  // Tells the embedder that the zygote process is starting, and allows it to
71  // specify one or more zygote delegates if it wishes by storing them in
72  // |*delegates|.
73  virtual void ZygoteStarting(ScopedVector<ZygoteForkDelegate>* delegates);
74
75  // Called every time the zygote process forks.
76  virtual void ZygoteForked() {}
77#endif  // OS_MACOSX
78
79  // Allows the embedder to disable termination on heap corruption.
80  // This is being used to measure the impact of this feature on crash reports.
81  // Termination on heap corruption is enabled by default.
82  // TODO(erikwright): Remove this by September 2014 when experimentation is
83  // complete.
84  virtual bool ShouldEnableTerminationOnHeapCorruption();
85
86 protected:
87  friend class ContentClientInitializer;
88
89  // Called once per relevant process type to allow the embedder to customize
90  // content. If an embedder wants the default (empty) implementation, don't
91  // override this.
92  virtual ContentBrowserClient* CreateContentBrowserClient();
93  virtual ContentPluginClient* CreateContentPluginClient();
94  virtual ContentRendererClient* CreateContentRendererClient();
95  virtual ContentUtilityClient* CreateContentUtilityClient();
96};
97
98}  // namespace content
99
100#endif  // CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_
101