• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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_BROWSER_GPU_GPU_PROCESS_HOST_H_
6 #define CONTENT_BROWSER_GPU_GPU_PROCESS_HOST_H_
7 
8 #include <map>
9 #include <queue>
10 #include <set>
11 #include <string>
12 
13 #include "base/callback.h"
14 #include "base/containers/hash_tables.h"
15 #include "base/memory/weak_ptr.h"
16 #include "base/threading/non_thread_safe.h"
17 #include "base/time/time.h"
18 #include "content/browser/gpu/gpu_surface_tracker.h"
19 #include "content/common/content_export.h"
20 #include "content/common/gpu/gpu_memory_uma_stats.h"
21 #include "content/common/gpu/gpu_process_launch_causes.h"
22 #include "content/common/gpu/gpu_result_codes.h"
23 #include "content/public/browser/browser_child_process_host_delegate.h"
24 #include "content/public/browser/gpu_data_manager.h"
25 #include "gpu/command_buffer/common/constants.h"
26 #include "gpu/config/gpu_info.h"
27 #include "ipc/ipc_sender.h"
28 #include "ipc/message_filter.h"
29 #include "ui/gfx/native_widget_types.h"
30 #include "ui/gfx/size.h"
31 #include "url/gurl.h"
32 
33 struct GPUCreateCommandBufferConfig;
34 struct GpuHostMsg_AcceleratedSurfaceBuffersSwapped_Params;
35 struct GpuHostMsg_AcceleratedSurfacePostSubBuffer_Params;
36 struct GpuHostMsg_AcceleratedSurfaceRelease_Params;
37 
38 namespace gfx {
39 struct GpuMemoryBufferHandle;
40 }
41 
42 namespace IPC {
43 struct ChannelHandle;
44 }
45 
46 namespace content {
47 class BrowserChildProcessHostImpl;
48 class GpuMainThread;
49 class RenderWidgetHostViewFrameSubscriber;
50 class ShaderDiskCache;
51 
52 typedef base::Thread* (*GpuMainThreadFactoryFunction)(const std::string& id);
53 
54 class GpuProcessHost : public BrowserChildProcessHostDelegate,
55                        public IPC::Sender,
56                        public base::NonThreadSafe {
57  public:
58   enum GpuProcessKind {
59     GPU_PROCESS_KIND_UNSANDBOXED,
60     GPU_PROCESS_KIND_SANDBOXED,
61     GPU_PROCESS_KIND_COUNT
62   };
63 
64   typedef base::Callback<void(const IPC::ChannelHandle&, const gpu::GPUInfo&)>
65       EstablishChannelCallback;
66 
67   typedef base::Callback<void(CreateCommandBufferResult)>
68       CreateCommandBufferCallback;
69 
70   typedef base::Callback<void(const gfx::Size)> CreateImageCallback;
71 
72   typedef base::Callback<void(const gfx::GpuMemoryBufferHandle& handle)>
73       CreateGpuMemoryBufferCallback;
74 
gpu_enabled()75   static bool gpu_enabled() { return gpu_enabled_; }
76 
77   // Creates a new GpuProcessHost or gets an existing one, resulting in the
78   // launching of a GPU process if required.  Returns null on failure. It
79   // is not safe to store the pointer once control has returned to the message
80   // loop as it can be destroyed. Instead store the associated GPU host ID.
81   // This could return NULL if GPU access is not allowed (blacklisted).
82   CONTENT_EXPORT static GpuProcessHost* Get(GpuProcessKind kind,
83                                             CauseForGpuLaunch cause);
84 
85   // Retrieves a list of process handles for all gpu processes.
86   static void GetProcessHandles(
87       const GpuDataManager::GetGpuProcessHandlesCallback& callback);
88 
89   // Helper function to send the given message to the GPU process on the IO
90   // thread.  Calls Get and if a host is returned, sends it.  Can be called from
91   // any thread.  Deletes the message if it cannot be sent.
92   CONTENT_EXPORT static void SendOnIO(GpuProcessKind kind,
93                                       CauseForGpuLaunch cause,
94                                       IPC::Message* message);
95 
96   CONTENT_EXPORT static void RegisterGpuMainThreadFactory(
97       GpuMainThreadFactoryFunction create);
98 
99   // Get the GPU process host for the GPU process with the given ID. Returns
100   // null if the process no longer exists.
101   static GpuProcessHost* FromID(int host_id);
host_id()102   int host_id() const { return host_id_; }
103 
104   // IPC::Sender implementation.
105   virtual bool Send(IPC::Message* msg) OVERRIDE;
106 
107   // Adds a message filter to the GpuProcessHost's channel.
108   void AddFilter(IPC::MessageFilter* filter);
109 
110   // Tells the GPU process to create a new channel for communication with a
111   // client. Once the GPU process responds asynchronously with the IPC handle
112   // and GPUInfo, we call the callback.
113   void EstablishGpuChannel(int client_id,
114                            bool share_context,
115                            const EstablishChannelCallback& callback);
116 
117   // Tells the GPU process to create a new command buffer that draws into the
118   // given surface.
119   void CreateViewCommandBuffer(
120       const gfx::GLSurfaceHandle& compositing_surface,
121       int surface_id,
122       int client_id,
123       const GPUCreateCommandBufferConfig& init_params,
124       int route_id,
125       const CreateCommandBufferCallback& callback);
126 
127   // Tells the GPU process to create a new image using the given window.
128   void CreateImage(
129       gfx::PluginWindowHandle window,
130       int client_id,
131       int image_id,
132       const CreateImageCallback& callback);
133 
134     // Tells the GPU process to delete image.
135   void DeleteImage(int client_id, int image_id, int sync_point);
136 
137   void CreateGpuMemoryBuffer(const gfx::GpuMemoryBufferHandle& handle,
138                              const gfx::Size& size,
139                              unsigned internalformat,
140                              unsigned usage,
141                              const CreateGpuMemoryBufferCallback& callback);
142   void DestroyGpuMemoryBuffer(const gfx::GpuMemoryBufferHandle& handle,
143                               int sync_point);
144 
145   // What kind of GPU process, e.g. sandboxed or unsandboxed.
146   GpuProcessKind kind();
147 
148   void ForceShutdown();
149 
150   void BeginFrameSubscription(
151       int surface_id,
152       base::WeakPtr<RenderWidgetHostViewFrameSubscriber> subscriber);
153   void EndFrameSubscription(int surface_id);
154   void LoadedShader(const std::string& key, const std::string& data);
155 
156  private:
157   static bool ValidateHost(GpuProcessHost* host);
158 
159   GpuProcessHost(int host_id, GpuProcessKind kind);
160   virtual ~GpuProcessHost();
161 
162   bool Init();
163 
164   // Post an IPC message to the UI shim's message handler on the UI thread.
165   void RouteOnUIThread(const IPC::Message& message);
166 
167   // BrowserChildProcessHostDelegate implementation.
168   virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
169   virtual void OnChannelConnected(int32 peer_pid) OVERRIDE;
170   virtual void OnProcessLaunched() OVERRIDE;
171   virtual void OnProcessCrashed(int exit_code) OVERRIDE;
172 
173   // Message handlers.
174   void OnInitialized(bool result, const gpu::GPUInfo& gpu_info);
175   void OnChannelEstablished(const IPC::ChannelHandle& channel_handle);
176   void OnCommandBufferCreated(CreateCommandBufferResult result);
177   void OnDestroyCommandBuffer(int32 surface_id);
178   void OnImageCreated(const gfx::Size size);
179   void OnGpuMemoryBufferCreated(const gfx::GpuMemoryBufferHandle& handle);
180   void OnDidCreateOffscreenContext(const GURL& url);
181   void OnDidLoseContext(bool offscreen,
182                         gpu::error::ContextLostReason reason,
183                         const GURL& url);
184   void OnDidDestroyOffscreenContext(const GURL& url);
185   void OnGpuMemoryUmaStatsReceived(const GPUMemoryUmaStats& stats);
186 #if defined(OS_MACOSX)
187   void OnAcceleratedSurfaceBuffersSwapped(
188       const GpuHostMsg_AcceleratedSurfaceBuffersSwapped_Params& params);
189 #endif
190 
191   void CreateChannelCache(int32 client_id);
192   void OnDestroyChannel(int32 client_id);
193   void OnCacheShader(int32 client_id, const std::string& key,
194                      const std::string& shader);
195 
196   bool LaunchGpuProcess(const std::string& channel_id);
197 
198   void SendOutstandingReplies();
199 
200   void BlockLiveOffscreenContexts();
201 
202   std::string GetShaderPrefixKey();
203 
204   // The serial number of the GpuProcessHost / GpuProcessHostUIShim pair.
205   int host_id_;
206 
207   // These are the channel requests that we have already sent to
208   // the GPU process, but haven't heard back about yet.
209   std::queue<EstablishChannelCallback> channel_requests_;
210 
211   // The pending create command buffer requests we need to reply to.
212   std::queue<CreateCommandBufferCallback> create_command_buffer_requests_;
213 
214   // The pending create image requests we need to reply to.
215   std::queue<CreateImageCallback> create_image_requests_;
216 
217   // The pending create gpu memory buffer requests we need to reply to.
218   std::queue<CreateGpuMemoryBufferCallback> create_gpu_memory_buffer_requests_;
219 
220   // Qeueud messages to send when the process launches.
221   std::queue<IPC::Message*> queued_messages_;
222 
223   // Whether the GPU process is valid, set to false after Send() failed.
224   bool valid_;
225 
226   // Whether we are running a GPU thread inside the browser process instead
227   // of a separate GPU process.
228   bool in_process_;
229 
230   bool swiftshader_rendering_;
231   GpuProcessKind kind_;
232 
233   scoped_ptr<base::Thread> in_process_gpu_thread_;
234 
235   // Whether we actually launched a GPU process.
236   bool process_launched_;
237 
238   // Whether the GPU process successfully initialized.
239   bool initialized_;
240 
241   // Time Init started.  Used to log total GPU process startup time to UMA.
242   base::TimeTicks init_start_time_;
243 
244   // Master switch for enabling/disabling GPU acceleration for the current
245   // browser session. It does not change the acceleration settings for
246   // existing tabs, just the future ones.
247   static bool gpu_enabled_;
248 
249   static bool hardware_gpu_enabled_;
250 
251   scoped_ptr<BrowserChildProcessHostImpl> process_;
252 
253   // Track the URLs of the pages which have live offscreen contexts,
254   // assumed to be associated with untrusted content such as WebGL.
255   // For best robustness, when any context lost notification is
256   // received, assume all of these URLs are guilty, and block
257   // automatic execution of 3D content from those domains.
258   std::multiset<GURL> urls_with_live_offscreen_contexts_;
259 
260   // Statics kept around to send to UMA histograms on GPU process lost.
261   bool uma_memory_stats_received_;
262   GPUMemoryUmaStats uma_memory_stats_;
263 
264   // This map of frame subscribers are listening for frame presentation events.
265   // The key is the surface id and value is the subscriber.
266   typedef base::hash_map<int,
267                          base::WeakPtr<RenderWidgetHostViewFrameSubscriber> >
268   FrameSubscriberMap;
269   FrameSubscriberMap frame_subscribers_;
270 
271   typedef std::map<int32, scoped_refptr<ShaderDiskCache> >
272       ClientIdToShaderCacheMap;
273   ClientIdToShaderCacheMap client_id_to_shader_cache_;
274 
275   std::string shader_prefix_key_;
276 
277   // Keep an extra reference to the SurfaceRef stored in the GpuSurfaceTracker
278   // in this map so that we don't destroy it whilst the GPU process is
279   // drawing to it.
280   typedef std::multimap<int, scoped_refptr<GpuSurfaceTracker::SurfaceRef> >
281       SurfaceRefMap;
282   SurfaceRefMap surface_refs_;
283 
284   DISALLOW_COPY_AND_ASSIGN(GpuProcessHost);
285 };
286 
287 }  // namespace content
288 
289 #endif  // CONTENT_BROWSER_GPU_GPU_PROCESS_HOST_H_
290