| OLD | NEW |
| (Empty) |
| 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 | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CHROME_COMMON_CHILD_PROCESS_INFO_H_ | |
| 6 #define CHROME_COMMON_CHILD_PROCESS_INFO_H_ | |
| 7 #pragma once | |
| 8 | |
| 9 #include <string> | |
| 10 | |
| 11 #include "base/process.h" | |
| 12 #include "base/string16.h" | |
| 13 | |
| 14 // Holds information about a child process. | |
| 15 class ChildProcessInfo { | |
| 16 public: | |
| 17 // NOTE: Do not remove or reorder the elements in this enum, and only add new | |
| 18 // items at the end. We depend on these specific values in a histogram. | |
| 19 enum ProcessType { | |
| 20 UNKNOWN_PROCESS = 1, | |
| 21 BROWSER_PROCESS, | |
| 22 RENDER_PROCESS, | |
| 23 PLUGIN_PROCESS, | |
| 24 WORKER_PROCESS, | |
| 25 NACL_LOADER_PROCESS, | |
| 26 UTILITY_PROCESS, | |
| 27 PROFILE_IMPORT_PROCESS, | |
| 28 ZYGOTE_PROCESS, | |
| 29 SANDBOX_HELPER_PROCESS, | |
| 30 NACL_BROKER_PROCESS, | |
| 31 GPU_PROCESS, | |
| 32 PPAPI_PLUGIN_PROCESS | |
| 33 }; | |
| 34 | |
| 35 // NOTE: Do not remove or reorder the elements in this enum, and only add new | |
| 36 // items at the end. We depend on these specific values in a histogram. | |
| 37 enum RendererProcessType { | |
| 38 RENDERER_UNKNOWN = 0, | |
| 39 RENDERER_NORMAL, | |
| 40 RENDERER_CHROME, // WebUI (chrome:// URL) | |
| 41 RENDERER_EXTENSION, // chrome-extension:// | |
| 42 RENDERER_DEVTOOLS, // Web inspector | |
| 43 RENDERER_INTERSTITIAL, // malware/phishing interstitial | |
| 44 RENDERER_NOTIFICATION, // HTML notification bubble | |
| 45 RENDERER_BACKGROUND_APP // hosted app background page | |
| 46 }; | |
| 47 | |
| 48 ChildProcessInfo(const ChildProcessInfo& original); | |
| 49 virtual ~ChildProcessInfo(); | |
| 50 | |
| 51 ChildProcessInfo& operator=(const ChildProcessInfo& original); | |
| 52 | |
| 53 // Returns the type of the process. | |
| 54 ProcessType type() const { return type_; } | |
| 55 | |
| 56 // Returns the renderer subtype of this process. | |
| 57 // Only valid if the type() is RENDER_PROCESS. | |
| 58 RendererProcessType renderer_type() const { return renderer_type_; } | |
| 59 | |
| 60 // Returns the name of the process. i.e. for plugins it might be Flash, while | |
| 61 // for workers it might be the domain that it's from. | |
| 62 std::wstring name() const { return name_; } | |
| 63 | |
| 64 // Returns the version of the exe, this only appliest to plugins. Otherwise | |
| 65 // the string is empty. | |
| 66 std::wstring version() const { return version_; } | |
| 67 | |
| 68 // Getter to the process handle. | |
| 69 base::ProcessHandle handle() const { return process_.handle(); } | |
| 70 | |
| 71 // Getter to the process ID. | |
| 72 int pid() const { return process_.pid(); } | |
| 73 | |
| 74 // The unique identifier for this child process. This identifier is NOT a | |
| 75 // process ID, and will be unique for all types of child process for | |
| 76 // one run of the browser. | |
| 77 int id() const { return id_; } | |
| 78 | |
| 79 void SetProcessBackgrounded() const { process_.SetProcessBackgrounded(true); } | |
| 80 | |
| 81 // Returns an English name of the process type, should only be used for non | |
| 82 // user-visible strings, or debugging pages like about:memory. | |
| 83 static std::string GetFullTypeNameInEnglish(ProcessType type, | |
| 84 RendererProcessType rtype); | |
| 85 static std::string GetTypeNameInEnglish(ProcessType type); | |
| 86 static std::string GetRendererTypeNameInEnglish(RendererProcessType type); | |
| 87 | |
| 88 // Returns a localized title for the child process. For example, a plugin | |
| 89 // process would be "Plug-in: Flash" when name is "Flash". | |
| 90 string16 GetLocalizedTitle() const; | |
| 91 | |
| 92 // We define the < operator so that the ChildProcessInfo can be used as a key | |
| 93 // in a std::map. | |
| 94 bool operator <(const ChildProcessInfo& rhs) const { | |
| 95 if (process_.handle() != rhs.process_.handle()) | |
| 96 return process_ .handle() < rhs.process_.handle(); | |
| 97 return false; | |
| 98 } | |
| 99 | |
| 100 bool operator ==(const ChildProcessInfo& rhs) const { | |
| 101 return process_.handle() == rhs.process_.handle(); | |
| 102 } | |
| 103 | |
| 104 // Generates a unique channel name for a child renderer/plugin process. | |
| 105 // The "instance" pointer value is baked into the channel id. | |
| 106 static std::string GenerateRandomChannelID(void* instance); | |
| 107 | |
| 108 // Returns a unique ID to identify a child process. On construction, this | |
| 109 // function will be used to generate the id_, but it is also used to generate | |
| 110 // IDs for the RenderProcessHost, which doesn't inherit from us, and whose IDs | |
| 111 // must be unique for all child processes. | |
| 112 // | |
| 113 // This function is threadsafe since RenderProcessHost is on the UI thread, | |
| 114 // but normally this will be used on the IO thread. | |
| 115 static int GenerateChildProcessUniqueId(); | |
| 116 | |
| 117 protected: | |
| 118 // Derived objects need to use this constructor so we know what type we are. | |
| 119 // If the caller has already generated a unique ID for this child process, | |
| 120 // it should pass it as the second argument. Otherwise, -1 should be passed | |
| 121 // and a unique ID will be automatically generated. | |
| 122 ChildProcessInfo(ProcessType type, int id); | |
| 123 | |
| 124 void set_type(ProcessType type) { type_ = type; } | |
| 125 void set_renderer_type(RendererProcessType type) { renderer_type_ = type; } | |
| 126 void set_name(const std::wstring& name) { name_ = name; } | |
| 127 void set_version(const std::wstring& ver) { version_ = ver; } | |
| 128 void set_handle(base::ProcessHandle handle) { process_.set_handle(handle); } | |
| 129 | |
| 130 private: | |
| 131 ProcessType type_; | |
| 132 RendererProcessType renderer_type_; | |
| 133 std::wstring name_; | |
| 134 std::wstring version_; | |
| 135 int id_; | |
| 136 | |
| 137 // The handle to the process. | |
| 138 mutable base::Process process_; | |
| 139 }; | |
| 140 | |
| 141 #endif // CHROME_COMMON_CHILD_PROCESS_INFO_H_ | |
| OLD | NEW |