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