2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2009 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in the file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
24 typedef int (*MODULE_INIT_FN)(
27 typedef int (*MODULE_LOAD_FN)(
29 const char *filename);
30 typedef int (*MODULE_TERM_FN)(void);
33 struct module_regtable_t {
36 } module_regtable[] = {
37 { "null", load_null_module },
38 #ifdef SLAPD_EXTERNAL_EXTENSIONS
39 { "extension", load_extop_module },
44 typedef struct module_loaded_t {
45 struct module_loaded_t *next;
50 module_loaded_t *module_list = NULL;
52 static int module_int_unload (module_loaded_t *module);
55 static char ebuf[BUFSIZ];
58 int module_init (void)
61 const char *error = lt_dlerror();
63 strcpy( ebuf, error );
67 Debug(LDAP_DEBUG_ANY, "lt_dlinit failed: %s\n", error, 0, 0);
72 return module_path( LDAP_MODULEDIR );
75 int module_kill (void)
77 /* unload all modules before shutdown */
78 while (module_list != NULL) {
79 module_int_unload(module_list);
83 const char *error = lt_dlerror();
85 strcpy( ebuf, error );
89 Debug(LDAP_DEBUG_ANY, "lt_dlexit failed: %s\n", error, 0, 0);
96 void * module_handle( const char *file_name )
98 module_loaded_t *module;
100 for ( module = module_list; module; module= module->next ) {
101 if ( !strcmp( module->name, file_name )) {
108 int module_unload( const char *file_name )
110 module_loaded_t *module;
112 module = module_handle( file_name );
114 module_int_unload( module );
117 return -1; /* not found */
120 int module_load(const char* file_name, int argc, char *argv[])
122 module_loaded_t *module = NULL;
125 MODULE_INIT_FN initialize;
129 #define file file_name
132 module = (module_loaded_t *)ch_calloc(1, sizeof(module_loaded_t) +
134 if (module == NULL) {
135 Debug(LDAP_DEBUG_ANY, "module_load failed: (%s) out of memory\n", file_name,
140 strcpy( module->name, file_name );
143 strcpy( file, file_name );
147 * The result of lt_dlerror(), when called, must be cached prior
148 * to calling Debug. This is because Debug is a macro that expands
149 * into multiple function calls.
151 if ((module->lib = lt_dlopenext(file)) == NULL) {
152 error = lt_dlerror();
154 strcpy( ebuf, error );
158 Debug(LDAP_DEBUG_ANY, "lt_dlopenext failed: (%s) %s\n", file_name,
165 Debug(LDAP_DEBUG_CONFIG, "loaded module %s\n", file_name, 0, 0);
169 #pragma convlit(suspend)
171 if ((initialize = lt_dlsym(module->lib, "init_module")) == NULL) {
173 #pragma convlit(resume)
175 Debug(LDAP_DEBUG_CONFIG, "module %s: no init_module() function found\n",
178 lt_dlclose(module->lib);
183 /* The imported init_module() routine passes back the type of
184 * module (i.e., which part of slapd it should be hooked into)
185 * or -1 for error. If it passes back 0, then you get the
186 * old behavior (i.e., the library is loaded and not hooked
189 * It might be better if the conf file could specify the type
190 * of module. That way, a single module could support multiple
191 * type of hooks. This could be done by using something like:
193 * moduleload extension /usr/local/openldap/whatever.so
195 * then we'd search through module_regtable for a matching
196 * module type, and hook in there.
198 rc = initialize(argc, argv);
200 Debug(LDAP_DEBUG_CONFIG, "module %s: init_module() failed\n",
203 lt_dlclose(module->lib);
208 if (rc >= (int)(sizeof(module_regtable) / sizeof(struct module_regtable_t))
209 || module_regtable[rc].proc == NULL)
211 Debug(LDAP_DEBUG_CONFIG, "module %s: unknown registration type (%d)\n",
214 module_int_unload(module);
218 rc = (module_regtable[rc].proc)(module, file_name);
220 Debug(LDAP_DEBUG_CONFIG, "module %s: %s module could not be registered\n",
221 file_name, module_regtable[rc].type, 0);
223 module_int_unload(module);
227 module->next = module_list;
228 module_list = module;
230 Debug(LDAP_DEBUG_CONFIG, "module %s: %s module registered\n",
231 file_name, module_regtable[rc].type, 0);
236 int module_path(const char *path)
243 return lt_dlsetsearchpath( path );
246 void *module_resolve (const void *module, const char *name)
253 if (module == NULL || name == NULL)
255 return(lt_dlsym(((module_loaded_t *)module)->lib, name));
258 static int module_int_unload (module_loaded_t *module)
260 module_loaded_t *mod;
261 MODULE_TERM_FN terminate;
263 if (module != NULL) {
264 /* remove module from tracking list */
265 if (module_list == module) {
266 module_list = module->next;
268 for (mod = module_list; mod; mod = mod->next) {
269 if (mod->next == module) {
270 mod->next = module->next;
276 /* call module's terminate routine, if present */
278 #pragma convlit(suspend)
280 if ((terminate = lt_dlsym(module->lib, "term_module"))) {
282 #pragma convlit(resume)
287 /* close the library and free the memory */
288 lt_dlclose(module->lib);
294 int load_null_module (const void *module, const char *file_name)
299 #ifdef SLAPD_EXTERNAL_EXTENSIONS
303 const char *file_name
306 SLAP_EXTOP_MAIN_FN *ext_main;
307 SLAP_EXTOP_GETOID_FN *ext_getoid;
311 ext_main = (SLAP_EXTOP_MAIN_FN *)module_resolve(module, "ext_main");
312 if (ext_main == NULL) {
316 ext_getoid = module_resolve(module, "ext_getoid");
317 if (ext_getoid == NULL) {
321 rc = (ext_getoid)(0, &oid, 256);
325 if (oid.bv_val == NULL || oid.bv_len == 0) {
329 /* FIXME: this is broken, and no longer needed,
330 * as a module can call load_extop() itself... */
331 rc = load_extop( &oid, ext_main );
334 #endif /* SLAPD_EXTERNAL_EXTENSIONS */
335 #endif /* SLAPD_MODULES */