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 46 void app_RAND_load_conf(CONF *c, const char *section); 47 void app_RAND_write(void); 48 49 extern char *default_config_file; 50 extern BIO *bio_in; 51 extern BIO *bio_out; 52 extern BIO *bio_err; 53 extern const unsigned char tls13_aes128gcmsha256_id[]; 54 extern const unsigned char tls13_aes256gcmsha384_id[]; 55 extern BIO_ADDR *ourpeer; 56 57 BIO_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 */ 69 void destroy_prefix_method(void); 70 71 BIO *dup_bio_in(int format); 72 BIO *dup_bio_out(int format); 73 BIO *dup_bio_err(int format); 74 BIO *bio_open_owner(const char *filename, int format, int private); 75 BIO *bio_open_default(const char *filename, char mode, int format); 76 BIO *bio_open_default_quiet(const char *filename, char mode, int format); 77 CONF *app_load_config_bio(BIO *in, const char *filename); 78 CONF *app_load_config(const char *filename); 79 CONF *app_load_config_quiet(const char *filename); 80 int app_load_modules(const CONF *config); 81 void unbuffer(FILE *fp); 82 void wait_for_async(SSL *s); 83 # if defined(OPENSSL_SYS_MSDOS) 84 int has_stdin_waiting(void); 85 # endif 86 87 void corrupt_signature(const ASN1_STRING *signature); 88 int 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 */ 341 extern const char OPT_HELP_STR[]; 342 extern const char OPT_MORE_STR[]; 343 typedef 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 */ 361 typedef 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 384 char *opt_progname(const char *argv0); 385 char *opt_getprog(void); 386 char *opt_init(int ac, char **av, const OPTIONS * o); 387 int opt_next(void); 388 int opt_format(const char *s, unsigned long flags, int *result); 389 int opt_int(const char *arg, int *result); 390 int opt_ulong(const char *arg, unsigned long *result); 391 int opt_long(const char *arg, long *result); 392 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L && \ 393 defined(INTMAX_MAX) && defined(UINTMAX_MAX) 394 int opt_imax(const char *arg, intmax_t *result); 395 int 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 402 int opt_pair(const char *arg, const OPT_PAIR * pairs, int *result); 403 int opt_cipher(const char *name, const EVP_CIPHER **cipherp); 404 int opt_md(const char *name, const EVP_MD **mdp); 405 char *opt_arg(void); 406 char *opt_flag(void); 407 char *opt_unknown(void); 408 char **opt_rest(void); 409 int opt_num_rest(void); 410 int opt_verify(int i, X509_VERIFY_PARAM *vpm); 411 int opt_rand(int i); 412 void opt_help(const OPTIONS * list); 413 int opt_format_error(const char *s, unsigned long flags); 414 415 typedef 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 */ 426 char **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 */ 431 void win32_utf8argv(int *argc, char **argv[]); 432 433 434 # define PW_MIN_LENGTH 4 435 typedef struct pw_cb_data { 436 const void *password; 437 const char *prompt_info; 438 } PW_CB_DATA; 439 440 int password_callback(char *buf, int bufsiz, int verify, PW_CB_DATA *cb_data); 441 442 int setup_ui_method(void); 443 void destroy_ui_method(void); 444 const UI_METHOD *get_ui_method(void); 445 446 int chopup_args(ARGS *arg, char *buf); 447 int dump_cert_text(BIO *out, X509 *x); 448 void print_name(BIO *out, const char *title, X509_NAME *nm, 449 unsigned long lflags); 450 void print_bignum_var(BIO *, const BIGNUM *, const char*, 451 int, unsigned char *); 452 void print_array(BIO *, const char *, int, const unsigned char *); 453 int set_nameopt(const char *arg); 454 unsigned long get_nameopt(void); 455 int set_cert_ex(unsigned long *flags, const char *arg); 456 int set_name_ex(unsigned long *flags, const char *arg); 457 int set_ext_copy(int *copy_type, const char *arg); 458 int copy_extensions(X509 *x, X509_REQ *req, int copy_type); 459 int app_passwd(const char *arg1, const char *arg2, char **pass1, char **pass2); 460 int add_oid_section(CONF *conf); 461 X509 *load_cert(const char *file, int format, const char *cert_descrip); 462 X509_CRL *load_crl(const char *infile, int format); 463 EVP_PKEY *load_key(const char *file, int format, int maybe_stdin, 464 const char *pass, ENGINE *e, const char *key_descrip); 465 EVP_PKEY *load_pubkey(const char *file, int format, int maybe_stdin, 466 const char *pass, ENGINE *e, const char *key_descrip); 467 int load_certs(const char *file, STACK_OF(X509) **certs, int format, 468 const char *pass, const char *cert_descrip); 469 int load_crls(const char *file, STACK_OF(X509_CRL) **crls, int format, 470 const char *pass, const char *cert_descrip); 471 X509_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 488 ENGINE *setup_engine(const char *engine, int debug); 489 void release_engine(ENGINE *e); 490 491 # ifndef OPENSSL_NO_OCSP 492 OCSP_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 */ 500 int 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 517 typedef struct db_attr_st { 518 int unique_subject; 519 } DB_ATTR; 520 typedef 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 529 void* app_malloc(int sz, const char *what); 530 531 /* load_serial, save_serial, and rotate_serial are also used for CRL numbers */ 532 BIGNUM *load_serial(const char *serialfile, int *exists, int create, 533 ASN1_INTEGER **retai); 534 int save_serial(const char *serialfile, const char *suffix, 535 const BIGNUM *serial, ASN1_INTEGER **retai); 536 int rotate_serial(const char *serialfile, const char *new_suffix, 537 const char *old_suffix); 538 int rand_serial(BIGNUM *b, ASN1_INTEGER *ai); 539 CA_DB *load_index(const char *dbfile, DB_ATTR *dbattr); 540 int index_index(CA_DB *db); 541 int save_index(const char *dbfile, const char *suffix, CA_DB *db); 542 int rotate_index(const char *dbfile, const char *new_suffix, 543 const char *old_suffix); 544 void 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)) 548 int index_name_cmp(const OPENSSL_CSTRING *a, const OPENSSL_CSTRING *b); 549 int parse_yesno(const char *str, int def); 550 551 X509_NAME *parse_name(const char *str, long chtype, int multirdn); 552 void policies_print(X509_STORE_CTX *ctx); 553 int bio_to_mem(unsigned char **out, int maxlen, BIO *in); 554 int pkey_ctrl_string(EVP_PKEY_CTX *ctx, const char *value); 555 int init_gen_str(EVP_PKEY_CTX **pctx, 556 const char *algname, ENGINE *e, int do_param); 557 int do_X509_sign(X509 *x, EVP_PKEY *pkey, const EVP_MD *md, 558 STACK_OF(OPENSSL_STRING) *sigopts); 559 int do_X509_REQ_sign(X509_REQ *x, EVP_PKEY *pkey, const EVP_MD *md, 560 STACK_OF(OPENSSL_STRING) *sigopts); 561 int do_X509_CRL_sign(X509_CRL *x, EVP_PKEY *pkey, const EVP_MD *md, 562 STACK_OF(OPENSSL_STRING) *sigopts); 563 564 extern char *psk_key; 565 566 567 unsigned char *next_protos_parse(size_t *outlen, const char *in); 568 569 void print_cert_checks(BIO *bio, X509 *x, 570 const char *checkhost, 571 const char *checkemail, const char *checkip); 572 573 void 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 613 int app_isdir(const char *); 614 int app_access(const char *, int flag); 615 int fileno_stdin(void); 616 int fileno_stdout(void); 617 int raw_read_stdin(void *, int); 618 int raw_write_stdout(const void *, int); 619 620 # define TM_START 0 621 # define TM_STOP 1 622 double app_tminterval(int stop, int usertime); 623 624 void make_uppercase(char *string); 625 626 typedef struct verify_options_st { 627 int depth; 628 int quiet; 629 int error; 630 int return_error; 631 } VERIFY_CB_ARGS; 632 633 extern VERIFY_CB_ARGS verify_args; 634 635 #endif 636
Indexes created Sat Feb 28 05:31:39 UTC 2026