1/* 2 * Copyright 1995-2022 The OpenSSL Project Authors. All Rights Reserved. 3 * 4 * Licensed under the OpenSSL license (the "License"). You may not use 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 8 */ 9 10#ifndef OSSL_APPS_H 11# define OSSL_APPS_H 12 13# include "e_os.h" /* struct timeval for DTLS */ 14# include "internal/nelem.h" 15# include <assert.h> 16 17# include <sys/types.h> 18# ifndef OPENSSL_NO_POSIX_IO 19# include <sys/stat.h> 20# include <fcntl.h> 21# endif 22 23# include <openssl/e_os2.h> 24# include <openssl/ossl_typ.h> 25# include <openssl/bio.h> 26# include <openssl/x509.h> 27# include <openssl/conf.h> 28# include <openssl/txt_db.h> 29# include <openssl/engine.h> 30# include <openssl/ocsp.h> 31# include <signal.h> 32 33# if defined(OPENSSL_SYS_WIN32) || defined(OPENSSL_SYS_WINCE) 34# define openssl_fdset(a,b) FD_SET((unsigned int)a, b) 35# else 36# define openssl_fdset(a,b) FD_SET(a, b) 37# endif 38 39/* 40 * quick macro when you need to pass an unsigned char instead of a char. 41 * this is true for some implementations of the is*() functions, for 42 * example. 43 */ 44#define _UC(c) ((unsigned char)(c)) 45 46void app_RAND_load_conf(CONF *c, const char *section); 47void app_RAND_write(void); 48 49extern char *default_config_file; 50extern BIO *bio_in; 51extern BIO *bio_out; 52extern BIO *bio_err; 53extern const unsigned char tls13_aes128gcmsha256_id[]; 54extern const unsigned char tls13_aes256gcmsha384_id[]; 55extern BIO_ADDR *ourpeer; 56 57BIO_METHOD *apps_bf_prefix(void); 58/* 59 * The control used to set the prefix with BIO_ctrl() 60 * We make it high enough so the chance of ever clashing with the BIO library 61 * remains unlikely for the foreseeable future and beyond. 62 */ 63#define PREFIX_CTRL_SET_PREFIX (1 << 15) 64/* 65 * apps_bf_prefix() returns a dynamically created BIO_METHOD, which we 66 * need to destroy at some point. When created internally, it's stored 67 * in an internal pointer which can be freed with the following function 68 */ 69void destroy_prefix_method(void); 70 71BIO *dup_bio_in(int format); 72BIO *dup_bio_out(int format); 73BIO *dup_bio_err(int format); 74BIO *bio_open_owner(const char *filename, int format, int private); 75BIO *bio_open_default(const char *filename, char mode, int format); 76BIO *bio_open_default_quiet(const char *filename, char mode, int format); 77CONF *app_load_config_bio(BIO *in, const char *filename); 78CONF *app_load_config(const char *filename); 79CONF *app_load_config_quiet(const char *filename); 80int app_load_modules(const CONF *config); 81void unbuffer(FILE *fp); 82void wait_for_async(SSL *s); 83# if defined(OPENSSL_SYS_MSDOS) 84int has_stdin_waiting(void); 85# endif 86 87void corrupt_signature(const ASN1_STRING *signature); 88int set_cert_times(X509 *x, const char *startdate, const char *enddate, 89 int days); 90 91/* 92 * Common verification options. 93 */ 94# define OPT_V_ENUM \ 95 OPT_V__FIRST=2000, \ 96 OPT_V_POLICY, OPT_V_PURPOSE, OPT_V_VERIFY_NAME, OPT_V_VERIFY_DEPTH, \ 97 OPT_V_ATTIME, OPT_V_VERIFY_HOSTNAME, OPT_V_VERIFY_EMAIL, \ 98 OPT_V_VERIFY_IP, OPT_V_IGNORE_CRITICAL, OPT_V_ISSUER_CHECKS, \ 99 OPT_V_CRL_CHECK, OPT_V_CRL_CHECK_ALL, OPT_V_POLICY_CHECK, \ 100 OPT_V_EXPLICIT_POLICY, OPT_V_INHIBIT_ANY, OPT_V_INHIBIT_MAP, \ 101 OPT_V_X509_STRICT, OPT_V_EXTENDED_CRL, OPT_V_USE_DELTAS, \ 102 OPT_V_POLICY_PRINT, OPT_V_CHECK_SS_SIG, OPT_V_TRUSTED_FIRST, \ 103 OPT_V_SUITEB_128_ONLY, OPT_V_SUITEB_128, OPT_V_SUITEB_192, \ 104 OPT_V_PARTIAL_CHAIN, OPT_V_NO_ALT_CHAINS, OPT_V_NO_CHECK_TIME, \ 105 OPT_V_VERIFY_AUTH_LEVEL, OPT_V_ALLOW_PROXY_CERTS, \ 106 OPT_V__LAST 107 108# define OPT_V_OPTIONS \ 109 { "policy", OPT_V_POLICY, 's', "adds policy to the acceptable policy set"}, \ 110 { "purpose", OPT_V_PURPOSE, 's', \ 111 "certificate chain purpose"}, \ 112 { "verify_name", OPT_V_VERIFY_NAME, 's', "verification policy name"}, \ 113 { "verify_depth", OPT_V_VERIFY_DEPTH, 'n', \ 114 "chain depth limit" }, \ 115 { "auth_level", OPT_V_VERIFY_AUTH_LEVEL, 'n', \ 116 "chain authentication security level" }, \ 117 { "attime", OPT_V_ATTIME, 'M', "verification epoch time" }, \ 118 { "verify_hostname", OPT_V_VERIFY_HOSTNAME, 's', \ 119 "expected peer hostname" }, \ 120 { "verify_email", OPT_V_VERIFY_EMAIL, 's', \ 121 "expected peer email" }, \ 122 { "verify_ip", OPT_V_VERIFY_IP, 's', \ 123 "expected peer IP address" }, \ 124 { "ignore_critical", OPT_V_IGNORE_CRITICAL, '-', \ 125 "permit unhandled critical extensions"}, \ 126 { "issuer_checks", OPT_V_ISSUER_CHECKS, '-', "(deprecated)"}, \ 127 { "crl_check", OPT_V_CRL_CHECK, '-', "check leaf certificate revocation" }, \ 128 { "crl_check_all", OPT_V_CRL_CHECK_ALL, '-', "check full chain revocation" }, \ 129 { "policy_check", OPT_V_POLICY_CHECK, '-', "perform rfc5280 policy checks"}, \ 130 { "explicit_policy", OPT_V_EXPLICIT_POLICY, '-', \ 131 "set policy variable require-explicit-policy"}, \ 132 { "inhibit_any", OPT_V_INHIBIT_ANY, '-', \ 133 "set policy variable inhibit-any-policy"}, \ 134 { "inhibit_map", OPT_V_INHIBIT_MAP, '-', \ 135 "set policy variable inhibit-policy-mapping"}, \ 136 { "x509_strict", OPT_V_X509_STRICT, '-', \ 137 "disable certificate compatibility work-arounds"}, \ 138 { "extended_crl", OPT_V_EXTENDED_CRL, '-', \ 139 "enable extended CRL features"}, \ 140 { "use_deltas", OPT_V_USE_DELTAS, '-', \ 141 "use delta CRLs"}, \ 142 { "policy_print", OPT_V_POLICY_PRINT, '-', \ 143 "print policy processing diagnostics"}, \ 144 { "check_ss_sig", OPT_V_CHECK_SS_SIG, '-', \ 145 "check root CA self-signatures"}, \ 146 { "trusted_first", OPT_V_TRUSTED_FIRST, '-', \ 147 "search trust store first (default)" }, \ 148 { "suiteB_128_only", OPT_V_SUITEB_128_ONLY, '-', "Suite B 128-bit-only mode"}, \ 149 { "suiteB_128", OPT_V_SUITEB_128, '-', \ 150 "Suite B 128-bit mode allowing 192-bit algorithms"}, \ 151 { "suiteB_192", OPT_V_SUITEB_192, '-', "Suite B 192-bit-only mode" }, \ 152 { "partial_chain", OPT_V_PARTIAL_CHAIN, '-', \ 153 "accept chains anchored by intermediate trust-store CAs"}, \ 154 { "no_alt_chains", OPT_V_NO_ALT_CHAINS, '-', "(deprecated)" }, \ 155 { "no_check_time", OPT_V_NO_CHECK_TIME, '-', "ignore certificate validity time" }, \ 156 { "allow_proxy_certs", OPT_V_ALLOW_PROXY_CERTS, '-', "allow the use of proxy certificates" } 157 158# define OPT_V_CASES \ 159 OPT_V__FIRST: case OPT_V__LAST: break; \ 160 case OPT_V_POLICY: \ 161 case OPT_V_PURPOSE: \ 162 case OPT_V_VERIFY_NAME: \ 163 case OPT_V_VERIFY_DEPTH: \ 164 case OPT_V_VERIFY_AUTH_LEVEL: \ 165 case OPT_V_ATTIME: \ 166 case OPT_V_VERIFY_HOSTNAME: \ 167 case OPT_V_VERIFY_EMAIL: \ 168 case OPT_V_VERIFY_IP: \ 169 case OPT_V_IGNORE_CRITICAL: \ 170 case OPT_V_ISSUER_CHECKS: \ 171 case OPT_V_CRL_CHECK: \ 172 case OPT_V_CRL_CHECK_ALL: \ 173 case OPT_V_POLICY_CHECK: \ 174 case OPT_V_EXPLICIT_POLICY: \ 175 case OPT_V_INHIBIT_ANY: \ 176 case OPT_V_INHIBIT_MAP: \ 177 case OPT_V_X509_STRICT: \ 178 case OPT_V_EXTENDED_CRL: \ 179 case OPT_V_USE_DELTAS: \ 180 case OPT_V_POLICY_PRINT: \ 181 case OPT_V_CHECK_SS_SIG: \ 182 case OPT_V_TRUSTED_FIRST: \ 183 case OPT_V_SUITEB_128_ONLY: \ 184 case OPT_V_SUITEB_128: \ 185 case OPT_V_SUITEB_192: \ 186 case OPT_V_PARTIAL_CHAIN: \ 187 case OPT_V_NO_ALT_CHAINS: \ 188 case OPT_V_NO_CHECK_TIME: \ 189 case OPT_V_ALLOW_PROXY_CERTS 190 191/* 192 * Common "extended validation" options. 193 */ 194# define OPT_X_ENUM \ 195 OPT_X__FIRST=1000, \ 196 OPT_X_KEY, OPT_X_CERT, OPT_X_CHAIN, OPT_X_CHAIN_BUILD, \ 197 OPT_X_CERTFORM, OPT_X_KEYFORM, \ 198 OPT_X__LAST 199 200# define OPT_X_OPTIONS \ 201 { "xkey", OPT_X_KEY, '<', "key for Extended certificates"}, \ 202 { "xcert", OPT_X_CERT, '<', "cert for Extended certificates"}, \ 203 { "xchain", OPT_X_CHAIN, '<', "chain for Extended certificates"}, \ 204 { "xchain_build", OPT_X_CHAIN_BUILD, '-', \ 205 "build certificate chain for the extended certificates"}, \ 206 { "xcertform", OPT_X_CERTFORM, 'F', \ 207 "format of Extended certificate (PEM or DER) PEM default " }, \ 208 { "xkeyform", OPT_X_KEYFORM, 'F', \ 209 "format of Extended certificate's key (PEM or DER) PEM default"} 210 211# define OPT_X_CASES \ 212 OPT_X__FIRST: case OPT_X__LAST: break; \ 213 case OPT_X_KEY: \ 214 case OPT_X_CERT: \ 215 case OPT_X_CHAIN: \ 216 case OPT_X_CHAIN_BUILD: \ 217 case OPT_X_CERTFORM: \ 218 case OPT_X_KEYFORM 219 220/* 221 * Common SSL options. 222 * Any changes here must be coordinated with ../ssl/ssl_conf.c 223 */ 224# define OPT_S_ENUM \ 225 OPT_S__FIRST=3000, \ 226 OPT_S_NOSSL3, OPT_S_NOTLS1, OPT_S_NOTLS1_1, OPT_S_NOTLS1_2, \ 227 OPT_S_NOTLS1_3, OPT_S_BUGS, OPT_S_NO_COMP, OPT_S_NOTICKET, \ 228 OPT_S_SERVERPREF, OPT_S_LEGACYRENEG, OPT_S_LEGACYCONN, \ 229 OPT_S_ONRESUMP, OPT_S_NOLEGACYCONN, OPT_S_ALLOW_NO_DHE_KEX, \ 230 OPT_S_PRIORITIZE_CHACHA, \ 231 OPT_S_STRICT, OPT_S_SIGALGS, OPT_S_CLIENTSIGALGS, OPT_S_GROUPS, \ 232 OPT_S_CURVES, OPT_S_NAMEDCURVE, OPT_S_CIPHER, OPT_S_CIPHERSUITES, \ 233 OPT_S_RECORD_PADDING, OPT_S_DEBUGBROKE, OPT_S_COMP, \ 234 OPT_S_MINPROTO, OPT_S_MAXPROTO, \ 235 OPT_S_NO_RENEGOTIATION, OPT_S_NO_MIDDLEBOX, OPT_S__LAST 236 237# define OPT_S_OPTIONS \ 238 {"no_ssl3", OPT_S_NOSSL3, '-',"Just disable SSLv3" }, \ 239 {"no_tls1", OPT_S_NOTLS1, '-', "Just disable TLSv1"}, \ 240 {"no_tls1_1", OPT_S_NOTLS1_1, '-', "Just disable TLSv1.1" }, \ 241 {"no_tls1_2", OPT_S_NOTLS1_2, '-', "Just disable TLSv1.2"}, \ 242 {"no_tls1_3", OPT_S_NOTLS1_3, '-', "Just disable TLSv1.3"}, \ 243 {"bugs", OPT_S_BUGS, '-', "Turn on SSL bug compatibility"}, \ 244 {"no_comp", OPT_S_NO_COMP, '-', "Disable SSL/TLS compression (default)" }, \ 245 {"comp", OPT_S_COMP, '-', "Use SSL/TLS-level compression" }, \ 246 {"no_ticket", OPT_S_NOTICKET, '-', \ 247 "Disable use of TLS session tickets"}, \ 248 {"serverpref", OPT_S_SERVERPREF, '-', "Use server's cipher preferences"}, \ 249 {"legacy_renegotiation", OPT_S_LEGACYRENEG, '-', \ 250 "Enable use of legacy renegotiation (dangerous)"}, \ 251 {"no_renegotiation", OPT_S_NO_RENEGOTIATION, '-', \ 252 "Disable all renegotiation."}, \ 253 {"legacy_server_connect", OPT_S_LEGACYCONN, '-', \ 254 "Allow initial connection to servers that don't support RI"}, \ 255 {"no_resumption_on_reneg", OPT_S_ONRESUMP, '-', \ 256 "Disallow session resumption on renegotiation"}, \ 257 {"no_legacy_server_connect", OPT_S_NOLEGACYCONN, '-', \ 258 "Disallow initial connection to servers that don't support RI"}, \ 259 {"allow_no_dhe_kex", OPT_S_ALLOW_NO_DHE_KEX, '-', \ 260 "In TLSv1.3 allow non-(ec)dhe based key exchange on resumption"}, \ 261 {"prioritize_chacha", OPT_S_PRIORITIZE_CHACHA, '-', \ 262 "Prioritize ChaCha ciphers when preferred by clients"}, \ 263 {"strict", OPT_S_STRICT, '-', \ 264 "Enforce strict certificate checks as per TLS standard"}, \ 265 {"sigalgs", OPT_S_SIGALGS, 's', \ 266 "Signature algorithms to support (colon-separated list)" }, \ 267 {"client_sigalgs", OPT_S_CLIENTSIGALGS, 's', \ 268 "Signature algorithms to support for client certificate" \ 269 " authentication (colon-separated list)" }, \ 270 {"groups", OPT_S_GROUPS, 's', \ 271 "Groups to advertise (colon-separated list)" }, \ 272 {"curves", OPT_S_CURVES, 's', \ 273 "Groups to advertise (colon-separated list)" }, \ 274 {"named_curve", OPT_S_NAMEDCURVE, 's', \ 275 "Elliptic curve used for ECDHE (server-side only)" }, \ 276 {"cipher", OPT_S_CIPHER, 's', "Specify TLSv1.2 and below cipher list to be used"}, \ 277 {"ciphersuites", OPT_S_CIPHERSUITES, 's', "Specify TLSv1.3 ciphersuites to be used"}, \ 278 {"min_protocol", OPT_S_MINPROTO, 's', "Specify the minimum protocol version to be used"}, \ 279 {"max_protocol", OPT_S_MAXPROTO, 's', "Specify the maximum protocol version to be used"}, \ 280 {"record_padding", OPT_S_RECORD_PADDING, 's', \ 281 "Block size to pad TLS 1.3 records to."}, \ 282 {"debug_broken_protocol", OPT_S_DEBUGBROKE, '-', \ 283 "Perform all sorts of protocol violations for testing purposes"}, \ 284 {"no_middlebox", OPT_S_NO_MIDDLEBOX, '-', \ 285 "Disable TLSv1.3 middlebox compat mode" } 286 287# define OPT_S_CASES \ 288 OPT_S__FIRST: case OPT_S__LAST: break; \ 289 case OPT_S_NOSSL3: \ 290 case OPT_S_NOTLS1: \ 291 case OPT_S_NOTLS1_1: \ 292 case OPT_S_NOTLS1_2: \ 293 case OPT_S_NOTLS1_3: \ 294 case OPT_S_BUGS: \ 295 case OPT_S_NO_COMP: \ 296 case OPT_S_COMP: \ 297 case OPT_S_NOTICKET: \ 298 case OPT_S_SERVERPREF: \ 299 case OPT_S_LEGACYRENEG: \ 300 case OPT_S_LEGACYCONN: \ 301 case OPT_S_ONRESUMP: \ 302 case OPT_S_NOLEGACYCONN: \ 303 case OPT_S_ALLOW_NO_DHE_KEX: \ 304 case OPT_S_PRIORITIZE_CHACHA: \ 305 case OPT_S_STRICT: \ 306 case OPT_S_SIGALGS: \ 307 case OPT_S_CLIENTSIGALGS: \ 308 case OPT_S_GROUPS: \ 309 case OPT_S_CURVES: \ 310 case OPT_S_NAMEDCURVE: \ 311 case OPT_S_CIPHER: \ 312 case OPT_S_CIPHERSUITES: \ 313 case OPT_S_RECORD_PADDING: \ 314 case OPT_S_NO_RENEGOTIATION: \ 315 case OPT_S_MINPROTO: \ 316 case OPT_S_MAXPROTO: \ 317 case OPT_S_DEBUGBROKE: \ 318 case OPT_S_NO_MIDDLEBOX 319 320#define IS_NO_PROT_FLAG(o) \ 321 (o == OPT_S_NOSSL3 || o == OPT_S_NOTLS1 || o == OPT_S_NOTLS1_1 \ 322 || o == OPT_S_NOTLS1_2 || o == OPT_S_NOTLS1_3) 323 324/* 325 * Random state options. 326 */ 327# define OPT_R_ENUM \ 328 OPT_R__FIRST=1500, OPT_R_RAND, OPT_R_WRITERAND, OPT_R__LAST 329 330# define OPT_R_OPTIONS \ 331 {"rand", OPT_R_RAND, 's', "Load the file(s) into the random number generator"}, \ 332 {"writerand", OPT_R_WRITERAND, '>', "Write random data to the specified file"} 333 334# define OPT_R_CASES \ 335 OPT_R__FIRST: case OPT_R__LAST: break; \ 336 case OPT_R_RAND: case OPT_R_WRITERAND 337 338/* 339 * Option parsing. 340 */ 341extern const char OPT_HELP_STR[]; 342extern const char OPT_MORE_STR[]; 343typedef struct options_st { 344 const char *name; 345 int retval; 346 /* 347 * value type: - no value (also the value zero), n number, p positive 348 * number, u unsigned, l long, s string, < input file, > output file, 349 * f any format, F der/pem format, E der/pem/engine format identifier. 350 * l, n and u include zero; p does not. 351 */ 352 int valtype; 353 const char *helpstr; 354} OPTIONS; 355 356/* 357 * A string/int pairing; widely use for option value lookup, hence the 358 * name OPT_PAIR. But that name is misleading in s_cb.c, so we also use 359 * the "generic" name STRINT_PAIR. 360 */ 361typedef struct string_int_pair_st { 362 const char *name; 363 int retval; 364} OPT_PAIR, STRINT_PAIR; 365 366/* Flags to pass into opt_format; see FORMAT_xxx, below. */ 367# define OPT_FMT_PEMDER (1L << 1) 368# define OPT_FMT_PKCS12 (1L << 2) 369# define OPT_FMT_SMIME (1L << 3) 370# define OPT_FMT_ENGINE (1L << 4) 371# define OPT_FMT_MSBLOB (1L << 5) 372/* (1L << 6) was OPT_FMT_NETSCAPE, but wasn't used */ 373# define OPT_FMT_NSS (1L << 7) 374# define OPT_FMT_TEXT (1L << 8) 375# define OPT_FMT_HTTP (1L << 9) 376# define OPT_FMT_PVK (1L << 10) 377# define OPT_FMT_PDE (OPT_FMT_PEMDER | OPT_FMT_ENGINE) 378# define OPT_FMT_PDS (OPT_FMT_PEMDER | OPT_FMT_SMIME) 379# define OPT_FMT_ANY ( \ 380 OPT_FMT_PEMDER | OPT_FMT_PKCS12 | OPT_FMT_SMIME | \ 381 OPT_FMT_ENGINE | OPT_FMT_MSBLOB | OPT_FMT_NSS | \ 382 OPT_FMT_TEXT | OPT_FMT_HTTP | OPT_FMT_PVK) 383 384char *opt_progname(const char *argv0); 385char *opt_getprog(void); 386char *opt_init(int ac, char **av, const OPTIONS * o); 387int opt_next(void); 388int opt_format(const char *s, unsigned long flags, int *result); 389int opt_int(const char *arg, int *result); 390int opt_ulong(const char *arg, unsigned long *result); 391int opt_long(const char *arg, long *result); 392#if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L && \ 393 defined(INTMAX_MAX) && defined(UINTMAX_MAX) 394int opt_imax(const char *arg, intmax_t *result); 395int opt_umax(const char *arg, uintmax_t *result); 396#else 397# define opt_imax opt_long 398# define opt_umax opt_ulong 399# define intmax_t long 400# define uintmax_t unsigned long 401#endif 402int opt_pair(const char *arg, const OPT_PAIR * pairs, int *result); 403int opt_cipher(const char *name, const EVP_CIPHER **cipherp); 404int opt_md(const char *name, const EVP_MD **mdp); 405char *opt_arg(void); 406char *opt_flag(void); 407char *opt_unknown(void); 408char **opt_rest(void); 409int opt_num_rest(void); 410int opt_verify(int i, X509_VERIFY_PARAM *vpm); 411int opt_rand(int i); 412void opt_help(const OPTIONS * list); 413int opt_format_error(const char *s, unsigned long flags); 414 415typedef struct args_st { 416 int size; 417 int argc; 418 char **argv; 419} ARGS; 420 421/* 422 * VMS C only for now, implemented in vms_decc_init.c 423 * If other C compilers forget to terminate argv with NULL, this function 424 * can be re-used. 425 */ 426char **copy_argv(int *argc, char *argv[]); 427/* 428 * Win32-specific argv initialization that splits OS-supplied UNICODE 429 * command line string to array of UTF8-encoded strings. 430 */ 431void win32_utf8argv(int *argc, char **argv[]); 432 433 434# define PW_MIN_LENGTH 4 435typedef struct pw_cb_data { 436 const void *password; 437 const char *prompt_info; 438} PW_CB_DATA; 439 440int password_callback(char *buf, int bufsiz, int verify, PW_CB_DATA *cb_data); 441 442int setup_ui_method(void); 443void destroy_ui_method(void); 444const UI_METHOD *get_ui_method(void); 445 446int chopup_args(ARGS *arg, char *buf); 447int dump_cert_text(BIO *out, X509 *x); 448void print_name(BIO *out, const char *title, X509_NAME *nm, 449 unsigned long lflags); 450void print_bignum_var(BIO *, const BIGNUM *, const char*, 451 int, unsigned char *); 452void print_array(BIO *, const char *, int, const unsigned char *); 453int set_nameopt(const char *arg); 454unsigned long get_nameopt(void); 455int set_cert_ex(unsigned long *flags, const char *arg); 456int set_name_ex(unsigned long *flags, const char *arg); 457int set_ext_copy(int *copy_type, const char *arg); 458int copy_extensions(X509 *x, X509_REQ *req, int copy_type); 459int app_passwd(const char *arg1, const char *arg2, char **pass1, char **pass2); 460int add_oid_section(CONF *conf); 461X509 *load_cert(const char *file, int format, const char *cert_descrip); 462X509_CRL *load_crl(const char *infile, int format); 463EVP_PKEY *load_key(const char *file, int format, int maybe_stdin, 464 const char *pass, ENGINE *e, const char *key_descrip); 465EVP_PKEY *load_pubkey(const char *file, int format, int maybe_stdin, 466 const char *pass, ENGINE *e, const char *key_descrip); 467int load_certs(const char *file, STACK_OF(X509) **certs, int format, 468 const char *pass, const char *cert_descrip); 469int load_crls(const char *file, STACK_OF(X509_CRL) **crls, int format, 470 const char *pass, const char *cert_descrip); 471X509_STORE *setup_verify(const char *CAfile, const char *CApath, 472 int noCAfile, int noCApath); 473__owur int ctx_set_verify_locations(SSL_CTX *ctx, const char *CAfile, 474 const char *CApath, int noCAfile, 475 int noCApath); 476 477#ifndef OPENSSL_NO_CT 478 479/* 480 * Sets the file to load the Certificate Transparency log list from. 481 * If path is NULL, loads from the default file path. 482 * Returns 1 on success, 0 otherwise. 483 */ 484__owur int ctx_set_ctlog_list_file(SSL_CTX *ctx, const char *path); 485 486#endif 487 488ENGINE *setup_engine(const char *engine, int debug); 489void release_engine(ENGINE *e); 490 491# ifndef OPENSSL_NO_OCSP 492OCSP_RESPONSE *process_responder(OCSP_REQUEST *req, 493 const char *host, const char *path, 494 const char *port, int use_ssl, 495 STACK_OF(CONF_VALUE) *headers, 496 int req_timeout); 497# endif 498 499/* Functions defined in ca.c and also used in ocsp.c */ 500int unpack_revinfo(ASN1_TIME **prevtm, int *preason, ASN1_OBJECT **phold, 501 ASN1_GENERALIZEDTIME **pinvtm, const char *str); 502 503# define DB_type 0 504# define DB_exp_date 1 505# define DB_rev_date 2 506# define DB_serial 3 /* index - unique */ 507# define DB_file 4 508# define DB_name 5 /* index - unique when active and not 509 * disabled */ 510# define DB_NUMBER 6 511 512# define DB_TYPE_REV 'R' /* Revoked */ 513# define DB_TYPE_EXP 'E' /* Expired */ 514# define DB_TYPE_VAL 'V' /* Valid ; inserted with: ca ... -valid */ 515# define DB_TYPE_SUSP 'S' /* Suspended */ 516 517typedef struct db_attr_st { 518 int unique_subject; 519} DB_ATTR; 520typedef struct ca_db_st { 521 DB_ATTR attributes; 522 TXT_DB *db; 523 char *dbfname; 524# ifndef OPENSSL_NO_POSIX_IO 525 struct stat dbst; 526# endif 527} CA_DB; 528 529void* app_malloc(int sz, const char *what); 530 531/* load_serial, save_serial, and rotate_serial are also used for CRL numbers */ 532BIGNUM *load_serial(const char *serialfile, int *exists, int create, 533 ASN1_INTEGER **retai); 534int save_serial(const char *serialfile, const char *suffix, 535 const BIGNUM *serial, ASN1_INTEGER **retai); 536int rotate_serial(const char *serialfile, const char *new_suffix, 537 const char *old_suffix); 538int rand_serial(BIGNUM *b, ASN1_INTEGER *ai); 539CA_DB *load_index(const char *dbfile, DB_ATTR *dbattr); 540int index_index(CA_DB *db); 541int save_index(const char *dbfile, const char *suffix, CA_DB *db); 542int rotate_index(const char *dbfile, const char *new_suffix, 543 const char *old_suffix); 544void free_index(CA_DB *db); 545# define index_name_cmp_noconst(a, b) \ 546 index_name_cmp((const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, a), \ 547 (const OPENSSL_CSTRING *)CHECKED_PTR_OF(OPENSSL_STRING, b)) 548int index_name_cmp(const OPENSSL_CSTRING *a, const OPENSSL_CSTRING *b); 549int parse_yesno(const char *str, int def); 550 551X509_NAME *parse_name(const char *str, long chtype, int multirdn); 552void policies_print(X509_STORE_CTX *ctx); 553int bio_to_mem(unsigned char **out, int maxlen, BIO *in); 554int pkey_ctrl_string(EVP_PKEY_CTX *ctx, const char *value); 555int init_gen_str(EVP_PKEY_CTX **pctx, 556 const char *algname, ENGINE *e, int do_param); 557int do_X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md, 558 STACK_OF(OPENSSL_STRING) *sigopts); 559int do_X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md, 560 STACK_OF(OPENSSL_STRING) *sigopts); 561int do_X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md, 562 STACK_OF(OPENSSL_STRING) *sigopts); 563 564extern char *psk_key; 565 566 567unsigned char *next_protos_parse(size_t *outlen, const char *in); 568 569void print_cert_checks(BIO *bio, X509 *x, 570 const char *checkhost, 571 const char *checkemail, const char *checkip); 572 573void store_setup_crl_download(X509_STORE *st); 574 575/* See OPT_FMT_xxx, above. */ 576/* On some platforms, it's important to distinguish between text and binary 577 * files. On some, there might even be specific file formats for different 578 * contents. The FORMAT_xxx macros are meant to express an intent with the 579 * file being read or created. 580 */ 581# define B_FORMAT_TEXT 0x8000 582# define FORMAT_UNDEF 0 583# define FORMAT_TEXT (1 | B_FORMAT_TEXT) /* Generic text */ 584# define FORMAT_BINARY 2 /* Generic binary */ 585# define FORMAT_BASE64 (3 | B_FORMAT_TEXT) /* Base64 */ 586# define FORMAT_ASN1 4 /* ASN.1/DER */ 587# define FORMAT_PEM (5 | B_FORMAT_TEXT) 588# define FORMAT_PKCS12 6 589# define FORMAT_SMIME (7 | B_FORMAT_TEXT) 590# define FORMAT_ENGINE 8 /* Not really a file format */ 591# define FORMAT_PEMRSA (9 | B_FORMAT_TEXT) /* PEM RSAPubicKey format */ 592# define FORMAT_ASN1RSA 10 /* DER RSAPubicKey format */ 593# define FORMAT_MSBLOB 11 /* MS Key blob format */ 594# define FORMAT_PVK 12 /* MS PVK file format */ 595# define FORMAT_HTTP 13 /* Download using HTTP */ 596# define FORMAT_NSS 14 /* NSS keylog format */ 597 598# define EXT_COPY_NONE 0 599# define EXT_COPY_ADD 1 600# define EXT_COPY_ALL 2 601 602# define NETSCAPE_CERT_HDR "certificate" 603 604# define APP_PASS_LEN 1024 605 606/* 607 * IETF RFC 5280 says serial number must be <= 20 bytes. Use 159 bits 608 * so that the first bit will never be one, so that the DER encoding 609 * rules won't force a leading octet. 610 */ 611# define SERIAL_RAND_BITS 159 612 613int app_isdir(const char *); 614int app_access(const char *, int flag); 615int fileno_stdin(void); 616int fileno_stdout(void); 617int raw_read_stdin(void *, int); 618int raw_write_stdout(const void *, int); 619 620# define TM_START 0 621# define TM_STOP 1 622double app_tminterval(int stop, int usertime); 623 624void make_uppercase(char *string); 625 626typedef struct verify_options_st { 627 int depth; 628 int quiet; 629 int error; 630 int return_error; 631} VERIFY_CB_ARGS; 632 633extern VERIFY_CB_ARGS verify_args; 634 635#endif 636