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