1/*
2 * WARNING: do not edit!
3 * Generated by Makefile from include/openssl/x509_vfy.h.in
4 *
5 * Copyright 1995-2025 The OpenSSL Project Authors. 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/* clang-format off */
14
15/* clang-format on */
16
17#ifndef OPENSSL_X509_VFY_H
18#define OPENSSL_X509_VFY_H
19#pragma once
20
21#include <openssl/macros.h>
22#ifndef OPENSSL_NO_DEPRECATED_3_0
23#define HEADER_X509_VFY_H
24#endif
25
26/*
27 * Protect against recursion, x509.h and x509_vfy.h each include the other.
28 */
29#ifndef OPENSSL_X509_H
30#include <openssl/x509.h>
31#endif
32
33#include <openssl/opensslconf.h>
34#include <openssl/lhash.h>
35#include <openssl/bio.h>
36#include <openssl/crypto.h>
37#include <openssl/symhacks.h>
38
39#ifdef __cplusplus
40extern "C" {
41#endif
42
43DEFINE_STACK_OF(OCSP_RESPONSE)
44
45/*-
46SSL_CTX -> X509_STORE
47 -> X509_LOOKUP
48 ->X509_LOOKUP_METHOD
49 -> X509_LOOKUP
50 ->X509_LOOKUP_METHOD
51
52SSL -> X509_STORE_CTX
53 ->X509_STORE
54
55The X509_STORE holds the tables etc for verification stuff.
56A X509_STORE_CTX is used while validating a single certificate.
57The X509_STORE has X509_LOOKUPs for looking up certs.
58The X509_STORE then calls a function to actually verify the
59certificate chain.
60*/
61
62typedef enum {
63 X509_LU_NONE = 0,
64 X509_LU_X509,
65 X509_LU_CRL
66} X509_LOOKUP_TYPE;
67
68#ifndef OPENSSL_NO_DEPRECATED_1_1_0
69#define X509_LU_RETRY -1
70#define X509_LU_FAIL 0
71#endif
72
73/* clang-format off */
74SKM_DEFINE_STACK_OF_INTERNAL(X509_LOOKUP, X509_LOOKUP, X509_LOOKUP)
75#define sk_X509_LOOKUP_num(sk) OPENSSL_sk_num(ossl_check_const_X509_LOOKUP_sk_type(sk))
76#define sk_X509_LOOKUP_value(sk, idx) ((X509_LOOKUP *)OPENSSL_sk_value(ossl_check_const_X509_LOOKUP_sk_type(sk), (idx)))
77#define sk_X509_LOOKUP_new(cmp) ((STACK_OF(X509_LOOKUP) *)OPENSSL_sk_new(ossl_check_X509_LOOKUP_compfunc_type(cmp)))
78#define sk_X509_LOOKUP_new_null() ((STACK_OF(X509_LOOKUP) *)OPENSSL_sk_new_null())
79#define sk_X509_LOOKUP_new_reserve(cmp, n) ((STACK_OF(X509_LOOKUP) *)OPENSSL_sk_new_reserve(ossl_check_X509_LOOKUP_compfunc_type(cmp), (n)))
80#define sk_X509_LOOKUP_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_X509_LOOKUP_sk_type(sk), (n))
81#define sk_X509_LOOKUP_free(sk) OPENSSL_sk_free(ossl_check_X509_LOOKUP_sk_type(sk))
82#define sk_X509_LOOKUP_zero(sk) OPENSSL_sk_zero(ossl_check_X509_LOOKUP_sk_type(sk))
83#define sk_X509_LOOKUP_delete(sk, i) ((X509_LOOKUP *)OPENSSL_sk_delete(ossl_check_X509_LOOKUP_sk_type(sk), (i)))
84#define sk_X509_LOOKUP_delete_ptr(sk, ptr) ((X509_LOOKUP *)OPENSSL_sk_delete_ptr(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr)))
85#define sk_X509_LOOKUP_push(sk, ptr) OPENSSL_sk_push(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr))
86#define sk_X509_LOOKUP_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr))
87#define sk_X509_LOOKUP_pop(sk) ((X509_LOOKUP *)OPENSSL_sk_pop(ossl_check_X509_LOOKUP_sk_type(sk)))
88#define sk_X509_LOOKUP_shift(sk) ((X509_LOOKUP *)OPENSSL_sk_shift(ossl_check_X509_LOOKUP_sk_type(sk)))
89#define sk_X509_LOOKUP_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_freefunc_type(freefunc))
90#define sk_X509_LOOKUP_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr), (idx))
91#define sk_X509_LOOKUP_set(sk, idx, ptr) ((X509_LOOKUP *)OPENSSL_sk_set(ossl_check_X509_LOOKUP_sk_type(sk), (idx), ossl_check_X509_LOOKUP_type(ptr)))
92#define sk_X509_LOOKUP_find(sk, ptr) OPENSSL_sk_find(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr))
93#define sk_X509_LOOKUP_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr))
94#define sk_X509_LOOKUP_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_type(ptr), pnum)
95#define sk_X509_LOOKUP_sort(sk) OPENSSL_sk_sort(ossl_check_X509_LOOKUP_sk_type(sk))
96#define sk_X509_LOOKUP_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_X509_LOOKUP_sk_type(sk))
97#define sk_X509_LOOKUP_dup(sk) ((STACK_OF(X509_LOOKUP) *)OPENSSL_sk_dup(ossl_check_const_X509_LOOKUP_sk_type(sk)))
98#define sk_X509_LOOKUP_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(X509_LOOKUP) *)OPENSSL_sk_deep_copy(ossl_check_const_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_copyfunc_type(copyfunc), ossl_check_X509_LOOKUP_freefunc_type(freefunc)))
99#define sk_X509_LOOKUP_set_cmp_func(sk, cmp) ((sk_X509_LOOKUP_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_X509_LOOKUP_sk_type(sk), ossl_check_X509_LOOKUP_compfunc_type(cmp)))
100SKM_DEFINE_STACK_OF_INTERNAL(X509_OBJECT, X509_OBJECT, X509_OBJECT)
101#define sk_X509_OBJECT_num(sk) OPENSSL_sk_num(ossl_check_const_X509_OBJECT_sk_type(sk))
102#define sk_X509_OBJECT_value(sk, idx) ((X509_OBJECT *)OPENSSL_sk_value(ossl_check_const_X509_OBJECT_sk_type(sk), (idx)))
103#define sk_X509_OBJECT_new(cmp) ((STACK_OF(X509_OBJECT) *)OPENSSL_sk_new(ossl_check_X509_OBJECT_compfunc_type(cmp)))
104#define sk_X509_OBJECT_new_null() ((STACK_OF(X509_OBJECT) *)OPENSSL_sk_new_null())
105#define sk_X509_OBJECT_new_reserve(cmp, n) ((STACK_OF(X509_OBJECT) *)OPENSSL_sk_new_reserve(ossl_check_X509_OBJECT_compfunc_type(cmp), (n)))
106#define sk_X509_OBJECT_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_X509_OBJECT_sk_type(sk), (n))
107#define sk_X509_OBJECT_free(sk) OPENSSL_sk_free(ossl_check_X509_OBJECT_sk_type(sk))
108#define sk_X509_OBJECT_zero(sk) OPENSSL_sk_zero(ossl_check_X509_OBJECT_sk_type(sk))
109#define sk_X509_OBJECT_delete(sk, i) ((X509_OBJECT *)OPENSSL_sk_delete(ossl_check_X509_OBJECT_sk_type(sk), (i)))
110#define sk_X509_OBJECT_delete_ptr(sk, ptr) ((X509_OBJECT *)OPENSSL_sk_delete_ptr(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr)))
111#define sk_X509_OBJECT_push(sk, ptr) OPENSSL_sk_push(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr))
112#define sk_X509_OBJECT_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr))
113#define sk_X509_OBJECT_pop(sk) ((X509_OBJECT *)OPENSSL_sk_pop(ossl_check_X509_OBJECT_sk_type(sk)))
114#define sk_X509_OBJECT_shift(sk) ((X509_OBJECT *)OPENSSL_sk_shift(ossl_check_X509_OBJECT_sk_type(sk)))
115#define sk_X509_OBJECT_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_freefunc_type(freefunc))
116#define sk_X509_OBJECT_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr), (idx))
117#define sk_X509_OBJECT_set(sk, idx, ptr) ((X509_OBJECT *)OPENSSL_sk_set(ossl_check_X509_OBJECT_sk_type(sk), (idx), ossl_check_X509_OBJECT_type(ptr)))
118#define sk_X509_OBJECT_find(sk, ptr) OPENSSL_sk_find(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr))
119#define sk_X509_OBJECT_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr))
120#define sk_X509_OBJECT_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_type(ptr), pnum)
121#define sk_X509_OBJECT_sort(sk) OPENSSL_sk_sort(ossl_check_X509_OBJECT_sk_type(sk))
122#define sk_X509_OBJECT_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_X509_OBJECT_sk_type(sk))
123#define sk_X509_OBJECT_dup(sk) ((STACK_OF(X509_OBJECT) *)OPENSSL_sk_dup(ossl_check_const_X509_OBJECT_sk_type(sk)))
124#define sk_X509_OBJECT_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(X509_OBJECT) *)OPENSSL_sk_deep_copy(ossl_check_const_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_copyfunc_type(copyfunc), ossl_check_X509_OBJECT_freefunc_type(freefunc)))
125#define sk_X509_OBJECT_set_cmp_func(sk, cmp) ((sk_X509_OBJECT_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_X509_OBJECT_sk_type(sk), ossl_check_X509_OBJECT_compfunc_type(cmp)))
126SKM_DEFINE_STACK_OF_INTERNAL(X509_VERIFY_PARAM, X509_VERIFY_PARAM, X509_VERIFY_PARAM)
127#define sk_X509_VERIFY_PARAM_num(sk) OPENSSL_sk_num(ossl_check_const_X509_VERIFY_PARAM_sk_type(sk))
128#define sk_X509_VERIFY_PARAM_value(sk, idx) ((X509_VERIFY_PARAM *)OPENSSL_sk_value(ossl_check_const_X509_VERIFY_PARAM_sk_type(sk), (idx)))
129#define sk_X509_VERIFY_PARAM_new(cmp) ((STACK_OF(X509_VERIFY_PARAM) *)OPENSSL_sk_new(ossl_check_X509_VERIFY_PARAM_compfunc_type(cmp)))
130#define sk_X509_VERIFY_PARAM_new_null() ((STACK_OF(X509_VERIFY_PARAM) *)OPENSSL_sk_new_null())
131#define sk_X509_VERIFY_PARAM_new_reserve(cmp, n) ((STACK_OF(X509_VERIFY_PARAM) *)OPENSSL_sk_new_reserve(ossl_check_X509_VERIFY_PARAM_compfunc_type(cmp), (n)))
132#define sk_X509_VERIFY_PARAM_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_X509_VERIFY_PARAM_sk_type(sk), (n))
133#define sk_X509_VERIFY_PARAM_free(sk) OPENSSL_sk_free(ossl_check_X509_VERIFY_PARAM_sk_type(sk))
134#define sk_X509_VERIFY_PARAM_zero(sk) OPENSSL_sk_zero(ossl_check_X509_VERIFY_PARAM_sk_type(sk))
135#define sk_X509_VERIFY_PARAM_delete(sk, i) ((X509_VERIFY_PARAM *)OPENSSL_sk_delete(ossl_check_X509_VERIFY_PARAM_sk_type(sk), (i)))
136#define sk_X509_VERIFY_PARAM_delete_ptr(sk, ptr) ((X509_VERIFY_PARAM *)OPENSSL_sk_delete_ptr(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr)))
137#define sk_X509_VERIFY_PARAM_push(sk, ptr) OPENSSL_sk_push(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr))
138#define sk_X509_VERIFY_PARAM_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr))
139#define sk_X509_VERIFY_PARAM_pop(sk) ((X509_VERIFY_PARAM *)OPENSSL_sk_pop(ossl_check_X509_VERIFY_PARAM_sk_type(sk)))
140#define sk_X509_VERIFY_PARAM_shift(sk) ((X509_VERIFY_PARAM *)OPENSSL_sk_shift(ossl_check_X509_VERIFY_PARAM_sk_type(sk)))
141#define sk_X509_VERIFY_PARAM_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_freefunc_type(freefunc))
142#define sk_X509_VERIFY_PARAM_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr), (idx))
143#define sk_X509_VERIFY_PARAM_set(sk, idx, ptr) ((X509_VERIFY_PARAM *)OPENSSL_sk_set(ossl_check_X509_VERIFY_PARAM_sk_type(sk), (idx), ossl_check_X509_VERIFY_PARAM_type(ptr)))
144#define sk_X509_VERIFY_PARAM_find(sk, ptr) OPENSSL_sk_find(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr))
145#define sk_X509_VERIFY_PARAM_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr))
146#define sk_X509_VERIFY_PARAM_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_type(ptr), pnum)
147#define sk_X509_VERIFY_PARAM_sort(sk) OPENSSL_sk_sort(ossl_check_X509_VERIFY_PARAM_sk_type(sk))
148#define sk_X509_VERIFY_PARAM_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_X509_VERIFY_PARAM_sk_type(sk))
149#define sk_X509_VERIFY_PARAM_dup(sk) ((STACK_OF(X509_VERIFY_PARAM) *)OPENSSL_sk_dup(ossl_check_const_X509_VERIFY_PARAM_sk_type(sk)))
150#define sk_X509_VERIFY_PARAM_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(X509_VERIFY_PARAM) *)OPENSSL_sk_deep_copy(ossl_check_const_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_copyfunc_type(copyfunc), ossl_check_X509_VERIFY_PARAM_freefunc_type(freefunc)))
151#define sk_X509_VERIFY_PARAM_set_cmp_func(sk, cmp) ((sk_X509_VERIFY_PARAM_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_X509_VERIFY_PARAM_sk_type(sk), ossl_check_X509_VERIFY_PARAM_compfunc_type(cmp)))
152
153/* clang-format on */
154
155/* This is used for a table of trust checking functions */
156typedef struct x509_trust_st {
157 int trust;
158 int flags;
159 int (*check_trust)(struct x509_trust_st *, X509 *, int);
160 char *name;
161 int arg1;
162 void *arg2;
163} X509_TRUST;
164/* clang-format off */
165SKM_DEFINE_STACK_OF_INTERNAL(X509_TRUST, X509_TRUST, X509_TRUST)
166#define sk_X509_TRUST_num(sk) OPENSSL_sk_num(ossl_check_const_X509_TRUST_sk_type(sk))
167#define sk_X509_TRUST_value(sk, idx) ((X509_TRUST *)OPENSSL_sk_value(ossl_check_const_X509_TRUST_sk_type(sk), (idx)))
168#define sk_X509_TRUST_new(cmp) ((STACK_OF(X509_TRUST) *)OPENSSL_sk_new(ossl_check_X509_TRUST_compfunc_type(cmp)))
169#define sk_X509_TRUST_new_null() ((STACK_OF(X509_TRUST) *)OPENSSL_sk_new_null())
170#define sk_X509_TRUST_new_reserve(cmp, n) ((STACK_OF(X509_TRUST) *)OPENSSL_sk_new_reserve(ossl_check_X509_TRUST_compfunc_type(cmp), (n)))
171#define sk_X509_TRUST_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_X509_TRUST_sk_type(sk), (n))
172#define sk_X509_TRUST_free(sk) OPENSSL_sk_free(ossl_check_X509_TRUST_sk_type(sk))
173#define sk_X509_TRUST_zero(sk) OPENSSL_sk_zero(ossl_check_X509_TRUST_sk_type(sk))
174#define sk_X509_TRUST_delete(sk, i) ((X509_TRUST *)OPENSSL_sk_delete(ossl_check_X509_TRUST_sk_type(sk), (i)))
175#define sk_X509_TRUST_delete_ptr(sk, ptr) ((X509_TRUST *)OPENSSL_sk_delete_ptr(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr)))
176#define sk_X509_TRUST_push(sk, ptr) OPENSSL_sk_push(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr))
177#define sk_X509_TRUST_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr))
178#define sk_X509_TRUST_pop(sk) ((X509_TRUST *)OPENSSL_sk_pop(ossl_check_X509_TRUST_sk_type(sk)))
179#define sk_X509_TRUST_shift(sk) ((X509_TRUST *)OPENSSL_sk_shift(ossl_check_X509_TRUST_sk_type(sk)))
180#define sk_X509_TRUST_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_freefunc_type(freefunc))
181#define sk_X509_TRUST_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr), (idx))
182#define sk_X509_TRUST_set(sk, idx, ptr) ((X509_TRUST *)OPENSSL_sk_set(ossl_check_X509_TRUST_sk_type(sk), (idx), ossl_check_X509_TRUST_type(ptr)))
183#define sk_X509_TRUST_find(sk, ptr) OPENSSL_sk_find(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr))
184#define sk_X509_TRUST_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr))
185#define sk_X509_TRUST_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_type(ptr), pnum)
186#define sk_X509_TRUST_sort(sk) OPENSSL_sk_sort(ossl_check_X509_TRUST_sk_type(sk))
187#define sk_X509_TRUST_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_X509_TRUST_sk_type(sk))
188#define sk_X509_TRUST_dup(sk) ((STACK_OF(X509_TRUST) *)OPENSSL_sk_dup(ossl_check_const_X509_TRUST_sk_type(sk)))
189#define sk_X509_TRUST_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(X509_TRUST) *)OPENSSL_sk_deep_copy(ossl_check_const_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_copyfunc_type(copyfunc), ossl_check_X509_TRUST_freefunc_type(freefunc)))
190#define sk_X509_TRUST_set_cmp_func(sk, cmp) ((sk_X509_TRUST_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_X509_TRUST_sk_type(sk), ossl_check_X509_TRUST_compfunc_type(cmp)))
191
192/* clang-format on */
193
194/* standard trust ids */
195#define X509_TRUST_DEFAULT 0 /* Only valid in purpose settings */
196#define X509_TRUST_COMPAT 1
197#define X509_TRUST_SSL_CLIENT 2
198#define X509_TRUST_SSL_SERVER 3
199#define X509_TRUST_EMAIL 4
200#define X509_TRUST_OBJECT_SIGN 5
201#define X509_TRUST_OCSP_SIGN 6
202#define X509_TRUST_OCSP_REQUEST 7
203#define X509_TRUST_TSA 8
204/* Keep these up to date! */
205#define X509_TRUST_MIN 1
206#define X509_TRUST_MAX 8
207
208/* trust_flags values */
209#define X509_TRUST_DYNAMIC (1U << 0)
210#define X509_TRUST_DYNAMIC_NAME (1U << 1)
211/* No compat trust if self-signed, preempts "DO_SS" */
212#define X509_TRUST_NO_SS_COMPAT (1U << 2)
213/* Compat trust if no explicit accepted trust EKUs */
214#define X509_TRUST_DO_SS_COMPAT (1U << 3)
215/* Accept "anyEKU" as a wildcard rejection OID and as a wildcard trust OID */
216#define X509_TRUST_OK_ANY_EKU (1U << 4)
217
218/* check_trust return codes */
219#define X509_TRUST_TRUSTED 1
220#define X509_TRUST_REJECTED 2
221#define X509_TRUST_UNTRUSTED 3
222
223int X509_TRUST_set(int *t, int trust);
224int X509_TRUST_get_count(void);
225X509_TRUST *X509_TRUST_get0(int idx);
226int X509_TRUST_get_by_id(int id);
227int X509_TRUST_add(int id, int flags, int (*ck)(X509_TRUST *, X509 *, int),
228 const char *name, int arg1, void *arg2);
229void X509_TRUST_cleanup(void);
230int X509_TRUST_get_flags(const X509_TRUST *xp);
231char *X509_TRUST_get0_name(const X509_TRUST *xp);
232int X509_TRUST_get_trust(const X509_TRUST *xp);
233
234int X509_trusted(const X509 *x);
235int X509_add1_trust_object(X509 *x, const ASN1_OBJECT *obj);
236int X509_add1_reject_object(X509 *x, const ASN1_OBJECT *obj);
237void X509_trust_clear(X509 *x);
238void X509_reject_clear(X509 *x);
239STACK_OF(ASN1_OBJECT) *X509_get0_trust_objects(X509 *x);
240STACK_OF(ASN1_OBJECT) *X509_get0_reject_objects(X509 *x);
241
242int (*X509_TRUST_set_default(int (*trust)(int, X509 *, int)))(int, X509 *,
243 int);
244int X509_check_trust(X509 *x, int id, int flags);
245
246int X509_verify_cert(X509_STORE_CTX *ctx);
247int X509_STORE_CTX_verify(X509_STORE_CTX *ctx);
248STACK_OF(X509) *X509_build_chain(X509 *target, STACK_OF(X509) *certs,
249 X509_STORE *store, int with_self_signed,
250 OSSL_LIB_CTX *libctx, const char *propq);
251
252int X509_STORE_set_depth(X509_STORE *store, int depth);
253
254typedef int (*X509_STORE_CTX_verify_cb)(int, X509_STORE_CTX *);
255int X509_STORE_CTX_print_verify_cb(int ok, X509_STORE_CTX *ctx);
256typedef int (*X509_STORE_CTX_verify_fn)(X509_STORE_CTX *);
257typedef int (*X509_STORE_CTX_get_issuer_fn)(X509 **issuer,
258 X509_STORE_CTX *ctx, X509 *x);
259typedef int (*X509_STORE_CTX_check_issued_fn)(X509_STORE_CTX *ctx,
260 X509 *x, X509 *issuer);
261typedef int (*X509_STORE_CTX_check_revocation_fn)(X509_STORE_CTX *ctx);
262typedef int (*X509_STORE_CTX_get_crl_fn)(X509_STORE_CTX *ctx,
263 X509_CRL **crl, X509 *x);
264typedef int (*X509_STORE_CTX_check_crl_fn)(X509_STORE_CTX *ctx, X509_CRL *crl);
265typedef int (*X509_STORE_CTX_cert_crl_fn)(X509_STORE_CTX *ctx,
266 X509_CRL *crl, X509 *x);
267typedef int (*X509_STORE_CTX_check_policy_fn)(X509_STORE_CTX *ctx);
268typedef STACK_OF(X509)
269 *(*X509_STORE_CTX_lookup_certs_fn)(X509_STORE_CTX *ctx,
270 const X509_NAME *nm);
271typedef STACK_OF(X509_CRL)
272 *(*X509_STORE_CTX_lookup_crls_fn)(const X509_STORE_CTX *ctx,
273 const X509_NAME *nm);
274typedef int (*X509_STORE_CTX_cleanup_fn)(X509_STORE_CTX *ctx);
275
276void X509_STORE_CTX_set_depth(X509_STORE_CTX *ctx, int depth);
277
278#define X509_STORE_CTX_set_app_data(ctx, data) \
279 X509_STORE_CTX_set_ex_data(ctx, 0, data)
280#define X509_STORE_CTX_get_app_data(ctx) \
281 X509_STORE_CTX_get_ex_data(ctx, 0)
282
283#define X509_L_FILE_LOAD 1
284#define X509_L_ADD_DIR 2
285#define X509_L_ADD_STORE 3
286#define X509_L_LOAD_STORE 4
287
288#define X509_LOOKUP_load_file(x, name, type) \
289 X509_LOOKUP_ctrl((x), X509_L_FILE_LOAD, (name), (long)(type), NULL)
290
291#define X509_LOOKUP_add_dir(x, name, type) \
292 X509_LOOKUP_ctrl((x), X509_L_ADD_DIR, (name), (long)(type), NULL)
293
294#define X509_LOOKUP_add_store(x, name) \
295 X509_LOOKUP_ctrl((x), X509_L_ADD_STORE, (name), 0, NULL)
296
297#define X509_LOOKUP_load_store(x, name) \
298 X509_LOOKUP_ctrl((x), X509_L_LOAD_STORE, (name), 0, NULL)
299
300#define X509_LOOKUP_load_file_ex(x, name, type, libctx, propq) \
301 X509_LOOKUP_ctrl_ex((x), X509_L_FILE_LOAD, (name), (long)(type), NULL, \
302 (libctx), (propq))
303
304#define X509_LOOKUP_load_store_ex(x, name, libctx, propq) \
305 X509_LOOKUP_ctrl_ex((x), X509_L_LOAD_STORE, (name), 0, NULL, \
306 (libctx), (propq))
307
308#define X509_LOOKUP_add_store_ex(x, name, libctx, propq) \
309 X509_LOOKUP_ctrl_ex((x), X509_L_ADD_STORE, (name), 0, NULL, \
310 (libctx), (propq))
311
312#define X509_V_OK 0
313#define X509_V_ERR_UNSPECIFIED 1
314#define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT 2
315#define X509_V_ERR_UNABLE_TO_GET_CRL 3
316#define X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE 4
317#define X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE 5
318#define X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY 6
319#define X509_V_ERR_CERT_SIGNATURE_FAILURE 7
320#define X509_V_ERR_CRL_SIGNATURE_FAILURE 8
321#define X509_V_ERR_CERT_NOT_YET_VALID 9
322#define X509_V_ERR_CERT_HAS_EXPIRED 10
323#define X509_V_ERR_CRL_NOT_YET_VALID 11
324#define X509_V_ERR_CRL_HAS_EXPIRED 12
325#define X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD 13
326#define X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD 14
327#define X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD 15
328#define X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD 16
329#define X509_V_ERR_OUT_OF_MEM 17
330#define X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 18
331#define X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN 19
332#define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 20
333#define X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 21
334#define X509_V_ERR_CERT_CHAIN_TOO_LONG 22
335#define X509_V_ERR_CERT_REVOKED 23
336#define X509_V_ERR_NO_ISSUER_PUBLIC_KEY 24
337#define X509_V_ERR_PATH_LENGTH_EXCEEDED 25
338#define X509_V_ERR_INVALID_PURPOSE 26
339#define X509_V_ERR_CERT_UNTRUSTED 27
340#define X509_V_ERR_CERT_REJECTED 28
341
342/* These are 'informational' when looking for issuer cert */
343#define X509_V_ERR_SUBJECT_ISSUER_MISMATCH 29
344#define X509_V_ERR_AKID_SKID_MISMATCH 30
345#define X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH 31
346#define X509_V_ERR_KEYUSAGE_NO_CERTSIGN 32
347#define X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER 33
348#define X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION 34
349#define X509_V_ERR_KEYUSAGE_NO_CRL_SIGN 35
350#define X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION 36
351#define X509_V_ERR_INVALID_NON_CA 37
352#define X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED 38
353#define X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE 39
354#define X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED 40
355#define X509_V_ERR_INVALID_EXTENSION 41
356#define X509_V_ERR_INVALID_POLICY_EXTENSION 42
357#define X509_V_ERR_NO_EXPLICIT_POLICY 43
358#define X509_V_ERR_DIFFERENT_CRL_SCOPE 44
359#define X509_V_ERR_UNSUPPORTED_EXTENSION_FEATURE 45
360#define X509_V_ERR_UNNESTED_RESOURCE 46
361#define X509_V_ERR_PERMITTED_VIOLATION 47
362#define X509_V_ERR_EXCLUDED_VIOLATION 48
363#define X509_V_ERR_SUBTREE_MINMAX 49
364/* The application is not happy */
365#define X509_V_ERR_APPLICATION_VERIFICATION 50
366#define X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE 51
367#define X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX 52
368#define X509_V_ERR_UNSUPPORTED_NAME_SYNTAX 53
369#define X509_V_ERR_CRL_PATH_VALIDATION_ERROR 54
370/* Another issuer check debug option */
371#define X509_V_ERR_PATH_LOOP 55
372/* Suite B mode algorithm violation */
373#define X509_V_ERR_SUITE_B_INVALID_VERSION 56
374#define X509_V_ERR_SUITE_B_INVALID_ALGORITHM 57
375#define X509_V_ERR_SUITE_B_INVALID_CURVE 58
376#define X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM 59
377#define X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED 60
378#define X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256 61
379/* Host, email and IP check errors */
380#define X509_V_ERR_HOSTNAME_MISMATCH 62
381#define X509_V_ERR_EMAIL_MISMATCH 63
382#define X509_V_ERR_IP_ADDRESS_MISMATCH 64
383/* DANE TLSA errors */
384#define X509_V_ERR_DANE_NO_MATCH 65
385/* security level errors */
386#define X509_V_ERR_EE_KEY_TOO_SMALL 66
387#define X509_V_ERR_CA_KEY_TOO_SMALL 67
388#define X509_V_ERR_CA_MD_TOO_WEAK 68
389/* Caller error */
390#define X509_V_ERR_INVALID_CALL 69
391/* Issuer lookup error */
392#define X509_V_ERR_STORE_LOOKUP 70
393/* Certificate transparency */
394#define X509_V_ERR_NO_VALID_SCTS 71
395
396#define X509_V_ERR_PROXY_SUBJECT_NAME_VIOLATION 72
397/* OCSP status errors */
398#define X509_V_ERR_OCSP_VERIFY_NEEDED 73 /* Need OCSP verification */
399#define X509_V_ERR_OCSP_VERIFY_FAILED 74 /* Couldn't verify cert through OCSP */
400#define X509_V_ERR_OCSP_CERT_UNKNOWN 75 /* Certificate wasn't recognized by the OCSP responder */
401
402#define X509_V_ERR_UNSUPPORTED_SIGNATURE_ALGORITHM 76
403#define X509_V_ERR_SIGNATURE_ALGORITHM_MISMATCH 77
404
405/* Errors in case a check in X509_V_FLAG_X509_STRICT mode fails */
406#define X509_V_ERR_SIGNATURE_ALGORITHM_INCONSISTENCY 78
407#define X509_V_ERR_INVALID_CA 79
408#define X509_V_ERR_PATHLEN_INVALID_FOR_NON_CA 80
409#define X509_V_ERR_PATHLEN_WITHOUT_KU_KEY_CERT_SIGN 81
410#define X509_V_ERR_KU_KEY_CERT_SIGN_INVALID_FOR_NON_CA 82
411#define X509_V_ERR_ISSUER_NAME_EMPTY 83
412#define X509_V_ERR_SUBJECT_NAME_EMPTY 84
413#define X509_V_ERR_MISSING_AUTHORITY_KEY_IDENTIFIER 85
414#define X509_V_ERR_MISSING_SUBJECT_KEY_IDENTIFIER 86
415#define X509_V_ERR_EMPTY_SUBJECT_ALT_NAME 87
416#define X509_V_ERR_EMPTY_SUBJECT_SAN_NOT_CRITICAL 88
417#define X509_V_ERR_CA_BCONS_NOT_CRITICAL 89
418#define X509_V_ERR_AUTHORITY_KEY_IDENTIFIER_CRITICAL 90
419#define X509_V_ERR_SUBJECT_KEY_IDENTIFIER_CRITICAL 91
420#define X509_V_ERR_CA_CERT_MISSING_KEY_USAGE 92
421#define X509_V_ERR_EXTENSIONS_REQUIRE_VERSION_3 93
422#define X509_V_ERR_EC_KEY_EXPLICIT_PARAMS 94
423#define X509_V_ERR_RPK_UNTRUSTED 95
424
425/* additional OCSP status errors */
426#define X509_V_ERR_OCSP_RESP_INVALID 96
427#define X509_V_ERR_OCSP_SIGNATURE_FAILURE 97
428#define X509_V_ERR_OCSP_NOT_YET_VALID 98
429#define X509_V_ERR_OCSP_HAS_EXPIRED 99
430#define X509_V_ERR_OCSP_NO_RESPONSE 100
431#define X509_V_ERR_CRL_VERIFY_FAILED 101
432
433/* Certificate verify flags */
434#ifndef OPENSSL_NO_DEPRECATED_1_1_0
435#define X509_V_FLAG_CB_ISSUER_CHECK 0x0 /* Deprecated */
436#endif
437/* Use check time instead of current time */
438#define X509_V_FLAG_USE_CHECK_TIME 0x2
439/* Lookup CRLs */
440#define X509_V_FLAG_CRL_CHECK 0x4
441/* Lookup CRLs for whole chain */
442#define X509_V_FLAG_CRL_CHECK_ALL 0x8
443/* Ignore unhandled critical extensions */
444#define X509_V_FLAG_IGNORE_CRITICAL 0x10
445/* Disable workarounds for broken certificates */
446#define X509_V_FLAG_X509_STRICT 0x20
447/* Enable proxy certificate validation */
448#define X509_V_FLAG_ALLOW_PROXY_CERTS 0x40
449/* Enable policy checking */
450#define X509_V_FLAG_POLICY_CHECK 0x80
451/* Policy variable require-explicit-policy */
452#define X509_V_FLAG_EXPLICIT_POLICY 0x100
453/* Policy variable inhibit-any-policy */
454#define X509_V_FLAG_INHIBIT_ANY 0x200
455/* Policy variable inhibit-policy-mapping */
456#define X509_V_FLAG_INHIBIT_MAP 0x400
457/* Notify callback that policy is OK */
458#define X509_V_FLAG_NOTIFY_POLICY 0x800
459/* Extended CRL features such as indirect CRLs, alternate CRL signing keys */
460#define X509_V_FLAG_EXTENDED_CRL_SUPPORT 0x1000
461/* Delta CRL support */
462#define X509_V_FLAG_USE_DELTAS 0x2000
463/* Check self-signed CA signature */
464#define X509_V_FLAG_CHECK_SS_SIGNATURE 0x4000
465/* Use trusted store first */
466#define X509_V_FLAG_TRUSTED_FIRST 0x8000
467/* Suite B 128 bit only mode: not normally used */
468#define X509_V_FLAG_SUITEB_128_LOS_ONLY 0x10000
469/* Suite B 192 bit only mode */
470#define X509_V_FLAG_SUITEB_192_LOS 0x20000
471/* Suite B 128 bit mode allowing 192 bit algorithms */
472#define X509_V_FLAG_SUITEB_128_LOS 0x30000
473/* Allow partial chains if at least one certificate is in trusted store */
474#define X509_V_FLAG_PARTIAL_CHAIN 0x80000
475/*
476 * If the initial chain is not trusted, do not attempt to build an alternative
477 * chain. Alternate chain checking was introduced in 1.1.0. Setting this flag
478 * will force the behaviour to match that of previous versions.
479 */
480#define X509_V_FLAG_NO_ALT_CHAINS 0x100000
481/* Do not check certificate/CRL validity against current time */
482#define X509_V_FLAG_NO_CHECK_TIME 0x200000
483
484/* Verify OCSP stapling response for server certificate */
485#define X509_V_FLAG_OCSP_RESP_CHECK 0x400000
486/* Verify OCSP stapling responses for whole chain */
487#define X509_V_FLAG_OCSP_RESP_CHECK_ALL 0x800000
488
489#define X509_VP_FLAG_DEFAULT 0x1
490#define X509_VP_FLAG_OVERWRITE 0x2
491#define X509_VP_FLAG_RESET_FLAGS 0x4
492#define X509_VP_FLAG_LOCKED 0x8
493#define X509_VP_FLAG_ONCE 0x10
494
495/* Internal use: mask of policy related options */
496#define X509_V_FLAG_POLICY_MASK (X509_V_FLAG_POLICY_CHECK \
497 | X509_V_FLAG_EXPLICIT_POLICY \
498 | X509_V_FLAG_INHIBIT_ANY \
499 | X509_V_FLAG_INHIBIT_MAP)
500
501int X509_OBJECT_idx_by_subject(STACK_OF(X509_OBJECT) *h, X509_LOOKUP_TYPE type,
502 const X509_NAME *name);
503X509_OBJECT *X509_OBJECT_retrieve_by_subject(STACK_OF(X509_OBJECT) *h,
504 X509_LOOKUP_TYPE type,
505 const X509_NAME *name);
506X509_OBJECT *X509_OBJECT_retrieve_match(STACK_OF(X509_OBJECT) *h,
507 X509_OBJECT *x);
508int X509_OBJECT_up_ref_count(X509_OBJECT *a);
509X509_OBJECT *X509_OBJECT_new(void);
510void X509_OBJECT_free(X509_OBJECT *a);
511X509_LOOKUP_TYPE X509_OBJECT_get_type(const X509_OBJECT *a);
512X509 *X509_OBJECT_get0_X509(const X509_OBJECT *a);
513int X509_OBJECT_set1_X509(X509_OBJECT *a, X509 *obj);
514X509_CRL *X509_OBJECT_get0_X509_CRL(const X509_OBJECT *a);
515int X509_OBJECT_set1_X509_CRL(X509_OBJECT *a, X509_CRL *obj);
516X509_STORE *X509_STORE_new(void);
517void X509_STORE_free(X509_STORE *xs);
518int X509_STORE_lock(X509_STORE *xs);
519int X509_STORE_unlock(X509_STORE *xs);
520int X509_STORE_up_ref(X509_STORE *xs);
521STACK_OF(X509_OBJECT) *X509_STORE_get0_objects(const X509_STORE *xs);
522STACK_OF(X509_OBJECT) *X509_STORE_get1_objects(X509_STORE *xs);
523STACK_OF(X509) *X509_STORE_get1_all_certs(X509_STORE *xs);
524STACK_OF(X509) *X509_STORE_CTX_get1_certs(X509_STORE_CTX *xs,
525 const X509_NAME *nm);
526STACK_OF(X509_CRL) *X509_STORE_CTX_get1_crls(const X509_STORE_CTX *st,
527 const X509_NAME *nm);
528int X509_STORE_set_flags(X509_STORE *xs, unsigned long flags);
529int X509_STORE_set_purpose(X509_STORE *xs, int purpose);
530int X509_STORE_set_trust(X509_STORE *xs, int trust);
531int X509_STORE_set1_param(X509_STORE *xs, const X509_VERIFY_PARAM *pm);
532X509_VERIFY_PARAM *X509_STORE_get0_param(const X509_STORE *xs);
533
534void X509_STORE_set_verify(X509_STORE *xs, X509_STORE_CTX_verify_fn verify);
535#define X509_STORE_set_verify_func(ctx, func) \
536 X509_STORE_set_verify((ctx), (func))
537void X509_STORE_CTX_set_verify(X509_STORE_CTX *ctx,
538 X509_STORE_CTX_verify_fn verify);
539X509_STORE_CTX_verify_fn X509_STORE_get_verify(const X509_STORE *xs);
540void X509_STORE_set_verify_cb(X509_STORE *xs,
541 X509_STORE_CTX_verify_cb verify_cb);
542#define X509_STORE_set_verify_cb_func(ctx, func) \
543 X509_STORE_set_verify_cb((ctx), (func))
544X509_STORE_CTX_verify_cb X509_STORE_get_verify_cb(const X509_STORE *xs);
545void X509_STORE_set_get_issuer(X509_STORE *xs,
546 X509_STORE_CTX_get_issuer_fn get_issuer);
547X509_STORE_CTX_get_issuer_fn X509_STORE_get_get_issuer(const X509_STORE *xs);
548void X509_STORE_set_check_issued(X509_STORE *xs,
549 X509_STORE_CTX_check_issued_fn check_issued);
550X509_STORE_CTX_check_issued_fn X509_STORE_get_check_issued(const X509_STORE *s);
551void X509_STORE_set_check_revocation(X509_STORE *xs,
552 X509_STORE_CTX_check_revocation_fn check_revocation);
553X509_STORE_CTX_check_revocation_fn
554X509_STORE_get_check_revocation(const X509_STORE *xs);
555void X509_STORE_set_get_crl(X509_STORE *xs,
556 X509_STORE_CTX_get_crl_fn get_crl);
557X509_STORE_CTX_get_crl_fn X509_STORE_get_get_crl(const X509_STORE *xs);
558void X509_STORE_set_check_crl(X509_STORE *xs,
559 X509_STORE_CTX_check_crl_fn check_crl);
560X509_STORE_CTX_check_crl_fn X509_STORE_get_check_crl(const X509_STORE *xs);
561void X509_STORE_set_cert_crl(X509_STORE *xs,
562 X509_STORE_CTX_cert_crl_fn cert_crl);
563X509_STORE_CTX_cert_crl_fn X509_STORE_get_cert_crl(const X509_STORE *xs);
564void X509_STORE_set_check_policy(X509_STORE *xs,
565 X509_STORE_CTX_check_policy_fn check_policy);
566X509_STORE_CTX_check_policy_fn X509_STORE_get_check_policy(const X509_STORE *s);
567void X509_STORE_set_lookup_certs(X509_STORE *xs,
568 X509_STORE_CTX_lookup_certs_fn lookup_certs);
569X509_STORE_CTX_lookup_certs_fn X509_STORE_get_lookup_certs(const X509_STORE *s);
570void X509_STORE_set_lookup_crls(X509_STORE *xs,
571 X509_STORE_CTX_lookup_crls_fn lookup_crls);
572#define X509_STORE_set_lookup_crls_cb(ctx, func) \
573 X509_STORE_set_lookup_crls((ctx), (func))
574X509_STORE_CTX_lookup_crls_fn X509_STORE_get_lookup_crls(const X509_STORE *xs);
575void X509_STORE_set_cleanup(X509_STORE *xs,
576 X509_STORE_CTX_cleanup_fn cleanup);
577X509_STORE_CTX_cleanup_fn X509_STORE_get_cleanup(const X509_STORE *xs);
578
579#define X509_STORE_get_ex_new_index(l, p, newf, dupf, freef) \
580 CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE, l, p, newf, dupf, freef)
581int X509_STORE_set_ex_data(X509_STORE *xs, int idx, void *data);
582void *X509_STORE_get_ex_data(const X509_STORE *xs, int idx);
583
584X509_STORE_CTX *X509_STORE_CTX_new_ex(OSSL_LIB_CTX *libctx, const char *propq);
585X509_STORE_CTX *X509_STORE_CTX_new(void);
586
587int X509_STORE_CTX_get1_issuer(X509 **issuer, X509_STORE_CTX *ctx, X509 *x);
588
589void X509_STORE_CTX_free(X509_STORE_CTX *ctx);
590int X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *trust_store,
591 X509 *target, STACK_OF(X509) *untrusted);
592int X509_STORE_CTX_init_rpk(X509_STORE_CTX *ctx, X509_STORE *trust_store,
593 EVP_PKEY *rpk);
594void X509_STORE_CTX_set0_trusted_stack(X509_STORE_CTX *ctx, STACK_OF(X509) *sk);
595void X509_STORE_CTX_cleanup(X509_STORE_CTX *ctx);
596
597X509_STORE *X509_STORE_CTX_get0_store(const X509_STORE_CTX *ctx);
598X509 *X509_STORE_CTX_get0_cert(const X509_STORE_CTX *ctx);
599EVP_PKEY *X509_STORE_CTX_get0_rpk(const X509_STORE_CTX *ctx);
600STACK_OF(X509) *X509_STORE_CTX_get0_untrusted(const X509_STORE_CTX *ctx);
601void X509_STORE_CTX_set0_untrusted(X509_STORE_CTX *ctx, STACK_OF(X509) *sk);
602void X509_STORE_CTX_set_verify_cb(X509_STORE_CTX *ctx,
603 X509_STORE_CTX_verify_cb verify);
604X509_STORE_CTX_verify_cb X509_STORE_CTX_get_verify_cb(const X509_STORE_CTX *ctx);
605X509_STORE_CTX_verify_fn X509_STORE_CTX_get_verify(const X509_STORE_CTX *ctx);
606X509_STORE_CTX_get_issuer_fn X509_STORE_CTX_get_get_issuer(const X509_STORE_CTX *ctx);
607X509_STORE_CTX_check_issued_fn X509_STORE_CTX_get_check_issued(const X509_STORE_CTX *ctx);
608X509_STORE_CTX_check_revocation_fn X509_STORE_CTX_get_check_revocation(const X509_STORE_CTX *ctx);
609void X509_STORE_CTX_set_get_crl(X509_STORE_CTX *ctx,
610 X509_STORE_CTX_get_crl_fn get_crl);
611X509_STORE_CTX_get_crl_fn X509_STORE_CTX_get_get_crl(const X509_STORE_CTX *ctx);
612X509_STORE_CTX_check_crl_fn X509_STORE_CTX_get_check_crl(const X509_STORE_CTX *ctx);
613X509_STORE_CTX_cert_crl_fn X509_STORE_CTX_get_cert_crl(const X509_STORE_CTX *ctx);
614X509_STORE_CTX_check_policy_fn X509_STORE_CTX_get_check_policy(const X509_STORE_CTX *ctx);
615X509_STORE_CTX_lookup_certs_fn X509_STORE_CTX_get_lookup_certs(const X509_STORE_CTX *ctx);
616X509_STORE_CTX_lookup_crls_fn X509_STORE_CTX_get_lookup_crls(const X509_STORE_CTX *ctx);
617X509_STORE_CTX_cleanup_fn X509_STORE_CTX_get_cleanup(const X509_STORE_CTX *ctx);
618
619#ifndef OPENSSL_NO_DEPRECATED_1_1_0
620#define X509_STORE_CTX_get_chain X509_STORE_CTX_get0_chain
621#define X509_STORE_CTX_set_chain X509_STORE_CTX_set0_untrusted
622#define X509_STORE_CTX_trusted_stack X509_STORE_CTX_set0_trusted_stack
623#define X509_STORE_get_by_subject X509_STORE_CTX_get_by_subject
624#define X509_STORE_get1_certs X509_STORE_CTX_get1_certs
625#define X509_STORE_get1_crls X509_STORE_CTX_get1_crls
626/* the following macro is misspelled; use X509_STORE_get1_certs instead */
627#define X509_STORE_get1_cert X509_STORE_CTX_get1_certs
628/* the following macro is misspelled; use X509_STORE_get1_crls instead */
629#define X509_STORE_get1_crl X509_STORE_CTX_get1_crls
630#endif
631
632X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *xs, X509_LOOKUP_METHOD *m);
633X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(void);
634X509_LOOKUP_METHOD *X509_LOOKUP_file(void);
635X509_LOOKUP_METHOD *X509_LOOKUP_store(void);
636
637typedef int (*X509_LOOKUP_ctrl_fn)(X509_LOOKUP *ctx, int cmd, const char *argc,
638 long argl, char **ret);
639typedef int (*X509_LOOKUP_ctrl_ex_fn)(
640 X509_LOOKUP *ctx, int cmd, const char *argc, long argl, char **ret,
641 OSSL_LIB_CTX *libctx, const char *propq);
642
643typedef int (*X509_LOOKUP_get_by_subject_fn)(X509_LOOKUP *ctx,
644 X509_LOOKUP_TYPE type,
645 const X509_NAME *name,
646 X509_OBJECT *ret);
647typedef int (*X509_LOOKUP_get_by_subject_ex_fn)(X509_LOOKUP *ctx,
648 X509_LOOKUP_TYPE type,
649 const X509_NAME *name,
650 X509_OBJECT *ret,
651 OSSL_LIB_CTX *libctx,
652 const char *propq);
653typedef int (*X509_LOOKUP_get_by_issuer_serial_fn)(X509_LOOKUP *ctx,
654 X509_LOOKUP_TYPE type,
655 const X509_NAME *name,
656 const ASN1_INTEGER *serial,
657 X509_OBJECT *ret);
658typedef int (*X509_LOOKUP_get_by_fingerprint_fn)(X509_LOOKUP *ctx,
659 X509_LOOKUP_TYPE type,
660 const unsigned char *bytes,
661 int len,
662 X509_OBJECT *ret);
663typedef int (*X509_LOOKUP_get_by_alias_fn)(X509_LOOKUP *ctx,
664 X509_LOOKUP_TYPE type,
665 const char *str,
666 int len,
667 X509_OBJECT *ret);
668
669X509_LOOKUP_METHOD *X509_LOOKUP_meth_new(const char *name);
670void X509_LOOKUP_meth_free(X509_LOOKUP_METHOD *method);
671
672int X509_LOOKUP_meth_set_new_item(X509_LOOKUP_METHOD *method,
673 int (*new_item)(X509_LOOKUP *ctx));
674int (*X509_LOOKUP_meth_get_new_item(const X509_LOOKUP_METHOD *method))(X509_LOOKUP *ctx);
675
676int X509_LOOKUP_meth_set_free(X509_LOOKUP_METHOD *method,
677 void (*free_fn)(X509_LOOKUP *ctx));
678void (*X509_LOOKUP_meth_get_free(const X509_LOOKUP_METHOD *method))(X509_LOOKUP *ctx);
679
680int X509_LOOKUP_meth_set_init(X509_LOOKUP_METHOD *method,
681 int (*init)(X509_LOOKUP *ctx));
682int (*X509_LOOKUP_meth_get_init(const X509_LOOKUP_METHOD *method))(X509_LOOKUP *ctx);
683
684int X509_LOOKUP_meth_set_shutdown(X509_LOOKUP_METHOD *method,
685 int (*shutdown)(X509_LOOKUP *ctx));
686int (*X509_LOOKUP_meth_get_shutdown(const X509_LOOKUP_METHOD *method))(X509_LOOKUP *ctx);
687
688int X509_LOOKUP_meth_set_ctrl(X509_LOOKUP_METHOD *method,
689 X509_LOOKUP_ctrl_fn ctrl_fn);
690X509_LOOKUP_ctrl_fn X509_LOOKUP_meth_get_ctrl(const X509_LOOKUP_METHOD *method);
691
692int X509_LOOKUP_meth_set_get_by_subject(X509_LOOKUP_METHOD *method,
693 X509_LOOKUP_get_by_subject_fn fn);
694X509_LOOKUP_get_by_subject_fn X509_LOOKUP_meth_get_get_by_subject(
695 const X509_LOOKUP_METHOD *method);
696
697int X509_LOOKUP_meth_set_get_by_issuer_serial(X509_LOOKUP_METHOD *method,
698 X509_LOOKUP_get_by_issuer_serial_fn fn);
699X509_LOOKUP_get_by_issuer_serial_fn X509_LOOKUP_meth_get_get_by_issuer_serial(
700 const X509_LOOKUP_METHOD *method);
701
702int X509_LOOKUP_meth_set_get_by_fingerprint(X509_LOOKUP_METHOD *method,
703 X509_LOOKUP_get_by_fingerprint_fn fn);
704X509_LOOKUP_get_by_fingerprint_fn X509_LOOKUP_meth_get_get_by_fingerprint(
705 const X509_LOOKUP_METHOD *method);
706
707int X509_LOOKUP_meth_set_get_by_alias(X509_LOOKUP_METHOD *method,
708 X509_LOOKUP_get_by_alias_fn fn);
709X509_LOOKUP_get_by_alias_fn X509_LOOKUP_meth_get_get_by_alias(
710 const X509_LOOKUP_METHOD *method);
711
712int X509_STORE_add_cert(X509_STORE *xs, X509 *x);
713int X509_STORE_add_crl(X509_STORE *xs, X509_CRL *x);
714
715int X509_STORE_CTX_get_by_subject(const X509_STORE_CTX *vs,
716 X509_LOOKUP_TYPE type,
717 const X509_NAME *name, X509_OBJECT *ret);
718X509_OBJECT *X509_STORE_CTX_get_obj_by_subject(X509_STORE_CTX *vs,
719 X509_LOOKUP_TYPE type,
720 const X509_NAME *name);
721
722int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc,
723 long argl, char **ret);
724int X509_LOOKUP_ctrl_ex(X509_LOOKUP *ctx, int cmd, const char *argc, long argl,
725 char **ret, OSSL_LIB_CTX *libctx, const char *propq);
726
727int X509_load_cert_file(X509_LOOKUP *ctx, const char *file, int type);
728int X509_load_cert_file_ex(X509_LOOKUP *ctx, const char *file, int type,
729 OSSL_LIB_CTX *libctx, const char *propq);
730int X509_load_crl_file(X509_LOOKUP *ctx, const char *file, int type);
731int X509_load_cert_crl_file(X509_LOOKUP *ctx, const char *file, int type);
732int X509_load_cert_crl_file_ex(X509_LOOKUP *ctx, const char *file, int type,
733 OSSL_LIB_CTX *libctx, const char *propq);
734
735X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method);
736void X509_LOOKUP_free(X509_LOOKUP *ctx);
737int X509_LOOKUP_init(X509_LOOKUP *ctx);
738int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
739 const X509_NAME *name, X509_OBJECT *ret);
740int X509_LOOKUP_by_subject_ex(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
741 const X509_NAME *name, X509_OBJECT *ret,
742 OSSL_LIB_CTX *libctx, const char *propq);
743int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
744 const X509_NAME *name,
745 const ASN1_INTEGER *serial,
746 X509_OBJECT *ret);
747int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
748 const unsigned char *bytes, int len,
749 X509_OBJECT *ret);
750int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
751 const char *str, int len, X509_OBJECT *ret);
752int X509_LOOKUP_set_method_data(X509_LOOKUP *ctx, void *data);
753void *X509_LOOKUP_get_method_data(const X509_LOOKUP *ctx);
754X509_STORE *X509_LOOKUP_get_store(const X509_LOOKUP *ctx);
755int X509_LOOKUP_shutdown(X509_LOOKUP *ctx);
756
757int X509_STORE_load_file(X509_STORE *xs, const char *file);
758int X509_STORE_load_path(X509_STORE *xs, const char *path);
759int X509_STORE_load_store(X509_STORE *xs, const char *store);
760int X509_STORE_load_locations(X509_STORE *s, const char *file, const char *dir);
761int X509_STORE_set_default_paths(X509_STORE *xs);
762
763int X509_STORE_load_file_ex(X509_STORE *xs, const char *file,
764 OSSL_LIB_CTX *libctx, const char *propq);
765int X509_STORE_load_store_ex(X509_STORE *xs, const char *store,
766 OSSL_LIB_CTX *libctx, const char *propq);
767int X509_STORE_load_locations_ex(X509_STORE *xs,
768 const char *file, const char *dir,
769 OSSL_LIB_CTX *libctx, const char *propq);
770int X509_STORE_set_default_paths_ex(X509_STORE *xs,
771 OSSL_LIB_CTX *libctx, const char *propq);
772
773#define X509_STORE_CTX_get_ex_new_index(l, p, newf, dupf, freef) \
774 CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE_CTX, l, p, newf, dupf, freef)
775int X509_STORE_CTX_set_ex_data(X509_STORE_CTX *ctx, int idx, void *data);
776void *X509_STORE_CTX_get_ex_data(const X509_STORE_CTX *ctx, int idx);
777int X509_STORE_CTX_get_error(const X509_STORE_CTX *ctx);
778void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx, int s);
779int X509_STORE_CTX_get_error_depth(const X509_STORE_CTX *ctx);
780void X509_STORE_CTX_set_error_depth(X509_STORE_CTX *ctx, int depth);
781X509 *X509_STORE_CTX_get_current_cert(const X509_STORE_CTX *ctx);
782void X509_STORE_CTX_set_current_cert(X509_STORE_CTX *ctx, X509 *x);
783X509 *X509_STORE_CTX_get0_current_issuer(const X509_STORE_CTX *ctx);
784X509_CRL *X509_STORE_CTX_get0_current_crl(const X509_STORE_CTX *ctx);
785X509_STORE_CTX *X509_STORE_CTX_get0_parent_ctx(const X509_STORE_CTX *ctx);
786STACK_OF(X509) *X509_STORE_CTX_get0_chain(const X509_STORE_CTX *ctx);
787STACK_OF(X509) *X509_STORE_CTX_get1_chain(const X509_STORE_CTX *ctx);
788void X509_STORE_CTX_set_cert(X509_STORE_CTX *ctx, X509 *target);
789void X509_STORE_CTX_set0_rpk(X509_STORE_CTX *ctx, EVP_PKEY *target);
790void X509_STORE_CTX_set0_verified_chain(X509_STORE_CTX *c, STACK_OF(X509) *sk);
791void X509_STORE_CTX_set0_crls(X509_STORE_CTX *ctx, STACK_OF(X509_CRL) *sk);
792#ifndef OPENSSL_NO_OCSP
793void X509_STORE_CTX_set_ocsp_resp(X509_STORE_CTX *ctx, STACK_OF(OCSP_RESPONSE) *sk);
794#endif
795int X509_STORE_CTX_set_purpose(X509_STORE_CTX *ctx, int purpose);
796int X509_STORE_CTX_set_trust(X509_STORE_CTX *ctx, int trust);
797int X509_STORE_CTX_purpose_inherit(X509_STORE_CTX *ctx, int def_purpose,
798 int purpose, int trust);
799void X509_STORE_CTX_set_flags(X509_STORE_CTX *ctx, unsigned long flags);
800void X509_STORE_CTX_set_time(X509_STORE_CTX *ctx, unsigned long flags,
801 time_t t);
802void X509_STORE_CTX_set_current_reasons(X509_STORE_CTX *ctx,
803 unsigned int current_reasons);
804
805X509_POLICY_TREE *X509_STORE_CTX_get0_policy_tree(const X509_STORE_CTX *ctx);
806int X509_STORE_CTX_get_explicit_policy(const X509_STORE_CTX *ctx);
807int X509_STORE_CTX_get_num_untrusted(const X509_STORE_CTX *ctx);
808
809X509_VERIFY_PARAM *X509_STORE_CTX_get0_param(const X509_STORE_CTX *ctx);
810void X509_STORE_CTX_set0_param(X509_STORE_CTX *ctx, X509_VERIFY_PARAM *param);
811int X509_STORE_CTX_set_default(X509_STORE_CTX *ctx, const char *name);
812
813/*
814 * Bridge opacity barrier between libcrypt and libssl, also needed to support
815 * offline testing in test/danetest.c
816 */
817void X509_STORE_CTX_set0_dane(X509_STORE_CTX *ctx, SSL_DANE *dane);
818#define DANE_FLAG_NO_DANE_EE_NAMECHECKS (1L << 0)
819
820/* X509_VERIFY_PARAM functions */
821
822X509_VERIFY_PARAM *X509_VERIFY_PARAM_new(void);
823void X509_VERIFY_PARAM_free(X509_VERIFY_PARAM *param);
824int X509_VERIFY_PARAM_inherit(X509_VERIFY_PARAM *to,
825 const X509_VERIFY_PARAM *from);
826int X509_VERIFY_PARAM_set1(X509_VERIFY_PARAM *to,
827 const X509_VERIFY_PARAM *from);
828int X509_VERIFY_PARAM_set1_name(X509_VERIFY_PARAM *param, const char *name);
829int X509_VERIFY_PARAM_set_flags(X509_VERIFY_PARAM *param,
830 unsigned long flags);
831int X509_VERIFY_PARAM_clear_flags(X509_VERIFY_PARAM *param,
832 unsigned long flags);
833unsigned long X509_VERIFY_PARAM_get_flags(const X509_VERIFY_PARAM *param);
834int X509_VERIFY_PARAM_set_purpose(X509_VERIFY_PARAM *param, int purpose);
835int X509_VERIFY_PARAM_get_purpose(const X509_VERIFY_PARAM *param);
836int X509_VERIFY_PARAM_set_trust(X509_VERIFY_PARAM *param, int trust);
837void X509_VERIFY_PARAM_set_depth(X509_VERIFY_PARAM *param, int depth);
838void X509_VERIFY_PARAM_set_auth_level(X509_VERIFY_PARAM *param, int auth_level);
839time_t X509_VERIFY_PARAM_get_time(const X509_VERIFY_PARAM *param);
840void X509_VERIFY_PARAM_set_time(X509_VERIFY_PARAM *param, time_t t);
841int X509_VERIFY_PARAM_add0_policy(X509_VERIFY_PARAM *param,
842 ASN1_OBJECT *policy);
843int X509_VERIFY_PARAM_set1_policies(X509_VERIFY_PARAM *param,
844 STACK_OF(ASN1_OBJECT) *policies);
845
846int X509_VERIFY_PARAM_set_inh_flags(X509_VERIFY_PARAM *param,
847 uint32_t flags);
848uint32_t X509_VERIFY_PARAM_get_inh_flags(const X509_VERIFY_PARAM *param);
849
850char *X509_VERIFY_PARAM_get0_host(X509_VERIFY_PARAM *param, int idx);
851int X509_VERIFY_PARAM_set1_host(X509_VERIFY_PARAM *param,
852 const char *name, size_t namelen);
853int X509_VERIFY_PARAM_add1_host(X509_VERIFY_PARAM *param,
854 const char *name, size_t namelen);
855void X509_VERIFY_PARAM_set_hostflags(X509_VERIFY_PARAM *param,
856 unsigned int flags);
857unsigned int X509_VERIFY_PARAM_get_hostflags(const X509_VERIFY_PARAM *param);
858char *X509_VERIFY_PARAM_get0_peername(const X509_VERIFY_PARAM *param);
859void X509_VERIFY_PARAM_move_peername(X509_VERIFY_PARAM *, X509_VERIFY_PARAM *);
860char *X509_VERIFY_PARAM_get0_email(X509_VERIFY_PARAM *param);
861int X509_VERIFY_PARAM_set1_email(X509_VERIFY_PARAM *param,
862 const char *email, size_t emaillen);
863char *X509_VERIFY_PARAM_get1_ip_asc(X509_VERIFY_PARAM *param);
864int X509_VERIFY_PARAM_set1_ip(X509_VERIFY_PARAM *param,
865 const unsigned char *ip, size_t iplen);
866int X509_VERIFY_PARAM_set1_ip_asc(X509_VERIFY_PARAM *param,
867 const char *ipasc);
868
869int X509_VERIFY_PARAM_get_depth(const X509_VERIFY_PARAM *param);
870int X509_VERIFY_PARAM_get_auth_level(const X509_VERIFY_PARAM *param);
871const char *X509_VERIFY_PARAM_get0_name(const X509_VERIFY_PARAM *param);
872
873int X509_VERIFY_PARAM_add0_table(X509_VERIFY_PARAM *param);
874int X509_VERIFY_PARAM_get_count(void);
875const X509_VERIFY_PARAM *X509_VERIFY_PARAM_get0(int id);
876const X509_VERIFY_PARAM *X509_VERIFY_PARAM_lookup(const char *name);
877void X509_VERIFY_PARAM_table_cleanup(void);
878
879/* Non positive return values are errors */
880#define X509_PCY_TREE_FAILURE -2 /* Failure to satisfy explicit policy */
881#define X509_PCY_TREE_INVALID -1 /* Inconsistent or invalid extensions */
882#define X509_PCY_TREE_INTERNAL 0 /* Internal error, most likely malloc */
883
884/*
885 * Positive return values form a bit mask, all but the first are internal to
886 * the library and don't appear in results from X509_policy_check().
887 */
888#define X509_PCY_TREE_VALID 1 /* The policy tree is valid */
889#define X509_PCY_TREE_EMPTY 2 /* The policy tree is empty */
890#define X509_PCY_TREE_EXPLICIT 4 /* Explicit policy required */
891
892int X509_policy_check(X509_POLICY_TREE **ptree, int *pexplicit_policy,
893 STACK_OF(X509) *certs,
894 STACK_OF(ASN1_OBJECT) *policy_oids, unsigned int flags);
895
896void X509_policy_tree_free(X509_POLICY_TREE *tree);
897
898int X509_policy_tree_level_count(const X509_POLICY_TREE *tree);
899X509_POLICY_LEVEL *X509_policy_tree_get0_level(const X509_POLICY_TREE *tree,
900 int i);
901
902STACK_OF(X509_POLICY_NODE)
903*X509_policy_tree_get0_policies(const X509_POLICY_TREE *tree);
904
905STACK_OF(X509_POLICY_NODE)
906*X509_policy_tree_get0_user_policies(const X509_POLICY_TREE *tree);
907
908int X509_policy_level_node_count(X509_POLICY_LEVEL *level);
909
910X509_POLICY_NODE *X509_policy_level_get0_node(const X509_POLICY_LEVEL *level,
911 int i);
912
913const ASN1_OBJECT *X509_policy_node_get0_policy(const X509_POLICY_NODE *node);
914
915STACK_OF(POLICYQUALINFO)
916*X509_policy_node_get0_qualifiers(const X509_POLICY_NODE *node);
917const X509_POLICY_NODE *X509_policy_node_get0_parent(const X509_POLICY_NODE *node);
918
919#ifdef __cplusplus
920}
921#endif
922#endif
923