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
|
/* -*- linux-c -*-
*
* (C) Copright IBM Corp 2004-2006
*
* 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. This
* file and program are licensed under a BSD style license. See
* the Copying file included with the OpenHPI distribution for
* full licensing terms.
*
* Authors:
* Renier Morales <renier@users.sourceforge.net>
*/
#ifndef __OH_PLUGIN_H
#define __OH_PLUGIN_H
#include <glib.h>
#include <gmodule.h>
#include <oHpi.h>
#include <oh_handler.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* Plugins are kept in a list within the oh_plugins struct
*/
struct oh_plugins {
GSList *list;
#if GLIB_CHECK_VERSION (2, 32, 0)
GRecMutex lock;
#else
GStaticRecMutex lock;
#endif
};
struct oh_plugin {
char *name; /* Name of plugin preceded by 'lib' (e.g. "libdummy"). */
/* handle returned by lt_dlopenext or 0 for static plugins */
GModule *dl_handle;
struct oh_abi_v2 *abi; /* pointer to associated plugin interface */
int handler_count; /* How many handlers use this plugin */
/* Synchronization - used internally by plugin interfaces below. */
#if GLIB_CHECK_VERSION (2, 32, 0)
GRecMutex lock; /* Exclusive lock for working with plugin */
/* These are used to keep the plugin from being unloaded while it
* is being referenced.
*/
GRecMutex refcount_lock;
#else
GStaticRecMutex lock; /* Exclusive lock for working with plugin */
/* These are used to keep the plugin from being unloaded while it
* is being referenced.
*/
GStaticRecMutex refcount_lock;
#endif
int refcount;
};
extern struct oh_plugins oh_plugins;
/*
* Representation of a handler (plugin instance)
*/
struct oh_handlers {
GHashTable *table;
GSList *list;
#if GLIB_CHECK_VERSION (2, 32, 0)
GRecMutex lock;
#else
GStaticRecMutex lock;
#endif
};
struct oh_handler {
unsigned int id; /* id of handler */
char *plugin_name;
GHashTable *config; /* pointer to handler configuration */
struct oh_abi_v2 *abi; /* pointer to associated plugin interface */
/*
* private pointer used by plugin implementations to distinguish
* between different instances
*/
void *hnd;
/* Synchronization - used internally by handler interfaces below. */
#if GLIB_CHECK_VERSION (2, 32, 0)
GRecMutex lock; /* Exclusive lock for working with handler */
/* These are used to keep the handler from being destroyed while it
* is being referenced.
*/
GRecMutex refcount_lock;
#else
GStaticRecMutex lock; /* Exclusive lock for working with handler */
/* These are used to keep the handler from being destroyed while it
* is being referenced.
*/
GStaticRecMutex refcount_lock;
#endif
int refcount;
};
extern struct oh_handlers oh_handlers;
/* Finalization of plugins and handlers. */
void oh_close_handlers(void);
/* Plugin interface functions */
struct oh_plugin *oh_get_plugin(char *plugin_name);
void oh_release_plugin(struct oh_plugin *plugin);
int oh_getnext_plugin_name(char *plugin_name,
char *next_plugin_name,
unsigned int size);
int oh_load_plugin(char *plugin_name);
int oh_unload_plugin(char *plugin_name);
/* Handler (plugin instances) interface functions */
struct oh_handler *oh_get_handler(unsigned int hid);
void oh_release_handler(struct oh_handler *handler);
int oh_getnext_handler_id(unsigned int hid, unsigned int *next_hid);
SaErrorT oh_create_handler(GHashTable *handler_config, unsigned int *hid);
int oh_destroy_handler(unsigned int hid);
SaErrorT oh_get_handler_info(unsigned int hid, oHpiHandlerInfoT *info, GHashTable *conf_params);
SaErrorT oh_discovery(void);
/* Bind abi functions into plugin */
int oh_load_plugin_functions(struct oh_plugin *plugin, struct oh_abi_v2 **abi);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /*__OH_PLUGIN_H*/
|
