]> git.ipfire.org Git - thirdparty/openssl.git/blame - apps/include/apps.h
Avoid overflowing FDSET when using select(2).
[thirdparty/openssl.git] / apps / include / apps.h
CommitLineData
846e33c7 1/*
39556e63 2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
a661b653 3 *
dffa7520 4 * Licensed under the Apache License 2.0 (the "License"). You may not use
846e33c7
RS
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
a661b653 8 */
d02b48c6
RE
9
10#ifndef HEADER_APPS_H
0f113f3e
MC
11# define HEADER_APPS_H
12
4cff10dc 13# include "e_os.h" /* struct timeval for DTLS */
07016a8a 14# include "internal/nelem.h"
3b061a00 15# include <assert.h>
0f113f3e 16
3e3c7c36 17# include <sys/types.h>
c7d5ea26
VD
18# ifndef OPENSSL_NO_POSIX_IO
19# include <sys/stat.h>
20# include <fcntl.h>
21# endif
22
568b8020 23# include <openssl/e_os2.h>
03f887ca 24# include <openssl/ossl_typ.h>
0f113f3e
MC
25# include <openssl/bio.h>
26# include <openssl/x509.h>
0f113f3e
MC
27# include <openssl/conf.h>
28# include <openssl/txt_db.h>
3c27208f
RS
29# include <openssl/engine.h>
30# include <openssl/ocsp.h>
1fbab1dc 31# include <signal.h>
a43ce58f
SL
32# include "apps_ui.h"
33# include "opt.h"
34# include "fmt.h"
ce506d27 35# include "platform.h"
d02b48c6 36
7e1b7485
RS
37# if defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_WINCE)
38# define openssl_fdset(a,b) FD_SET((unsigned int)a, b)
39# else
40# define openssl_fdset(a,b) FD_SET(a, b)
41# endif
42
18295f0c
RL
43/*
44 * quick macro when you need to pass an unsigned char instead of a char.
45 * this is true for some implementations of the is*() functions, for
46 * example.
47 */
48#define _UC(c) ((unsigned char)(c))
49
3ee1eac2
RS
50void app_RAND_load_conf(CONF *c, const char *section);
51void app_RAND_write(void);
a31011e8 52
d02b48c6 53extern char *default_config_file;
7e1b7485
RS
54extern BIO *bio_in;
55extern BIO *bio_out;
d02b48c6 56extern BIO *bio_err;
adfc3786
MC
57extern const unsigned char tls13_aes128gcmsha256_id[];
58extern const unsigned char tls13_aes256gcmsha384_id[];
10ee7246
MC
59extern BIO_ADDR *ourpeer;
60
39556e63
RL
61BIO_METHOD *apps_bf_prefix(void);
62/*
63 * The control used to set the prefix with BIO_ctrl()
64 * We make it high enough so the chance of ever clashing with the BIO library
65 * remains unlikely for the foreseeable future and beyond.
66 */
67#define PREFIX_CTRL_SET_PREFIX (1 << 15)
71bb86f0
RL
68/*
69 * apps_bf_prefix() returns a dynamically created BIO_METHOD, which we
70 * need to destroy at some point. When created internally, it's stored
71 * in an internal pointer which can be freed with the following function
72 */
73void destroy_prefix_method(void);
39556e63 74
a60994df
RL
75BIO *dup_bio_in(int format);
76BIO *dup_bio_out(int format);
149bd5d6 77BIO *dup_bio_err(int format);
bdd58d98
RL
78BIO *bio_open_owner(const char *filename, int format, int private);
79BIO *bio_open_default(const char *filename, char mode, int format);
80BIO *bio_open_default_quiet(const char *filename, char mode, int format);
bfa470a4 81CONF *app_load_config_bio(BIO *in, const char *filename);
296f54ee
RL
82CONF *app_load_config(const char *filename);
83CONF *app_load_config_quiet(const char *filename);
84int app_load_modules(const CONF *config);
7e1b7485 85void unbuffer(FILE *fp);
e1b9840e 86void wait_for_async(SSL *s);
75dd6c1a
MC
87# if defined(OPENSSL_SYS_MSDOS)
88int has_stdin_waiting(void);
89# endif
d02b48c6 90
a0754084 91void corrupt_signature(const ASN1_STRING *signature);
dc047d31
DSH
92int set_cert_times(X509 *x, const char *startdate, const char *enddate,
93 int days);
17ebf85a 94
0f113f3e 95typedef struct args_st {
7e1b7485
RS
96 int size;
97 int argc;
98 char **argv;
0f113f3e 99} ARGS;
7bf7333d 100
229446df
RS
101/* We need both wrap and the "real" function because libcrypto uses both. */
102int wrap_password_callback(char *buf, int bufsiz, int verify, void *cb_data);
2fe5adc3 103
7e1b7485 104int chopup_args(ARGS *arg, char *buf);
954ef7ef 105int dump_cert_text(BIO *out, X509 *x);
0f113f3e
MC
106void print_name(BIO *out, const char *title, X509_NAME *nm,
107 unsigned long lflags);
2ac6115d
RL
108void print_bignum_var(BIO *, const BIGNUM *, const char*,
109 int, unsigned char *);
7e1b7485 110void print_array(BIO *, const char *, int, const unsigned char *);
b5c4209b
DB
111int set_nameopt(const char *arg);
112unsigned long get_nameopt(void);
8ca533e3 113int set_cert_ex(unsigned long *flags, const char *arg);
a657546f 114int set_name_ex(unsigned long *flags, const char *arg);
791bd0cd
DSH
115int set_ext_copy(int *copy_type, const char *arg);
116int copy_extensions(X509 *x, X509_REQ *req, int copy_type);
cc696296 117int app_passwd(const char *arg1, const char *arg2, char **pass1, char **pass2);
7e1b7485 118int add_oid_section(CONF *conf);
a773b52a 119X509 *load_cert(const char *file, int format, const char *cert_descrip);
0090a686 120X509_CRL *load_crl(const char *infile, int format);
7e1b7485 121EVP_PKEY *load_key(const char *file, int format, int maybe_stdin,
0f113f3e 122 const char *pass, ENGINE *e, const char *key_descrip);
7e1b7485 123EVP_PKEY *load_pubkey(const char *file, int format, int maybe_stdin,
0f113f3e 124 const char *pass, ENGINE *e, const char *key_descrip);
0996dc54 125int load_certs(const char *file, STACK_OF(X509) **certs, int format,
a773b52a 126 const char *pass, const char *cert_descrip);
0996dc54 127int load_crls(const char *file, STACK_OF(X509_CRL) **crls, int format,
a773b52a 128 const char *pass, const char *cert_descrip);
cc696296 129X509_STORE *setup_verify(const char *CAfile, const char *CApath,
2b6bcb70 130 int noCAfile, int noCApath);
5da65ef2
RP
131__owur int ctx_set_verify_locations(SSL_CTX *ctx, const char *CAfile,
132 const char *CApath, int noCAfile,
133 int noCApath);
ca74c38d 134
b5369582
RP
135#ifndef OPENSSL_NO_CT
136
ca74c38d
RP
137/*
138 * Sets the file to load the Certificate Transparency log list from.
139 * If path is NULL, loads from the default file path.
140 * Returns 1 on success, 0 otherwise.
141 */
5da65ef2 142__owur int ctx_set_ctlog_list_file(SSL_CTX *ctx, const char *path);
dd696a55 143
b5369582
RP
144#endif
145
7e1b7485 146ENGINE *setup_engine(const char *engine, int debug);
dd1abd44 147void release_engine(ENGINE *e);
907c6c86 148
0f113f3e 149# ifndef OPENSSL_NO_OCSP
7e1b7485 150OCSP_RESPONSE *process_responder(OCSP_REQUEST *req,
0f113f3e
MC
151 const char *host, const char *path,
152 const char *port, int use_ssl,
82c49427 153 STACK_OF(CONF_VALUE) *headers,
0f113f3e
MC
154 int req_timeout);
155# endif
67c8e7f4 156
ee306a13
DSH
157/* Functions defined in ca.c and also used in ocsp.c */
158int unpack_revinfo(ASN1_TIME **prevtm, int *preason, ASN1_OBJECT **phold,
0f113f3e
MC
159 ASN1_GENERALIZEDTIME **pinvtm, const char *str);
160
161# define DB_type 0
162# define DB_exp_date 1
163# define DB_rev_date 2
164# define DB_serial 3 /* index - unique */
165# define DB_file 4
166# define DB_name 5 /* index - unique when active and not
167 * disabled */
168# define DB_NUMBER 6
169
06a79af2
F
170# define DB_TYPE_REV 'R' /* Revoked */
171# define DB_TYPE_EXP 'E' /* Expired */
172# define DB_TYPE_VAL 'V' /* Valid ; inserted with: ca ... -valid */
173# define DB_TYPE_SUSP 'S' /* Suspended */
0f113f3e
MC
174
175typedef struct db_attr_st {
176 int unique_subject;
177} DB_ATTR;
178typedef struct ca_db_st {
179 DB_ATTR attributes;
180 TXT_DB *db;
c7d5ea26
VD
181 char *dbfname;
182# ifndef OPENSSL_NO_POSIX_IO
183 struct stat dbst;
184# endif
0f113f3e 185} CA_DB;
f85b68cd 186
68dc6824 187void* app_malloc(int sz, const char *what);
cc696296
F
188BIGNUM *load_serial(const char *serialfile, int create, ASN1_INTEGER **retai);
189int save_serial(const char *serialfile, const char *suffix, const BIGNUM *serial,
0f113f3e 190 ASN1_INTEGER **retai);
cc696296
F
191int rotate_serial(const char *serialfile, const char *new_suffix,
192 const char *old_suffix);
64674bcc 193int rand_serial(BIGNUM *b, ASN1_INTEGER *ai);
cc696296 194CA_DB *load_index(const char *dbfile, DB_ATTR *dbattr);
f85b68cd 195int index_index(CA_DB *db);
7d727231 196int save_index(const char *dbfile, const char *suffix, CA_DB *db);
0f113f3e
MC
197int rotate_index(const char *dbfile, const char *new_suffix,
198 const char *old_suffix);
f85b68cd 199void free_index(CA_DB *db);
0f113f3e
MC
200# define index_name_cmp_noconst(a, b) \
201 index_name_cmp((const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, a), \
202 (const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, b))
c869da88 203int index_name_cmp(const OPENSSL_CSTRING *a, const OPENSSL_CSTRING *b);
ff990440 204int parse_yesno(const char *str, int def);
ee306a13 205
db4c08f0 206X509_NAME *parse_name(const char *str, long chtype, int multirdn);
ecf3a1fb 207void policies_print(X509_STORE_CTX *ctx);
a9164153 208int bio_to_mem(unsigned char **out, int maxlen, BIO *in);
0c20802c 209int pkey_ctrl_string(EVP_PKEY_CTX *ctx, const char *value);
7e1b7485 210int init_gen_str(EVP_PKEY_CTX **pctx,
0f113f3e 211 const char *algname, ENGINE *e, int do_param);
7e1b7485 212int do_X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md,
0f113f3e 213 STACK_OF(OPENSSL_STRING) *sigopts);
7e1b7485 214int do_X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md,
0f113f3e 215 STACK_OF(OPENSSL_STRING) *sigopts);
7e1b7485 216int do_X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md,
0f113f3e 217 STACK_OF(OPENSSL_STRING) *sigopts);
14e35350 218
f3b7bdad 219extern char *psk_key;
14e35350 220
eee6c81a 221
817cd0d5 222unsigned char *next_protos_parse(size_t *outlen, const char *in);
71fa4513 223
a70da5b3 224void print_cert_checks(BIO *bio, X509 *x,
0f113f3e
MC
225 const char *checkhost,
226 const char *checkemail, const char *checkip);
a70da5b3 227
0090a686
DSH
228void store_setup_crl_download(X509_STORE *st);
229
0f113f3e
MC
230# define EXT_COPY_NONE 0
231# define EXT_COPY_ADD 1
232# define EXT_COPY_ALL 2
233
234# define NETSCAPE_CERT_HDR "certificate"
235
236# define APP_PASS_LEN 1024
237
ffb46830
RS
238/*
239 * IETF RFC 5280 says serial number must be <= 20 bytes. Use 159 bits
240 * so that the first bit will never be one, so that the DER encoding
241 * rules won't force a leading octet.
242 */
243# define SERIAL_RAND_BITS 159
64674bcc 244
ffa10187 245int app_isdir(const char *);
7e1b7485 246int app_access(const char *, int flag);
51e5133d
RL
247int fileno_stdin(void);
248int fileno_stdout(void);
0f113f3e
MC
249int raw_read_stdin(void *, int);
250int raw_write_stdout(const void *, int);
0a39d8f2 251
0f113f3e
MC
252# define TM_START 0
253# define TM_STOP 1
254double app_tminterval(int stop, int usertime);
ee2ffc27 255
20967afb
RS
256void make_uppercase(char *string);
257
acc00492
F
258typedef struct verify_options_st {
259 int depth;
260 int quiet;
261 int error;
262 int return_error;
263} VERIFY_CB_ARGS;
264
265extern VERIFY_CB_ARGS verify_args;
df2ee0e2 266
ee2ffc27 267#endif