| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 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_PLUGIN_LIST_H_ | 5 #ifndef CONTENT_COMMON_PLUGIN_LIST_H_ |
| 6 #define CONTENT_COMMON_PLUGIN_LIST_H_ | 6 #define CONTENT_COMMON_PLUGIN_LIST_H_ |
| 7 | 7 |
| 8 #include <set> | 8 #include <set> |
| 9 #include <string> | 9 #include <string> |
| 10 #include <utility> | 10 #include <utility> |
| 11 #include <vector> | 11 #include <vector> |
| 12 | 12 |
| 13 #include "base/basictypes.h" | 13 #include "base/basictypes.h" |
| 14 #include "base/callback.h" | 14 #include "base/callback.h" |
| 15 #include "base/files/file_path.h" | 15 #include "base/files/file_path.h" |
| 16 #include "base/lazy_instance.h" | 16 #include "base/lazy_instance.h" |
| 17 #include "base/memory/linked_ptr.h" | 17 #include "base/memory/linked_ptr.h" |
| 18 #include "base/memory/scoped_vector.h" | 18 #include "base/memory/scoped_vector.h" |
| 19 #include "base/synchronization/lock.h" | 19 #include "base/synchronization/lock.h" |
| 20 #include "content/common/content_export.h" | 20 #include "content/common/content_export.h" |
| 21 #include "webkit/plugins/webplugininfo.h" | 21 #include "content/public/common/webplugininfo.h" |
| 22 | 22 |
| 23 class GURL; | 23 class GURL; |
| 24 | 24 |
| 25 namespace content { | 25 namespace content { |
| 26 | 26 |
| 27 // The PluginList is responsible for loading our NPAPI based plugins. It does | 27 // The PluginList is responsible for loading our NPAPI based plugins. It does |
| 28 // so in whatever manner is appropriate for the platform. On Windows, it loads | 28 // so in whatever manner is appropriate for the platform. On Windows, it loads |
| 29 // plugins from a known directory by looking for DLLs which start with "NP", | 29 // plugins from a known directory by looking for DLLs which start with "NP", |
| 30 // and checking to see if they are valid NPAPI libraries. On the Mac, it walks | 30 // and checking to see if they are valid NPAPI libraries. On the Mac, it walks |
| 31 // the machine-wide and user plugin directories and loads anything that has | 31 // the machine-wide and user plugin directories and loads anything that has |
| 32 // the correct types. On Linux, it walks the plugin directories as well | 32 // the correct types. On Linux, it walks the plugin directories as well |
| 33 // (e.g. /usr/lib/browser-plugins/). | 33 // (e.g. /usr/lib/browser-plugins/). |
| 34 // This object is thread safe. | 34 // This object is thread safe. |
| 35 class CONTENT_EXPORT PluginList { | 35 class CONTENT_EXPORT PluginList { |
| 36 public: | 36 public: |
| 37 | 37 |
| 38 // Gets the one instance of the PluginList. | 38 // Gets the one instance of the PluginList. |
| 39 static PluginList* Singleton(); | 39 static PluginList* Singleton(); |
| 40 | 40 |
| 41 // Returns true if we're in debug-plugin-loading mode. This is controlled | 41 // Returns true if we're in debug-plugin-loading mode. This is controlled |
| 42 // by a command line switch. | 42 // by a command line switch. |
| 43 static bool DebugPluginLoading(); | 43 static bool DebugPluginLoading(); |
| 44 | 44 |
| 45 // Returns true if the plugin supports |mime_type|. |mime_type| should be all | 45 // Returns true if the plugin supports |mime_type|. |mime_type| should be all |
| 46 // lower case. | 46 // lower case. |
| 47 static bool SupportsType(const webkit::WebPluginInfo& plugin, | 47 static bool SupportsType(const WebPluginInfo& plugin, |
| 48 const std::string& mime_type, | 48 const std::string& mime_type, |
| 49 bool allow_wildcard); | 49 bool allow_wildcard); |
| 50 | 50 |
| 51 // Disables discovery of third_party plugins in standard places next time | 51 // Disables discovery of third_party plugins in standard places next time |
| 52 // plugins are loaded. | 52 // plugins are loaded. |
| 53 void DisablePluginsDiscovery(); | 53 void DisablePluginsDiscovery(); |
| 54 | 54 |
| 55 // Cause the plugin list to refresh next time they are accessed, regardless | 55 // Cause the plugin list to refresh next time they are accessed, regardless |
| 56 // of whether they are already loaded. | 56 // of whether they are already loaded. |
| 57 void RefreshPlugins(); | 57 void RefreshPlugins(); |
| 58 | 58 |
| 59 // Add/Remove an extra plugin to load when we actually do the loading. Must | 59 // Add/Remove an extra plugin to load when we actually do the loading. Must |
| 60 // be called before the plugins have been loaded. | 60 // be called before the plugins have been loaded. |
| 61 void AddExtraPluginPath(const base::FilePath& plugin_path); | 61 void AddExtraPluginPath(const base::FilePath& plugin_path); |
| 62 void RemoveExtraPluginPath(const base::FilePath& plugin_path); | 62 void RemoveExtraPluginPath(const base::FilePath& plugin_path); |
| 63 | 63 |
| 64 // Same as above, but specifies a directory in which to search for plugins. | 64 // Same as above, but specifies a directory in which to search for plugins. |
| 65 void AddExtraPluginDir(const base::FilePath& plugin_dir); | 65 void AddExtraPluginDir(const base::FilePath& plugin_dir); |
| 66 | 66 |
| 67 // Get the ordered list of directories from which to load plugins | 67 // Get the ordered list of directories from which to load plugins |
| 68 void GetPluginDirectories(std::vector<base::FilePath>* plugin_dirs); | 68 void GetPluginDirectories(std::vector<base::FilePath>* plugin_dirs); |
| 69 | 69 |
| 70 // Register an internal plugin with the specified plugin information. | 70 // Register an internal plugin with the specified plugin information. |
| 71 // An internal plugin must be registered before it can | 71 // An internal plugin must be registered before it can |
| 72 // be loaded using PluginList::LoadPlugin(). | 72 // be loaded using PluginList::LoadPlugin(). |
| 73 // If |add_at_beginning| is true the plugin will be added earlier in | 73 // If |add_at_beginning| is true the plugin will be added earlier in |
| 74 // the list so that it can override the MIME types of older registrations. | 74 // the list so that it can override the MIME types of older registrations. |
| 75 void RegisterInternalPlugin(const webkit::WebPluginInfo& info, | 75 void RegisterInternalPlugin(const WebPluginInfo& info, |
| 76 bool add_at_beginning); | 76 bool add_at_beginning); |
| 77 | 77 |
| 78 // Removes a specified internal plugin from the list. The search will match | 78 // Removes a specified internal plugin from the list. The search will match |
| 79 // on the path from the version info previously registered. | 79 // on the path from the version info previously registered. |
| 80 void UnregisterInternalPlugin(const base::FilePath& path); | 80 void UnregisterInternalPlugin(const base::FilePath& path); |
| 81 | 81 |
| 82 // Gets a list of all the registered internal plugins. | 82 // Gets a list of all the registered internal plugins. |
| 83 void GetInternalPlugins(std::vector<webkit::WebPluginInfo>* plugins); | 83 void GetInternalPlugins(std::vector<WebPluginInfo>* plugins); |
| 84 | 84 |
| 85 // Creates a WebPluginInfo structure given a plugin's path. On success | 85 // Creates a WebPluginInfo structure given a plugin's path. On success |
| 86 // returns true, with the information being put into "info". | 86 // returns true, with the information being put into "info". |
| 87 // Returns false if the library couldn't be found, or if it's not a plugin. | 87 // Returns false if the library couldn't be found, or if it's not a plugin. |
| 88 bool ReadPluginInfo(const base::FilePath& filename, | 88 bool ReadPluginInfo(const base::FilePath& filename, |
| 89 webkit::WebPluginInfo* info); | 89 WebPluginInfo* info); |
| 90 | 90 |
| 91 // In Windows plugins, the mime types are passed as a specially formatted list | 91 // In Windows plugins, the mime types are passed as a specially formatted list |
| 92 // of strings. This function parses those strings into a WebPluginMimeType | 92 // of strings. This function parses those strings into a WebPluginMimeType |
| 93 // vector. | 93 // vector. |
| 94 // TODO(evan): move this code into plugin_list_win. | 94 // TODO(evan): move this code into plugin_list_win. |
| 95 static bool ParseMimeTypes( | 95 static bool ParseMimeTypes( |
| 96 const std::string& mime_types, | 96 const std::string& mime_types, |
| 97 const std::string& file_extensions, | 97 const std::string& file_extensions, |
| 98 const base::string16& mime_type_descriptions, | 98 const base::string16& mime_type_descriptions, |
| 99 std::vector<webkit::WebPluginMimeType>* parsed_mime_types); | 99 std::vector<WebPluginMimeType>* parsed_mime_types); |
| 100 | 100 |
| 101 // Get all the plugins synchronously, loading them if necessary. | 101 // Get all the plugins synchronously, loading them if necessary. |
| 102 void GetPlugins(std::vector<webkit::WebPluginInfo>* plugins, | 102 void GetPlugins(std::vector<WebPluginInfo>* plugins, |
| 103 bool include_npapi); | 103 bool include_npapi); |
| 104 | 104 |
| 105 // Copies the list of plug-ins into |plugins| without loading them. | 105 // Copies the list of plug-ins into |plugins| without loading them. |
| 106 // Returns true if the list of plugins is up-to-date. | 106 // Returns true if the list of plugins is up-to-date. |
| 107 bool GetPluginsNoRefresh( | 107 bool GetPluginsNoRefresh(std::vector<WebPluginInfo>* plugins); |
| 108 std::vector<webkit::WebPluginInfo>* plugins); | |
| 109 | 108 |
| 110 // Returns a list in |info| containing plugins that are found for | 109 // Returns a list in |info| containing plugins that are found for |
| 111 // the given url and mime type (including disabled plugins, for | 110 // the given url and mime type (including disabled plugins, for |
| 112 // which |info->enabled| is false). The mime type which corresponds | 111 // which |info->enabled| is false). The mime type which corresponds |
| 113 // to the URL is optionally returned back in |actual_mime_types| (if | 112 // to the URL is optionally returned back in |actual_mime_types| (if |
| 114 // it is non-NULL), one for each of the plugin info objects found. | 113 // it is non-NULL), one for each of the plugin info objects found. |
| 115 // The |allow_wildcard| parameter controls whether this function | 114 // The |allow_wildcard| parameter controls whether this function |
| 116 // returns plugins which support wildcard mime types (* as the mime | 115 // returns plugins which support wildcard mime types (* as the mime |
| 117 // type). The |info| parameter is required to be non-NULL. The | 116 // type). The |info| parameter is required to be non-NULL. The |
| 118 // list is in order of "most desirable" to "least desirable". | 117 // list is in order of "most desirable" to "least desirable". |
| 119 // If |use_stale| is NULL, this will load the plug-in list if necessary. | 118 // If |use_stale| is NULL, this will load the plug-in list if necessary. |
| 120 // If it is not NULL, the plug-in list will not be loaded, and |*use_stale| | 119 // If it is not NULL, the plug-in list will not be loaded, and |*use_stale| |
| 121 // will be true iff the plug-in list was stale. | 120 // will be true iff the plug-in list was stale. |
| 122 void GetPluginInfoArray(const GURL& url, | 121 void GetPluginInfoArray(const GURL& url, |
| 123 const std::string& mime_type, | 122 const std::string& mime_type, |
| 124 bool allow_wildcard, | 123 bool allow_wildcard, |
| 125 bool* use_stale, | 124 bool* use_stale, |
| 126 bool include_npapi, | 125 bool include_npapi, |
| 127 std::vector<webkit::WebPluginInfo>* info, | 126 std::vector<WebPluginInfo>* info, |
| 128 std::vector<std::string>* actual_mime_types); | 127 std::vector<std::string>* actual_mime_types); |
| 129 | 128 |
| 130 // Load a specific plugin with full path. Return true iff loading the plug-in | 129 // Load a specific plugin with full path. Return true iff loading the plug-in |
| 131 // was successful. | 130 // was successful. |
| 132 bool LoadPluginIntoPluginList(const base::FilePath& filename, | 131 bool LoadPluginIntoPluginList(const base::FilePath& filename, |
| 133 std::vector<webkit::WebPluginInfo>* plugins, | 132 std::vector<WebPluginInfo>* plugins, |
| 134 webkit::WebPluginInfo* plugin_info); | 133 WebPluginInfo* plugin_info); |
| 135 | 134 |
| 136 // The following functions are used to support probing for WebPluginInfo | 135 // The following functions are used to support probing for WebPluginInfo |
| 137 // using a different instance of this class. | 136 // using a different instance of this class. |
| 138 | 137 |
| 139 // Computes a list of all plugins to potentially load from all sources. | 138 // Computes a list of all plugins to potentially load from all sources. |
| 140 void GetPluginPathsToLoad(std::vector<base::FilePath>* plugin_paths, | 139 void GetPluginPathsToLoad(std::vector<base::FilePath>* plugin_paths, |
| 141 bool include_npapi); | 140 bool include_npapi); |
| 142 | 141 |
| 143 // Clears the internal list of Plugins and copies them from the vector. | 142 // Clears the internal list of Plugins and copies them from the vector. |
| 144 void SetPlugins(const std::vector<webkit::WebPluginInfo>& plugins); | 143 void SetPlugins(const std::vector<WebPluginInfo>& plugins); |
| 145 | 144 |
| 146 void set_will_load_plugins_callback(const base::Closure& callback); | 145 void set_will_load_plugins_callback(const base::Closure& callback); |
| 147 | 146 |
| 148 virtual ~PluginList(); | 147 virtual ~PluginList(); |
| 149 | 148 |
| 150 // Creates a WebPluginInfo structure given a plugin's path. On success | 149 // Creates a WebPluginInfo structure given a plugin's path. On success |
| 151 // returns true, with the information being put into "info". | 150 // returns true, with the information being put into "info". |
| 152 // Returns false if the library couldn't be found, or if it's not a plugin. | 151 // Returns false if the library couldn't be found, or if it's not a plugin. |
| 153 static bool ReadWebPluginInfo(const base::FilePath& filename, | 152 static bool ReadWebPluginInfo(const base::FilePath& filename, |
| 154 webkit::WebPluginInfo* info); | 153 WebPluginInfo* info); |
| 155 | 154 |
| 156 #if defined(OS_POSIX) && !defined(OS_MACOSX) | 155 #if defined(OS_POSIX) && !defined(OS_MACOSX) |
| 157 // Parse the result of an NP_GetMIMEDescription() call. | 156 // Parse the result of an NP_GetMIMEDescription() call. |
| 158 // This API is only used on Unixes, and is exposed here for testing. | 157 // This API is only used on Unixes, and is exposed here for testing. |
| 159 static void ParseMIMEDescription(const std::string& description, | 158 static void ParseMIMEDescription(const std::string& description, |
| 160 std::vector<webkit::WebPluginMimeType>* mime_types); | 159 std::vector<WebPluginMimeType>* mime_types); |
| 161 | 160 |
| 162 // Extract a version number from a description string. | 161 // Extract a version number from a description string. |
| 163 // This API is only used on Unixes, and is exposed here for testing. | 162 // This API is only used on Unixes, and is exposed here for testing. |
| 164 static void ExtractVersionString(const std::string& version, | 163 static void ExtractVersionString(const std::string& version, |
| 165 webkit::WebPluginInfo* info); | 164 WebPluginInfo* info); |
| 166 #endif | 165 #endif |
| 167 | 166 |
| 168 private: | 167 private: |
| 169 enum LoadingState { | 168 enum LoadingState { |
| 170 LOADING_STATE_NEEDS_REFRESH, | 169 LOADING_STATE_NEEDS_REFRESH, |
| 171 LOADING_STATE_REFRESHING, | 170 LOADING_STATE_REFRESHING, |
| 172 LOADING_STATE_UP_TO_DATE, | 171 LOADING_STATE_UP_TO_DATE, |
| 173 }; | 172 }; |
| 174 | 173 |
| 175 friend class PluginListTest; | 174 friend class PluginListTest; |
| 176 friend struct base::DefaultLazyInstanceTraits<PluginList>; | 175 friend struct base::DefaultLazyInstanceTraits<PluginList>; |
| 177 | 176 |
| 178 PluginList(); | 177 PluginList(); |
| 179 | 178 |
| 180 // Load all plugins from the default plugins directory. | 179 // Load all plugins from the default plugins directory. |
| 181 void LoadPlugins(bool include_npapi); | 180 void LoadPlugins(bool include_npapi); |
| 182 | 181 |
| 183 // Walks a directory and produces a list of all the plugins to potentially | 182 // Walks a directory and produces a list of all the plugins to potentially |
| 184 // load in that directory. | 183 // load in that directory. |
| 185 void GetPluginsInDir(const base::FilePath& path, | 184 void GetPluginsInDir(const base::FilePath& path, |
| 186 std::vector<base::FilePath>* plugins); | 185 std::vector<base::FilePath>* plugins); |
| 187 | 186 |
| 188 // Returns true if we should load the given plugin, or false otherwise. | 187 // Returns true if we should load the given plugin, or false otherwise. |
| 189 // |plugins| is the list of plugins we have crawled in the current plugin | 188 // |plugins| is the list of plugins we have crawled in the current plugin |
| 190 // loading run. | 189 // loading run. |
| 191 bool ShouldLoadPluginUsingPluginList( | 190 bool ShouldLoadPluginUsingPluginList(const WebPluginInfo& info, |
| 192 const webkit::WebPluginInfo& info, | 191 std::vector<WebPluginInfo>* plugins); |
| 193 std::vector<webkit::WebPluginInfo>* plugins); | |
| 194 | 192 |
| 195 // Returns true if the given plugin supports a given file extension. | 193 // Returns true if the given plugin supports a given file extension. |
| 196 // |extension| should be all lower case. If |mime_type| is not NULL, it will | 194 // |extension| should be all lower case. If |mime_type| is not NULL, it will |
| 197 // be set to the MIME type if found. The MIME type which corresponds to the | 195 // be set to the MIME type if found. The MIME type which corresponds to the |
| 198 // extension is optionally returned back. | 196 // extension is optionally returned back. |
| 199 bool SupportsExtension(const webkit::WebPluginInfo& plugin, | 197 bool SupportsExtension(const WebPluginInfo& plugin, |
| 200 const std::string& extension, | 198 const std::string& extension, |
| 201 std::string* actual_mime_type); | 199 std::string* actual_mime_type); |
| 202 // | 200 // |
| 203 // Command-line switches | 201 // Command-line switches |
| 204 // | 202 // |
| 205 | 203 |
| 206 #if defined(OS_WIN) | 204 #if defined(OS_WIN) |
| 207 // Gets plugin paths registered under HKCU\Software\MozillaPlugins and | 205 // Gets plugin paths registered under HKCU\Software\MozillaPlugins and |
| 208 // HKLM\Software\MozillaPlugins. | 206 // HKLM\Software\MozillaPlugins. |
| 209 void GetPluginPathsFromRegistry(std::vector<base::FilePath>* plugins); | 207 void GetPluginPathsFromRegistry(std::vector<base::FilePath>* plugins); |
| 210 #endif | 208 #endif |
| 211 | 209 |
| 212 // | 210 // |
| 213 // Internals | 211 // Internals |
| 214 // | 212 // |
| 215 | 213 |
| 216 // States whether we will load the plug-in list the next time we try to access | 214 // States whether we will load the plug-in list the next time we try to access |
| 217 // it, whether we are currently in the process of loading it, or whether we | 215 // it, whether we are currently in the process of loading it, or whether we |
| 218 // consider it up-to-date. | 216 // consider it up-to-date. |
| 219 LoadingState loading_state_; | 217 LoadingState loading_state_; |
| 220 | 218 |
| 221 // Extra plugin paths that we want to search when loading. | 219 // Extra plugin paths that we want to search when loading. |
| 222 std::vector<base::FilePath> extra_plugin_paths_; | 220 std::vector<base::FilePath> extra_plugin_paths_; |
| 223 | 221 |
| 224 // Extra plugin directories that we want to search when loading. | 222 // Extra plugin directories that we want to search when loading. |
| 225 std::vector<base::FilePath> extra_plugin_dirs_; | 223 std::vector<base::FilePath> extra_plugin_dirs_; |
| 226 | 224 |
| 227 // Holds information about internal plugins. | 225 // Holds information about internal plugins. |
| 228 std::vector<webkit::WebPluginInfo> internal_plugins_; | 226 std::vector<WebPluginInfo> internal_plugins_; |
| 229 | 227 |
| 230 // A list holding all plug-ins. | 228 // A list holding all plug-ins. |
| 231 std::vector<webkit::WebPluginInfo> plugins_list_; | 229 std::vector<WebPluginInfo> plugins_list_; |
| 232 | 230 |
| 233 // Callback that is invoked whenever the PluginList will reload the plugins. | 231 // Callback that is invoked whenever the PluginList will reload the plugins. |
| 234 base::Closure will_load_plugins_callback_; | 232 base::Closure will_load_plugins_callback_; |
| 235 | 233 |
| 236 // Need synchronization for the above members since this object can be | 234 // Need synchronization for the above members since this object can be |
| 237 // accessed on multiple threads. | 235 // accessed on multiple threads. |
| 238 base::Lock lock_; | 236 base::Lock lock_; |
| 239 | 237 |
| 240 // Flag indicating whether third_party plugins will be searched for | 238 // Flag indicating whether third_party plugins will be searched for |
| 241 // in common places. | 239 // in common places. |
| 242 bool plugins_discovery_disabled_; | 240 bool plugins_discovery_disabled_; |
| 243 | 241 |
| 244 DISALLOW_COPY_AND_ASSIGN(PluginList); | 242 DISALLOW_COPY_AND_ASSIGN(PluginList); |
| 245 }; | 243 }; |
| 246 | 244 |
| 247 } // namespace content | 245 } // namespace content |
| 248 | 246 |
| 249 #endif // CONTENT_COMMON_PLUGIN_LIST_H_ | 247 #endif // CONTENT_COMMON_PLUGIN_LIST_H_ |
| OLD | NEW |