2 * xlat.c Translate strings. This is the first version of xlat
3 * incorporated to RADIUS
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
21 * Copyright 2000,2006 The FreeRADIUS server project
22 * Copyright 2000 Alan DeKok <aland@ox.org>
25 #include <freeradius-devel/ident.h>
28 #include <freeradius-devel/radiusd.h>
29 #include <freeradius-devel/md5.h>
30 #include <freeradius-devel/rad_assert.h>
34 typedef struct xlat_t {
35 char module[MAX_STRING_LEN];
38 RAD_XLAT_FUNC do_xlat;
39 int internal; /* not allowed to re-define these */
42 static rbtree_t *xlat_root = NULL;
45 * Define all xlat's in the structure.
47 static const char * const internal_xlat[] = {"check",
56 #if REQUEST_MAX_REGEX > 8
57 #error Please fix the following line
59 static const int xlat_inst[] = { 0, 1, 2, 3, 4, 5, 6, 7, 8 }; /* up to 8 for regex */
63 * Convert the value on a VALUE_PAIR to string
65 static int valuepair2str(char * out,int outlen,VALUE_PAIR * pair,
66 int type, RADIUS_ESCAPE_STRING func)
68 char buffer[MAX_STRING_LEN * 4];
71 vp_prints_value(buffer, sizeof(buffer), pair, -1);
72 return func(out, outlen, buffer);
77 strlcpy(out,"_",outlen);
79 case PW_TYPE_INTEGER :
80 strlcpy(out,"0",outlen);
83 strlcpy(out,"?.?.?.?",outlen);
85 case PW_TYPE_IPV6ADDR :
86 strlcpy(out,":?:",outlen);
89 strlcpy(out,"0",outlen);
92 strlcpy(out,"unknown_type",outlen);
99 * Dynamically translate for check:, request:, reply:, etc.
101 static size_t xlat_packet(void *instance, REQUEST *request,
102 char *fmt, char *out, size_t outlen,
103 RADIUS_ESCAPE_STRING func)
107 VALUE_PAIR *vps = NULL;
108 RADIUS_PACKET *packet = NULL;
110 switch (*(int*) instance) {
112 vps = request->config_items;
116 vps = request->packet->vps;
117 packet = request->packet;
121 vps = request->reply->vps;
122 packet = request->reply;
127 if (request->proxy) vps = request->proxy->vps;
128 packet = request->proxy;
134 if (request->proxy_reply) vps = request->proxy_reply->vps;
135 packet = request->proxy_reply;
140 if (request->parent) {
141 vps = request->parent->packet->vps;
142 packet = request->parent->packet;
147 if (request->parent && request->parent->reply) {
148 vps = request->parent->reply->vps;
149 packet = request->parent->reply;
158 * The "format" string is the attribute name.
160 da = dict_attrbyname(fmt);
162 int do_number = FALSE;
167 if (strlen(fmt) > sizeof(buffer)) return 0;
169 p = strchr(fmt, '[');
171 p = strchr(fmt, '#');
176 strlcpy(buffer, fmt, p - fmt + 1);
178 da = dict_attrbyname(buffer);
182 vp = pairfind(vps, da->attr, 0);
189 case PW_TYPE_INTEGER:
193 snprintf(out, outlen, "%u", vp->lvalue);
201 * %{Attribute-Name[#]} returns the count of
202 * attributes of that name in the list.
204 if ((p[1] == '#') && (p[2] == ']')) {
207 for (vp = pairfind(vps, da->attr, da->vendor);
209 vp = pairfind(vp->next, da->attr, da->vendor)) {
212 snprintf(out, outlen, "%d", (int) count);
217 * %{Attribute-Name[*]} returns ALL of the
218 * the attributes, separated by a newline.
220 if ((p[1] == '*') && (p[2] == ']')) {
223 for (vp = pairfind(vps, da->attr, da->vendor);
225 vp = pairfind(vp->next, da->attr, da->vendor)) {
226 count = valuepair2str(out, outlen - 1, vp, da->type, func);
227 rad_assert(count <= outlen);
229 outlen -= (count + 1);
234 if (outlen == 0) break;
245 p += 1 + strspn(p + 1, "0123456789");
247 RDEBUG2("xlat: Invalid array reference in string at %s %s",
253 * Find the N'th value.
255 for (vp = pairfind(vps, da->attr, da->vendor);
257 vp = pairfind(vp->next, da->attr, da->vendor)) {
258 if (count == 0) break;
263 * Non-existent array reference.
267 return valuepair2str(out, outlen, vp, da->type, func);
270 vp = pairfind(vps, da->attr, da->vendor);
273 * Some "magic" handlers, which are never in VP's, but
274 * which are in the packet.
276 * FIXME: We should really do this in a more
282 memset(&localvp, 0, sizeof(localvp));
289 dval = dict_valbyattr(da->attr, da->vendor, packet->code);
291 snprintf(out, outlen, "%s", dval->name);
293 snprintf(out, outlen, "%d", packet->code);
299 case PW_CLIENT_SHORTNAME:
300 if (request->client && request->client->shortname) {
301 strlcpy(out, request->client->shortname, outlen);
303 strlcpy(out, "<UNKNOWN-CLIENT>", outlen);
307 case PW_CLIENT_IP_ADDRESS: /* the same as below */
308 case PW_PACKET_SRC_IP_ADDRESS:
309 if (packet->src_ipaddr.af != AF_INET) {
312 localvp.attribute = da->attr;
313 localvp.vp_ipaddr = packet->src_ipaddr.ipaddr.ip4addr.s_addr;
316 case PW_PACKET_DST_IP_ADDRESS:
317 if (packet->dst_ipaddr.af != AF_INET) {
320 localvp.attribute = da->attr;
321 localvp.vp_ipaddr = packet->dst_ipaddr.ipaddr.ip4addr.s_addr;
324 case PW_PACKET_SRC_PORT:
325 localvp.attribute = da->attr;
326 localvp.vp_integer = packet->src_port;
329 case PW_PACKET_DST_PORT:
330 localvp.attribute = da->attr;
331 localvp.vp_integer = packet->dst_port;
334 case PW_PACKET_AUTHENTICATION_VECTOR:
335 localvp.attribute = da->attr;
336 memcpy(localvp.vp_strvalue, packet->vector,
337 sizeof(packet->vector));
338 localvp.length = sizeof(packet->vector);
342 * Authorization, accounting, etc.
344 case PW_REQUEST_PROCESSING_STAGE:
345 if (request->component) {
346 strlcpy(out, request->component, outlen);
348 strlcpy(out, "server_core", outlen);
352 case PW_PACKET_SRC_IPV6_ADDRESS:
353 if (packet->src_ipaddr.af != AF_INET6) {
356 localvp.attribute = da->attr;
357 memcpy(localvp.vp_strvalue,
358 &packet->src_ipaddr.ipaddr.ip6addr,
359 sizeof(packet->src_ipaddr.ipaddr.ip6addr));
362 case PW_PACKET_DST_IPV6_ADDRESS:
363 if (packet->dst_ipaddr.af != AF_INET6) {
366 localvp.attribute = da->attr;
367 memcpy(localvp.vp_strvalue,
368 &packet->dst_ipaddr.ipaddr.ip6addr,
369 sizeof(packet->dst_ipaddr.ipaddr.ip6addr));
372 case PW_VIRTUAL_SERVER:
373 if (!request->server) return 0;
375 snprintf(out, outlen, "%s", request->server);
379 case PW_MODULE_RETURN_CODE:
380 localvp.attribute = da->attr;
383 * See modcall.c for a bit of a hack.
385 localvp.vp_integer = request->simul_max;
389 return 0; /* not found */
393 localvp.type = da->type;
394 return valuepair2str(out, outlen, &localvp,
404 if (!vps) return 0; /* silently fail */
407 * Convert the VP to a string, and return it.
409 return valuepair2str(out, outlen, vp, da->type, func);
414 * Pull %{0} to %{8} out of the packet.
416 static size_t xlat_regex(void *instance, REQUEST *request,
417 char *fmt, char *out, size_t outlen,
418 RADIUS_ESCAPE_STRING func)
423 * We cheat: fmt is "0" to "8", but those numbers
424 * are already in the "instance".
426 fmt = fmt; /* -Wunused */
427 func = func; /* -Wunused FIXME: do escaping? */
429 regex = request_data_reference(request, request,
430 REQUEST_DATA_REGEX | *(int *)instance);
431 if (!regex) return 0;
434 * Copy UP TO "freespace" bytes, including
437 strlcpy(out, regex, outlen);
440 #endif /* HAVE_REGEX_H */
444 * Change the debugging level.
446 static size_t xlat_debug(UNUSED void *instance, REQUEST *request,
447 char *fmt, char *out, size_t outlen,
448 UNUSED RADIUS_ESCAPE_STRING func)
452 if (*fmt) level = atoi(fmt);
455 request->options = RAD_REQUEST_OPTION_NONE;
456 request->radlog = NULL;
458 if (level > 4) level = 4;
460 request->options = level;
461 request->radlog = radlog_request;
464 snprintf(out, outlen, "%d", level);
470 * Calculate the MD5 hash of a string.
472 static size_t xlat_md5(UNUSED void *instance, REQUEST *request,
473 char *fmt, char *out, size_t outlen,
474 UNUSED RADIUS_ESCAPE_STRING func)
481 if (!radius_xlat(buffer, sizeof(buffer), fmt, request, func)) {
487 fr_MD5Update(&ctx, (void *) buffer, strlen(buffer));
488 fr_MD5Final(digest, &ctx);
491 snprintf(out, outlen, "md5_overflow");
495 for (i = 0; i < 16; i++) {
496 snprintf(out + i * 2, 3, "%02x", digest[i]);
504 * Convert a string to lowercase
506 static size_t xlat_lc(UNUSED void *instance, REQUEST *request,
507 char *fmt, char *out, size_t outlen,
508 UNUSED RADIUS_ESCAPE_STRING func)
513 if (!radius_xlat(buffer, sizeof(buffer), fmt, request, func)) {
518 for (p = buffer, q = out; *p != '\0'; p++, outlen--) {
519 if (outlen <= 1) break;
521 *(q++) = tolower((int) *p);
532 * Compare two xlat_t structs, based ONLY on the module name.
534 static int xlat_cmp(const void *a, const void *b)
536 if (((const xlat_t *)a)->length != ((const xlat_t *)b)->length) {
537 return ((const xlat_t *)a)->length - ((const xlat_t *)b)->length;
540 return memcmp(((const xlat_t *)a)->module,
541 ((const xlat_t *)b)->module,
542 ((const xlat_t *)a)->length);
546 * find the appropriate registered xlat function.
548 static xlat_t *xlat_find(const char *module)
553 * Look for dictionary attributes first.
555 if ((dict_attrbyname(module) != NULL) ||
556 (strchr(module, '[') != NULL) ||
557 (strchr(module, '#') != NULL)) {
561 strlcpy(my_xlat.module, module, sizeof(my_xlat.module));
562 my_xlat.length = strlen(my_xlat.module);
564 return rbtree_finddata(xlat_root, &my_xlat);
569 * Register an xlat function.
571 int xlat_register(const char *module, RAD_XLAT_FUNC func, void *instance)
576 if ((module == NULL) || (strlen(module) == 0)) {
577 DEBUG("xlat_register: Invalid module name");
582 * First time around, build up the tree...
584 * FIXME: This code should be hoisted out of this function,
585 * and into a global "initialization". But it isn't critical...
593 xlat_root = rbtree_create(xlat_cmp, free, 0);
595 DEBUG("xlat_register: Failed to create tree.");
600 * Register the internal packet xlat's.
602 for (i = 0; internal_xlat[i] != NULL; i++) {
603 xlat_register(internal_xlat[i], xlat_packet, &xlat_inst[i]);
604 c = xlat_find(internal_xlat[i]);
605 rad_assert(c != NULL);
610 * New name: "control"
612 xlat_register("control", xlat_packet, &xlat_inst[0]);
613 c = xlat_find("control");
614 rad_assert(c != NULL);
619 * Register xlat's for regexes.
622 for (i = 0; i <= REQUEST_MAX_REGEX; i++) {
624 xlat_register(buffer, xlat_regex, &xlat_inst[i]);
625 c = xlat_find(buffer);
626 rad_assert(c != NULL);
629 #endif /* HAVE_REGEX_H */
632 xlat_register("debug", xlat_debug, &xlat_inst[0]);
633 c = xlat_find("debug");
634 rad_assert(c != NULL);
637 xlat_register("md5", xlat_md5, &xlat_inst[0]);
638 c = xlat_find("md5");
639 rad_assert(c != NULL);
642 xlat_register("tolower", xlat_lc, &xlat_inst[0]);
643 c = xlat_find("tolower");
644 rad_assert(c != NULL);
649 * If it already exists, replace the instance.
651 strlcpy(my_xlat.module, module, sizeof(my_xlat.module));
652 my_xlat.length = strlen(my_xlat.module);
653 c = rbtree_finddata(xlat_root, &my_xlat);
656 DEBUG("xlat_register: Cannot re-define internal xlat");
661 c->instance = instance;
666 * Doesn't exist. Create it.
668 c = rad_malloc(sizeof(*c));
669 memset(c, 0, sizeof(*c));
672 strlcpy(c->module, module, sizeof(c->module));
673 c->length = strlen(c->module);
674 c->instance = instance;
676 rbtree_insert(xlat_root, c);
682 * Unregister an xlat function.
684 * We can only have one function to call per name, so the
685 * passing of "func" here is extraneous.
687 void xlat_unregister(const char *module, RAD_XLAT_FUNC func)
692 func = func; /* -Wunused */
696 strlcpy(my_xlat.module, module, sizeof(my_xlat.module));
697 my_xlat.length = strlen(my_xlat.module);
699 node = rbtree_find(xlat_root, &my_xlat);
702 rbtree_delete(xlat_root, node);
706 * De-register all xlat functions,
707 * used mainly for debugging.
711 rbtree_free(xlat_root);
716 * Decode an attribute name into a string.
718 static int decode_attribute(const char **from, char **to, int freespace,
720 RADIUS_ESCAPE_STRING func)
723 char *xlat_name, *xlat_string;
724 char *p, *q, *l, *next = NULL;
735 * Copy the input string to an intermediate buffer where
738 varlen = rad_copy_variable(buffer, *from);
740 RDEBUG2("Badly formatted variable: %s", *from);
746 * Kill the %{} around the data we are looking for.
749 p[varlen - 1] = '\0'; /* */
757 * Handle %{%{foo}:-%{bar}}, which is useful, too.
759 * Did I mention that this parser is garbage?
761 if ((p[0] == '%') && (p[1] == '{')) {
766 * 'p' is after the start of 'buffer', so we can
769 len1 = rad_copy_variable(buffer, p);
771 RDEBUG2("Badly formatted variable: %s", p);
776 * They did %{%{foo}}, which is stupid, but allowed.
779 RDEBUG2("Improperly nested variable; %%{%s}", p);
784 * It SHOULD be %{%{foo}:-%{bar}}. If not, it's
787 if ((p[len1] != ':') || (p[len1 + 1] != '-')) {
788 RDEBUG2("No trailing :- after variable at %s", p);
793 * Parse the second bit. The second bit can be
794 * either %{foo}, or a string "foo", or a string
795 * 'foo', or just a bare word: foo
798 l = buffer + len1 + 1;
800 if ((p[0] == '%') && (p[1] == '{')) {
801 len2 = rad_copy_variable(l, p);
804 RDEBUG2("Invalid text after :- at %s", p);
810 } else if ((p[0] == '"') || p[0] == '\'') {
811 getstring(&p, l, strlen(l));
818 * Expand the first one. If we did, exit the
821 retlen = radius_xlat(q, freespace, buffer, request, func);
827 RDEBUG2("\t... expanding second conditional");
829 * Expand / copy the second string if required.
832 retlen = radius_xlat(q, freespace, l,
838 strlcpy(q, l, freespace);
843 * Else the output is an empty string.
849 * See if we're supposed to expand a module name.
852 for (l = p; *l != '\0'; l++) {
859 xlat_name = p; /* start of name */
866 * Module names can't have spaces.
868 if ((*l == ' ') || (*l == '\t')) break;
872 * %{name} is a simple attribute reference,
873 * or regex reference.
876 xlat_name = xlat_string = p;
881 * Maybe it's the old-style %{foo:-bar}
884 RDEBUG2("WARNING: Deprecated conditional expansion \":-\". See \"man unlang\" for details");
887 xlat_string = xlat_name;
893 * FIXME: For backwards "WTF" compatibility, check for
894 * {...}, (after the :), and copy that, too.
897 /* module name, followed by (possibly) per-module string */
901 if ((c = xlat_find(xlat_name)) != NULL) {
902 if (!c->internal) RDEBUG3("radius_xlat: Running registered xlat function of module %s for string \'%s\'",
903 c->module, xlat_string);
904 retlen = c->do_xlat(c->instance, request, xlat_string,
908 snprintf(q, freespace, "%d", retlen);
914 * Expand the second bit.
916 RDEBUG2("\t... expanding second conditional");
917 retlen = radius_xlat(q, freespace, next, request, func);
923 * No attribute by that name, return an error.
925 RDEBUG2("WARNING: Unknown module \"%s\" in string expansion \"%%%s\"", xlat_name, *from);
935 * If the caller doesn't pass xlat an escape function, then
936 * we use this one. It simplifies the coding, as the check for
937 * func == NULL only happens once.
939 static size_t xlat_copy(char *out, size_t outlen, const char *in)
941 int freespace = outlen;
943 rad_assert(outlen > 0);
945 while ((*in) && (freespace > 1)) {
949 * FIXME: Do escaping of bad stuff!
957 return (outlen - freespace); /* count does not include NUL */
961 * Replace %<whatever> in a string.
963 * See 'doc/variables.txt' for more information.
965 int radius_xlat(char *out, int outlen, const char *fmt,
966 REQUEST *request, RADIUS_ESCAPE_STRING func)
968 int c, len, freespace;
974 char tmpdt[40]; /* For temporary storing of dates */
980 if (!fmt || !out || !request) return 0;
983 * Ensure that we always have an escaping function.
992 /* Calculate freespace in output */
993 freespace = outlen - (q - out);
998 if ((c != '%') && (c != '$') && (c != '\\')) {
1000 * We check if we're inside an open brace. If we are
1001 * then we assume this brace is NOT literal, but is
1002 * a closing brace and apply it
1004 if ((c == '}') && openbraces) {
1014 * There's nothing after this character, copy
1015 * the last '%' or "$' or '\\' over to the output
1041 } else if (c == '%') switch(*p) {
1044 if (decode_attribute(&p, &q, freespace, request, func) < 0) return 0;
1050 case 'a': /* Protocol: */
1051 q += valuepair2str(q,freespace,pairfind(request->reply->vps,PW_FRAMED_PROTOCOL, 0),PW_TYPE_INTEGER, func);
1054 case 'c': /* Callback-Number */
1055 q += valuepair2str(q,freespace,pairfind(request->reply->vps,PW_CALLBACK_NUMBER, 0),PW_TYPE_STRING, func);
1058 case 'd': /* request day */
1059 TM = localtime_r(&request->timestamp, &s_TM);
1060 len = strftime(tmpdt, sizeof(tmpdt), "%d", TM);
1062 strlcpy(q, tmpdt, freespace);
1067 case 'f': /* Framed IP address */
1068 q += valuepair2str(q,freespace,pairfind(request->reply->vps,PW_FRAMED_IP_ADDRESS, 0),PW_TYPE_IPADDR, func);
1071 case 'i': /* Calling station ID */
1072 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_CALLING_STATION_ID, 0),PW_TYPE_STRING, func);
1075 case 'l': /* request timestamp */
1076 snprintf(tmpdt, sizeof(tmpdt), "%lu",
1077 (unsigned long) request->timestamp);
1078 strlcpy(q,tmpdt,freespace);
1082 case 'm': /* request month */
1083 TM = localtime_r(&request->timestamp, &s_TM);
1084 len = strftime(tmpdt, sizeof(tmpdt), "%m", TM);
1086 strlcpy(q, tmpdt, freespace);
1091 case 'n': /* NAS IP address */
1092 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_NAS_IP_ADDRESS, 0),PW_TYPE_IPADDR, func);
1095 case 'p': /* Port number */
1096 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_NAS_PORT, 0),PW_TYPE_INTEGER, func);
1099 case 's': /* Speed */
1100 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_CONNECT_INFO, 0),PW_TYPE_STRING, func);
1103 case 't': /* request timestamp */
1104 CTIME_R(&request->timestamp, tmpdt, sizeof(tmpdt));
1105 nl = strchr(tmpdt, '\n');
1107 strlcpy(q, tmpdt, freespace);
1111 case 'u': /* User name */
1112 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_USER_NAME, 0),PW_TYPE_STRING, func);
1115 case 'A': /* radacct_dir */
1116 strlcpy(q,radacct_dir,freespace);
1120 case 'C': /* ClientName */
1121 strlcpy(q,request->client->shortname,freespace);
1125 case 'D': /* request date */
1126 TM = localtime_r(&request->timestamp, &s_TM);
1127 len = strftime(tmpdt, sizeof(tmpdt), "%Y%m%d", TM);
1129 strlcpy(q, tmpdt, freespace);
1134 case 'H': /* request hour */
1135 TM = localtime_r(&request->timestamp, &s_TM);
1136 len = strftime(tmpdt, sizeof(tmpdt), "%H", TM);
1138 strlcpy(q, tmpdt, freespace);
1143 case 'L': /* radlog_dir */
1144 strlcpy(q,radlog_dir,freespace);
1149 q += valuepair2str(q,freespace,pairfind(request->reply->vps,PW_FRAMED_MTU, 0),PW_TYPE_INTEGER, func);
1152 case 'R': /* radius_dir */
1153 strlcpy(q,radius_dir,freespace);
1157 case 'S': /* request timestamp in SQL format*/
1158 TM = localtime_r(&request->timestamp, &s_TM);
1159 len = strftime(tmpdt, sizeof(tmpdt), "%Y-%m-%d %H:%M:%S", TM);
1161 strlcpy(q, tmpdt, freespace);
1166 case 'T': /* request timestamp */
1167 TM = localtime_r(&request->timestamp, &s_TM);
1168 len = strftime(tmpdt, sizeof(tmpdt), "%Y-%m-%d-%H.%M.%S.000000", TM);
1170 strlcpy(q, tmpdt, freespace);
1175 case 'U': /* Stripped User name */
1176 q += valuepair2str(q,freespace,pairfind(request->packet->vps,PW_STRIPPED_USER_NAME, 0),PW_TYPE_STRING, func);
1179 case 'V': /* Request-Authenticator */
1180 strlcpy(q,"Verified",freespace);
1184 case 'Y': /* request year */
1185 TM = localtime_r(&request->timestamp, &s_TM);
1186 len = strftime(tmpdt, sizeof(tmpdt), "%Y", TM);
1188 strlcpy(q, tmpdt, freespace);
1193 case 'Z': /* Full request pairs except password */
1194 tmp = request->packet->vps;
1195 while (tmp && (freespace > 3)) {
1196 if (tmp->attribute != PW_USER_PASSWORD) {
1198 len = vp_prints(q, freespace - 2, tmp);
1200 freespace -= (len + 2);
1208 RDEBUG2("WARNING: Unknown variable '%%%c': See 'doc/variables.txt'", *p);
1209 if (freespace > 2) {
1218 RDEBUG2("\texpand: %s -> %s", fmt, out);