include/openssl/x509.h.in

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