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