2 * This program is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License as published by
4 * the Free Software Foundation; either version 2 of the License, or
5 * (at your option) any later version.
7 * This program is distributed in the hope that it will be useful,
8 * but WITHOUT ANY WARRANTY; without even the implied warranty of
9 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10 * GNU General Public License for more details.
12 * You should have received a copy of the GNU General Public License
13 * along with this program; if not, write to the Free Software
14 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 * @brief String expansion ("translation"). Implements %Attribute -> value
23 * @copyright 2000,2006 The FreeRADIUS server project
24 * @copyright 2000 Alan DeKok <aland@ox.org>
29 #include <freeradius-devel/radiusd.h>
30 #include <freeradius-devel/parser.h>
31 #include <freeradius-devel/rad_assert.h>
32 #include <freeradius-devel/base64.h>
36 typedef struct xlat_t {
37 char name[MAX_STRING_LEN]; //!< Name of the xlat expansion.
38 int length; //!< Length of name.
39 void *instance; //!< Module instance passed to xlat and escape functions.
40 xlat_func_t func; //!< xlat function.
41 xlat_escape_t escape; //!< Escape function to apply to dynamic input to func.
42 bool internal; //!< If true, cannot be redefined.
46 XLAT_LITERAL, //!< Literal string
47 XLAT_PERCENT, //!< Literal string with %v
48 XLAT_MODULE, //!< xlat module
49 XLAT_VIRTUAL, //!< virtual attribute
50 XLAT_ATTRIBUTE, //!< xlat attribute
52 XLAT_REGEX, //!< regex reference
54 XLAT_ALTERNATE //!< xlat conditional syntax :-
58 char const *fmt; //!< The format string.
59 size_t len; //!< Length of the format string.
61 xlat_state_t type; //!< type of this expansion.
62 xlat_exp_t *next; //!< Next in the list.
64 xlat_exp_t *child; //!< Nested expansion.
65 xlat_exp_t *alternate; //!< Alternative expansion if this one expanded to a zero length string.
67 vp_tmpl_t attr; //!< An attribute template.
68 xlat_t const *xlat; //!< The xlat expansion to expand format with.
71 typedef struct xlat_out {
72 char const *out; //!< Output data.
73 size_t len; //!< Length of the output string.
76 static rbtree_t *xlat_root = NULL;
79 static char const * const xlat_foreach_names[] = {"Foreach-Variable-0",
93 static int xlat_inst[] = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; /* up to 10 for foreach */
95 /** Print length of its RHS.
98 static ssize_t xlat_strlen(UNUSED void *instance, UNUSED REQUEST *request,
99 char const *fmt, char *out, size_t outlen)
101 snprintf(out, outlen, "%u", (unsigned int) strlen(fmt));
105 /** Print the size of the attribute in bytes.
108 static ssize_t xlat_length(UNUSED void *instance, REQUEST *request,
109 char const *fmt, char *out, size_t outlen)
112 while (isspace((int) *fmt)) fmt++;
114 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
119 snprintf(out, outlen, "%zu", vp->vp_length);
123 /** Print data as integer, not as VALUE.
126 static ssize_t xlat_integer(UNUSED void *instance, REQUEST *request,
127 char const *fmt, char *out, size_t outlen)
131 uint64_t int64 = 0; /* Needs to be initialised to zero */
132 uint32_t int32 = 0; /* Needs to be initialised to zero */
134 while (isspace((int) *fmt)) fmt++;
136 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
141 switch (vp->da->type) {
144 if (vp->vp_length > 8) {
148 if (vp->vp_length > 4) {
149 memcpy(&int64, vp->vp_octets, vp->vp_length);
150 return snprintf(out, outlen, "%" PRIu64, htonll(int64));
153 memcpy(&int32, vp->vp_octets, vp->vp_length);
154 return snprintf(out, outlen, "%i", htonl(int32));
156 case PW_TYPE_INTEGER64:
157 return snprintf(out, outlen, "%" PRIu64, vp->vp_integer64);
160 * IP addresses are treated specially, as parsing functions assume the value
161 * is bigendian and will convert it for us.
163 case PW_TYPE_IPV4_ADDR:
164 return snprintf(out, outlen, "%u", htonl(vp->vp_ipaddr));
166 case PW_TYPE_IPV4_PREFIX:
167 return snprintf(out, outlen, "%u", htonl((*(uint32_t *)(vp->vp_ipv4prefix + 2))));
169 case PW_TYPE_INTEGER:
171 return snprintf(out, outlen, "%u", vp->vp_integer);
173 return snprintf(out, outlen, "%u", (unsigned int) vp->vp_byte);
175 return snprintf(out, outlen, "%u", (unsigned int) vp->vp_short);
178 * Ethernet is weird... It's network related, so we assume to it should be
181 case PW_TYPE_ETHERNET:
182 memcpy(&int64, vp->vp_ether, vp->vp_length);
183 return snprintf(out, outlen, "%" PRIu64, htonll(int64));
186 return snprintf(out, outlen, "%i", vp->vp_signed);
188 case PW_TYPE_IPV6_ADDR:
189 return fr_prints_uint128(out, outlen, ntohlll(*(uint128_t const *) &vp->vp_ipv6addr));
191 case PW_TYPE_IPV6_PREFIX:
192 return fr_prints_uint128(out, outlen, ntohlll(*(uint128_t const *) &vp->vp_ipv6prefix[2]));
198 REDEBUG("Type '%s' of length %zu cannot be converted to integer",
199 fr_int2str(dict_attr_types, vp->da->type, "???"), vp->vp_length);
205 /** Print data as hex, not as VALUE.
208 static ssize_t xlat_hex(UNUSED void *instance, REQUEST *request,
209 char const *fmt, char *out, size_t outlen)
217 uint8_t const *buff = NULL;
219 while (isspace((int) *fmt)) fmt++;
221 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
230 if (vp->da->type == PW_TYPE_OCTETS) {
234 * Cast the value_data_t of the VP to an octets string and
238 ret = value_data_cast(request, &dst, PW_TYPE_OCTETS, NULL, vp->da->type,
239 NULL, &vp->data, vp->vp_length);
241 REDEBUG("%s", fr_strerror());
245 p = buff = dst.octets;
251 * Don't truncate the data.
253 if (outlen < (len * 2)) {
254 rad_const_free(buff);
258 for (i = 0; i < len; i++) {
259 snprintf(out + 2*i, 3, "%02x", p[i]);
261 rad_const_free(buff);
266 /** Return the tag of an attribute reference
269 static ssize_t xlat_tag(UNUSED void *instance, REQUEST *request,
270 char const *fmt, char *out, size_t outlen)
274 while (isspace((int) *fmt)) fmt++;
276 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
281 if (!vp->da->flags.has_tag || !TAG_VALID(vp->tag)) {
286 return snprintf(out, outlen, "%u", vp->tag);
289 /** Return the vendor of an attribute reference
292 static ssize_t xlat_vendor(UNUSED void *instance, REQUEST *request,
293 char const *fmt, char *out, size_t outlen)
298 while (isspace((int) *fmt)) fmt++;
300 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
305 vendor = dict_vendorbyvalue(vp->da->vendor);
310 strlcpy(out, vendor->name, outlen);
312 return vendor->length;
315 /** Return the vendor number of an attribute reference
318 static ssize_t xlat_vendor_num(UNUSED void *instance, REQUEST *request,
319 char const *fmt, char *out, size_t outlen)
323 while (isspace((int) *fmt)) fmt++;
325 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
330 return snprintf(out, outlen, "%u", vp->da->vendor);
333 /** Return the attribute name of an attribute reference
336 static ssize_t xlat_attr(UNUSED void *instance, REQUEST *request,
337 char const *fmt, char *out, size_t outlen)
341 while (isspace((int) *fmt)) fmt++;
343 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
347 strlcpy(out, vp->da->name, outlen);
349 return strlen(vp->da->name);
352 /** Return the attribute number of an attribute reference
355 static ssize_t xlat_attr_num(UNUSED void *instance, REQUEST *request,
356 char const *fmt, char *out, size_t outlen)
360 while (isspace((int) *fmt)) fmt++;
362 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
367 return snprintf(out, outlen, "%u", vp->da->attr);
370 /** Print out attribute info
372 * Prints out all instances of a current attribute, or all attributes in a list.
374 * At higher debugging levels, also prints out alternative decodings of the same
375 * value. This is helpful to determine types for unknown attributes of long
376 * passed vendors, or just crazy/broken NAS.
378 * This expands to a zero length string.
380 static ssize_t xlat_debug_attr(UNUSED void *instance, REQUEST *request, char const *fmt,
381 char *out, UNUSED size_t outlen)
388 if (!RDEBUG_ENABLED2) {
393 while (isspace((int) *fmt)) fmt++;
395 if (tmpl_from_attr_str(&vpt, fmt, REQUEST_CURRENT, PAIR_LIST_REQUEST, false, false) <= 0) {
396 RDEBUG("%s", fr_strerror());
400 RIDEBUG("Attributes matching \"%s\"", fmt);
403 for (vp = tmpl_cursor_init(NULL, &cursor, request, &vpt);
405 vp = tmpl_cursor_next(&cursor, &vpt)) {
406 FR_NAME_NUMBER const *type;
409 value = vp_aprints_value(vp, vp, '\'');
410 if (vp->da->flags.has_tag) {
411 RIDEBUG2("&%s:%s:%i %s %s",
412 fr_int2str(pair_lists, vpt.tmpl_list, "<INVALID>"),
415 fr_int2str(fr_tokens, vp->op, "<INVALID>"),
418 RIDEBUG2("&%s:%s %s %s",
419 fr_int2str(pair_lists, vpt.tmpl_list, "<INVALID>"),
421 fr_int2str(fr_tokens, vp->op, "<INVALID>"),
426 if (!RDEBUG_ENABLED3) continue;
428 if (vp->da->vendor) {
431 dv = dict_vendorbyvalue(vp->da->vendor);
432 RIDEBUG2("Vendor : %i (%s)", vp->da->vendor, dv ? dv->name : "unknown");
434 RIDEBUG2("Type : %s", fr_int2str(dict_attr_types, vp->da->type, "<INVALID>"));
435 RIDEBUG2("Length : %zu", vp->vp_length);
437 if (!RDEBUG_ENABLED4) continue;
439 type = dict_attr_types;
443 value_data_t *dst = NULL;
447 if ((PW_TYPE) type->number == vp->da->type) {
451 switch (type->number) {
452 case PW_TYPE_INVALID: /* Not real type */
453 case PW_TYPE_MAX: /* Not real type */
454 case PW_TYPE_EXTENDED: /* Not safe/appropriate */
455 case PW_TYPE_LONG_EXTENDED: /* Not safe/appropriate */
456 case PW_TYPE_TLV: /* Not safe/appropriate */
457 case PW_TYPE_EVS: /* Not safe/appropriate */
458 case PW_TYPE_VSA: /* @fixme We need special behaviour for these */
459 case PW_TYPE_COMBO_IP_ADDR: /* Covered by IPv4 address IPv6 address */
460 case PW_TYPE_COMBO_IP_PREFIX: /* Covered by IPv4 address IPv6 address */
461 case PW_TYPE_TIMEVAL: /* Not a VALUE_PAIR type */
468 dst = talloc_zero(vp, value_data_t);
469 ret = value_data_cast(dst, dst, type->number, NULL, vp->da->type, vp->da,
470 &vp->data, vp->vp_length);
471 if (ret < 0) goto next_type; /* We expect some to fail */
473 value = value_data_aprints(dst, type->number, NULL, dst, (size_t)ret, '\'');
474 if (!value) goto next_type;
476 if ((pad = (11 - strlen(type->name))) < 0) {
481 RDEBUG2("as %s%*s: %s", type->name, pad, " ", value);
494 /** Processes fmt as a map string and applies it to the current request
496 * e.g. "%{map:&User-Name := 'foo'}"
498 * Allows sets of modifications to be cached and then applied.
499 * Useful for processing generic attributes from LDAP.
501 static ssize_t xlat_map(UNUSED void *instance, REQUEST *request,
502 char const *fmt, char *out, size_t outlen)
504 vp_map_t *map = NULL;
507 if (map_afrom_attr_str(request, &map, fmt,
508 REQUEST_CURRENT, PAIR_LIST_REQUEST,
509 REQUEST_CURRENT, PAIR_LIST_REQUEST) < 0) {
510 REDEBUG("Failed parsing \"%s\" as map: %s", fmt, fr_strerror());
515 ret = map_to_request(request, map, map_to_vp, NULL);
518 if (ret < 0) return strlcpy(out, "0", outlen);
520 return strlcpy(out, "1", outlen);
523 /** Prints the current module processing the request
526 static ssize_t xlat_module(UNUSED void *instance, REQUEST *request,
527 UNUSED char const *fmt, char *out, size_t outlen)
529 strlcpy(out, request->module, outlen);
534 #if defined(HAVE_REGEX) && defined(HAVE_PCRE)
535 static ssize_t xlat_regex(UNUSED void *instance, REQUEST *request,
536 char const *fmt, char *out, size_t outlen)
541 if (regex_request_to_sub_named(request, &p, request, fmt) < 0) {
546 len = talloc_array_length(p);
548 RDEBUG("Insufficient buffer space to write subcapture value, needed %zu bytes, have %zu bytes",
552 strlcpy(out, p, outlen);
554 return len - 1; /* - \0 */
559 /** Implements the Foreach-Variable-X
563 static ssize_t xlat_foreach(void *instance, REQUEST *request,
564 UNUSED char const *fmt, char *out, size_t outlen)
570 * See modcall, "FOREACH" for how this works.
572 pvp = (VALUE_PAIR **) request_data_reference(request, (void *)radius_get_vp, *(int*) instance);
578 len = vp_prints_value(out, outlen, *pvp, 0);
579 if (is_truncated(len, outlen)) {
580 RDEBUG("Insufficient buffer space to write foreach value");
588 /** Print data as string, if possible.
590 * If attribute "Foo" is defined as "octets" it will normally
591 * be printed as 0x0a0a0a. The xlat "%{string:Foo}" will instead
594 static ssize_t xlat_string(UNUSED void *instance, REQUEST *request,
595 char const *fmt, char *out, size_t outlen)
602 while (isspace((int) *fmt)) fmt++;
610 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) goto nothing;
612 ret = rad_vp2data(&p, vp);
617 switch (vp->da->type) {
619 len = fr_prints(out, outlen, (char const *) p, vp->vp_length, '"');
623 len = strlcpy(out, vp->vp_strvalue, outlen);
627 len = fr_prints(out, outlen, (char const *) p, ret, '\0');
634 /** xlat expand string attribute value
637 static ssize_t xlat_xlat(UNUSED void *instance, REQUEST *request,
638 char const *fmt, char *out, size_t outlen)
642 while (isspace((int) *fmt)) fmt++;
650 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) goto nothing;
652 return radius_xlat(out, outlen, request, vp->vp_strvalue, NULL, NULL);
655 /** Dynamically change the debugging level for the current request
659 static ssize_t xlat_debug(UNUSED void *instance, REQUEST *request,
660 char const *fmt, char *out, size_t outlen)
665 * Expand to previous (or current) level
667 snprintf(out, outlen, "%d", request->log.lvl);
670 * Assume we just want to get the current value and NOT set it to 0
677 request->log.lvl = RAD_REQUEST_LVL_NONE;
678 request->log.func = NULL;
680 if (level > 4) level = 4;
682 request->log.lvl = level;
683 request->log.func = vradlog_request;
691 * Compare two xlat_t structs, based ONLY on the module name.
693 static int xlat_cmp(void const *one, void const *two)
695 xlat_t const *a = one;
696 xlat_t const *b = two;
698 if (a->length != b->length) {
699 return a->length - b->length;
702 return memcmp(a->name, b->name, a->length);
707 * find the appropriate registered xlat function.
709 static xlat_t *xlat_find(char const *name)
713 strlcpy(my_xlat.name, name, sizeof(my_xlat.name));
714 my_xlat.length = strlen(my_xlat.name);
716 return rbtree_finddata(xlat_root, &my_xlat);
720 /** Register an xlat function.
722 * @param[in] name xlat name.
723 * @param[in] func xlat function to be called.
724 * @param[in] escape function to sanitize any sub expansions passed to the xlat function.
725 * @param[in] instance of module that's registering the xlat function.
726 * @return 0 on success, -1 on failure
728 int xlat_register(char const *name, xlat_func_t func, xlat_escape_t escape, void *instance)
734 if (!name || !*name) {
735 DEBUG("xlat_register: Invalid xlat name");
740 * First time around, build up the tree...
742 * FIXME: This code should be hoisted out of this function,
743 * and into a global "initialization". But it isn't critical...
750 xlat_root = rbtree_create(NULL, xlat_cmp, NULL, RBTREE_FLAG_REPLACE);
752 DEBUG("xlat_register: Failed to create tree");
757 for (i = 0; xlat_foreach_names[i] != NULL; i++) {
758 xlat_register(xlat_foreach_names[i],
759 xlat_foreach, NULL, &xlat_inst[i]);
760 c = xlat_find(xlat_foreach_names[i]);
761 rad_assert(c != NULL);
766 #define XLAT_REGISTER(_x) xlat_register(STRINGIFY(_x), xlat_ ## _x, NULL, NULL); \
767 c = xlat_find(STRINGIFY(_x)); \
768 rad_assert(c != NULL); \
771 XLAT_REGISTER(integer);
772 XLAT_REGISTER(strlen);
773 XLAT_REGISTER(length);
776 XLAT_REGISTER(vendor);
777 XLAT_REGISTER(vendor_num);
779 XLAT_REGISTER(attr_num);
780 XLAT_REGISTER(string);
783 XLAT_REGISTER(module);
784 XLAT_REGISTER(debug_attr);
785 #if defined(HAVE_REGEX) && defined(HAVE_PCRE)
786 XLAT_REGISTER(regex);
789 xlat_register("debug", xlat_debug, NULL, &xlat_inst[0]);
790 c = xlat_find("debug");
791 rad_assert(c != NULL);
796 * If it already exists, replace the instance.
798 strlcpy(my_xlat.name, name, sizeof(my_xlat.name));
799 my_xlat.length = strlen(my_xlat.name);
800 c = rbtree_finddata(xlat_root, &my_xlat);
803 DEBUG("xlat_register: Cannot re-define internal xlat");
809 c->instance = instance;
814 * Doesn't exist. Create it.
816 c = talloc_zero(xlat_root, xlat_t);
820 strlcpy(c->name, name, sizeof(c->name));
821 c->length = strlen(c->name);
822 c->instance = instance;
824 node = rbtree_insert_node(xlat_root, c);
831 * Ensure that the data is deleted when the node is
834 * @todo: Maybe this should be the other way around...
835 * when a thing IN the tree is deleted, it's automatically
836 * removed from the tree. But for now, this works.
838 (void) talloc_steal(node, c);
842 /** Unregister an xlat function
844 * We can only have one function to call per name, so the passing of "func"
845 * here is extraneous.
847 * @param[in] name xlat to unregister.
848 * @param[in] func unused.
849 * @param[in] instance data.
851 void xlat_unregister(char const *name, UNUSED xlat_func_t func, void *instance)
856 if (!name || !xlat_root) return;
858 strlcpy(my_xlat.name, name, sizeof(my_xlat.name));
859 my_xlat.length = strlen(my_xlat.name);
861 c = rbtree_finddata(xlat_root, &my_xlat);
864 if (c->instance != instance) return;
866 rbtree_deletebydata(xlat_root, c);
869 static int xlat_unregister_callback(void *instance, void *data)
871 xlat_t *c = (xlat_t *) data;
873 if (c->instance != instance) return 0; /* keep walking */
875 return 2; /* delete it */
878 void xlat_unregister_module(void *instance)
880 rbtree_walk(xlat_root, RBTREE_DELETE_ORDER, xlat_unregister_callback, instance);
884 * Internal redundant handler for xlats
886 typedef enum xlat_redundant_type_t {
890 XLAT_REDUNDANT_LOAD_BALANCE,
891 } xlat_redundant_type_t;
893 typedef struct xlat_redundant_t {
894 xlat_redundant_type_t type;
900 static ssize_t xlat_redundant(void *instance, REQUEST *request,
901 char const *fmt, char *out, size_t outlen)
903 xlat_redundant_t *xr = instance;
908 rad_assert(xr->type == XLAT_REDUNDANT);
911 * Pick the first xlat which succeeds
913 for (ci = cf_item_find_next(xr->cs, NULL);
915 ci = cf_item_find_next(xr->cs, ci)) {
918 if (!cf_item_is_pair(ci)) continue;
920 name = cf_pair_attr(cf_item_to_pair(ci));
921 rad_assert(name != NULL);
923 xlat = xlat_find(name);
926 rcode = xlat->func(xlat->instance, request, fmt, out, outlen);
927 if (rcode <= 0) continue;
932 * Everything failed. Oh well.
939 static ssize_t xlat_load_balance(void *instance, REQUEST *request,
940 char const *fmt, char *out, size_t outlen)
943 xlat_redundant_t *xr = instance;
945 CONF_ITEM *found = NULL;
950 * Choose a child at random.
952 for (ci = cf_item_find_next(xr->cs, NULL);
954 ci = cf_item_find_next(xr->cs, ci)) {
955 if (!cf_item_is_pair(ci)) continue;
959 * Replace the previously found one with a random
962 if ((count * (fr_rand() & 0xffff)) < (uint32_t) 0x10000) {
968 * Plain load balancing: do one child, and only one child.
970 if (xr->type == XLAT_LOAD_BALANCE) {
971 name = cf_pair_attr(cf_item_to_pair(found));
972 rad_assert(name != NULL);
974 xlat = xlat_find(name);
975 if (!xlat) return -1;
977 return xlat->func(xlat->instance, request, fmt, out, outlen);
980 rad_assert(xr->type == XLAT_REDUNDANT_LOAD_BALANCE);
983 * Try the random one we found. If it fails, keep going
984 * through the rest of the children.
988 name = cf_pair_attr(cf_item_to_pair(ci));
989 rad_assert(name != NULL);
991 xlat = xlat_find(name);
995 rcode = xlat->func(xlat->instance, request, fmt, out, outlen);
996 if (rcode > 0) return rcode;
1000 * Go to the next one, wrapping around at the end.
1002 ci = cf_item_find_next(xr->cs, ci);
1003 if (!ci) ci = cf_item_find_next(xr->cs, NULL);
1004 } while (ci != found);
1010 bool xlat_register_redundant(CONF_SECTION *cs)
1012 char const *name1, *name2;
1013 xlat_redundant_t *xr;
1015 name1 = cf_section_name1(cs);
1016 name2 = cf_section_name2(cs);
1018 if (!name2) return false;
1020 if (xlat_find(name2)) {
1021 cf_log_err_cs(cs, "An expansion is already registered for this name");
1025 xr = talloc_zero(cs, xlat_redundant_t);
1026 if (!xr) return false;
1028 if (strcmp(name1, "redundant") == 0) {
1029 xr->type = XLAT_REDUNDANT;
1031 } else if (strcmp(name1, "redundant-load-balance") == 0) {
1032 xr->type = XLAT_REDUNDANT_LOAD_BALANCE;
1034 } else if (strcmp(name1, "load-balance") == 0) {
1035 xr->type = XLAT_LOAD_BALANCE;
1044 * Get the number of children for load balancing.
1046 if (xr->type == XLAT_REDUNDANT) {
1047 if (xlat_register(name2, xlat_redundant, NULL, xr) < 0) {
1055 for (ci = cf_item_find_next(cs, NULL);
1057 ci = cf_item_find_next(cs, ci)) {
1058 if (!cf_item_is_pair(ci)) continue;
1060 if (!xlat_find(cf_pair_attr(cf_item_to_pair(ci)))) {
1068 if (xlat_register(name2, xlat_load_balance, NULL, xr) < 0) {
1078 /** Crappy temporary function to add attribute ref support to xlats
1080 * This needs to die, and hopefully will die, when xlat functions accept
1081 * xlat node structures.
1083 * Provides either a pointer to a buffer which contains the value of the reference VALUE_PAIR
1084 * in an architecture independent format. Or a pointer to the start of the fmt string.
1086 * The pointer is only guaranteed to be valid between calls to xlat_fmt_to_ref,
1087 * and so long as the source VALUE_PAIR is not freed.
1089 * @param out where to write a pointer to the buffer to the data the xlat function needs to work on.
1090 * @param request current request.
1091 * @param fmt string.
1092 * @returns the length of the data or -1 on error.
1094 ssize_t xlat_fmt_to_ref(uint8_t const **out, REQUEST *request, char const *fmt)
1098 while (isspace((int) *fmt)) fmt++;
1100 if (fmt[0] == '&') {
1101 if ((radius_get_vp(&vp, request, fmt) < 0) || !vp) {
1106 return rad_vp2data(out, vp);
1109 *out = (uint8_t const *)fmt;
1113 /** De-register all xlat functions, used mainly for debugging.
1116 void xlat_free(void)
1118 rbtree_free(xlat_root);
1122 # define XLAT_DEBUG DEBUG3
1124 # define XLAT_DEBUG(...)
1127 static ssize_t xlat_tokenize_expansion(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1128 char const **error);
1129 static ssize_t xlat_tokenize_literal(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1130 bool brace, char const **error);
1131 static size_t xlat_process(char **out, REQUEST *request, xlat_exp_t const * const head,
1132 xlat_escape_t escape, void *escape_ctx);
1134 static ssize_t xlat_tokenize_alternation(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1141 rad_assert(fmt[0] == '%');
1142 rad_assert(fmt[1] == '{');
1143 rad_assert(fmt[2] == '%');
1144 rad_assert(fmt[3] == '{');
1146 XLAT_DEBUG("ALTERNATE <-- %s", fmt);
1148 node = talloc_zero(ctx, xlat_exp_t);
1149 node->type = XLAT_ALTERNATE;
1152 slen = xlat_tokenize_expansion(node, p, &node->child, error);
1155 return slen - (p - fmt);
1161 *error = "Expected ':' after first expansion";
1168 *error = "Expected '-' after ':'";
1174 * Allow the RHS to be empty as a special case.
1178 * Hack up an empty string.
1180 node->alternate = talloc_zero(node, xlat_exp_t);
1181 node->alternate->type = XLAT_LITERAL;
1182 node->alternate->fmt = talloc_typed_strdup(node->alternate, "");
1186 slen = xlat_tokenize_literal(node, p, &node->alternate, true, error);
1189 return slen - (p - fmt);
1192 if (!node->alternate) {
1194 *error = "Empty expansion is invalid";
1204 static ssize_t xlat_tokenize_expansion(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1212 rad_assert(fmt[0] == '%');
1213 rad_assert(fmt[1] == '{');
1218 if ((fmt[2] == '%') && (fmt[3] == '{')) return xlat_tokenize_alternation(ctx, fmt, head, error);
1220 XLAT_DEBUG("EXPANSION <-- %s", fmt);
1221 node = talloc_zero(ctx, xlat_exp_t);
1222 node->fmt = fmt + 2;
1227 * Handle regex's specially.
1230 num = strtol(p, &q, 10);
1231 if (p != q && (*q == '}')) {
1232 XLAT_DEBUG("REGEX <-- %s", fmt);
1235 if ((num > REQUEST_MAX_REGEX) || (num < 0)) {
1237 *error = "Invalid regex reference. Must be in range 0-" STRINGIFY(REQUEST_MAX_REGEX);
1240 node->attr.tmpl_num = num;
1242 node->type = XLAT_REGEX;
1245 return (q - fmt) + 1;
1247 #endif /* HAVE_REGEX */
1252 * %{Tunnel-Password:1}
1253 * %{Tunnel-Password:1[#]}
1254 * %{request:Attr-Name}
1255 * %{request:Tunnel-Password:1}
1256 * %{request:Tunnel-Password:1[#]}
1261 * This is for efficiency, so we don't search for an xlat,
1262 * when what's being referenced is obviously an attribute.
1265 for (q = p; *q != '\0'; q++) {
1266 if (*q == ':') break;
1268 if (isspace((int) *q)) break;
1270 if (*q == '[') continue;
1272 if (*q == '}') break;
1276 * Check for empty expressions %{}
1278 if ((*q == '}') && (q == p)) {
1279 *error = "Empty expression is invalid";
1284 * Might be a module name reference.
1286 * If it's not, it's an attribute or parse error.
1290 node->xlat = xlat_find(node->fmt);
1295 node->type = XLAT_MODULE;
1298 XLAT_DEBUG("MOD <-- %s ... %s", node->fmt, p);
1300 slen = xlat_tokenize_literal(node, p, &node->child, true, error);
1303 return slen - (p - fmt);
1308 rad_assert(node->next == NULL);
1312 *q = ':'; /* Avoids a strdup */
1316 * The first token ends with:
1317 * - '[' - Which is an attribute index, so it must be an attribute.
1318 * - '}' - The end of the expansion, which means it was a bareword.
1320 slen = tmpl_from_attr_substr(&node->attr, p, REQUEST_CURRENT, PAIR_LIST_REQUEST, true, true);
1323 * If the parse error occurred before the ':'
1324 * then the error is changed to 'Unknown module',
1325 * as it was more likely to be a bad module name,
1326 * than a request qualifier.
1328 if ((*q == ':') && ((p + (slen * -1)) < q)) {
1329 *error = "Unknown module";
1331 *error = fr_strerror();
1333 return slen - (p - fmt);
1337 * Might be a virtual XLAT attribute
1339 if (node->attr.type == TMPL_TYPE_ATTR_UNDEFINED) {
1340 node->xlat = xlat_find(node->attr.tmpl_unknown_name);
1342 node->type = XLAT_VIRTUAL;
1343 node->fmt = node->attr.tmpl_unknown_name;
1345 XLAT_DEBUG("VIRTUAL <-- %s", node->fmt);
1347 rad_assert(node->next == NULL);
1353 *error = "Unknown attribute";
1357 node->type = XLAT_ATTRIBUTE;
1362 *error = "No matching closing brace";
1363 return -1; /* second character of format string */
1367 rad_assert(node->next == NULL);
1373 static ssize_t xlat_tokenize_literal(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1374 bool brace, char const **error)
1379 if (!*fmt) return 0;
1381 XLAT_DEBUG("LITERAL <-- %s", fmt);
1383 node = talloc_zero(ctx, xlat_exp_t);
1386 node->type = XLAT_LITERAL;
1394 *error = "Invalid escape at end of string";
1402 * Process the expansion.
1404 if ((p[0] == '%') && (p[1] == '{')) {
1407 XLAT_DEBUG("EXPANSION-2 <-- %s", node->fmt);
1409 slen = xlat_tokenize_expansion(node, p, &node->next, error);
1412 return slen - (p - fmt);
1414 *p = '\0'; /* end the literal */
1417 rad_assert(node->next != NULL);
1420 * Short-circuit the recursive call.
1421 * This saves another function call and
1422 * memory allocation.
1427 * "foo %{User-Name} bar"
1429 * EXPANSION User-Name
1432 slen = xlat_tokenize_literal(node->next, p, &(node->next->next), brace, error);
1433 rad_assert(slen != 0);
1436 return slen - (p - fmt);
1439 brace = false; /* it was found above, or else the above code errored out */
1441 break; /* stop processing the string */
1445 * Check for valid single-character expansions.
1451 if (!p[1] || !strchr("%dlmntDGHISTYv", p[1])) {
1453 *error = "Invalid variable expansion";
1458 next = talloc_zero(node, xlat_exp_t);
1462 next->fmt = talloc_typed_strdup(next, "%");
1464 XLAT_DEBUG("LITERAL-PERCENT <-- %s", next->fmt);
1465 next->type = XLAT_LITERAL;
1470 XLAT_DEBUG("PERCENT <-- %c", *next->fmt);
1471 next->type = XLAT_PERCENT;
1483 slen = xlat_tokenize_literal(node->next, p, &(node->next->next), brace, error);
1484 rad_assert(slen != 0);
1487 return slen - (p - fmt);
1490 brace = false; /* it was found above, or else the above code errored out */
1492 break; /* stop processing the string */
1496 * If required, eat the brace.
1498 if (brace && (*p == '}')) {
1510 * We were told to look for a brace, but we ran off of
1511 * the end of the string before we found one.
1514 *error = "Missing closing brace at end of string";
1519 * Squash zero-width literals
1521 if (node->len > 0) {
1525 (void) talloc_steal(ctx, node->next);
1534 static char const xlat_tabs[] = " ";
1536 static void xlat_tokenize_debug(xlat_exp_t const *node, int lvl)
1538 rad_assert(node != NULL);
1540 if (lvl >= (int) sizeof(xlat_tabs)) lvl = sizeof(xlat_tabs);
1543 switch (node->type) {
1545 DEBUG("%.*sliteral --> %s", lvl, xlat_tabs, node->fmt);
1549 DEBUG("%.*spercent --> %c", lvl, xlat_tabs, node->fmt[0]);
1552 case XLAT_ATTRIBUTE:
1553 rad_assert(node->attr.tmpl_da != NULL);
1554 DEBUG("%.*sattribute --> %s", lvl, xlat_tabs, node->attr.tmpl_da->name);
1555 rad_assert(node->child == NULL);
1556 if ((node->attr.tmpl_tag != TAG_ANY) || (node->attr.tmpl_num != NUM_ANY)) {
1557 DEBUG("%.*s{", lvl, xlat_tabs);
1559 DEBUG("%.*sref %d", lvl + 1, xlat_tabs, node->attr.tmpl_request);
1560 DEBUG("%.*slist %d", lvl + 1, xlat_tabs, node->attr.tmpl_list);
1562 if (node->attr.tmpl_tag != TAG_ANY) {
1563 DEBUG("%.*stag %d", lvl + 1, xlat_tabs, node->attr.tmpl_tag);
1565 if (node->attr.tmpl_num != NUM_ANY) {
1566 if (node->attr.tmpl_num == NUM_COUNT) {
1567 DEBUG("%.*s[#]", lvl + 1, xlat_tabs);
1568 } else if (node->attr.tmpl_num == NUM_ALL) {
1569 DEBUG("%.*s[*]", lvl + 1, xlat_tabs);
1571 DEBUG("%.*s[%d]", lvl + 1, xlat_tabs, node->attr.tmpl_num);
1575 DEBUG("%.*s}", lvl, xlat_tabs);
1580 rad_assert(node->fmt != NULL);
1581 DEBUG("%.*svirtual --> %s", lvl, xlat_tabs, node->fmt);
1585 rad_assert(node->xlat != NULL);
1586 DEBUG("%.*sxlat --> %s", lvl, xlat_tabs, node->xlat->name);
1588 DEBUG("%.*s{", lvl, xlat_tabs);
1589 xlat_tokenize_debug(node->child, lvl + 1);
1590 DEBUG("%.*s}", lvl, xlat_tabs);
1596 DEBUG("%.*sregex-var --> %d", lvl, xlat_tabs, node->attr.tmpl_num);
1600 case XLAT_ALTERNATE:
1601 DEBUG("%.*sif {", lvl, xlat_tabs);
1602 xlat_tokenize_debug(node->child, lvl + 1);
1603 DEBUG("%.*s}", lvl, xlat_tabs);
1604 DEBUG("%.*selse {", lvl, xlat_tabs);
1605 xlat_tokenize_debug(node->alternate, lvl + 1);
1606 DEBUG("%.*s}", lvl, xlat_tabs);
1613 size_t xlat_sprint(char *buffer, size_t bufsize, xlat_exp_t const *node)
1624 end = buffer + bufsize;
1627 switch (node->type) {
1629 strlcpy(p, node->fmt, end - p);
1635 p[1] = node->fmt[0];
1639 case XLAT_ATTRIBUTE:
1643 if (node->attr.tmpl_request != REQUEST_CURRENT) {
1644 strlcpy(p, fr_int2str(request_refs, node->attr.tmpl_request, "??"), end - p);
1649 if ((node->attr.tmpl_request != REQUEST_CURRENT) ||
1650 (node->attr.tmpl_list != PAIR_LIST_REQUEST)) {
1651 strlcpy(p, fr_int2str(pair_lists, node->attr.tmpl_list, "??"), end - p);
1656 strlcpy(p, node->attr.tmpl_da->name, end - p);
1659 if (node->attr.tmpl_tag != TAG_ANY) {
1661 snprintf(p, end - p, "%u", node->attr.tmpl_tag);
1665 if (node->attr.tmpl_num != NUM_ANY) {
1667 switch (node->attr.tmpl_num) {
1677 snprintf(p, end - p, "%i", node->attr.tmpl_num);
1686 snprintf(p, end - p, "%%{%i}", node->attr.tmpl_num);
1693 strlcpy(p, node->fmt, end - p);
1701 strlcpy(p, node->xlat->name, end - p);
1704 rad_assert(node->child != NULL);
1705 len = xlat_sprint(p, end - p, node->child);
1710 case XLAT_ALTERNATE:
1714 len = xlat_sprint(p, end - p, node->child);
1720 len = xlat_sprint(p, end - p, node->alternate);
1728 if (p == end) break;
1738 ssize_t xlat_tokenize(TALLOC_CTX *ctx, char *fmt, xlat_exp_t **head,
1741 return xlat_tokenize_literal(ctx, fmt, head, false, error);
1745 /** Tokenize an xlat expansion
1747 * @param[in] request the input request. Memory will be attached here.
1748 * @param[in] fmt the format string to expand
1749 * @param[out] head the head of the xlat list / tree structure.
1751 static ssize_t xlat_tokenize_request(REQUEST *request, char const *fmt, xlat_exp_t **head)
1755 char const *error = NULL;
1760 * Copy the original format string to a buffer so that
1761 * the later functions can mangle it in-place, which is
1764 tokens = talloc_typed_strdup(request, fmt);
1765 if (!tokens) return -1;
1767 slen = xlat_tokenize_literal(request, tokens, head, false, &error);
1770 * Zero length expansion, return a zero length node.
1773 *head = talloc_zero(request, xlat_exp_t);
1777 * Output something like:
1780 * " ^ error was here"
1783 talloc_free(tokens);
1784 rad_assert(error != NULL);
1786 REMARKER(fmt, -slen, error);
1790 if (*head && (rad_debug_lvl > 2)) {
1792 DEBUG("Parsed xlat tree:");
1793 xlat_tokenize_debug(*head, 0);
1797 * All of the nodes point to offsets in the "tokens"
1798 * string. Let's ensure that free'ing head will free
1801 (void) talloc_steal(*head, tokens);
1807 static char *xlat_getvp(TALLOC_CTX *ctx, REQUEST *request, vp_tmpl_t const *vpt,
1808 bool escape, bool return_null)
1810 VALUE_PAIR *vp = NULL, *virtual = NULL;
1811 RADIUS_PACKET *packet = NULL;
1816 char quote = escape ? '"' : '\0';
1821 * See if we're dealing with an attribute in the request
1823 * This allows users to manipulate virtual attributes as if
1824 * they were real ones.
1826 vp = tmpl_cursor_init(&err, &cursor, request, vpt);
1827 if (vp) goto do_print;
1830 * We didn't find the VP in a list.
1831 * If it's not a virtual one, and we're not meant to
1832 * be counting it, return.
1834 if (!vpt->tmpl_da->flags.virtual) {
1835 if (vpt->tmpl_num == NUM_COUNT) goto do_print;
1840 * Switch out the request to the one specified by the template
1842 if (radius_request(&request, vpt->tmpl_request) < 0) return NULL;
1845 * Some non-packet expansions
1847 switch (vpt->tmpl_da->attr) {
1849 break; /* ignore them */
1851 case PW_CLIENT_SHORTNAME:
1852 if (vpt->tmpl_num == NUM_COUNT) goto count_virtual;
1853 if (request->client && request->client->shortname) {
1854 return talloc_typed_strdup(ctx, request->client->shortname);
1856 return talloc_typed_strdup(ctx, "<UNKNOWN-CLIENT>");
1858 case PW_REQUEST_PROCESSING_STAGE:
1859 if (vpt->tmpl_num == NUM_COUNT) goto count_virtual;
1860 if (request->component) {
1861 return talloc_typed_strdup(ctx, request->component);
1863 return talloc_typed_strdup(ctx, "server_core");
1865 case PW_VIRTUAL_SERVER:
1866 if (vpt->tmpl_num == NUM_COUNT) goto count_virtual;
1867 if (!request->server) return NULL;
1868 return talloc_typed_strdup(ctx, request->server);
1870 case PW_MODULE_RETURN_CODE:
1871 if (vpt->tmpl_num == NUM_COUNT) goto count_virtual;
1872 if (!request->rcode) return NULL;
1873 return talloc_typed_strdup(ctx, fr_int2str(modreturn_table, request->rcode, ""));
1877 * All of the attributes must now refer to a packet.
1878 * If there's no packet, we can't print any attribute
1881 packet = radius_packet(request, vpt->tmpl_list);
1883 if (return_null) return NULL;
1884 return vp_aprints_type(ctx, vpt->tmpl_da->type);
1888 switch (vpt->tmpl_da->attr) {
1892 case PW_PACKET_TYPE:
1893 dv = dict_valbyattr(PW_PACKET_TYPE, 0, packet->code);
1894 if (dv) return talloc_typed_strdup(ctx, dv->name);
1895 return talloc_typed_asprintf(ctx, "%d", packet->code);
1897 case PW_RESPONSE_PACKET_TYPE:
1902 if (request->proxy_reply && (!request->reply || !request->reply->code)) {
1903 code = request->proxy_reply->code;
1906 if (request->reply) {
1907 code = request->reply->code;
1910 return talloc_typed_strdup(ctx, fr_packet_codes[code]);
1914 * Virtual attributes which require a temporary VALUE_PAIR
1915 * to be allocated. We can't use stack allocated memory
1916 * because of the talloc checks sprinkled throughout the
1917 * various VP functions.
1919 case PW_PACKET_AUTHENTICATION_VECTOR:
1920 virtual = pairalloc(ctx, vpt->tmpl_da);
1921 pairmemcpy(virtual, packet->vector, sizeof(packet->vector));
1925 case PW_CLIENT_IP_ADDRESS:
1926 case PW_PACKET_SRC_IP_ADDRESS:
1927 if (packet->src_ipaddr.af == AF_INET) {
1928 virtual = pairalloc(ctx, vpt->tmpl_da);
1929 virtual->vp_ipaddr = packet->src_ipaddr.ipaddr.ip4addr.s_addr;
1934 case PW_PACKET_DST_IP_ADDRESS:
1935 if (packet->dst_ipaddr.af == AF_INET) {
1936 virtual = pairalloc(ctx, vpt->tmpl_da);
1937 virtual->vp_ipaddr = packet->dst_ipaddr.ipaddr.ip4addr.s_addr;
1942 case PW_PACKET_SRC_IPV6_ADDRESS:
1943 if (packet->src_ipaddr.af == AF_INET6) {
1944 virtual = pairalloc(ctx, vpt->tmpl_da);
1945 memcpy(&virtual->vp_ipv6addr,
1946 &packet->src_ipaddr.ipaddr.ip6addr,
1947 sizeof(packet->src_ipaddr.ipaddr.ip6addr));
1952 case PW_PACKET_DST_IPV6_ADDRESS:
1953 if (packet->dst_ipaddr.af == AF_INET6) {
1954 virtual = pairalloc(ctx, vpt->tmpl_da);
1955 memcpy(&virtual->vp_ipv6addr,
1956 &packet->dst_ipaddr.ipaddr.ip6addr,
1957 sizeof(packet->dst_ipaddr.ipaddr.ip6addr));
1962 case PW_PACKET_SRC_PORT:
1963 virtual = pairalloc(ctx, vpt->tmpl_da);
1964 virtual->vp_integer = packet->src_port;
1968 case PW_PACKET_DST_PORT:
1969 virtual = pairalloc(ctx, vpt->tmpl_da);
1970 virtual->vp_integer = packet->dst_port;
1976 * Fake various operations for virtual attributes.
1979 if (vpt->tmpl_num != NUM_ANY) switch (vpt->tmpl_num) {
1981 * [n] is NULL (we only have [0])
1986 * [*] means only one.
1992 * [#] means 1 (as there's only one)
1996 ret = talloc_strdup(ctx, "1");
2000 * [0] is fine (get the first instance)
2009 switch (vpt->tmpl_num) {
2011 * Return a count of the VPs.
2017 fr_cursor_first(&cursor);
2018 while (fr_cursor_next_by_da(&cursor, vpt->tmpl_da, vpt->tmpl_tag)) count++;
2020 return talloc_typed_asprintf(ctx, "%d", count);
2025 * Concatenate all values together,
2026 * separated by commas.
2032 if (!fr_cursor_current(&cursor)) return NULL;
2033 p = vp_aprints_value(ctx, vp, quote);
2034 if (!p) return NULL;
2036 while ((vp = tmpl_cursor_next(&cursor, vpt)) != NULL) {
2037 q = vp_aprints_value(ctx, vp, quote);
2038 if (!q) return NULL;
2039 p = talloc_strdup_append(p, ",");
2040 p = talloc_strdup_append(p, q);
2048 * The cursor was set to the correct
2049 * position above by tmpl_cursor_init.
2051 vp = fr_cursor_current(&cursor);
2056 if (return_null) return NULL;
2057 return vp_aprints_type(ctx, vpt->tmpl_da->type);
2061 ret = vp_aprints_value(ctx, vp, quote);
2064 talloc_free(virtual);
2069 static const char xlat_spaces[] = " ";
2072 static char *xlat_aprint(TALLOC_CTX *ctx, REQUEST *request, xlat_exp_t const * const node,
2073 xlat_escape_t escape, void *escape_ctx, int lvl)
2076 char *str = NULL, *child;
2079 XLAT_DEBUG("%.*sxlat aprint %d %s", lvl, xlat_spaces, node->type, node->fmt);
2081 switch (node->type) {
2083 * Don't escape this.
2086 XLAT_DEBUG("xlat_aprint LITERAL");
2087 return talloc_typed_strdup(ctx, node->fmt);
2090 * Do a one-character expansion.
2095 size_t freespace = 256;
2099 XLAT_DEBUG("xlat_aprint PERCENT");
2101 str = talloc_array(ctx, char, freespace); /* @todo do better allocation */
2104 when = request->timestamp;
2105 if (request->packet) {
2106 when = request->packet->timestamp.tv_sec;
2115 case 'd': /* request day */
2116 if (!localtime_r(&when, &ts)) goto error;
2117 strftime(str, freespace, "%d", &ts);
2120 case 'l': /* request timestamp */
2121 snprintf(str, freespace, "%lu",
2122 (unsigned long) when);
2125 case 'm': /* request month */
2126 if (!localtime_r(&when, &ts)) goto error;
2127 strftime(str, freespace, "%m", &ts);
2130 case 'n': /* Request Number*/
2131 snprintf(str, freespace, "%u", request->number);
2134 case 't': /* request timestamp */
2135 CTIME_R(&when, str, freespace);
2136 nl = strchr(str, '\n');
2140 case 'D': /* request date */
2141 if (!localtime_r(&when, &ts)) goto error;
2142 strftime(str, freespace, "%Y%m%d", &ts);
2145 case 'G': /* request minute */
2146 if (!localtime_r(&when, &ts)) goto error;
2147 strftime(str, freespace, "%M", &ts);
2150 case 'H': /* request hour */
2151 if (!localtime_r(&when, &ts)) goto error;
2152 strftime(str, freespace, "%H", &ts);
2155 case 'I': /* Request ID */
2156 if (request->packet) {
2157 snprintf(str, freespace, "%i", request->packet->id);
2161 case 'S': /* request timestamp in SQL format*/
2162 if (!localtime_r(&when, &ts)) goto error;
2163 strftime(str, freespace, "%Y-%m-%d %H:%M:%S", &ts);
2166 case 'T': /* request timestamp */
2167 if (!localtime_r(&when, &ts)) goto error;
2168 strftime(str, freespace, "%Y-%m-%d-%H.%M.%S.000000", &ts);
2171 case 'Y': /* request year */
2172 if (!localtime_r(&when, &ts)) {
2174 REDEBUG("Failed converting packet timestamp to localtime: %s", fr_syserror(errno));
2178 strftime(str, freespace, "%Y", &ts);
2181 case 'v': /* Version of code */
2182 RWDEBUG("%%v is deprecated and will be removed. Use ${version.freeradius-server}");
2183 snprintf(str, freespace, "%s", radiusd_version_short);
2193 case XLAT_ATTRIBUTE:
2194 XLAT_DEBUG("xlat_aprint ATTRIBUTE");
2197 * Some attributes are virtual <sigh>
2199 str = xlat_getvp(ctx, request, &node->attr, escape ? false : true, true);
2201 XLAT_DEBUG("EXPAND attr %s", node->attr.tmpl_da->name);
2202 XLAT_DEBUG(" ---> %s", str);
2207 XLAT_DEBUG("xlat_aprint VIRTUAL");
2208 str = talloc_array(ctx, char, 2048); /* FIXME: have the module call talloc_typed_asprintf */
2209 rcode = node->xlat->func(node->xlat->instance, request, NULL, str, 2048);
2214 RDEBUG2("EXPAND %s", node->xlat->name);
2215 RDEBUG2(" --> %s", str);
2219 XLAT_DEBUG("xlat_aprint MODULE");
2222 if (xlat_process(&child, request, node->child, node->xlat->escape, node->xlat->instance) == 0) {
2226 XLAT_DEBUG("%.*sEXPAND mod %s %s", lvl, xlat_spaces, node->fmt, node->child->fmt);
2228 XLAT_DEBUG("%.*sEXPAND mod %s", lvl, xlat_spaces, node->fmt);
2229 child = talloc_typed_strdup(ctx, "");
2232 XLAT_DEBUG("%.*s ---> %s", lvl, xlat_spaces, child);
2237 * The OUTPUT of xlat is a printable string. The INPUT might not be...
2239 * This is really the reverse of fr_prints().
2241 if (cf_new_escape && *child) {
2246 type = PW_TYPE_STRING;
2247 slen = value_data_from_str(request, &data, &type, NULL, child, talloc_array_length(child) - 1, '"');
2261 if (*p == '\\') switch (p[1]) {
2283 str = talloc_array(ctx, char, 2048); /* FIXME: have the module call talloc_typed_asprintf */
2284 *str = '\0'; /* Be sure the string is NULL terminated, we now only free on error */
2286 rcode = node->xlat->func(node->xlat->instance, request, child, str, 2048);
2296 XLAT_DEBUG("xlat_aprint REGEX");
2297 if (regex_request_to_sub(ctx, &str, request, node->attr.tmpl_num) < 0) return NULL;
2302 case XLAT_ALTERNATE:
2303 XLAT_DEBUG("xlat_aprint ALTERNATE");
2304 rad_assert(node->child != NULL);
2305 rad_assert(node->alternate != NULL);
2307 str = xlat_aprint(ctx, request, node->child, escape, escape_ctx, lvl);
2309 XLAT_DEBUG("ALTERNATE got string: %s", str);
2313 XLAT_DEBUG("ALTERNATE going to alternate");
2314 str = xlat_aprint(ctx, request, node->alternate, escape, escape_ctx, lvl);
2320 * If there's no data, return that, instead of an empty string.
2322 if (str && !str[0]) {
2328 * Escape the non-literals we found above.
2330 if (str && escape) {
2333 escaped = talloc_array(ctx, char, 2048); /* FIXME: do something intelligent */
2334 escape(request, escaped, 2038, str, escape_ctx);
2343 static size_t xlat_process(char **out, REQUEST *request, xlat_exp_t const * const head,
2344 xlat_escape_t escape, void *escape_ctx)
2348 char **array, *answer;
2349 xlat_exp_t const *node;
2354 * There are no nodes to process, so the result is a zero
2358 *out = talloc_zero_array(request, char, 1);
2363 * Hack for speed. If it's one expansion, just allocate
2364 * that and return, instead of allocating an intermediary
2369 * Pass the MAIN escape function. Recursive
2370 * calls will call node-specific escape
2373 answer = xlat_aprint(request, request, head, escape, escape_ctx, 0);
2375 *out = talloc_zero_array(request, char, 1);
2379 return strlen(answer);
2382 list = 0; /* FIXME: calculate this once */
2383 for (node = head; node != NULL; node = node->next) {
2387 array = talloc_array(request, char *, list);
2388 if (!array) return -1;
2390 for (node = head, i = 0; node != NULL; node = node->next, i++) {
2391 array[i] = xlat_aprint(array, request, node, escape, escape_ctx, 0); /* may be NULL */
2395 for (i = 0; i < list; i++) {
2396 if (array[i]) total += strlen(array[i]); /* FIXME: calculate strlen once */
2401 *out = talloc_zero_array(request, char, 1);
2405 answer = talloc_array(request, char, total + 1);
2408 for (i = 0; i < list; i++) {
2412 len = strlen(array[i]);
2413 memcpy(answer + total, array[i], len);
2417 answer[total] = '\0';
2418 talloc_free(array); /* and child entries */
2425 /** Replace %whatever in a string.
2427 * See 'doc/variables.txt' for more information.
2429 * @param[out] out Where to write pointer to output buffer.
2430 * @param[in] outlen Size of out.
2431 * @param[in] request current request.
2432 * @param[in] node the xlat structure to expand
2433 * @param[in] escape function to escape final value e.g. SQL quoting.
2434 * @param[in] escape_ctx pointer to pass to escape function.
2435 * @return length of string written @bug should really have -1 for failure
2437 static ssize_t xlat_expand_struct(char **out, size_t outlen, REQUEST *request, xlat_exp_t const *node,
2438 xlat_escape_t escape, void *escape_ctx)
2443 rad_assert(node != NULL);
2445 len = xlat_process(&buff, request, node, escape, escape_ctx);
2446 if ((len < 0) || !buff) {
2447 rad_assert(buff == NULL);
2448 if (*out) *out[0] = '\0';
2454 * If out doesn't point to an existing buffer
2455 * copy the pointer to our buffer over.
2463 * Otherwise copy the malloced buffer to the fixed one.
2465 strlcpy(*out, buff, outlen);
2470 static ssize_t xlat_expand(char **out, size_t outlen, REQUEST *request, char const *fmt,
2471 xlat_escape_t escape, void *escape_ctx) CC_HINT(nonnull (1, 3, 4));
2473 /** Replace %whatever in a string.
2475 * See 'doc/variables.txt' for more information.
2477 * @param[out] out Where to write pointer to output buffer.
2478 * @param[in] outlen Size of out.
2479 * @param[in] request current request.
2480 * @param[in] fmt string to expand.
2481 * @param[in] escape function to escape final value e.g. SQL quoting.
2482 * @param[in] escape_ctx pointer to pass to escape function.
2483 * @return length of string written @bug should really have -1 for failure
2485 static ssize_t xlat_expand(char **out, size_t outlen, REQUEST *request, char const *fmt,
2486 xlat_escape_t escape, void *escape_ctx)
2492 * Give better errors than the old code.
2494 len = xlat_tokenize_request(request, fmt, &node);
2499 *out = talloc_zero_array(request, char, 1);
2505 if (*out) *out[0] = '\0';
2509 len = xlat_expand_struct(out, outlen, request, node, escape, escape_ctx);
2512 RDEBUG2("EXPAND %s", fmt);
2513 RDEBUG2(" --> %s", *out);
2518 /** Try to convert an xlat to a tmpl for efficiency
2520 * @param ctx to allocate new vp_tmpl_t in.
2521 * @param node to convert.
2522 * @return NULL if unable to convert (not necessarily error), or a new vp_tmpl_t.
2524 vp_tmpl_t *xlat_to_tmpl_attr(TALLOC_CTX *ctx, xlat_exp_t *node)
2528 if (node->next || (node->type != XLAT_ATTRIBUTE)) return NULL;
2531 * Concat means something completely different as an attribute reference
2532 * Count isn't implemented.
2534 if ((node->attr.tmpl_num == NUM_COUNT) || (node->attr.tmpl_num == NUM_ALL)) return NULL;
2536 vpt = tmpl_alloc(ctx, TMPL_TYPE_ATTR, node->fmt, -1);
2537 if (!vpt) return NULL;
2538 memcpy(&vpt->data, &node->attr.data, sizeof(vpt->data));
2545 /** Try to convert attr tmpl to an xlat for &attr[*] and artificially constructing expansions
2547 * @param ctx to allocate new xlat_expt_t in.
2548 * @param vpt to convert.
2549 * @return NULL if unable to convert (not necessarily error), or a new vp_tmpl_t.
2551 xlat_exp_t *xlat_from_tmpl_attr(TALLOC_CTX *ctx, vp_tmpl_t *vpt)
2555 if (vpt->type != TMPL_TYPE_ATTR) return NULL;
2557 node = talloc_zero(ctx, xlat_exp_t);
2558 node->fmt = talloc_bstrndup(node, vpt->name, vpt->len);
2559 tmpl_init(&node->attr, TMPL_TYPE_ATTR, node->fmt, talloc_array_length(node->fmt) - 1);
2560 memcpy(&node->attr.data, &vpt->data, sizeof(vpt->data));
2565 ssize_t radius_xlat(char *out, size_t outlen, REQUEST *request, char const *fmt, xlat_escape_t escape, void *ctx)
2567 return xlat_expand(&out, outlen, request, fmt, escape, ctx);
2570 ssize_t radius_xlat_struct(char *out, size_t outlen, REQUEST *request, xlat_exp_t const *xlat, xlat_escape_t escape, void *ctx)
2572 return xlat_expand_struct(&out, outlen, request, xlat, escape, ctx);
2575 ssize_t radius_axlat(char **out, REQUEST *request, char const *fmt, xlat_escape_t escape, void *ctx)
2577 return xlat_expand(out, 0, request, fmt, escape, ctx);
2580 ssize_t radius_axlat_struct(char **out, REQUEST *request, xlat_exp_t const *xlat, xlat_escape_t escape, void *ctx)
2582 return xlat_expand_struct(out, 0, request, xlat, escape, ctx);