1 /* crypto/asn1/asn1.h */ 2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) 3 * All rights reserved. 4 * 5 * This package is an SSL implementation written 6 * by Eric Young (eay@cryptsoft.com). 7 * The implementation was written so as to conform with Netscapes SSL. 8 * 9 * This library is free for commercial and non-commercial use as long as 10 * the following conditions are aheared to. The following conditions 11 * apply to all code found in this distribution, be it the RC4, RSA, 12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation 13 * included with this distribution is covered by the same copyright terms 14 * except that the holder is Tim Hudson (tjh@cryptsoft.com). 15 * 16 * Copyright remains Eric Young's, and as such any Copyright notices in 17 * the code are not to be removed. 18 * If this package is used in a product, Eric Young should be given attribution 19 * as the author of the parts of the library used. 20 * This can be in the form of a textual message at program startup or 21 * in documentation (online or textual) provided with the package. 22 * 23 * Redistribution and use in source and binary forms, with or without 24 * modification, are permitted provided that the following conditions 25 * are met: 26 * 1. Redistributions of source code must retain the copyright 27 * notice, this list of conditions and the following disclaimer. 28 * 2. Redistributions in binary form must reproduce the above copyright 29 * notice, this list of conditions and the following disclaimer in the 30 * documentation and/or other materials provided with the distribution. 31 * 3. All advertising materials mentioning features or use of this software 32 * must display the following acknowledgement: 33 * "This product includes cryptographic software written by 34 * Eric Young (eay@cryptsoft.com)" 35 * The word 'cryptographic' can be left out if the rouines from the library 36 * being used are not cryptographic related :-). 37 * 4. If you include any Windows specific code (or a derivative thereof) from 38 * the apps directory (application code) you must include an acknowledgement: 39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" 40 * 41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND 42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 51 * SUCH DAMAGE. 52 * 53 * The licence and distribution terms for any publically available version or 54 * derivative of this code cannot be changed. i.e. this code cannot simply be 55 * copied and put under another distribution licence 56 * [including the GNU Public Licence.] 57 */ 58 59 #ifndef HEADER_ASN1_H 60 #define HEADER_ASN1_H 61 62 #include <time.h> 63 #include <openssl/e_os2.h> 64 #ifndef OPENSSL_NO_BIO 65 #include <openssl/bio.h> 66 #endif 67 #include <openssl/stack.h> 68 #include <openssl/safestack.h> 69 70 #include <openssl/symhacks.h> 71 72 #include <openssl/ossl_typ.h> 73 #ifndef OPENSSL_NO_DEPRECATED 74 #include <openssl/bn.h> 75 #endif 76 77 #ifdef OPENSSL_BUILD_SHLIBCRYPTO 78 # undef OPENSSL_EXTERN 79 # define OPENSSL_EXTERN OPENSSL_EXPORT 80 #endif 81 82 #ifdef __cplusplus 83 extern "C" { 84 #endif 85 86 #define V_ASN1_UNIVERSAL 0x00 87 #define V_ASN1_APPLICATION 0x40 88 #define V_ASN1_CONTEXT_SPECIFIC 0x80 89 #define V_ASN1_PRIVATE 0xc0 90 91 #define V_ASN1_CONSTRUCTED 0x20 92 #define V_ASN1_PRIMITIVE_TAG 0x1f 93 #define V_ASN1_PRIMATIVE_TAG 0x1f 94 95 #define V_ASN1_APP_CHOOSE -2 /* let the recipient choose */ 96 #define V_ASN1_OTHER -3 /* used in ASN1_TYPE */ 97 #define V_ASN1_ANY -4 /* used in ASN1 template code */ 98 99 #define V_ASN1_NEG 0x100 /* negative flag */ 100 101 #define V_ASN1_UNDEF -1 102 #define V_ASN1_EOC 0 103 #define V_ASN1_BOOLEAN 1 /**/ 104 #define V_ASN1_INTEGER 2 105 #define V_ASN1_NEG_INTEGER (2 | V_ASN1_NEG) 106 #define V_ASN1_BIT_STRING 3 107 #define V_ASN1_OCTET_STRING 4 108 #define V_ASN1_NULL 5 109 #define V_ASN1_OBJECT 6 110 #define V_ASN1_OBJECT_DESCRIPTOR 7 111 #define V_ASN1_EXTERNAL 8 112 #define V_ASN1_REAL 9 113 #define V_ASN1_ENUMERATED 10 114 #define V_ASN1_NEG_ENUMERATED (10 | V_ASN1_NEG) 115 #define V_ASN1_UTF8STRING 12 116 #define V_ASN1_SEQUENCE 16 117 #define V_ASN1_SET 17 118 #define V_ASN1_NUMERICSTRING 18 /**/ 119 #define V_ASN1_PRINTABLESTRING 19 120 #define V_ASN1_T61STRING 20 121 #define V_ASN1_TELETEXSTRING 20 /* alias */ 122 #define V_ASN1_VIDEOTEXSTRING 21 /**/ 123 #define V_ASN1_IA5STRING 22 124 #define V_ASN1_UTCTIME 23 125 #define V_ASN1_GENERALIZEDTIME 24 /**/ 126 #define V_ASN1_GRAPHICSTRING 25 /**/ 127 #define V_ASN1_ISO64STRING 26 /**/ 128 #define V_ASN1_VISIBLESTRING 26 /* alias */ 129 #define V_ASN1_GENERALSTRING 27 /**/ 130 #define V_ASN1_UNIVERSALSTRING 28 /**/ 131 #define V_ASN1_BMPSTRING 30 132 133 /* For use with d2i_ASN1_type_bytes() */ 134 #define B_ASN1_NUMERICSTRING 0x0001 135 #define B_ASN1_PRINTABLESTRING 0x0002 136 #define B_ASN1_T61STRING 0x0004 137 #define B_ASN1_TELETEXSTRING 0x0004 138 #define B_ASN1_VIDEOTEXSTRING 0x0008 139 #define B_ASN1_IA5STRING 0x0010 140 #define B_ASN1_GRAPHICSTRING 0x0020 141 #define B_ASN1_ISO64STRING 0x0040 142 #define B_ASN1_VISIBLESTRING 0x0040 143 #define B_ASN1_GENERALSTRING 0x0080 144 #define B_ASN1_UNIVERSALSTRING 0x0100 145 #define B_ASN1_OCTET_STRING 0x0200 146 #define B_ASN1_BIT_STRING 0x0400 147 #define B_ASN1_BMPSTRING 0x0800 148 #define B_ASN1_UNKNOWN 0x1000 149 #define B_ASN1_UTF8STRING 0x2000 150 #define B_ASN1_UTCTIME 0x4000 151 #define B_ASN1_GENERALIZEDTIME 0x8000 152 #define B_ASN1_SEQUENCE 0x10000 153 154 /* For use with ASN1_mbstring_copy() */ 155 #define MBSTRING_FLAG 0x1000 156 #define MBSTRING_UTF8 (MBSTRING_FLAG) 157 #define MBSTRING_ASC (MBSTRING_FLAG|1) 158 #define MBSTRING_BMP (MBSTRING_FLAG|2) 159 #define MBSTRING_UNIV (MBSTRING_FLAG|4) 160 161 struct X509_algor_st; 162 163 #define DECLARE_ASN1_SET_OF(type) /* filled in by mkstack.pl */ 164 #define IMPLEMENT_ASN1_SET_OF(type) /* nothing, no longer needed */ 165 166 /* We MUST make sure that, except for constness, asn1_ctx_st and 167 asn1_const_ctx are exactly the same. Fortunately, as soon as 168 the old ASN1 parsing macros are gone, we can throw this away 169 as well... */ 170 typedef struct asn1_ctx_st 171 { 172 unsigned char *p;/* work char pointer */ 173 int eos; /* end of sequence read for indefinite encoding */ 174 int error; /* error code to use when returning an error */ 175 int inf; /* constructed if 0x20, indefinite is 0x21 */ 176 int tag; /* tag from last 'get object' */ 177 int xclass; /* class from last 'get object' */ 178 long slen; /* length of last 'get object' */ 179 unsigned char *max; /* largest value of p allowed */ 180 unsigned char *q;/* temporary variable */ 181 unsigned char **pp;/* variable */ 182 int line; /* used in error processing */ 183 } ASN1_CTX; 184 185 typedef struct asn1_const_ctx_st 186 { 187 const unsigned char *p;/* work char pointer */ 188 int eos; /* end of sequence read for indefinite encoding */ 189 int error; /* error code to use when returning an error */ 190 int inf; /* constructed if 0x20, indefinite is 0x21 */ 191 int tag; /* tag from last 'get object' */ 192 int xclass; /* class from last 'get object' */ 193 long slen; /* length of last 'get object' */ 194 const unsigned char *max; /* largest value of p allowed */ 195 const unsigned char *q;/* temporary variable */ 196 const unsigned char **pp;/* variable */ 197 int line; /* used in error processing */ 198 } ASN1_const_CTX; 199 200 /* These are used internally in the ASN1_OBJECT to keep track of 201 * whether the names and data need to be free()ed */ 202 #define ASN1_OBJECT_FLAG_DYNAMIC 0x01 /* internal use */ 203 #define ASN1_OBJECT_FLAG_CRITICAL 0x02 /* critical x509v3 object id */ 204 #define ASN1_OBJECT_FLAG_DYNAMIC_STRINGS 0x04 /* internal use */ 205 #define ASN1_OBJECT_FLAG_DYNAMIC_DATA 0x08 /* internal use */ 206 typedef struct asn1_object_st 207 { 208 const char *sn,*ln; 209 int nid; 210 int length; 211 unsigned char *data; 212 int flags; /* Should we free this one */ 213 } ASN1_OBJECT; 214 215 #define ASN1_STRING_FLAG_BITS_LEFT 0x08 /* Set if 0x07 has bits left value */ 216 /* This indicates that the ASN1_STRING is not a real value but just a place 217 * holder for the location where indefinite length constructed data should 218 * be inserted in the memory buffer 219 */ 220 #define ASN1_STRING_FLAG_NDEF 0x010 221 /* This is the base type that holds just about everything :-) */ 222 typedef struct asn1_string_st 223 { 224 int length; 225 int type; 226 unsigned char *data; 227 /* The value of the following field depends on the type being 228 * held. It is mostly being used for BIT_STRING so if the 229 * input data has a non-zero 'unused bits' value, it will be 230 * handled correctly */ 231 long flags; 232 } ASN1_STRING; 233 234 /* ASN1_ENCODING structure: this is used to save the received 235 * encoding of an ASN1 type. This is useful to get round 236 * problems with invalid encodings which can break signatures. 237 */ 238 239 typedef struct ASN1_ENCODING_st 240 { 241 unsigned char *enc; /* DER encoding */ 242 long len; /* Length of encoding */ 243 int modified; /* set to 1 if 'enc' is invalid */ 244 } ASN1_ENCODING; 245 246 /* Used with ASN1 LONG type: if a long is set to this it is omitted */ 247 #define ASN1_LONG_UNDEF 0x7fffffffL 248 249 #define STABLE_FLAGS_MALLOC 0x01 250 #define STABLE_NO_MASK 0x02 251 #define DIRSTRING_TYPE \ 252 (B_ASN1_PRINTABLESTRING|B_ASN1_T61STRING|B_ASN1_BMPSTRING|B_ASN1_UTF8STRING) 253 #define PKCS9STRING_TYPE (DIRSTRING_TYPE|B_ASN1_IA5STRING) 254 255 typedef struct asn1_string_table_st { 256 int nid; 257 long minsize; 258 long maxsize; 259 unsigned long mask; 260 unsigned long flags; 261 } ASN1_STRING_TABLE; 262 263 DECLARE_STACK_OF(ASN1_STRING_TABLE) 264 265 /* size limits: this stuff is taken straight from RFC2459 */ 266 267 #define ub_name 32768 268 #define ub_common_name 64 269 #define ub_locality_name 128 270 #define ub_state_name 128 271 #define ub_organization_name 64 272 #define ub_organization_unit_name 64 273 #define ub_title 64 274 #define ub_email_address 128 275 276 /* Declarations for template structures: for full definitions 277 * see asn1t.h 278 */ 279 typedef struct ASN1_TEMPLATE_st ASN1_TEMPLATE; 280 typedef struct ASN1_ITEM_st ASN1_ITEM; 281 typedef struct ASN1_TLC_st ASN1_TLC; 282 /* This is just an opaque pointer */ 283 typedef struct ASN1_VALUE_st ASN1_VALUE; 284 285 /* Declare ASN1 functions: the implement macro in in asn1t.h */ 286 287 #define DECLARE_ASN1_FUNCTIONS(type) DECLARE_ASN1_FUNCTIONS_name(type, type) 288 289 #define DECLARE_ASN1_ALLOC_FUNCTIONS(type) \ 290 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, type) 291 292 #define DECLARE_ASN1_FUNCTIONS_name(type, name) \ 293 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ 294 DECLARE_ASN1_ENCODE_FUNCTIONS(type, name, name) 295 296 #define DECLARE_ASN1_FUNCTIONS_fname(type, itname, name) \ 297 DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ 298 DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) 299 300 #define DECLARE_ASN1_ENCODE_FUNCTIONS(type, itname, name) \ 301 type *d2i_##name(type **a, const unsigned char **in, long len); \ 302 int i2d_##name(type *a, unsigned char **out); \ 303 DECLARE_ASN1_ITEM(itname) 304 305 #define DECLARE_ASN1_ENCODE_FUNCTIONS_const(type, name) \ 306 type *d2i_##name(type **a, const unsigned char **in, long len); \ 307 int i2d_##name(const type *a, unsigned char **out); \ 308 DECLARE_ASN1_ITEM(name) 309 310 #define DECLARE_ASN1_NDEF_FUNCTION(name) \ 311 int i2d_##name##_NDEF(name *a, unsigned char **out); 312 313 #define DECLARE_ASN1_FUNCTIONS_const(name) \ 314 name *name##_new(void); \ 315 void name##_free(name *a); 316 317 #define DECLARE_ASN1_ALLOC_FUNCTIONS_name(type, name) \ 318 type *name##_new(void); \ 319 void name##_free(type *a); 320 321 #define D2I_OF(type) type *(*)(type **,const unsigned char **,long) 322 #define I2D_OF(type) int (*)(type *,unsigned char **) 323 #define I2D_OF_const(type) int (*)(const type *,unsigned char **) 324 325 #define CHECKED_D2I_OF(type, d2i) \ 326 ((d2i_of_void*) (1 ? d2i : ((D2I_OF(type))0))) 327 #define CHECKED_I2D_OF(type, i2d) \ 328 ((i2d_of_void*) (1 ? i2d : ((I2D_OF(type))0))) 329 #define CHECKED_NEW_OF(type, xnew) \ 330 ((void *(*)(void)) (1 ? xnew : ((type *(*)(void))0))) 331 #define CHECKED_PTR_OF(type, p) \ 332 ((void*) (1 ? p : (type*)0)) 333 #define CHECKED_PPTR_OF(type, p) \ 334 ((void**) (1 ? p : (type**)0)) 335 336 #define TYPEDEF_D2I_OF(type) typedef type *d2i_of_##type(type **,const unsigned char **,long) 337 #define TYPEDEF_I2D_OF(type) typedef int i2d_of_##type(type *,unsigned char **) 338 #define TYPEDEF_D2I2D_OF(type) TYPEDEF_D2I_OF(type); TYPEDEF_I2D_OF(type) 339 340 TYPEDEF_D2I2D_OF(void); 341 342 /* The following macros and typedefs allow an ASN1_ITEM 343 * to be embedded in a structure and referenced. Since 344 * the ASN1_ITEM pointers need to be globally accessible 345 * (possibly from shared libraries) they may exist in 346 * different forms. On platforms that support it the 347 * ASN1_ITEM structure itself will be globally exported. 348 * Other platforms will export a function that returns 349 * an ASN1_ITEM pointer. 350 * 351 * To handle both cases transparently the macros below 352 * should be used instead of hard coding an ASN1_ITEM 353 * pointer in a structure. 354 * 355 * The structure will look like this: 356 * 357 * typedef struct SOMETHING_st { 358 * ... 359 * ASN1_ITEM_EXP *iptr; 360 * ... 361 * } SOMETHING; 362 * 363 * It would be initialised as e.g.: 364 * 365 * SOMETHING somevar = {...,ASN1_ITEM_ref(X509),...}; 366 * 367 * and the actual pointer extracted with: 368 * 369 * const ASN1_ITEM *it = ASN1_ITEM_ptr(somevar.iptr); 370 * 371 * Finally an ASN1_ITEM pointer can be extracted from an 372 * appropriate reference with: ASN1_ITEM_rptr(X509). This 373 * would be used when a function takes an ASN1_ITEM * argument. 374 * 375 */ 376 377 #ifndef OPENSSL_EXPORT_VAR_AS_FUNCTION 378 379 /* ASN1_ITEM pointer exported type */ 380 typedef const ASN1_ITEM ASN1_ITEM_EXP; 381 382 /* Macro to obtain ASN1_ITEM pointer from exported type */ 383 #define ASN1_ITEM_ptr(iptr) (iptr) 384 385 /* Macro to include ASN1_ITEM pointer from base type */ 386 #define ASN1_ITEM_ref(iptr) (&(iptr##_it)) 387 388 #define ASN1_ITEM_rptr(ref) (&(ref##_it)) 389 390 #define DECLARE_ASN1_ITEM(name) \ 391 OPENSSL_EXTERN const ASN1_ITEM name##_it; 392 393 #else 394 395 /* Platforms that can't easily handle shared global variables are declared 396 * as functions returning ASN1_ITEM pointers. 397 */ 398 399 /* ASN1_ITEM pointer exported type */ 400 typedef const ASN1_ITEM * ASN1_ITEM_EXP(void); 401 402 /* Macro to obtain ASN1_ITEM pointer from exported type */ 403 #define ASN1_ITEM_ptr(iptr) (iptr()) 404 405 /* Macro to include ASN1_ITEM pointer from base type */ 406 #define ASN1_ITEM_ref(iptr) (iptr##_it) 407 408 #define ASN1_ITEM_rptr(ref) (ref##_it()) 409 410 #define DECLARE_ASN1_ITEM(name) \ 411 const ASN1_ITEM * name##_it(void); 412 413 #endif 414 415 /* Parameters used by ASN1_STRING_print_ex() */ 416 417 /* These determine which characters to escape: 418 * RFC2253 special characters, control characters and 419 * MSB set characters 420 */ 421 422 #define ASN1_STRFLGS_ESC_2253 1 423 #define ASN1_STRFLGS_ESC_CTRL 2 424 #define ASN1_STRFLGS_ESC_MSB 4 425 426 427 /* This flag determines how we do escaping: normally 428 * RC2253 backslash only, set this to use backslash and 429 * quote. 430 */ 431 432 #define ASN1_STRFLGS_ESC_QUOTE 8 433 434 435 /* These three flags are internal use only. */ 436 437 /* Character is a valid PrintableString character */ 438 #define CHARTYPE_PRINTABLESTRING 0x10 439 /* Character needs escaping if it is the first character */ 440 #define CHARTYPE_FIRST_ESC_2253 0x20 441 /* Character needs escaping if it is the last character */ 442 #define CHARTYPE_LAST_ESC_2253 0x40 443 444 /* NB the internal flags are safely reused below by flags 445 * handled at the top level. 446 */ 447 448 /* If this is set we convert all character strings 449 * to UTF8 first 450 */ 451 452 #define ASN1_STRFLGS_UTF8_CONVERT 0x10 453 454 /* If this is set we don't attempt to interpret content: 455 * just assume all strings are 1 byte per character. This 456 * will produce some pretty odd looking output! 457 */ 458 459 #define ASN1_STRFLGS_IGNORE_TYPE 0x20 460 461 /* If this is set we include the string type in the output */ 462 #define ASN1_STRFLGS_SHOW_TYPE 0x40 463 464 /* This determines which strings to display and which to 465 * 'dump' (hex dump of content octets or DER encoding). We can 466 * only dump non character strings or everything. If we 467 * don't dump 'unknown' they are interpreted as character 468 * strings with 1 octet per character and are subject to 469 * the usual escaping options. 470 */ 471 472 #define ASN1_STRFLGS_DUMP_ALL 0x80 473 #define ASN1_STRFLGS_DUMP_UNKNOWN 0x100 474 475 /* These determine what 'dumping' does, we can dump the 476 * content octets or the DER encoding: both use the 477 * RFC2253 #XXXXX notation. 478 */ 479 480 #define ASN1_STRFLGS_DUMP_DER 0x200 481 482 /* All the string flags consistent with RFC2253, 483 * escaping control characters isn't essential in 484 * RFC2253 but it is advisable anyway. 485 */ 486 487 #define ASN1_STRFLGS_RFC2253 (ASN1_STRFLGS_ESC_2253 | \ 488 ASN1_STRFLGS_ESC_CTRL | \ 489 ASN1_STRFLGS_ESC_MSB | \ 490 ASN1_STRFLGS_UTF8_CONVERT | \ 491 ASN1_STRFLGS_DUMP_UNKNOWN | \ 492 ASN1_STRFLGS_DUMP_DER) 493 494 DECLARE_STACK_OF(ASN1_INTEGER) 495 DECLARE_ASN1_SET_OF(ASN1_INTEGER) 496 497 DECLARE_STACK_OF(ASN1_GENERALSTRING) 498 499 typedef struct asn1_type_st 500 { 501 int type; 502 union { 503 char *ptr; 504 ASN1_BOOLEAN boolean; 505 ASN1_STRING * asn1_string; 506 ASN1_OBJECT * object; 507 ASN1_INTEGER * integer; 508 ASN1_ENUMERATED * enumerated; 509 ASN1_BIT_STRING * bit_string; 510 ASN1_OCTET_STRING * octet_string; 511 ASN1_PRINTABLESTRING * printablestring; 512 ASN1_T61STRING * t61string; 513 ASN1_IA5STRING * ia5string; 514 ASN1_GENERALSTRING * generalstring; 515 ASN1_BMPSTRING * bmpstring; 516 ASN1_UNIVERSALSTRING * universalstring; 517 ASN1_UTCTIME * utctime; 518 ASN1_GENERALIZEDTIME * generalizedtime; 519 ASN1_VISIBLESTRING * visiblestring; 520 ASN1_UTF8STRING * utf8string; 521 /* set and sequence are left complete and still 522 * contain the set or sequence bytes */ 523 ASN1_STRING * set; 524 ASN1_STRING * sequence; 525 } value; 526 } ASN1_TYPE; 527 528 DECLARE_STACK_OF(ASN1_TYPE) 529 DECLARE_ASN1_SET_OF(ASN1_TYPE) 530 531 typedef struct asn1_method_st 532 { 533 i2d_of_void *i2d; 534 d2i_of_void *d2i; 535 void *(*create)(void); 536 void (*destroy)(void *); 537 } ASN1_METHOD; 538 539 /* This is used when parsing some Netscape objects */ 540 typedef struct asn1_header_st 541 { 542 ASN1_OCTET_STRING *header; 543 void *data; 544 ASN1_METHOD *meth; 545 } ASN1_HEADER; 546 547 /* This is used to contain a list of bit names */ 548 typedef struct BIT_STRING_BITNAME_st { 549 int bitnum; 550 const char *lname; 551 const char *sname; 552 } BIT_STRING_BITNAME; 553 554 555 #define M_ASN1_STRING_length(x) ((x)->length) 556 #define M_ASN1_STRING_length_set(x, n) ((x)->length = (n)) 557 #define M_ASN1_STRING_type(x) ((x)->type) 558 #define M_ASN1_STRING_data(x) ((x)->data) 559 560 /* Macros for string operations */ 561 #define M_ASN1_BIT_STRING_new() (ASN1_BIT_STRING *)\ 562 ASN1_STRING_type_new(V_ASN1_BIT_STRING) 563 #define M_ASN1_BIT_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 564 #define M_ASN1_BIT_STRING_dup(a) (ASN1_BIT_STRING *)\ 565 ASN1_STRING_dup((ASN1_STRING *)a) 566 #define M_ASN1_BIT_STRING_cmp(a,b) ASN1_STRING_cmp(\ 567 (ASN1_STRING *)a,(ASN1_STRING *)b) 568 #define M_ASN1_BIT_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c) 569 570 #define M_ASN1_INTEGER_new() (ASN1_INTEGER *)\ 571 ASN1_STRING_type_new(V_ASN1_INTEGER) 572 #define M_ASN1_INTEGER_free(a) ASN1_STRING_free((ASN1_STRING *)a) 573 #define M_ASN1_INTEGER_dup(a) (ASN1_INTEGER *)ASN1_STRING_dup((ASN1_STRING *)a) 574 #define M_ASN1_INTEGER_cmp(a,b) ASN1_STRING_cmp(\ 575 (ASN1_STRING *)a,(ASN1_STRING *)b) 576 577 #define M_ASN1_ENUMERATED_new() (ASN1_ENUMERATED *)\ 578 ASN1_STRING_type_new(V_ASN1_ENUMERATED) 579 #define M_ASN1_ENUMERATED_free(a) ASN1_STRING_free((ASN1_STRING *)a) 580 #define M_ASN1_ENUMERATED_dup(a) (ASN1_ENUMERATED *)ASN1_STRING_dup((ASN1_STRING *)a) 581 #define M_ASN1_ENUMERATED_cmp(a,b) ASN1_STRING_cmp(\ 582 (ASN1_STRING *)a,(ASN1_STRING *)b) 583 584 #define M_ASN1_OCTET_STRING_new() (ASN1_OCTET_STRING *)\ 585 ASN1_STRING_type_new(V_ASN1_OCTET_STRING) 586 #define M_ASN1_OCTET_STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 587 #define M_ASN1_OCTET_STRING_dup(a) (ASN1_OCTET_STRING *)\ 588 ASN1_STRING_dup((ASN1_STRING *)a) 589 #define M_ASN1_OCTET_STRING_cmp(a,b) ASN1_STRING_cmp(\ 590 (ASN1_STRING *)a,(ASN1_STRING *)b) 591 #define M_ASN1_OCTET_STRING_set(a,b,c) ASN1_STRING_set((ASN1_STRING *)a,b,c) 592 #define M_ASN1_OCTET_STRING_print(a,b) ASN1_STRING_print(a,(ASN1_STRING *)b) 593 #define M_i2d_ASN1_OCTET_STRING(a,pp) \ 594 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_OCTET_STRING,\ 595 V_ASN1_UNIVERSAL) 596 597 #define B_ASN1_TIME \ 598 B_ASN1_UTCTIME | \ 599 B_ASN1_GENERALIZEDTIME 600 601 #define B_ASN1_PRINTABLE \ 602 B_ASN1_PRINTABLESTRING| \ 603 B_ASN1_T61STRING| \ 604 B_ASN1_IA5STRING| \ 605 B_ASN1_BIT_STRING| \ 606 B_ASN1_UNIVERSALSTRING|\ 607 B_ASN1_BMPSTRING|\ 608 B_ASN1_UTF8STRING|\ 609 B_ASN1_SEQUENCE|\ 610 B_ASN1_UNKNOWN 611 612 #define B_ASN1_DIRECTORYSTRING \ 613 B_ASN1_PRINTABLESTRING| \ 614 B_ASN1_TELETEXSTRING|\ 615 B_ASN1_BMPSTRING|\ 616 B_ASN1_UNIVERSALSTRING|\ 617 B_ASN1_UTF8STRING 618 619 #define B_ASN1_DISPLAYTEXT \ 620 B_ASN1_IA5STRING| \ 621 B_ASN1_VISIBLESTRING| \ 622 B_ASN1_BMPSTRING|\ 623 B_ASN1_UTF8STRING 624 625 #define M_ASN1_PRINTABLE_new() ASN1_STRING_type_new(V_ASN1_T61STRING) 626 #define M_ASN1_PRINTABLE_free(a) ASN1_STRING_free((ASN1_STRING *)a) 627 #define M_i2d_ASN1_PRINTABLE(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\ 628 pp,a->type,V_ASN1_UNIVERSAL) 629 #define M_d2i_ASN1_PRINTABLE(a,pp,l) \ 630 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \ 631 B_ASN1_PRINTABLE) 632 633 #define M_DIRECTORYSTRING_new() ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING) 634 #define M_DIRECTORYSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 635 #define M_i2d_DIRECTORYSTRING(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\ 636 pp,a->type,V_ASN1_UNIVERSAL) 637 #define M_d2i_DIRECTORYSTRING(a,pp,l) \ 638 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \ 639 B_ASN1_DIRECTORYSTRING) 640 641 #define M_DISPLAYTEXT_new() ASN1_STRING_type_new(V_ASN1_VISIBLESTRING) 642 #define M_DISPLAYTEXT_free(a) ASN1_STRING_free((ASN1_STRING *)a) 643 #define M_i2d_DISPLAYTEXT(a,pp) i2d_ASN1_bytes((ASN1_STRING *)a,\ 644 pp,a->type,V_ASN1_UNIVERSAL) 645 #define M_d2i_DISPLAYTEXT(a,pp,l) \ 646 d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l, \ 647 B_ASN1_DISPLAYTEXT) 648 649 #define M_ASN1_PRINTABLESTRING_new() (ASN1_PRINTABLESTRING *)\ 650 ASN1_STRING_type_new(V_ASN1_PRINTABLESTRING) 651 #define M_ASN1_PRINTABLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 652 #define M_i2d_ASN1_PRINTABLESTRING(a,pp) \ 653 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_PRINTABLESTRING,\ 654 V_ASN1_UNIVERSAL) 655 #define M_d2i_ASN1_PRINTABLESTRING(a,pp,l) \ 656 (ASN1_PRINTABLESTRING *)d2i_ASN1_type_bytes\ 657 ((ASN1_STRING **)a,pp,l,B_ASN1_PRINTABLESTRING) 658 659 #define M_ASN1_T61STRING_new() (ASN1_T61STRING *)\ 660 ASN1_STRING_type_new(V_ASN1_T61STRING) 661 #define M_ASN1_T61STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 662 #define M_i2d_ASN1_T61STRING(a,pp) \ 663 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_T61STRING,\ 664 V_ASN1_UNIVERSAL) 665 #define M_d2i_ASN1_T61STRING(a,pp,l) \ 666 (ASN1_T61STRING *)d2i_ASN1_type_bytes\ 667 ((ASN1_STRING **)a,pp,l,B_ASN1_T61STRING) 668 669 #define M_ASN1_IA5STRING_new() (ASN1_IA5STRING *)\ 670 ASN1_STRING_type_new(V_ASN1_IA5STRING) 671 #define M_ASN1_IA5STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 672 #define M_ASN1_IA5STRING_dup(a) \ 673 (ASN1_IA5STRING *)ASN1_STRING_dup((ASN1_STRING *)a) 674 #define M_i2d_ASN1_IA5STRING(a,pp) \ 675 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_IA5STRING,\ 676 V_ASN1_UNIVERSAL) 677 #define M_d2i_ASN1_IA5STRING(a,pp,l) \ 678 (ASN1_IA5STRING *)d2i_ASN1_type_bytes((ASN1_STRING **)a,pp,l,\ 679 B_ASN1_IA5STRING) 680 681 #define M_ASN1_UTCTIME_new() (ASN1_UTCTIME *)\ 682 ASN1_STRING_type_new(V_ASN1_UTCTIME) 683 #define M_ASN1_UTCTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a) 684 #define M_ASN1_UTCTIME_dup(a) (ASN1_UTCTIME *)ASN1_STRING_dup((ASN1_STRING *)a) 685 686 #define M_ASN1_GENERALIZEDTIME_new() (ASN1_GENERALIZEDTIME *)\ 687 ASN1_STRING_type_new(V_ASN1_GENERALIZEDTIME) 688 #define M_ASN1_GENERALIZEDTIME_free(a) ASN1_STRING_free((ASN1_STRING *)a) 689 #define M_ASN1_GENERALIZEDTIME_dup(a) (ASN1_GENERALIZEDTIME *)ASN1_STRING_dup(\ 690 (ASN1_STRING *)a) 691 692 #define M_ASN1_TIME_new() (ASN1_TIME *)\ 693 ASN1_STRING_type_new(V_ASN1_UTCTIME) 694 #define M_ASN1_TIME_free(a) ASN1_STRING_free((ASN1_STRING *)a) 695 #define M_ASN1_TIME_dup(a) (ASN1_TIME *)ASN1_STRING_dup((ASN1_STRING *)a) 696 697 #define M_ASN1_GENERALSTRING_new() (ASN1_GENERALSTRING *)\ 698 ASN1_STRING_type_new(V_ASN1_GENERALSTRING) 699 #define M_ASN1_GENERALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 700 #define M_i2d_ASN1_GENERALSTRING(a,pp) \ 701 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_GENERALSTRING,\ 702 V_ASN1_UNIVERSAL) 703 #define M_d2i_ASN1_GENERALSTRING(a,pp,l) \ 704 (ASN1_GENERALSTRING *)d2i_ASN1_type_bytes\ 705 ((ASN1_STRING **)a,pp,l,B_ASN1_GENERALSTRING) 706 707 #define M_ASN1_UNIVERSALSTRING_new() (ASN1_UNIVERSALSTRING *)\ 708 ASN1_STRING_type_new(V_ASN1_UNIVERSALSTRING) 709 #define M_ASN1_UNIVERSALSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 710 #define M_i2d_ASN1_UNIVERSALSTRING(a,pp) \ 711 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UNIVERSALSTRING,\ 712 V_ASN1_UNIVERSAL) 713 #define M_d2i_ASN1_UNIVERSALSTRING(a,pp,l) \ 714 (ASN1_UNIVERSALSTRING *)d2i_ASN1_type_bytes\ 715 ((ASN1_STRING **)a,pp,l,B_ASN1_UNIVERSALSTRING) 716 717 #define M_ASN1_BMPSTRING_new() (ASN1_BMPSTRING *)\ 718 ASN1_STRING_type_new(V_ASN1_BMPSTRING) 719 #define M_ASN1_BMPSTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 720 #define M_i2d_ASN1_BMPSTRING(a,pp) \ 721 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_BMPSTRING,\ 722 V_ASN1_UNIVERSAL) 723 #define M_d2i_ASN1_BMPSTRING(a,pp,l) \ 724 (ASN1_BMPSTRING *)d2i_ASN1_type_bytes\ 725 ((ASN1_STRING **)a,pp,l,B_ASN1_BMPSTRING) 726 727 #define M_ASN1_VISIBLESTRING_new() (ASN1_VISIBLESTRING *)\ 728 ASN1_STRING_type_new(V_ASN1_VISIBLESTRING) 729 #define M_ASN1_VISIBLESTRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 730 #define M_i2d_ASN1_VISIBLESTRING(a,pp) \ 731 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_VISIBLESTRING,\ 732 V_ASN1_UNIVERSAL) 733 #define M_d2i_ASN1_VISIBLESTRING(a,pp,l) \ 734 (ASN1_VISIBLESTRING *)d2i_ASN1_type_bytes\ 735 ((ASN1_STRING **)a,pp,l,B_ASN1_VISIBLESTRING) 736 737 #define M_ASN1_UTF8STRING_new() (ASN1_UTF8STRING *)\ 738 ASN1_STRING_type_new(V_ASN1_UTF8STRING) 739 #define M_ASN1_UTF8STRING_free(a) ASN1_STRING_free((ASN1_STRING *)a) 740 #define M_i2d_ASN1_UTF8STRING(a,pp) \ 741 i2d_ASN1_bytes((ASN1_STRING *)a,pp,V_ASN1_UTF8STRING,\ 742 V_ASN1_UNIVERSAL) 743 #define M_d2i_ASN1_UTF8STRING(a,pp,l) \ 744 (ASN1_UTF8STRING *)d2i_ASN1_type_bytes\ 745 ((ASN1_STRING **)a,pp,l,B_ASN1_UTF8STRING) 746 747 /* for the is_set parameter to i2d_ASN1_SET */ 748 #define IS_SEQUENCE 0 749 #define IS_SET 1 750 751 DECLARE_ASN1_FUNCTIONS_fname(ASN1_TYPE, ASN1_ANY, ASN1_TYPE) 752 753 int ASN1_TYPE_get(ASN1_TYPE *a); 754 void ASN1_TYPE_set(ASN1_TYPE *a, int type, void *value); 755 756 ASN1_OBJECT * ASN1_OBJECT_new(void ); 757 void ASN1_OBJECT_free(ASN1_OBJECT *a); 758 int i2d_ASN1_OBJECT(ASN1_OBJECT *a,unsigned char **pp); 759 ASN1_OBJECT * c2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp, 760 long length); 761 ASN1_OBJECT * d2i_ASN1_OBJECT(ASN1_OBJECT **a,const unsigned char **pp, 762 long length); 763 764 DECLARE_ASN1_ITEM(ASN1_OBJECT) 765 766 DECLARE_STACK_OF(ASN1_OBJECT) 767 DECLARE_ASN1_SET_OF(ASN1_OBJECT) 768 769 ASN1_STRING * ASN1_STRING_new(void); 770 void ASN1_STRING_free(ASN1_STRING *a); 771 ASN1_STRING * ASN1_STRING_dup(ASN1_STRING *a); 772 ASN1_STRING * ASN1_STRING_type_new(int type ); 773 int ASN1_STRING_cmp(ASN1_STRING *a, ASN1_STRING *b); 774 /* Since this is used to store all sorts of things, via macros, for now, make 775 its data void * */ 776 int ASN1_STRING_set(ASN1_STRING *str, const void *data, int len); 777 int ASN1_STRING_length(ASN1_STRING *x); 778 void ASN1_STRING_length_set(ASN1_STRING *x, int n); 779 int ASN1_STRING_type(ASN1_STRING *x); 780 unsigned char * ASN1_STRING_data(ASN1_STRING *x); 781 782 DECLARE_ASN1_FUNCTIONS(ASN1_BIT_STRING) 783 int i2c_ASN1_BIT_STRING(ASN1_BIT_STRING *a,unsigned char **pp); 784 ASN1_BIT_STRING *c2i_ASN1_BIT_STRING(ASN1_BIT_STRING **a,const unsigned char **pp, 785 long length); 786 int ASN1_BIT_STRING_set(ASN1_BIT_STRING *a, unsigned char *d, 787 int length ); 788 int ASN1_BIT_STRING_set_bit(ASN1_BIT_STRING *a, int n, int value); 789 int ASN1_BIT_STRING_get_bit(ASN1_BIT_STRING *a, int n); 790 791 #ifndef OPENSSL_NO_BIO 792 int ASN1_BIT_STRING_name_print(BIO *out, ASN1_BIT_STRING *bs, 793 BIT_STRING_BITNAME *tbl, int indent); 794 #endif 795 int ASN1_BIT_STRING_num_asc(char *name, BIT_STRING_BITNAME *tbl); 796 int ASN1_BIT_STRING_set_asc(ASN1_BIT_STRING *bs, char *name, int value, 797 BIT_STRING_BITNAME *tbl); 798 799 int i2d_ASN1_BOOLEAN(int a,unsigned char **pp); 800 int d2i_ASN1_BOOLEAN(int *a,const unsigned char **pp,long length); 801 802 DECLARE_ASN1_FUNCTIONS(ASN1_INTEGER) 803 int i2c_ASN1_INTEGER(ASN1_INTEGER *a,unsigned char **pp); 804 ASN1_INTEGER *c2i_ASN1_INTEGER(ASN1_INTEGER **a,const unsigned char **pp, 805 long length); 806 ASN1_INTEGER *d2i_ASN1_UINTEGER(ASN1_INTEGER **a,const unsigned char **pp, 807 long length); 808 ASN1_INTEGER * ASN1_INTEGER_dup(ASN1_INTEGER *x); 809 int ASN1_INTEGER_cmp(ASN1_INTEGER *x, ASN1_INTEGER *y); 810 811 DECLARE_ASN1_FUNCTIONS(ASN1_ENUMERATED) 812 813 int ASN1_UTCTIME_check(ASN1_UTCTIME *a); 814 ASN1_UTCTIME *ASN1_UTCTIME_set(ASN1_UTCTIME *s,time_t t); 815 int ASN1_UTCTIME_set_string(ASN1_UTCTIME *s, const char *str); 816 int ASN1_UTCTIME_cmp_time_t(const ASN1_UTCTIME *s, time_t t); 817 #if 0 818 time_t ASN1_UTCTIME_get(const ASN1_UTCTIME *s); 819 #endif 820 821 int ASN1_GENERALIZEDTIME_check(ASN1_GENERALIZEDTIME *a); 822 ASN1_GENERALIZEDTIME *ASN1_GENERALIZEDTIME_set(ASN1_GENERALIZEDTIME *s,time_t t); 823 int ASN1_GENERALIZEDTIME_set_string(ASN1_GENERALIZEDTIME *s, const char *str); 824 825 DECLARE_ASN1_FUNCTIONS(ASN1_OCTET_STRING) 826 ASN1_OCTET_STRING * ASN1_OCTET_STRING_dup(ASN1_OCTET_STRING *a); 827 int ASN1_OCTET_STRING_cmp(ASN1_OCTET_STRING *a, ASN1_OCTET_STRING *b); 828 int ASN1_OCTET_STRING_set(ASN1_OCTET_STRING *str, const unsigned char *data, int len); 829 830 DECLARE_ASN1_FUNCTIONS(ASN1_VISIBLESTRING) 831 DECLARE_ASN1_FUNCTIONS(ASN1_UNIVERSALSTRING) 832 DECLARE_ASN1_FUNCTIONS(ASN1_UTF8STRING) 833 DECLARE_ASN1_FUNCTIONS(ASN1_NULL) 834 DECLARE_ASN1_FUNCTIONS(ASN1_BMPSTRING) 835 836 int UTF8_getc(const unsigned char *str, int len, unsigned long *val); 837 int UTF8_putc(unsigned char *str, int len, unsigned long value); 838 839 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, ASN1_PRINTABLE) 840 841 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DIRECTORYSTRING) 842 DECLARE_ASN1_FUNCTIONS_name(ASN1_STRING, DISPLAYTEXT) 843 DECLARE_ASN1_FUNCTIONS(ASN1_PRINTABLESTRING) 844 DECLARE_ASN1_FUNCTIONS(ASN1_T61STRING) 845 DECLARE_ASN1_FUNCTIONS(ASN1_IA5STRING) 846 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALSTRING) 847 DECLARE_ASN1_FUNCTIONS(ASN1_UTCTIME) 848 DECLARE_ASN1_FUNCTIONS(ASN1_GENERALIZEDTIME) 849 DECLARE_ASN1_FUNCTIONS(ASN1_TIME) 850 851 DECLARE_ASN1_ITEM(ASN1_OCTET_STRING_NDEF) 852 853 ASN1_TIME *ASN1_TIME_set(ASN1_TIME *s,time_t t); 854 int ASN1_TIME_check(ASN1_TIME *t); 855 ASN1_GENERALIZEDTIME *ASN1_TIME_to_generalizedtime(ASN1_TIME *t, ASN1_GENERALIZEDTIME **out); 856 857 int i2d_ASN1_SET(STACK *a, unsigned char **pp, 858 i2d_of_void *i2d, int ex_tag, int ex_class, int is_set); 859 STACK * d2i_ASN1_SET(STACK **a, const unsigned char **pp, long length, 860 d2i_of_void *d2i, void (*free_func)(void *), 861 int ex_tag, int ex_class); 862 863 #ifndef OPENSSL_NO_BIO 864 int i2a_ASN1_INTEGER(BIO *bp, ASN1_INTEGER *a); 865 int a2i_ASN1_INTEGER(BIO *bp,ASN1_INTEGER *bs,char *buf,int size); 866 int i2a_ASN1_ENUMERATED(BIO *bp, ASN1_ENUMERATED *a); 867 int a2i_ASN1_ENUMERATED(BIO *bp,ASN1_ENUMERATED *bs,char *buf,int size); 868 int i2a_ASN1_OBJECT(BIO *bp,ASN1_OBJECT *a); 869 int a2i_ASN1_STRING(BIO *bp,ASN1_STRING *bs,char *buf,int size); 870 int i2a_ASN1_STRING(BIO *bp, ASN1_STRING *a, int type); 871 #endif 872 int i2t_ASN1_OBJECT(char *buf,int buf_len,ASN1_OBJECT *a); 873 874 int a2d_ASN1_OBJECT(unsigned char *out,int olen, const char *buf, int num); 875 ASN1_OBJECT *ASN1_OBJECT_create(int nid, unsigned char *data,int len, 876 const char *sn, const char *ln); 877 878 int ASN1_INTEGER_set(ASN1_INTEGER *a, long v); 879 long ASN1_INTEGER_get(ASN1_INTEGER *a); 880 ASN1_INTEGER *BN_to_ASN1_INTEGER(BIGNUM *bn, ASN1_INTEGER *ai); 881 BIGNUM *ASN1_INTEGER_to_BN(ASN1_INTEGER *ai,BIGNUM *bn); 882 883 int ASN1_ENUMERATED_set(ASN1_ENUMERATED *a, long v); 884 long ASN1_ENUMERATED_get(ASN1_ENUMERATED *a); 885 ASN1_ENUMERATED *BN_to_ASN1_ENUMERATED(BIGNUM *bn, ASN1_ENUMERATED *ai); 886 BIGNUM *ASN1_ENUMERATED_to_BN(ASN1_ENUMERATED *ai,BIGNUM *bn); 887 888 /* General */ 889 /* given a string, return the correct type, max is the maximum length */ 890 int ASN1_PRINTABLE_type(const unsigned char *s, int max); 891 892 int i2d_ASN1_bytes(ASN1_STRING *a, unsigned char **pp, int tag, int xclass); 893 ASN1_STRING *d2i_ASN1_bytes(ASN1_STRING **a, const unsigned char **pp, 894 long length, int Ptag, int Pclass); 895 unsigned long ASN1_tag2bit(int tag); 896 /* type is one or more of the B_ASN1_ values. */ 897 ASN1_STRING *d2i_ASN1_type_bytes(ASN1_STRING **a,const unsigned char **pp, 898 long length,int type); 899 900 /* PARSING */ 901 int asn1_Finish(ASN1_CTX *c); 902 int asn1_const_Finish(ASN1_const_CTX *c); 903 904 /* SPECIALS */ 905 int ASN1_get_object(const unsigned char **pp, long *plength, int *ptag, 906 int *pclass, long omax); 907 int ASN1_check_infinite_end(unsigned char **p,long len); 908 int ASN1_const_check_infinite_end(const unsigned char **p,long len); 909 void ASN1_put_object(unsigned char **pp, int constructed, int length, 910 int tag, int xclass); 911 int ASN1_put_eoc(unsigned char **pp); 912 int ASN1_object_size(int constructed, int length, int tag); 913 914 /* Used to implement other functions */ 915 void *ASN1_dup(i2d_of_void *i2d, d2i_of_void *d2i, char *x); 916 917 #define ASN1_dup_of(type,i2d,d2i,x) \ 918 ((type*)ASN1_dup(CHECKED_I2D_OF(type, i2d), \ 919 CHECKED_D2I_OF(type, d2i), \ 920 CHECKED_PTR_OF(type, x))) 921 922 #define ASN1_dup_of_const(type,i2d,d2i,x) \ 923 ((type*)ASN1_dup(CHECKED_I2D_OF(const type, i2d), \ 924 CHECKED_D2I_OF(type, d2i), \ 925 CHECKED_PTR_OF(const type, x))) 926 927 void *ASN1_item_dup(const ASN1_ITEM *it, void *x); 928 929 #ifndef OPENSSL_NO_FP_API 930 void *ASN1_d2i_fp(void *(*xnew)(void), d2i_of_void *d2i, FILE *in, void **x); 931 932 #define ASN1_d2i_fp_of(type,xnew,d2i,in,x) \ 933 ((type*)ASN1_d2i_fp(CHECKED_NEW_OF(type, xnew), \ 934 CHECKED_D2I_OF(type, d2i), \ 935 in, \ 936 CHECKED_PPTR_OF(type, x))) 937 938 void *ASN1_item_d2i_fp(const ASN1_ITEM *it, FILE *in, void *x); 939 int ASN1_i2d_fp(i2d_of_void *i2d,FILE *out,void *x); 940 941 #define ASN1_i2d_fp_of(type,i2d,out,x) \ 942 (ASN1_i2d_fp(CHECKED_I2D_OF(type, i2d), \ 943 out, \ 944 CHECKED_PTR_OF(type, x))) 945 946 #define ASN1_i2d_fp_of_const(type,i2d,out,x) \ 947 (ASN1_i2d_fp(CHECKED_I2D_OF(const type, i2d), \ 948 out, \ 949 CHECKED_PTR_OF(const type, x))) 950 951 int ASN1_item_i2d_fp(const ASN1_ITEM *it, FILE *out, void *x); 952 int ASN1_STRING_print_ex_fp(FILE *fp, ASN1_STRING *str, unsigned long flags); 953 #endif 954 955 int ASN1_STRING_to_UTF8(unsigned char **out, ASN1_STRING *in); 956 957 #ifndef OPENSSL_NO_BIO 958 void *ASN1_d2i_bio(void *(*xnew)(void), d2i_of_void *d2i, BIO *in, void **x); 959 960 #define ASN1_d2i_bio_of(type,xnew,d2i,in,x) \ 961 ((type*)ASN1_d2i_bio( CHECKED_NEW_OF(type, xnew), \ 962 CHECKED_D2I_OF(type, d2i), \ 963 in, \ 964 CHECKED_PPTR_OF(type, x))) 965 966 void *ASN1_item_d2i_bio(const ASN1_ITEM *it, BIO *in, void *x); 967 int ASN1_i2d_bio(i2d_of_void *i2d,BIO *out, unsigned char *x); 968 969 #define ASN1_i2d_bio_of(type,i2d,out,x) \ 970 (ASN1_i2d_bio(CHECKED_I2D_OF(type, i2d), \ 971 out, \ 972 CHECKED_PTR_OF(type, x))) 973 974 #define ASN1_i2d_bio_of_const(type,i2d,out,x) \ 975 (ASN1_i2d_bio(CHECKED_I2D_OF(const type, i2d), \ 976 out, \ 977 CHECKED_PTR_OF(const type, x))) 978 979 int ASN1_item_i2d_bio(const ASN1_ITEM *it, BIO *out, void *x); 980 int ASN1_UTCTIME_print(BIO *fp,ASN1_UTCTIME *a); 981 int ASN1_GENERALIZEDTIME_print(BIO *fp,ASN1_GENERALIZEDTIME *a); 982 int ASN1_TIME_print(BIO *fp,ASN1_TIME *a); 983 int ASN1_STRING_print(BIO *bp,ASN1_STRING *v); 984 int ASN1_STRING_print_ex(BIO *out, ASN1_STRING *str, unsigned long flags); 985 int ASN1_parse(BIO *bp,const unsigned char *pp,long len,int indent); 986 int ASN1_parse_dump(BIO *bp,const unsigned char *pp,long len,int indent,int dump); 987 #endif 988 const char *ASN1_tag2str(int tag); 989 990 /* Used to load and write netscape format cert/key */ 991 int i2d_ASN1_HEADER(ASN1_HEADER *a,unsigned char **pp); 992 ASN1_HEADER *d2i_ASN1_HEADER(ASN1_HEADER **a,const unsigned char **pp, long length); 993 ASN1_HEADER *ASN1_HEADER_new(void ); 994 void ASN1_HEADER_free(ASN1_HEADER *a); 995 996 int ASN1_UNIVERSALSTRING_to_string(ASN1_UNIVERSALSTRING *s); 997 998 /* Not used that much at this point, except for the first two */ 999 ASN1_METHOD *X509_asn1_meth(void); 1000 ASN1_METHOD *RSAPrivateKey_asn1_meth(void); 1001 ASN1_METHOD *ASN1_IA5STRING_asn1_meth(void); 1002 ASN1_METHOD *ASN1_BIT_STRING_asn1_meth(void); 1003 1004 int ASN1_TYPE_set_octetstring(ASN1_TYPE *a, 1005 unsigned char *data, int len); 1006 int ASN1_TYPE_get_octetstring(ASN1_TYPE *a, 1007 unsigned char *data, int max_len); 1008 int ASN1_TYPE_set_int_octetstring(ASN1_TYPE *a, long num, 1009 unsigned char *data, int len); 1010 int ASN1_TYPE_get_int_octetstring(ASN1_TYPE *a,long *num, 1011 unsigned char *data, int max_len); 1012 1013 STACK *ASN1_seq_unpack(const unsigned char *buf, int len, 1014 d2i_of_void *d2i, void (*free_func)(void *)); 1015 unsigned char *ASN1_seq_pack(STACK *safes, i2d_of_void *i2d, 1016 unsigned char **buf, int *len ); 1017 void *ASN1_unpack_string(ASN1_STRING *oct, d2i_of_void *d2i); 1018 void *ASN1_item_unpack(ASN1_STRING *oct, const ASN1_ITEM *it); 1019 ASN1_STRING *ASN1_pack_string(void *obj, i2d_of_void *i2d, 1020 ASN1_OCTET_STRING **oct); 1021 1022 #define ASN1_pack_string_of(type,obj,i2d,oct) \ 1023 (ASN1_pack_string(CHECKED_PTR_OF(type, obj), \ 1024 CHECKED_I2D_OF(type, i2d), \ 1025 oct)) 1026 1027 ASN1_STRING *ASN1_item_pack(void *obj, const ASN1_ITEM *it, ASN1_OCTET_STRING **oct); 1028 1029 void ASN1_STRING_set_default_mask(unsigned long mask); 1030 int ASN1_STRING_set_default_mask_asc(char *p); 1031 unsigned long ASN1_STRING_get_default_mask(void); 1032 int ASN1_mbstring_copy(ASN1_STRING **out, const unsigned char *in, int len, 1033 int inform, unsigned long mask); 1034 int ASN1_mbstring_ncopy(ASN1_STRING **out, const unsigned char *in, int len, 1035 int inform, unsigned long mask, 1036 long minsize, long maxsize); 1037 1038 ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out, 1039 const unsigned char *in, int inlen, int inform, int nid); 1040 ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid); 1041 int ASN1_STRING_TABLE_add(int, long, long, unsigned long, unsigned long); 1042 void ASN1_STRING_TABLE_cleanup(void); 1043 1044 /* ASN1 template functions */ 1045 1046 /* Old API compatible functions */ 1047 ASN1_VALUE *ASN1_item_new(const ASN1_ITEM *it); 1048 void ASN1_item_free(ASN1_VALUE *val, const ASN1_ITEM *it); 1049 ASN1_VALUE * ASN1_item_d2i(ASN1_VALUE **val, const unsigned char **in, long len, const ASN1_ITEM *it); 1050 int ASN1_item_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it); 1051 int ASN1_item_ndef_i2d(ASN1_VALUE *val, unsigned char **out, const ASN1_ITEM *it); 1052 1053 void ASN1_add_oid_module(void); 1054 1055 ASN1_TYPE *ASN1_generate_nconf(char *str, CONF *nconf); 1056 ASN1_TYPE *ASN1_generate_v3(char *str, X509V3_CTX *cnf); 1057 1058 /* BEGIN ERROR CODES */ 1059 /* The following lines are auto generated by the script mkerr.pl. Any changes 1060 * made after this point may be overwritten when the script is next run. 1061 */ 1062 void ERR_load_ASN1_strings(void); 1063 1064 /* Error codes for the ASN1 functions. */ 1065 1066 /* Function codes. */ 1067 #define ASN1_F_A2D_ASN1_OBJECT 100 1068 #define ASN1_F_A2I_ASN1_ENUMERATED 101 1069 #define ASN1_F_A2I_ASN1_INTEGER 102 1070 #define ASN1_F_A2I_ASN1_STRING 103 1071 #define ASN1_F_APPEND_EXP 176 1072 #define ASN1_F_ASN1_BIT_STRING_SET_BIT 183 1073 #define ASN1_F_ASN1_CB 177 1074 #define ASN1_F_ASN1_CHECK_TLEN 104 1075 #define ASN1_F_ASN1_COLLATE_PRIMITIVE 105 1076 #define ASN1_F_ASN1_COLLECT 106 1077 #define ASN1_F_ASN1_D2I_EX_PRIMITIVE 108 1078 #define ASN1_F_ASN1_D2I_FP 109 1079 #define ASN1_F_ASN1_D2I_READ_BIO 107 1080 #define ASN1_F_ASN1_DIGEST 184 1081 #define ASN1_F_ASN1_DO_ADB 110 1082 #define ASN1_F_ASN1_DUP 111 1083 #define ASN1_F_ASN1_ENUMERATED_SET 112 1084 #define ASN1_F_ASN1_ENUMERATED_TO_BN 113 1085 #define ASN1_F_ASN1_EX_C2I 204 1086 #define ASN1_F_ASN1_FIND_END 190 1087 #define ASN1_F_ASN1_GENERALIZEDTIME_SET 185 1088 #define ASN1_F_ASN1_GENERATE_V3 178 1089 #define ASN1_F_ASN1_GET_OBJECT 114 1090 #define ASN1_F_ASN1_HEADER_NEW 115 1091 #define ASN1_F_ASN1_I2D_BIO 116 1092 #define ASN1_F_ASN1_I2D_FP 117 1093 #define ASN1_F_ASN1_INTEGER_SET 118 1094 #define ASN1_F_ASN1_INTEGER_TO_BN 119 1095 #define ASN1_F_ASN1_ITEM_D2I_FP 206 1096 #define ASN1_F_ASN1_ITEM_DUP 191 1097 #define ASN1_F_ASN1_ITEM_EX_COMBINE_NEW 121 1098 #define ASN1_F_ASN1_ITEM_EX_D2I 120 1099 #define ASN1_F_ASN1_ITEM_I2D_BIO 192 1100 #define ASN1_F_ASN1_ITEM_I2D_FP 193 1101 #define ASN1_F_ASN1_ITEM_PACK 198 1102 #define ASN1_F_ASN1_ITEM_SIGN 195 1103 #define ASN1_F_ASN1_ITEM_UNPACK 199 1104 #define ASN1_F_ASN1_ITEM_VERIFY 197 1105 #define ASN1_F_ASN1_MBSTRING_NCOPY 122 1106 #define ASN1_F_ASN1_OBJECT_NEW 123 1107 #define ASN1_F_ASN1_PACK_STRING 124 1108 #define ASN1_F_ASN1_PCTX_NEW 205 1109 #define ASN1_F_ASN1_PKCS5_PBE_SET 125 1110 #define ASN1_F_ASN1_SEQ_PACK 126 1111 #define ASN1_F_ASN1_SEQ_UNPACK 127 1112 #define ASN1_F_ASN1_SIGN 128 1113 #define ASN1_F_ASN1_STR2TYPE 179 1114 #define ASN1_F_ASN1_STRING_SET 186 1115 #define ASN1_F_ASN1_STRING_TABLE_ADD 129 1116 #define ASN1_F_ASN1_STRING_TYPE_NEW 130 1117 #define ASN1_F_ASN1_TEMPLATE_EX_D2I 132 1118 #define ASN1_F_ASN1_TEMPLATE_NEW 133 1119 #define ASN1_F_ASN1_TEMPLATE_NOEXP_D2I 131 1120 #define ASN1_F_ASN1_TIME_SET 175 1121 #define ASN1_F_ASN1_TYPE_GET_INT_OCTETSTRING 134 1122 #define ASN1_F_ASN1_TYPE_GET_OCTETSTRING 135 1123 #define ASN1_F_ASN1_UNPACK_STRING 136 1124 #define ASN1_F_ASN1_UTCTIME_SET 187 1125 #define ASN1_F_ASN1_VERIFY 137 1126 #define ASN1_F_BITSTR_CB 180 1127 #define ASN1_F_BN_TO_ASN1_ENUMERATED 138 1128 #define ASN1_F_BN_TO_ASN1_INTEGER 139 1129 #define ASN1_F_C2I_ASN1_BIT_STRING 189 1130 #define ASN1_F_C2I_ASN1_INTEGER 194 1131 #define ASN1_F_C2I_ASN1_OBJECT 196 1132 #define ASN1_F_COLLECT_DATA 140 1133 #define ASN1_F_D2I_ASN1_BIT_STRING 141 1134 #define ASN1_F_D2I_ASN1_BOOLEAN 142 1135 #define ASN1_F_D2I_ASN1_BYTES 143 1136 #define ASN1_F_D2I_ASN1_GENERALIZEDTIME 144 1137 #define ASN1_F_D2I_ASN1_HEADER 145 1138 #define ASN1_F_D2I_ASN1_INTEGER 146 1139 #define ASN1_F_D2I_ASN1_OBJECT 147 1140 #define ASN1_F_D2I_ASN1_SET 148 1141 #define ASN1_F_D2I_ASN1_TYPE_BYTES 149 1142 #define ASN1_F_D2I_ASN1_UINTEGER 150 1143 #define ASN1_F_D2I_ASN1_UTCTIME 151 1144 #define ASN1_F_D2I_NETSCAPE_RSA 152 1145 #define ASN1_F_D2I_NETSCAPE_RSA_2 153 1146 #define ASN1_F_D2I_PRIVATEKEY 154 1147 #define ASN1_F_D2I_PUBLICKEY 155 1148 #define ASN1_F_D2I_RSA_NET 200 1149 #define ASN1_F_D2I_RSA_NET_2 201 1150 #define ASN1_F_D2I_X509 156 1151 #define ASN1_F_D2I_X509_CINF 157 1152 #define ASN1_F_D2I_X509_PKEY 159 1153 #define ASN1_F_I2D_ASN1_SET 188 1154 #define ASN1_F_I2D_ASN1_TIME 160 1155 #define ASN1_F_I2D_DSA_PUBKEY 161 1156 #define ASN1_F_I2D_EC_PUBKEY 181 1157 #define ASN1_F_I2D_PRIVATEKEY 163 1158 #define ASN1_F_I2D_PUBLICKEY 164 1159 #define ASN1_F_I2D_RSA_NET 162 1160 #define ASN1_F_I2D_RSA_PUBKEY 165 1161 #define ASN1_F_LONG_C2I 166 1162 #define ASN1_F_OID_MODULE_INIT 174 1163 #define ASN1_F_PARSE_TAGGING 182 1164 #define ASN1_F_PKCS5_PBE2_SET 167 1165 #define ASN1_F_PKCS5_PBE_SET 202 1166 #define ASN1_F_X509_CINF_NEW 168 1167 #define ASN1_F_X509_CRL_ADD0_REVOKED 169 1168 #define ASN1_F_X509_INFO_NEW 170 1169 #define ASN1_F_X509_NAME_ENCODE 203 1170 #define ASN1_F_X509_NAME_EX_D2I 158 1171 #define ASN1_F_X509_NAME_EX_NEW 171 1172 #define ASN1_F_X509_NEW 172 1173 #define ASN1_F_X509_PKEY_NEW 173 1174 1175 /* Reason codes. */ 1176 #define ASN1_R_ADDING_OBJECT 171 1177 #define ASN1_R_AUX_ERROR 100 1178 #define ASN1_R_BAD_CLASS 101 1179 #define ASN1_R_BAD_OBJECT_HEADER 102 1180 #define ASN1_R_BAD_PASSWORD_READ 103 1181 #define ASN1_R_BAD_TAG 104 1182 #define ASN1_R_BN_LIB 105 1183 #define ASN1_R_BOOLEAN_IS_WRONG_LENGTH 106 1184 #define ASN1_R_BUFFER_TOO_SMALL 107 1185 #define ASN1_R_CIPHER_HAS_NO_OBJECT_IDENTIFIER 108 1186 #define ASN1_R_DATA_IS_WRONG 109 1187 #define ASN1_R_DECODE_ERROR 110 1188 #define ASN1_R_DECODING_ERROR 111 1189 #define ASN1_R_DEPTH_EXCEEDED 174 1190 #define ASN1_R_ENCODE_ERROR 112 1191 #define ASN1_R_ERROR_GETTING_TIME 173 1192 #define ASN1_R_ERROR_LOADING_SECTION 172 1193 #define ASN1_R_ERROR_PARSING_SET_ELEMENT 113 1194 #define ASN1_R_ERROR_SETTING_CIPHER_PARAMS 114 1195 #define ASN1_R_EXPECTING_AN_INTEGER 115 1196 #define ASN1_R_EXPECTING_AN_OBJECT 116 1197 #define ASN1_R_EXPECTING_A_BOOLEAN 117 1198 #define ASN1_R_EXPECTING_A_TIME 118 1199 #define ASN1_R_EXPLICIT_LENGTH_MISMATCH 119 1200 #define ASN1_R_EXPLICIT_TAG_NOT_CONSTRUCTED 120 1201 #define ASN1_R_FIELD_MISSING 121 1202 #define ASN1_R_FIRST_NUM_TOO_LARGE 122 1203 #define ASN1_R_HEADER_TOO_LONG 123 1204 #define ASN1_R_ILLEGAL_BITSTRING_FORMAT 175 1205 #define ASN1_R_ILLEGAL_BOOLEAN 176 1206 #define ASN1_R_ILLEGAL_CHARACTERS 124 1207 #define ASN1_R_ILLEGAL_FORMAT 177 1208 #define ASN1_R_ILLEGAL_HEX 178 1209 #define ASN1_R_ILLEGAL_IMPLICIT_TAG 179 1210 #define ASN1_R_ILLEGAL_INTEGER 180 1211 #define ASN1_R_ILLEGAL_NESTED_TAGGING 181 1212 #define ASN1_R_ILLEGAL_NULL 125 1213 #define ASN1_R_ILLEGAL_NULL_VALUE 182 1214 #define ASN1_R_ILLEGAL_OBJECT 183 1215 #define ASN1_R_ILLEGAL_OPTIONAL_ANY 126 1216 #define ASN1_R_ILLEGAL_OPTIONS_ON_ITEM_TEMPLATE 170 1217 #define ASN1_R_ILLEGAL_TAGGED_ANY 127 1218 #define ASN1_R_ILLEGAL_TIME_VALUE 184 1219 #define ASN1_R_INTEGER_NOT_ASCII_FORMAT 185 1220 #define ASN1_R_INTEGER_TOO_LARGE_FOR_LONG 128 1221 #define ASN1_R_INVALID_BMPSTRING_LENGTH 129 1222 #define ASN1_R_INVALID_DIGIT 130 1223 #define ASN1_R_INVALID_MODIFIER 186 1224 #define ASN1_R_INVALID_NUMBER 187 1225 #define ASN1_R_INVALID_SEPARATOR 131 1226 #define ASN1_R_INVALID_TIME_FORMAT 132 1227 #define ASN1_R_INVALID_UNIVERSALSTRING_LENGTH 133 1228 #define ASN1_R_INVALID_UTF8STRING 134 1229 #define ASN1_R_IV_TOO_LARGE 135 1230 #define ASN1_R_LENGTH_ERROR 136 1231 #define ASN1_R_LIST_ERROR 188 1232 #define ASN1_R_MISSING_EOC 137 1233 #define ASN1_R_MISSING_SECOND_NUMBER 138 1234 #define ASN1_R_MISSING_VALUE 189 1235 #define ASN1_R_MSTRING_NOT_UNIVERSAL 139 1236 #define ASN1_R_MSTRING_WRONG_TAG 140 1237 #define ASN1_R_NESTED_ASN1_STRING 197 1238 #define ASN1_R_NON_HEX_CHARACTERS 141 1239 #define ASN1_R_NOT_ASCII_FORMAT 190 1240 #define ASN1_R_NOT_ENOUGH_DATA 142 1241 #define ASN1_R_NO_MATCHING_CHOICE_TYPE 143 1242 #define ASN1_R_NULL_IS_WRONG_LENGTH 144 1243 #define ASN1_R_OBJECT_NOT_ASCII_FORMAT 191 1244 #define ASN1_R_ODD_NUMBER_OF_CHARS 145 1245 #define ASN1_R_PRIVATE_KEY_HEADER_MISSING 146 1246 #define ASN1_R_SECOND_NUMBER_TOO_LARGE 147 1247 #define ASN1_R_SEQUENCE_LENGTH_MISMATCH 148 1248 #define ASN1_R_SEQUENCE_NOT_CONSTRUCTED 149 1249 #define ASN1_R_SEQUENCE_OR_SET_NEEDS_CONFIG 192 1250 #define ASN1_R_SHORT_LINE 150 1251 #define ASN1_R_STRING_TOO_LONG 151 1252 #define ASN1_R_STRING_TOO_SHORT 152 1253 #define ASN1_R_TAG_VALUE_TOO_HIGH 153 1254 #define ASN1_R_THE_ASN1_OBJECT_IDENTIFIER_IS_NOT_KNOWN_FOR_THIS_MD 154 1255 #define ASN1_R_TIME_NOT_ASCII_FORMAT 193 1256 #define ASN1_R_TOO_LONG 155 1257 #define ASN1_R_TYPE_NOT_CONSTRUCTED 156 1258 #define ASN1_R_UNABLE_TO_DECODE_RSA_KEY 157 1259 #define ASN1_R_UNABLE_TO_DECODE_RSA_PRIVATE_KEY 158 1260 #define ASN1_R_UNEXPECTED_EOC 159 1261 #define ASN1_R_UNKNOWN_FORMAT 160 1262 #define ASN1_R_UNKNOWN_MESSAGE_DIGEST_ALGORITHM 161 1263 #define ASN1_R_UNKNOWN_OBJECT_TYPE 162 1264 #define ASN1_R_UNKNOWN_PUBLIC_KEY_TYPE 163 1265 #define ASN1_R_UNKNOWN_TAG 194 1266 #define ASN1_R_UNKOWN_FORMAT 195 1267 #define ASN1_R_UNSUPPORTED_ANY_DEFINED_BY_TYPE 164 1268 #define ASN1_R_UNSUPPORTED_CIPHER 165 1269 #define ASN1_R_UNSUPPORTED_ENCRYPTION_ALGORITHM 166 1270 #define ASN1_R_UNSUPPORTED_PUBLIC_KEY_TYPE 167 1271 #define ASN1_R_UNSUPPORTED_TYPE 196 1272 #define ASN1_R_WRONG_TAG 168 1273 #define ASN1_R_WRONG_TYPE 169 1274 1275 #ifdef __cplusplus 1276 } 1277 #endif 1278 #endif 1279