/*

 * WARNING: do not edit!

 * Generated by Makefile from include/openssl/ssl.h.in

 *

 * Copyright 1995-2025 The OpenSSL Project Authors. All Rights Reserved.

 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved

 * Copyright 2005 Nokia. All rights reserved.

 *

 * Licensed under the Apache License 2.0 (the "License").  You may not use

 * this file except in compliance with the License.  You can obtain a copy

 * in the file LICENSE in the source distribution or at

 * https://www.openssl.org/source/license.html

 */

/* clang-format off */

/* clang-format on */

#ifndef OPENSSL_SSL_H

#define OPENSSL_SSL_H

#pragma once

#include <openssl/macros.h>

#ifndef OPENSSL_NO_DEPRECATED_3_0

#define HEADER_SSL_H

#endif

#include <openssl/e_os2.h>

#include <openssl/e_ostime.h>

#include <openssl/opensslconf.h>

#include <openssl/comp.h>

#include <openssl/bio.h>

#ifndef OPENSSL_NO_DEPRECATED_1_1_0

#include <openssl/x509.h>

#include <openssl/crypto.h>

#include <openssl/buffer.h>

#endif

#include <openssl/lhash.h>

#include <openssl/pem.h>

#include <openssl/hmac.h>

#include <openssl/async.h>

#include <openssl/safestack.h>

#include <openssl/symhacks.h>

#include <openssl/ct.h>

#include <openssl/sslerr.h>

#include <openssl/prov_ssl.h>

#ifndef OPENSSL_NO_STDIO

#include <stdio.h>

#endif

#ifdef __cplusplus

extern "C" {

#endif

/* OpenSSL version number for ASN.1 encoding of the session information */

/*-

 * Version 0 - initial version

 * Version 1 - added the optional peer certificate

 */

#define SSL_SESSION_ASN1_VERSION 0x0001

#define SSL_MAX_SSL_SESSION_ID_LENGTH 32

#define SSL_MAX_SID_CTX_LENGTH 32

#define SSL_MIN_RSA_MODULUS_LENGTH_IN_BYTES (512 / 8)

#define SSL_MAX_KEY_ARG_LENGTH 8

/* SSL_MAX_MASTER_KEY_LENGTH is defined in prov_ssl.h */

/* The maximum number of encrypt/decrypt pipelines we can support */

#define SSL_MAX_PIPELINES 32

/* text strings for the ciphers */

/* These are used to specify which ciphers to use and not to use */

#define SSL_TXT_LOW "LOW"

#define SSL_TXT_MEDIUM "MEDIUM"

#define SSL_TXT_HIGH "HIGH"

#define SSL_TXT_FIPS "FIPS"

#define SSL_TXT_aNULL "aNULL"

#define SSL_TXT_eNULL "eNULL"

#define SSL_TXT_NULL "NULL"

#define SSL_TXT_kRSA "kRSA"

#define SSL_TXT_kDHr "kDHr" /* this cipher class has been removed */

#define SSL_TXT_kDHd "kDHd" /* this cipher class has been removed */

#define SSL_TXT_kDH "kDH" /* this cipher class has been removed */

#define SSL_TXT_kEDH "kEDH" /* alias for kDHE */

#define SSL_TXT_kDHE "kDHE"

#define SSL_TXT_kECDHr "kECDHr" /* this cipher class has been removed */

#define SSL_TXT_kECDHe "kECDHe" /* this cipher class has been removed */

#define SSL_TXT_kECDH "kECDH" /* this cipher class has been removed */

#define SSL_TXT_kEECDH "kEECDH" /* alias for kECDHE */

#define SSL_TXT_kECDHE "kECDHE"

#define SSL_TXT_kPSK "kPSK"

#define SSL_TXT_kRSAPSK "kRSAPSK"

#define SSL_TXT_kECDHEPSK "kECDHEPSK"

#define SSL_TXT_kDHEPSK "kDHEPSK"

#define SSL_TXT_kGOST "kGOST"

#define SSL_TXT_kGOST18 "kGOST18"

#define SSL_TXT_kSRP "kSRP"

#define SSL_TXT_aRSA "aRSA"

#define SSL_TXT_aDSS "aDSS"

#define SSL_TXT_aDH "aDH" /* this cipher class has been removed */

#define SSL_TXT_aECDH "aECDH" /* this cipher class has been removed */

#define SSL_TXT_aECDSA "aECDSA"

#define SSL_TXT_aPSK "aPSK"

#define SSL_TXT_aGOST94 "aGOST94"

#define SSL_TXT_aGOST01 "aGOST01"

#define SSL_TXT_aGOST12 "aGOST12"

#define SSL_TXT_aGOST "aGOST"

#define SSL_TXT_aSRP "aSRP"

#define SSL_TXT_DSS "DSS"

#define SSL_TXT_DH "DH"

#define SSL_TXT_DHE "DHE" /* same as "kDHE:-ADH" */

#define SSL_TXT_EDH "EDH" /* alias for DHE */

#define SSL_TXT_ADH "ADH"

#define SSL_TXT_RSA "RSA"

#define SSL_TXT_ECDH "ECDH"

#define SSL_TXT_EECDH "EECDH" /* alias for ECDHE" */

#define SSL_TXT_ECDHE "ECDHE" /* same as "kECDHE:-AECDH" */

#define SSL_TXT_AECDH "AECDH"

#define SSL_TXT_ECDSA "ECDSA"

#define SSL_TXT_PSK "PSK"

#define SSL_TXT_SRP "SRP"

#define SSL_TXT_DES "DES"

#define SSL_TXT_3DES "3DES"

#define SSL_TXT_RC4 "RC4"

#define SSL_TXT_RC2 "RC2"

#define SSL_TXT_IDEA "IDEA"

#define SSL_TXT_SEED "SEED"

#define SSL_TXT_AES128 "AES128"

#define SSL_TXT_AES256 "AES256"

#define SSL_TXT_AES "AES"

#define SSL_TXT_AES_GCM "AESGCM"

#define SSL_TXT_AES_CCM "AESCCM"

#define SSL_TXT_AES_CCM_8 "AESCCM8"

#define SSL_TXT_CAMELLIA128 "CAMELLIA128"

#define SSL_TXT_CAMELLIA256 "CAMELLIA256"

#define SSL_TXT_CAMELLIA "CAMELLIA"

#define SSL_TXT_CHACHA20 "CHACHA20"

#define SSL_TXT_GOST "GOST89"

#define SSL_TXT_ARIA "ARIA"

#define SSL_TXT_ARIA_GCM "ARIAGCM"

#define SSL_TXT_ARIA128 "ARIA128"

#define SSL_TXT_ARIA256 "ARIA256"

#define SSL_TXT_GOST2012_GOST8912_GOST8912 "GOST2012-GOST8912-GOST8912"

#define SSL_TXT_CBC "CBC"

#define SSL_TXT_MD5 "MD5"

#define SSL_TXT_SHA1 "SHA1"

#define SSL_TXT_SHA "SHA" /* same as "SHA1" */

#define SSL_TXT_GOST94 "GOST94"

#define SSL_TXT_GOST89MAC "GOST89MAC"

#define SSL_TXT_GOST12 "GOST12"

#define SSL_TXT_GOST89MAC12 "GOST89MAC12"

#define SSL_TXT_SHA256 "SHA256"

#define SSL_TXT_SHA384 "SHA384"

#define SSL_TXT_SSLV3 "SSLv3"

#define SSL_TXT_TLSV1 "TLSv1"

#define SSL_TXT_TLSV1_1 "TLSv1.1"

#define SSL_TXT_TLSV1_2 "TLSv1.2"

#define SSL_TXT_ALL "ALL"

/*-

 * COMPLEMENTOF* definitions. These identifiers are used to (de-select)

 * ciphers normally not being used.

 * Example: "RC4" will activate all ciphers using RC4 including ciphers

 * without authentication, which would normally disabled by DEFAULT (due

 * the "!ADH" being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT"

 * will make sure that it is also disabled in the specific selection.

 * COMPLEMENTOF* identifiers are portable between version, as adjustments

 * to the default cipher setup will also be included here.

 *

 * COMPLEMENTOFDEFAULT does not experience the same special treatment that

 * DEFAULT gets, as only selection is being done and no sorting as needed

 * for DEFAULT.

 */

#define SSL_TXT_CMPALL "COMPLEMENTOFALL"

#define SSL_TXT_CMPDEF "COMPLEMENTOFDEFAULT"

/*

 * The following cipher list is used by default. It also is substituted when

 * an application-defined cipher list string starts with 'DEFAULT'.

 * This applies to ciphersuites for TLSv1.2 and below.

 * DEPRECATED IN 3.0.0, in favor of OSSL_default_cipher_list()

 * Update both macro and function simultaneously

 */

#ifndef OPENSSL_NO_DEPRECATED_3_0

#define SSL_DEFAULT_CIPHER_LIST "ALL:!COMPLEMENTOFDEFAULT:!eNULL"

/*

 * This is the default set of TLSv1.3 ciphersuites

 * DEPRECATED IN 3.0.0, in favor of OSSL_default_ciphersuites()

 * Update both macro and function simultaneously

 */

#define TLS_DEFAULT_CIPHERSUITES "TLS_AES_256_GCM_SHA384:"       \

                                 "TLS_CHACHA20_POLY1305_SHA256:" \

                                 "TLS_AES_128_GCM_SHA256"

#endif

/*

 * As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always

 * starts with a reasonable order, and all we have to do for DEFAULT is

 * throwing out anonymous and unencrypted ciphersuites! (The latter are not

 * actually enabled by ALL, but "ALL:RSA" would enable some of them.)

 */

/* Used in SSL_set_shutdown()/SSL_get_shutdown(); */

#define SSL_SENT_SHUTDOWN 1

#define SSL_RECEIVED_SHUTDOWN 2

#ifdef __cplusplus

}

#endif

#ifdef __cplusplus

extern "C" {

#endif

#define SSL_FILETYPE_ASN1 X509_FILETYPE_ASN1

#define SSL_FILETYPE_PEM X509_FILETYPE_PEM

/*

 * This is needed to stop compilers complaining about the 'struct ssl_st *'

 * function parameters used to prototype callbacks in SSL_CTX.

 */

typedef struct ssl_st *ssl_crock_st;

typedef struct tls_session_ticket_ext_st TLS_SESSION_TICKET_EXT;

typedef struct ssl_method_st SSL_METHOD;

typedef struct ssl_cipher_st SSL_CIPHER;

typedef struct ssl_session_st SSL_SESSION;

typedef struct tls_sigalgs_st TLS_SIGALGS;

typedef struct ssl_conf_ctx_st SSL_CONF_CTX;

STACK_OF(SSL_CIPHER);

/* SRTP protection profiles for use with the use_srtp extension (RFC 5764)*/

typedef struct srtp_protection_profile_st {

    const char *name;

    unsigned long id;

} SRTP_PROTECTION_PROFILE;

/* clang-format off */

SKM_DEFINE_STACK_OF_INTERNAL(SRTP_PROTECTION_PROFILE, SRTP_PROTECTION_PROFILE, SRTP_PROTECTION_PROFILE)

#define sk_SRTP_PROTECTION_PROFILE_num(sk) OPENSSL_sk_num(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk))

#define sk_SRTP_PROTECTION_PROFILE_value(sk, idx) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_value(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk), (idx)))

#define sk_SRTP_PROTECTION_PROFILE_new(cmp) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_new(ossl_check_SRTP_PROTECTION_PROFILE_compfunc_type(cmp)))

#define sk_SRTP_PROTECTION_PROFILE_new_null() ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_new_null())

#define sk_SRTP_PROTECTION_PROFILE_new_reserve(cmp, n) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_new_reserve(ossl_check_SRTP_PROTECTION_PROFILE_compfunc_type(cmp), (n)))

#define sk_SRTP_PROTECTION_PROFILE_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), (n))

#define sk_SRTP_PROTECTION_PROFILE_free(sk) OPENSSL_sk_free(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))

#define sk_SRTP_PROTECTION_PROFILE_zero(sk) OPENSSL_sk_zero(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))

#define sk_SRTP_PROTECTION_PROFILE_delete(sk, i) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_delete(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), (i)))

#define sk_SRTP_PROTECTION_PROFILE_delete_ptr(sk, ptr) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_delete_ptr(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr)))

#define sk_SRTP_PROTECTION_PROFILE_push(sk, ptr) OPENSSL_sk_push(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr))

#define sk_SRTP_PROTECTION_PROFILE_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr))

#define sk_SRTP_PROTECTION_PROFILE_pop(sk) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_pop(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk)))

#define sk_SRTP_PROTECTION_PROFILE_shift(sk) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_shift(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk)))

#define sk_SRTP_PROTECTION_PROFILE_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_freefunc_type(freefunc))

#define sk_SRTP_PROTECTION_PROFILE_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr), (idx))

#define sk_SRTP_PROTECTION_PROFILE_set(sk, idx, ptr) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_set(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), (idx), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr)))

#define sk_SRTP_PROTECTION_PROFILE_find(sk, ptr) OPENSSL_sk_find(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr))

#define sk_SRTP_PROTECTION_PROFILE_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr))

#define sk_SRTP_PROTECTION_PROFILE_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_type(ptr), pnum)

#define sk_SRTP_PROTECTION_PROFILE_sort(sk) OPENSSL_sk_sort(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))

#define sk_SRTP_PROTECTION_PROFILE_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk))

#define sk_SRTP_PROTECTION_PROFILE_dup(sk) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_dup(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk)))

#define sk_SRTP_PROTECTION_PROFILE_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_deep_copy(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_copyfunc_type(copyfunc), ossl_check_SRTP_PROTECTION_PROFILE_freefunc_type(freefunc)))

#define sk_SRTP_PROTECTION_PROFILE_set_cmp_func(sk, cmp) ((sk_SRTP_PROTECTION_PROFILE_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), ossl_check_SRTP_PROTECTION_PROFILE_compfunc_type(cmp)))

/* clang-format on */

typedef int (*tls_session_ticket_ext_cb_fn)(SSL *s, const unsigned char *data,

    int len, void *arg);

typedef int (*tls_session_secret_cb_fn)(SSL *s, void *secret, int *secret_len,

    STACK_OF(SSL_CIPHER) *peer_ciphers,

    const SSL_CIPHER **cipher, void *arg);

/* Extension context codes */

/* This extension is only allowed in TLS */

#define SSL_EXT_TLS_ONLY 0x00001

/* This extension is only allowed in DTLS */

#define SSL_EXT_DTLS_ONLY 0x00002

/* Some extensions may be allowed in DTLS but we don't implement them for it */

#define SSL_EXT_TLS_IMPLEMENTATION_ONLY 0x00004

/* Most extensions are not defined for SSLv3 but EXT_TYPE_renegotiate is */

#define SSL_EXT_SSL3_ALLOWED 0x00008

/* Extension is only defined for TLS1.2 and below */

#define SSL_EXT_TLS1_2_AND_BELOW_ONLY 0x00010

/* Extension is only defined for TLS1.3 and above */

#define SSL_EXT_TLS1_3_ONLY 0x00020

/* Ignore this extension during parsing if we are resuming */

#define SSL_EXT_IGNORE_ON_RESUMPTION 0x00040

#define SSL_EXT_CLIENT_HELLO 0x00080

/* Really means TLS1.2 or below */

#define SSL_EXT_TLS1_2_SERVER_HELLO 0x00100

#define SSL_EXT_TLS1_3_SERVER_HELLO 0x00200

#define SSL_EXT_TLS1_3_ENCRYPTED_EXTENSIONS 0x00400

#define SSL_EXT_TLS1_3_HELLO_RETRY_REQUEST 0x00800

#define SSL_EXT_TLS1_3_CERTIFICATE 0x01000

#define SSL_EXT_TLS1_3_NEW_SESSION_TICKET 0x02000

#define SSL_EXT_TLS1_3_CERTIFICATE_REQUEST 0x04000

#define SSL_EXT_TLS1_3_CERTIFICATE_COMPRESSION 0x08000

/* When sending a raw public key in a certificate message */

#define SSL_EXT_TLS1_3_RAW_PUBLIC_KEY 0x10000

/* Typedefs for handling custom extensions */

typedef int (*custom_ext_add_cb)(SSL *s, unsigned int ext_type,

    const unsigned char **out, size_t *outlen,

    int *al, void *add_arg);

typedef void (*custom_ext_free_cb)(SSL *s, unsigned int ext_type,

    const unsigned char *out, void *add_arg);

typedef int (*custom_ext_parse_cb)(SSL *s, unsigned int ext_type,

    const unsigned char *in, size_t inlen,

    int *al, void *parse_arg);

typedef int (*SSL_custom_ext_add_cb_ex)(SSL *s, unsigned int ext_type,

    unsigned int context,

    const unsigned char **out,

    size_t *outlen, X509 *x,

    size_t chainidx,

    int *al, void *add_arg);

typedef void (*SSL_custom_ext_free_cb_ex)(SSL *s, unsigned int ext_type,

    unsigned int context,

    const unsigned char *out,

    void *add_arg);

typedef int (*SSL_custom_ext_parse_cb_ex)(SSL *s, unsigned int ext_type,

    unsigned int context,

    const unsigned char *in,

    size_t inlen, X509 *x,

    size_t chainidx,

    int *al, void *parse_arg);

/* Typedef for verification callback */

typedef int (*SSL_verify_cb)(int preverify_ok, X509_STORE_CTX *x509_ctx);

/* Typedef for SSL async callback */

typedef int (*SSL_async_callback_fn)(SSL *s, void *arg);

#define SSL_OP_BIT(n) ((uint64_t)1 << (uint64_t)n)

/*

 * SSL/TLS connection options.

 */

/* Disable Extended master secret */

#define SSL_OP_NO_EXTENDED_MASTER_SECRET SSL_OP_BIT(0)

/* Cleanse plaintext copies of data delivered to the application */

#define SSL_OP_CLEANSE_PLAINTEXT SSL_OP_BIT(1)

/* Allow initial connection to servers that don't support RI */

#define SSL_OP_LEGACY_SERVER_CONNECT SSL_OP_BIT(2)

/* Enable support for Kernel TLS */

#define SSL_OP_ENABLE_KTLS SSL_OP_BIT(3)

#define SSL_OP_TLSEXT_PADDING SSL_OP_BIT(4)

#define SSL_OP_SAFARI_ECDHE_ECDSA_BUG SSL_OP_BIT(6)

#define SSL_OP_IGNORE_UNEXPECTED_EOF SSL_OP_BIT(7)

#define SSL_OP_ALLOW_CLIENT_RENEGOTIATION SSL_OP_BIT(8)

#define SSL_OP_DISABLE_TLSEXT_CA_NAMES SSL_OP_BIT(9)

/* In TLSv1.3 allow a non-(ec)dhe based kex_mode */

#define SSL_OP_ALLOW_NO_DHE_KEX SSL_OP_BIT(10)

/*

 * Disable SSL 3.0/TLS 1.0 CBC vulnerability workaround that was added

 * in OpenSSL 0.9.6d.  Usually (depending on the application protocol)

 * the workaround is not needed.  Unfortunately some broken SSL/TLS

 * implementations cannot handle it at all, which is why we include it

 * in SSL_OP_ALL. Added in 0.9.6e

 */

#define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS SSL_OP_BIT(11)

/* DTLS options */

#define SSL_OP_NO_QUERY_MTU SSL_OP_BIT(12)

/* Turn on Cookie Exchange (on relevant for servers) */

#define SSL_OP_COOKIE_EXCHANGE SSL_OP_BIT(13)

/* Don't use RFC4507 ticket extension */

#define SSL_OP_NO_TICKET SSL_OP_BIT(14)

#ifndef OPENSSL_NO_DTLS1_METHOD

/*

 * Use Cisco's version identifier of DTLS_BAD_VER

 * (only with deprecated DTLSv1_client_method())

 */

#define SSL_OP_CISCO_ANYCONNECT SSL_OP_BIT(15)

#endif

/* As server, disallow session resumption on renegotiation */

#define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION SSL_OP_BIT(16)

/* Don't use compression even if supported */

#define SSL_OP_NO_COMPRESSION SSL_OP_BIT(17)

/* Permit unsafe legacy renegotiation */

#define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION SSL_OP_BIT(18)

/* Disable encrypt-then-mac */

#define SSL_OP_NO_ENCRYPT_THEN_MAC SSL_OP_BIT(19)

/*

 * Enable TLSv1.3 Compatibility mode. This is on by default. A future

 * version of OpenSSL may have this disabled by default.

 */

#define SSL_OP_ENABLE_MIDDLEBOX_COMPAT SSL_OP_BIT(20)

/*

 * Prioritize Chacha20Poly1305 when client does.

 * Modifies SSL_OP_SERVER_PREFERENCE

 */

#define SSL_OP_PRIORITIZE_CHACHA SSL_OP_BIT(21)

/*

 * Set on servers to choose cipher, curve or group according to server's

 * preferences.

 */

#define SSL_OP_SERVER_PREFERENCE SSL_OP_BIT(22)

/* Equivalent definition for backwards compatibility: */

#define SSL_OP_CIPHER_SERVER_PREFERENCE SSL_OP_SERVER_PREFERENCE

/*

 * If set, a server will allow a client to issue an SSLv3.0 version

 * number as latest version supported in the premaster secret, even when

 * TLSv1.0 (version 3.1) was announced in the client hello. Normally

 * this is forbidden to prevent version rollback attacks.

 */

#define SSL_OP_TLS_ROLLBACK_BUG SSL_OP_BIT(23)

/*

 * Switches off automatic TLSv1.3 anti-replay protection for early data.

 * This is a server-side option only (no effect on the client).

 */

#define SSL_OP_NO_ANTI_REPLAY SSL_OP_BIT(24)

#define SSL_OP_NO_SSLv3 SSL_OP_BIT(25)

#define SSL_OP_NO_TLSv1 SSL_OP_BIT(26)

#define SSL_OP_NO_TLSv1_2 SSL_OP_BIT(27)

#define SSL_OP_NO_TLSv1_1 SSL_OP_BIT(28)

#define SSL_OP_NO_TLSv1_3 SSL_OP_BIT(29)

#define SSL_OP_NO_DTLSv1 SSL_OP_BIT(26)

#define SSL_OP_NO_DTLSv1_2 SSL_OP_BIT(27)

/* Disallow all renegotiation */

#define SSL_OP_NO_RENEGOTIATION SSL_OP_BIT(30)

/*

 * Make server add server-hello extension from early version of

 * cryptopro draft, when GOST ciphersuite is negotiated. Required for

 * interoperability with CryptoPro CSP 3.x

 */

#define SSL_OP_CRYPTOPRO_TLSEXT_BUG SSL_OP_BIT(31)

/*

 * Disable RFC8879 certificate compression

 * SSL_OP_NO_TX_CERTIFICATE_COMPRESSION: don't send compressed certificates,

 *     and ignore the extension when received.

 * SSL_OP_NO_RX_CERTIFICATE_COMPRESSION: don't send the extension, and

 *     subsequently indicating that receiving is not supported

 */

#define SSL_OP_NO_TX_CERTIFICATE_COMPRESSION SSL_OP_BIT(32)

#define SSL_OP_NO_RX_CERTIFICATE_COMPRESSION SSL_OP_BIT(33)

/* Enable KTLS TX zerocopy on Linux */

#define SSL_OP_ENABLE_KTLS_TX_ZEROCOPY_SENDFILE SSL_OP_BIT(34)

#define SSL_OP_PREFER_NO_DHE_KEX SSL_OP_BIT(35)

#define SSL_OP_LEGACY_EC_POINT_FORMATS SSL_OP_BIT(36)

/*

 * Option "collections."

 */

#define SSL_OP_NO_SSL_MASK                                 \

    (SSL_OP_NO_SSLv3 | SSL_OP_NO_TLSv1 | SSL_OP_NO_TLSv1_1 \

        | SSL_OP_NO_TLSv1_2 | SSL_OP_NO_TLSv1_3)

#define SSL_OP_NO_DTLS_MASK \

    (SSL_OP_NO_DTLSv1 | SSL_OP_NO_DTLSv1_2)

/* Various bug workarounds that should be rather harmless. */

#define SSL_OP_ALL                                                    \

    (SSL_OP_CRYPTOPRO_TLSEXT_BUG | SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS \

        | SSL_OP_TLSEXT_PADDING | SSL_OP_SAFARI_ECDHE_ECDSA_BUG)

/*

 * OBSOLETE OPTIONS retained for compatibility

 */

#define SSL_OP_MICROSOFT_SESS_ID_BUG 0x0

#define SSL_OP_NETSCAPE_CHALLENGE_BUG 0x0

#define SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG 0x0

#define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG 0x0

#define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER 0x0

#define SSL_OP_MSIE_SSLV2_RSA_PADDING 0x0

#define SSL_OP_SSLEAY_080_CLIENT_DH_BUG 0x0

#define SSL_OP_TLS_D5_BUG 0x0

#define SSL_OP_TLS_BLOCK_PADDING_BUG 0x0

#define SSL_OP_SINGLE_ECDH_USE 0x0

#define SSL_OP_SINGLE_DH_USE 0x0

#define SSL_OP_EPHEMERAL_RSA 0x0

#define SSL_OP_NO_SSLv2 0x0

#define SSL_OP_PKCS1_CHECK_1 0x0

#define SSL_OP_PKCS1_CHECK_2 0x0

#define SSL_OP_NETSCAPE_CA_DN_BUG 0x0

#define SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG 0x0

/*

 * Allow SSL_write(..., n) to return r with 0 < r < n (i.e. report success

 * when just a single record has been written):

 */

#define SSL_MODE_ENABLE_PARTIAL_WRITE 0x00000001U

/*

 * Make it possible to retry SSL_write() with changed buffer location (buffer

 * contents must stay the same!); this is not the default to avoid the

 * misconception that non-blocking SSL_write() behaves like non-blocking

 * write():

 */

#define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002U

/*

 * Never bother the application with retries if the transport is blocking:

 */

#define SSL_MODE_AUTO_RETRY 0x00000004U

/* Don't attempt to automatically build certificate chain */

#define SSL_MODE_NO_AUTO_CHAIN 0x00000008U

/*

 * Save RAM by releasing read and write buffers when they're empty. (SSL3 and

 * TLS only.) Released buffers are freed.

 */

#define SSL_MODE_RELEASE_BUFFERS 0x00000010U

/*

 * Send the current time in the Random fields of the ClientHello and

 * ServerHello records for compatibility with hypothetical implementations

 * that require it.

 */

#define SSL_MODE_SEND_CLIENTHELLO_TIME 0x00000020U

#define SSL_MODE_SEND_SERVERHELLO_TIME 0x00000040U

/*

 * Send TLS_FALLBACK_SCSV in the ClientHello. To be set only by applications

 * that reconnect with a downgraded protocol version; see

 * draft-ietf-tls-downgrade-scsv-00 for details. DO NOT ENABLE THIS if your

 * application attempts a normal handshake. Only use this in explicit

 * fallback retries, following the guidance in

 * draft-ietf-tls-downgrade-scsv-00.

 */

#define SSL_MODE_SEND_FALLBACK_SCSV 0x00000080U

/*

 * Support Asynchronous operation

 */

#define SSL_MODE_ASYNC 0x00000100U

/*

 * When using DTLS/SCTP, include the terminating zero in the label

 * used for computing the endpoint-pair shared secret. Required for

 * interoperability with implementations having this bug like these

 * older version of OpenSSL:

 * - OpenSSL 1.0.0 series

 * - OpenSSL 1.0.1 series

 * - OpenSSL 1.0.2 series

 * - OpenSSL 1.1.0 series

 * - OpenSSL 1.1.1 and 1.1.1a

 */

#define SSL_MODE_DTLS_SCTP_LABEL_LENGTH_BUG 0x00000400U

/* Cert related flags */

/*

 * Many implementations ignore some aspects of the TLS standards such as

 * enforcing certificate chain algorithms. When this is set we enforce them.

 */

#define SSL_CERT_FLAG_TLS_STRICT 0x00000001U

/* Suite B modes, takes same values as certificate verify flags */

#define SSL_CERT_FLAG_SUITEB_128_LOS_ONLY 0x10000

/* Suite B 192 bit only mode */

#define SSL_CERT_FLAG_SUITEB_192_LOS 0x20000

/* Suite B 128 bit mode allowing 192 bit algorithms */

#define SSL_CERT_FLAG_SUITEB_128_LOS 0x30000

/* Perform all sorts of protocol violations for testing purposes */

#define SSL_CERT_FLAG_BROKEN_PROTOCOL 0x10000000

/* Flags for building certificate chains */

/* Treat any existing certificates as untrusted CAs */

#define SSL_BUILD_CHAIN_FLAG_UNTRUSTED 0x1

/* Don't include root CA in chain */

#define SSL_BUILD_CHAIN_FLAG_NO_ROOT 0x2

/* Just check certificates already there */

#define SSL_BUILD_CHAIN_FLAG_CHECK 0x4

/* Ignore verification errors */

#define SSL_BUILD_CHAIN_FLAG_IGNORE_ERROR 0x8

/* Clear verification errors from queue */

#define SSL_BUILD_CHAIN_FLAG_CLEAR_ERROR 0x10

/* Flags returned by SSL_check_chain */

/* Certificate can be used with this session */

#define CERT_PKEY_VALID 0x1

/* Certificate can also be used for signing */

#define CERT_PKEY_SIGN 0x2

/* EE certificate signing algorithm OK */

#define CERT_PKEY_EE_SIGNATURE 0x10

/* CA signature algorithms OK */

#define CERT_PKEY_CA_SIGNATURE 0x20

/* EE certificate parameters OK */

#define CERT_PKEY_EE_PARAM 0x40

/* CA certificate parameters OK */

#define CERT_PKEY_CA_PARAM 0x80

/* Signing explicitly allowed as opposed to SHA1 fallback */

#define CERT_PKEY_EXPLICIT_SIGN 0x100

/* Client CA issuer names match (always set for server cert) */

#define CERT_PKEY_ISSUER_NAME 0x200

/* Cert type matches client types (always set for server cert) */

#define CERT_PKEY_CERT_TYPE 0x400

/* Cert chain suitable to Suite B */

#define CERT_PKEY_SUITEB 0x800

/* Cert pkey valid for raw public key use */

#define CERT_PKEY_RPK 0x1000

#define SSL_CONF_FLAG_CMDLINE 0x1

#define SSL_CONF_FLAG_FILE 0x2

#define SSL_CONF_FLAG_CLIENT 0x4

#define SSL_CONF_FLAG_SERVER 0x8

#define SSL_CONF_FLAG_SHOW_ERRORS 0x10

#define SSL_CONF_FLAG_CERTIFICATE 0x20

#define SSL_CONF_FLAG_REQUIRE_PRIVATE 0x40

/* Configuration value types */

#define SSL_CONF_TYPE_UNKNOWN 0x0

#define SSL_CONF_TYPE_STRING 0x1

#define SSL_CONF_TYPE_FILE 0x2

#define SSL_CONF_TYPE_DIR 0x3

#define SSL_CONF_TYPE_NONE 0x4

#define SSL_CONF_TYPE_STORE 0x5

/* Maximum length of the application-controlled segment of a a TLSv1.3 cookie */

#define SSL_COOKIE_LENGTH 4096

/*

 * Note: SSL[_CTX]_set_{options,mode} use |= op on the previous value, they

 * cannot be used to clear bits.

 */

uint64_t SSL_CTX_get_options(const SSL_CTX *ctx);

uint64_t SSL_get_options(const SSL *s);

uint64_t SSL_CTX_clear_options(SSL_CTX *ctx, uint64_t op);

uint64_t SSL_clear_options(SSL *s, uint64_t op);

uint64_t SSL_CTX_set_options(SSL_CTX *ctx, uint64_t op);

uint64_t SSL_set_options(SSL *s, uint64_t op);

#define SSL_CTX_set_mode(ctx, op) \

    SSL_CTX_ctrl((ctx), SSL_CTRL_MODE, (op), NULL)

#define SSL_CTX_clear_mode(ctx, op) \

    SSL_CTX_ctrl((ctx), SSL_CTRL_CLEAR_MODE, (op), NULL)

#define SSL_CTX_get_mode(ctx) \

    SSL_CTX_ctrl((ctx), SSL_CTRL_MODE, 0, NULL)

#define SSL_clear_mode(ssl, op) \

    SSL_ctrl((ssl), SSL_CTRL_CLEAR_MODE, (op), NULL)

#define SSL_set_mode(ssl, op) \

    SSL_ctrl((ssl), SSL_CTRL_MODE, (op), NULL)

#define SSL_get_mode(ssl) \

    SSL_ctrl((ssl), SSL_CTRL_MODE, 0, NULL)

#define SSL_set_mtu(ssl, mtu) \

    SSL_ctrl((ssl), SSL_CTRL_SET_MTU, (mtu), NULL)

#define DTLS_set_link_mtu(ssl, mtu) \

    SSL_ctrl((ssl), DTLS_CTRL_SET_LINK_MTU, (mtu), NULL)

#define DTLS_get_link_min_mtu(ssl) \

    SSL_ctrl((ssl), DTLS_CTRL_GET_LINK_MIN_MTU, 0, NULL)

#define SSL_get_secure_renegotiation_support(ssl) \

    SSL_ctrl((ssl), SSL_CTRL_GET_RI_SUPPORT, 0, NULL)

#define SSL_CTX_set_cert_flags(ctx, op) \

    SSL_CTX_ctrl((ctx), SSL_CTRL_CERT_FLAGS, (op), NULL)

#define SSL_set_cert_flags(s, op) \

    SSL_ctrl((s), SSL_CTRL_CERT_FLAGS, (op), NULL)

#define SSL_CTX_clear_cert_flags(ctx, op) \

    SSL_CTX_ctrl((ctx), SSL_CTRL_CLEAR_CERT_FLAGS, (op), NULL)

#define SSL_clear_cert_flags(s, op) \

    SSL_ctrl((s), SSL_CTRL_CLEAR_CERT_FLAGS, (op), NULL)

void SSL_CTX_set_msg_callback(SSL_CTX *ctx,

    void (*cb)(int write_p, int version,

        int content_type, const void *buf,

        size_t len, SSL *ssl, void *arg));

void SSL_set_msg_callback(SSL *ssl,

    void (*cb)(int write_p, int version,

        int content_type, const void *buf,

        size_t len, SSL *ssl, void *arg));

#define SSL_CTX_set_msg_callback_arg(ctx, arg) SSL_CTX_ctrl((ctx), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))

#define SSL_set_msg_callback_arg(ssl, arg) SSL_ctrl((ssl), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))

#define SSL_get_extms_support(s) \

    SSL_ctrl((s), SSL_CTRL_GET_EXTMS_SUPPORT, 0, NULL)

#ifndef OPENSSL_NO_SRP

/* see tls_srp.c */

#ifndef OPENSSL_NO_DEPRECATED_3_0

OSSL_DEPRECATEDIN_3_0 __owur int SSL_SRP_CTX_init(SSL *s);

OSSL_DEPRECATEDIN_3_0 __owur int SSL_CTX_SRP_CTX_init(SSL_CTX *ctx);

OSSL_DEPRECATEDIN_3_0 int SSL_SRP_CTX_free(SSL *ctx);

OSSL_DEPRECATEDIN_3_0 int SSL_CTX_SRP_CTX_free(SSL_CTX *ctx);

OSSL_DEPRECATEDIN_3_0 __owur int SSL_srp_server_param_with_username(SSL *s,

    int *ad);

OSSL_DEPRECATEDIN_3_0 __owur int SRP_Calc_A_param(SSL *s);

#endif

#endif

/* 100k max cert list */

#define SSL_MAX_CERT_LIST_DEFAULT (1024 * 100)

#define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT (1024 * 20)

/*

 * This callback type is used inside SSL_CTX, SSL, and in the functions that

 * set them. It is used to override the generation of SSL/TLS session IDs in

 * a server. Return value should be zero on an error, non-zero to proceed.

 * Also, callbacks should themselves check if the id they generate is unique

 * otherwise the SSL handshake will fail with an error - callbacks can do

 * this using the 'ssl' value they're passed by;

 * SSL_has_matching_session_id(ssl, id, *id_len) The length value passed in

 * is set at the maximum size the session ID can be. In SSLv3/TLSv1 it is 32

 * bytes. The callback can alter this length to be less if desired. It is

 * also an error for the callback to set the size to zero.

 */

typedef int (*GEN_SESSION_CB)(SSL *ssl, unsigned char *id,

    unsigned int *id_len);

#define SSL_SESS_CACHE_OFF 0x0000

#define SSL_SESS_CACHE_CLIENT 0x0001

#define SSL_SESS_CACHE_SERVER 0x0002

#define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT | SSL_SESS_CACHE_SERVER)

#define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080

/* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */

#define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100

#define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200

#define SSL_SESS_CACHE_NO_INTERNAL \

    (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP | SSL_SESS_CACHE_NO_INTERNAL_STORE)

#define SSL_SESS_CACHE_UPDATE_TIME 0x0400

LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);

#define SSL_CTX_sess_number(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_NUMBER, 0, NULL)

#define SSL_CTX_sess_connect(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_CONNECT, 0, NULL)

#define SSL_CTX_sess_connect_good(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_CONNECT_GOOD, 0, NULL)

#define SSL_CTX_sess_connect_renegotiate(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_CONNECT_RENEGOTIATE, 0, NULL)

#define SSL_CTX_sess_accept(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_ACCEPT, 0, NULL)

#define SSL_CTX_sess_accept_renegotiate(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_ACCEPT_RENEGOTIATE, 0, NULL)

#define SSL_CTX_sess_accept_good(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_ACCEPT_GOOD, 0, NULL)

#define SSL_CTX_sess_hits(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_HIT, 0, NULL)

#define SSL_CTX_sess_cb_hits(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_CB_HIT, 0, NULL)

#define SSL_CTX_sess_misses(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_MISSES, 0, NULL)

#define SSL_CTX_sess_timeouts(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_TIMEOUTS, 0, NULL)

#define SSL_CTX_sess_cache_full(ctx) \

    SSL_CTX_ctrl(ctx, SSL_CTRL_SESS_CACHE_FULL, 0, NULL)

void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx,

    int (*new_session_cb)(struct ssl_st *ssl,

        SSL_SESSION *sess));

int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl,

    SSL_SESSION *sess);

void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx,

    void (*remove_session_cb)(struct ssl_ctx_st

                                  *ctx,

        SSL_SESSION *sess));

void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx,

    SSL_SESSION *sess);

void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx,

    SSL_SESSION *(*get_session_cb)(struct ssl_st

                                       *ssl,

        const unsigned char

            *data,

        int len,

        int *copy));

SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(struct ssl_st *ssl,

    const unsigned char *data,

    int len, int *copy);

void SSL_CTX_set_info_callback(SSL_CTX *ctx,

    void (*cb)(const SSL *ssl, int type, int val));

void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl, int type,

    int val);

void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx,

    int (*client_cert_cb)(SSL *ssl, X509 **x509,

        EVP_PKEY **pkey));

int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509 **x509,

    EVP_PKEY **pkey);

void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx,

    int (*app_gen_cookie_cb)(SSL *ssl,

        unsigned char

            *cookie,

        unsigned int

            *cookie_len));

void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx,

    int (*app_verify_cookie_cb)(SSL *ssl,

        const unsigned char *cookie,

        unsigned int

            cookie_len));

void SSL_CTX_set_stateless_cookie_generate_cb(

    SSL_CTX *ctx,

    int (*gen_stateless_cookie_cb)(SSL *ssl,

        unsigned char *cookie,

        size_t *cookie_len));

void SSL_CTX_set_stateless_cookie_verify_cb(

    SSL_CTX *ctx,

    int (*verify_stateless_cookie_cb)(SSL *ssl,

        const unsigned char *cookie,

        size_t cookie_len));

#ifndef OPENSSL_NO_NEXTPROTONEG

typedef int (*SSL_CTX_npn_advertised_cb_func)(SSL *ssl,

    const unsigned char **out,

    unsigned int *outlen,

    void *arg);

void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *s,

    SSL_CTX_npn_advertised_cb_func cb,

    void *arg);

#define SSL_CTX_set_npn_advertised_cb SSL_CTX_set_next_protos_advertised_cb

typedef int (*SSL_CTX_npn_select_cb_func)(SSL *s,

    unsigned char **out,

    unsigned char *outlen,

    const unsigned char *in,

    unsigned int inlen,

    void *arg);

void SSL_CTX_set_next_proto_select_cb(SSL_CTX *s,

    SSL_CTX_npn_select_cb_func cb,

    void *arg);

#define SSL_CTX_set_npn_select_cb SSL_CTX_set_next_proto_select_cb

void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data,

    unsigned *len);

#define SSL_get0_npn_negotiated SSL_get0_next_proto_negotiated

#endif

__owur int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,

    const unsigned char *server, unsigned int server_len,

    const unsigned char *client,

    unsigned int client_len);

#define OPENSSL_NPN_UNSUPPORTED 0

#define OPENSSL_NPN_NEGOTIATED 1

#define OPENSSL_NPN_NO_OVERLAP 2

__owur int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos,

    unsigned int protos_len);

__owur int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos,

    unsigned int protos_len);

typedef int (*SSL_CTX_alpn_select_cb_func)(SSL *ssl,

    const unsigned char **out,

    unsigned char *outlen,

    const unsigned char *in,

    unsigned int inlen,

    void *arg);

void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,

    SSL_CTX_alpn_select_cb_func cb,

    void *arg);

void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,

    unsigned int *len);

#ifndef OPENSSL_NO_PSK

/*

 * the maximum length of the buffer given to callbacks containing the

 * resulting identity/psk

 */

#define PSK_MAX_IDENTITY_LEN 256

#define PSK_MAX_PSK_LEN 512

typedef unsigned int (*SSL_psk_client_cb_func)(SSL *ssl,

    const char *hint,

    char *identity,

    unsigned int max_identity_len,

    unsigned char *psk,

    unsigned int max_psk_len);

void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, SSL_psk_client_cb_func cb);

void SSL_set_psk_client_callback(SSL *ssl, SSL_psk_client_cb_func cb);

typedef unsigned int (*SSL_psk_server_cb_func)(SSL *ssl,

    const char *identity,

    unsigned char *psk,

    unsigned int max_psk_len);

void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx, SSL_psk_server_cb_func cb);

void SSL_set_psk_server_callback(SSL *ssl, SSL_psk_server_cb_func cb);

__owur int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint);

__owur int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint);

const char *SSL_get_psk_identity_hint(const SSL *s);

const char *SSL_get_psk_identity(const SSL *s);

#endif

typedef int (*SSL_psk_find_session_cb_func)(SSL *ssl,

    const unsigned char *identity,

    size_t identity_len,

    SSL_SESSION **sess);

typedef int (*SSL_psk_use_session_cb_func)(SSL *ssl, const EVP_MD *md,

    const unsigned char **id,

    size_t *idlen,

    SSL_SESSION **sess);

void SSL_set_psk_find_session_callback(SSL *s, SSL_psk_find_session_cb_func cb);

void SSL_CTX_set_psk_find_session_callback(SSL_CTX *ctx,

    SSL_psk_find_session_cb_func cb);

void SSL_set_psk_use_session_callback(SSL *s, SSL_psk_use_session_cb_func cb);

void SSL_CTX_set_psk_use_session_callback(SSL_CTX *ctx,

    SSL_psk_use_session_cb_func cb);

/* Register callbacks to handle custom TLS Extensions for client or server. */

__owur int SSL_CTX_has_client_custom_ext(const SSL_CTX *ctx,

    unsigned int ext_type);

__owur int SSL_CTX_add_client_custom_ext(SSL_CTX *ctx,

    unsigned int ext_type,

    custom_ext_add_cb add_cb,

    custom_ext_free_cb free_cb,

    void *add_arg,

    custom_ext_parse_cb parse_cb,

    void *parse_arg);

__owur int SSL_CTX_add_server_custom_ext(SSL_CTX *ctx,

    unsigned int ext_type,

    custom_ext_add_cb add_cb,

    custom_ext_free_cb free_cb,

    void *add_arg,

    custom_ext_parse_cb parse_cb,

    void *parse_arg);

__owur int SSL_CTX_add_custom_ext(SSL_CTX *ctx, unsigned int ext_type,

    unsigned int context,

    SSL_custom_ext_add_cb_ex add_cb,

    SSL_custom_ext_free_cb_ex free_cb,

    void *add_arg,

    SSL_custom_ext_parse_cb_ex parse_cb,

    void *parse_arg);

__owur int SSL_extension_supported(unsigned int ext_type);

#define SSL_NOTHING 1

#define SSL_WRITING 2

#define SSL_READING 3

#define SSL_X509_LOOKUP 4

#define SSL_ASYNC_PAUSED 5

#define SSL_ASYNC_NO_JOBS 6

#define SSL_CLIENT_HELLO_CB 7

#define SSL_RETRY_VERIFY 8

/* These will only be used when doing non-blocking IO */

#define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING)

#define SSL_want_read(s) (SSL_want(s) == SSL_READING)

#define SSL_want_write(s) (SSL_want(s) == SSL_WRITING)

#define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP)

#define SSL_want_retry_verify(s) (SSL_want(s) == SSL_RETRY_VERIFY)

#define SSL_want_async(s) (SSL_want(s) == SSL_ASYNC_PAUSED)

#define SSL_want_async_job(s) (SSL_want(s) == SSL_ASYNC_NO_JOBS)

#define SSL_want_client_hello_cb(s) (SSL_want(s) == SSL_CLIENT_HELLO_CB)

#define SSL_MAC_FLAG_READ_MAC_STREAM 1

#define SSL_MAC_FLAG_WRITE_MAC_STREAM 2

#define SSL_MAC_FLAG_READ_MAC_TLSTREE 4

#define SSL_MAC_FLAG_WRITE_MAC_TLSTREE 8

/*

 * A callback for logging out TLS key material. This callback should log out

 * |line| followed by a newline.

 */

typedef void (*SSL_CTX_keylog_cb_func)(const SSL *ssl, const char *line);

/*

 * SSL_CTX_set_keylog_callback configures a callback to log key material. This

 * is intended for debugging use with tools like Wireshark. The cb function

 * should log line followed by a newline.

 */

void SSL_CTX_set_keylog_callback(SSL_CTX *ctx, SSL_CTX_keylog_cb_func cb);

/*

 * SSL_CTX_get_keylog_callback returns the callback configured by

 * SSL_CTX_set_keylog_callback.

 */

SSL_CTX_keylog_cb_func SSL_CTX_get_keylog_callback(const SSL_CTX *ctx);

int SSL_CTX_set_max_early_data(SSL_CTX *ctx, uint32_t max_early_data);

uint32_t SSL_CTX_get_max_early_data(const SSL_CTX *ctx);

int SSL_set_max_early_data(SSL *s, uint32_t max_early_data);

uint32_t SSL_get_max_early_data(const SSL *s);

int SSL_CTX_set_recv_max_early_data(SSL_CTX *ctx, uint32_t recv_max_early_data);

uint32_t SSL_CTX_get_recv_max_early_data(const SSL_CTX *ctx);

int SSL_set_recv_max_early_data(SSL *s, uint32_t recv_max_early_data);

uint32_t SSL_get_recv_max_early_data(const SSL *s);

#ifdef __cplusplus

}

#endif

#include <openssl/ssl2.h>

#include <openssl/ssl3.h>

#include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */

#include <openssl/dtls1.h> /* Datagram TLS */

#include <openssl/srtp.h> /* Support for the use_srtp extension */

#include <openssl/quic.h>

#ifdef __cplusplus

extern "C" {

#endif

/*

 * These need to be after the above set of includes due to a compiler bug

 * in VisualStudio 2015

 */

/* clang-format off */

SKM_DEFINE_STACK_OF_INTERNAL(SSL_CIPHER, const SSL_CIPHER, SSL_CIPHER)

#define sk_SSL_CIPHER_num(sk) OPENSSL_sk_num(ossl_check_const_SSL_CIPHER_sk_type(sk))

#define sk_SSL_CIPHER_value(sk, idx) ((const SSL_CIPHER *)OPENSSL_sk_value(ossl_check_const_SSL_CIPHER_sk_type(sk), (idx)))

#define sk_SSL_CIPHER_new(cmp) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new(ossl_check_SSL_CIPHER_compfunc_type(cmp)))

#define sk_SSL_CIPHER_new_null() ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new_null())

#define sk_SSL_CIPHER_new_reserve(cmp, n) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new_reserve(ossl_check_SSL_CIPHER_compfunc_type(cmp), (n)))

#define sk_SSL_CIPHER_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_SSL_CIPHER_sk_type(sk), (n))

#define sk_SSL_CIPHER_free(sk) OPENSSL_sk_free(ossl_check_SSL_CIPHER_sk_type(sk))

#define sk_SSL_CIPHER_zero(sk) OPENSSL_sk_zero(ossl_check_SSL_CIPHER_sk_type(sk))

#define sk_SSL_CIPHER_delete(sk, i) ((const SSL_CIPHER *)OPENSSL_sk_delete(ossl_check_SSL_CIPHER_sk_type(sk), (i)))

#define sk_SSL_CIPHER_delete_ptr(sk, ptr) ((const SSL_CIPHER *)OPENSSL_sk_delete_ptr(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr)))

#define sk_SSL_CIPHER_push(sk, ptr) OPENSSL_sk_push(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))

#define sk_SSL_CIPHER_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))

#define sk_SSL_CIPHER_pop(sk) ((const SSL_CIPHER *)OPENSSL_sk_pop(ossl_check_SSL_CIPHER_sk_type(sk)))

#define sk_SSL_CIPHER_shift(sk) ((const SSL_CIPHER *)OPENSSL_sk_shift(ossl_check_SSL_CIPHER_sk_type(sk)))

#define sk_SSL_CIPHER_pop_free(sk, freefunc) OPENSSL_sk_pop_free(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_freefunc_type(freefunc))

#define sk_SSL_CIPHER_insert(sk, ptr, idx) OPENSSL_sk_insert(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr), (idx))

#define sk_SSL_CIPHER_set(sk, idx, ptr) ((const SSL_CIPHER *)OPENSSL_sk_set(ossl_check_SSL_CIPHER_sk_type(sk), (idx), ossl_check_SSL_CIPHER_type(ptr)))

#define sk_SSL_CIPHER_find(sk, ptr) OPENSSL_sk_find(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))

#define sk_SSL_CIPHER_find_ex(sk, ptr) OPENSSL_sk_find_ex(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))

#define sk_SSL_CIPHER_find_all(sk, ptr, pnum) OPENSSL_sk_find_all(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr), pnum)

#define sk_SSL_CIPHER_sort(sk) OPENSSL_sk_sort(ossl_check_SSL_CIPHER_sk_type(sk))

#define sk_SSL_CIPHER_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_SSL_CIPHER_sk_type(sk))

#define sk_SSL_CIPHER_dup(sk) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_dup(ossl_check_const_SSL_CIPHER_sk_type(sk)))

#define sk_SSL_CIPHER_deep_copy(sk, copyfunc, freefunc) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_deep_copy(ossl_check_const_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_copyfunc_type(copyfunc), ossl_check_SSL_CIPHER_freefunc_type(freefunc)))

#define sk_SSL_CIPHER_set_cmp_func(sk, cmp) ((sk_SSL_CIPHER_compfunc)OPENSSL_sk_set_cmp_func(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_compfunc_type(cmp)))

/* clang-format on */

/* compatibility */

#define SSL_set_app_data(s, arg) (SSL_set_ex_data(s, 0, (char *)(arg)))

#define SSL_get_app_data(s) (SSL_get_ex_data(s, 0))

#define SSL_SESSION_set_app_data(s, a) (SSL_SESSION_set_ex_data(s, 0, \

    (char *)(a)))

#define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s, 0))

#define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx, 0))

#define SSL_CTX_set_app_data(ctx, arg) (SSL_CTX_set_ex_data(ctx, 0, \

    (char *)(arg)))

#ifndef OPENSSL_NO_DEPRECATED_1_1_0

OSSL_DEPRECATEDIN_1_1_0 void SSL_set_debug(SSL *s, int debug);

#endif

/* TLSv1.3 KeyUpdate message types */

/* -1 used so that this is an invalid value for the on-the-wire protocol */

#define SSL_KEY_UPDATE_NONE -1

/* Values as defined for the on-the-wire protocol */

#define SSL_KEY_UPDATE_NOT_REQUESTED 0

#define SSL_KEY_UPDATE_REQUESTED 1

/*

 * The valid handshake states (one for each type message sent and one for each

 * type of message received). There are also two "special" states:

 * TLS = TLS or DTLS state

 * DTLS = DTLS specific state

 * CR/SR = Client Read/Server Read

 * CW/SW = Client Write/Server Write

 *

 * The "special" states are:

 * TLS_ST_BEFORE = No handshake has been initiated yet

 * TLS_ST_OK = A handshake has been successfully completed

 */

typedef enum {

    TLS_ST_BEFORE,

    TLS_ST_OK,

    DTLS_ST_CR_HELLO_VERIFY_REQUEST,

    TLS_ST_CR_SRVR_HELLO,

    TLS_ST_CR_CERT,

    TLS_ST_CR_COMP_CERT,

    TLS_ST_CR_CERT_STATUS,

    TLS_ST_CR_KEY_EXCH,

    TLS_ST_CR_CERT_REQ,

    TLS_ST_CR_SRVR_DONE,

    TLS_ST_CR_SESSION_TICKET,

    TLS_ST_CR_CHANGE,

    TLS_ST_CR_FINISHED,

    TLS_ST_CW_CLNT_HELLO,

    TLS_ST_CW_CERT,

    TLS_ST_CW_COMP_CERT,

    TLS_ST_CW_KEY_EXCH,

    TLS_ST_CW_CERT_VRFY,

    TLS_ST_CW_CHANGE,

    TLS_ST_CW_NEXT_PROTO,

    TLS_ST_CW_FINISHED,

    TLS_ST_SW_HELLO_REQ,

    TLS_ST_SR_CLNT_HELLO,

    DTLS_ST_SW_HELLO_VERIFY_REQUEST,

    TLS_ST_SW_SRVR_HELLO,

    TLS_ST_SW_CERT,

    TLS_ST_SW_COMP_CERT,

    TLS_ST_SW_KEY_EXCH,

    TLS_ST_SW_CERT_REQ,

    TLS_ST_SW_SRVR_DONE,

    TLS_ST_SR_CERT,

    TLS_ST_SR_COMP_CERT,

    TLS_ST_SR_KEY_EXCH,

    TLS_ST_SR_CERT_VRFY,

    TLS_ST_SR_NEXT_PROTO,

    TLS_ST_SR_CHANGE,

    TLS_ST_SR_FINISHED,

    TLS_ST_SW_SESSION_TICKET,

    TLS_ST_SW_CERT_STATUS,

    TLS_ST_SW_CHANGE,

    TLS_ST_SW_FINISHED,

    TLS_ST_SW_ENCRYPTED_EXTENSIONS,

    TLS_ST_CR_ENCRYPTED_EXTENSIONS,

    TLS_ST_CR_CERT_VRFY,

    TLS_ST_SW_CERT_VRFY,

    TLS_ST_CR_HELLO_REQ,

    TLS_ST_SW_KEY_UPDATE,

    TLS_ST_CW_KEY_UPDATE,

    TLS_ST_SR_KEY_UPDATE,

    TLS_ST_CR_KEY_UPDATE,

    TLS_ST_EARLY_DATA,

    TLS_ST_PENDING_EARLY_DATA_END,

    TLS_ST_CW_END_OF_EARLY_DATA,

    TLS_ST_SR_END_OF_EARLY_DATA

} OSSL_HANDSHAKE_STATE;

/*

 * Most of the following state values are no longer used and are defined to be

 * the closest equivalent value in the current state machine code. Not all

 * defines have an equivalent and are set to a dummy value (-1). SSL_ST_CONNECT

 * and SSL_ST_ACCEPT are still in use in the definition of SSL_CB_ACCEPT_LOOP,

 * SSL_CB_ACCEPT_EXIT, SSL_CB_CONNECT_LOOP and SSL_CB_CONNECT_EXIT.

 */

#define SSL_ST_CONNECT 0x1000

#define SSL_ST_ACCEPT 0x2000

#define SSL_ST_MASK 0x0FFF

#define SSL_CB_LOOP 0x01

#define SSL_CB_EXIT 0x02

#define SSL_CB_READ 0x04

#define SSL_CB_WRITE 0x08