crypto/x509v3/x509v3.h

   1 /* x509v3.h */
   2 /* Written by Dr Stephen N Henson (shenson@bigfoot.com) for the OpenSSL
   3  * project 1999.
   4  */
   5 /* ====================================================================
   6  * Copyright (c) 1999 The OpenSSL Project.  All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  *
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  *
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in
  17  *    the documentation and/or other materials provided with the
  18  *    distribution.
  19  *
  20  * 3. All advertising materials mentioning features or use of this
  21  *    software must display the following acknowledgment:
  22  *    "This product includes software developed by the OpenSSL Project
  23  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  24  *
  25  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  26  *    endorse or promote products derived from this software without
  27  *    prior written permission. For written permission, please contact
  28  *    licensing@OpenSSL.org.
  29  *
  30  * 5. Products derived from this software may not be called "OpenSSL"
  31  *    nor may "OpenSSL" appear in their names without prior written
  32  *    permission of the OpenSSL Project.
  33  *
  34  * 6. Redistributions of any form whatsoever must retain the following
  35  *    acknowledgment:
  36  *    "This product includes software developed by the OpenSSL Project
  37  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  38  *
  39  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  40  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  41  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  42  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  43  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  44  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  45  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  46  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  48  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  49  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  50  * OF THE POSSIBILITY OF SUCH DAMAGE.
  51  * ====================================================================
  52  *
  53  * This product includes cryptographic software written by Eric Young
  54  * (eay@cryptsoft.com).  This product includes software written by Tim
  55  * Hudson (tjh@cryptsoft.com).
  56  *
  57  */
  58 #ifndef HEADER_X509V3_H
  59 #define HEADER_X509V3_H
  60
  61 #ifdef __cplusplus
  62 extern "C" {
  63 #endif
  64
  65 #include "bio.h"
  66 #include "x509.h"
  67
  68 /* Forward reference */
  69 struct v3_ext_method;
  70 struct v3_ext_ctx;
  71
  72 /* Useful typedefs */
  73
  74 typedef char * (*X509V3_EXT_NEW)();
  75 typedef void (*X509V3_EXT_FREE)();
  76 typedef char * (*X509V3_EXT_D2I)();
  77 typedef int (*X509V3_EXT_I2D)();
  78 typedef STACK * (*X509V3_EXT_I2V)(struct v3_ext_method *method, char *ext, STACK *extlist);
  79 typedef char * (*X509V3_EXT_V2I)(struct v3_ext_method *method, struct v3_ext_ctx *ctx, STACK *values);
  80 typedef char * (*X509V3_EXT_I2S)(struct v3_ext_method *method, char *ext);
  81 typedef char * (*X509V3_EXT_S2I)(struct v3_ext_method *method, struct v3_ext_ctx *ctx, char *str);
  82 typedef int (*X509V3_EXT_I2R)(struct v3_ext_method *method, char *ext, BIO *out, int indent);
  83 typedef char *(*X509V3_EXT_R2I)(struct v3_ext_method *method, char *db, char *value);
  84
  85 /* V3 extension structure */
  86
  87 struct v3_ext_method {
  88 int ext_nid;
  89 int ext_flags;
  90 X509V3_EXT_NEW ext_new;
  91 X509V3_EXT_FREE ext_free;
  92 X509V3_EXT_D2I d2i;
  93 X509V3_EXT_I2D i2d;
  94
  95 /* The following pair is used for string extensions */
  96 X509V3_EXT_I2S i2s;
  97 X509V3_EXT_S2I s2i;
  98
  99 /* The following pair is used for multi-valued extensions */
 100 X509V3_EXT_I2V i2v;
 101 X509V3_EXT_V2I v2i;
 102
 103 /* The following are used for raw extensions */
 104 X509V3_EXT_I2R i2r;
 105 X509V3_EXT_R2I r2i;     /* Doesn't do anything *YET* */
 106
 107 char *usr_data; /* Any extension specific data */
 108 };
 109
 110
 111 /* Context specific info */
 112 struct v3_ext_ctx {
 113 #define CTX_TEST 0x1
 114 int flags;
 115 X509 *issuer_cert;
 116 X509 *subject_cert;
 117 X509_REQ *subject_req;
 118 X509_CRL *crl;
 119 /* Maybe more here */
 120 };
 121
 122 typedef struct v3_ext_method X509V3_EXT_METHOD;
 123 typedef struct v3_ext_ctx X509V3_CTX;
 124
 125 /* ext_flags values */
 126 #define X509V3_EXT_DYNAMIC      0x1
 127 #define X509V3_EXT_CTX_DEP      0x2
 128 #define X509V3_EXT_MULTILINE    0x4
 129
 130 typedef struct {
 131 int bitnum;
 132 char *lname;
 133 char *sname;
 134 } BIT_STRING_BITNAME;
 135
 136 typedef BIT_STRING_BITNAME ENUMERATED_NAMES;
 137
 138 typedef struct {
 139 int ca;
 140 ASN1_INTEGER *pathlen;
 141 } BASIC_CONSTRAINTS;
 142
 143 typedef struct {
 144 ASN1_OCTET_STRING *keyid;
 145 STACK *issuer;
 146 ASN1_INTEGER *serial;
 147 } AUTHORITY_KEYID;
 148
 149 typedef struct {
 150 ASN1_GENERALIZEDTIME *notBefore;
 151 ASN1_GENERALIZEDTIME *notAfter;
 152 } PKEY_USAGE_PERIOD;
 153
 154 typedef struct {
 155
 156 #define GEN_OTHERNAME   (0|V_ASN1_CONTEXT_SPECIFIC)
 157 #define GEN_EMAIL       (1|V_ASN1_CONTEXT_SPECIFIC)
 158 #define GEN_DNS         (2|V_ASN1_CONTEXT_SPECIFIC)
 159 #define GEN_X400        (3|V_ASN1_CONTEXT_SPECIFIC)
 160 #define GEN_DIRNAME     (4|V_ASN1_CONTEXT_SPECIFIC)
 161 #define GEN_EDIPARTY    (5|V_ASN1_CONTEXT_SPECIFIC)
 162 #define GEN_URI         (6|V_ASN1_CONTEXT_SPECIFIC)
 163 #define GEN_IPADD       (7|V_ASN1_CONTEXT_SPECIFIC)
 164 #define GEN_RID         (8|V_ASN1_CONTEXT_SPECIFIC)
 165
 166 int type;
 167 union {
 168         char *ptr;
 169         ASN1_IA5STRING *ia5;/* rfc822Name, dNSName, uniformResourceIdentifier */
 170         ASN1_OCTET_STRING *ip; /* iPAddress */
 171         X509_NAME *dirn;                /* dirn */
 172         ASN1_OBJECT *rid; /* registeredID */
 173         ASN1_TYPE *other; /* otherName, ediPartyName, x400Address */
 174 } d;
 175 } GENERAL_NAME;
 176
 177 /* Strong extranet structures */
 178
 179 typedef struct {
 180         ASN1_INTEGER *version;
 181         STACK /* SXNETID */ *ids;
 182 } SXNET;
 183
 184 typedef struct {
 185         ASN1_INTEGER *zone;
 186         ASN1_OCTET_STRING *user;
 187 } SXNETID;
 188
 189 #define X509V3_conf_err(val) ERR_add_error_data(6, "section:", val->section, \
 190 ",name:", val->name, ",value:", val->value);
 191
 192 #define EXT_BITSTRING(nid, table) { nid, 0, \
 193                         (X509V3_EXT_NEW)asn1_bit_string_new, ASN1_STRING_free, \
 194                         (X509V3_EXT_D2I)d2i_ASN1_BIT_STRING, \
 195                         i2d_ASN1_BIT_STRING, \
 196                         NULL, NULL, \
 197                         (X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \
 198                         (X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \
 199                         NULL, NULL, \
 200                         (char *)table}
 201
 202 #define EXT_IA5STRING(nid) { nid, 0, \
 203                         (X509V3_EXT_NEW)ia5string_new, ASN1_STRING_free, \
 204                         (X509V3_EXT_D2I)d2i_ASN1_IA5STRING, \
 205                         i2d_ASN1_IA5STRING, \
 206                         (X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \
 207                         (X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \
 208                         NULL, NULL, NULL, NULL, \
 209                         NULL}
 210
 211 #define EXT_END { -1, 0, NULL, NULL, NULL, NULL, NULL, NULL, \
 212                          NULL, NULL, NULL, NULL, \
 213                          NULL}
 214
 215 #ifndef NOPROTO
 216 void ERR_load_X509V3_strings(void);
 217 int i2d_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS *a, unsigned char **pp);
 218 BASIC_CONSTRAINTS *d2i_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS **a, unsigned char **pp, long length);
 219 BASIC_CONSTRAINTS *BASIC_CONSTRAINTS_new(void);
 220 void BASIC_CONSTRAINTS_free(BASIC_CONSTRAINTS *a);
 221
 222 int i2d_GENERAL_NAME(GENERAL_NAME *a, unsigned char **pp);
 223 GENERAL_NAME *d2i_GENERAL_NAME(GENERAL_NAME **a, unsigned char **pp, long length);
 224 GENERAL_NAME *GENERAL_NAME_new(void);
 225 void GENERAL_NAME_free(GENERAL_NAME *a);
 226 STACK *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method, GENERAL_NAME *gen, STACK *ret);
 227
 228 int i2d_SXNET(SXNET *a, unsigned char **pp);
 229 SXNET *d2i_SXNET(SXNET **a, unsigned char **pp, long length);
 230 SXNET *SXNET_new(void);
 231 void SXNET_free(SXNET *a);
 232
 233 int i2d_SXNETID(SXNETID *a, unsigned char **pp);
 234 SXNETID *d2i_SXNETID(SXNETID **a, unsigned char **pp, long length);
 235 SXNETID *SXNETID_new(void);
 236 void SXNETID_free(SXNETID *a);
 237
 238 int i2d_AUTHORITY_KEYID(AUTHORITY_KEYID *a, unsigned char **pp);
 239 AUTHORITY_KEYID *d2i_AUTHORITY_KEYID(AUTHORITY_KEYID **a, unsigned char **pp, long length);
 240 AUTHORITY_KEYID *AUTHORITY_KEYID_new(void);
 241 void AUTHORITY_KEYID_free(AUTHORITY_KEYID *a);
 242
 243 int i2d_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD *a, unsigned char **pp);
 244 PKEY_USAGE_PERIOD *d2i_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD **a, unsigned char **pp, long length);
 245 PKEY_USAGE_PERIOD *PKEY_USAGE_PERIOD_new(void);
 246 void PKEY_USAGE_PERIOD_free(PKEY_USAGE_PERIOD *a);
 247
 248 STACK *GENERAL_NAMES_new(void);
 249 void GENERAL_NAMES_free(STACK *a);
 250 STACK *d2i_GENERAL_NAMES(STACK **a, unsigned char **pp, long length);
 251 int i2d_GENERAL_NAMES(STACK *a, unsigned char **pp);
 252 STACK *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method, STACK *gen, STACK *extlist);
 253 STACK *v2i_GENERAL_NAMES(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, STACK *nval);
 254
 255 char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, ASN1_OCTET_STRING *ia5);
 256 ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, char *str);
 257
 258 int i2d_ext_ku(STACK *a, unsigned char **pp);
 259 STACK *d2i_ext_ku(STACK **a, unsigned char **pp, long length);
 260 void ext_ku_free(STACK *a);
 261 STACK *ext_ku_new(void);
 262
 263 #ifdef HEADER_CONF_H
 264 GENERAL_NAME *v2i_GENERAL_NAME(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, CONF_VALUE *cnf);
 265 void X509V3_conf_free(CONF_VALUE *val);
 266 X509_EXTENSION *X509V3_EXT_conf_nid(LHASH *conf, X509V3_CTX *ctx, int ext_nid, char *value);
 267 X509_EXTENSION *X509V3_EXT_conf(LHASH *conf, X509V3_CTX *ctx, char *name, char *value);
 268 int X509V3_EXT_add_conf(LHASH *conf, X509V3_CTX *ctx, char *section, X509 *cert);
 269 int X509V3_EXT_CRL_add_conf(LHASH *conf, X509V3_CTX *ctx, char *section, X509_CRL *crl);
 270 int X509V3_EXT_check_conf(LHASH *conf, char *section);
 271 int X509V3_get_value_bool(CONF_VALUE *value, int *asn1_bool);
 272 int X509V3_get_value_int(CONF_VALUE *value, ASN1_INTEGER **aint);
 273 #endif
 274
 275 int X509V3_add_value(char *name, char *value, STACK **extlist);
 276 int X509V3_add_value_bool(char *name, int asn1_bool, STACK **extlist);
 277 int X509V3_add_value_int( char *name, ASN1_INTEGER *aint, STACK **extlist);
 278 char * i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, ASN1_INTEGER *aint);
 279 char * i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
 280 char * i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
 281 int X509V3_EXT_add(X509V3_EXT_METHOD *ext);
 282 int X509V3_EXT_add_alias(int nid_to, int nid_from);
 283 void X509V3_EXT_cleanup(void);
 284
 285 X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext);
 286 X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid);
 287 int X509V3_add_standard_extensions(void);
 288 STACK *X509V3_parse_list(char *line);
 289 char *X509V3_EXT_d2i(X509_EXTENSION *ext);
 290
 291 char *hex_to_string(unsigned char *buffer, long len);
 292 unsigned char *string_to_hex(char *str, long *len);
 293 int name_cmp(char *name, char *cmp);
 294
 295 int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, int flag, int indent);
 296 int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
 297
 298 #else
 299
 300 void ERR_load_X509V3_strings();
 301 int i2d_BASIC_CONSTRAINTS();
 302 BASIC_CONSTRAINTS *d2i_BASIC_CONSTRAINTS();
 303 BASIC_CONSTRAINTS *BASIC_CONSTRAINTS_new();
 304 void BASIC_CONSTRAINTS_free();
 305
 306 int i2d_GENERAL_NAME();
 307 GENERAL_NAME *d2i_GENERAL_NAME();
 308 GENERAL_NAME *GENERAL_NAME_new();
 309 void GENERAL_NAME_free();
 310 STACK *i2v_GENERAL_NAME();
 311 GENERAL_NAME *v2i_GENERAL_NAME();
 312
 313 int i2d_SXNET();
 314 SXNET *d2i_SXNET();
 315 SXNET *SXNET_new();
 316 void SXNET_free();
 317
 318 int i2d_SXNETID();
 319 SXNETID *d2i_SXNETID();
 320 SXNETID *SXNETID_new();
 321 void SXNETID_free();
 322
 323 int i2d_AUTHORITY_KEYID();
 324 AUTHORITY_KEYID *d2i_AUTHORITY_KEYID();
 325 AUTHORITY_KEYID *AUTHORITY_KEYID_new();
 326 void AUTHORITY_KEYID_free();
 327
 328 int i2d_PKEY_USAGE_PERIOD();
 329 PKEY_USAGE_PERIOD *d2i_PKEY_USAGE_PERIOD();
 330 PKEY_USAGE_PERIOD *PKEY_USAGE_PERIOD_new();
 331 void PKEY_USAGE_PERIOD_free();
 332
 333 STACK *GENERAL_NAMES_new():
 334 void GENERAL_NAMES_free():
 335 STACK *d2i_GENERAL_NAMES();
 336 int i2d_GENERAL_NAMES();
 337 STACK *i2v_GENERAL_NAMES();
 338 STACK *v2i_GENERAL_NAMES();
 339
 340 char *i2s_ASN1_OCTET_STRING();
 341 ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING();
 342
 343 int i2d_ext_ku();
 344 STACK *d2i_ext_ku();
 345 void ext_ku_free();
 346 STACK *ext_ku_new();
 347
 348 #ifdef HEADER_CONF_H
 349 void X509V3_conf_free();
 350 X509_EXTENSION *X509V3_EXT_conf_nid();
 351 X509_EXTENSION *X509V3_EXT_conf();
 352 int X509V3_EXT_add_conf();
 353 int X509V3_EXT_check_conf();
 354 int X509V3_get_value_bool();
 355 int X509V3_get_value_int();
 356 #endif
 357
 358 int X509V3_add_value();
 359 int X509V3_add_value_bool();
 360 int X509V3_add_value_int();
 361 char *i2s_ASN1_INTEGER();
 362 char * i2s_ASN1_ENUMERATED();
 363 char * i2s_ASN1_ENUMERATED_TABLE();
 364 int X509V3_EXT_add();
 365 int X509V3_EXT_CRL_add_conf();
 366 int X509V3_EXT_add_alias();
 367 void X509V3_EXT_cleanup();
 368
 369 X509V3_EXT_METHOD *X509V3_EXT_get();
 370 X509V3_EXT_METHOD *X509V3_EXT_get_nid();
 371 int X509V3_add_standard_extensions();
 372 STACK *X509V3_parse_list();
 373 char *X509V3_EXT_d2i();
 374
 375 char *hex_to_string();
 376 unsigned char *string_to_hex();
 377 int name_cmp();
 378
 379 int X509V3_EXT_print();
 380 int X509V3_EXT_print_fp();
 381 #endif
 382
 383 /* BEGIN ERROR CODES */
 384 /* Error codes for the X509V3 functions. */
 385
 386 /* Function codes. */
 387 #define X509V3_F_COPY_EMAIL                              122
 388 #define X509V3_F_COPY_ISSUER                             123
 389 #define X509V3_F_DO_EXT_CONF                             124
 390 #define X509V3_F_HEX_TO_STRING                           111
 391 #define X509V3_F_I2S_ASN1_ENUMERATED                     121
 392 #define X509V3_F_I2S_ASN1_INTEGER                        120
 393 #define X509V3_F_S2I_ASN1_IA5STRING                      100
 394 #define X509V3_F_S2I_ASN1_OCTET_STRING                   112
 395 #define X509V3_F_S2I_ASN1_SKEY_ID                        114
 396 #define X509V3_F_S2I_S2I_SKEY_ID                         115
 397 #define X509V3_F_STRING_TO_HEX                           113
 398 #define X509V3_F_V2I_ASN1_BIT_STRING                     101
 399 #define X509V3_F_V2I_AUTHORITY_KEYID                     119
 400 #define X509V3_F_V2I_BASIC_CONSTRAINTS                   102
 401 #define X509V3_F_V2I_EXT_KU                              103
 402 #define X509V3_F_V2I_GENERAL_NAME                        117
 403 #define X509V3_F_V2I_GENERAL_NAMES                       118
 404 #define X509V3_F_V3_GENERIC_EXTENSION                    116
 405 #define X509V3_F_X509V3_ADD_EXT                          104
 406 #define X509V3_F_X509V3_ADD_VALUE                        105
 407 #define X509V3_F_X509V3_EXT_ADD_ALIAS                    106
 408 #define X509V3_F_X509V3_EXT_CONF                         107
 409 #define X509V3_F_X509V3_GET_VALUE_INT                    108
 410 #define X509V3_F_X509V3_PARSE_LIST                       109
 411 #define X509V3_F_X509V3_VALUE_GET_BOOL                   110
 412
 413 /* Reason codes. */
 414 #define X509V3_R_BAD_IP_ADDRESS                          118
 415 #define X509V3_R_BAD_OBJECT                              119
 416 #define X509V3_R_BN_DEC2BN_ERROR                         100
 417 #define X509V3_R_BN_TO_ASN1_INTEGER_ERROR                101
 418 #define X509V3_R_ERROR_IN_EXTENSION                      128
 419 #define X509V3_R_EXTENSION_NAME_ERROR                    115
 420 #define X509V3_R_EXTENSION_NOT_FOUND                     102
 421 #define X509V3_R_EXTENSION_SETTING_NOT_SUPPORTED         103
 422 #define X509V3_R_EXTENSION_VALUE_ERROR                   116
 423 #define X509V3_R_ILLEGAL_HEX_DIGIT                       113
 424 #define X509V3_R_INVALID_BOOLEAN_STRING                  104
 425 #define X509V3_R_INVALID_EXTENSION_STRING                105
 426 #define X509V3_R_INVALID_NAME                            106
 427 #define X509V3_R_INVALID_NULL_ARGUMENT                   107
 428 #define X509V3_R_INVALID_NULL_NAME                       108
 429 #define X509V3_R_INVALID_NULL_VALUE                      109
 430 #define X509V3_R_INVALID_OBJECT_IDENTIFIER               110
 431 #define X509V3_R_ISSUER_DECODE_ERROR                     126
 432 #define X509V3_R_MISSING_VALUE                           124
 433 #define X509V3_R_NO_ISSUER_CERTIFICATE                   121
 434 #define X509V3_R_NO_ISSUER_DETAILS                       127
 435 #define X509V3_R_NO_PUBLIC_KEY                           114
 436 #define X509V3_R_NO_SUBJECT_DETAILS                      125
 437 #define X509V3_R_ODD_NUMBER_OF_DIGITS                    112
 438 #define X509V3_R_UNABLE_TO_GET_ISSUER_DETAILS            122
 439 #define X509V3_R_UNABLE_TO_GET_ISSUER_KEYID              123
 440 #define X509V3_R_UNKNOWN_BIT_STRING_ARGUMENT             111
 441 #define X509V3_R_UNKNOWN_EXTENSION                       129
 442 #define X509V3_R_UNKNOWN_EXTENSION_NAME                  130
 443 #define X509V3_R_UNKNOWN_OPTION                          120
 444 #define X509V3_R_UNSUPPORTED_OPTION                      117
 445
 446 #ifdef  __cplusplus
 447 }
 448 #endif
 449 #endif
 450