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;
125 MODULE_INIT_FN initialize;
129 #define file file_name
132 module = module_handle( file_name );
134 Debug( LDAP_DEBUG_ANY, "module_load: (%s) already loaded\n",
139 module = (module_loaded_t *)ch_calloc(1, sizeof(module_loaded_t) +
141 if (module == NULL) {
142 Debug(LDAP_DEBUG_ANY, "module_load failed: (%s) out of memory\n", file_name,
147 strcpy( module->name, file_name );
150 strcpy( file, file_name );
154 * The result of lt_dlerror(), when called, must be cached prior
155 * to calling Debug. This is because Debug is a macro that expands
156 * into multiple function calls.
158 if ((module->lib = lt_dlopenext(file)) == NULL) {
159 error = lt_dlerror();
161 strcpy( ebuf, error );
165 Debug(LDAP_DEBUG_ANY, "lt_dlopenext failed: (%s) %s\n", file_name,
172 Debug(LDAP_DEBUG_CONFIG, "loaded module %s\n", file_name, 0, 0);
176 #pragma convlit(suspend)
178 if ((initialize = lt_dlsym(module->lib, "init_module")) == NULL) {
180 #pragma convlit(resume)
182 Debug(LDAP_DEBUG_CONFIG, "module %s: no init_module() function found\n",
185 lt_dlclose(module->lib);
190 /* The imported init_module() routine passes back the type of
191 * module (i.e., which part of slapd it should be hooked into)
192 * or -1 for error. If it passes back 0, then you get the
193 * old behavior (i.e., the library is loaded and not hooked
196 * It might be better if the conf file could specify the type
197 * of module. That way, a single module could support multiple
198 * type of hooks. This could be done by using something like:
200 * moduleload extension /usr/local/openldap/whatever.so
202 * then we'd search through module_regtable for a matching
203 * module type, and hook in there.
205 rc = initialize(argc, argv);
207 Debug(LDAP_DEBUG_CONFIG, "module %s: init_module() failed\n",
210 lt_dlclose(module->lib);
215 if (rc >= (int)(sizeof(module_regtable) / sizeof(struct module_regtable_t))
216 || module_regtable[rc].proc == NULL)
218 Debug(LDAP_DEBUG_CONFIG, "module %s: unknown registration type (%d)\n",
221 module_int_unload(module);
225 rc = (module_regtable[rc].proc)(module, file_name);
227 Debug(LDAP_DEBUG_CONFIG, "module %s: %s module could not be registered\n",
228 file_name, module_regtable[rc].type, 0);
230 module_int_unload(module);
234 module->next = module_list;
235 module_list = module;
237 Debug(LDAP_DEBUG_CONFIG, "module %s: %s module registered\n",
238 file_name, module_regtable[rc].type, 0);
243 int module_path(const char *path)
250 return lt_dlsetsearchpath( path );
253 void *module_resolve (const void *module, const char *name)
260 if (module == NULL || name == NULL)
262 return(lt_dlsym(((module_loaded_t *)module)->lib, name));
265 static int module_int_unload (module_loaded_t *module)
267 module_loaded_t *mod;
268 MODULE_TERM_FN terminate;
270 if (module != NULL) {
271 /* remove module from tracking list */
272 if (module_list == module) {
273 module_list = module->next;
275 for (mod = module_list; mod; mod = mod->next) {
276 if (mod->next == module) {
277 mod->next = module->next;
283 /* call module's terminate routine, if present */
285 #pragma convlit(suspend)
287 if ((terminate = lt_dlsym(module->lib, "term_module"))) {
289 #pragma convlit(resume)
294 /* close the library and free the memory */
295 lt_dlclose(module->lib);
301 int load_null_module (const void *module, const char *file_name)
306 #ifdef SLAPD_EXTERNAL_EXTENSIONS
310 const char *file_name
313 SLAP_EXTOP_MAIN_FN *ext_main;
314 SLAP_EXTOP_GETOID_FN *ext_getoid;
318 ext_main = (SLAP_EXTOP_MAIN_FN *)module_resolve(module, "ext_main");
319 if (ext_main == NULL) {
323 ext_getoid = module_resolve(module, "ext_getoid");
324 if (ext_getoid == NULL) {
328 rc = (ext_getoid)(0, &oid, 256);
332 if (oid.bv_val == NULL || oid.bv_len == 0) {
336 /* FIXME: this is broken, and no longer needed,
337 * as a module can call load_extop() itself... */
338 rc = load_extop( &oid, ext_main );
341 #endif /* SLAPD_EXTERNAL_EXTENSIONS */
342 #endif /* SLAPD_MODULES */