include/openssl/x509.h

   1 /*
   2  * Copyright 1995-2020 The OpenSSL Project Authors. All Rights Reserved.
   3  * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
   4  *
   5  * Licensed under the Apache License 2.0 (the "License").  You may not use
   6  * this file except in compliance with the License.  You can obtain a copy
   7  * in the file LICENSE in the source distribution or at
   8  * https://www.openssl.org/source/license.html
   9  */
  10
  11 #ifndef OPENSSL_X509_H
  12 # define OPENSSL_X509_H
  13 # pragma once
  14
  15 # include <openssl/macros.h>
  16 # ifndef OPENSSL_NO_DEPRECATED_3_0
  17 #  define HEADER_X509_H
  18 # endif
  19
  20 # include <openssl/e_os2.h>
  21 # include <openssl/types.h>
  22 # include <openssl/symhacks.h>
  23 # include <openssl/buffer.h>
  24 # include <openssl/evp.h>
  25 # include <openssl/bio.h>
  26 # include <openssl/asn1.h>
  27 # include <openssl/safestack.h>
  28 # include <openssl/ec.h>
  29
  30 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  31 #  include <openssl/rsa.h>
  32 #  include <openssl/dsa.h>
  33 #  include <openssl/dh.h>
  34 # endif
  35
  36 # include <openssl/sha.h>
  37 # include <openssl/x509err.h>
  38
  39 #ifdef  __cplusplus
  40 extern "C" {
  41 #endif
  42
  43 /* Needed stacks for types defined in other headers */
  44 DEFINE_OR_DECLARE_STACK_OF(X509_NAME)
  45 DEFINE_OR_DECLARE_STACK_OF(X509)
  46 DEFINE_OR_DECLARE_STACK_OF(X509_REVOKED)
  47 DEFINE_OR_DECLARE_STACK_OF(X509_CRL)
  48
  49 /* Flags for X509_get_signature_info() */
  50 /* Signature info is valid */
  51 # define X509_SIG_INFO_VALID     0x1
  52 /* Signature is suitable for TLS use */
  53 # define X509_SIG_INFO_TLS       0x2
  54
  55 # define X509_FILETYPE_PEM       1
  56 # define X509_FILETYPE_ASN1      2
  57 # define X509_FILETYPE_DEFAULT   3
  58
  59 # define X509v3_KU_DIGITAL_SIGNATURE     0x0080
  60 # define X509v3_KU_NON_REPUDIATION       0x0040
  61 # define X509v3_KU_KEY_ENCIPHERMENT      0x0020
  62 # define X509v3_KU_DATA_ENCIPHERMENT     0x0010
  63 # define X509v3_KU_KEY_AGREEMENT         0x0008
  64 # define X509v3_KU_KEY_CERT_SIGN         0x0004
  65 # define X509v3_KU_CRL_SIGN              0x0002
  66 # define X509v3_KU_ENCIPHER_ONLY         0x0001
  67 # define X509v3_KU_DECIPHER_ONLY         0x8000
  68 # define X509v3_KU_UNDEF                 0xffff
  69
  70 struct X509_algor_st {
  71     ASN1_OBJECT *algorithm;
  72     ASN1_TYPE *parameter;
  73 } /* X509_ALGOR */ ;
  74
  75 typedef STACK_OF(X509_ALGOR) X509_ALGORS;
  76
  77 typedef struct X509_val_st {
  78     ASN1_TIME *notBefore;
  79     ASN1_TIME *notAfter;
  80 } X509_VAL;
  81
  82 typedef struct X509_sig_st X509_SIG;
  83
  84 typedef struct X509_name_entry_st X509_NAME_ENTRY;
  85 DEFINE_OR_DECLARE_STACK_OF(X509_NAME_ENTRY)
  86
  87
  88 # define X509_EX_V_NETSCAPE_HACK         0x8000
  89 # define X509_EX_V_INIT                  0x0001
  90 typedef struct X509_extension_st X509_EXTENSION;
  91 DEFINE_OR_DECLARE_STACK_OF(X509_EXTENSION)
  92 typedef STACK_OF(X509_EXTENSION) X509_EXTENSIONS;
  93 typedef struct x509_attributes_st X509_ATTRIBUTE;
  94 DEFINE_OR_DECLARE_STACK_OF(X509_ATTRIBUTE)
  95 typedef struct X509_req_info_st X509_REQ_INFO;
  96 typedef struct X509_req_st X509_REQ;
  97 typedef struct x509_cert_aux_st X509_CERT_AUX;
  98 typedef struct x509_cinf_st X509_CINF;
  99
 100 /* This is used for a table of trust checking functions */
 101
 102 typedef struct x509_trust_st {
 103     int trust;
 104     int flags;
 105     int (*check_trust) (struct x509_trust_st *, X509 *, int);
 106     char *name;
 107     int arg1;
 108     void *arg2;
 109 } X509_TRUST;
 110 DEFINE_OR_DECLARE_STACK_OF(X509_TRUST)
 111
 112
 113 /* standard trust ids */
 114
 115 # define X509_TRUST_DEFAULT      0 /* Only valid in purpose settings */
 116
 117 # define X509_TRUST_COMPAT       1
 118 # define X509_TRUST_SSL_CLIENT   2
 119 # define X509_TRUST_SSL_SERVER   3
 120 # define X509_TRUST_EMAIL        4
 121 # define X509_TRUST_OBJECT_SIGN  5
 122 # define X509_TRUST_OCSP_SIGN    6
 123 # define X509_TRUST_OCSP_REQUEST 7
 124 # define X509_TRUST_TSA          8
 125
 126 /* Keep these up to date! */
 127 # define X509_TRUST_MIN          1
 128 # define X509_TRUST_MAX          8
 129
 130 /* trust_flags values */
 131 # define X509_TRUST_DYNAMIC      (1U << 0)
 132 # define X509_TRUST_DYNAMIC_NAME (1U << 1)
 133 /* No compat trust if self-signed, preempts "DO_SS" */
 134 # define X509_TRUST_NO_SS_COMPAT (1U << 2)
 135 /* Compat trust if no explicit accepted trust EKUs */
 136 # define X509_TRUST_DO_SS_COMPAT (1U << 3)
 137 /* Accept "anyEKU" as a wildcard trust OID */
 138 # define X509_TRUST_OK_ANY_EKU   (1U << 4)
 139
 140 /* check_trust return codes */
 141
 142 # define X509_TRUST_TRUSTED      1
 143 # define X509_TRUST_REJECTED     2
 144 # define X509_TRUST_UNTRUSTED    3
 145
 146 /* Flags for X509_print_ex() */
 147
 148 # define X509_FLAG_COMPAT                0
 149 # define X509_FLAG_NO_HEADER             1L
 150 # define X509_FLAG_NO_VERSION            (1L << 1)
 151 # define X509_FLAG_NO_SERIAL             (1L << 2)
 152 # define X509_FLAG_NO_SIGNAME            (1L << 3)
 153 # define X509_FLAG_NO_ISSUER             (1L << 4)
 154 # define X509_FLAG_NO_VALIDITY           (1L << 5)
 155 # define X509_FLAG_NO_SUBJECT            (1L << 6)
 156 # define X509_FLAG_NO_PUBKEY             (1L << 7)
 157 # define X509_FLAG_NO_EXTENSIONS         (1L << 8)
 158 # define X509_FLAG_NO_SIGDUMP            (1L << 9)
 159 # define X509_FLAG_NO_AUX                (1L << 10)
 160 # define X509_FLAG_NO_ATTRIBUTES         (1L << 11)
 161 # define X509_FLAG_NO_IDS                (1L << 12)
 162
 163 /* Flags specific to X509_NAME_print_ex() */
 164
 165 /* The field separator information */
 166
 167 # define XN_FLAG_SEP_MASK        (0xf << 16)
 168
 169 # define XN_FLAG_COMPAT          0/* Traditional; use old X509_NAME_print */
 170 # define XN_FLAG_SEP_COMMA_PLUS  (1 << 16)/* RFC2253 ,+ */
 171 # define XN_FLAG_SEP_CPLUS_SPC   (2 << 16)/* ,+ spaced: more readable */
 172 # define XN_FLAG_SEP_SPLUS_SPC   (3 << 16)/* ;+ spaced */
 173 # define XN_FLAG_SEP_MULTILINE   (4 << 16)/* One line per field */
 174
 175 # define XN_FLAG_DN_REV          (1 << 20)/* Reverse DN order */
 176
 177 /* How the field name is shown */
 178
 179 # define XN_FLAG_FN_MASK         (0x3 << 21)
 180
 181 # define XN_FLAG_FN_SN           0/* Object short name */
 182 # define XN_FLAG_FN_LN           (1 << 21)/* Object long name */
 183 # define XN_FLAG_FN_OID          (2 << 21)/* Always use OIDs */
 184 # define XN_FLAG_FN_NONE         (3 << 21)/* No field names */
 185
 186 # define XN_FLAG_SPC_EQ          (1 << 23)/* Put spaces round '=' */
 187
 188 /*
 189  * This determines if we dump fields we don't recognise: RFC2253 requires
 190  * this.
 191  */
 192
 193 # define XN_FLAG_DUMP_UNKNOWN_FIELDS (1 << 24)
 194
 195 # define XN_FLAG_FN_ALIGN        (1 << 25)/* Align field names to 20
 196                                            * characters */
 197
 198 /* Complete set of RFC2253 flags */
 199
 200 # define XN_FLAG_RFC2253 (ASN1_STRFLGS_RFC2253 | \
 201                         XN_FLAG_SEP_COMMA_PLUS | \
 202                         XN_FLAG_DN_REV | \
 203                         XN_FLAG_FN_SN | \
 204                         XN_FLAG_DUMP_UNKNOWN_FIELDS)
 205
 206 /* readable oneline form */
 207
 208 # define XN_FLAG_ONELINE (ASN1_STRFLGS_RFC2253 | \
 209                         ASN1_STRFLGS_ESC_QUOTE | \
 210                         XN_FLAG_SEP_CPLUS_SPC | \
 211                         XN_FLAG_SPC_EQ | \
 212                         XN_FLAG_FN_SN)
 213
 214 /* readable multiline form */
 215
 216 # define XN_FLAG_MULTILINE (ASN1_STRFLGS_ESC_CTRL | \
 217                         ASN1_STRFLGS_ESC_MSB | \
 218                         XN_FLAG_SEP_MULTILINE | \
 219                         XN_FLAG_SPC_EQ | \
 220                         XN_FLAG_FN_LN | \
 221                         XN_FLAG_FN_ALIGN)
 222
 223 typedef struct X509_crl_info_st X509_CRL_INFO;
 224
 225 typedef struct private_key_st {
 226     int version;
 227     /* The PKCS#8 data types */
 228     X509_ALGOR *enc_algor;
 229     ASN1_OCTET_STRING *enc_pkey; /* encrypted pub key */
 230     /* When decrypted, the following will not be NULL */
 231     EVP_PKEY *dec_pkey;
 232     /* used to encrypt and decrypt */
 233     int key_length;
 234     char *key_data;
 235     int key_free;               /* true if we should auto free key_data */
 236     /* expanded version of 'enc_algor' */
 237     EVP_CIPHER_INFO cipher;
 238 } X509_PKEY;
 239
 240 typedef struct X509_info_st {
 241     X509 *x509;
 242     X509_CRL *crl;
 243     X509_PKEY *x_pkey;
 244     EVP_CIPHER_INFO enc_cipher;
 245     int enc_len;
 246     char *enc_data;
 247 } X509_INFO;
 248 DEFINE_OR_DECLARE_STACK_OF(X509_INFO)
 249
 250 /*
 251  * The next 2 structures and their 8 routines are used to manipulate Netscape's
 252  * spki structures - useful if you are writing a CA web page
 253  */
 254 typedef struct Netscape_spkac_st {
 255     X509_PUBKEY *pubkey;
 256     ASN1_IA5STRING *challenge;  /* challenge sent in atlas >= PR2 */
 257 } NETSCAPE_SPKAC;
 258
 259 typedef struct Netscape_spki_st {
 260     NETSCAPE_SPKAC *spkac;      /* signed public key and challenge */
 261     X509_ALGOR sig_algor;
 262     ASN1_BIT_STRING *signature;
 263 } NETSCAPE_SPKI;
 264
 265 /* Netscape certificate sequence structure */
 266 typedef struct Netscape_certificate_sequence {
 267     ASN1_OBJECT *type;
 268     STACK_OF(X509) *certs;
 269 } NETSCAPE_CERT_SEQUENCE;
 270
 271 /*- Unused (and iv length is wrong)
 272 typedef struct CBCParameter_st
 273         {
 274         unsigned char iv[8];
 275         } CBC_PARAM;
 276 */
 277
 278 /* Password based encryption structure */
 279
 280 typedef struct PBEPARAM_st {
 281     ASN1_OCTET_STRING *salt;
 282     ASN1_INTEGER *iter;
 283 } PBEPARAM;
 284
 285 /* Password based encryption V2 structures */
 286
 287 typedef struct PBE2PARAM_st {
 288     X509_ALGOR *keyfunc;
 289     X509_ALGOR *encryption;
 290 } PBE2PARAM;
 291
 292 typedef struct PBKDF2PARAM_st {
 293 /* Usually OCTET STRING but could be anything */
 294     ASN1_TYPE *salt;
 295     ASN1_INTEGER *iter;
 296     ASN1_INTEGER *keylength;
 297     X509_ALGOR *prf;
 298 } PBKDF2PARAM;
 299
 300 #ifndef OPENSSL_NO_SCRYPT
 301 typedef struct SCRYPT_PARAMS_st {
 302     ASN1_OCTET_STRING *salt;
 303     ASN1_INTEGER *costParameter;
 304     ASN1_INTEGER *blockSize;
 305     ASN1_INTEGER *parallelizationParameter;
 306     ASN1_INTEGER *keyLength;
 307 } SCRYPT_PARAMS;
 308 #endif
 309
 310 #ifdef  __cplusplus
 311 }
 312 #endif
 313
 314 # include <openssl/x509_vfy.h>
 315 # include <openssl/pkcs7.h>
 316
 317 #ifdef  __cplusplus
 318 extern "C" {
 319 #endif
 320
 321 # define X509_EXT_PACK_UNKNOWN   1
 322 # define X509_EXT_PACK_STRING    2
 323
 324 # define         X509_extract_key(x)     X509_get_pubkey(x)/*****/
 325 # define         X509_REQ_extract_key(a) X509_REQ_get_pubkey(a)
 326 # define         X509_name_cmp(a,b)      X509_NAME_cmp((a),(b))
 327
 328 void X509_CRL_set_default_method(const X509_CRL_METHOD *meth);
 329 X509_CRL_METHOD *X509_CRL_METHOD_new(int (*crl_init) (X509_CRL *crl),
 330                                      int (*crl_free) (X509_CRL *crl),
 331                                      int (*crl_lookup) (X509_CRL *crl,
 332                                                         X509_REVOKED **ret,
 333                                                         const
 334                                                         ASN1_INTEGER *serial,
 335                                                         const
 336                                                         X509_NAME *issuer),
 337                                      int (*crl_verify) (X509_CRL *crl,
 338                                                         EVP_PKEY *pk));
 339 void X509_CRL_METHOD_free(X509_CRL_METHOD *m);
 340
 341 void X509_CRL_set_meth_data(X509_CRL *crl, void *dat);
 342 void *X509_CRL_get_meth_data(X509_CRL *crl);
 343
 344 const char *X509_verify_cert_error_string(long n);
 345
 346 int X509_verify_ex(X509 *a, EVP_PKEY *r, OPENSSL_CTX *libctx, const char *propq);
 347 int X509_verify(X509 *a, EVP_PKEY *r);
 348 int X509_self_signed(X509 *cert, int verify_signature);
 349
 350 int X509_REQ_verify_ex(X509_REQ *a, EVP_PKEY *r, OPENSSL_CTX *libctx,
 351                        const char *propq);
 352 int X509_REQ_verify(X509_REQ *a, EVP_PKEY *r);
 353 int X509_CRL_verify(X509_CRL *a, EVP_PKEY *r);
 354 int NETSCAPE_SPKI_verify(NETSCAPE_SPKI *a, EVP_PKEY *r);
 355
 356 NETSCAPE_SPKI *NETSCAPE_SPKI_b64_decode(const char *str, int len);
 357 char *NETSCAPE_SPKI_b64_encode(NETSCAPE_SPKI *x);
 358 EVP_PKEY *NETSCAPE_SPKI_get_pubkey(NETSCAPE_SPKI *x);
 359 int NETSCAPE_SPKI_set_pubkey(NETSCAPE_SPKI *x, EVP_PKEY *pkey);
 360
 361 int NETSCAPE_SPKI_print(BIO *out, NETSCAPE_SPKI *spki);
 362
 363 int X509_signature_dump(BIO *bp, const ASN1_STRING *sig, int indent);
 364 int X509_signature_print(BIO *bp, const X509_ALGOR *alg,
 365                          const ASN1_STRING *sig);
 366
 367 int X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md);
 368 int X509_sign_ctx(X509 *x, EVP_MD_CTX *ctx);
 369 int X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md);
 370 int X509_REQ_sign_ctx(X509_REQ *x, EVP_MD_CTX *ctx);
 371 int X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md);
 372 int X509_CRL_sign_ctx(X509_CRL *x, EVP_MD_CTX *ctx);
 373 int NETSCAPE_SPKI_sign(NETSCAPE_SPKI *x, EVP_PKEY *pkey, const EVP_MD *md);
 374
 375 int X509_pubkey_digest(const X509 *data, const EVP_MD *type,
 376                        unsigned char *md, unsigned int *len);
 377 int X509_digest(const X509 *data, const EVP_MD *type,
 378                 unsigned char *md, unsigned int *len);
 379 ASN1_OCTET_STRING *X509_digest_sig(const X509 *cert);
 380 int X509_CRL_digest(const X509_CRL *data, const EVP_MD *type,
 381                     unsigned char *md, unsigned int *len);
 382 int X509_REQ_digest(const X509_REQ *data, const EVP_MD *type,
 383                     unsigned char *md, unsigned int *len);
 384 int X509_NAME_digest(const X509_NAME *data, const EVP_MD *type,
 385                      unsigned char *md, unsigned int *len);
 386
 387 # if !defined(OPENSSL_NO_SOCK)
 388 X509 *X509_load_http(const char *url, BIO *bio, BIO *rbio, int timeout);
 389 #  define X509_http_nbio(url) X509_load_http(url, NULL, NULL, 0)
 390 X509_CRL *X509_CRL_load_http(const char *url, BIO *bio, BIO *rbio, int timeout);
 391 #  define X509_CRL_http_nbio(url) X509_CRL_load_http(url, NULL,  NULL, 0)
 392 # endif
 393
 394 # ifndef OPENSSL_NO_STDIO
 395 X509 *d2i_X509_fp(FILE *fp, X509 **x509);
 396 int i2d_X509_fp(FILE *fp, const X509 *x509);
 397 X509_CRL *d2i_X509_CRL_fp(FILE *fp, X509_CRL **crl);
 398 int i2d_X509_CRL_fp(FILE *fp, const X509_CRL *crl);
 399 X509_REQ *d2i_X509_REQ_fp(FILE *fp, X509_REQ **req);
 400 int i2d_X509_REQ_fp(FILE *fp, const X509_REQ *req);
 401 #  ifndef OPENSSL_NO_RSA
 402 RSA *d2i_RSAPrivateKey_fp(FILE *fp, RSA **rsa);
 403 int i2d_RSAPrivateKey_fp(FILE *fp, const RSA *rsa);
 404 RSA *d2i_RSAPublicKey_fp(FILE *fp, RSA **rsa);
 405 int i2d_RSAPublicKey_fp(FILE *fp, const RSA *rsa);
 406 RSA *d2i_RSA_PUBKEY_fp(FILE *fp, RSA **rsa);
 407 int i2d_RSA_PUBKEY_fp(FILE *fp, const RSA *rsa);
 408 #  endif
 409 #  ifndef OPENSSL_NO_DSA
 410 DSA *d2i_DSA_PUBKEY_fp(FILE *fp, DSA **dsa);
 411 int i2d_DSA_PUBKEY_fp(FILE *fp, const DSA *dsa);
 412 DSA *d2i_DSAPrivateKey_fp(FILE *fp, DSA **dsa);
 413 int i2d_DSAPrivateKey_fp(FILE *fp, const DSA *dsa);
 414 #  endif
 415 #  ifndef OPENSSL_NO_EC
 416 EC_KEY *d2i_EC_PUBKEY_fp(FILE *fp, EC_KEY **eckey);
 417 int i2d_EC_PUBKEY_fp(FILE *fp, const EC_KEY *eckey);
 418 EC_KEY *d2i_ECPrivateKey_fp(FILE *fp, EC_KEY **eckey);
 419 int i2d_ECPrivateKey_fp(FILE *fp, const EC_KEY *eckey);
 420 #  endif
 421 X509_SIG *d2i_PKCS8_fp(FILE *fp, X509_SIG **p8);
 422 int i2d_PKCS8_fp(FILE *fp, const X509_SIG *p8);
 423 X509_PUBKEY *d2i_X509_PUBKEY_fp(FILE *fp, X509_PUBKEY **xpk);
 424 int i2d_X509_PUBKEY_fp(FILE *fp, const X509_PUBKEY *xpk);
 425 PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_fp(FILE *fp,
 426                                                 PKCS8_PRIV_KEY_INFO **p8inf);
 427 int i2d_PKCS8_PRIV_KEY_INFO_fp(FILE *fp, const PKCS8_PRIV_KEY_INFO *p8inf);
 428 int i2d_PKCS8PrivateKeyInfo_fp(FILE *fp, const EVP_PKEY *key);
 429 int i2d_PrivateKey_fp(FILE *fp, const EVP_PKEY *pkey);
 430 EVP_PKEY *d2i_PrivateKey_ex_fp(FILE *fp, EVP_PKEY **a, OPENSSL_CTX *libctx,
 431                                const char *propq);
 432 EVP_PKEY *d2i_PrivateKey_fp(FILE *fp, EVP_PKEY **a);
 433 int i2d_PUBKEY_fp(FILE *fp, const EVP_PKEY *pkey);
 434 EVP_PKEY *d2i_PUBKEY_fp(FILE *fp, EVP_PKEY **a);
 435 # endif
 436
 437 X509 *d2i_X509_bio(BIO *bp, X509 **x509);
 438 int i2d_X509_bio(BIO *bp, const X509 *x509);
 439 X509_CRL *d2i_X509_CRL_bio(BIO *bp, X509_CRL **crl);
 440 int i2d_X509_CRL_bio(BIO *bp, const X509_CRL *crl);
 441 X509_REQ *d2i_X509_REQ_bio(BIO *bp, X509_REQ **req);
 442 int i2d_X509_REQ_bio(BIO *bp, const X509_REQ *req);
 443 #  ifndef OPENSSL_NO_RSA
 444 RSA *d2i_RSAPrivateKey_bio(BIO *bp, RSA **rsa);
 445 int i2d_RSAPrivateKey_bio(BIO *bp, const RSA *rsa);
 446 RSA *d2i_RSAPublicKey_bio(BIO *bp, RSA **rsa);
 447 int i2d_RSAPublicKey_bio(BIO *bp, const RSA *rsa);
 448 RSA *d2i_RSA_PUBKEY_bio(BIO *bp, RSA **rsa);
 449 int i2d_RSA_PUBKEY_bio(BIO *bp, const RSA *rsa);
 450 #  endif
 451 #  ifndef OPENSSL_NO_DSA
 452 DSA *d2i_DSA_PUBKEY_bio(BIO *bp, DSA **dsa);
 453 int i2d_DSA_PUBKEY_bio(BIO *bp, const DSA *dsa);
 454 DSA *d2i_DSAPrivateKey_bio(BIO *bp, DSA **dsa);
 455 int i2d_DSAPrivateKey_bio(BIO *bp, const DSA *dsa);
 456 #  endif
 457 #  ifndef OPENSSL_NO_EC
 458 EC_KEY *d2i_EC_PUBKEY_bio(BIO *bp, EC_KEY **eckey);
 459 int i2d_EC_PUBKEY_bio(BIO *bp, const EC_KEY *eckey);
 460 EC_KEY *d2i_ECPrivateKey_bio(BIO *bp, EC_KEY **eckey);
 461 int i2d_ECPrivateKey_bio(BIO *bp, const EC_KEY *eckey);
 462 #  endif
 463 X509_SIG *d2i_PKCS8_bio(BIO *bp, X509_SIG **p8);
 464 int i2d_PKCS8_bio(BIO *bp, const X509_SIG *p8);
 465 X509_PUBKEY *d2i_X509_PUBKEY_bio(BIO *bp, X509_PUBKEY **xpk);
 466 int i2d_X509_PUBKEY_bio(BIO *bp, const X509_PUBKEY *xpk);
 467 PKCS8_PRIV_KEY_INFO *d2i_PKCS8_PRIV_KEY_INFO_bio(BIO *bp,
 468                                                  PKCS8_PRIV_KEY_INFO **p8inf);
 469 int i2d_PKCS8_PRIV_KEY_INFO_bio(BIO *bp, const PKCS8_PRIV_KEY_INFO *p8inf);
 470 int i2d_PKCS8PrivateKeyInfo_bio(BIO *bp, const EVP_PKEY *key);
 471 int i2d_PrivateKey_bio(BIO *bp, const EVP_PKEY *pkey);
 472 EVP_PKEY *d2i_PrivateKey_ex_bio(BIO *bp, EVP_PKEY **a, OPENSSL_CTX *libctx,
 473                                 const char *propq);
 474 EVP_PKEY *d2i_PrivateKey_bio(BIO *bp, EVP_PKEY **a);
 475 int i2d_PUBKEY_bio(BIO *bp, const EVP_PKEY *pkey);
 476 EVP_PKEY *d2i_PUBKEY_bio(BIO *bp, EVP_PKEY **a);
 477
 478 DECLARE_ASN1_DUP_FUNCTION(X509)
 479 DECLARE_ASN1_DUP_FUNCTION(X509_ALGOR)
 480 DECLARE_ASN1_DUP_FUNCTION(X509_ATTRIBUTE)
 481 DECLARE_ASN1_DUP_FUNCTION(X509_CRL)
 482 DECLARE_ASN1_DUP_FUNCTION(X509_EXTENSION)
 483 DECLARE_ASN1_DUP_FUNCTION(X509_PUBKEY)
 484 DECLARE_ASN1_DUP_FUNCTION(X509_REQ)
 485 DECLARE_ASN1_DUP_FUNCTION(X509_REVOKED)
 486 int X509_ALGOR_set0(X509_ALGOR *alg, ASN1_OBJECT *aobj, int ptype,
 487                     void *pval);
 488 void X509_ALGOR_get0(const ASN1_OBJECT **paobj, int *pptype,
 489                      const void **ppval, const X509_ALGOR *algor);
 490 void X509_ALGOR_set_md(X509_ALGOR *alg, const EVP_MD *md);
 491 int X509_ALGOR_cmp(const X509_ALGOR *a, const X509_ALGOR *b);
 492 int X509_ALGOR_copy(X509_ALGOR *dest, const X509_ALGOR *src);
 493
 494 DECLARE_ASN1_DUP_FUNCTION(X509_NAME)
 495 DECLARE_ASN1_DUP_FUNCTION(X509_NAME_ENTRY)
 496
 497 int X509_cmp_time(const ASN1_TIME *s, time_t *t);
 498 int X509_cmp_current_time(const ASN1_TIME *s);
 499 int X509_cmp_timeframe(const X509_VERIFY_PARAM *vpm,
 500                        const ASN1_TIME *start, const ASN1_TIME *end);
 501 ASN1_TIME *X509_time_adj(ASN1_TIME *s, long adj, time_t *t);
 502 ASN1_TIME *X509_time_adj_ex(ASN1_TIME *s,
 503                             int offset_day, long offset_sec, time_t *t);
 504 ASN1_TIME *X509_gmtime_adj(ASN1_TIME *s, long adj);
 505
 506 const char *X509_get_default_cert_area(void);
 507 const char *X509_get_default_cert_dir(void);
 508 const char *X509_get_default_cert_file(void);
 509 const char *X509_get_default_cert_dir_env(void);
 510 const char *X509_get_default_cert_file_env(void);
 511 const char *X509_get_default_private_dir(void);
 512
 513 X509_REQ *X509_to_X509_REQ(X509 *x, EVP_PKEY *pkey, const EVP_MD *md);
 514 X509 *X509_REQ_to_X509(X509_REQ *r, int days, EVP_PKEY *pkey);
 515
 516 DECLARE_ASN1_FUNCTIONS(X509_ALGOR)
 517 DECLARE_ASN1_ENCODE_FUNCTIONS(X509_ALGORS, X509_ALGORS, X509_ALGORS)
 518 DECLARE_ASN1_FUNCTIONS(X509_VAL)
 519
 520 DECLARE_ASN1_FUNCTIONS(X509_PUBKEY)
 521
 522 int X509_PUBKEY_set(X509_PUBKEY **x, EVP_PKEY *pkey);
 523 EVP_PKEY *X509_PUBKEY_get0(const X509_PUBKEY *key);
 524 EVP_PKEY *X509_PUBKEY_get(const X509_PUBKEY *key);
 525 int X509_get_pubkey_parameters(EVP_PKEY *pkey, STACK_OF(X509) *chain);
 526 long X509_get_pathlen(X509 *x);
 527 DECLARE_ASN1_ENCODE_FUNCTIONS_only(EVP_PKEY, PUBKEY)
 528 # ifndef OPENSSL_NO_RSA
 529 DECLARE_ASN1_ENCODE_FUNCTIONS_only(RSA, RSA_PUBKEY)
 530 # endif
 531 # ifndef OPENSSL_NO_DSA
 532 DECLARE_ASN1_ENCODE_FUNCTIONS_only(DSA, DSA_PUBKEY)
 533 # endif
 534 # ifndef OPENSSL_NO_EC
 535 DECLARE_ASN1_ENCODE_FUNCTIONS_only(EC_KEY, EC_PUBKEY)
 536 # endif
 537
 538 DECLARE_ASN1_FUNCTIONS(X509_SIG)
 539 void X509_SIG_get0(const X509_SIG *sig, const X509_ALGOR **palg,
 540                    const ASN1_OCTET_STRING **pdigest);
 541 void X509_SIG_getm(X509_SIG *sig, X509_ALGOR **palg,
 542                    ASN1_OCTET_STRING **pdigest);
 543
 544 DECLARE_ASN1_FUNCTIONS(X509_REQ_INFO)
 545 DECLARE_ASN1_FUNCTIONS(X509_REQ)
 546
 547 DECLARE_ASN1_FUNCTIONS(X509_ATTRIBUTE)
 548 X509_ATTRIBUTE *X509_ATTRIBUTE_create(int nid, int atrtype, void *value);
 549
 550 DECLARE_ASN1_FUNCTIONS(X509_EXTENSION)
 551 DECLARE_ASN1_ENCODE_FUNCTIONS(X509_EXTENSIONS, X509_EXTENSIONS, X509_EXTENSIONS)
 552
 553 DECLARE_ASN1_FUNCTIONS(X509_NAME_ENTRY)
 554
 555 DECLARE_ASN1_FUNCTIONS(X509_NAME)
 556
 557 int X509_NAME_set(X509_NAME **xn, const X509_NAME *name);
 558
 559 DECLARE_ASN1_FUNCTIONS(X509_CINF)
 560 DECLARE_ASN1_FUNCTIONS(X509)
 561 DECLARE_ASN1_FUNCTIONS(X509_CERT_AUX)
 562
 563 #define X509_get_ex_new_index(l, p, newf, dupf, freef) \
 564     CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509, l, p, newf, dupf, freef)
 565 int X509_set_ex_data(X509 *r, int idx, void *arg);
 566 void *X509_get_ex_data(const X509 *r, int idx);
 567 DECLARE_ASN1_ENCODE_FUNCTIONS_only(X509,X509_AUX)
 568
 569 int i2d_re_X509_tbs(X509 *x, unsigned char **pp);
 570
 571 int X509_SIG_INFO_get(const X509_SIG_INFO *siginf, int *mdnid, int *pknid,
 572                       int *secbits, uint32_t *flags);
 573 void X509_SIG_INFO_set(X509_SIG_INFO *siginf, int mdnid, int pknid,
 574                        int secbits, uint32_t flags);
 575
 576 int X509_get_signature_info(X509 *x, int *mdnid, int *pknid, int *secbits,
 577                             uint32_t *flags);
 578
 579 void X509_get0_signature(const ASN1_BIT_STRING **psig,
 580                          const X509_ALGOR **palg, const X509 *x);
 581 int X509_get_signature_nid(const X509 *x);
 582
 583 void X509_set0_distinguishing_id(X509 *x, ASN1_OCTET_STRING *d_id);
 584 ASN1_OCTET_STRING *X509_get0_distinguishing_id(X509 *x);
 585 void X509_REQ_set0_distinguishing_id(X509_REQ *x, ASN1_OCTET_STRING *d_id);
 586 ASN1_OCTET_STRING *X509_REQ_get0_distinguishing_id(X509_REQ *x);
 587
 588 int X509_trusted(const X509 *x);
 589 int X509_alias_set1(X509 *x, const unsigned char *name, int len);
 590 int X509_keyid_set1(X509 *x, const unsigned char *id, int len);
 591 unsigned char *X509_alias_get0(X509 *x, int *len);
 592 unsigned char *X509_keyid_get0(X509 *x, int *len);
 593 int (*X509_TRUST_set_default(int (*trust) (int, X509 *, int))) (int, X509 *,
 594                                                                 int);
 595 int X509_TRUST_set(int *t, int trust);
 596 int X509_add1_trust_object(X509 *x, const ASN1_OBJECT *obj);
 597 int X509_add1_reject_object(X509 *x, const ASN1_OBJECT *obj);
 598 void X509_trust_clear(X509 *x);
 599 void X509_reject_clear(X509 *x);
 600
 601 STACK_OF(ASN1_OBJECT) *X509_get0_trust_objects(X509 *x);
 602 STACK_OF(ASN1_OBJECT) *X509_get0_reject_objects(X509 *x);
 603
 604 DECLARE_ASN1_FUNCTIONS(X509_REVOKED)
 605 DECLARE_ASN1_FUNCTIONS(X509_CRL_INFO)
 606 DECLARE_ASN1_FUNCTIONS(X509_CRL)
 607
 608 int X509_CRL_add0_revoked(X509_CRL *crl, X509_REVOKED *rev);
 609 int X509_CRL_get0_by_serial(X509_CRL *crl,
 610                             X509_REVOKED **ret, const ASN1_INTEGER *serial);
 611 int X509_CRL_get0_by_cert(X509_CRL *crl, X509_REVOKED **ret, X509 *x);
 612
 613 X509_PKEY *X509_PKEY_new(void);
 614 void X509_PKEY_free(X509_PKEY *a);
 615
 616 DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKI)
 617 DECLARE_ASN1_FUNCTIONS(NETSCAPE_SPKAC)
 618 DECLARE_ASN1_FUNCTIONS(NETSCAPE_CERT_SEQUENCE)
 619
 620 X509_INFO *X509_INFO_new(void);
 621 void X509_INFO_free(X509_INFO *a);
 622 char *X509_NAME_oneline(const X509_NAME *a, char *buf, int size);
 623
 624 DEPRECATEDIN_3_0(int ASN1_verify(i2d_of_void *i2d, X509_ALGOR *algor1,
 625                                  ASN1_BIT_STRING *signature, char *data,
 626                                  EVP_PKEY *pkey))
 627
 628 DEPRECATEDIN_3_0(int ASN1_digest(i2d_of_void *i2d, const EVP_MD *type,
 629                                  char *data,
 630                                  unsigned char *md, unsigned int *len))
 631
 632 DEPRECATEDIN_3_0(int ASN1_sign(i2d_of_void *i2d, X509_ALGOR *algor1,
 633                                X509_ALGOR *algor2, ASN1_BIT_STRING *signature,
 634                                char *data, EVP_PKEY *pkey, const EVP_MD *type))
 635
 636 int ASN1_item_digest(const ASN1_ITEM *it, const EVP_MD *type, void *data,
 637                      unsigned char *md, unsigned int *len);
 638
 639 int ASN1_item_verify(const ASN1_ITEM *it, X509_ALGOR *algor1,
 640                      ASN1_BIT_STRING *signature, void *data, EVP_PKEY *pkey);
 641 int ASN1_item_verify_ctx(const ASN1_ITEM *it, X509_ALGOR *algor1,
 642                          ASN1_BIT_STRING *signature, void *data,
 643                          EVP_MD_CTX *ctx);
 644
 645 int ASN1_item_sign(const ASN1_ITEM *it, X509_ALGOR *algor1,
 646                    X509_ALGOR *algor2, ASN1_BIT_STRING *signature, void *data,
 647                    EVP_PKEY *pkey, const EVP_MD *type);
 648 int ASN1_item_sign_ctx(const ASN1_ITEM *it, X509_ALGOR *algor1,
 649                        X509_ALGOR *algor2, ASN1_BIT_STRING *signature,
 650                        void *asn, EVP_MD_CTX *ctx);
 651
 652 long X509_get_version(const X509 *x);
 653 int X509_set_version(X509 *x, long version);
 654 int X509_set_serialNumber(X509 *x, ASN1_INTEGER *serial);
 655 ASN1_INTEGER *X509_get_serialNumber(X509 *x);
 656 const ASN1_INTEGER *X509_get0_serialNumber(const X509 *x);
 657 int X509_set_issuer_name(X509 *x, const X509_NAME *name);
 658 X509_NAME *X509_get_issuer_name(const X509 *a); /* TODO change to get0_ */
 659 int X509_set_subject_name(X509 *x, const X509_NAME *name);
 660 X509_NAME *X509_get_subject_name(const X509 *a); /* TODO change to get0_ */
 661 const ASN1_TIME * X509_get0_notBefore(const X509 *x);
 662 ASN1_TIME *X509_getm_notBefore(const X509 *x);
 663 int X509_set1_notBefore(X509 *x, const ASN1_TIME *tm);
 664 const ASN1_TIME *X509_get0_notAfter(const X509 *x);
 665 ASN1_TIME *X509_getm_notAfter(const X509 *x);
 666 int X509_set1_notAfter(X509 *x, const ASN1_TIME *tm);
 667 int X509_set_pubkey(X509 *x, EVP_PKEY *pkey);
 668 int X509_up_ref(X509 *x);
 669 int X509_get_signature_type(const X509 *x);
 670
 671 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
 672 #  define X509_get_notBefore X509_getm_notBefore
 673 #  define X509_get_notAfter X509_getm_notAfter
 674 #  define X509_set_notBefore X509_set1_notBefore
 675 #  define X509_set_notAfter X509_set1_notAfter
 676 #endif
 677
 678
 679 /*
 680  * This one is only used so that a binary form can output, as in
 681  * i2d_X509_PUBKEY(X509_get_X509_PUBKEY(x), &buf)
 682  */
 683 X509_PUBKEY *X509_get_X509_PUBKEY(const X509 *x);
 684 const STACK_OF(X509_EXTENSION) *X509_get0_extensions(const X509 *x);
 685 void X509_get0_uids(const X509 *x, const ASN1_BIT_STRING **piuid,
 686                     const ASN1_BIT_STRING **psuid);
 687 const X509_ALGOR *X509_get0_tbs_sigalg(const X509 *x);
 688
 689 EVP_PKEY *X509_get0_pubkey(const X509 *x);
 690 EVP_PKEY *X509_get_pubkey(X509 *x);
 691 ASN1_BIT_STRING *X509_get0_pubkey_bitstr(const X509 *x);
 692 int X509_certificate_type(const X509 *x, const EVP_PKEY *pubkey);
 693
 694 long X509_REQ_get_version(const X509_REQ *req);
 695 int X509_REQ_set_version(X509_REQ *x, long version);
 696 X509_NAME *X509_REQ_get_subject_name(const X509_REQ *req); /* TODO change to get0_ */
 697 int X509_REQ_set_subject_name(X509_REQ *req, const X509_NAME *name);
 698 void X509_REQ_get0_signature(const X509_REQ *req, const ASN1_BIT_STRING **psig,
 699                              const X509_ALGOR **palg);
 700 void X509_REQ_set0_signature(X509_REQ *req, ASN1_BIT_STRING *psig);
 701 int X509_REQ_set1_signature_algo(X509_REQ *req, X509_ALGOR *palg);
 702 int X509_REQ_get_signature_nid(const X509_REQ *req);
 703 int i2d_re_X509_REQ_tbs(X509_REQ *req, unsigned char **pp);
 704 int X509_REQ_set_pubkey(X509_REQ *x, EVP_PKEY *pkey);
 705 EVP_PKEY *X509_REQ_get_pubkey(X509_REQ *req);
 706 EVP_PKEY *X509_REQ_get0_pubkey(X509_REQ *req);
 707 X509_PUBKEY *X509_REQ_get_X509_PUBKEY(X509_REQ *req);
 708 int X509_REQ_extension_nid(int nid);
 709 int *X509_REQ_get_extension_nids(void);
 710 void X509_REQ_set_extension_nids(int *nids);
 711 STACK_OF(X509_EXTENSION) *X509_REQ_get_extensions(X509_REQ *req);
 712 int X509_REQ_add_extensions_nid(X509_REQ *req, STACK_OF(X509_EXTENSION) *exts,
 713                                 int nid);
 714 int X509_REQ_add_extensions(X509_REQ *req, STACK_OF(X509_EXTENSION) *exts);
 715 int X509_REQ_get_attr_count(const X509_REQ *req);
 716 int X509_REQ_get_attr_by_NID(const X509_REQ *req, int nid, int lastpos);
 717 int X509_REQ_get_attr_by_OBJ(const X509_REQ *req, const ASN1_OBJECT *obj,
 718                              int lastpos);
 719 X509_ATTRIBUTE *X509_REQ_get_attr(const X509_REQ *req, int loc);
 720 X509_ATTRIBUTE *X509_REQ_delete_attr(X509_REQ *req, int loc);
 721 int X509_REQ_add1_attr(X509_REQ *req, X509_ATTRIBUTE *attr);
 722 int X509_REQ_add1_attr_by_OBJ(X509_REQ *req,
 723                               const ASN1_OBJECT *obj, int type,
 724                               const unsigned char *bytes, int len);
 725 int X509_REQ_add1_attr_by_NID(X509_REQ *req,
 726                               int nid, int type,
 727                               const unsigned char *bytes, int len);
 728 int X509_REQ_add1_attr_by_txt(X509_REQ *req,
 729                               const char *attrname, int type,
 730                               const unsigned char *bytes, int len);
 731
 732 int X509_CRL_set_version(X509_CRL *x, long version);
 733 int X509_CRL_set_issuer_name(X509_CRL *x, const X509_NAME *name);
 734 int X509_CRL_set1_lastUpdate(X509_CRL *x, const ASN1_TIME *tm);
 735 int X509_CRL_set1_nextUpdate(X509_CRL *x, const ASN1_TIME *tm);
 736 int X509_CRL_sort(X509_CRL *crl);
 737 int X509_CRL_up_ref(X509_CRL *crl);
 738
 739 # ifndef OPENSSL_NO_DEPRECATED_1_1_0
 740 #  define X509_CRL_set_lastUpdate X509_CRL_set1_lastUpdate
 741 #  define X509_CRL_set_nextUpdate X509_CRL_set1_nextUpdate
 742 #endif
 743
 744 long X509_CRL_get_version(const X509_CRL *crl);
 745 const ASN1_TIME *X509_CRL_get0_lastUpdate(const X509_CRL *crl);
 746 const ASN1_TIME *X509_CRL_get0_nextUpdate(const X509_CRL *crl);
 747 DEPRECATEDIN_1_1_0(ASN1_TIME *X509_CRL_get_lastUpdate(X509_CRL *crl))
 748 DEPRECATEDIN_1_1_0(ASN1_TIME *X509_CRL_get_nextUpdate(X509_CRL *crl))
 749 X509_NAME *X509_CRL_get_issuer(const X509_CRL *crl); /* TODO change to get0_ */
 750 const STACK_OF(X509_EXTENSION) *X509_CRL_get0_extensions(const X509_CRL *crl);
 751 STACK_OF(X509_REVOKED) *X509_CRL_get_REVOKED(X509_CRL *crl);
 752 void X509_CRL_get0_signature(const X509_CRL *crl, const ASN1_BIT_STRING **psig,
 753                              const X509_ALGOR **palg);
 754 int X509_CRL_get_signature_nid(const X509_CRL *crl);
 755 int i2d_re_X509_CRL_tbs(X509_CRL *req, unsigned char **pp);
 756
 757 const ASN1_INTEGER *X509_REVOKED_get0_serialNumber(const X509_REVOKED *x);
 758 int X509_REVOKED_set_serialNumber(X509_REVOKED *x, ASN1_INTEGER *serial);
 759 const ASN1_TIME *X509_REVOKED_get0_revocationDate(const X509_REVOKED *x);
 760 int X509_REVOKED_set_revocationDate(X509_REVOKED *r, ASN1_TIME *tm);
 761 const STACK_OF(X509_EXTENSION) *
 762 X509_REVOKED_get0_extensions(const X509_REVOKED *r);
 763
 764 X509_CRL *X509_CRL_diff(X509_CRL *base, X509_CRL *newer,
 765                         EVP_PKEY *skey, const EVP_MD *md, unsigned int flags);
 766
 767 int X509_REQ_check_private_key(X509_REQ *x509, EVP_PKEY *pkey);
 768
 769 int X509_check_private_key(const X509 *x509, const EVP_PKEY *pkey);
 770 int X509_chain_check_suiteb(int *perror_depth,
 771                             X509 *x, STACK_OF(X509) *chain,
 772                             unsigned long flags);
 773 int X509_CRL_check_suiteb(X509_CRL *crl, EVP_PKEY *pk, unsigned long flags);
 774 STACK_OF(X509) *X509_chain_up_ref(STACK_OF(X509) *chain);
 775
 776 int X509_issuer_and_serial_cmp(const X509 *a, const X509 *b);
 777 unsigned long X509_issuer_and_serial_hash(X509 *a);
 778
 779 int X509_issuer_name_cmp(const X509 *a, const X509 *b);
 780 unsigned long X509_issuer_name_hash(X509 *a);
 781
 782 int X509_subject_name_cmp(const X509 *a, const X509 *b);
 783 unsigned long X509_subject_name_hash(X509 *x);
 784
 785 # ifndef OPENSSL_NO_MD5
 786 unsigned long X509_issuer_name_hash_old(X509 *a);
 787 unsigned long X509_subject_name_hash_old(X509 *x);
 788 # endif
 789
 790 int X509_cmp(const X509 *a, const X509 *b);
 791 int X509_NAME_cmp(const X509_NAME *a, const X509_NAME *b);
 792 unsigned long X509_NAME_hash(const X509_NAME *x);
 793 unsigned long X509_NAME_hash_old(const X509_NAME *x);
 794
 795 int X509_CRL_cmp(const X509_CRL *a, const X509_CRL *b);
 796 int X509_CRL_match(const X509_CRL *a, const X509_CRL *b);
 797 int X509_aux_print(BIO *out, X509 *x, int indent);
 798 # ifndef OPENSSL_NO_STDIO
 799 int X509_print_ex_fp(FILE *bp, X509 *x, unsigned long nmflag,
 800                      unsigned long cflag);
 801 int X509_print_fp(FILE *bp, X509 *x);
 802 int X509_CRL_print_fp(FILE *bp, X509_CRL *x);
 803 int X509_REQ_print_fp(FILE *bp, X509_REQ *req);
 804 int X509_NAME_print_ex_fp(FILE *fp, const X509_NAME *nm, int indent,
 805                           unsigned long flags);
 806 # endif
 807
 808 int X509_NAME_print(BIO *bp, const X509_NAME *name, int obase);
 809 int X509_NAME_print_ex(BIO *out, const X509_NAME *nm, int indent,
 810                        unsigned long flags);
 811 int X509_print_ex(BIO *bp, X509 *x, unsigned long nmflag,
 812                   unsigned long cflag);
 813 int X509_print(BIO *bp, X509 *x);
 814 int X509_ocspid_print(BIO *bp, X509 *x);
 815 int X509_CRL_print_ex(BIO *out, X509_CRL *x, unsigned long nmflag);
 816 int X509_CRL_print(BIO *bp, X509_CRL *x);
 817 int X509_REQ_print_ex(BIO *bp, X509_REQ *x, unsigned long nmflag,
 818                       unsigned long cflag);
 819 int X509_REQ_print(BIO *bp, X509_REQ *req);
 820
 821 int X509_NAME_entry_count(const X509_NAME *name);
 822 int X509_NAME_get_text_by_NID(const X509_NAME *name, int nid,
 823                               char *buf, int len);
 824 int X509_NAME_get_text_by_OBJ(const X509_NAME *name, const ASN1_OBJECT *obj,
 825                               char *buf, int len);
 826
 827 /*
 828  * NOTE: you should be passing -1, not 0 as lastpos. The functions that use
 829  * lastpos, search after that position on.
 830  */
 831 int X509_NAME_get_index_by_NID(const X509_NAME *name, int nid, int lastpos);
 832 int X509_NAME_get_index_by_OBJ(const X509_NAME *name, const ASN1_OBJECT *obj,
 833                                int lastpos);
 834 X509_NAME_ENTRY *X509_NAME_get_entry(const X509_NAME *name, int loc);
 835 X509_NAME_ENTRY *X509_NAME_delete_entry(X509_NAME *name, int loc);
 836 int X509_NAME_add_entry(X509_NAME *name, const X509_NAME_ENTRY *ne,
 837                         int loc, int set);
 838 int X509_NAME_add_entry_by_OBJ(X509_NAME *name, const ASN1_OBJECT *obj, int type,
 839                                const unsigned char *bytes, int len, int loc,
 840                                int set);
 841 int X509_NAME_add_entry_by_NID(X509_NAME *name, int nid, int type,
 842                                const unsigned char *bytes, int len, int loc,
 843                                int set);
 844 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_txt(X509_NAME_ENTRY **ne,
 845                                                const char *field, int type,
 846                                                const unsigned char *bytes,
 847                                                int len);
 848 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_NID(X509_NAME_ENTRY **ne, int nid,
 849                                                int type,
 850                                                const unsigned char *bytes,
 851                                                int len);
 852 int X509_NAME_add_entry_by_txt(X509_NAME *name, const char *field, int type,
 853                                const unsigned char *bytes, int len, int loc,
 854                                int set);
 855 X509_NAME_ENTRY *X509_NAME_ENTRY_create_by_OBJ(X509_NAME_ENTRY **ne,
 856                                                const ASN1_OBJECT *obj, int type,
 857                                                const unsigned char *bytes,
 858                                                int len);
 859 int X509_NAME_ENTRY_set_object(X509_NAME_ENTRY *ne, const ASN1_OBJECT *obj);
 860 int X509_NAME_ENTRY_set_data(X509_NAME_ENTRY *ne, int type,
 861                              const unsigned char *bytes, int len);
 862 ASN1_OBJECT *X509_NAME_ENTRY_get_object(const X509_NAME_ENTRY *ne);
 863 ASN1_STRING * X509_NAME_ENTRY_get_data(const X509_NAME_ENTRY *ne);
 864 int X509_NAME_ENTRY_set(const X509_NAME_ENTRY *ne);
 865
 866 int X509_NAME_get0_der(const X509_NAME *nm, const unsigned char **pder,
 867                        size_t *pderlen);
 868
 869 int X509v3_get_ext_count(const STACK_OF(X509_EXTENSION) *x);
 870 int X509v3_get_ext_by_NID(const STACK_OF(X509_EXTENSION) *x,
 871                           int nid, int lastpos);
 872 int X509v3_get_ext_by_OBJ(const STACK_OF(X509_EXTENSION) *x,
 873                           const ASN1_OBJECT *obj, int lastpos);
 874 int X509v3_get_ext_by_critical(const STACK_OF(X509_EXTENSION) *x,
 875                                int crit, int lastpos);
 876 X509_EXTENSION *X509v3_get_ext(const STACK_OF(X509_EXTENSION) *x, int loc);
 877 X509_EXTENSION *X509v3_delete_ext(STACK_OF(X509_EXTENSION) *x, int loc);
 878 STACK_OF(X509_EXTENSION) *X509v3_add_ext(STACK_OF(X509_EXTENSION) **x,
 879                                          X509_EXTENSION *ex, int loc);
 880
 881 int X509_get_ext_count(const X509 *x);
 882 int X509_get_ext_by_NID(const X509 *x, int nid, int lastpos);
 883 int X509_get_ext_by_OBJ(const X509 *x, const ASN1_OBJECT *obj, int lastpos);
 884 int X509_get_ext_by_critical(const X509 *x, int crit, int lastpos);
 885 X509_EXTENSION *X509_get_ext(const X509 *x, int loc);
 886 X509_EXTENSION *X509_delete_ext(X509 *x, int loc);
 887 int X509_add_ext(X509 *x, X509_EXTENSION *ex, int loc);
 888 void *X509_get_ext_d2i(const X509 *x, int nid, int *crit, int *idx);
 889 int X509_add1_ext_i2d(X509 *x, int nid, void *value, int crit,
 890                       unsigned long flags);
 891
 892 int X509_CRL_get_ext_count(const X509_CRL *x);
 893 int X509_CRL_get_ext_by_NID(const X509_CRL *x, int nid, int lastpos);
 894 int X509_CRL_get_ext_by_OBJ(const X509_CRL *x, const ASN1_OBJECT *obj,
 895                             int lastpos);
 896 int X509_CRL_get_ext_by_critical(const X509_CRL *x, int crit, int lastpos);
 897 X509_EXTENSION *X509_CRL_get_ext(const X509_CRL *x, int loc);
 898 X509_EXTENSION *X509_CRL_delete_ext(X509_CRL *x, int loc);
 899 int X509_CRL_add_ext(X509_CRL *x, X509_EXTENSION *ex, int loc);
 900 void *X509_CRL_get_ext_d2i(const X509_CRL *x, int nid, int *crit, int *idx);
 901 int X509_CRL_add1_ext_i2d(X509_CRL *x, int nid, void *value, int crit,
 902                           unsigned long flags);
 903
 904 int X509_REVOKED_get_ext_count(const X509_REVOKED *x);
 905 int X509_REVOKED_get_ext_by_NID(const X509_REVOKED *x, int nid, int lastpos);
 906 int X509_REVOKED_get_ext_by_OBJ(const X509_REVOKED *x, const ASN1_OBJECT *obj,
 907                                 int lastpos);
 908 int X509_REVOKED_get_ext_by_critical(const X509_REVOKED *x, int crit,
 909                                      int lastpos);
 910 X509_EXTENSION *X509_REVOKED_get_ext(const X509_REVOKED *x, int loc);
 911 X509_EXTENSION *X509_REVOKED_delete_ext(X509_REVOKED *x, int loc);
 912 int X509_REVOKED_add_ext(X509_REVOKED *x, X509_EXTENSION *ex, int loc);
 913 void *X509_REVOKED_get_ext_d2i(const X509_REVOKED *x, int nid, int *crit,
 914                                int *idx);
 915 int X509_REVOKED_add1_ext_i2d(X509_REVOKED *x, int nid, void *value, int crit,
 916                               unsigned long flags);
 917
 918 X509_EXTENSION *X509_EXTENSION_create_by_NID(X509_EXTENSION **ex,
 919                                              int nid, int crit,
 920                                              ASN1_OCTET_STRING *data);
 921 X509_EXTENSION *X509_EXTENSION_create_by_OBJ(X509_EXTENSION **ex,
 922                                              const ASN1_OBJECT *obj, int crit,
 923                                              ASN1_OCTET_STRING *data);
 924 int X509_EXTENSION_set_object(X509_EXTENSION *ex, const ASN1_OBJECT *obj);
 925 int X509_EXTENSION_set_critical(X509_EXTENSION *ex, int crit);
 926 int X509_EXTENSION_set_data(X509_EXTENSION *ex, ASN1_OCTET_STRING *data);
 927 ASN1_OBJECT *X509_EXTENSION_get_object(X509_EXTENSION *ex);
 928 ASN1_OCTET_STRING *X509_EXTENSION_get_data(X509_EXTENSION *ne);
 929 int X509_EXTENSION_get_critical(const X509_EXTENSION *ex);
 930
 931 int X509at_get_attr_count(const STACK_OF(X509_ATTRIBUTE) *x);
 932 int X509at_get_attr_by_NID(const STACK_OF(X509_ATTRIBUTE) *x, int nid,
 933                            int lastpos);
 934 int X509at_get_attr_by_OBJ(const STACK_OF(X509_ATTRIBUTE) *sk,
 935                            const ASN1_OBJECT *obj, int lastpos);
 936 X509_ATTRIBUTE *X509at_get_attr(const STACK_OF(X509_ATTRIBUTE) *x, int loc);
 937 X509_ATTRIBUTE *X509at_delete_attr(STACK_OF(X509_ATTRIBUTE) *x, int loc);
 938 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr(STACK_OF(X509_ATTRIBUTE) **x,
 939                                            X509_ATTRIBUTE *attr);
 940 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_OBJ(STACK_OF(X509_ATTRIBUTE)
 941                                                   **x, const ASN1_OBJECT *obj,
 942                                                   int type,
 943                                                   const unsigned char *bytes,
 944                                                   int len);
 945 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_NID(STACK_OF(X509_ATTRIBUTE)
 946                                                   **x, int nid, int type,
 947                                                   const unsigned char *bytes,
 948                                                   int len);
 949 STACK_OF(X509_ATTRIBUTE) *X509at_add1_attr_by_txt(STACK_OF(X509_ATTRIBUTE)
 950                                                   **x, const char *attrname,
 951                                                   int type,
 952                                                   const unsigned char *bytes,
 953                                                   int len);
 954 void *X509at_get0_data_by_OBJ(STACK_OF(X509_ATTRIBUTE) *x,
 955                               const ASN1_OBJECT *obj, int lastpos, int type);
 956 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_NID(X509_ATTRIBUTE **attr, int nid,
 957                                              int atrtype, const void *data,
 958                                              int len);
 959 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_OBJ(X509_ATTRIBUTE **attr,
 960                                              const ASN1_OBJECT *obj,
 961                                              int atrtype, const void *data,
 962                                              int len);
 963 X509_ATTRIBUTE *X509_ATTRIBUTE_create_by_txt(X509_ATTRIBUTE **attr,
 964                                              const char *atrname, int type,
 965                                              const unsigned char *bytes,
 966                                              int len);
 967 int X509_ATTRIBUTE_set1_object(X509_ATTRIBUTE *attr, const ASN1_OBJECT *obj);
 968 int X509_ATTRIBUTE_set1_data(X509_ATTRIBUTE *attr, int attrtype,
 969                              const void *data, int len);
 970 void *X509_ATTRIBUTE_get0_data(X509_ATTRIBUTE *attr, int idx, int atrtype,
 971                                void *data);
 972 int X509_ATTRIBUTE_count(const X509_ATTRIBUTE *attr);
 973 ASN1_OBJECT *X509_ATTRIBUTE_get0_object(X509_ATTRIBUTE *attr);
 974 ASN1_TYPE *X509_ATTRIBUTE_get0_type(X509_ATTRIBUTE *attr, int idx);
 975
 976 int EVP_PKEY_get_attr_count(const EVP_PKEY *key);
 977 int EVP_PKEY_get_attr_by_NID(const EVP_PKEY *key, int nid, int lastpos);
 978 int EVP_PKEY_get_attr_by_OBJ(const EVP_PKEY *key, const ASN1_OBJECT *obj,
 979                              int lastpos);
 980 X509_ATTRIBUTE *EVP_PKEY_get_attr(const EVP_PKEY *key, int loc);
 981 X509_ATTRIBUTE *EVP_PKEY_delete_attr(EVP_PKEY *key, int loc);
 982 int EVP_PKEY_add1_attr(EVP_PKEY *key, X509_ATTRIBUTE *attr);
 983 int EVP_PKEY_add1_attr_by_OBJ(EVP_PKEY *key,
 984                               const ASN1_OBJECT *obj, int type,
 985                               const unsigned char *bytes, int len);
 986 int EVP_PKEY_add1_attr_by_NID(EVP_PKEY *key,
 987                               int nid, int type,
 988                               const unsigned char *bytes, int len);
 989 int EVP_PKEY_add1_attr_by_txt(EVP_PKEY *key,
 990                               const char *attrname, int type,
 991                               const unsigned char *bytes, int len);
 992
 993 int X509_verify_cert(X509_STORE_CTX *ctx);
 994
 995 /* lookup a cert from a X509 STACK */
 996 X509 *X509_find_by_issuer_and_serial(STACK_OF(X509) *sk, const X509_NAME *name,
 997                                      const ASN1_INTEGER *serial);
 998 X509 *X509_find_by_subject(STACK_OF(X509) *sk, const X509_NAME *name);
 999
1000 DECLARE_ASN1_FUNCTIONS(PBEPARAM)
1001 DECLARE_ASN1_FUNCTIONS(PBE2PARAM)
1002 DECLARE_ASN1_FUNCTIONS(PBKDF2PARAM)
1003 #ifndef OPENSSL_NO_SCRYPT
1004 DECLARE_ASN1_FUNCTIONS(SCRYPT_PARAMS)
1005 #endif
1006
1007 int PKCS5_pbe_set0_algor(X509_ALGOR *algor, int alg, int iter,
1008                          const unsigned char *salt, int saltlen);
1009
1010 X509_ALGOR *PKCS5_pbe_set(int alg, int iter,
1011                           const unsigned char *salt, int saltlen);
1012 X509_ALGOR *PKCS5_pbe2_set(const EVP_CIPHER *cipher, int iter,
1013                            unsigned char *salt, int saltlen);
1014 X509_ALGOR *PKCS5_pbe2_set_iv(const EVP_CIPHER *cipher, int iter,
1015                               unsigned char *salt, int saltlen,
1016                               unsigned char *aiv, int prf_nid);
1017
1018 #ifndef OPENSSL_NO_SCRYPT
1019 X509_ALGOR *PKCS5_pbe2_set_scrypt(const EVP_CIPHER *cipher,
1020                                   const unsigned char *salt, int saltlen,
1021                                   unsigned char *aiv, uint64_t N, uint64_t r,
1022                                   uint64_t p);
1023 #endif
1024
1025 X509_ALGOR *PKCS5_pbkdf2_set(int iter, unsigned char *salt, int saltlen,
1026                              int prf_nid, int keylen);
1027
1028 /* PKCS#8 utilities */
1029
1030 DECLARE_ASN1_FUNCTIONS(PKCS8_PRIV_KEY_INFO)
1031
1032 EVP_PKEY *EVP_PKCS82PKEY(const PKCS8_PRIV_KEY_INFO *p8);
1033 PKCS8_PRIV_KEY_INFO *EVP_PKEY2PKCS8(const EVP_PKEY *pkey);
1034
1035 int PKCS8_pkey_set0(PKCS8_PRIV_KEY_INFO *priv, ASN1_OBJECT *aobj,
1036                     int version, int ptype, void *pval,
1037                     unsigned char *penc, int penclen);
1038 int PKCS8_pkey_get0(const ASN1_OBJECT **ppkalg,
1039                     const unsigned char **pk, int *ppklen,
1040                     const X509_ALGOR **pa, const PKCS8_PRIV_KEY_INFO *p8);
1041
1042 const STACK_OF(X509_ATTRIBUTE) *
1043 PKCS8_pkey_get0_attrs(const PKCS8_PRIV_KEY_INFO *p8);
1044 int PKCS8_pkey_add1_attr(PKCS8_PRIV_KEY_INFO *p8, X509_ATTRIBUTE *attr);
1045 int PKCS8_pkey_add1_attr_by_NID(PKCS8_PRIV_KEY_INFO *p8, int nid, int type,
1046                                 const unsigned char *bytes, int len);
1047 int PKCS8_pkey_add1_attr_by_OBJ(PKCS8_PRIV_KEY_INFO *p8, const ASN1_OBJECT *obj,
1048                                 int type, const unsigned char *bytes, int len);
1049
1050
1051 int X509_PUBKEY_set0_param(X509_PUBKEY *pub, ASN1_OBJECT *aobj,
1052                            int ptype, void *pval,
1053                            unsigned char *penc, int penclen);
1054 int X509_PUBKEY_get0_param(ASN1_OBJECT **ppkalg,
1055                            const unsigned char **pk, int *ppklen,
1056                            X509_ALGOR **pa, const X509_PUBKEY *pub);
1057 int X509_PUBKEY_eq(const X509_PUBKEY *a, const X509_PUBKEY *b);
1058
1059 int X509_check_trust(X509 *x, int id, int flags);
1060 int X509_TRUST_get_count(void);
1061 X509_TRUST *X509_TRUST_get0(int idx);
1062 int X509_TRUST_get_by_id(int id);
1063 int X509_TRUST_add(int id, int flags, int (*ck) (X509_TRUST *, X509 *, int),
1064                    const char *name, int arg1, void *arg2);
1065 void X509_TRUST_cleanup(void);
1066 int X509_TRUST_get_flags(const X509_TRUST *xp);
1067 char *X509_TRUST_get0_name(const X509_TRUST *xp);
1068 int X509_TRUST_get_trust(const X509_TRUST *xp);
1069
1070 # ifdef  __cplusplus
1071 }
1072 # endif
1073 #endif