summaryrefslogtreecommitdiffstats
path: root/content/app/content_main_delegate.h
blob: 3e28c5d7c419c5b036a3a8165598a395bec7e3d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
// Copyright (c) 2011 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_APP_CONTENT_MAIN_DELEGATE_H_
#define CONTENT_APP_CONTENT_MAIN_DELEGATE_H_
#pragma once

#include <string>

#include "build/build_config.h"

struct MainFunctionParams;
class ZygoteForkDelegate;

namespace content {

class ContentMainDelegate {
 public:
  // Tells the embedder that the absolute basic startup has been done, i.e. it's
  // now safe to create singletons and check the command line. Return true if
  // the process should exit afterwards, and if so, |exit_code| should be set.
  // This is the place for embedder to do the things that must happen at the
  // start. Most of its startup code should be in the methods below.
  virtual bool BasicStartupComplete(int* exit_code) = 0;

  // This is where the embedder puts all of its startup code that needs to run
  // before the sandbox is engaged.
  virtual void PreSandboxStartup() = 0;

  // This is where the embedder can add startup code to run after the sandbox
  // has been initialized.
  virtual void SandboxInitialized(const std::string& process_type) = 0;

  // Asks the embedder to start a process that content doesn't know about.
  virtual int RunProcess(const std::string& process_type,
                         const MainFunctionParams& main_function_params) = 0;

  // Called right before the process exits.
  virtual void ProcessExiting(const std::string& process_type) = 0;

#if defined(OS_MACOSX)
  // Returns true if the process registers with the system monitor, so that we
  // can allocate an IO port for it before the sandbox is initialized. Embedders
  // are called only for process types that content doesn't know about.
  virtual bool ProcessRegistersWithSystemProcess(
      const std::string& process_type) = 0;

  // Used to determine if we should send the mach port to the parent process or
  // not. The embedder usually sends it for all child processes, use this to
  // override this behavior.
  virtual bool ShouldSendMachPort(const std::string& process_type) = 0;

  // Allows the embedder to override initializing the sandbox. This is needed
  // because some processes might not want to enable it right away or might not
  // want it at all.
  virtual bool DelaySandboxInitialization(const std::string& process_type) = 0;
#elif defined(OS_POSIX)
  // Tells the embedder that the zygote process is starting, and allows it to
  // specify a zygote delegate if it wishes.
  virtual ZygoteForkDelegate* ZygoteStarting() = 0;

  // Called every time the zygote process forks.
  virtual void ZygoteForked() = 0;
#endif  // OS_MACOSX
};

}  // namespace content

#endif  // CONTENT_APP_CONTENT_MAIN_DELEGATE_H_