content/public/app/content_main_delegate.h

   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
  13 template <typename>
  14 class ScopedVector;
  15
  16 namespace content {
  17
  18 class ContentBrowserClient;
  19 class ContentPluginClient;
  20 class ContentRendererClient;
  21 class ContentUtilityClient;
  22 class ZygoteForkDelegate;
  23 struct MainFunctionParams;
  24
  25 class 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_