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 #define VMPS_SPACE "vmps"
35 typedef struct indexed_modcallable {
39 modcallable *modulelist;
40 } indexed_modcallable;
43 * For each component, keep an ordered list of ones to call.
45 static rbtree_t *components;
47 static rbtree_t *module_tree = NULL;
49 typedef struct section_type_value_t {
53 } section_type_value_t;
57 * Ordered by component
59 static const section_type_value_t section_type_value[RLM_COMPONENT_COUNT] = {
60 { "authenticate", "Auth-Type", PW_AUTH_TYPE },
61 { "authorize", "Autz-Type", PW_AUTZ_TYPE },
62 { "preacct", "Pre-Acct-Type", PW_PRE_ACCT_TYPE },
63 { "accounting", "Acct-Type", PW_ACCT_TYPE },
64 { "session", "Session-Type", PW_SESSION_TYPE },
65 { "pre-proxy", "Pre-Proxy-Type", PW_PRE_PROXY_TYPE },
66 { "post-proxy", "Post-Proxy-Type", PW_POST_PROXY_TYPE },
67 { "post-auth", "Post-Auth-Type", PW_POST_AUTH_TYPE },
70 static void indexed_modcallable_free(void *data)
72 indexed_modcallable *c = data;
74 modcallable_free(&c->modulelist);
78 static int indexed_modcallable_cmp(const void *one, const void *two)
81 const indexed_modcallable *a = one;
82 const indexed_modcallable *b = two;
84 rcode = strcmp(a->space, b->space);
85 if (rcode != 0) return rcode;
87 if (a->comp < b->comp) return -1;
88 if (a->comp > b->comp) return +1;
90 return a->idx - b->idx;
95 * Free a module instance.
97 static void module_instance_free(void *data)
99 module_instance_t *this = data;
101 if (this->entry->module->detach)
102 (this->entry->module->detach)(this->insthandle);
103 #ifdef HAVE_PTHREAD_H
107 * The mutex MIGHT be locked...
108 * we'll check for that later, I guess.
110 pthread_mutex_destroy(this->mutex);
119 * Compare two module entries
121 static int module_entry_cmp(const void *one, const void *two)
123 const module_entry_t *a = one;
124 const module_entry_t *b = two;
126 return strcmp(a->name, b->name);
130 * Free a module entry.
132 static void module_entry_free(void *data)
134 module_entry_t *this = data;
136 lt_dlclose(this->handle); /* ignore any errors */
142 * Remove the module lists.
144 int detach_modules(void)
146 rbtree_free(components);
147 rbtree_free(module_tree);
154 * Find a module on disk or in memory, and link to it.
156 static module_entry_t *linkto_module(const char *module_name,
157 const char *cffilename, int cflineno)
159 module_entry_t myentry;
160 module_entry_t *node;
162 char module_struct[256];
166 strlcpy(myentry.name, module_name, sizeof(myentry.name));
167 node = rbtree_finddata(module_tree, &myentry);
168 if (node) return node;
171 * Keep the handle around so we can dlclose() it.
173 handle = lt_dlopenext(module_name);
174 if (handle == NULL) {
175 radlog(L_ERR|L_CONS, "%s[%d] Failed to link to module '%s':"
176 " %s\n", cffilename, cflineno, module_name, lt_dlerror());
181 * Link to the module's rlm_FOO{} module structure.
183 * The module_name variable has the version number
184 * embedded in it, and we don't want that here.
186 strcpy(module_struct, module_name);
187 p = strrchr(module_struct, '-');
190 DEBUG3(" (Loaded %s, checking if it's valid)", module_name);
193 * libltld MAY core here, if the handle it gives us contains
196 module = lt_dlsym(handle, module_struct);
198 radlog(L_ERR|L_CONS, "%s[%d] Failed linking to "
199 "%s structure in %s: %s\n",
200 cffilename, cflineno,
201 module_name, cffilename, lt_dlerror());
206 * Before doing anything else, check if it's sane.
208 if ((*(const uint32_t *) module) != RLM_MODULE_MAGIC_NUMBER) {
210 radlog(L_ERR|L_CONS, "%s[%d] Invalid version in module '%s'",
211 cffilename, cflineno, module_name);
216 /* make room for the module type */
217 node = rad_malloc(sizeof(*node));
218 memset(node, 0, sizeof(*node));
219 strlcpy(node->name, module_name, sizeof(node->name));
220 node->module = module;
221 node->handle = handle;
223 DEBUG(" Module: Linked to module %s", module_name);
226 * Add the module as "rlm_foo-version" to the configuration
229 if (!rbtree_insert(module_tree, node)) {
230 radlog(L_ERR, "Failed to cache module %s", module_name);
240 * Find a module instance.
242 module_instance_t *find_module_instance(CONF_SECTION *modules,
243 const char *instname)
246 const char *name1, *name2;
247 module_instance_t *node;
248 char module_name[256];
250 if (!modules) return NULL;
253 * Module instances are declared in the modules{} block
254 * and referenced later by their name, which is the
255 * name2 from the config section, or name1 if there was
258 cs = cf_section_sub_find_name2(modules, NULL, instname);
260 radlog(L_ERR|L_CONS, "ERROR: Cannot find a configuration entry for module \"%s\".\n", instname);
265 * If there's already a module instance, return it.
267 node = cf_data_find(cs, "instance");
268 if (node) return node;
270 name1 = cf_section_name1(cs);
271 name2 = cf_section_name2(cs);
274 * Found the configuration entry.
276 node = rad_malloc(sizeof(*node));
277 memset(node, 0, sizeof(*node));
279 node->insthandle = NULL;
282 * Names in the "modules" section aren't prefixed
283 * with "rlm_", so we add it here.
285 snprintf(module_name, sizeof(module_name), "rlm_%s", name1);
287 node->entry = linkto_module(module_name,
288 mainconfig.radiusd_conf,
289 cf_section_lineno(cs));
292 /* linkto_module logs any errors */
296 DEBUG2(" Module: Instantiating %s", instname);
299 * Call the module's instantiation routine.
301 if ((node->entry->module->instantiate) &&
302 ((node->entry->module->instantiate)(cs, &node->insthandle) < 0)) {
304 "%s[%d]: %s: Module instantiation failed.\n",
305 mainconfig.radiusd_conf, cf_section_lineno(cs),
312 * We're done. Fill in the rest of the data structure,
313 * and link it to the module instance list.
315 strlcpy(node->name, instname, sizeof(node->name));
317 #ifdef HAVE_PTHREAD_H
319 * If we're threaded, check if the module is thread-safe.
321 * If it isn't, we create a mutex.
323 if ((node->entry->module->type & RLM_TYPE_THREAD_UNSAFE) != 0) {
324 node->mutex = (pthread_mutex_t *) rad_malloc(sizeof(pthread_mutex_t));
326 * Initialize the mutex.
328 pthread_mutex_init(node->mutex, NULL);
331 * The module is thread-safe. Don't give it a mutex.
337 cf_data_add(cs, "instance", node, module_instance_free);
342 static indexed_modcallable *lookup_by_index(const char *space, int comp,
345 indexed_modcallable myc;
351 return rbtree_finddata(components, &myc);
355 * Create a new sublist.
357 static indexed_modcallable *new_sublist(const char *space, int comp, int idx)
359 indexed_modcallable *c;
361 c = lookup_by_index(space, comp, idx);
363 /* It is an error to try to create a sublist that already
364 * exists. It would almost certainly be caused by accidental
365 * duplication in the config file.
367 * index 0 is the exception, because it is used when we want
368 * to collect _all_ listed modules under a single index by
369 * default, which is currently the case in all components
370 * except authenticate. */
378 c = rad_malloc(sizeof(*c));
379 c->modulelist = NULL;
384 if (!rbtree_insert(components, c)) {
392 static int indexed_modcall(const char *space, int comp, int idx,
396 indexed_modcallable *this;
397 modcallable *list = NULL;
399 this = lookup_by_index(space, comp, idx);
401 if (idx != 0) DEBUG2(" ERROR: Unknown value specified for %s. Cannot perform requested action.",
402 section_type_value[comp].typename);
404 list = this->modulelist;
407 request->component = section_type_value[comp].section;
409 rcode = modcall(comp, list, request);
411 request->module = "<server-core>";
412 request->component = "<server-core>";
417 * Load a sub-module list, as found inside an Auth-Type foo {}
420 static int load_subcomponent_section(modcallable *parent, CONF_SECTION *cs,
422 int comp, const char *filename)
424 indexed_modcallable *subcomp;
427 const char *name2 = cf_section_name2(cs);
429 rad_assert(comp >= RLM_COMPONENT_AUTH);
430 rad_assert(comp <= RLM_COMPONENT_COUNT);
437 "%s[%d]: No name specified for %s block",
438 filename, cf_section_lineno(cs),
439 section_type_value[comp].typename);
446 ml = compile_modgroup(parent, comp, cs, filename);
452 * We must assign a numeric index to this subcomponent.
453 * It is generated and placed in the dictionary by
454 * setup_modules(), when it loads the sections. If it
455 * isn't found, it's a serious error.
457 dval = dict_valbyname(section_type_value[comp].attr, name2);
460 "%s[%d] %s %s Not previously configured",
461 filename, cf_section_lineno(cs),
462 section_type_value[comp].typename, name2);
463 modcallable_free(&ml);
467 subcomp = new_sublist(space, comp, dval->value);
469 modcallable_free(&ml);
473 subcomp->modulelist = ml;
477 static int load_component_section(modcallable *parent, CONF_SECTION *cs,
478 const char *space, int comp,
479 const char *filename)
484 indexed_modcallable *subcomp;
486 const char *visiblename;
489 * Loop over the entries in the named section.
491 for (modref = cf_item_find_next(cs, NULL);
493 modref = cf_item_find_next(cs, modref)) {
494 CONF_PAIR *cp = NULL;
495 CONF_SECTION *scs = NULL;
498 * Look for Auth-Type foo {}, which are special
499 * cases of named sections, and allowable ONLY
502 * i.e. They're not allowed in a "group" or "redundant"
505 if (cf_item_is_section(modref)) {
506 const char *sec_name;
507 scs = cf_itemtosection(modref);
509 sec_name = cf_section_name1(scs);
512 section_type_value[comp].typename) == 0) {
513 if (!load_subcomponent_section(parent, scs,
516 return -1; /* FIXME: memleak? */
522 } else if (cf_item_is_pair(modref)) {
523 cp = cf_itemtopair(modref);
525 continue; /* ignore it */
529 * Try to compile one entry.
531 this = compile_modsingle(parent, comp, modref, filename,
535 "%s[%d] Failed to parse %s section.\n",
536 filename, cf_section_lineno(cs),
537 cf_section_name1(cs));
541 if (comp == RLM_COMPONENT_AUTH) {
543 const char *modrefname = NULL;
547 modrefname = cf_pair_attr(cp);
548 lineno = cf_pair_lineno(cp);
550 modrefname = cf_section_name2(scs);
551 lineno = cf_section_lineno(scs);
554 "%s[%d] Failed to parse %s sub-section.\n",
556 cf_section_name1(scs));
561 dval = dict_valbyname(PW_AUTH_TYPE, modrefname);
564 * It's a section, but nothing we
567 radlog(L_ERR|L_CONS, "%s[%d] Unknown Auth-Type \"%s\" in %s sub-section.",
569 modrefname, section_type_value[comp].section);
574 /* See the comment in new_sublist() for explanation
575 * of the special index 0 */
579 subcomp = new_sublist(space, comp, idx);
580 if (subcomp == NULL) {
581 modcallable_free(&this);
585 /* If subcomp->modulelist is NULL, add_to_modcallable will
587 visiblename = cf_section_name2(cs);
588 if (visiblename == NULL)
589 visiblename = cf_section_name1(cs);
590 add_to_modcallable(&subcomp->modulelist, this,
597 static int load_byspace(CONF_SECTION *cs, const char *space,
602 DEBUG2(" modules {");
605 * Loop over all of the known components, finding their
606 * configuration section, and loading it.
608 for (comp = 0; comp < RLM_COMPONENT_COUNT; ++comp) {
611 if (!do_component[comp]) continue;
613 subcs = cf_section_sub_find(cs,
614 section_type_value[comp].section);
615 if (!subcs) continue;
617 if (cf_item_find_next(subcs, NULL) == NULL) continue;
619 DEBUG2(" Module: Checking %s {...} for more modules to load",
620 section_type_value[comp].section);
622 if (load_component_section(NULL, subcs, space, comp,
623 mainconfig.radiusd_conf) < 0) {
627 } /* loop over components */
635 * Parse the module config sections, and load
636 * and call each module's init() function.
638 * Libtool makes your life a LOT easier, especially with libltdl.
639 * see: http://www.gnu.org/software/libtool/
641 int setup_modules(int reload)
644 CONF_SECTION *cs, *modules;
645 int do_component[RLM_COMPONENT_COUNT];
646 rad_listen_t *listener;
649 * If necessary, initialize libltdl.
653 * Set the default list of preloaded symbols.
654 * This is used to initialize libltdl's list of
657 * i.e. Static modules.
659 LTDL_SET_PRELOADED_SYMBOLS();
661 if (lt_dlinit() != 0) {
662 radlog(L_ERR|L_CONS, "Failed to initialize libraries: %s\n",
668 * Set the search path to ONLY our library directory.
669 * This prevents the modules from being found from
670 * any location on the disk.
672 lt_dlsetsearchpath(radlib_dir);
674 DEBUG2("radiusd: Library search path is %s",
675 lt_dlgetsearchpath());
678 * Set up the internal module struct.
680 module_tree = rbtree_create(module_entry_cmp,
681 module_entry_free, 0);
683 radlog(L_ERR|L_CONS, "Failed to initialize modules\n");
687 rbtree_free(components);
690 components = rbtree_create(indexed_modcallable_cmp,
691 indexed_modcallable_free, 0);
693 radlog(L_ERR|L_CONS, "Failed to initialize components\n");
698 * Figure out which sections to load.
700 memset(do_component, 0, sizeof(do_component));
701 for (listener = mainconfig.listen;
703 listener = listener->next) {
704 switch (listener->type) {
705 case RAD_LISTEN_AUTH:
706 do_component[RLM_COMPONENT_AUTZ] = 1;
707 do_component[RLM_COMPONENT_AUTH] = 1;
708 do_component[RLM_COMPONENT_POST_AUTH] = 1;
709 do_component[RLM_COMPONENT_SESS] = 1;
712 case RAD_LISTEN_DETAIL: /* just like acct */
713 case RAD_LISTEN_ACCT:
714 do_component[RLM_COMPONENT_PREACCT] = 1;
715 do_component[RLM_COMPONENT_ACCT] = 1;
718 case RAD_LISTEN_PROXY:
719 do_component[RLM_COMPONENT_PRE_PROXY] = 1;
720 do_component[RLM_COMPONENT_POST_PROXY] = 1;
724 do_component[RLM_COMPONENT_POST_AUTH] = 1;
729 case RAD_LISTEN_SNMP:
738 for (comp = RLM_COMPONENT_AUTH; comp < RLM_COMPONENT_COUNT; comp++) {
740 * Have the debugging messages all in one place.
742 if (!do_component[comp]) {
743 DEBUG2("modules: Not loading %s{} section",
744 section_type_value[comp].section);
749 * Create any DICT_VALUE's for the types. See
750 * 'doc/configurable_failover' for examples of 'authtype'
751 * used to create new Auth-Type values. In order to
752 * let the user create new names, we've got to look for
753 * those names, and create DICT_VALUE's for them.
755 for (comp = RLM_COMPONENT_AUTH; comp < RLM_COMPONENT_COUNT; comp++) {
760 CONF_SECTION *sub, *next;
764 * Not needed, don't load it.
766 if (!do_component[comp]) {
769 cs = cf_section_find(section_type_value[comp].section);
776 * See if there's a sub-section by that
779 next = cf_subsection_find_next(cs, sub,
780 section_type_value[comp].typename);
784 * If so, look for it to define a new
787 name2 = cf_section_name2(sub);
788 if (!name2) continue;
792 * If the value already exists, don't
795 dval = dict_valbyname(section_type_value[comp].attr,
800 * Find the attribute for the value.
802 dattr = dict_attrbyvalue(section_type_value[comp].attr);
804 radlog(L_ERR, "%s[%d]: No such attribute %s",
805 mainconfig.radiusd_conf,
806 cf_section_lineno(sub),
807 section_type_value[comp].typename);
812 * Create a new unique value with a
813 * meaningless number. You can't look at
814 * it from outside of this code, so it
815 * doesn't matter. The only requirement
816 * is that it's unique.
819 value = lrad_rand() & 0x00ffffff;
820 } while (dict_valbyattr(dattr->attr, value));
822 if (dict_addvalue(name2, dattr->name, value) < 0) {
823 radlog(L_ERR, "%s", librad_errstr);
826 } while (sub != NULL);
829 * Loop over the non-sub-sections, too.
834 * See if there's a conf-pair by that
837 cp = cf_pair_find_next(cs, cp, NULL);
842 * If the value already exists, don't
845 name2 = cf_pair_attr(cp);
846 dval = dict_valbyname(section_type_value[comp].attr,
851 * Find the attribute for the value.
853 dattr = dict_attrbyvalue(section_type_value[comp].attr);
855 radlog(L_ERR, "%s[%d]: No such attribute %s",
856 mainconfig.radiusd_conf,
857 cf_section_lineno(sub),
858 section_type_value[comp].typename);
863 * Finally, create the new attribute.
866 value = lrad_rand() & 0x00ffffff;
867 } while (dict_valbyattr(dattr->attr, value));
868 if (dict_addvalue(name2, dattr->name, value) < 0) {
869 radlog(L_ERR, "%s", librad_errstr);
872 } while (cp != NULL);
873 } /* over the sections which can have redundent sub-sections */
876 * Remember where the modules were stored.
878 modules = cf_section_find("modules");
880 radlog(L_ERR, "Cannot find a \"modules\" section in the configuration file!");
885 * Look for the 'instantiate' section, which tells us
886 * the instantiation order of the modules, and also allows
887 * us to load modules with no authorize/authenticate/etc.
890 cs = cf_section_find("instantiate");
894 module_instance_t *module;
897 DEBUG2(" instantiate {");
900 * Loop over the items in the 'instantiate' section.
902 for (ci=cf_item_find_next(cs, NULL);
904 ci=cf_item_find_next(cs, ci)) {
907 * Skip sections. They'll be handled
908 * later, if they're referenced at all...
910 if (cf_item_is_section(ci)) {
914 cp = cf_itemtopair(ci);
915 name = cf_pair_attr(cp);
916 module = find_module_instance(modules, name);
920 } /* loop over items in the subsection */
923 } /* if there's an 'instantiate' section. */
925 if (load_byspace(mainconfig.config, NULL, do_component) < 0) {
930 * Load by identities, and by vmps.
932 for (listener = mainconfig.listen;
934 listener = listener->next) {
935 if (listener->type == RAD_LISTEN_VQP) {
936 cs = cf_section_find("vmps");
938 radlog(L_ERR, "Listening on vmps socket, but no vmps section");
942 if (cf_item_find_next(cs, NULL) == NULL) {
943 radlog(L_ERR, "Listening on vmps socket, vmps section is empty");
947 DEBUG2(" Module: Checking vmps {...} for more modules to load");
949 if (load_component_section(NULL, cs, VMPS_SPACE,
950 RLM_COMPONENT_POST_AUTH,
951 mainconfig.radiusd_conf) < 0) {
958 if (!listener->identity) continue;
963 cs = cf_section_sub_find_name2(mainconfig.config,
964 "identity", listener->identity);
967 DEBUG2("identity %s {", listener->identity);
968 if (load_byspace(cs, listener->identity, do_component) < 0) {
979 * Call all authorization modules until one returns
980 * somethings else than RLM_MODULE_OK
982 int module_authorize(int autz_type, REQUEST *request)
984 return indexed_modcall(request->listener->identity,
985 RLM_COMPONENT_AUTZ, autz_type, request);
989 * Authenticate a user/password with various methods.
991 int module_authenticate(int auth_type, REQUEST *request)
993 return indexed_modcall(request->listener->identity,
994 RLM_COMPONENT_AUTH, auth_type, request);
998 * Do pre-accounting for ALL configured sessions
1000 int module_preacct(REQUEST *request)
1002 return indexed_modcall(request->listener->identity,
1003 RLM_COMPONENT_PREACCT, 0, request);
1007 * Do accounting for ALL configured sessions
1009 int module_accounting(int acct_type, REQUEST *request)
1011 return indexed_modcall(request->listener->identity,
1012 RLM_COMPONENT_ACCT, acct_type, request);
1016 * See if a user is already logged in.
1018 * Returns: 0 == OK, 1 == double logins, 2 == multilink attempt
1020 int module_checksimul(int sess_type, REQUEST *request, int maxsimul)
1024 if(!request->username)
1027 request->simul_count = 0;
1028 request->simul_max = maxsimul;
1029 request->simul_mpp = 1;
1031 rcode = indexed_modcall(request->listener->identity,
1032 RLM_COMPONENT_SESS, sess_type, request);
1034 if (rcode != RLM_MODULE_OK) {
1035 /* FIXME: Good spot for a *rate-limited* warning to the log */
1039 return (request->simul_count < maxsimul) ? 0 : request->simul_mpp;
1043 * Do pre-proxying for ALL configured sessions
1045 int module_pre_proxy(int type, REQUEST *request)
1047 return indexed_modcall(request->listener->identity,
1048 RLM_COMPONENT_PRE_PROXY, type, request);
1052 * Do post-proxying for ALL configured sessions
1054 int module_post_proxy(int type, REQUEST *request)
1056 return indexed_modcall(request->listener->identity,
1057 RLM_COMPONENT_POST_PROXY, type, request);
1061 * Do post-authentication for ALL configured sessions
1063 int module_post_auth(int postauth_type, REQUEST *request)
1065 return indexed_modcall(request->listener->identity,
1066 RLM_COMPONENT_POST_AUTH, postauth_type, request);
1072 int module_vmps(REQUEST *request)
1074 return indexed_modcall(VMPS_SPACE, RLM_COMPONENT_POST_AUTH, 0,