blob: 8884754ec163b383db37e138f370809a19d142bf (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef WEBKIT_PLUGINS_NPAPI_PLUGIN_LIB_H_
#define WEBKIT_PLUGINS_NPAPI_PLUGIN_LIB_H_
#include <string>
#include <vector>
#include "base/basictypes.h"
#include "base/memory/ref_counted.h"
#include "base/native_library.h"
#include "build/build_config.h"
#include "webkit/plugins/npapi/plugin_list.h"
#include "webkit/plugins/npapi/webplugin.h"
#include "webkit/plugins/webkit_plugins_export.h"
namespace base {
class FilePath;
}
namespace webkit {
namespace npapi {
class PluginInstance;
// A PluginLib is a single NPAPI Plugin Library, and is the lifecycle
// manager for new PluginInstances.
class WEBKIT_PLUGINS_EXPORT PluginLib : public base::RefCounted<PluginLib> {
public:
static PluginLib* CreatePluginLib(const base::FilePath& filename);
// Unloads all the loaded plugin libraries and cleans up the plugin map.
static void UnloadAllPlugins();
// Shuts down all loaded plugin instances.
static void ShutdownAllPlugins();
// Get the Plugin's function pointer table.
NPPluginFuncs* functions();
// Creates a new instance of this plugin.
PluginInstance* CreateInstance(const std::string& mime_type);
// Called by the instance when the instance is tearing down.
void CloseInstance();
// Gets information about this plugin and the mime types that it
// supports.
const webkit::WebPluginInfo& plugin_info() { return web_plugin_info_; }
bool internal() { return internal_; }
//
// NPAPI functions
//
// NPAPI method to initialize a Plugin.
// Initialize can be safely called multiple times
NPError NP_Initialize();
// NPAPI method to shutdown a Plugin.
void NP_Shutdown(void);
// NPAPI method to clear locally stored data (LSO's or "Flash cookies").
NPError NP_ClearSiteData(const char* site, uint64 flags, uint64 max_age);
// NPAPI method to get a NULL-terminated list of all sites under which data
// is stored.
char** NP_GetSitesWithData();
int instance_count() const { return instance_count_; }
// Prevents the library code from being unload when Unload() is called (since
// some plugins crash if unloaded).
void PreventLibraryUnload();
// Indicates whether plugin unload can be deferred.
void set_defer_unload(bool defer_unload) {
defer_unload_ = defer_unload;
}
// protected for testability.
protected:
friend class base::RefCounted<PluginLib>;
// Creates a new PluginLib.
// |entry_points| is non-NULL for internal plugins.
PluginLib(const webkit::WebPluginInfo& info,
const PluginEntryPoints* entry_points);
virtual ~PluginLib();
// Attempts to load the plugin from the library.
// Returns true if it is a legitimate plugin, false otherwise
bool Load();
// Unloads the plugin library.
void Unload();
// Shutdown the plugin library.
void Shutdown();
private:
bool internal_; // True for plugins that are built-in into chrome binaries.
webkit::WebPluginInfo web_plugin_info_; // Supported mime types, description
base::NativeLibrary library_; // The opened library reference.
NPPluginFuncs plugin_funcs_; // The struct of plugin side functions.
bool initialized_; // Is the plugin initialized?
NPSavedData *saved_data_; // Persisted plugin info for NPAPI.
int instance_count_; // Count of plugins in use.
bool skip_unload_; // True if library_ should not be unloaded.
// Function pointers to entry points into the plugin.
PluginEntryPoints entry_points_;
// Set to true if unloading of the plugin dll is to be deferred.
bool defer_unload_;
DISALLOW_COPY_AND_ASSIGN(PluginLib);
};
} // namespace npapi
} // namespace webkit
#endif // WEBKIT_PLUGINS_NPAPI_PLUGIN_LIB_H_
|