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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
|
/* Ekiga -- A VoIP and Video-Conferencing application
* Copyright (C) 2000-2009 Damien Sandras <dsandras@seconix.com>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
*
*
* Ekiga is licensed under the GPL license and as a special exception,
* you have permission to link or otherwise combine this program with the
* programs OPAL, OpenH323 and PWLIB, and distribute the combination,
* without applying the requirements of the GNU GPL to the OPAL, OpenH323
* and PWLIB programs, as long as you do follow the requirements of the
* GNU GPL for all the rest of the software thus combined.
*/
/*
* plugin-core.cpp - description
* ------------------------------------------
* begin : written in 2009 by Julien Puydt
* copyright : (c) 2009 by Julien Puydt
* description : Implementation of the object responsible of plugin loads
*
*/
#include "plugin-core.h"
#include <gmodule.h>
#define DEBUG 0
#if DEBUG
#include <iostream>
#endif
// Here is what a trivial plugin looks like :
//
// #include "kickstart.h"
// #include <iostream>
//
// extern "C" void
// ekiga_plugin_init (Ekiga::KickStart& /*kickstart*/)
// {
// std::cout << "Hello!" << std::endl;
// }
//
// which can be compiled with :
// gcc -o hello.so hello.cpp -shared -export-dynamic -I$(PATH_TO_EKIGA_SOURCES)/lib/engine/framework -lboost_signals-mt
//
// additionally, if you want to debug a plugin you're writing, then you should
// set DEBUG to 1 at the start of that file, and put your plugin (and its
// dependancies) in the ekiga_debug_plugins/ directory in your temporary
// directory ("/tmp" on unix-like systems) : that way ekiga will only load that
// and be verbose about it.
static void
plugin_parse_file (Ekiga::KickStart& kickstart,
const gchar* filename)
{
#if DEBUG
std::cout << "Trying to load " << filename << "... ";
#endif
GModule* plugin = g_module_open (filename, G_MODULE_BIND_LOCAL);
if (plugin != 0) {
#if DEBUG
std::cout << "loaded... ";
#endif
gpointer init_func = NULL;
if (g_module_symbol (plugin, "ekiga_plugin_init", &init_func)) {
#if DEBUG
std::cout << "valid" << std::endl;
#endif
g_module_make_resident (plugin);
((void (*)(Ekiga::KickStart&))init_func) (kickstart);
} else {
#if DEBUG
std::cout << "invalid: " << g_module_error () << std::endl;
#endif
g_module_close (plugin);
}
} else {
#if DEBUG
std::cout << "failed to load the module: " << g_module_error () << std::endl;
#endif
}
}
static void
plugin_parse_directory (Ekiga::KickStart& kickstart,
const gchar* path)
{
g_return_if_fail (path != NULL);
GError* error = NULL;
GDir* directory = g_dir_open (path, 0, &error);
#if DEBUG
std::cout << "Trying to load plugins in " << path << "... ";
#endif
if (directory != NULL) {
#if DEBUG
std::cout << "open succeeded" << std::endl;
#endif
const gchar* name = g_dir_read_name (directory);
while (name) {
gchar* filename = g_build_filename (path, name, NULL);
/* There is something to say here : it is unsafe to test then decide
* what to do, because things could have changed between the time we
* test and the time we act. But I think it's good enough for the
* purpose of this code. If I'm wrong, report as a bug.
* (Snark, 20090618)
*/
if (g_str_has_suffix (filename, G_MODULE_SUFFIX))
plugin_parse_file (kickstart, filename);
else
plugin_parse_directory (kickstart, filename);
g_free (filename);
name = g_dir_read_name (directory);
}
g_dir_close (directory);
} else {
#if DEBUG
std::cout << "failure: " << error->message << std::endl;
#endif
g_error_free (error);
}
}
void
plugin_init (Ekiga::KickStart& kickstart)
{
#if DEBUG
// should make it easier to test ekiga without installing
gchar* path = g_build_path (G_DIR_SEPARATOR_S,
g_get_tmp_dir (), "ekiga_debug_plugins", NULL);
plugin_parse_directory (kickstart, path);
g_free (path);
#else
plugin_parse_directory (kickstart,
EKIGA_PLUGIN_DIR);
#endif
}
|
