2 * modules.c Radius module support.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20 * Copyright 2003,2006 The FreeRADIUS server project
21 * Copyright 2000 Alan DeKok <aland@ox.org>
22 * Copyright 2000 Alan Curry <pacman@world.std.com>
25 #include <freeradius-devel/ident.h>
28 #include <freeradius-devel/radiusd.h>
29 #include <freeradius-devel/modpriv.h>
30 #include <freeradius-devel/modcall.h>
31 #include <freeradius-devel/rad_assert.h>
33 extern int check_config;
35 typedef struct indexed_modcallable {
38 modcallable *modulelist;
39 } indexed_modcallable;
41 typedef struct virtual_server_t {
47 struct virtual_server_t *next;
51 * Keep a hash of virtual servers, so that we can reload them.
53 #define VIRTUAL_SERVER_HASH_SIZE (256)
54 static virtual_server_t *virtual_servers[VIRTUAL_SERVER_HASH_SIZE];
56 static rbtree_t *module_tree = NULL;
58 static rbtree_t *instance_tree = NULL;
60 typedef struct section_type_value_t {
64 } section_type_value_t;
66 struct fr_module_hup_t {
67 module_instance_t *mi;
70 fr_module_hup_t *next;
75 * Ordered by component
77 static const section_type_value_t section_type_value[RLM_COMPONENT_COUNT] = {
78 { "authenticate", "Auth-Type", PW_AUTH_TYPE },
79 { "authorize", "Autz-Type", PW_AUTZ_TYPE },
80 { "preacct", "Pre-Acct-Type", PW_PRE_ACCT_TYPE },
81 { "accounting", "Acct-Type", PW_ACCT_TYPE },
82 { "session", "Session-Type", PW_SESSION_TYPE },
83 { "pre-proxy", "Pre-Proxy-Type", PW_PRE_PROXY_TYPE },
84 { "post-proxy", "Post-Proxy-Type", PW_POST_PROXY_TYPE },
85 { "post-auth", "Post-Auth-Type", PW_POST_AUTH_TYPE },
89 #ifdef WITHOUT_LIBLTDL
90 typedef struct lt_dlmodule_t {
96 * Define modules here.
98 extern module_t rlm_pap;
99 extern module_t rlm_chap;
100 extern module_t rlm_eap;
103 * EAP structures are defined elsewhere.
105 typedef struct eap_type_t EAP_TYPE;
108 * And so on for other EAP types.
110 extern EAP_TYPE rlm_eap_md5;
112 static const lt_dlmodule_t lt_dlmodules[] = {
113 { "rlm_pap", &rlm_pap },
114 { "rlm_chap", &rlm_chap },
115 { "rlm_eap", &rlm_eap },
116 { "rlm_eap_md5", &rlm_eap_md5 },
119 * Add other modules here.
126 lt_dlhandle lt_dlopenext(const char *name)
130 for (i = 0; lt_dlmodules[i].name != NULL; i++) {
131 if (strcmp(name, lt_dlmodules[i].name) == 0) {
132 return lt_dlmodules[i].ref;
139 void *lt_dlsym(lt_dlhandle handle, UNUSED const char *symbol)
143 #endif /* WITHOUT_LIBLTDL */
145 static int virtual_server_idx(const char *name)
151 hash = fr_hash_string(name);
153 return hash & (VIRTUAL_SERVER_HASH_SIZE - 1);
156 static void virtual_server_free(virtual_server_t *server)
158 if (server->components) rbtree_free(server->components);
159 server->components = NULL;
164 void virtual_servers_free(time_t when)
167 virtual_server_t **last;
169 for (i = 0; i < VIRTUAL_SERVER_HASH_SIZE; i++) {
170 virtual_server_t *server, *next;
172 last = &virtual_servers[i];
173 for (server = virtual_servers[i];
179 * If we delete it, fix the links so that
180 * we don't orphan anything. Also,
181 * delete it if it's old, AND a newer one
184 * Otherwise, the last pointer gets set to
185 * the one we didn't delete.
188 ((server->created < when) && server->can_free)) {
189 *last = server->next;
190 virtual_server_free(server);
192 last = &(server->next);
198 static void indexed_modcallable_free(void *data)
200 indexed_modcallable *c = data;
202 modcallable_free(&c->modulelist);
206 static int indexed_modcallable_cmp(const void *one, const void *two)
208 const indexed_modcallable *a = one;
209 const indexed_modcallable *b = two;
211 if (a->comp < b->comp) return -1;
212 if (a->comp > b->comp) return +1;
214 return a->idx - b->idx;
219 * Compare two module entries
221 static int module_instance_cmp(const void *one, const void *two)
223 const module_instance_t *a = one;
224 const module_instance_t *b = two;
226 return strcmp(a->name, b->name);
230 static void module_instance_free_old(CONF_SECTION *cs, module_instance_t *node,
233 fr_module_hup_t *mh, **last;
236 * Walk the list, freeing up old instances.
243 * Free only every 60 seconds.
245 if ((when - mh->when) < 60) {
250 cf_section_parse_free(cs, mh->insthandle);
252 if (node->entry->module->detach) {
253 (node->entry->module->detach)(mh->insthandle);
255 free(mh->insthandle);
265 * Free a module instance.
267 static void module_instance_free(void *data)
269 module_instance_t *this = data;
271 module_instance_free_old(this->cs, this, time(NULL) + 100);
273 if (this->entry->module->detach) {
274 (this->entry->module->detach)(this->insthandle);
277 #ifdef HAVE_PTHREAD_H
281 * The mutex MIGHT be locked...
282 * we'll check for that later, I guess.
284 pthread_mutex_destroy(this->mutex);
288 memset(this, 0, sizeof(*this));
294 * Compare two module entries
296 static int module_entry_cmp(const void *one, const void *two)
298 const module_entry_t *a = one;
299 const module_entry_t *b = two;
301 return strcmp(a->name, b->name);
305 * Free a module entry.
307 static void module_entry_free(void *data)
309 module_entry_t *this = data;
311 lt_dlclose(this->handle); /* ignore any errors */
312 memset(this, 0, sizeof(*this));
318 * Remove the module lists.
320 int detach_modules(void)
322 rbtree_free(instance_tree);
323 rbtree_free(module_tree);
332 * Find a module on disk or in memory, and link to it.
334 static module_entry_t *linkto_module(const char *module_name,
337 module_entry_t myentry;
338 module_entry_t *node;
340 char module_struct[256];
342 const module_t *module;
344 strlcpy(myentry.name, module_name, sizeof(myentry.name));
345 node = rbtree_finddata(module_tree, &myentry);
346 if (node) return node;
349 * Keep the handle around so we can dlclose() it.
351 handle = lt_dlopenext(module_name);
352 if (handle == NULL) {
353 cf_log_err(cf_sectiontoitem(cs),
354 "Failed to link to module '%s': %s\n",
355 module_name, lt_dlerror());
360 * Link to the module's rlm_FOO{} module structure.
362 * The module_name variable has the version number
363 * embedded in it, and we don't want that here.
365 strcpy(module_struct, module_name);
366 p = strrchr(module_struct, '-');
369 DEBUG3(" (Loaded %s, checking if it's valid)", module_name);
372 * libltld MAY core here, if the handle it gives us contains
375 module = lt_dlsym(handle, module_struct);
377 cf_log_err(cf_sectiontoitem(cs),
378 "Failed linking to %s structure: %s\n",
379 module_name, lt_dlerror());
384 * Before doing anything else, check if it's sane.
386 if (module->magic != RLM_MODULE_MAGIC_NUMBER) {
388 cf_log_err(cf_sectiontoitem(cs),
389 "Invalid version in module '%s'",
395 /* make room for the module type */
396 node = rad_malloc(sizeof(*node));
397 memset(node, 0, sizeof(*node));
398 strlcpy(node->name, module_name, sizeof(node->name));
399 node->module = module;
400 node->handle = handle;
402 cf_log_module(cs, "Linked to module %s", module_name);
405 * Add the module as "rlm_foo-version" to the configuration
408 if (!rbtree_insert(module_tree, node)) {
409 radlog(L_ERR, "Failed to cache module %s", module_name);
419 * Find a module instance.
421 module_instance_t *find_module_instance(CONF_SECTION *modules,
422 const char *instname, int do_link)
424 int check_config_safe = FALSE;
426 const char *name1, *name2;
427 module_instance_t *node, myNode;
428 char module_name[256];
430 if (!modules) return NULL;
433 * Module instances are declared in the modules{} block
434 * and referenced later by their name, which is the
435 * name2 from the config section, or name1 if there was
438 cs = cf_section_sub_find_name2(modules, NULL, instname);
440 radlog(L_ERR, "ERROR: Cannot find a configuration entry for module \"%s\".\n", instname);
445 * If there's already a module instance, return it.
447 strlcpy(myNode.name, instname, sizeof(myNode.name));
448 node = rbtree_finddata(instance_tree, &myNode);
449 if (node) return node;
451 if (!do_link) return NULL;
453 name1 = cf_section_name1(cs);
454 name2 = cf_section_name2(cs);
457 * Found the configuration entry.
459 node = rad_malloc(sizeof(*node));
460 memset(node, 0, sizeof(*node));
462 node->insthandle = NULL;
466 * Names in the "modules" section aren't prefixed
467 * with "rlm_", so we add it here.
469 snprintf(module_name, sizeof(module_name), "rlm_%s", name1);
471 node->entry = linkto_module(module_name, cs);
474 /* linkto_module logs any errors */
478 if (check_config && (node->entry->module->instantiate) &&
479 (node->entry->module->type & RLM_TYPE_CHECK_CONFIG_SAFE) == 0) {
480 const char *value = NULL;
483 cp = cf_pair_find(cs, "force_check_config");
484 if (cp) value = cf_pair_value(cp);
486 if (value && (strcmp(value, "yes") == 0)) goto print_inst;
488 cf_log_module(cs, "Skipping instantiation of %s", instname);
491 check_config_safe = TRUE;
492 cf_log_module(cs, "Instantiating %s", instname);
496 * Call the module's instantiation routine.
498 if ((node->entry->module->instantiate) &&
499 (!check_config || check_config_safe) &&
500 ((node->entry->module->instantiate)(cs, &node->insthandle) < 0)) {
501 cf_log_err(cf_sectiontoitem(cs),
502 "Instantiation failed for module \"%s\"",
509 * We're done. Fill in the rest of the data structure,
510 * and link it to the module instance list.
512 strlcpy(node->name, instname, sizeof(node->name));
514 #ifdef HAVE_PTHREAD_H
516 * If we're threaded, check if the module is thread-safe.
518 * If it isn't, we create a mutex.
520 if ((node->entry->module->type & RLM_TYPE_THREAD_UNSAFE) != 0) {
521 node->mutex = (pthread_mutex_t *) rad_malloc(sizeof(pthread_mutex_t));
523 * Initialize the mutex.
525 pthread_mutex_init(node->mutex, NULL);
528 * The module is thread-safe. Don't give it a mutex.
534 rbtree_insert(instance_tree, node);
539 static indexed_modcallable *lookup_by_index(rbtree_t *components,
542 indexed_modcallable myc;
547 return rbtree_finddata(components, &myc);
551 * Create a new sublist.
553 static indexed_modcallable *new_sublist(rbtree_t *components, int comp, int idx)
555 indexed_modcallable *c;
557 c = lookup_by_index(components, comp, idx);
559 /* It is an error to try to create a sublist that already
560 * exists. It would almost certainly be caused by accidental
561 * duplication in the config file.
563 * index 0 is the exception, because it is used when we want
564 * to collect _all_ listed modules under a single index by
565 * default, which is currently the case in all components
566 * except authenticate. */
574 c = rad_malloc(sizeof(*c));
575 c->modulelist = NULL;
579 if (!rbtree_insert(components, c)) {
587 int indexed_modcall(int comp, int idx, REQUEST *request)
590 indexed_modcallable *this;
591 modcallable *list = NULL;
592 virtual_server_t *server;
594 rcode = virtual_server_idx(request->server);
595 for (server = virtual_servers[rcode];
597 server = server->next) {
598 if (!request->server && !server->name) break;
600 if ((request->server && server->name) &&
601 (strcmp(request->server, server->name) == 0)) break;
605 RDEBUG("No such virtual server %s", request->server);
606 return RLM_MODULE_FAIL;
609 this = lookup_by_index(server->components, comp, idx);
611 if (idx != 0) DEBUG2(" WARNING: Unknown value specified for %s. Cannot perform requested action.",
612 section_type_value[comp].typename);
614 list = this->modulelist;
617 request->component = section_type_value[comp].section;
619 rcode = modcall(comp, list, request);
621 request->module = "";
622 request->component = "";
627 * Load a sub-module list, as found inside an Auth-Type foo {}
630 static int load_subcomponent_section(modcallable *parent, CONF_SECTION *cs,
631 rbtree_t *components, int attr, int comp)
633 indexed_modcallable *subcomp;
636 const char *name2 = cf_section_name2(cs);
638 rad_assert(comp >= RLM_COMPONENT_AUTH);
639 rad_assert(comp < RLM_COMPONENT_COUNT);
645 cf_log_err(cf_sectiontoitem(cs),
646 "No name specified for %s block",
647 section_type_value[comp].typename);
654 ml = compile_modgroup(parent, comp, cs);
660 * We must assign a numeric index to this subcomponent.
661 * It is generated and placed in the dictionary
662 * automatically. If it isn't found, it's a serious
665 dval = dict_valbyname(attr, name2);
667 cf_log_err(cf_sectiontoitem(cs),
668 "%s %s Not previously configured",
669 section_type_value[comp].typename, name2);
670 modcallable_free(&ml);
674 subcomp = new_sublist(components, comp, dval->value);
676 modcallable_free(&ml);
680 subcomp->modulelist = ml;
684 static int define_type(const DICT_ATTR *dattr, const char *name)
690 * If the value already exists, don't
693 dval = dict_valbyname(dattr->attr, name);
697 * Create a new unique value with a
698 * meaningless number. You can't look at
699 * it from outside of this code, so it
700 * doesn't matter. The only requirement
701 * is that it's unique.
704 value = fr_rand() & 0x00ffffff;
705 } while (dict_valbyattr(dattr->attr, value));
707 if (dict_addvalue(name, dattr->name, value) < 0) {
708 radlog(L_ERR, "%s", fr_strerror());
715 static int load_component_section(CONF_SECTION *cs,
716 rbtree_t *components, int comp)
721 indexed_modcallable *subcomp;
723 const char *visiblename;
724 const DICT_ATTR *dattr;
727 * Find the attribute used to store VALUEs for this section.
729 dattr = dict_attrbyvalue(section_type_value[comp].attr);
731 cf_log_err(cf_sectiontoitem(cs),
732 "No such attribute %s",
733 section_type_value[comp].typename);
738 * Loop over the entries in the named section, loading
739 * the sections this time.
741 for (modref = cf_item_find_next(cs, NULL);
743 modref = cf_item_find_next(cs, modref)) {
745 CONF_PAIR *cp = NULL;
746 CONF_SECTION *scs = NULL;
748 if (cf_item_is_section(modref)) {
749 scs = cf_itemtosection(modref);
751 name1 = cf_section_name1(scs);
754 section_type_value[comp].typename) == 0) {
755 if (!load_subcomponent_section(NULL, scs,
759 return -1; /* FIXME: memleak? */
766 } else if (cf_item_is_pair(modref)) {
767 cp = cf_itemtopair(modref);
770 continue; /* ignore it */
774 * Try to compile one entry.
776 this = compile_modsingle(NULL, comp, modref, &modname);
778 cf_log_err(cf_sectiontoitem(cs),
779 "Errors parsing %s section.\n",
780 cf_section_name1(cs));
785 * Look for Auth-Type foo {}, which are special
786 * cases of named sections, and allowable ONLY
789 * i.e. They're not allowed in a "group" or "redundant"
792 if (comp == RLM_COMPONENT_AUTH) {
794 const char *modrefname = NULL;
796 modrefname = cf_pair_attr(cp);
798 modrefname = cf_section_name2(scs);
800 modcallable_free(&this);
801 cf_log_err(cf_sectiontoitem(cs),
802 "Errors parsing %s sub-section.\n",
803 cf_section_name1(scs));
808 dval = dict_valbyname(PW_AUTH_TYPE, modrefname);
811 * It's a section, but nothing we
814 modcallable_free(&this);
815 cf_log_err(cf_sectiontoitem(cs),
816 "Unknown Auth-Type \"%s\" in %s sub-section.",
817 modrefname, section_type_value[comp].section);
822 /* See the comment in new_sublist() for explanation
823 * of the special index 0 */
827 subcomp = new_sublist(components, comp, idx);
828 if (subcomp == NULL) {
829 modcallable_free(&this);
833 /* If subcomp->modulelist is NULL, add_to_modcallable will
835 visiblename = cf_section_name2(cs);
836 if (visiblename == NULL)
837 visiblename = cf_section_name1(cs);
838 add_to_modcallable(&subcomp->modulelist, this,
845 static int load_byserver(CONF_SECTION *cs)
848 const char *name = cf_section_name2(cs);
849 rbtree_t *components;
850 virtual_server_t *server;
852 cf_log_info(cs, " modules {");
854 components = rbtree_create(indexed_modcallable_cmp,
855 indexed_modcallable_free, 0);
857 radlog(L_ERR, "Failed to initialize components\n");
861 server = rad_malloc(sizeof(*server));
862 memset(server, 0, sizeof(*server));
865 server->created = time(NULL);
867 server->components = components;
870 * Define types first.
872 for (comp = 0; comp < RLM_COMPONENT_COUNT; ++comp) {
877 subcs = cf_section_sub_find(cs,
878 section_type_value[comp].section);
879 if (!subcs) continue;
881 if (cf_item_find_next(subcs, NULL) == NULL) continue;
884 * Find the attribute used to store VALUEs for this section.
886 dattr = dict_attrbyvalue(section_type_value[comp].attr);
888 cf_log_err(cf_sectiontoitem(subcs),
889 "No such attribute %s",
890 section_type_value[comp].typename);
891 cf_log_info(cs, " }");
893 virtual_server_free(server);
898 * Define dynamic types, so that others can reference
901 for (modref = cf_item_find_next(subcs, NULL);
903 modref = cf_item_find_next(subcs, modref)) {
905 CONF_SECTION *subsubcs;
908 * Create types for simple references
909 * only when parsing the authenticate
912 if ((section_type_value[comp].attr == PW_AUTH_TYPE) &&
913 cf_item_is_pair(modref)) {
914 CONF_PAIR *cp = cf_itemtopair(modref);
915 if (!define_type(dattr, cf_pair_attr(cp))) {
922 if (!cf_item_is_section(modref)) continue;
924 subsubcs = cf_itemtosection(modref);
925 name1 = cf_section_name1(subsubcs);
927 if (strcmp(name1, section_type_value[comp].typename) == 0) {
928 if (!define_type(dattr,
929 cf_section_name2(subsubcs))) {
930 cf_log_info(cs, " }");
935 } /* loop over components */
938 * Loop over all of the known components, finding their
939 * configuration section, and loading it.
942 for (comp = 0; comp < RLM_COMPONENT_COUNT; ++comp) {
945 subcs = cf_section_sub_find(cs,
946 section_type_value[comp].section);
947 if (!subcs) continue;
949 if (cf_item_find_next(subcs, NULL) == NULL) continue;
951 cf_log_module(cs, "Checking %s {...} for more modules to load",
952 section_type_value[comp].section);
956 * Skip pre/post-proxy sections if we're not
959 if (!mainconfig.proxy_requests &&
960 ((comp == PW_PRE_PROXY_TYPE) ||
961 (comp == PW_PRE_PROXY_TYPE))) {
966 if (load_component_section(subcs, components, comp) < 0) {
967 cf_log_info(cs, " }");
971 } /* loop over components */
974 * We haven't loaded any of the normal sections. Maybe we're
975 * supposed to load the vmps section.
977 * This is a bit of a hack...
982 subcs = cf_section_sub_find(cs, "vmps");
984 cf_log_module(cs, "Checking vmps {...} for more modules to load");
985 if (load_component_section(subcs, components,
986 RLM_COMPONENT_POST_AUTH) < 0) {
994 const DICT_ATTR *dattr;
996 dattr = dict_attrbyname("DHCP-Message-Type");
998 radlog(L_ERR, "No DHCP-Message-Type attribute");
1003 * Handle each DHCP Message type separately.
1005 for (subcs = cf_subsection_find_next(cs, NULL,
1008 subcs = cf_subsection_find_next(cs, subcs,
1010 const char *name2 = cf_section_name2(subcs);
1012 DEBUG2(" Module: Checking dhcp %s {...} for more modules to load", name2);
1013 if (!load_subcomponent_section(NULL, subcs,
1016 RLM_COMPONENT_POST_AUTH)) {
1017 goto error; /* FIXME: memleak? */
1025 cf_log_info(cs, " }");
1027 if (!flag && name) {
1028 DEBUG("WARNING: Server %s is empty, and will do nothing!",
1033 * Now that it is OK, insert it into the list.
1035 * This is thread-safe...
1037 comp = virtual_server_idx(name);
1038 server->next = virtual_servers[comp];
1039 virtual_servers[comp] = server;
1042 * Mark OLDER ones of the same name as being unused.
1044 server = server->next;
1046 if (strcmp(server->name, name) == 0) {
1047 server->can_free = TRUE;
1050 server = server->next;
1058 * Load all of the virtual servers.
1060 int virtual_servers_load(CONF_SECTION *config)
1062 int null_server = FALSE;
1065 DEBUG2("%s: #### Loading Virtual Servers ####", mainconfig.name);
1068 * Load all of the virtual servers.
1070 for (cs = cf_subsection_find_next(config, NULL, "server");
1072 cs = cf_subsection_find_next(config, cs, "server")) {
1073 const char *name2 = cf_section_name2(cs);
1076 cf_log_info(cs, "server %s {", name2);
1078 cf_log_info(cs, "server {");
1081 if (load_byserver(cs) < 0) {
1082 cf_log_info(cs, "}");
1085 cf_log_info(cs, "}");
1086 if (debug_flag == 0) {
1087 radlog(L_INFO, "Loaded virtual server %s", name2);
1092 * No empty server defined. Try to load an old-style
1093 * one for backwards compatibility.
1096 cf_log_info(cs, "server {");
1097 if (load_byserver(config) < 0) {
1098 cf_log_info(cs, "}");
1101 cf_log_info(cs, "}");
1107 int module_hup_module(CONF_SECTION *cs, module_instance_t *node, time_t when)
1109 void *insthandle = NULL;
1110 fr_module_hup_t *mh;
1113 !node->entry->module->instantiate ||
1114 ((node->entry->module->type & RLM_TYPE_HUP_SAFE) == 0)) {
1118 cf_log_module(cs, "Trying to reload module \"%s\"", node->name);
1120 if ((node->entry->module->instantiate)(cs, &insthandle) < 0) {
1121 cf_log_err(cf_sectiontoitem(cs),
1122 "HUP failed for module \"%s\". Using old configuration.",
1127 radlog(L_INFO, " Module: Reloaded module \"%s\"", node->name);
1129 module_instance_free_old(cs, node, when);
1132 * Save the old instance handle for later deletion.
1134 mh = rad_malloc(sizeof(*mh));
1137 mh->insthandle = node->insthandle;
1138 mh->next = node->mh;
1141 node->insthandle = insthandle;
1144 * FIXME: Set a timeout to come back in 60s, so that
1145 * we can pro-actively clean up the old instances.
1152 int module_hup(CONF_SECTION *modules)
1157 module_instance_t *node;
1159 if (!modules) return 0;
1164 * Loop over the modules
1166 for (ci=cf_item_find_next(modules, NULL);
1168 ci=cf_item_find_next(modules, ci)) {
1169 const char *instname;
1170 module_instance_t myNode;
1173 * If it's not a section, ignore it.
1175 if (!cf_item_is_section(ci)) continue;
1177 cs = cf_itemtosection(ci);
1178 instname = cf_section_name2(cs);
1179 if (!instname) instname = cf_section_name1(cs);
1181 strlcpy(myNode.name, instname, sizeof(myNode.name));
1182 node = rbtree_finddata(instance_tree, &myNode);
1184 module_hup_module(cs, node, when);
1192 * Parse the module config sections, and load
1193 * and call each module's init() function.
1195 * Libtool makes your life a LOT easier, especially with libltdl.
1196 * see: http://www.gnu.org/software/libtool/
1198 int setup_modules(int reload, CONF_SECTION *config)
1200 CONF_SECTION *cs, *modules;
1201 rad_listen_t *listener;
1203 if (reload) return 0;
1206 * If necessary, initialize libltdl.
1210 * Set the default list of preloaded symbols.
1211 * This is used to initialize libltdl's list of
1212 * preloaded modules.
1214 * i.e. Static modules.
1216 LTDL_SET_PRELOADED_SYMBOLS();
1218 if (lt_dlinit() != 0) {
1219 radlog(L_ERR, "Failed to initialize libraries: %s\n",
1225 * Set the search path to ONLY our library directory.
1226 * This prevents the modules from being found from
1227 * any location on the disk.
1229 lt_dlsetsearchpath(radlib_dir);
1232 * Set up the internal module struct.
1234 module_tree = rbtree_create(module_entry_cmp,
1235 module_entry_free, 0);
1237 radlog(L_ERR, "Failed to initialize modules\n");
1241 instance_tree = rbtree_create(module_instance_cmp,
1242 module_instance_free, 0);
1243 if (!instance_tree) {
1244 radlog(L_ERR, "Failed to initialize modules\n");
1249 memset(virtual_servers, 0, sizeof(virtual_servers));
1252 * Remember where the modules were stored.
1254 modules = cf_section_sub_find(config, "modules");
1256 radlog(L_ERR, "Cannot find a \"modules\" section in the configuration file!");
1260 DEBUG2("%s: #### Instantiating modules ####", mainconfig.name);
1263 * Look for the 'instantiate' section, which tells us
1264 * the instantiation order of the modules, and also allows
1265 * us to load modules with no authorize/authenticate/etc.
1268 cs = cf_section_sub_find(config, "instantiate");
1272 module_instance_t *module;
1275 cf_log_info(cs, " instantiate {");
1278 * Loop over the items in the 'instantiate' section.
1280 for (ci=cf_item_find_next(cs, NULL);
1282 ci=cf_item_find_next(cs, ci)) {
1285 * Skip sections and "other" stuff.
1286 * Sections will be handled later, if
1287 * they're referenced at all...
1289 if (!cf_item_is_pair(ci)) {
1293 cp = cf_itemtopair(ci);
1294 name = cf_pair_attr(cp);
1295 module = find_module_instance(modules, name, 1);
1299 } /* loop over items in the subsection */
1301 cf_log_info(cs, " }");
1302 } /* if there's an 'instantiate' section. */
1305 * Loop over the listeners, figuring out which sections
1308 for (listener = mainconfig.listen;
1310 listener = listener->next) {
1313 if (listener->type == RAD_LISTEN_PROXY) continue;
1315 cs = cf_section_sub_find_name2(config,
1316 "server", listener->server);
1317 if (!cs && (listener->server != NULL)) {
1318 listener->print(listener, buffer, sizeof(buffer));
1320 radlog(L_ERR, "No server has been defined for %s", buffer);
1325 if (virtual_servers_load(config) < 0) return -1;
1331 * Call all authorization modules until one returns
1332 * somethings else than RLM_MODULE_OK
1334 int module_authorize(int autz_type, REQUEST *request)
1336 return indexed_modcall(RLM_COMPONENT_AUTZ, autz_type, request);
1340 * Authenticate a user/password with various methods.
1342 int module_authenticate(int auth_type, REQUEST *request)
1344 return indexed_modcall(RLM_COMPONENT_AUTH, auth_type, request);
1347 #ifdef WITH_ACCOUNTING
1349 * Do pre-accounting for ALL configured sessions
1351 int module_preacct(REQUEST *request)
1353 return indexed_modcall(RLM_COMPONENT_PREACCT, 0, request);
1357 * Do accounting for ALL configured sessions
1359 int module_accounting(int acct_type, REQUEST *request)
1361 return indexed_modcall(RLM_COMPONENT_ACCT, acct_type, request);
1365 #ifdef WITH_SESSION_MGMT
1367 * See if a user is already logged in.
1369 * Returns: 0 == OK, 1 == double logins, 2 == multilink attempt
1371 int module_checksimul(int sess_type, REQUEST *request, int maxsimul)
1375 if(!request->username)
1378 request->simul_count = 0;
1379 request->simul_max = maxsimul;
1380 request->simul_mpp = 1;
1382 rcode = indexed_modcall(RLM_COMPONENT_SESS, sess_type, request);
1384 if (rcode != RLM_MODULE_OK) {
1385 /* FIXME: Good spot for a *rate-limited* warning to the log */
1389 return (request->simul_count < maxsimul) ? 0 : request->simul_mpp;
1395 * Do pre-proxying for ALL configured sessions
1397 int module_pre_proxy(int type, REQUEST *request)
1399 return indexed_modcall(RLM_COMPONENT_PRE_PROXY, type, request);
1403 * Do post-proxying for ALL configured sessions
1405 int module_post_proxy(int type, REQUEST *request)
1407 return indexed_modcall(RLM_COMPONENT_POST_PROXY, type, request);
1412 * Do post-authentication for ALL configured sessions
1414 int module_post_auth(int postauth_type, REQUEST *request)
1416 return indexed_modcall(RLM_COMPONENT_POST_AUTH, postauth_type, request);