Mercurial > pidgin.yaz
annotate src/plugin.h @ 11896:8aa6462e563c
[gaim-migrate @ 14187]
Change "Keep the dialog open" to "Close this window when all transfers finish". I think that's a lot clearer. I didn't change the underlying preference, just inverted the value when setting up the checkbox. That seemed like a lot of work for very little gain.
committer: Tailor Script <tailor@pidgin.im>
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Sat, 29 Oct 2005 21:11:07 +0000 |
parents | 1bb0efbd4394 |
children | 2b9ca8861ca5 |
rev | line source |
---|---|
5205 | 1 /** |
2 * @file plugin.h Plugin API | |
3 * @ingroup core | |
4 * | |
5 * gaim | |
6 * | |
8046 | 7 * Gaim is the legal property of its developers, whose names are too numerous |
8 * to list here. Please refer to the COPYRIGHT file distributed with this | |
9 * source distribution. | |
6485
70d5122bc3ff
[gaim-migrate @ 6999]
Christian Hammond <chipx86@chipx86.com>
parents:
5949
diff
changeset
|
10 * |
5205 | 11 * This program is free software; you can redistribute it and/or modify |
12 * it under the terms of the GNU General Public License as published by | |
13 * the Free Software Foundation; either version 2 of the License, or | |
14 * (at your option) any later version. | |
15 * | |
16 * This program is distributed in the hope that it will be useful, | |
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 * GNU General Public License for more details. | |
20 * | |
21 * You should have received a copy of the GNU General Public License | |
22 * along with this program; if not, write to the Free Software | |
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
24 */ | |
25 #ifndef _GAIM_PLUGIN_H_ | |
26 #define _GAIM_PLUGIN_H_ | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
27 |
8986 | 28 #include <glib/glist.h> |
5224
5160333a80df
[gaim-migrate @ 5594]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
5205
diff
changeset
|
29 #include <gmodule.h> |
6822
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
30 #include "signals.h" |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
31 #include "value.h" |
5205 | 32 |
10682 | 33 #define GAIM_PLUGIN_EXT_WIN32 ".dll" |
34 #define GAIM_PLUGIN_EXT_HPUX ".sl" | |
35 #define GAIM_PLUGIN_EXT_UNIX ".so" | |
36 | |
10504 | 37 #ifdef _WIN32 |
10682 | 38 # define GAIM_PLUGIN_EXT GAIM_PLUGIN_EXT_WIN32 |
10710 | 39 #elif __hpux |
40 # define GAIM_PLUGIN_EXT GAIM_PLUGIN_EXT_HPUX | |
10504 | 41 #else |
10710 | 42 # define GAIM_PLUGIN_EXT GAIM_PLUGIN_EXT_UNIX |
10504 | 43 #endif |
44 | |
8749
d7b8eb1f0a18
[gaim-migrate @ 9504]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
45 typedef struct _GaimPlugin GaimPlugin; |
d7b8eb1f0a18
[gaim-migrate @ 9504]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
46 typedef struct _GaimPluginInfo GaimPluginInfo; |
d7b8eb1f0a18
[gaim-migrate @ 9504]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
47 typedef struct _GaimPluginUiInfo GaimPluginUiInfo; |
5205 | 48 typedef struct _GaimPluginLoaderInfo GaimPluginLoaderInfo; |
49 | |
9015 | 50 typedef struct _GaimPluginAction GaimPluginAction; |
51 | |
5205 | 52 typedef int GaimPluginPriority; /**< Plugin priority. */ |
53 | |
8713 | 54 #include "pluginpref.h" |
55 | |
5205 | 56 /** |
57 * Plugin types. | |
58 */ | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
59 typedef enum |
5205 | 60 { |
61 GAIM_PLUGIN_UNKNOWN = -1, /**< Unknown type. */ | |
62 GAIM_PLUGIN_STANDARD = 0, /**< Standard plugin. */ | |
63 GAIM_PLUGIN_LOADER, /**< Loader plugin. */ | |
64 GAIM_PLUGIN_PROTOCOL /**< Protocol plugin. */ | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
65 |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
66 } GaimPluginType; |
5205 | 67 |
68 #define GAIM_PRIORITY_DEFAULT 0 | |
69 #define GAIM_PRIORITY_HIGHEST 9999 | |
70 #define GAIM_PRIORITY_LOWEST -9999 | |
71 | |
6928
6ed0a1c045b4
[gaim-migrate @ 7475]
Christian Hammond <chipx86@chipx86.com>
parents:
6822
diff
changeset
|
72 #define GAIM_PLUGIN_FLAG_INVISIBLE 0x01 |
6ed0a1c045b4
[gaim-migrate @ 7475]
Christian Hammond <chipx86@chipx86.com>
parents:
6822
diff
changeset
|
73 |
9946 | 74 #define GAIM_PLUGIN_MAGIC 5 /* once we hit 6.0.0 I think we can remove this */ |
8749
d7b8eb1f0a18
[gaim-migrate @ 9504]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
75 |
5205 | 76 /** |
77 * Detailed information about a plugin. | |
78 * | |
79 * This is used in the version 2.0 API and up. | |
80 */ | |
81 struct _GaimPluginInfo | |
82 { | |
9943 | 83 unsigned int magic; |
84 unsigned int major_version; | |
85 unsigned int minor_version; | |
5205 | 86 GaimPluginType type; |
87 char *ui_requirement; | |
88 unsigned long flags; | |
89 GList *dependencies; | |
90 GaimPluginPriority priority; | |
91 | |
92 char *id; | |
93 char *name; | |
94 char *version; | |
95 char *summary; | |
96 char *description; | |
97 char *author; | |
98 char *homepage; | |
99 | |
10450 | 100 /* |
101 * TODO: I think the intention was the allow multiple load and unload | |
102 * callback functions. Perhaps using a GList instead of a pointer to | |
103 * 1 function. | |
104 */ | |
5205 | 105 gboolean (*load)(GaimPlugin *plugin); |
106 gboolean (*unload)(GaimPlugin *plugin); | |
107 void (*destroy)(GaimPlugin *plugin); | |
108 | |
11817
1bb0efbd4394
[gaim-migrate @ 14108]
Daniel Atallah <daniel.atallah@gmail.com>
parents:
11772
diff
changeset
|
109 void *ui_info; /**< Used only by UI-specific plugins to build a preference screen with a custom UI */ |
5205 | 110 void *extra_info; |
11817
1bb0efbd4394
[gaim-migrate @ 14108]
Daniel Atallah <daniel.atallah@gmail.com>
parents:
11772
diff
changeset
|
111 GaimPluginUiInfo *prefs_info; /**< Used by any plugin to display preferences. If #ui_info has been specified, this will be ignored. */ |
9015 | 112 GList *(*actions)(GaimPlugin *plugin, gpointer context); |
5205 | 113 }; |
114 | |
115 /** | |
116 * Extra information for loader plugins. | |
117 */ | |
118 struct _GaimPluginLoaderInfo | |
119 { | |
120 GList *exts; | |
121 | |
122 gboolean (*probe)(GaimPlugin *plugin); | |
123 gboolean (*load)(GaimPlugin *plugin); | |
124 gboolean (*unload)(GaimPlugin *plugin); | |
125 void (*destroy)(GaimPlugin *plugin); | |
126 }; | |
127 | |
128 /** | |
129 * A plugin handle. | |
130 */ | |
131 struct _GaimPlugin | |
132 { | |
133 gboolean native_plugin; /**< Native C plugin. */ | |
134 gboolean loaded; /**< The loaded state. */ | |
135 void *handle; /**< The module handle. */ | |
136 char *path; /**< The path to the plugin. */ | |
137 GaimPluginInfo *info; /**< The plugin information. */ | |
138 char *error; | |
6822
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
139 void *ipc_data; /**< IPC data. */ |
5205 | 140 void *extra; /**< Plugin-specific data. */ |
141 }; | |
142 | |
143 #define GAIM_PLUGIN_LOADER_INFO(plugin) \ | |
144 ((GaimPluginLoaderInfo *)(plugin)->info->extra_info) | |
145 | |
8713 | 146 struct _GaimPluginUiInfo { |
147 GaimPluginPrefFrame *(*get_plugin_pref_frame)(GaimPlugin *plugin); | |
148 | |
10759 | 149 int page_num; /**< Reserved */ |
8814 | 150 GaimPluginPrefFrame *frame; /**< Reserved */ |
8713 | 151 }; |
152 | |
153 #define GAIM_PLUGIN_HAS_PREF_FRAME(plugin) \ | |
154 ((plugin)->info != NULL && (plugin)->info->prefs_info != NULL) | |
155 | |
156 #define GAIM_PLUGIN_UI_INFO(plugin) \ | |
157 ((GaimPluginUiInfo*)(plugin)->info->prefs_info) | |
158 | |
9015 | 159 |
160 /** | |
161 * The structure used in the actions member of GaimPluginInfo | |
162 */ | |
163 struct _GaimPluginAction { | |
164 char *label; | |
165 void (*callback)(GaimPluginAction *); | |
166 | |
167 /** set to the owning plugin */ | |
168 GaimPlugin *plugin; | |
169 | |
170 /** NULL for plugin actions menu, set to the GaimConnection for | |
171 account actions menu */ | |
172 gpointer context; | |
173 }; | |
174 | |
175 #define GAIM_PLUGIN_HAS_ACTIONS(plugin) \ | |
176 ((plugin)->info != NULL && (plugin)->info->actions != NULL) | |
177 | |
178 #define GAIM_PLUGIN_ACTIONS(plugin, context) \ | |
179 (GAIM_PLUGIN_HAS_ACTIONS(plugin)? \ | |
180 (plugin)->info->actions(plugin, context): NULL) | |
181 | |
182 | |
5205 | 183 /** |
184 * Handles the initialization of modules. | |
185 */ | |
8082 | 186 #if !defined(GAIM_PLUGINS) || defined(GAIM_STATIC_PRPL) |
5205 | 187 # define GAIM_INIT_PLUGIN(pluginname, initfunc, plugininfo) \ |
188 gboolean gaim_init_##pluginname##_plugin(void) { \ | |
189 GaimPlugin *plugin = gaim_plugin_new(TRUE, NULL); \ | |
190 plugin->info = &(plugininfo); \ | |
191 initfunc((plugin)); \ | |
192 return gaim_plugin_register(plugin); \ | |
193 } | |
8082 | 194 #else /* GAIM_PLUGINS && !GAIM_STATIC_PRPL */ |
5205 | 195 # define GAIM_INIT_PLUGIN(pluginname, initfunc, plugininfo) \ |
5224
5160333a80df
[gaim-migrate @ 5594]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
5205
diff
changeset
|
196 G_MODULE_EXPORT gboolean gaim_init_plugin(GaimPlugin *plugin) { \ |
5205 | 197 plugin->info = &(plugininfo); \ |
198 initfunc((plugin)); \ | |
199 return gaim_plugin_register(plugin); \ | |
200 } | |
201 #endif | |
202 | |
9015 | 203 |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
204 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
205 extern "C" { |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
206 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
207 |
5205 | 208 /**************************************************************************/ |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
209 /** @name Plugin API */ |
5205 | 210 /**************************************************************************/ |
211 /*@{*/ | |
212 | |
213 /** | |
214 * Creates a new plugin structure. | |
215 * | |
216 * @param native Whether or not the plugin is native. | |
217 * @param path The path to the plugin, or @c NULL if statically compiled. | |
218 * | |
219 * @return A new GaimPlugin structure. | |
220 */ | |
221 GaimPlugin *gaim_plugin_new(gboolean native, const char *path); | |
222 | |
223 /** | |
224 * Probes a plugin, retrieving the information on it and adding it to the | |
225 * list of available plugins. | |
226 * | |
227 * @param filename The plugin's filename. | |
228 * | |
229 * @return The plugin handle. | |
230 * | |
231 * @see gaim_plugin_load() | |
232 * @see gaim_plugin_destroy() | |
233 */ | |
234 GaimPlugin *gaim_plugin_probe(const char *filename); | |
235 | |
236 /** | |
237 * Registers a plugin and prepares it for loading. | |
238 * | |
239 * This shouldn't be called by anything but the internal module code. | |
10447 | 240 * Plugins should use the GAIM_INIT_PLUGIN() macro to register themselves |
241 * with the core. | |
5205 | 242 * |
243 * @param plugin The plugin to register. | |
10447 | 244 * |
245 * @return @c TRUE if the plugin was registered successfully. Otherwise | |
246 * @c FALSE is returned (this happens if the plugin does not contain | |
247 * the necessary information). | |
5205 | 248 */ |
249 gboolean gaim_plugin_register(GaimPlugin *plugin); | |
250 | |
251 /** | |
252 * Attempts to load a previously probed plugin. | |
253 * | |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6486
diff
changeset
|
254 * @param plugin The plugin to load. |
5205 | 255 * |
256 * @return @c TRUE if successful, or @c FALSE otherwise. | |
257 * | |
258 * @see gaim_plugin_reload() | |
259 * @see gaim_plugin_unload() | |
260 */ | |
261 gboolean gaim_plugin_load(GaimPlugin *plugin); | |
262 | |
263 /** | |
264 * Unloads the specified plugin. | |
265 * | |
266 * @param plugin The plugin handle. | |
267 * | |
268 * @return @c TRUE if successful, or @c FALSE otherwise. | |
269 * | |
270 * @see gaim_plugin_load() | |
271 * @see gaim_plugin_reload() | |
272 */ | |
273 gboolean gaim_plugin_unload(GaimPlugin *plugin); | |
274 | |
275 /** | |
276 * Reloads a plugin. | |
277 * | |
278 * @param plugin The old plugin handle. | |
6486
fab81e4b885c
[gaim-migrate @ 7000]
Christian Hammond <chipx86@chipx86.com>
parents:
6485
diff
changeset
|
279 * |
5205 | 280 * @return @c TRUE if successful, or @c FALSE otherwise. |
281 * | |
282 * @see gaim_plugin_load() | |
283 * @see gaim_plugin_unload() | |
284 */ | |
285 gboolean gaim_plugin_reload(GaimPlugin *plugin); | |
286 | |
287 /** | |
288 * Unloads a plugin and destroys the structure from memory. | |
289 * | |
290 * @param plugin The plugin handle. | |
291 */ | |
292 void gaim_plugin_destroy(GaimPlugin *plugin); | |
293 | |
294 /** | |
295 * Returns whether or not a plugin is currently loaded. | |
296 * | |
297 * @param plugin The plugin. | |
298 * | |
299 * @return TRUE if loaded, or FALSE otherwise. | |
300 */ | |
301 gboolean gaim_plugin_is_loaded(const GaimPlugin *plugin); | |
302 | |
11772
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
303 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
304 * Returns a plugin's id. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
305 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
306 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
307 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
308 * @return The plugin's id. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
309 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
310 const gchar *gaim_plugin_get_id(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
311 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
312 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
313 * Returns a plugin's name. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
314 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
315 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
316 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
317 * @return THe name of the plugin, or @c NULL. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
318 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
319 const gchar *gaim_plugin_get_name(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
320 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
321 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
322 * Returns a plugin's version. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
323 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
324 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
325 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
326 * @return The plugin's version or @c NULL. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
327 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
328 const gchar *gaim_plugin_get_version(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
329 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
330 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
331 * Returns a plugin's summary. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
332 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
333 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
334 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
335 * @return The plugin's summary. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
336 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
337 const gchar *gaim_plugin_get_summary(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
338 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
339 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
340 * Returns a plugin's description. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
341 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
342 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
343 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
344 * @return The plugin's description. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
345 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
346 const gchar *gaim_plugin_get_description(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
347 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
348 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
349 * Returns a plugin's author. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
350 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
351 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
352 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
353 * @return The plugin's author. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
354 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
355 const gchar *gaim_plugin_get_author(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
356 |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
357 /** |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
358 * Returns a plugin's homepage. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
359 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
360 * @param plugin The plugin. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
361 * |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
362 * @return The plugin's homepage. |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
363 */ |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
364 const gchar *gaim_plugin_get_homepage(const GaimPlugin *plugin); |
d1d5f27de95d
[gaim-migrate @ 14063]
Gary Kramlich <grim@reaperworld.com>
parents:
10759
diff
changeset
|
365 |
5205 | 366 /*@}*/ |
367 | |
368 /**************************************************************************/ | |
6822
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
369 /** @name Plugin IPC API */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
370 /**************************************************************************/ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
371 /*@{*/ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
372 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
373 /** |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
374 * Registers an IPC command in a plugin. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
375 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
376 * @param plugin The plugin to register the command with. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
377 * @param command The name of the command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
378 * @param func The function to execute. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
379 * @param marshal The marshalling function. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
380 * @param ret_value The return value type. |
7114
c47633e9e2a4
[gaim-migrate @ 7681]
Christian Hammond <chipx86@chipx86.com>
parents:
7034
diff
changeset
|
381 * @param num_params The number of parameters. |
6822
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
382 * @param ... The parameter types. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
383 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
384 * @return TRUE if the function was registered successfully, or |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
385 * FALSE otherwise. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
386 */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
387 gboolean gaim_plugin_ipc_register(GaimPlugin *plugin, const char *command, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
388 GaimCallback func, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
389 GaimSignalMarshalFunc marshal, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
390 GaimValue *ret_value, int num_params, ...); |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
391 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
392 /** |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
393 * Unregisters an IPC command in a plugin. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
394 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
395 * @param plugin The plugin to unregister the command from. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
396 * @param command The name of the command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
397 */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
398 void gaim_plugin_ipc_unregister(GaimPlugin *plugin, const char *command); |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
399 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
400 /** |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
401 * Unregisters all IPC commands in a plugin. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
402 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
403 * @param plugin The plugin to unregister the commands from. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
404 */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
405 void gaim_plugin_ipc_unregister_all(GaimPlugin *plugin); |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
406 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
407 /** |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
408 * Returns a list of value types used for an IPC command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
409 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
410 * @param plugin The plugin. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
411 * @param command The name of the command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
412 * @param ret_value The returned return value. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
413 * @param num_params The returned number of parameters. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
414 * @param params The returned list of parameters. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
415 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
416 * @return TRUE if the command was found, or FALSE otherwise. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
417 */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
418 gboolean gaim_plugin_ipc_get_params(GaimPlugin *plugin, const char *command, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
419 GaimValue **ret_value, int *num_params, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
420 GaimValue ***params); |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
421 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
422 /** |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
423 * Executes an IPC command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
424 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
425 * @param plugin The plugin to execute the command on. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
426 * @param command The name of the command. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
427 * @param ok TRUE if the call was successful, or FALSE otherwise. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
428 * @param ... The parameters to pass. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
429 * |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
430 * @return The return value, which will be NULL if the command doesn't |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
431 * return a value. |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
432 */ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
433 void *gaim_plugin_ipc_call(GaimPlugin *plugin, const char *command, |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
434 gboolean *ok, ...); |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
435 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
436 /*@}*/ |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
437 |
7dba3e17cb21
[gaim-migrate @ 7366]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
438 /**************************************************************************/ |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
439 /** @name Plugins API */ |
5205 | 440 /**************************************************************************/ |
441 /*@{*/ | |
442 | |
443 /** | |
10447 | 444 * Add a new directory to search for plugins |
5205 | 445 * |
10448 | 446 * @param path The new search path. |
5205 | 447 */ |
10447 | 448 void gaim_plugins_add_search_path(const char *path); |
5205 | 449 |
450 /** | |
5242
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
451 * Unloads all loaded plugins. |
5205 | 452 */ |
453 void gaim_plugins_unload_all(void); | |
454 | |
5242
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
455 /** |
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
456 * Destroys all registered plugins. |
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
457 */ |
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
458 void gaim_plugins_destroy_all(void); |
fd81a00480ac
[gaim-migrate @ 5613]
Christian Hammond <chipx86@chipx86.com>
parents:
5224
diff
changeset
|
459 |
5205 | 460 /** |
5949
90d0849abd3c
[gaim-migrate @ 6393]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
461 * Attempts to load all the plugins in the specified preference key |
90d0849abd3c
[gaim-migrate @ 6393]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
462 * that were loaded when gaim last quit. |
90d0849abd3c
[gaim-migrate @ 6393]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
463 * |
90d0849abd3c
[gaim-migrate @ 6393]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
464 * @param key The preference key containing the list of plugins. |
5838 | 465 */ |
5949
90d0849abd3c
[gaim-migrate @ 6393]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
466 void gaim_plugins_load_saved(const char *key); |
5838 | 467 |
468 /** | |
5205 | 469 * Probes for plugins in the registered module paths. |
470 * | |
471 * @param ext The extension type to probe for, or @c NULL for all. | |
472 * | |
473 * @see gaim_plugin_set_probe_path() | |
474 */ | |
475 void gaim_plugins_probe(const char *ext); | |
476 | |
477 /** | |
478 * Returns whether or not plugin support is enabled. | |
479 * | |
480 * @return TRUE if plugin support is enabled, or FALSE otherwise. | |
481 */ | |
482 gboolean gaim_plugins_enabled(void); | |
483 | |
484 /** | |
485 * Registers a function that will be called when probing is finished. | |
486 * | |
487 * @param func The callback function. | |
488 * @param data Data to pass to the callback. | |
489 */ | |
490 void gaim_plugins_register_probe_notify_cb(void (*func)(void *), void *data); | |
491 | |
492 /** | |
493 * Unregisters a function that would be called when probing is finished. | |
494 * | |
495 * @param func The callback function. | |
496 */ | |
497 void gaim_plugins_unregister_probe_notify_cb(void (*func)(void *)); | |
498 | |
499 /** | |
500 * Registers a function that will be called when a plugin is loaded. | |
501 * | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8713
diff
changeset
|
502 * @param func The callback function. |
5205 | 503 * @param data Data to pass to the callback. |
504 */ | |
505 void gaim_plugins_register_load_notify_cb(void (*func)(GaimPlugin *, void *), | |
506 void *data); | |
507 | |
508 /** | |
509 * Unregisters a function that would be called when a plugin is loaded. | |
510 * | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8713
diff
changeset
|
511 * @param func The callback function. |
5205 | 512 */ |
513 void gaim_plugins_unregister_load_notify_cb(void (*func)(GaimPlugin *, void *)); | |
514 | |
515 /** | |
516 * Registers a function that will be called when a plugin is unloaded. | |
517 * | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8713
diff
changeset
|
518 * @param func The callback function. |
5205 | 519 * @param data Data to pass to the callback. |
520 */ | |
521 void gaim_plugins_register_unload_notify_cb(void (*func)(GaimPlugin *, void *), | |
522 void *data); | |
523 | |
524 /** | |
525 * Unregisters a function that would be called when a plugin is unloaded. | |
526 * | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8713
diff
changeset
|
527 * @param func The callback function. |
5205 | 528 */ |
529 void gaim_plugins_unregister_unload_notify_cb(void (*func)(GaimPlugin *, | |
530 void *)); | |
531 | |
532 /** | |
533 * Finds a plugin with the specified name. | |
534 * | |
535 * @param name The plugin name. | |
536 * | |
537 * @return The plugin if found, or @c NULL if not found. | |
538 */ | |
539 GaimPlugin *gaim_plugins_find_with_name(const char *name); | |
540 | |
541 /** | |
7034
f7ff0dfa6b9f
[gaim-migrate @ 7597]
Christian Hammond <chipx86@chipx86.com>
parents:
7033
diff
changeset
|
542 * Finds a plugin with the specified filename (filename with a path). |
5205 | 543 * |
544 * @param filename The plugin filename. | |
545 * | |
546 * @return The plugin if found, or @c NULL if not found. | |
547 */ | |
548 GaimPlugin *gaim_plugins_find_with_filename(const char *filename); | |
549 | |
550 /** | |
7034
f7ff0dfa6b9f
[gaim-migrate @ 7597]
Christian Hammond <chipx86@chipx86.com>
parents:
7033
diff
changeset
|
551 * Finds a plugin with the specified basename (filename without a path). |
7033
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
552 * |
7034
f7ff0dfa6b9f
[gaim-migrate @ 7597]
Christian Hammond <chipx86@chipx86.com>
parents:
7033
diff
changeset
|
553 * @param basename The plugin basename. |
7033
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
554 * |
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
555 * @return The plugin if found, or @c NULL if not found. |
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
556 */ |
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
557 GaimPlugin *gaim_plugins_find_with_basename(const char *basename); |
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
558 |
cf1126ba1834
[gaim-migrate @ 7596]
Christian Hammond <chipx86@chipx86.com>
parents:
6928
diff
changeset
|
559 /** |
5205 | 560 * Finds a plugin with the specified plugin ID. |
561 * | |
562 * @param id The plugin ID. | |
563 * | |
564 * @return The plugin if found, or @c NULL if not found. | |
565 */ | |
566 GaimPlugin *gaim_plugins_find_with_id(const char *id); | |
567 | |
568 /** | |
569 * Returns a list of all loaded plugins. | |
570 * | |
5573
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
571 * @return A list of all loaded plugins. |
5205 | 572 */ |
573 GList *gaim_plugins_get_loaded(void); | |
574 | |
575 /** | |
5573
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
576 * Returns a list of all protocol plugins. |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
577 * |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
578 * @return A list of all protocol plugins. |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
579 */ |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
580 GList *gaim_plugins_get_protocols(void); |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
581 |
5e7de337a053
[gaim-migrate @ 5976]
Christian Hammond <chipx86@chipx86.com>
parents:
5449
diff
changeset
|
582 /** |
5205 | 583 * Returns a list of all plugins, whether loaded or not. |
584 * | |
585 * @return A list of all plugins. | |
586 */ | |
587 GList *gaim_plugins_get_all(void); | |
588 | |
589 /*@}*/ | |
590 | |
10479 | 591 /**************************************************************************/ |
592 /** @name Plugins SubSytem API */ | |
593 /**************************************************************************/ | |
594 /*@{*/ | |
595 | |
596 /** | |
597 * Returns the plugin subsystem handle. | |
598 * | |
599 * @return The plugin sybsystem handle. | |
600 */ | |
601 void *gaim_plugins_get_handle(void); | |
602 | |
603 /** | |
604 * Initializes the plugin subsystem | |
605 */ | |
606 void gaim_plugins_init(void); | |
607 | |
608 /** | |
609 * Uninitializes the plugin subsystem | |
610 */ | |
611 void gaim_plugins_uninit(void); | |
612 | |
613 /*@}*/ | |
9015 | 614 |
615 /** | |
616 * Allocates and returns a new GaimPluginAction. | |
617 */ | |
618 GaimPluginAction *gaim_plugin_action_new(char* label, void (*callback)(GaimPluginAction *)); | |
619 | |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
620 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
621 } |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
622 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5840
diff
changeset
|
623 |
5205 | 624 #endif /* _GAIM_PLUGIN_H_ */ |