lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame] | 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 |