Delete trailing whitespace.
[freeradius.git] / src / lib / dict.c
1 /*
2  * dict.c       Routines to read the dictionary file.
3  *
4  * Version:     $Id$
5  *
6  *   This library is free software; you can redistribute it and/or
7  *   modify it under the terms of the GNU Lesser General Public
8  *   License as published by the Free Software Foundation; either
9  *   version 2.1 of the License, or (at your option) any later version.
10  *
11  *   This library 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 GNU
14  *   Lesser General Public License for more details.
15  *
16  *   You should have received a copy of the GNU Lesser General Public
17  *   License along with this library; if not, write to the Free Software
18  *   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19  *
20  * Copyright 2000,2006  The FreeRADIUS server project
21  */
22
23 #include        <freeradius-devel/ident.h>
24 RCSID("$Id$")
25
26 #include        <freeradius-devel/libradius.h>
27
28 #include        <ctype.h>
29
30 #ifdef HAVE_MALLOC_H
31 #include        <malloc.h>
32 #endif
33
34 #ifdef HAVE_SYS_STAT_H
35 #include        <sys/stat.h>
36 #endif
37
38 #define DICT_VALUE_MAX_NAME_LEN (128)
39 #define DICT_VENDOR_MAX_NAME_LEN (128)
40
41 static lrad_hash_table_t *vendors_byname = NULL;
42 static lrad_hash_table_t *vendors_byvalue = NULL;
43
44 static lrad_hash_table_t *attributes_byname = NULL;
45 static lrad_hash_table_t *attributes_byvalue = NULL;
46
47 static lrad_hash_table_t *values_byvalue = NULL;
48 static lrad_hash_table_t *values_byname = NULL;
49
50 static DICT_ATTR *dict_base_attrs[256];
51
52 /*
53  *      For faster HUP's, we cache the stat information for
54  *      files we've $INCLUDEd
55  */
56 typedef struct dict_stat_t {
57         struct dict_stat_t *next;
58         char               *name;
59         time_t             mtime;
60 } dict_stat_t;
61
62 static char *stat_root_dir = NULL;
63 static char *stat_root_file = NULL;
64
65 static dict_stat_t *stat_head = NULL;
66 static dict_stat_t *stat_tail = NULL;
67
68 typedef struct value_fixup_t {
69         char            attrstr[40];
70         DICT_VALUE      *dval;
71         struct value_fixup_t *next;
72 } value_fixup_t;
73
74
75 /*
76  *      So VALUEs in the dictionary can have forward references.
77  */
78 static value_fixup_t *value_fixup = NULL;
79
80 static const LRAD_NAME_NUMBER type_table[] = {
81         { "string",     PW_TYPE_STRING },
82         { "integer",    PW_TYPE_INTEGER },
83         { "ipaddr",     PW_TYPE_IPADDR },
84         { "date",       PW_TYPE_DATE },
85         { "abinary",    PW_TYPE_ABINARY },
86         { "octets",     PW_TYPE_OCTETS },
87         { "ifid",       PW_TYPE_IFID },
88         { "ipv6addr",   PW_TYPE_IPV6ADDR },
89         { "ipv6prefix", PW_TYPE_IPV6PREFIX },
90         { "byte",       PW_TYPE_BYTE },
91         { "short",      PW_TYPE_SHORT },
92         { NULL, 0 }
93 };
94
95
96 /*
97  *      Create the hash of the name.
98  *
99  *      We copy the hash function here because it's substantially faster.
100  */
101 #define FNV_MAGIC_INIT (0x811c9dc5)
102 #define FNV_MAGIC_PRIME (0x01000193)
103
104 static uint32_t dict_hashname(const char *name)
105 {
106         uint32_t hash = FNV_MAGIC_INIT;
107         const char *p;
108
109         for (p = name; *p != '\0'; p++) {
110                 int c = *(const unsigned char *) p;
111                 if (isalpha(c)) c = tolower(c);
112
113                 hash *= FNV_MAGIC_PRIME;
114                 hash ^= (uint32_t ) (c & 0xff);
115         }
116
117         return hash;
118 }
119
120
121 /*
122  *      Hash callback functions.
123  */
124 static uint32_t dict_attr_name_hash(const void *data)
125 {
126         return dict_hashname(((const DICT_ATTR *)data)->name);
127 }
128
129 static int dict_attr_name_cmp(const void *one, const void *two)
130 {
131         const DICT_ATTR *a = one;
132         const DICT_ATTR *b = two;
133
134         return strcasecmp(a->name, b->name);
135 }
136
137 static uint32_t dict_attr_value_hash(const void *data)
138 {
139         uint32_t hash;
140         const DICT_ATTR *attr = data;
141
142         hash = lrad_hash(&attr->vendor, sizeof(attr->vendor));
143         return lrad_hash_update(&attr->attr, sizeof(attr->attr), hash);
144 }
145
146 static int dict_attr_value_cmp(const void *one, const void *two)
147 {
148         const DICT_ATTR *a = one;
149         const DICT_ATTR *b = two;
150
151         if (a->vendor < b->vendor) return -1;
152         if (a->vendor > b->vendor) return +1;
153
154         return a->attr - b->attr;
155 }
156
157 static uint32_t dict_vendor_name_hash(const void *data)
158 {
159         return dict_hashname(((const DICT_VENDOR *)data)->name);
160 }
161
162 static int dict_vendor_name_cmp(const void *one, const void *two)
163 {
164         const DICT_VENDOR *a = one;
165         const DICT_VENDOR *b = two;
166
167         return strcasecmp(a->name, b->name);
168 }
169
170 static uint32_t dict_vendor_value_hash(const void *data)
171 {
172         return lrad_hash(&(((const DICT_VENDOR *)data)->vendorpec),
173                          sizeof(((const DICT_VENDOR *)data)->vendorpec));
174 }
175
176 static int dict_vendor_value_cmp(const void *one, const void *two)
177 {
178         const DICT_VENDOR *a = one;
179         const DICT_VENDOR *b = two;
180
181         return a->vendorpec - b->vendorpec;
182 }
183
184 static uint32_t dict_value_name_hash(const void *data)
185 {
186         uint32_t hash;
187         const DICT_VALUE *dval = data;
188
189         hash = dict_hashname(dval->name);
190         return lrad_hash_update(&dval->attr, sizeof(dval->attr), hash);
191 }
192
193 static int dict_value_name_cmp(const void *one, const void *two)
194 {
195         int rcode;
196         const DICT_VALUE *a = one;
197         const DICT_VALUE *b = two;
198
199         rcode = a->attr - b->attr;
200         if (rcode != 0) return rcode;
201
202         return strcasecmp(a->name, b->name);
203 }
204
205 static uint32_t dict_value_value_hash(const void *data)
206 {
207         uint32_t hash;
208         const DICT_VALUE *dval = data;
209
210         hash = lrad_hash(&dval->attr, sizeof(dval->attr));
211         return lrad_hash_update(&dval->value, sizeof(dval->value), hash);
212 }
213
214 static int dict_value_value_cmp(const void *one, const void *two)
215 {
216         int rcode;
217         const DICT_VALUE *a = one;
218         const DICT_VALUE *b = two;
219
220         rcode = a->attr - b->attr;
221         if (rcode != 0) return rcode;
222
223         return a->value - b->value;
224 }
225
226
227 /*
228  *      Free the list of stat buffers
229  */
230 static void dict_stat_free(void)
231 {
232         dict_stat_t *this, *next;
233
234         free(stat_root_dir);
235         stat_root_dir = NULL;
236         free(stat_root_file);
237         stat_root_file = NULL;
238
239         if (!stat_head) {
240                 stat_tail = NULL;
241                 return;
242         }
243
244         for (this = stat_head; this != NULL; this = next) {
245                 next = this->next;
246                 free(this->name);
247                 free(this);
248         }
249
250         stat_head = stat_tail = NULL;
251 }
252
253
254 /*
255  *      Add an entry to the list of stat buffers.
256  */
257 static void dict_stat_add(const char *name, const struct stat *stat_buf)
258 {
259         dict_stat_t *this;
260
261         this = malloc(sizeof(*this));
262         if (!this) return;
263         memset(this, 0, sizeof(*this));
264
265         this->name = strdup(name);
266         this->mtime = stat_buf->st_mtime;
267
268         if (!stat_head) {
269                 stat_head = stat_tail = this;
270         } else {
271                 stat_tail->next = this;
272                 stat_tail = this;
273         }
274 }
275
276
277 /*
278  *      See if any dictionaries have changed.  If not, don't
279  *      do anything.
280  */
281 static int dict_stat_check(const char *root_dir, const char *root_file)
282 {
283         struct stat buf;
284         dict_stat_t *this;
285
286         if (!stat_root_dir) return 0;
287         if (!stat_root_file) return 0;
288
289         if (strcmp(root_dir, stat_root_dir) != 0) return 0;
290         if (strcmp(root_file, stat_root_file) != 0) return 0;
291
292         if (!stat_head) return 0; /* changed, reload */
293
294         for (this = stat_head; this != NULL; this = this->next) {
295                 if (stat(this->name, &buf) < 0) return 0;
296
297                 if (buf.st_mtime != this->mtime) return 0;
298         }
299
300         return 1;
301 }
302
303
304 /*
305  *      Free the dictionary_attributes and dictionary_values lists.
306  */
307 void dict_free(void)
308 {
309         /*
310          *      Free the tables
311          */
312         lrad_hash_table_free(vendors_byname);
313         lrad_hash_table_free(vendors_byvalue);
314         vendors_byname = NULL;
315         vendors_byvalue = NULL;
316
317         lrad_hash_table_free(attributes_byname);
318         lrad_hash_table_free(attributes_byvalue);
319         attributes_byname = NULL;
320         attributes_byvalue = NULL;
321
322         lrad_hash_table_free(values_byname);
323         lrad_hash_table_free(values_byvalue);
324         values_byname = NULL;
325         values_byvalue = NULL;
326
327         memset(dict_base_attrs, 0, sizeof(dict_base_attrs));
328
329         dict_stat_free();
330 }
331
332
333 /*
334  *      Add vendor to the list.
335  */
336 int dict_addvendor(const char *name, int value)
337 {
338         size_t length;
339         DICT_VENDOR *dv;
340
341         if (value >= 32767) {
342                 librad_log("dict_addvendor: Cannot handle vendor ID larger than 65535");
343                 return -1;
344         }
345
346         if ((length = strlen(name)) >= DICT_VENDOR_MAX_NAME_LEN) {
347                 librad_log("dict_addvendor: vendor name too long");
348                 return -1;
349         }
350
351         if ((dv = malloc(sizeof(*dv) + length)) == NULL) {
352                 librad_log("dict_addvendor: out of memory");
353                 return -1;
354         }
355
356         strcpy(dv->name, name);
357         dv->vendorpec  = value;
358         dv->type = dv->length = 1; /* defaults */
359
360         if (!lrad_hash_table_insert(vendors_byname, dv)) {
361                 DICT_VENDOR *old_dv;
362
363                 old_dv = lrad_hash_table_finddata(vendors_byname, dv);
364                 if (!old_dv) {
365                         librad_log("dict_addvendor: Failed inserting vendor name %s", name);
366                         return -1;
367                 }
368                 if (old_dv->vendorpec != dv->vendorpec) {
369                         librad_log("dict_addvendor: Duplicate vendor name %s", name);
370                         return -1;
371                 }
372
373                 /*
374                  *      Already inserted.  Discard the duplicate entry.
375                  */
376                 free(dv);
377                 return 0;
378         }
379
380         /*
381          *      Insert the SAME pointer (not free'd when this table is
382          *      deleted), into another table.
383          *
384          *      We want this behaviour because we want OLD names for
385          *      the attributes to be read from the configuration
386          *      files, but when we're printing them, (and looking up
387          *      by value) we want to use the NEW name.
388          */
389         if (!lrad_hash_table_replace(vendors_byvalue, dv)) {
390                 librad_log("dict_addvendor: Failed inserting vendor %s",
391                            name);
392                 return -1;
393         }
394
395         return 0;
396 }
397
398 /*
399  *      Add an attribute to the dictionary.
400  */
401 int dict_addattr(const char *name, int vendor, int type, int value,
402                  ATTR_FLAGS flags)
403 {
404         static int      max_attr = 0;
405         DICT_ATTR       *attr;
406
407         if (strlen(name) > (sizeof(attr->name) -1)) {
408                 librad_log("dict_addattr: attribute name too long");
409                 return -1;
410         }
411
412         /*
413          *      If the value is '-1', that means use a pre-existing
414          *      one (if it already exists).  If one does NOT already exist,
415          *      then create a new attribute, with a non-conflicting value,
416          *      and use that.
417          */
418         if (value == -1) {
419                 if (dict_attrbyname(name)) {
420                         return 0; /* exists, don't add it again */
421                 }
422
423                 value = ++max_attr;
424
425         } else if (vendor == 0) {
426                 /*
427                  *  Update 'max_attr'
428                  */
429                 if (value > max_attr) {
430                         max_attr = value;
431                 }
432         }
433
434         if (value < 0) {
435                 librad_log("dict_addattr: ATTRIBUTE has invalid number (less than zero)");
436                 return -1;
437         }
438
439         if (value >= 65536) {
440                 librad_log("dict_addattr: ATTRIBUTE has invalid number (larger than 65535).");
441                 return -1;
442         }
443
444         if (vendor) {
445                 DICT_VENDOR *dv = dict_vendorbyvalue(vendor);
446
447                 /*
448                  *      If the vendor isn't defined, die/
449                  */
450                 if (!dv) {
451                         librad_log("dict_addattr: Unknown vendor");
452                         return -1;
453                 }
454
455                 /*
456                  *      FIXME: Switch over dv->type, and limit things
457                  *      properly.
458                  */
459                 if ((dv->type == 1) && (value >= 256)) {
460                         librad_log("dict_addattr: ATTRIBUTE has invalid number (larger than 255).");
461                         return -1;
462                 } /* else 256..65535 are allowed */
463         }
464
465         /*
466          *      Create a new attribute for the list
467          */
468         if ((attr = malloc(sizeof(*attr))) == NULL) {
469                 librad_log("dict_addattr: out of memory");
470                 return -1;
471         }
472
473         strcpy(attr->name, name);
474         attr->attr = value;
475         attr->attr |= (vendor << 16); /* FIXME: hack */
476         attr->vendor = vendor;
477         attr->type = type;
478         attr->flags = flags;
479         attr->vendor = vendor;
480
481         /*
482          *      Insert the attribute, only if it's not a duplicate.
483          */
484         if (!lrad_hash_table_insert(attributes_byname, attr)) {
485                 DICT_ATTR       *a;
486
487                 /*
488                  *      If the attribute has identical number, then
489                  *      ignore the duplicate.
490                  */
491                 a = lrad_hash_table_finddata(attributes_byname, attr);
492                 if (a && (strcasecmp(a->name, attr->name) == 0)) {
493                         if (a->attr != attr->attr) {
494                                 librad_log("dict_addattr: Duplicate attribute name %s", name);
495                                 free(attr);
496                                 return -1;
497                         }
498
499                         /*
500                          *      Same name, same vendor, same attr,
501                          *      maybe the flags and/or type is
502                          *      different.  Let the new value
503                          *      over-ride the old one.
504                          */
505                 }
506
507
508                 lrad_hash_table_delete(attributes_byvalue, a);
509
510                 if (!lrad_hash_table_replace(attributes_byname, attr)) {
511                         librad_log("dict_addattr: Internal error storing attribute %s", name);
512                         free(attr);
513                         return -1;
514                 }
515         }
516
517         /*
518          *      Insert the SAME pointer (not free'd when this entry is
519          *      deleted), into another table.
520          *
521          *      We want this behaviour because we want OLD names for
522          *      the attributes to be read from the configuration
523          *      files, but when we're printing them, (and looking up
524          *      by value) we want to use the NEW name.
525          */
526         if (!lrad_hash_table_replace(attributes_byvalue, attr)) {
527                 librad_log("dict_addattr: Failed inserting attribute name %s", name);
528                 return -1;
529         }
530
531         if (!vendor && (value > 0) && (value < 256)) {
532                  dict_base_attrs[value] = attr;
533         }
534
535         return 0;
536 }
537
538
539 /*
540  *      Add a value for an attribute to the dictionary.
541  */
542 int dict_addvalue(const char *namestr, const char *attrstr, int value)
543 {
544         size_t          length;
545         DICT_ATTR       *dattr;
546         DICT_VALUE      *dval;
547
548         if (!*namestr) {
549                 librad_log("dict_addvalue: empty names are not permitted");
550                 return -1;
551         }
552
553         if ((length = strlen(namestr)) >= DICT_VALUE_MAX_NAME_LEN) {
554                 librad_log("dict_addvalue: value name too long");
555                 return -1;
556         }
557
558         if ((dval = malloc(sizeof(*dval) + length)) == NULL) {
559                 librad_log("dict_addvalue: out of memory");
560                 return -1;
561         }
562         memset(dval, 0, sizeof(*dval));
563
564         strcpy(dval->name, namestr);
565         dval->value = value;
566
567         /*
568          *      Remember which attribute is associated with this
569          *      value, if possible.
570          */
571         dattr = dict_attrbyname(attrstr);
572         if (dattr) {
573                 if (dattr->flags.has_value_alias) {
574                         librad_log("dict_addvalue: Cannot add VALUE for ATTRIBUTE \"%s\": It already has a VALUE-ALIAS", attrstr);
575                         return -1;
576                 }
577
578                 dval->attr = dattr->attr;
579
580                 /*
581                  *      Enforce valid values
582                  *
583                  *      Don't worry about fixups...
584                  */
585                 switch (dattr->type) {
586                         case PW_TYPE_BYTE:
587                                 if (value > 255) {
588                                         librad_log("dict_addvalue: ATTRIBUTEs of type 'byte' cannot have VALUEs larger than 255");
589                                         return -1;
590                                 }
591                                 break;
592                         case PW_TYPE_SHORT:
593                                 if (value > 65535) {
594                                         librad_log("dict_addvalue: ATTRIBUTEs of type 'short' cannot have VALUEs larger than 65535");
595                                         return -1;
596                                 }
597                                 break;
598
599                                 /*
600                                  *      Allow octets for now, because
601                                  *      of dictionary.cablelabs
602                                  */
603                         case PW_TYPE_OCTETS:
604
605                         case PW_TYPE_INTEGER:
606                                 break;
607
608                         default:
609                                 librad_log("dict_addvalue: VALUEs cannot be defined for attributes of type '%s'",
610                                            lrad_int2str(type_table, dattr->type, "?Unknown?"));
611                                 return -1;
612                 }
613
614                 dattr->flags.has_value = 1;
615         } else {
616                 value_fixup_t *fixup;
617
618                 fixup = (value_fixup_t *) malloc(sizeof(*fixup));
619                 if (!fixup) {
620                         librad_log("dict_addvalue: out of memory");
621                         return -1;
622                 }
623                 memset(fixup, 0, sizeof(*fixup));
624
625                 strlcpy(fixup->attrstr, attrstr, sizeof(fixup->attrstr));
626                 fixup->dval = dval;
627
628                 /*
629                  *      Insert to the head of the list.
630                  */
631                 fixup->next = value_fixup;
632                 value_fixup = fixup;
633
634                 return 0;
635         }
636
637         /*
638          *      Add the value into the dictionary.
639          */
640         if (!lrad_hash_table_insert(values_byname, dval)) {
641                 if (dattr) {
642                         DICT_VALUE *old;
643
644                         /*
645                          *      Suppress duplicates with the same
646                          *      name and value.  There are lots in
647                          *      dictionary.ascend.
648                          */
649                         old = dict_valbyname(dattr->attr, namestr);
650                         if (old && (old->value == dval->value)) {
651                                 free(dval);
652                                 return 0;
653                         }
654                 }
655
656                 librad_log("dict_addvalue: Duplicate value name %s for attribute %s", namestr, attrstr);
657                 return -1;
658         }
659
660         /*
661          *      There are multiple VALUE's, keyed by attribute, so we
662          *      take care of that here.
663          */
664         if (!lrad_hash_table_replace(values_byvalue, dval)) {
665                 librad_log("dict_addvalue: Failed inserting value %s",
666                            namestr);
667                 return -1;
668         }
669
670         return 0;
671 }
672
673 /*
674  *      Process the ATTRIBUTE command
675  */
676 static int process_attribute(const char* fn, const int line,
677                              const int block_vendor, char **argv,
678                              int argc)
679 {
680         int             vendor = 0;
681         int             value;
682         int             type;
683         char            *s, *c;
684         ATTR_FLAGS      flags;
685
686         if ((argc < 3) || (argc > 4)) {
687                 librad_log("dict_init: %s[%d]: invalid ATTRIBUTE line",
688                         fn, line);
689                 return -1;
690         }
691
692         /*
693          *      Validate all entries
694          */
695         if (!isdigit((int) argv[1][0])) {
696                 librad_log("dict_init: %s[%d]: invalid value", fn, line);
697                 return -1;
698         }
699         sscanf(argv[1], "%i", &value);
700
701         /*
702          *      find the type of the attribute.
703          */
704         type = lrad_str2int(type_table, argv[2], -1);
705         if (type < 0) {
706                 librad_log("dict_init: %s[%d]: invalid type \"%s\"",
707                         fn, line, argv[2]);
708                 return -1;
709         }
710
711         /*
712          *      Only look up the vendor if the string
713          *      is non-empty.
714          */
715         memset(&flags, 0, sizeof(flags));
716         if (argc == 4) {
717                 /*
718                  *      FIXME: replace strtok with str2argv
719                  */
720                 s = strtok(argv[3], ",");
721                 while (s) {
722                         if (strcmp(s, "has_tag") == 0 ||
723                             strcmp(s, "has_tag=1") == 0) {
724                                 /* Boolean flag, means this is a
725                                    tagged attribute */
726                                 flags.has_tag = 1;
727
728                         } else if (strncmp(s, "encrypt=", 8) == 0) {
729                                 /* Encryption method, defaults to 0 (none).
730                                    Currently valid is just type 2,
731                                    Tunnel-Password style, which can only
732                                    be applied to strings. */
733                                 flags.encrypt = strtol(s + 8, &c, 0);
734                                 if (*c) {
735                                         librad_log( "dict_init: %s[%d] invalid option %s",
736                                                     fn, line, s);
737                                         return -1;
738                                 }
739
740                         } else if (strncmp(s, "array", 8) == 0) {
741                                 flags.array = 1;
742
743                                 switch (type) {
744                                         case PW_TYPE_IPADDR:
745                                         case PW_TYPE_BYTE:
746                                         case PW_TYPE_SHORT:
747                                         case PW_TYPE_INTEGER:
748                                         case PW_TYPE_DATE:
749                                                 break;
750
751                                         default:
752                                                 librad_log( "dict_init: %s[%d] Only IP addresses can have the \"array\" flag set.",
753                                                             fn, line);
754                                                 return -1;
755                                 }
756
757                         } else if (block_vendor) {
758                                 librad_log( "dict_init: %s[%d]: unknown option \"%s\"",
759                                             fn, line, s);
760                                 return -1;
761
762                         } else {
763                                 /* Must be a vendor 'flag'... */
764                                 if (strncmp(s, "vendor=", 7) == 0) {
765                                         /* New format */
766                                         s += 7;
767                                 }
768
769                                 vendor = dict_vendorbyname(s);
770                                 if (!vendor) {
771                                         librad_log( "dict_init: %s[%d]: unknown vendor \"%s\"",
772                                                     fn, line, s);
773                                         return -1;
774                                 }
775                                 if (block_vendor && argv[3][0] &&
776                                     (block_vendor != vendor)) {
777                                         librad_log("dict_init: %s[%d]: mismatched vendor %s within BEGIN-VENDOR/END-VENDOR block",
778                                                    fn, line, argv[3]);
779                                         return -1;
780                                 }
781                         }
782                         s = strtok(NULL, ",");
783                 }
784         }
785
786         if (block_vendor) vendor = block_vendor;
787
788         /*
789          *      Special checks for tags, they make our life much more
790          *      difficult.
791          */
792         if (flags.has_tag) {
793                 /*
794                  *      Only string, octets, and integer can be tagged.
795                  */
796                 switch (type) {
797                 case PW_TYPE_STRING:
798                 case PW_TYPE_INTEGER:
799                         break;
800
801                 default:
802                         librad_log("dict_init: %s[%d]: Attributes of type %s cannot be tagged.",
803                                    fn, line,
804                                    lrad_int2str(type_table, type, "?Unknown?"));
805                         return -1;
806
807                 }
808         }
809
810         /*
811          *      Add it in.
812          */
813         if (dict_addattr(argv[0], vendor, type, value, flags) < 0) {
814                 librad_log("dict_init: %s[%d]: %s",
815                            fn, line, librad_errstr);
816                 return -1;
817         }
818
819         return 0;
820 }
821
822
823 /*
824  *      Process the VALUE command
825  */
826 static int process_value(const char* fn, const int line, char **argv,
827                          int argc)
828 {
829         int     value;
830
831         if (argc != 3) {
832                 librad_log("dict_init: %s[%d]: invalid VALUE line",
833                         fn, line);
834                 return -1;
835         }
836         /*
837          *      For Compatibility, skip "Server-Config"
838          */
839         if (strcasecmp(argv[0], "Server-Config") == 0)
840                 return 0;
841
842         /*
843          *      Validate all entries
844          */
845         if (!isdigit((int) argv[2][0])) {
846                 librad_log("dict_init: %s[%d]: invalid value",
847                         fn, line);
848                 return -1;
849         }
850         sscanf(argv[2], "%i", &value);
851
852         if (dict_addvalue(argv[1], argv[0], value) < 0) {
853                 librad_log("dict_init: %s[%d]: %s",
854                            fn, line, librad_errstr);
855                 return -1;
856         }
857
858         return 0;
859 }
860
861
862 /*
863  *      Process the VALUE-ALIAS command
864  *
865  *      This allows VALUE mappings to be shared among multiple
866  *      attributes.
867  */
868 static int process_value_alias(const char* fn, const int line, char **argv,
869                                int argc)
870 {
871         DICT_ATTR *my_da, *da;
872         DICT_VALUE *dval;
873
874         if (argc != 2) {
875                 librad_log("dict_init: %s[%d]: invalid VALUE-ALIAS line",
876                         fn, line);
877                 return -1;
878         }
879
880         my_da = dict_attrbyname(argv[0]);
881         if (!my_da) {
882                 librad_log("dict_init: %s[%d]: ATTRIBUTE \"%s\" does not exist",
883                            fn, line, argv[1]);
884                 return -1;
885         }
886
887         if (my_da->flags.has_value) {
888                 librad_log("dict_init: %s[%d]: Cannot add VALUE-ALIAS to ATTRIBUTE \"%s\" with pre-existing VALUE",
889                            fn, line, argv[0]);
890                 return -1;
891         }
892
893         if (my_da->flags.has_value_alias) {
894                 librad_log("dict_init: %s[%d]: Cannot add VALUE-ALIAS to ATTRIBUTE \"%s\" with pre-existing VALUE-ALIAS",
895                            fn, line, argv[0]);
896                 return -1;
897         }
898
899         da = dict_attrbyname(argv[1]);
900         if (!da) {
901                 librad_log("dict_init: %s[%d]: Cannot find ATTRIBUTE \"%s\" for alias",
902                            fn, line, argv[1]);
903                 return -1;
904         }
905
906         if (!da->flags.has_value) {
907                 librad_log("dict_init: %s[%d]: VALUE-ALIAS cannot refer to ATTRIBUTE %s: It has no values",
908                            fn, line, argv[1]);
909                 return -1;
910         }
911
912         if (da->flags.has_value_alias) {
913                 librad_log("dict_init: %s[%d]: Cannot add VALUE-ALIAS to ATTRIBUTE \"%s\" which itself has a VALUE-ALIAS",
914                            fn, line, argv[1]);
915                 return -1;
916         }
917
918         if (my_da->type != da->type) {
919                 librad_log("dict_init: %s[%d]: Cannot add VALUE-ALIAS between attributes of differing type",
920                            fn, line);
921                 return -1;
922         }
923
924         if ((dval = malloc(sizeof(*dval))) == NULL) {
925                 librad_log("dict_addvalue: out of memory");
926                 return -1;
927         }
928         memset(dval, 0, sizeof(*dval));
929
930         dval->name[0] = '\0';   /* empty name */
931         dval->attr = my_da->attr;
932         dval->value = da->attr;
933
934         if (!lrad_hash_table_insert(values_byname, dval)) {
935                 librad_log("dict_init: %s[%d]: Error create alias",
936                            fn, line);
937                 free(dval);
938                 return -1;
939         }
940
941         return 0;
942 }
943
944
945 /*
946  *      Process the VENDOR command
947  */
948 static int process_vendor(const char* fn, const int line, char **argv,
949                           int argc)
950 {
951         int     value;
952         const   char *format = NULL;
953
954         if ((argc < 2) || (argc > 3)) {
955                 librad_log( "dict_init: %s[%d] invalid VENDOR entry",
956                             fn, line);
957                 return -1;
958         }
959
960         /*
961          *       Validate all entries
962          */
963         if (!isdigit((int) argv[1][0])) {
964                 librad_log("dict_init: %s[%d]: invalid value",
965                         fn, line);
966                 return -1;
967         }
968         value = atoi(argv[1]);
969
970         /* Create a new VENDOR entry for the list */
971         if (dict_addvendor(argv[0], value) < 0) {
972                 librad_log("dict_init: %s[%d]: %s",
973                            fn, line, librad_errstr);
974                 return -1;
975         }
976
977         /*
978          *      Look for a format statement
979          */
980         if (argc == 3) {
981                 format = argv[2];
982
983         } else if (value == VENDORPEC_USR) { /* catch dictionary screw-ups */
984                 format = "format=4,0";
985
986         } else if (value == VENDORPEC_LUCENT) {
987                 format = "format=2,1";
988
989         } else if (value == VENDORPEC_STARENT) {
990                 format = "format=2,2";
991
992         } /* else no fixups to do */
993
994         if (format) {
995                 int type, length;
996                 const char *p;
997                 DICT_VENDOR *dv;
998
999                 if (strncasecmp(format, "format=", 7) != 0) {
1000                         librad_log("dict_init: %s[%d]: Invalid format for VENDOR.  Expected \"format=\", got \"%s\"",
1001                                    fn, line, format);
1002                         return -1;
1003                 }
1004
1005                 p = format + 7;
1006                 if ((strlen(p) != 3) ||
1007                     !isdigit((int) p[0]) ||
1008                     (p[1] != ',') ||
1009                     !isdigit((int) p[2])) {
1010                         librad_log("dict_init: %s[%d]: Invalid format for VENDOR.  Expected text like \"1,1\", got \"%s\"",
1011                                    fn, line, p);
1012                         return -1;
1013                 }
1014
1015                 type = (int) (p[0] - '0');
1016                 length = (int) (p[2] - '0');
1017
1018                 dv = dict_vendorbyvalue(value);
1019                 if (!dv) {
1020                         librad_log("dict_init: %s[%d]: Failed adding format for VENDOR",
1021                                    fn, line);
1022                         return -1;
1023                 }
1024
1025                 if ((type != 1) && (type != 2) && (type != 4)) {
1026                         librad_log("dict_init: %s[%d]: invalid type value %d for VENDOR",
1027                                    fn, line, type);
1028                         return -1;
1029                 }
1030
1031                 if ((length != 0) && (length != 1) && (length != 2)) {
1032                         librad_log("dict_init: %s[%d]: invalid length value %d for VENDOR",
1033                                    fn, line, length);
1034                         return -1;
1035                 }
1036
1037                 dv->type = type;
1038                 dv->length = length;
1039         }
1040
1041         return 0;
1042 }
1043
1044 /*
1045  *      String split routine.  Splits an input string IN PLACE
1046  *      into pieces, based on spaces.
1047  */
1048 static int str2argv(char *str, char **argv, int max_argc)
1049 {
1050         int argc = 0;
1051
1052         while (*str) {
1053                 if (argc >= max_argc) return argc;
1054
1055                 /*
1056                  *      Chop out comments early.
1057                  */
1058                 if (*str == '#') {
1059                         *str = '\0';
1060                         break;
1061                 }
1062
1063                 while ((*str == ' ') ||
1064                        (*str == '\t') ||
1065                        (*str == '\r') ||
1066                        (*str == '\n')) *(str++) = '\0';
1067
1068                 if (!*str) return argc;
1069
1070                 argv[argc] = str;
1071                 argc++;
1072
1073                 while (*str &&
1074                        (*str != ' ') &&
1075                        (*str != '\t') &&
1076                        (*str != '\r') &&
1077                        (*str != '\n')) str++;
1078         }
1079
1080         return argc;
1081 }
1082
1083 #define MAX_ARGV (16)
1084
1085 /*
1086  *      Initialize the dictionary.
1087  */
1088 static int my_dict_init(const char *dir, const char *fn,
1089                         const char *src_file, int src_line)
1090 {
1091         FILE    *fp;
1092         char    dirtmp[256];
1093         char    buf[256];
1094         char    *p;
1095         int     line = 0;
1096         int     vendor;
1097         int     block_vendor;
1098         struct stat statbuf;
1099         char    *argv[MAX_ARGV];
1100         int     argc;
1101
1102         if (strlen(fn) >= sizeof(dirtmp) / 2 ||
1103             strlen(dir) >= sizeof(dirtmp) / 2) {
1104                 librad_log("dict_init: filename name too long");
1105                 return -1;
1106         }
1107
1108         /*
1109          *      First see if fn is relative to dir. If so, create
1110          *      new filename. If not, remember the absolute dir.
1111          */
1112         if ((p = strrchr(fn, '/')) != NULL) {
1113                 strcpy(dirtmp, fn);
1114                 dirtmp[p - fn] = 0;
1115                 dir = dirtmp;
1116         } else if (dir && dir[0] && strcmp(dir, ".") != 0) {
1117                 snprintf(dirtmp, sizeof(dirtmp), "%s/%s", dir, fn);
1118                 fn = dirtmp;
1119         }
1120
1121         if ((fp = fopen(fn, "r")) == NULL) {
1122                 if (!src_file) {
1123                         librad_log("dict_init: Couldn't open dictionary \"%s\": %s",
1124                                    fn, strerror(errno));
1125                 } else {
1126                         librad_log("dict_init: %s[%d]: Couldn't open dictionary \"%s\": %s",
1127                                    src_file, src_line, fn, strerror(errno));
1128                 }
1129                 return -1;
1130         }
1131
1132         stat(fn, &statbuf); /* fopen() guarantees this will succeed */
1133         if (!S_ISREG(statbuf.st_mode)) {
1134                 fclose(fp);
1135                 librad_log("dict_init: Dictionary \"%s\" is not a regular file",
1136                            fn);
1137                 return -1;
1138         }
1139
1140         /*
1141          *      Globally writable dictionaries means that users can control
1142          *      the server configuration with little difficulty.
1143          */
1144 #ifdef S_IWOTH
1145         if ((statbuf.st_mode & S_IWOTH) != 0) {
1146                 fclose(fp);
1147                 librad_log("dict_init: Dictionary \"%s\" is globally writable.  Refusing to start due to insecure configuration.",
1148                            fn);
1149                 return -1;
1150         }
1151 #endif
1152
1153         dict_stat_add(fn, &statbuf);
1154
1155         /*
1156          *      Seed the random pool with data.
1157          */
1158         lrad_rand_seed(&statbuf, sizeof(statbuf));
1159
1160         block_vendor = 0;
1161
1162         while (fgets(buf, sizeof(buf), fp) != NULL) {
1163                 line++;
1164                 if (buf[0] == '#' || buf[0] == 0 ||
1165                     buf[0] == '\n' || buf[0] == '\r')
1166                         continue;
1167
1168                 /*
1169                  *  Comment characters should NOT be appearing anywhere but
1170                  *  as start of a comment;
1171                  */
1172                 p = strchr(buf, '#');
1173                 if (p) *p = '\0';
1174
1175                 argc = str2argv(buf, argv, MAX_ARGV);
1176                 if (argc == 0) continue;
1177
1178                 if (argc == 1) {
1179                         librad_log( "dict_init: %s[%d] invalid entry",
1180                                     fn, line);
1181                         fclose(fp);
1182                         return -1;
1183                 }
1184
1185                 if (0) {
1186                         int i;
1187
1188                         fprintf(stderr, "ARGC = %d\n",argc);
1189                         for (i = 0; i < argc; i++) {
1190                                 fprintf(stderr, "\t%s\n", argv[i]);
1191                         }
1192                 }
1193
1194                 /*
1195                  *      See if we need to import another dictionary.
1196                  */
1197                 if (strcasecmp(argv[0], "$INCLUDE") == 0) {
1198                         if (my_dict_init(dir, argv[1], fn, line) < 0) {
1199                                 fclose(fp);
1200                                 return -1;
1201                         }
1202                         continue;
1203                 } /* $INCLUDE */
1204
1205                 /*
1206                  *      Perhaps this is an attribute.
1207                  */
1208                 if (strcasecmp(argv[0], "ATTRIBUTE") == 0) {
1209                         if (process_attribute(fn, line, block_vendor,
1210                                               argv + 1, argc - 1) == -1) {
1211                                 fclose(fp);
1212                                 return -1;
1213                         }
1214                         continue;
1215                 }
1216
1217                 /*
1218                  *      Process VALUE lines.
1219                  */
1220                 if (strcasecmp(argv[0], "VALUE") == 0) {
1221                         if (process_value(fn, line,
1222                                           argv + 1, argc - 1) == -1) {
1223                                 fclose(fp);
1224                                 return -1;
1225                         }
1226                         continue;
1227                 }
1228
1229                 if (strcasecmp(argv[0], "VALUE-ALIAS") == 0) {
1230                         if (process_value_alias(fn, line,
1231                                                 argv + 1, argc - 1) == -1) {
1232                                 fclose(fp);
1233                                 return -1;
1234                         }
1235                         continue;
1236                 }
1237
1238                 /*
1239                  *      Process VENDOR lines.
1240                  */
1241                 if (strcasecmp(argv[0], "VENDOR") == 0) {
1242                         if (process_vendor(fn, line,
1243                                            argv + 1, argc - 1) == -1) {
1244                                 fclose(fp);
1245                                 return -1;
1246                         }
1247                         continue;
1248                 }
1249
1250                 if (strcasecmp(argv[0], "BEGIN-VENDOR") == 0) {
1251                         if (argc != 2) {
1252                                 librad_log(
1253                                 "dict_init: %s[%d] invalid BEGIN-VENDOR entry",
1254                                         fn, line);
1255                                 fclose(fp);
1256                                 return -1;
1257                         }
1258
1259                         vendor = dict_vendorbyname(argv[1]);
1260                         if (!vendor) {
1261                                 librad_log(
1262                                         "dict_init: %s[%d]: unknown vendor %s",
1263                                         fn, line, argv[1]);
1264                                 fclose(fp);
1265                                 return -1;
1266                         }
1267                         block_vendor = vendor;
1268                         continue;
1269                 } /* BEGIN-VENDOR */
1270
1271                 if (strcasecmp(argv[0], "END-VENDOR") == 0) {
1272                         if (argc != 2) {
1273                                 librad_log(
1274                                 "dict_init: %s[%d] invalid END-VENDOR entry",
1275                                         fn, line);
1276                                 fclose(fp);
1277                                 return -1;
1278                         }
1279
1280                         vendor = dict_vendorbyname(argv[1]);
1281                         if (!vendor) {
1282                                 librad_log(
1283                                         "dict_init: %s[%d]: unknown vendor %s",
1284                                         fn, line, argv[1]);
1285                                 fclose(fp);
1286                                 return -1;
1287                         }
1288
1289                         if (vendor != block_vendor) {
1290                                 librad_log(
1291                                         "dict_init: %s[%d]: END-VENDOR %s does not match any previous BEGIN-VENDOR",
1292                                         fn, line, argv[1]);
1293                                 fclose(fp);
1294                                 return -1;
1295                         }
1296                         block_vendor = 0;
1297                         continue;
1298                 } /* END-VENDOR */
1299
1300                 /*
1301                  *      Any other string: We don't recognize it.
1302                  */
1303                 librad_log(
1304                         "dict_init: %s[%d] invalid keyword \"%s\"",
1305                         fn, line, argv[0]);
1306                 fclose(fp);
1307                 return -1;
1308         }
1309         fclose(fp);
1310         return 0;
1311 }
1312
1313
1314 /*
1315  *      Empty callback for hash table initialization.
1316  */
1317 static int null_callback(void *ctx, void *data)
1318 {
1319         ctx = ctx;              /* -Wunused */
1320         data = data;            /* -Wunused */
1321
1322         return 0;
1323 }
1324
1325
1326 /*
1327  *      Initialize the directory, then fix the attr member of
1328  *      all attributes.
1329  */
1330 int dict_init(const char *dir, const char *fn)
1331 {
1332         /*
1333          *      Check if we need to change anything.  If not, don't do
1334          *      anything.
1335          */
1336         if (dict_stat_check(dir, fn)) {
1337                 return 0;
1338         }
1339
1340         /*
1341          *      Free the dictionaries, and the stat cache.
1342          */
1343         dict_free();
1344         stat_root_dir = strdup(dir);
1345         stat_root_file = strdup(fn);
1346
1347         /*
1348          *      Create the table of vendor by name.   There MAY NOT
1349          *      be multiple vendors of the same name.
1350          *
1351          *      Each vendor is malloc'd, so the free function is free.
1352          */
1353         vendors_byname = lrad_hash_table_create(dict_vendor_name_hash,
1354                                                 dict_vendor_name_cmp,
1355                                                 free);
1356         if (!vendors_byname) {
1357                 return -1;
1358         }
1359
1360         /*
1361          *      Create the table of vendors by value.  There MAY
1362          *      be vendors of the same value.  If there are, we
1363          *      pick the latest one.
1364          */
1365         vendors_byvalue = lrad_hash_table_create(dict_vendor_value_hash,
1366                                                  dict_vendor_value_cmp,
1367                                                  NULL);
1368         if (!vendors_byvalue) {
1369                 return -1;
1370         }
1371
1372         /*
1373          *      Create the table of attributes by name.   There MAY NOT
1374          *      be multiple attributes of the same name.
1375          *
1376          *      Each attribute is malloc'd, so the free function is free.
1377          */
1378         attributes_byname = lrad_hash_table_create(dict_attr_name_hash,
1379                                                    dict_attr_name_cmp,
1380                                                    free);
1381         if (!attributes_byname) {
1382                 return -1;
1383         }
1384
1385         /*
1386          *      Create the table of attributes by value.  There MAY
1387          *      be attributes of the same value.  If there are, we
1388          *      pick the latest one.
1389          */
1390         attributes_byvalue = lrad_hash_table_create(dict_attr_value_hash,
1391                                                     dict_attr_value_cmp,
1392                                                     NULL);
1393         if (!attributes_byvalue) {
1394                 return -1;
1395         }
1396
1397         values_byname = lrad_hash_table_create(dict_value_name_hash,
1398                                                dict_value_name_cmp,
1399                                                free);
1400         if (!values_byname) {
1401                 return -1;
1402         }
1403
1404         values_byvalue = lrad_hash_table_create(dict_value_value_hash,
1405                                                 dict_value_value_cmp,
1406                                                 NULL);
1407         if (!values_byvalue) {
1408                 return -1;
1409         }
1410
1411         value_fixup = NULL;     /* just to be safe. */
1412
1413         if (my_dict_init(dir, fn, NULL, 0) < 0)
1414                 return -1;
1415
1416         if (value_fixup) {
1417                 DICT_ATTR *a;
1418                 value_fixup_t *this, *next;
1419
1420                 for (this = value_fixup; this != NULL; this = next) {
1421                         next = this->next;
1422
1423                         a = dict_attrbyname(this->attrstr);
1424                         if (!a) {
1425                                 librad_log(
1426                                         "dict_init: No ATTRIBUTE \"%s\" defined for VALUE \"%s\"",
1427                                         this->attrstr, this->dval->name);
1428                                 return -1; /* leak, but they should die... */
1429                         }
1430
1431                         this->dval->attr = a->attr;
1432
1433                         /*
1434                          *      Add the value into the dictionary.
1435                          */
1436                         if (!lrad_hash_table_replace(values_byname,
1437                                                      this->dval)) {
1438                                 librad_log("dict_addvalue: Duplicate value name %s for attribute %s", this->dval->name, a->name);
1439                                 return -1;
1440                         }
1441
1442                         /*
1443                          *      Allow them to use the old name, but
1444                          *      prefer the new name when printing
1445                          *      values.
1446                          */
1447                         if (!lrad_hash_table_finddata(values_byvalue, this->dval)) {
1448                                 lrad_hash_table_replace(values_byvalue,
1449                                                         this->dval);
1450                         }
1451                         free(this);
1452
1453                         /*
1454                          *      Just so we don't lose track of things.
1455                          */
1456                         value_fixup = next;
1457                 }
1458         }
1459
1460         /*
1461          *      Walk over all of the hash tables to ensure they're
1462          *      initialized.  We do this because the threads may perform
1463          *      lookups, and we don't want multi-threaded re-ordering
1464          *      of the table entries.  That would be bad.
1465          */
1466         lrad_hash_table_walk(vendors_byname, null_callback, NULL);
1467         lrad_hash_table_walk(vendors_byvalue, null_callback, NULL);
1468
1469         lrad_hash_table_walk(attributes_byname, null_callback, NULL);
1470         lrad_hash_table_walk(attributes_byvalue, null_callback, NULL);
1471
1472         lrad_hash_table_walk(values_byvalue, null_callback, NULL);
1473         lrad_hash_table_walk(values_byname, null_callback, NULL);
1474
1475         return 0;
1476 }
1477
1478 /*
1479  *      Get an attribute by its numerical value.
1480  */
1481 DICT_ATTR *dict_attrbyvalue(int attr)
1482 {
1483         DICT_ATTR dattr;
1484
1485         if ((attr > 0) && (attr < 256)) return dict_base_attrs[attr];
1486
1487         dattr.attr = attr;
1488         dattr.vendor = VENDOR(attr) & 0x7fff;
1489
1490         return lrad_hash_table_finddata(attributes_byvalue, &dattr);
1491 }
1492
1493 /*
1494  *      Get an attribute by its name.
1495  */
1496 DICT_ATTR *dict_attrbyname(const char *name)
1497 {
1498         DICT_ATTR dattr;
1499
1500         if (!name) return NULL;
1501
1502         strlcpy(dattr.name, name, sizeof(dattr.name));
1503
1504         return lrad_hash_table_finddata(attributes_byname, &dattr);
1505 }
1506
1507 /*
1508  *      Associate a value with an attribute and return it.
1509  */
1510 DICT_VALUE *dict_valbyattr(int attr, int value)
1511 {
1512         DICT_VALUE dval, *dv;
1513
1514         /*
1515          *      First, look up aliases.
1516          */
1517         dval.attr = attr;
1518         dval.name[0] = '\0';
1519
1520         /*
1521          *      Look up the attribute alias target, and use
1522          *      the correct attribute number if found.
1523          */
1524         dv = lrad_hash_table_finddata(values_byname, &dval);
1525         if (dv) dval.attr = dv->value;
1526
1527         dval.value = value;
1528
1529         return lrad_hash_table_finddata(values_byvalue, &dval);
1530 }
1531
1532 /*
1533  *      Get a value by its name, keyed off of an attribute.
1534  */
1535 DICT_VALUE *dict_valbyname(int attr, const char *name)
1536 {
1537         DICT_VALUE *my_dv, *dv;
1538         uint32_t buffer[(sizeof(*my_dv) + DICT_VALUE_MAX_NAME_LEN + 3)/4];
1539
1540         if (!name) return NULL;
1541
1542         my_dv = (DICT_VALUE *) buffer;
1543         my_dv->attr = attr;
1544         my_dv->name[0] = '\0';
1545
1546         /*
1547          *      Look up the attribute alias target, and use
1548          *      the correct attribute number if found.
1549          */
1550         dv = lrad_hash_table_finddata(values_byname, my_dv);
1551         if (dv) my_dv->attr = dv->value;
1552
1553         strlcpy(my_dv->name, name, DICT_VALUE_MAX_NAME_LEN);
1554
1555         return lrad_hash_table_finddata(values_byname, my_dv);
1556 }
1557
1558 /*
1559  *      Get the vendor PEC based on the vendor name
1560  *
1561  *      This is efficient only for small numbers of vendors.
1562  */
1563 int dict_vendorbyname(const char *name)
1564 {
1565         DICT_VENDOR *dv;
1566         uint32_t buffer[(sizeof(*dv) + DICT_VENDOR_MAX_NAME_LEN + 3)/4];
1567
1568         if (!name) return 0;
1569
1570         dv = (DICT_VENDOR *) buffer;
1571         strlcpy(dv->name, name, DICT_VENDOR_MAX_NAME_LEN);
1572
1573         dv = lrad_hash_table_finddata(vendors_byname, dv);
1574         if (!dv) return 0;
1575
1576         return dv->vendorpec;
1577 }
1578
1579 /*
1580  *      Return the vendor struct based on the PEC.
1581  */
1582 DICT_VENDOR *dict_vendorbyvalue(int vendorpec)
1583 {
1584         DICT_VENDOR dv;
1585
1586         dv.vendorpec = vendorpec;
1587
1588         return lrad_hash_table_finddata(vendors_byvalue, &dv);
1589 }