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_COMMON_PEPPER_PLUGIN_REGISTRY_H_ | 5 #ifndef CONTENT_COMMON_PEPPER_PLUGIN_REGISTRY_H_ |
6 #define CONTENT_COMMON_PEPPER_PLUGIN_REGISTRY_H_ | 6 #define CONTENT_COMMON_PEPPER_PLUGIN_REGISTRY_H_ |
7 #pragma once | 7 #pragma once |
8 | 8 |
9 #include <list> | 9 #include "base/memory/singleton.h" |
10 #include <map> | |
11 #include <string> | |
12 #include <vector> | |
13 | |
14 #include "base/file_path.h" | |
15 #include "content/common/content_export.h" | 10 #include "content/common/content_export.h" |
16 #include "webkit/plugins/ppapi/plugin_delegate.h" | 11 #include "webkit/plugins/ppapi/plugin_delegate.h" |
17 #include "webkit/plugins/ppapi/plugin_module.h" | 12 #include "webkit/plugins/ppapi/ppapi_plugin_list.h" |
18 #include "webkit/plugins/webplugininfo.h" | |
19 | 13 |
20 struct CONTENT_EXPORT PepperPluginInfo { | 14 // Static helper class to manage webkit::ppapi::PluginList. |
21 PepperPluginInfo(); | |
22 ~PepperPluginInfo(); | |
23 | |
24 webkit::WebPluginInfo ToWebPluginInfo() const; | |
25 | |
26 // Indicates internal plugins for which there's not actually a library. | |
27 // These plugins are implemented in the Chrome binary using a separate set | |
28 // of entry points (see internal_entry_points below). | |
29 // Defaults to false. | |
30 bool is_internal; | |
31 | |
32 // True when this plugin should be run out of process. Defaults to false. | |
33 bool is_out_of_process; | |
34 | |
35 FilePath path; // Internal plugins have "internal-[name]" as path. | |
36 std::string name; | |
37 std::string description; | |
38 std::string version; | |
39 std::vector<webkit::WebPluginMimeType> mime_types; | |
40 | |
41 // When is_internal is set, this contains the function pointers to the | |
42 // entry points for the internal plugins. | |
43 webkit::ppapi::PluginModule::EntryPoints internal_entry_points; | |
44 }; | |
45 | |
46 // Constructs a PepperPluginInfo from a WebPluginInfo. Returns false if | |
47 // the operation is not possible, in particular the WebPluginInfo::type | |
48 // must be one of the pepper types. | |
49 bool MakePepperPluginInfo(const webkit::WebPluginInfo& webplugin_info, | |
50 PepperPluginInfo* pepper_info); | |
51 | |
52 // This class holds references to all of the known pepper plugin modules. | |
53 // | |
54 // It keeps two lists. One list of preloaded in-process modules, and one list | |
55 // is a list of all live modules (some of which may be out-of-process and hence | |
56 // not preloaded). | |
57 class PepperPluginRegistry | 15 class PepperPluginRegistry |
58 : public webkit::ppapi::PluginDelegate::ModuleLifetime { | 16 : public webkit::ppapi::PluginDelegate::ModuleLifetime { |
59 public: | 17 public: |
60 ~PepperPluginRegistry(); | |
61 | |
62 static PepperPluginRegistry* GetInstance(); | |
63 | |
64 // Computes the list of known pepper plugins. | 18 // Computes the list of known pepper plugins. |
65 // | 19 // |
66 // This method is static so that it can be used by the browser process, which | 20 // This method is static so that it can be used by the browser process, which |
67 // has no need to load the pepper plugin modules. It will re-compute the | 21 // has no need to load the pepper plugin modules. It will re-compute the |
68 // plugin list every time it is called. Generally, code in the registry should | 22 // plugin list every time it is called. Generally, code in the registry should |
69 // be using the cached plugin_list_ instead. | 23 // be using the cached plugin_list_ instead. |
70 CONTENT_EXPORT static void ComputeList( | 24 CONTENT_EXPORT static void ComputeList( |
71 std::vector<PepperPluginInfo>* plugins); | 25 webkit::ppapi::PluginList* plugin_list); |
72 | 26 |
73 // Loads the (native) libraries but does not initialize them (i.e., does not | 27 // Loads the (native) libraries but does not initialize them (i.e., does not |
74 // call PPP_InitializeModule). This is needed by the zygote on Linux to get | 28 // call PPP_InitializeModule). This is needed by the zygote on Linux to get |
75 // access to the plugins before entering the sandbox. | 29 // access to the plugins before entering the sandbox. |
76 static void PreloadModules(); | 30 static void PreloadModules(); |
77 | 31 |
| 32 static PepperPluginRegistry* GetInstance(); |
| 33 |
78 // Retrieves the information associated with the given plugin info. The | 34 // Retrieves the information associated with the given plugin info. The |
79 // return value will be NULL if there is no such plugin. | 35 // return value will be NULL if there is no such plugin. |
80 // | 36 // |
81 // The returned pointer is owned by the PluginRegistry. | 37 // The returned pointer is owned by the PluginRegistry. |
82 const PepperPluginInfo* GetInfoForPlugin( | 38 const webkit::ppapi::PluginInfo* GetInfoForPlugin( |
83 const webkit::WebPluginInfo& info); | 39 const FilePath& plugin_path); |
84 | 40 |
85 // Returns an existing loaded module for the given path. It will search for | 41 // Returns an existing loaded module for the given path. It will search for |
86 // both preloaded in-process or currently active (non crashed) out-of-process | 42 // both preloaded in-process or currently active (non crashed) out-of-process |
87 // plugins matching the given name. Returns NULL if the plugin hasn't been | 43 // plugins matching the given name. Returns NULL if the plugin hasn't been |
88 // loaded. | 44 // loaded. |
89 webkit::ppapi::PluginModule* GetLiveModule(const FilePath& path); | 45 webkit::ppapi::PluginModule* GetLiveModule(const FilePath& path); |
90 | 46 |
91 // Notifies the registry that a new non-preloaded module has been created. | 47 // Notifies the registry that a new non-preloaded module has been created. |
92 // This is normally called for out-of-process plugins. Once this is called, | 48 // This is normally called for out-of-process plugins. Once this is called, |
93 // the module is available to be returned by GetModule(). The module will | 49 // the module is available to be returned by GetModule(). The module will |
94 // automatically unregister itself by calling PluginModuleDestroyed(). | 50 // automatically unregister itself by calling PluginModuleDestroyed(). |
95 void AddLiveModule(const FilePath& path, webkit::ppapi::PluginModule* module); | 51 void AddLiveModule(const FilePath& path, webkit::ppapi::PluginModule* module); |
96 | 52 |
97 // ModuleLifetime implementation. | 53 // ModuleLifetime implementation. |
98 virtual void PluginModuleDead(webkit::ppapi::PluginModule* dead_module); | 54 virtual void PluginModuleDead(webkit::ppapi::PluginModule* dead_module); |
99 | 55 |
100 private: | 56 private: |
101 PepperPluginRegistry(); | 57 PepperPluginRegistry(); |
102 | 58 ~PepperPluginRegistry(); |
103 // All known pepper plugins. | 59 friend struct DefaultSingletonTraits<PepperPluginRegistry>; |
104 std::vector<PepperPluginInfo> plugin_list_; | |
105 | |
106 // Plugins that have been preloaded so they can be executed in-process in | |
107 // the renderer (the sandbox prevents on-demand loading). | |
108 typedef std::map<FilePath, scoped_refptr<webkit::ppapi::PluginModule> > | |
109 OwningModuleMap; | |
110 OwningModuleMap preloaded_modules_; | |
111 | |
112 // A list of non-owning pointers to all currently-live plugin modules. This | |
113 // includes both preloaded ones in preloaded_modules_, and out-of-process | |
114 // modules whose lifetime is managed externally. This will contain only | |
115 // non-crashed modules. If an out-of-process module crashes, it may | |
116 // continue as long as there are WebKit references to it, but it will not | |
117 // appear in this list. | |
118 typedef std::map<FilePath, webkit::ppapi::PluginModule*> NonOwningModuleMap; | |
119 NonOwningModuleMap live_modules_; | |
120 | |
121 DISALLOW_COPY_AND_ASSIGN(PepperPluginRegistry); | |
122 }; | 60 }; |
123 | 61 |
124 #endif // CONTENT_COMMON_PEPPER_PLUGIN_REGISTRY_H_ | 62 #endif // CONTENT_COMMON_PEPPER_PLUGIN_REGISTRY_H_ |
OLD | NEW |