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