2 * Copyright 2002-2023 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
10 #include <openssl/asn1.h>
11 #include <openssl/x509v3.h>
12 #include "internal/cryptlib.h"
13 #include "crypto/asn1.h"
15 #define ASN1_GEN_FLAG 0x10000
16 #define ASN1_GEN_FLAG_IMP (ASN1_GEN_FLAG|1)
17 #define ASN1_GEN_FLAG_EXP (ASN1_GEN_FLAG|2)
18 #define ASN1_GEN_FLAG_TAG (ASN1_GEN_FLAG|3)
19 #define ASN1_GEN_FLAG_BITWRAP (ASN1_GEN_FLAG|4)
20 #define ASN1_GEN_FLAG_OCTWRAP (ASN1_GEN_FLAG|5)
21 #define ASN1_GEN_FLAG_SEQWRAP (ASN1_GEN_FLAG|6)
22 #define ASN1_GEN_FLAG_SETWRAP (ASN1_GEN_FLAG|7)
23 #define ASN1_GEN_FLAG_FORMAT (ASN1_GEN_FLAG|8)
25 #define ASN1_GEN_STR(str,val) {str, sizeof(str) - 1, val}
27 #define ASN1_FLAG_EXP_MAX 20
28 /* Maximum number of nested sequences */
29 #define ASN1_GEN_SEQ_MAX_DEPTH 50
34 #define ASN1_GEN_FORMAT_ASCII 1
36 #define ASN1_GEN_FORMAT_UTF8 2
38 #define ASN1_GEN_FORMAT_HEX 3
40 #define ASN1_GEN_FORMAT_BITLIST 4
62 tag_exp_type exp_list[ASN1_FLAG_EXP_MAX];
66 static ASN1_TYPE *generate_v3(const char *str, X509V3_CTX *cnf, int depth,
68 static int bitstr_cb(const char *elem, int len, void *bitstr);
69 static int asn1_cb(const char *elem, int len, void *bitstr);
70 static int append_exp(tag_exp_arg *arg, int exp_tag, int exp_class,
71 int exp_constructed, int exp_pad, int imp_ok);
72 static int parse_tagging(const char *vstart, int vlen, int *ptag,
74 static ASN1_TYPE *asn1_multi(int utype, const char *section, X509V3_CTX *cnf,
75 int depth, int *perr);
76 static ASN1_TYPE *asn1_str2type(const char *str, int format, int utype);
77 static int asn1_str2tag(const char *tagstr, int len);
79 ASN1_TYPE *ASN1_generate_nconf(const char *str, CONF *nconf)
84 return ASN1_generate_v3(str, NULL);
86 X509V3_set_nconf(&cnf, nconf);
87 return ASN1_generate_v3(str, &cnf);
90 ASN1_TYPE *ASN1_generate_v3(const char *str, X509V3_CTX *cnf)
93 ASN1_TYPE *ret = generate_v3(str, cnf, 0, &err);
95 ERR_raise(ERR_LIB_ASN1, err);
99 static ASN1_TYPE *generate_v3(const char *str, X509V3_CTX *cnf, int depth,
103 tag_exp_arg asn1_tags;
108 unsigned char *orig_der = NULL, *new_der = NULL;
109 const unsigned char *cpy_start;
111 const unsigned char *cp;
114 int hdr_constructed = 0, hdr_tag, hdr_class;
117 asn1_tags.imp_tag = -1;
118 asn1_tags.imp_class = -1;
119 asn1_tags.format = ASN1_GEN_FORMAT_ASCII;
120 asn1_tags.exp_count = 0;
121 if (CONF_parse_list(str, ',', 1, asn1_cb, &asn1_tags) != 0) {
122 *perr = ASN1_R_UNKNOWN_TAG;
126 if ((asn1_tags.utype == V_ASN1_SEQUENCE)
127 || (asn1_tags.utype == V_ASN1_SET)) {
129 *perr = ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG;
132 if (depth >= ASN1_GEN_SEQ_MAX_DEPTH) {
133 *perr = ASN1_R_ILLEGAL_NESTED_TAGGING;
136 ret = asn1_multi(asn1_tags.utype, asn1_tags.str, cnf, depth, perr);
138 ret = asn1_str2type(asn1_tags.str, asn1_tags.format, asn1_tags.utype);
143 /* If no tagging return base type */
144 if ((asn1_tags.imp_tag == -1) && (asn1_tags.exp_count == 0))
147 /* Generate the encoding */
148 cpy_len = i2d_ASN1_TYPE(ret, &orig_der);
151 /* Set point to start copying for modified encoding */
152 cpy_start = orig_der;
154 /* Do we need IMPLICIT tagging? */
155 if (asn1_tags.imp_tag != -1) {
156 /* If IMPLICIT we will replace the underlying tag */
157 /* Skip existing tag+len */
158 r = ASN1_get_object(&cpy_start, &hdr_len, &hdr_tag, &hdr_class,
162 /* Update copy length */
163 cpy_len -= cpy_start - orig_der;
165 * For IMPLICIT tagging the length should match the original length
166 * and constructed flag should be consistent.
169 /* Indefinite length constructed */
173 /* Just retain constructed flag */
174 hdr_constructed = r & V_ASN1_CONSTRUCTED;
176 * Work out new length with IMPLICIT tag: ignore constructed because
177 * it will mess up if indefinite length
179 len = ASN1_object_size(0, hdr_len, asn1_tags.imp_tag);
183 /* Work out length in any EXPLICIT, starting from end */
185 for (i = 0, etmp = asn1_tags.exp_list + asn1_tags.exp_count - 1;
186 i < asn1_tags.exp_count; i++, etmp--) {
187 /* Content length: number of content octets + any padding */
188 len += etmp->exp_pad;
190 /* Total object length: length including new header */
191 len = ASN1_object_size(0, len, etmp->exp_tag);
194 /* Allocate buffer for new encoding */
196 new_der = OPENSSL_malloc(len);
200 /* Generate tagged encoding */
204 /* Output explicit tags first */
206 for (i = 0, etmp = asn1_tags.exp_list; i < asn1_tags.exp_count;
208 ASN1_put_object(&p, etmp->exp_constructed, etmp->exp_len,
209 etmp->exp_tag, etmp->exp_class);
214 /* If IMPLICIT, output tag */
216 if (asn1_tags.imp_tag != -1) {
217 if (asn1_tags.imp_class == V_ASN1_UNIVERSAL
218 && (asn1_tags.imp_tag == V_ASN1_SEQUENCE
219 || asn1_tags.imp_tag == V_ASN1_SET))
220 hdr_constructed = V_ASN1_CONSTRUCTED;
221 ASN1_put_object(&p, hdr_constructed, hdr_len,
222 asn1_tags.imp_tag, asn1_tags.imp_class);
225 /* Copy across original encoding */
226 memcpy(p, cpy_start, cpy_len);
230 /* Obtain new ASN1_TYPE structure */
231 ret = d2i_ASN1_TYPE(NULL, &cp, len);
234 OPENSSL_free(orig_der);
235 OPENSSL_free(new_der);
241 static int asn1_cb(const char *elem, int len, void *bitstr)
243 tag_exp_arg *arg = bitstr;
247 const char *p, *vstart = NULL;
249 int tmp_tag, tmp_class;
254 for (i = 0, p = elem; i < len; p++, i++) {
255 /* Look for the ':' in name value pairs */
258 vlen = len - (vstart - elem);
264 utype = asn1_str2tag(elem, len);
267 ERR_raise_data(ERR_LIB_ASN1, ASN1_R_UNKNOWN_TAG, "tag=%s", elem);
271 /* If this is not a modifier mark end of string and exit */
272 if (!(utype & ASN1_GEN_FLAG)) {
275 /* If no value and not end of string, error */
276 if (!vstart && elem[len]) {
277 ERR_raise(ERR_LIB_ASN1, ASN1_R_MISSING_VALUE);
285 case ASN1_GEN_FLAG_IMP:
286 /* Check for illegal multiple IMPLICIT tagging */
287 if (arg->imp_tag != -1) {
288 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_NESTED_TAGGING);
291 if (!parse_tagging(vstart, vlen, &arg->imp_tag, &arg->imp_class))
295 case ASN1_GEN_FLAG_EXP:
297 if (!parse_tagging(vstart, vlen, &tmp_tag, &tmp_class))
299 if (!append_exp(arg, tmp_tag, tmp_class, 1, 0, 0))
303 case ASN1_GEN_FLAG_SEQWRAP:
304 if (!append_exp(arg, V_ASN1_SEQUENCE, V_ASN1_UNIVERSAL, 1, 0, 1))
308 case ASN1_GEN_FLAG_SETWRAP:
309 if (!append_exp(arg, V_ASN1_SET, V_ASN1_UNIVERSAL, 1, 0, 1))
313 case ASN1_GEN_FLAG_BITWRAP:
314 if (!append_exp(arg, V_ASN1_BIT_STRING, V_ASN1_UNIVERSAL, 0, 1, 1))
318 case ASN1_GEN_FLAG_OCTWRAP:
319 if (!append_exp(arg, V_ASN1_OCTET_STRING, V_ASN1_UNIVERSAL, 0, 0, 1))
323 case ASN1_GEN_FLAG_FORMAT:
325 ERR_raise(ERR_LIB_ASN1, ASN1_R_UNKNOWN_FORMAT);
328 if (HAS_PREFIX(vstart, "ASCII"))
329 arg->format = ASN1_GEN_FORMAT_ASCII;
330 else if (HAS_PREFIX(vstart, "UTF8"))
331 arg->format = ASN1_GEN_FORMAT_UTF8;
332 else if (HAS_PREFIX(vstart, "HEX"))
333 arg->format = ASN1_GEN_FORMAT_HEX;
334 else if (HAS_PREFIX(vstart, "BITLIST"))
335 arg->format = ASN1_GEN_FORMAT_BITLIST;
337 ERR_raise(ERR_LIB_ASN1, ASN1_R_UNKNOWN_FORMAT);
348 static int parse_tagging(const char *vstart, int vlen, int *ptag, int *pclass)
354 tag_num = strtoul(vstart, &eptr, 10);
355 /* Check we haven't gone past max length: should be impossible */
356 if (eptr && *eptr && (eptr > vstart + vlen))
359 ERR_raise(ERR_LIB_ASN1, ASN1_R_INVALID_NUMBER);
363 /* If we have non numeric characters, parse them */
365 vlen -= eptr - vstart;
372 *pclass = V_ASN1_UNIVERSAL;
376 *pclass = V_ASN1_APPLICATION;
380 *pclass = V_ASN1_PRIVATE;
384 *pclass = V_ASN1_CONTEXT_SPECIFIC;
388 ERR_raise_data(ERR_LIB_ASN1, ASN1_R_INVALID_MODIFIER,
394 *pclass = V_ASN1_CONTEXT_SPECIFIC;
400 /* Handle multiple types: SET and SEQUENCE */
402 static ASN1_TYPE *asn1_multi(int utype, const char *section, X509V3_CTX *cnf,
403 int depth, int *perr)
405 ASN1_TYPE *ret = NULL;
406 STACK_OF(ASN1_TYPE) *sk = NULL;
407 STACK_OF(CONF_VALUE) *sect = NULL;
408 unsigned char *der = NULL;
411 sk = sk_ASN1_TYPE_new_null();
417 sect = X509V3_get_section(cnf, (char *)section);
420 for (i = 0; i < sk_CONF_VALUE_num(sect); i++) {
422 generate_v3(sk_CONF_VALUE_value(sect, i)->value, cnf,
426 if (!sk_ASN1_TYPE_push(sk, typ))
432 * Now we has a STACK of the components, convert to the correct form
435 if (utype == V_ASN1_SET)
436 derlen = i2d_ASN1_SET_ANY(sk, &der);
438 derlen = i2d_ASN1_SEQUENCE_ANY(sk, &der);
442 if ((ret = ASN1_TYPE_new()) == NULL)
444 if ((ret->value.asn1_string = ASN1_STRING_type_new(utype)) == NULL)
448 ret->value.asn1_string->data = der;
449 ret->value.asn1_string->length = derlen;
457 sk_ASN1_TYPE_pop_free(sk, ASN1_TYPE_free);
458 X509V3_section_free(cnf, sect);
463 static int append_exp(tag_exp_arg *arg, int exp_tag, int exp_class,
464 int exp_constructed, int exp_pad, int imp_ok)
466 tag_exp_type *exp_tmp;
467 /* Can only have IMPLICIT if permitted */
468 if ((arg->imp_tag != -1) && !imp_ok) {
469 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_IMPLICIT_TAG);
473 if (arg->exp_count == ASN1_FLAG_EXP_MAX) {
474 ERR_raise(ERR_LIB_ASN1, ASN1_R_DEPTH_EXCEEDED);
478 exp_tmp = &arg->exp_list[arg->exp_count++];
481 * If IMPLICIT set tag to implicit value then reset implicit tag since it
484 if (arg->imp_tag != -1) {
485 exp_tmp->exp_tag = arg->imp_tag;
486 exp_tmp->exp_class = arg->imp_class;
490 exp_tmp->exp_tag = exp_tag;
491 exp_tmp->exp_class = exp_class;
493 exp_tmp->exp_constructed = exp_constructed;
494 exp_tmp->exp_pad = exp_pad;
499 static int asn1_str2tag(const char *tagstr, int len)
502 static const struct tag_name_st *tntmp, tnst[] = {
503 ASN1_GEN_STR("BOOL", V_ASN1_BOOLEAN),
504 ASN1_GEN_STR("BOOLEAN", V_ASN1_BOOLEAN),
505 ASN1_GEN_STR("NULL", V_ASN1_NULL),
506 ASN1_GEN_STR("INT", V_ASN1_INTEGER),
507 ASN1_GEN_STR("INTEGER", V_ASN1_INTEGER),
508 ASN1_GEN_STR("ENUM", V_ASN1_ENUMERATED),
509 ASN1_GEN_STR("ENUMERATED", V_ASN1_ENUMERATED),
510 ASN1_GEN_STR("OID", V_ASN1_OBJECT),
511 ASN1_GEN_STR("OBJECT", V_ASN1_OBJECT),
512 ASN1_GEN_STR("UTCTIME", V_ASN1_UTCTIME),
513 ASN1_GEN_STR("UTC", V_ASN1_UTCTIME),
514 ASN1_GEN_STR("GENERALIZEDTIME", V_ASN1_GENERALIZEDTIME),
515 ASN1_GEN_STR("GENTIME", V_ASN1_GENERALIZEDTIME),
516 ASN1_GEN_STR("OCT", V_ASN1_OCTET_STRING),
517 ASN1_GEN_STR("OCTETSTRING", V_ASN1_OCTET_STRING),
518 ASN1_GEN_STR("BITSTR", V_ASN1_BIT_STRING),
519 ASN1_GEN_STR("BITSTRING", V_ASN1_BIT_STRING),
520 ASN1_GEN_STR("UNIVERSALSTRING", V_ASN1_UNIVERSALSTRING),
521 ASN1_GEN_STR("UNIV", V_ASN1_UNIVERSALSTRING),
522 ASN1_GEN_STR("IA5", V_ASN1_IA5STRING),
523 ASN1_GEN_STR("IA5STRING", V_ASN1_IA5STRING),
524 ASN1_GEN_STR("UTF8", V_ASN1_UTF8STRING),
525 ASN1_GEN_STR("UTF8String", V_ASN1_UTF8STRING),
526 ASN1_GEN_STR("BMP", V_ASN1_BMPSTRING),
527 ASN1_GEN_STR("BMPSTRING", V_ASN1_BMPSTRING),
528 ASN1_GEN_STR("VISIBLESTRING", V_ASN1_VISIBLESTRING),
529 ASN1_GEN_STR("VISIBLE", V_ASN1_VISIBLESTRING),
530 ASN1_GEN_STR("PRINTABLESTRING", V_ASN1_PRINTABLESTRING),
531 ASN1_GEN_STR("PRINTABLE", V_ASN1_PRINTABLESTRING),
532 ASN1_GEN_STR("T61", V_ASN1_T61STRING),
533 ASN1_GEN_STR("T61STRING", V_ASN1_T61STRING),
534 ASN1_GEN_STR("TELETEXSTRING", V_ASN1_T61STRING),
535 ASN1_GEN_STR("GeneralString", V_ASN1_GENERALSTRING),
536 ASN1_GEN_STR("GENSTR", V_ASN1_GENERALSTRING),
537 ASN1_GEN_STR("NUMERIC", V_ASN1_NUMERICSTRING),
538 ASN1_GEN_STR("NUMERICSTRING", V_ASN1_NUMERICSTRING),
541 ASN1_GEN_STR("SEQUENCE", V_ASN1_SEQUENCE),
542 ASN1_GEN_STR("SEQ", V_ASN1_SEQUENCE),
543 ASN1_GEN_STR("SET", V_ASN1_SET),
546 ASN1_GEN_STR("EXP", ASN1_GEN_FLAG_EXP),
547 ASN1_GEN_STR("EXPLICIT", ASN1_GEN_FLAG_EXP),
549 ASN1_GEN_STR("IMP", ASN1_GEN_FLAG_IMP),
550 ASN1_GEN_STR("IMPLICIT", ASN1_GEN_FLAG_IMP),
551 /* OCTET STRING wrapper */
552 ASN1_GEN_STR("OCTWRAP", ASN1_GEN_FLAG_OCTWRAP),
553 /* SEQUENCE wrapper */
554 ASN1_GEN_STR("SEQWRAP", ASN1_GEN_FLAG_SEQWRAP),
556 ASN1_GEN_STR("SETWRAP", ASN1_GEN_FLAG_SETWRAP),
557 /* BIT STRING wrapper */
558 ASN1_GEN_STR("BITWRAP", ASN1_GEN_FLAG_BITWRAP),
559 ASN1_GEN_STR("FORM", ASN1_GEN_FLAG_FORMAT),
560 ASN1_GEN_STR("FORMAT", ASN1_GEN_FLAG_FORMAT),
564 len = strlen(tagstr);
567 for (i = 0; i < OSSL_NELEM(tnst); i++, tntmp++) {
568 if ((len == tntmp->len)
569 && (OPENSSL_strncasecmp(tntmp->strnam, tagstr, len) == 0))
576 static ASN1_TYPE *asn1_str2type(const char *str, int format, int utype)
578 ASN1_TYPE *atmp = NULL;
580 unsigned char *rdata;
584 if ((atmp = ASN1_TYPE_new()) == NULL) {
585 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
596 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_NULL_VALUE);
602 if (format != ASN1_GEN_FORMAT_ASCII) {
603 ERR_raise(ERR_LIB_ASN1, ASN1_R_NOT_ASCII_FORMAT);
608 vtmp.value = (char *)str;
609 if (!X509V3_get_value_bool(&vtmp, &atmp->value.boolean)) {
610 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_BOOLEAN);
616 case V_ASN1_ENUMERATED:
617 if (format != ASN1_GEN_FORMAT_ASCII) {
618 ERR_raise(ERR_LIB_ASN1, ASN1_R_INTEGER_NOT_ASCII_FORMAT);
621 if ((atmp->value.integer
622 = s2i_ASN1_INTEGER(NULL, str)) == NULL) {
623 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_INTEGER);
629 if (format != ASN1_GEN_FORMAT_ASCII) {
630 ERR_raise(ERR_LIB_ASN1, ASN1_R_OBJECT_NOT_ASCII_FORMAT);
633 if ((atmp->value.object = OBJ_txt2obj(str, 0)) == NULL) {
634 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_OBJECT);
640 case V_ASN1_GENERALIZEDTIME:
641 if (format != ASN1_GEN_FORMAT_ASCII) {
642 ERR_raise(ERR_LIB_ASN1, ASN1_R_TIME_NOT_ASCII_FORMAT);
645 if ((atmp->value.asn1_string = ASN1_STRING_new()) == NULL) {
646 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
649 if (!ASN1_STRING_set(atmp->value.asn1_string, str, -1)) {
650 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
653 atmp->value.asn1_string->type = utype;
654 if (!ASN1_TIME_check(atmp->value.asn1_string)) {
655 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_TIME_VALUE);
661 case V_ASN1_BMPSTRING:
662 case V_ASN1_PRINTABLESTRING:
663 case V_ASN1_IA5STRING:
664 case V_ASN1_T61STRING:
665 case V_ASN1_UTF8STRING:
666 case V_ASN1_VISIBLESTRING:
667 case V_ASN1_UNIVERSALSTRING:
668 case V_ASN1_GENERALSTRING:
669 case V_ASN1_NUMERICSTRING:
670 if (format == ASN1_GEN_FORMAT_ASCII)
671 format = MBSTRING_ASC;
672 else if (format == ASN1_GEN_FORMAT_UTF8)
673 format = MBSTRING_UTF8;
675 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_FORMAT);
679 if (ASN1_mbstring_copy(&atmp->value.asn1_string, (unsigned char *)str,
680 -1, format, ASN1_tag2bit(utype)) <= 0) {
681 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
687 case V_ASN1_BIT_STRING:
688 case V_ASN1_OCTET_STRING:
689 if ((atmp->value.asn1_string = ASN1_STRING_new()) == NULL) {
690 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
694 if (format == ASN1_GEN_FORMAT_HEX) {
695 if ((rdata = OPENSSL_hexstr2buf(str, &rdlen)) == NULL) {
696 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_HEX);
699 atmp->value.asn1_string->data = rdata;
700 atmp->value.asn1_string->length = rdlen;
701 atmp->value.asn1_string->type = utype;
702 } else if (format == ASN1_GEN_FORMAT_ASCII) {
703 if (!ASN1_STRING_set(atmp->value.asn1_string, str, -1)) {
704 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
707 } else if ((format == ASN1_GEN_FORMAT_BITLIST)
708 && (utype == V_ASN1_BIT_STRING)) {
710 (str, ',', 1, bitstr_cb, atmp->value.bit_string)) {
711 ERR_raise(ERR_LIB_ASN1, ASN1_R_LIST_ERROR);
717 ERR_raise(ERR_LIB_ASN1, ASN1_R_ILLEGAL_BITSTRING_FORMAT);
721 if ((utype == V_ASN1_BIT_STRING) && no_unused)
722 ossl_asn1_string_set_bits_left(atmp->value.asn1_string, 0);
727 ERR_raise(ERR_LIB_ASN1, ASN1_R_UNSUPPORTED_TYPE);
735 ERR_add_error_data(2, "string=", str);
738 ASN1_TYPE_free(atmp);
743 static int bitstr_cb(const char *elem, int len, void *bitstr)
749 bitnum = strtoul(elem, &eptr, 10);
750 if (eptr && *eptr && (eptr != elem + len))
753 ERR_raise(ERR_LIB_ASN1, ASN1_R_INVALID_NUMBER);
756 if (!ASN1_BIT_STRING_set_bit(bitstr, bitnum, 1)) {
757 ERR_raise(ERR_LIB_ASN1, ERR_R_ASN1_LIB);
763 static int mask_cb(const char *elem, int len, void *arg)
765 unsigned long *pmask = arg, tmpmask;
769 if (len == 3 && HAS_PREFIX(elem, "DIR")) {
770 *pmask |= B_ASN1_DIRECTORYSTRING;
773 tag = asn1_str2tag(elem, len);
774 if (!tag || (tag & ASN1_GEN_FLAG))
776 tmpmask = ASN1_tag2bit(tag);
783 int ASN1_str2mask(const char *str, unsigned long *pmask)
786 return CONF_parse_list(str, '|', 1, mask_cb, pmask);