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
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
/*
An object to represent loadable indicator modules to make loading
them easy and objectified.
Copyright 2009 Canonical Ltd.
Authors:
Ted Gould <ted@canonical.com>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
version 3.0 as published by the Free Software Foundation.
This library 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 version 3.0 for more details.
You should have received a copy of the GNU General Public
License along with this library. If not, see
<http://www.gnu.org/licenses/>.
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "indicator.h"
#include "indicator-object.h"
/**
IndicatorObjectPrivate:
@module: The loaded module representing the object. Note to
subclasses: This will not be set when you're initalized.
Private data for the object.
*/
struct _IndicatorObjectPrivate {
GModule * module;
};
#define INDICATOR_OBJECT_GET_PRIVATE(o) (INDICATOR_OBJECT(o)->priv)
static void indicator_object_class_init (IndicatorObjectClass *klass);
static void indicator_object_init (IndicatorObject *self);
static void indicator_object_dispose (GObject *object);
static void indicator_object_finalize (GObject *object);
G_DEFINE_TYPE (IndicatorObject, indicator_object, G_TYPE_OBJECT);
/* Setup the class and put the functions into the
class structure */
static void
indicator_object_class_init (IndicatorObjectClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
g_type_class_add_private (klass, sizeof (IndicatorObjectPrivate));
object_class->dispose = indicator_object_dispose;
object_class->finalize = indicator_object_finalize;
klass->get_label = NULL;
klass->get_menu = NULL;
klass->get_image = NULL;
return;
}
/* Initialize an instance */
static void
indicator_object_init (IndicatorObject *self)
{
self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, INDICATOR_OBJECT_TYPE, IndicatorObjectPrivate);
self->priv->module = NULL;
return;
}
/* Unref the objects that we're holding on to. */
static void
indicator_object_dispose (GObject *object)
{
IndicatorObjectPrivate * priv = INDICATOR_OBJECT_GET_PRIVATE(object);
if (priv->module != NULL) {
g_object_unref(priv->module);
priv->module = NULL;
}
G_OBJECT_CLASS (indicator_object_parent_class)->dispose (object);
return;
}
/* Free memory */
static void
indicator_object_finalize (GObject *object)
{
G_OBJECT_CLASS (indicator_object_parent_class)->finalize (object);
return;
}
/**
indicator_object_new_from_file:
@file: Filename containing a loadable module
This function builds an #IndicatorObject using the symbols
that are found in @file. The module is loaded and the
references are all kept by the object. To unload the
module the object must be destroyed.
Return value: A valid #IndicatorObject or #NULL if error.
*/
IndicatorObject *
indicator_object_new_from_file (const gchar * file)
{
GObject * object = NULL;
GModule * module = NULL;
/* Check to make sure the name exists and that the
file itself exists */
if (file == NULL) {
g_warning("Invalid filename.");
return NULL;
}
if (!g_file_test(file, G_FILE_TEST_EXISTS)) {
g_warning("File '%s' does not exist.", file);
return NULL;
}
/* Grab the g_module reference, pull it in but let's
keep the symbols local to avoid conflicts. */
module = g_module_open(file,
G_MODULE_BIND_LAZY | G_MODULE_BIND_LOCAL);
if(module == NULL) {
g_warning("Unable to load module: %s", file);
return NULL;
}
/* Look for the version function, error if not found. */
get_version_t lget_version = NULL;
if (!g_module_symbol(module, INDICATOR_GET_VERSION_S, (gpointer *)(&lget_version))) {
g_warning("Unable to get the symbol for getting the version.");
return NULL;
}
/* Check the version with the macro and make sure we're
all talking the same language. */
if (!INDICATOR_VERSION_CHECK(lget_version())) {
g_warning("Indicator using API version '%s' we're expecting '%s'", lget_version(), INDICATOR_VERSION);
return NULL;
}
/* The function for grabbing a label from the module
execute it, and make sure everything is a-okay */
get_type_t lget_type = NULL;
if (!g_module_symbol(module, INDICATOR_GET_TYPE_S, (gpointer *)(&lget_type))) {
g_warning("Unable to get '" INDICATOR_GET_TYPE_S "' symbol from module: %s", file);
goto unrefandout;
}
if (lget_type == NULL) {
g_warning("Symbol '" INDICATOR_GET_TYPE_S "' is (null) in module: %s", file);
goto unrefandout;
}
/* A this point we allocate the object, any code beyond
here needs to deallocate it if we're returning in an
error'd state. */
object = g_object_new(lget_type(), NULL);
if (object == NULL) {
g_warning("Unable to build an object if type '%d' in module: %s", lget_type(), file);
goto unrefandout;
}
if (!INDICATOR_IS_OBJECT(object)) {
g_warning("Type '%d' in file %s is not a subclass of IndicatorObject.", lget_type(), file);
goto unrefandout;
}
IndicatorObjectPrivate * priv = INDICATOR_OBJECT_GET_PRIVATE(object);
/* Now we can track the module */
priv->module = module;
return INDICATOR_OBJECT(object);
/* Error, let's drop the object and return NULL. Sad when
this happens. */
unrefandout:
if (object != NULL) {
g_object_unref(object);
}
if (module != NULL) {
g_object_unref(module);
}
g_warning("Error building IndicatorObject from file: %s", file);
return NULL;
}
|
