1 // Copyright 2013 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.
5 #ifndef CHROME_BROWSER_TASK_MANAGER_RESOURCE_PROVIDER_H_
6 #define CHROME_BROWSER_TASK_MANAGER_RESOURCE_PROVIDER_H_
8 #include "base/basictypes.h"
9 #include "base/memory/ref_counted.h"
10 #include "base/process/process_handle.h"
11 #include "base/strings/string16.h"
12 #include "third_party/WebKit/public/web/WebCache.h"
14 class PrefRegistrySimple
;
15 class TaskManagerModel
;
21 namespace extensions
{
29 namespace task_manager
{
31 #define TASKMANAGER_RESOURCE_TYPE_LIST(def) \
32 def(BROWSER) /* The main browser process. */ \
33 def(RENDERER) /* A normal WebContents renderer process. */ \
34 def(EXTENSION) /* An extension or app process. */ \
35 def(NOTIFICATION) /* A notification process. */ \
36 def(GUEST) /* A browser plugin guest process. */ \
37 def(PLUGIN) /* A plugin process. */ \
38 def(WORKER) /* A web worker process. */ \
39 def(NACL) /* A NativeClient loader or broker process. */ \
40 def(UTILITY) /* A browser utility process. */ \
41 def(ZYGOTE) /* A Linux zygote process. */ \
42 def(SANDBOX_HELPER) /* A sandbox helper process. */ \
43 def(GPU) /* A graphics process. */
45 #define TASKMANAGER_RESOURCE_TYPE_LIST_ENUM(a) a,
46 #define TASKMANAGER_RESOURCE_TYPE_LIST_AS_STRING(a) case a: return #a;
48 // A resource represents one row in the task manager.
49 // Resources from similar processes are grouped together by the task manager.
52 virtual ~Resource() {}
56 TASKMANAGER_RESOURCE_TYPE_LIST(TASKMANAGER_RESOURCE_TYPE_LIST_ENUM
)
59 virtual base::string16
GetTitle() const = 0;
60 virtual base::string16
GetProfileName() const = 0;
61 virtual gfx::ImageSkia
GetIcon() const = 0;
62 virtual base::ProcessHandle
GetProcess() const = 0;
63 virtual int GetUniqueChildProcessId() const = 0;
64 virtual Type
GetType() const = 0;
65 virtual int GetRoutingID() const;
67 virtual bool ReportsCacheStats() const;
68 virtual blink::WebCache::ResourceTypeStats
GetWebCoreCacheStats() const;
70 virtual bool ReportsSqliteMemoryUsed() const;
71 virtual size_t SqliteMemoryUsedBytes() const;
73 virtual bool ReportsV8MemoryStats() const;
74 virtual size_t GetV8MemoryAllocated() const;
75 virtual size_t GetV8MemoryUsed() const;
77 // A helper function for ActivateProcess when selected resource refers
78 // to a Tab or other window containing web contents. Returns NULL by
79 // default because not all resources have an associated web contents.
80 virtual content::WebContents
* GetWebContents() const;
82 // Whether this resource does report the network usage accurately.
83 // This controls whether 0 or N/A is displayed when no bytes have been
84 // reported as being read. This is because some plugins do not report the
85 // bytes read and we don't want to display a misleading 0 value in that
87 virtual bool SupportNetworkUsage() const = 0;
89 // Called when some bytes have been read and support_network_usage returns
90 // false (meaning we do have network usage support).
91 virtual void SetSupportNetworkUsage() = 0;
93 // The TaskManagerModel periodically refreshes its data and call this
94 // on all live resources.
95 virtual void Refresh() {}
97 static const char* GetResourceTypeAsString(const Type type
) {
99 TASKMANAGER_RESOURCE_TYPE_LIST(TASKMANAGER_RESOURCE_TYPE_LIST_AS_STRING
)
100 default: return "UNKNOWN";
108 DISALLOW_COPY_AND_ASSIGN(Resource
);
111 #undef TASKMANAGER_RESOURCE_TYPE_LIST
112 #undef TASKMANAGER_RESOURCE_TYPE_LIST_ENUM
113 #undef TASKMANAGER_RESOURCE_TYPE_LIST_AS_STRING
115 // ResourceProviders are responsible for adding/removing resources to the task
116 // manager. The task manager notifies the ResourceProvider that it is ready
117 // to receive resource creation/termination notifications with a call to
118 // StartUpdating(). At that point, the resource provider should call
119 // AddResource with all the existing resources, and after that it should call
120 // AddResource/RemoveResource as resources are created/terminated.
121 // The provider remains the owner of the resource objects and is responsible
122 // for deleting them (when StopUpdating() is called).
123 // After StopUpdating() is called the provider should also stop reporting
124 // notifications to the task manager.
125 // Note: ResourceProviders have to be ref counted as they are used in
126 // MessageLoop::InvokeLater().
127 class ResourceProvider
: public base::RefCountedThreadSafe
<ResourceProvider
> {
129 // Should return the resource associated to the specified ids, or NULL if
130 // the resource does not belong to this provider.
131 virtual Resource
* GetResource(int origin_pid
,
134 virtual void StartUpdating() = 0;
135 virtual void StopUpdating() = 0;
138 friend class base::RefCountedThreadSafe
<ResourceProvider
>;
140 virtual ~ResourceProvider() {}
143 } // namespace task_manager
145 #endif // CHROME_BROWSER_TASK_MANAGER_RESOURCE_PROVIDER_H_