OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CONTENT_APP_CONTENT_MAIN_DELEGATE_H_ | 5 #ifndef CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_ |
6 #define CONTENT_APP_CONTENT_MAIN_DELEGATE_H_ | 6 #define CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_ |
7 #pragma once | 7 #pragma once |
8 | 8 |
9 #include <string> | 9 #include <string> |
10 | 10 |
11 #include "build/build_config.h" | 11 #include "build/build_config.h" |
12 #include "content/common/content_export.h" | |
13 | 12 |
14 struct MainFunctionParams; | 13 struct MainFunctionParams; |
15 class ZygoteForkDelegate; | 14 class ZygoteForkDelegate; |
16 | 15 |
17 namespace content { | 16 namespace content { |
18 | 17 |
19 class CONTENT_EXPORT ContentMainDelegate { | 18 class ContentMainDelegate { |
20 public: | 19 public: |
21 virtual ~ContentMainDelegate(); | 20 virtual ~ContentMainDelegate() {} |
22 | 21 |
23 // Tells the embedder that the absolute basic startup has been done, i.e. it's | 22 // Tells the embedder that the absolute basic startup has been done, i.e. it's |
24 // now safe to create singletons and check the command line. Return true if | 23 // now safe to create singletons and check the command line. Return true if |
25 // the process should exit afterwards, and if so, |exit_code| should be set. | 24 // the process should exit afterwards, and if so, |exit_code| should be set. |
26 // This is the place for embedder to do the things that must happen at the | 25 // This is the place for embedder to do the things that must happen at the |
27 // start. Most of its startup code should be in the methods below. | 26 // start. Most of its startup code should be in the methods below. |
28 virtual bool BasicStartupComplete(int* exit_code); | 27 virtual bool BasicStartupComplete(int* exit_code) = 0; |
29 | 28 |
30 // This is where the embedder puts all of its startup code that needs to run | 29 // This is where the embedder puts all of its startup code that needs to run |
31 // before the sandbox is engaged. | 30 // before the sandbox is engaged. |
32 virtual void PreSandboxStartup(); | 31 virtual void PreSandboxStartup() = 0; |
33 | 32 |
34 // This is where the embedder can add startup code to run after the sandbox | 33 // This is where the embedder can add startup code to run after the sandbox |
35 // has been initialized. | 34 // has been initialized. |
36 virtual void SandboxInitialized(const std::string& process_type); | 35 virtual void SandboxInitialized(const std::string& process_type) = 0; |
37 | 36 |
38 // Asks the embedder to start a process that content doesn't know about. | 37 // Asks the embedder to start a process that content doesn't know about. |
39 virtual int RunProcess(const std::string& process_type, | 38 virtual int RunProcess(const std::string& process_type, |
40 const MainFunctionParams& main_function_params); | 39 const MainFunctionParams& main_function_params) = 0; |
41 | 40 |
42 // Called right before the process exits. | 41 // Called right before the process exits. |
43 virtual void ProcessExiting(const std::string& process_type); | 42 virtual void ProcessExiting(const std::string& process_type) = 0; |
44 | 43 |
45 #if defined(OS_MACOSX) | 44 #if defined(OS_MACOSX) |
46 // Returns true if the process registers with the system monitor, so that we | 45 // Returns true if the process registers with the system monitor, so that we |
47 // can allocate an IO port for it before the sandbox is initialized. Embedders | 46 // can allocate an IO port for it before the sandbox is initialized. Embedders |
48 // are called only for process types that content doesn't know about. | 47 // are called only for process types that content doesn't know about. |
49 virtual bool ProcessRegistersWithSystemProcess( | 48 virtual bool ProcessRegistersWithSystemProcess( |
50 const std::string& process_type); | 49 const std::string& process_type) = 0; |
51 | 50 |
52 // Used to determine if we should send the mach port to the parent process or | 51 // Used to determine if we should send the mach port to the parent process or |
53 // not. The embedder usually sends it for all child processes, use this to | 52 // not. The embedder usually sends it for all child processes, use this to |
54 // override this behavior. | 53 // override this behavior. |
55 virtual bool ShouldSendMachPort(const std::string& process_type); | 54 virtual bool ShouldSendMachPort(const std::string& process_type) = 0; |
56 | 55 |
57 // Allows the embedder to override initializing the sandbox. This is needed | 56 // Allows the embedder to override initializing the sandbox. This is needed |
58 // because some processes might not want to enable it right away or might not | 57 // because some processes might not want to enable it right away or might not |
59 // want it at all. | 58 // want it at all. |
60 virtual bool DelaySandboxInitialization(const std::string& process_type); | 59 virtual bool DelaySandboxInitialization(const std::string& process_type) = 0; |
61 | 60 |
62 #elif defined(OS_POSIX) | 61 #elif defined(OS_POSIX) |
63 // Tells the embedder that the zygote process is starting, and allows it to | 62 // Tells the embedder that the zygote process is starting, and allows it to |
64 // specify a zygote delegate if it wishes. | 63 // specify a zygote delegate if it wishes. |
65 virtual ZygoteForkDelegate* ZygoteStarting(); | 64 virtual ZygoteForkDelegate* ZygoteStarting() = 0; |
66 | 65 |
67 // Called every time the zygote process forks. | 66 // Called every time the zygote process forks. |
68 virtual void ZygoteForked(); | 67 virtual void ZygoteForked() = 0; |
69 #endif // OS_MACOSX | 68 #endif // OS_MACOSX |
70 }; | 69 }; |
71 | 70 |
72 } // namespace content | 71 } // namespace content |
73 | 72 |
74 #endif // CONTENT_APP_CONTENT_MAIN_DELEGATE_H_ | 73 #endif // CONTENT_PUBLIC_APP_CONTENT_MAIN_DELEGATE_H_ |
OLD | NEW |