ssl.h 133 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878
  1. /*
  2. * WARNING: do not edit!
  3. * Generated by Makefile from include/openssl/ssl.h.in
  4. *
  5. * Copyright 1995-2024 The OpenSSL Project Authors. All Rights Reserved.
  6. * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
  7. * Copyright 2005 Nokia. All rights reserved.
  8. *
  9. * Licensed under the Apache License 2.0 (the "License"). You may not use
  10. * this file except in compliance with the License. You can obtain a copy
  11. * in the file LICENSE in the source distribution or at
  12. * https://www.openssl.org/source/license.html
  13. */
  14. #ifndef OPENSSL_SSL_H
  15. # define OPENSSL_SSL_H
  16. # pragma once
  17. # include <openssl/macros.h>
  18. # ifndef OPENSSL_NO_DEPRECATED_3_0
  19. # define HEADER_SSL_H
  20. # endif
  21. # include <openssl/e_os2.h>
  22. # include <openssl/e_ostime.h>
  23. # include <openssl/opensslconf.h>
  24. # include <openssl/comp.h>
  25. # include <openssl/bio.h>
  26. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  27. # include <openssl/x509.h>
  28. # include <openssl/crypto.h>
  29. # include <openssl/buffer.h>
  30. # endif
  31. # include <openssl/lhash.h>
  32. # include <openssl/pem.h>
  33. # include <openssl/hmac.h>
  34. # include <openssl/async.h>
  35. # include <openssl/safestack.h>
  36. # include <openssl/symhacks.h>
  37. # include <openssl/ct.h>
  38. # include <openssl/sslerr.h>
  39. # include <openssl/prov_ssl.h>
  40. # ifndef OPENSSL_NO_STDIO
  41. # include <stdio.h>
  42. # endif
  43. #ifdef __cplusplus
  44. extern "C" {
  45. #endif
  46. /* OpenSSL version number for ASN.1 encoding of the session information */
  47. /*-
  48. * Version 0 - initial version
  49. * Version 1 - added the optional peer certificate
  50. */
  51. # define SSL_SESSION_ASN1_VERSION 0x0001
  52. # define SSL_MAX_SSL_SESSION_ID_LENGTH 32
  53. # define SSL_MAX_SID_CTX_LENGTH 32
  54. # define SSL_MIN_RSA_MODULUS_LENGTH_IN_BYTES (512/8)
  55. # define SSL_MAX_KEY_ARG_LENGTH 8
  56. /* SSL_MAX_MASTER_KEY_LENGTH is defined in prov_ssl.h */
  57. /* The maximum number of encrypt/decrypt pipelines we can support */
  58. # define SSL_MAX_PIPELINES 32
  59. /* text strings for the ciphers */
  60. /* These are used to specify which ciphers to use and not to use */
  61. # define SSL_TXT_LOW "LOW"
  62. # define SSL_TXT_MEDIUM "MEDIUM"
  63. # define SSL_TXT_HIGH "HIGH"
  64. # define SSL_TXT_FIPS "FIPS"
  65. # define SSL_TXT_aNULL "aNULL"
  66. # define SSL_TXT_eNULL "eNULL"
  67. # define SSL_TXT_NULL "NULL"
  68. # define SSL_TXT_kRSA "kRSA"
  69. # define SSL_TXT_kDHr "kDHr"/* this cipher class has been removed */
  70. # define SSL_TXT_kDHd "kDHd"/* this cipher class has been removed */
  71. # define SSL_TXT_kDH "kDH"/* this cipher class has been removed */
  72. # define SSL_TXT_kEDH "kEDH"/* alias for kDHE */
  73. # define SSL_TXT_kDHE "kDHE"
  74. # define SSL_TXT_kECDHr "kECDHr"/* this cipher class has been removed */
  75. # define SSL_TXT_kECDHe "kECDHe"/* this cipher class has been removed */
  76. # define SSL_TXT_kECDH "kECDH"/* this cipher class has been removed */
  77. # define SSL_TXT_kEECDH "kEECDH"/* alias for kECDHE */
  78. # define SSL_TXT_kECDHE "kECDHE"
  79. # define SSL_TXT_kPSK "kPSK"
  80. # define SSL_TXT_kRSAPSK "kRSAPSK"
  81. # define SSL_TXT_kECDHEPSK "kECDHEPSK"
  82. # define SSL_TXT_kDHEPSK "kDHEPSK"
  83. # define SSL_TXT_kGOST "kGOST"
  84. # define SSL_TXT_kGOST18 "kGOST18"
  85. # define SSL_TXT_kSRP "kSRP"
  86. # define SSL_TXT_aRSA "aRSA"
  87. # define SSL_TXT_aDSS "aDSS"
  88. # define SSL_TXT_aDH "aDH"/* this cipher class has been removed */
  89. # define SSL_TXT_aECDH "aECDH"/* this cipher class has been removed */
  90. # define SSL_TXT_aECDSA "aECDSA"
  91. # define SSL_TXT_aPSK "aPSK"
  92. # define SSL_TXT_aGOST94 "aGOST94"
  93. # define SSL_TXT_aGOST01 "aGOST01"
  94. # define SSL_TXT_aGOST12 "aGOST12"
  95. # define SSL_TXT_aGOST "aGOST"
  96. # define SSL_TXT_aSRP "aSRP"
  97. # define SSL_TXT_DSS "DSS"
  98. # define SSL_TXT_DH "DH"
  99. # define SSL_TXT_DHE "DHE"/* same as "kDHE:-ADH" */
  100. # define SSL_TXT_EDH "EDH"/* alias for DHE */
  101. # define SSL_TXT_ADH "ADH"
  102. # define SSL_TXT_RSA "RSA"
  103. # define SSL_TXT_ECDH "ECDH"
  104. # define SSL_TXT_EECDH "EECDH"/* alias for ECDHE" */
  105. # define SSL_TXT_ECDHE "ECDHE"/* same as "kECDHE:-AECDH" */
  106. # define SSL_TXT_AECDH "AECDH"
  107. # define SSL_TXT_ECDSA "ECDSA"
  108. # define SSL_TXT_PSK "PSK"
  109. # define SSL_TXT_SRP "SRP"
  110. # define SSL_TXT_DES "DES"
  111. # define SSL_TXT_3DES "3DES"
  112. # define SSL_TXT_RC4 "RC4"
  113. # define SSL_TXT_RC2 "RC2"
  114. # define SSL_TXT_IDEA "IDEA"
  115. # define SSL_TXT_SEED "SEED"
  116. # define SSL_TXT_AES128 "AES128"
  117. # define SSL_TXT_AES256 "AES256"
  118. # define SSL_TXT_AES "AES"
  119. # define SSL_TXT_AES_GCM "AESGCM"
  120. # define SSL_TXT_AES_CCM "AESCCM"
  121. # define SSL_TXT_AES_CCM_8 "AESCCM8"
  122. # define SSL_TXT_CAMELLIA128 "CAMELLIA128"
  123. # define SSL_TXT_CAMELLIA256 "CAMELLIA256"
  124. # define SSL_TXT_CAMELLIA "CAMELLIA"
  125. # define SSL_TXT_CHACHA20 "CHACHA20"
  126. # define SSL_TXT_GOST "GOST89"
  127. # define SSL_TXT_ARIA "ARIA"
  128. # define SSL_TXT_ARIA_GCM "ARIAGCM"
  129. # define SSL_TXT_ARIA128 "ARIA128"
  130. # define SSL_TXT_ARIA256 "ARIA256"
  131. # define SSL_TXT_GOST2012_GOST8912_GOST8912 "GOST2012-GOST8912-GOST8912"
  132. # define SSL_TXT_CBC "CBC"
  133. # define SSL_TXT_MD5 "MD5"
  134. # define SSL_TXT_SHA1 "SHA1"
  135. # define SSL_TXT_SHA "SHA"/* same as "SHA1" */
  136. # define SSL_TXT_GOST94 "GOST94"
  137. # define SSL_TXT_GOST89MAC "GOST89MAC"
  138. # define SSL_TXT_GOST12 "GOST12"
  139. # define SSL_TXT_GOST89MAC12 "GOST89MAC12"
  140. # define SSL_TXT_SHA256 "SHA256"
  141. # define SSL_TXT_SHA384 "SHA384"
  142. # define SSL_TXT_SSLV3 "SSLv3"
  143. # define SSL_TXT_TLSV1 "TLSv1"
  144. # define SSL_TXT_TLSV1_1 "TLSv1.1"
  145. # define SSL_TXT_TLSV1_2 "TLSv1.2"
  146. # define SSL_TXT_ALL "ALL"
  147. /*-
  148. * COMPLEMENTOF* definitions. These identifiers are used to (de-select)
  149. * ciphers normally not being used.
  150. * Example: "RC4" will activate all ciphers using RC4 including ciphers
  151. * without authentication, which would normally disabled by DEFAULT (due
  152. * the "!ADH" being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT"
  153. * will make sure that it is also disabled in the specific selection.
  154. * COMPLEMENTOF* identifiers are portable between version, as adjustments
  155. * to the default cipher setup will also be included here.
  156. *
  157. * COMPLEMENTOFDEFAULT does not experience the same special treatment that
  158. * DEFAULT gets, as only selection is being done and no sorting as needed
  159. * for DEFAULT.
  160. */
  161. # define SSL_TXT_CMPALL "COMPLEMENTOFALL"
  162. # define SSL_TXT_CMPDEF "COMPLEMENTOFDEFAULT"
  163. /*
  164. * The following cipher list is used by default. It also is substituted when
  165. * an application-defined cipher list string starts with 'DEFAULT'.
  166. * This applies to ciphersuites for TLSv1.2 and below.
  167. * DEPRECATED IN 3.0.0, in favor of OSSL_default_cipher_list()
  168. * Update both macro and function simultaneously
  169. */
  170. # ifndef OPENSSL_NO_DEPRECATED_3_0
  171. # define SSL_DEFAULT_CIPHER_LIST "ALL:!COMPLEMENTOFDEFAULT:!eNULL"
  172. /*
  173. * This is the default set of TLSv1.3 ciphersuites
  174. * DEPRECATED IN 3.0.0, in favor of OSSL_default_ciphersuites()
  175. * Update both macro and function simultaneously
  176. */
  177. # define TLS_DEFAULT_CIPHERSUITES "TLS_AES_256_GCM_SHA384:" \
  178. "TLS_CHACHA20_POLY1305_SHA256:" \
  179. "TLS_AES_128_GCM_SHA256"
  180. # endif
  181. /*
  182. * As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always
  183. * starts with a reasonable order, and all we have to do for DEFAULT is
  184. * throwing out anonymous and unencrypted ciphersuites! (The latter are not
  185. * actually enabled by ALL, but "ALL:RSA" would enable some of them.)
  186. */
  187. /* Used in SSL_set_shutdown()/SSL_get_shutdown(); */
  188. # define SSL_SENT_SHUTDOWN 1
  189. # define SSL_RECEIVED_SHUTDOWN 2
  190. #ifdef __cplusplus
  191. }
  192. #endif
  193. #ifdef __cplusplus
  194. extern "C" {
  195. #endif
  196. # define SSL_FILETYPE_ASN1 X509_FILETYPE_ASN1
  197. # define SSL_FILETYPE_PEM X509_FILETYPE_PEM
  198. /*
  199. * This is needed to stop compilers complaining about the 'struct ssl_st *'
  200. * function parameters used to prototype callbacks in SSL_CTX.
  201. */
  202. typedef struct ssl_st *ssl_crock_st;
  203. typedef struct tls_session_ticket_ext_st TLS_SESSION_TICKET_EXT;
  204. typedef struct ssl_method_st SSL_METHOD;
  205. typedef struct ssl_cipher_st SSL_CIPHER;
  206. typedef struct ssl_session_st SSL_SESSION;
  207. typedef struct tls_sigalgs_st TLS_SIGALGS;
  208. typedef struct ssl_conf_ctx_st SSL_CONF_CTX;
  209. STACK_OF(SSL_CIPHER);
  210. /* SRTP protection profiles for use with the use_srtp extension (RFC 5764)*/
  211. typedef struct srtp_protection_profile_st {
  212. const char *name;
  213. unsigned long id;
  214. } SRTP_PROTECTION_PROFILE;
  215. SKM_DEFINE_STACK_OF_INTERNAL(SRTP_PROTECTION_PROFILE, SRTP_PROTECTION_PROFILE, SRTP_PROTECTION_PROFILE)
  216. #define sk_SRTP_PROTECTION_PROFILE_num(sk) OPENSSL_sk_num(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk))
  217. #define sk_SRTP_PROTECTION_PROFILE_value(sk, idx) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_value(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk), (idx)))
  218. #define sk_SRTP_PROTECTION_PROFILE_new(cmp) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_new(ossl_check_SRTP_PROTECTION_PROFILE_compfunc_type(cmp)))
  219. #define sk_SRTP_PROTECTION_PROFILE_new_null() ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_new_null())
  220. #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)))
  221. #define sk_SRTP_PROTECTION_PROFILE_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), (n))
  222. #define sk_SRTP_PROTECTION_PROFILE_free(sk) OPENSSL_sk_free(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))
  223. #define sk_SRTP_PROTECTION_PROFILE_zero(sk) OPENSSL_sk_zero(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))
  224. #define sk_SRTP_PROTECTION_PROFILE_delete(sk, i) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_delete(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk), (i)))
  225. #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)))
  226. #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))
  227. #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))
  228. #define sk_SRTP_PROTECTION_PROFILE_pop(sk) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_pop(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk)))
  229. #define sk_SRTP_PROTECTION_PROFILE_shift(sk) ((SRTP_PROTECTION_PROFILE *)OPENSSL_sk_shift(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk)))
  230. #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))
  231. #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))
  232. #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)))
  233. #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))
  234. #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))
  235. #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)
  236. #define sk_SRTP_PROTECTION_PROFILE_sort(sk) OPENSSL_sk_sort(ossl_check_SRTP_PROTECTION_PROFILE_sk_type(sk))
  237. #define sk_SRTP_PROTECTION_PROFILE_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk))
  238. #define sk_SRTP_PROTECTION_PROFILE_dup(sk) ((STACK_OF(SRTP_PROTECTION_PROFILE) *)OPENSSL_sk_dup(ossl_check_const_SRTP_PROTECTION_PROFILE_sk_type(sk)))
  239. #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)))
  240. #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)))
  241. typedef int (*tls_session_ticket_ext_cb_fn)(SSL *s, const unsigned char *data,
  242. int len, void *arg);
  243. typedef int (*tls_session_secret_cb_fn)(SSL *s, void *secret, int *secret_len,
  244. STACK_OF(SSL_CIPHER) *peer_ciphers,
  245. const SSL_CIPHER **cipher, void *arg);
  246. /* Extension context codes */
  247. /* This extension is only allowed in TLS */
  248. #define SSL_EXT_TLS_ONLY 0x00001
  249. /* This extension is only allowed in DTLS */
  250. #define SSL_EXT_DTLS_ONLY 0x00002
  251. /* Some extensions may be allowed in DTLS but we don't implement them for it */
  252. #define SSL_EXT_TLS_IMPLEMENTATION_ONLY 0x00004
  253. /* Most extensions are not defined for SSLv3 but EXT_TYPE_renegotiate is */
  254. #define SSL_EXT_SSL3_ALLOWED 0x00008
  255. /* Extension is only defined for TLS1.2 and below */
  256. #define SSL_EXT_TLS1_2_AND_BELOW_ONLY 0x00010
  257. /* Extension is only defined for TLS1.3 and above */
  258. #define SSL_EXT_TLS1_3_ONLY 0x00020
  259. /* Ignore this extension during parsing if we are resuming */
  260. #define SSL_EXT_IGNORE_ON_RESUMPTION 0x00040
  261. #define SSL_EXT_CLIENT_HELLO 0x00080
  262. /* Really means TLS1.2 or below */
  263. #define SSL_EXT_TLS1_2_SERVER_HELLO 0x00100
  264. #define SSL_EXT_TLS1_3_SERVER_HELLO 0x00200
  265. #define SSL_EXT_TLS1_3_ENCRYPTED_EXTENSIONS 0x00400
  266. #define SSL_EXT_TLS1_3_HELLO_RETRY_REQUEST 0x00800
  267. #define SSL_EXT_TLS1_3_CERTIFICATE 0x01000
  268. #define SSL_EXT_TLS1_3_NEW_SESSION_TICKET 0x02000
  269. #define SSL_EXT_TLS1_3_CERTIFICATE_REQUEST 0x04000
  270. #define SSL_EXT_TLS1_3_CERTIFICATE_COMPRESSION 0x08000
  271. /* When sending a raw public key in a certificate message */
  272. #define SSL_EXT_TLS1_3_RAW_PUBLIC_KEY 0x10000
  273. /* Typedefs for handling custom extensions */
  274. typedef int (*custom_ext_add_cb)(SSL *s, unsigned int ext_type,
  275. const unsigned char **out, size_t *outlen,
  276. int *al, void *add_arg);
  277. typedef void (*custom_ext_free_cb)(SSL *s, unsigned int ext_type,
  278. const unsigned char *out, void *add_arg);
  279. typedef int (*custom_ext_parse_cb)(SSL *s, unsigned int ext_type,
  280. const unsigned char *in, size_t inlen,
  281. int *al, void *parse_arg);
  282. typedef int (*SSL_custom_ext_add_cb_ex)(SSL *s, unsigned int ext_type,
  283. unsigned int context,
  284. const unsigned char **out,
  285. size_t *outlen, X509 *x,
  286. size_t chainidx,
  287. int *al, void *add_arg);
  288. typedef void (*SSL_custom_ext_free_cb_ex)(SSL *s, unsigned int ext_type,
  289. unsigned int context,
  290. const unsigned char *out,
  291. void *add_arg);
  292. typedef int (*SSL_custom_ext_parse_cb_ex)(SSL *s, unsigned int ext_type,
  293. unsigned int context,
  294. const unsigned char *in,
  295. size_t inlen, X509 *x,
  296. size_t chainidx,
  297. int *al, void *parse_arg);
  298. /* Typedef for verification callback */
  299. typedef int (*SSL_verify_cb)(int preverify_ok, X509_STORE_CTX *x509_ctx);
  300. /* Typedef for SSL async callback */
  301. typedef int (*SSL_async_callback_fn)(SSL *s, void *arg);
  302. #define SSL_OP_BIT(n) ((uint64_t)1 << (uint64_t)n)
  303. /*
  304. * SSL/TLS connection options.
  305. */
  306. /* Disable Extended master secret */
  307. # define SSL_OP_NO_EXTENDED_MASTER_SECRET SSL_OP_BIT(0)
  308. /* Cleanse plaintext copies of data delivered to the application */
  309. # define SSL_OP_CLEANSE_PLAINTEXT SSL_OP_BIT(1)
  310. /* Allow initial connection to servers that don't support RI */
  311. # define SSL_OP_LEGACY_SERVER_CONNECT SSL_OP_BIT(2)
  312. /* Enable support for Kernel TLS */
  313. # define SSL_OP_ENABLE_KTLS SSL_OP_BIT(3)
  314. # define SSL_OP_TLSEXT_PADDING SSL_OP_BIT(4)
  315. # define SSL_OP_SAFARI_ECDHE_ECDSA_BUG SSL_OP_BIT(6)
  316. # define SSL_OP_IGNORE_UNEXPECTED_EOF SSL_OP_BIT(7)
  317. # define SSL_OP_ALLOW_CLIENT_RENEGOTIATION SSL_OP_BIT(8)
  318. # define SSL_OP_DISABLE_TLSEXT_CA_NAMES SSL_OP_BIT(9)
  319. /* In TLSv1.3 allow a non-(ec)dhe based kex_mode */
  320. # define SSL_OP_ALLOW_NO_DHE_KEX SSL_OP_BIT(10)
  321. /*
  322. * Disable SSL 3.0/TLS 1.0 CBC vulnerability workaround that was added
  323. * in OpenSSL 0.9.6d. Usually (depending on the application protocol)
  324. * the workaround is not needed. Unfortunately some broken SSL/TLS
  325. * implementations cannot handle it at all, which is why we include it
  326. * in SSL_OP_ALL. Added in 0.9.6e
  327. */
  328. # define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS SSL_OP_BIT(11)
  329. /* DTLS options */
  330. # define SSL_OP_NO_QUERY_MTU SSL_OP_BIT(12)
  331. /* Turn on Cookie Exchange (on relevant for servers) */
  332. # define SSL_OP_COOKIE_EXCHANGE SSL_OP_BIT(13)
  333. /* Don't use RFC4507 ticket extension */
  334. # define SSL_OP_NO_TICKET SSL_OP_BIT(14)
  335. # ifndef OPENSSL_NO_DTLS1_METHOD
  336. /*
  337. * Use Cisco's version identifier of DTLS_BAD_VER
  338. * (only with deprecated DTLSv1_client_method())
  339. */
  340. # define SSL_OP_CISCO_ANYCONNECT SSL_OP_BIT(15)
  341. # endif
  342. /* As server, disallow session resumption on renegotiation */
  343. # define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION SSL_OP_BIT(16)
  344. /* Don't use compression even if supported */
  345. # define SSL_OP_NO_COMPRESSION SSL_OP_BIT(17)
  346. /* Permit unsafe legacy renegotiation */
  347. # define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION SSL_OP_BIT(18)
  348. /* Disable encrypt-then-mac */
  349. # define SSL_OP_NO_ENCRYPT_THEN_MAC SSL_OP_BIT(19)
  350. /*
  351. * Enable TLSv1.3 Compatibility mode. This is on by default. A future
  352. * version of OpenSSL may have this disabled by default.
  353. */
  354. # define SSL_OP_ENABLE_MIDDLEBOX_COMPAT SSL_OP_BIT(20)
  355. /*
  356. * Prioritize Chacha20Poly1305 when client does.
  357. * Modifies SSL_OP_CIPHER_SERVER_PREFERENCE
  358. */
  359. # define SSL_OP_PRIORITIZE_CHACHA SSL_OP_BIT(21)
  360. /*
  361. * Set on servers to choose the cipher according to server's preferences.
  362. */
  363. # define SSL_OP_CIPHER_SERVER_PREFERENCE SSL_OP_BIT(22)
  364. /*
  365. * If set, a server will allow a client to issue a SSLv3.0 version
  366. * number as latest version supported in the premaster secret, even when
  367. * TLSv1.0 (version 3.1) was announced in the client hello. Normally
  368. * this is forbidden to prevent version rollback attacks.
  369. */
  370. # define SSL_OP_TLS_ROLLBACK_BUG SSL_OP_BIT(23)
  371. /*
  372. * Switches off automatic TLSv1.3 anti-replay protection for early data.
  373. * This is a server-side option only (no effect on the client).
  374. */
  375. # define SSL_OP_NO_ANTI_REPLAY SSL_OP_BIT(24)
  376. # define SSL_OP_NO_SSLv3 SSL_OP_BIT(25)
  377. # define SSL_OP_NO_TLSv1 SSL_OP_BIT(26)
  378. # define SSL_OP_NO_TLSv1_2 SSL_OP_BIT(27)
  379. # define SSL_OP_NO_TLSv1_1 SSL_OP_BIT(28)
  380. # define SSL_OP_NO_TLSv1_3 SSL_OP_BIT(29)
  381. # define SSL_OP_NO_DTLSv1 SSL_OP_BIT(26)
  382. # define SSL_OP_NO_DTLSv1_2 SSL_OP_BIT(27)
  383. /* Disallow all renegotiation */
  384. # define SSL_OP_NO_RENEGOTIATION SSL_OP_BIT(30)
  385. /*
  386. * Make server add server-hello extension from early version of
  387. * cryptopro draft, when GOST ciphersuite is negotiated. Required for
  388. * interoperability with CryptoPro CSP 3.x
  389. */
  390. # define SSL_OP_CRYPTOPRO_TLSEXT_BUG SSL_OP_BIT(31)
  391. /*
  392. * Disable RFC8879 certificate compression
  393. * SSL_OP_NO_TX_CERTIFICATE_COMPRESSION: don't send compressed certificates,
  394. * and ignore the extension when received.
  395. * SSL_OP_NO_RX_CERTIFICATE_COMPRESSION: don't send the extension, and
  396. * subsequently indicating that receiving is not supported
  397. */
  398. # define SSL_OP_NO_TX_CERTIFICATE_COMPRESSION SSL_OP_BIT(32)
  399. # define SSL_OP_NO_RX_CERTIFICATE_COMPRESSION SSL_OP_BIT(33)
  400. /* Enable KTLS TX zerocopy on Linux */
  401. # define SSL_OP_ENABLE_KTLS_TX_ZEROCOPY_SENDFILE SSL_OP_BIT(34)
  402. #define SSL_OP_PREFER_NO_DHE_KEX SSL_OP_BIT(35)
  403. /*
  404. * Option "collections."
  405. */
  406. # define SSL_OP_NO_SSL_MASK \
  407. ( SSL_OP_NO_SSLv3 | SSL_OP_NO_TLSv1 | SSL_OP_NO_TLSv1_1 \
  408. | SSL_OP_NO_TLSv1_2 | SSL_OP_NO_TLSv1_3 )
  409. # define SSL_OP_NO_DTLS_MASK \
  410. ( SSL_OP_NO_DTLSv1 | SSL_OP_NO_DTLSv1_2 )
  411. /* Various bug workarounds that should be rather harmless. */
  412. # define SSL_OP_ALL \
  413. ( SSL_OP_CRYPTOPRO_TLSEXT_BUG | SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS \
  414. | SSL_OP_TLSEXT_PADDING | SSL_OP_SAFARI_ECDHE_ECDSA_BUG )
  415. /*
  416. * OBSOLETE OPTIONS retained for compatibility
  417. */
  418. # define SSL_OP_MICROSOFT_SESS_ID_BUG 0x0
  419. # define SSL_OP_NETSCAPE_CHALLENGE_BUG 0x0
  420. # define SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG 0x0
  421. # define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG 0x0
  422. # define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER 0x0
  423. # define SSL_OP_MSIE_SSLV2_RSA_PADDING 0x0
  424. # define SSL_OP_SSLEAY_080_CLIENT_DH_BUG 0x0
  425. # define SSL_OP_TLS_D5_BUG 0x0
  426. # define SSL_OP_TLS_BLOCK_PADDING_BUG 0x0
  427. # define SSL_OP_SINGLE_ECDH_USE 0x0
  428. # define SSL_OP_SINGLE_DH_USE 0x0
  429. # define SSL_OP_EPHEMERAL_RSA 0x0
  430. # define SSL_OP_NO_SSLv2 0x0
  431. # define SSL_OP_PKCS1_CHECK_1 0x0
  432. # define SSL_OP_PKCS1_CHECK_2 0x0
  433. # define SSL_OP_NETSCAPE_CA_DN_BUG 0x0
  434. # define SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG 0x0
  435. /*
  436. * Allow SSL_write(..., n) to return r with 0 < r < n (i.e. report success
  437. * when just a single record has been written):
  438. */
  439. # define SSL_MODE_ENABLE_PARTIAL_WRITE 0x00000001U
  440. /*
  441. * Make it possible to retry SSL_write() with changed buffer location (buffer
  442. * contents must stay the same!); this is not the default to avoid the
  443. * misconception that non-blocking SSL_write() behaves like non-blocking
  444. * write():
  445. */
  446. # define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002U
  447. /*
  448. * Never bother the application with retries if the transport is blocking:
  449. */
  450. # define SSL_MODE_AUTO_RETRY 0x00000004U
  451. /* Don't attempt to automatically build certificate chain */
  452. # define SSL_MODE_NO_AUTO_CHAIN 0x00000008U
  453. /*
  454. * Save RAM by releasing read and write buffers when they're empty. (SSL3 and
  455. * TLS only.) Released buffers are freed.
  456. */
  457. # define SSL_MODE_RELEASE_BUFFERS 0x00000010U
  458. /*
  459. * Send the current time in the Random fields of the ClientHello and
  460. * ServerHello records for compatibility with hypothetical implementations
  461. * that require it.
  462. */
  463. # define SSL_MODE_SEND_CLIENTHELLO_TIME 0x00000020U
  464. # define SSL_MODE_SEND_SERVERHELLO_TIME 0x00000040U
  465. /*
  466. * Send TLS_FALLBACK_SCSV in the ClientHello. To be set only by applications
  467. * that reconnect with a downgraded protocol version; see
  468. * draft-ietf-tls-downgrade-scsv-00 for details. DO NOT ENABLE THIS if your
  469. * application attempts a normal handshake. Only use this in explicit
  470. * fallback retries, following the guidance in
  471. * draft-ietf-tls-downgrade-scsv-00.
  472. */
  473. # define SSL_MODE_SEND_FALLBACK_SCSV 0x00000080U
  474. /*
  475. * Support Asynchronous operation
  476. */
  477. # define SSL_MODE_ASYNC 0x00000100U
  478. /*
  479. * When using DTLS/SCTP, include the terminating zero in the label
  480. * used for computing the endpoint-pair shared secret. Required for
  481. * interoperability with implementations having this bug like these
  482. * older version of OpenSSL:
  483. * - OpenSSL 1.0.0 series
  484. * - OpenSSL 1.0.1 series
  485. * - OpenSSL 1.0.2 series
  486. * - OpenSSL 1.1.0 series
  487. * - OpenSSL 1.1.1 and 1.1.1a
  488. */
  489. # define SSL_MODE_DTLS_SCTP_LABEL_LENGTH_BUG 0x00000400U
  490. /* Cert related flags */
  491. /*
  492. * Many implementations ignore some aspects of the TLS standards such as
  493. * enforcing certificate chain algorithms. When this is set we enforce them.
  494. */
  495. # define SSL_CERT_FLAG_TLS_STRICT 0x00000001U
  496. /* Suite B modes, takes same values as certificate verify flags */
  497. # define SSL_CERT_FLAG_SUITEB_128_LOS_ONLY 0x10000
  498. /* Suite B 192 bit only mode */
  499. # define SSL_CERT_FLAG_SUITEB_192_LOS 0x20000
  500. /* Suite B 128 bit mode allowing 192 bit algorithms */
  501. # define SSL_CERT_FLAG_SUITEB_128_LOS 0x30000
  502. /* Perform all sorts of protocol violations for testing purposes */
  503. # define SSL_CERT_FLAG_BROKEN_PROTOCOL 0x10000000
  504. /* Flags for building certificate chains */
  505. /* Treat any existing certificates as untrusted CAs */
  506. # define SSL_BUILD_CHAIN_FLAG_UNTRUSTED 0x1
  507. /* Don't include root CA in chain */
  508. # define SSL_BUILD_CHAIN_FLAG_NO_ROOT 0x2
  509. /* Just check certificates already there */
  510. # define SSL_BUILD_CHAIN_FLAG_CHECK 0x4
  511. /* Ignore verification errors */
  512. # define SSL_BUILD_CHAIN_FLAG_IGNORE_ERROR 0x8
  513. /* Clear verification errors from queue */
  514. # define SSL_BUILD_CHAIN_FLAG_CLEAR_ERROR 0x10
  515. /* Flags returned by SSL_check_chain */
  516. /* Certificate can be used with this session */
  517. # define CERT_PKEY_VALID 0x1
  518. /* Certificate can also be used for signing */
  519. # define CERT_PKEY_SIGN 0x2
  520. /* EE certificate signing algorithm OK */
  521. # define CERT_PKEY_EE_SIGNATURE 0x10
  522. /* CA signature algorithms OK */
  523. # define CERT_PKEY_CA_SIGNATURE 0x20
  524. /* EE certificate parameters OK */
  525. # define CERT_PKEY_EE_PARAM 0x40
  526. /* CA certificate parameters OK */
  527. # define CERT_PKEY_CA_PARAM 0x80
  528. /* Signing explicitly allowed as opposed to SHA1 fallback */
  529. # define CERT_PKEY_EXPLICIT_SIGN 0x100
  530. /* Client CA issuer names match (always set for server cert) */
  531. # define CERT_PKEY_ISSUER_NAME 0x200
  532. /* Cert type matches client types (always set for server cert) */
  533. # define CERT_PKEY_CERT_TYPE 0x400
  534. /* Cert chain suitable to Suite B */
  535. # define CERT_PKEY_SUITEB 0x800
  536. /* Cert pkey valid for raw public key use */
  537. # define CERT_PKEY_RPK 0x1000
  538. # define SSL_CONF_FLAG_CMDLINE 0x1
  539. # define SSL_CONF_FLAG_FILE 0x2
  540. # define SSL_CONF_FLAG_CLIENT 0x4
  541. # define SSL_CONF_FLAG_SERVER 0x8
  542. # define SSL_CONF_FLAG_SHOW_ERRORS 0x10
  543. # define SSL_CONF_FLAG_CERTIFICATE 0x20
  544. # define SSL_CONF_FLAG_REQUIRE_PRIVATE 0x40
  545. /* Configuration value types */
  546. # define SSL_CONF_TYPE_UNKNOWN 0x0
  547. # define SSL_CONF_TYPE_STRING 0x1
  548. # define SSL_CONF_TYPE_FILE 0x2
  549. # define SSL_CONF_TYPE_DIR 0x3
  550. # define SSL_CONF_TYPE_NONE 0x4
  551. # define SSL_CONF_TYPE_STORE 0x5
  552. /* Maximum length of the application-controlled segment of a a TLSv1.3 cookie */
  553. # define SSL_COOKIE_LENGTH 4096
  554. /*
  555. * Note: SSL[_CTX]_set_{options,mode} use |= op on the previous value, they
  556. * cannot be used to clear bits.
  557. */
  558. uint64_t SSL_CTX_get_options(const SSL_CTX *ctx);
  559. uint64_t SSL_get_options(const SSL *s);
  560. uint64_t SSL_CTX_clear_options(SSL_CTX *ctx, uint64_t op);
  561. uint64_t SSL_clear_options(SSL *s, uint64_t op);
  562. uint64_t SSL_CTX_set_options(SSL_CTX *ctx, uint64_t op);
  563. uint64_t SSL_set_options(SSL *s, uint64_t op);
  564. # define SSL_CTX_set_mode(ctx,op) \
  565. SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,(op),NULL)
  566. # define SSL_CTX_clear_mode(ctx,op) \
  567. SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_MODE,(op),NULL)
  568. # define SSL_CTX_get_mode(ctx) \
  569. SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,0,NULL)
  570. # define SSL_clear_mode(ssl,op) \
  571. SSL_ctrl((ssl),SSL_CTRL_CLEAR_MODE,(op),NULL)
  572. # define SSL_set_mode(ssl,op) \
  573. SSL_ctrl((ssl),SSL_CTRL_MODE,(op),NULL)
  574. # define SSL_get_mode(ssl) \
  575. SSL_ctrl((ssl),SSL_CTRL_MODE,0,NULL)
  576. # define SSL_set_mtu(ssl, mtu) \
  577. SSL_ctrl((ssl),SSL_CTRL_SET_MTU,(mtu),NULL)
  578. # define DTLS_set_link_mtu(ssl, mtu) \
  579. SSL_ctrl((ssl),DTLS_CTRL_SET_LINK_MTU,(mtu),NULL)
  580. # define DTLS_get_link_min_mtu(ssl) \
  581. SSL_ctrl((ssl),DTLS_CTRL_GET_LINK_MIN_MTU,0,NULL)
  582. # define SSL_get_secure_renegotiation_support(ssl) \
  583. SSL_ctrl((ssl), SSL_CTRL_GET_RI_SUPPORT, 0, NULL)
  584. # define SSL_CTX_set_cert_flags(ctx,op) \
  585. SSL_CTX_ctrl((ctx),SSL_CTRL_CERT_FLAGS,(op),NULL)
  586. # define SSL_set_cert_flags(s,op) \
  587. SSL_ctrl((s),SSL_CTRL_CERT_FLAGS,(op),NULL)
  588. # define SSL_CTX_clear_cert_flags(ctx,op) \
  589. SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL)
  590. # define SSL_clear_cert_flags(s,op) \
  591. SSL_ctrl((s),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL)
  592. void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
  593. void (*cb) (int write_p, int version,
  594. int content_type, const void *buf,
  595. size_t len, SSL *ssl, void *arg));
  596. void SSL_set_msg_callback(SSL *ssl,
  597. void (*cb) (int write_p, int version,
  598. int content_type, const void *buf,
  599. size_t len, SSL *ssl, void *arg));
  600. # define SSL_CTX_set_msg_callback_arg(ctx, arg) SSL_CTX_ctrl((ctx), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
  601. # define SSL_set_msg_callback_arg(ssl, arg) SSL_ctrl((ssl), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
  602. # define SSL_get_extms_support(s) \
  603. SSL_ctrl((s),SSL_CTRL_GET_EXTMS_SUPPORT,0,NULL)
  604. # ifndef OPENSSL_NO_SRP
  605. /* see tls_srp.c */
  606. # ifndef OPENSSL_NO_DEPRECATED_3_0
  607. OSSL_DEPRECATEDIN_3_0 __owur int SSL_SRP_CTX_init(SSL *s);
  608. OSSL_DEPRECATEDIN_3_0 __owur int SSL_CTX_SRP_CTX_init(SSL_CTX *ctx);
  609. OSSL_DEPRECATEDIN_3_0 int SSL_SRP_CTX_free(SSL *ctx);
  610. OSSL_DEPRECATEDIN_3_0 int SSL_CTX_SRP_CTX_free(SSL_CTX *ctx);
  611. OSSL_DEPRECATEDIN_3_0 __owur int SSL_srp_server_param_with_username(SSL *s,
  612. int *ad);
  613. OSSL_DEPRECATEDIN_3_0 __owur int SRP_Calc_A_param(SSL *s);
  614. # endif
  615. # endif
  616. /* 100k max cert list */
  617. # define SSL_MAX_CERT_LIST_DEFAULT (1024*100)
  618. # define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT (1024*20)
  619. /*
  620. * This callback type is used inside SSL_CTX, SSL, and in the functions that
  621. * set them. It is used to override the generation of SSL/TLS session IDs in
  622. * a server. Return value should be zero on an error, non-zero to proceed.
  623. * Also, callbacks should themselves check if the id they generate is unique
  624. * otherwise the SSL handshake will fail with an error - callbacks can do
  625. * this using the 'ssl' value they're passed by;
  626. * SSL_has_matching_session_id(ssl, id, *id_len) The length value passed in
  627. * is set at the maximum size the session ID can be. In SSLv3/TLSv1 it is 32
  628. * bytes. The callback can alter this length to be less if desired. It is
  629. * also an error for the callback to set the size to zero.
  630. */
  631. typedef int (*GEN_SESSION_CB) (SSL *ssl, unsigned char *id,
  632. unsigned int *id_len);
  633. # define SSL_SESS_CACHE_OFF 0x0000
  634. # define SSL_SESS_CACHE_CLIENT 0x0001
  635. # define SSL_SESS_CACHE_SERVER 0x0002
  636. # define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT|SSL_SESS_CACHE_SERVER)
  637. # define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080
  638. /* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */
  639. # define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100
  640. # define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200
  641. # define SSL_SESS_CACHE_NO_INTERNAL \
  642. (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP|SSL_SESS_CACHE_NO_INTERNAL_STORE)
  643. # define SSL_SESS_CACHE_UPDATE_TIME 0x0400
  644. LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);
  645. # define SSL_CTX_sess_number(ctx) \
  646. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_NUMBER,0,NULL)
  647. # define SSL_CTX_sess_connect(ctx) \
  648. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT,0,NULL)
  649. # define SSL_CTX_sess_connect_good(ctx) \
  650. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_GOOD,0,NULL)
  651. # define SSL_CTX_sess_connect_renegotiate(ctx) \
  652. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_RENEGOTIATE,0,NULL)
  653. # define SSL_CTX_sess_accept(ctx) \
  654. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT,0,NULL)
  655. # define SSL_CTX_sess_accept_renegotiate(ctx) \
  656. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_RENEGOTIATE,0,NULL)
  657. # define SSL_CTX_sess_accept_good(ctx) \
  658. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_GOOD,0,NULL)
  659. # define SSL_CTX_sess_hits(ctx) \
  660. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_HIT,0,NULL)
  661. # define SSL_CTX_sess_cb_hits(ctx) \
  662. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CB_HIT,0,NULL)
  663. # define SSL_CTX_sess_misses(ctx) \
  664. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_MISSES,0,NULL)
  665. # define SSL_CTX_sess_timeouts(ctx) \
  666. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_TIMEOUTS,0,NULL)
  667. # define SSL_CTX_sess_cache_full(ctx) \
  668. SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CACHE_FULL,0,NULL)
  669. void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx,
  670. int (*new_session_cb) (struct ssl_st *ssl,
  671. SSL_SESSION *sess));
  672. int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx)) (struct ssl_st *ssl,
  673. SSL_SESSION *sess);
  674. void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx,
  675. void (*remove_session_cb) (struct ssl_ctx_st
  676. *ctx,
  677. SSL_SESSION *sess));
  678. void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx)) (struct ssl_ctx_st *ctx,
  679. SSL_SESSION *sess);
  680. void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx,
  681. SSL_SESSION *(*get_session_cb) (struct ssl_st
  682. *ssl,
  683. const unsigned char
  684. *data, int len,
  685. int *copy));
  686. SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx)) (struct ssl_st *ssl,
  687. const unsigned char *data,
  688. int len, int *copy);
  689. void SSL_CTX_set_info_callback(SSL_CTX *ctx,
  690. void (*cb) (const SSL *ssl, int type, int val));
  691. void (*SSL_CTX_get_info_callback(SSL_CTX *ctx)) (const SSL *ssl, int type,
  692. int val);
  693. void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx,
  694. int (*client_cert_cb) (SSL *ssl, X509 **x509,
  695. EVP_PKEY **pkey));
  696. int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx)) (SSL *ssl, X509 **x509,
  697. EVP_PKEY **pkey);
  698. # ifndef OPENSSL_NO_ENGINE
  699. __owur int SSL_CTX_set_client_cert_engine(SSL_CTX *ctx, ENGINE *e);
  700. # endif
  701. void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx,
  702. int (*app_gen_cookie_cb) (SSL *ssl,
  703. unsigned char
  704. *cookie,
  705. unsigned int
  706. *cookie_len));
  707. void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx,
  708. int (*app_verify_cookie_cb) (SSL *ssl,
  709. const unsigned
  710. char *cookie,
  711. unsigned int
  712. cookie_len));
  713. void SSL_CTX_set_stateless_cookie_generate_cb(
  714. SSL_CTX *ctx,
  715. int (*gen_stateless_cookie_cb) (SSL *ssl,
  716. unsigned char *cookie,
  717. size_t *cookie_len));
  718. void SSL_CTX_set_stateless_cookie_verify_cb(
  719. SSL_CTX *ctx,
  720. int (*verify_stateless_cookie_cb) (SSL *ssl,
  721. const unsigned char *cookie,
  722. size_t cookie_len));
  723. # ifndef OPENSSL_NO_NEXTPROTONEG
  724. typedef int (*SSL_CTX_npn_advertised_cb_func)(SSL *ssl,
  725. const unsigned char **out,
  726. unsigned int *outlen,
  727. void *arg);
  728. void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *s,
  729. SSL_CTX_npn_advertised_cb_func cb,
  730. void *arg);
  731. # define SSL_CTX_set_npn_advertised_cb SSL_CTX_set_next_protos_advertised_cb
  732. typedef int (*SSL_CTX_npn_select_cb_func)(SSL *s,
  733. unsigned char **out,
  734. unsigned char *outlen,
  735. const unsigned char *in,
  736. unsigned int inlen,
  737. void *arg);
  738. void SSL_CTX_set_next_proto_select_cb(SSL_CTX *s,
  739. SSL_CTX_npn_select_cb_func cb,
  740. void *arg);
  741. # define SSL_CTX_set_npn_select_cb SSL_CTX_set_next_proto_select_cb
  742. void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data,
  743. unsigned *len);
  744. # define SSL_get0_npn_negotiated SSL_get0_next_proto_negotiated
  745. # endif
  746. __owur int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
  747. const unsigned char *in, unsigned int inlen,
  748. const unsigned char *client,
  749. unsigned int client_len);
  750. # define OPENSSL_NPN_UNSUPPORTED 0
  751. # define OPENSSL_NPN_NEGOTIATED 1
  752. # define OPENSSL_NPN_NO_OVERLAP 2
  753. __owur int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos,
  754. unsigned int protos_len);
  755. __owur int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos,
  756. unsigned int protos_len);
  757. typedef int (*SSL_CTX_alpn_select_cb_func)(SSL *ssl,
  758. const unsigned char **out,
  759. unsigned char *outlen,
  760. const unsigned char *in,
  761. unsigned int inlen,
  762. void *arg);
  763. void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
  764. SSL_CTX_alpn_select_cb_func cb,
  765. void *arg);
  766. void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
  767. unsigned int *len);
  768. # ifndef OPENSSL_NO_PSK
  769. /*
  770. * the maximum length of the buffer given to callbacks containing the
  771. * resulting identity/psk
  772. */
  773. # define PSK_MAX_IDENTITY_LEN 256
  774. # define PSK_MAX_PSK_LEN 512
  775. typedef unsigned int (*SSL_psk_client_cb_func)(SSL *ssl,
  776. const char *hint,
  777. char *identity,
  778. unsigned int max_identity_len,
  779. unsigned char *psk,
  780. unsigned int max_psk_len);
  781. void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, SSL_psk_client_cb_func cb);
  782. void SSL_set_psk_client_callback(SSL *ssl, SSL_psk_client_cb_func cb);
  783. typedef unsigned int (*SSL_psk_server_cb_func)(SSL *ssl,
  784. const char *identity,
  785. unsigned char *psk,
  786. unsigned int max_psk_len);
  787. void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx, SSL_psk_server_cb_func cb);
  788. void SSL_set_psk_server_callback(SSL *ssl, SSL_psk_server_cb_func cb);
  789. __owur int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint);
  790. __owur int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint);
  791. const char *SSL_get_psk_identity_hint(const SSL *s);
  792. const char *SSL_get_psk_identity(const SSL *s);
  793. # endif
  794. typedef int (*SSL_psk_find_session_cb_func)(SSL *ssl,
  795. const unsigned char *identity,
  796. size_t identity_len,
  797. SSL_SESSION **sess);
  798. typedef int (*SSL_psk_use_session_cb_func)(SSL *ssl, const EVP_MD *md,
  799. const unsigned char **id,
  800. size_t *idlen,
  801. SSL_SESSION **sess);
  802. void SSL_set_psk_find_session_callback(SSL *s, SSL_psk_find_session_cb_func cb);
  803. void SSL_CTX_set_psk_find_session_callback(SSL_CTX *ctx,
  804. SSL_psk_find_session_cb_func cb);
  805. void SSL_set_psk_use_session_callback(SSL *s, SSL_psk_use_session_cb_func cb);
  806. void SSL_CTX_set_psk_use_session_callback(SSL_CTX *ctx,
  807. SSL_psk_use_session_cb_func cb);
  808. /* Register callbacks to handle custom TLS Extensions for client or server. */
  809. __owur int SSL_CTX_has_client_custom_ext(const SSL_CTX *ctx,
  810. unsigned int ext_type);
  811. __owur int SSL_CTX_add_client_custom_ext(SSL_CTX *ctx,
  812. unsigned int ext_type,
  813. custom_ext_add_cb add_cb,
  814. custom_ext_free_cb free_cb,
  815. void *add_arg,
  816. custom_ext_parse_cb parse_cb,
  817. void *parse_arg);
  818. __owur int SSL_CTX_add_server_custom_ext(SSL_CTX *ctx,
  819. unsigned int ext_type,
  820. custom_ext_add_cb add_cb,
  821. custom_ext_free_cb free_cb,
  822. void *add_arg,
  823. custom_ext_parse_cb parse_cb,
  824. void *parse_arg);
  825. __owur int SSL_CTX_add_custom_ext(SSL_CTX *ctx, unsigned int ext_type,
  826. unsigned int context,
  827. SSL_custom_ext_add_cb_ex add_cb,
  828. SSL_custom_ext_free_cb_ex free_cb,
  829. void *add_arg,
  830. SSL_custom_ext_parse_cb_ex parse_cb,
  831. void *parse_arg);
  832. __owur int SSL_extension_supported(unsigned int ext_type);
  833. # define SSL_NOTHING 1
  834. # define SSL_WRITING 2
  835. # define SSL_READING 3
  836. # define SSL_X509_LOOKUP 4
  837. # define SSL_ASYNC_PAUSED 5
  838. # define SSL_ASYNC_NO_JOBS 6
  839. # define SSL_CLIENT_HELLO_CB 7
  840. # define SSL_RETRY_VERIFY 8
  841. /* These will only be used when doing non-blocking IO */
  842. # define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING)
  843. # define SSL_want_read(s) (SSL_want(s) == SSL_READING)
  844. # define SSL_want_write(s) (SSL_want(s) == SSL_WRITING)
  845. # define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP)
  846. # define SSL_want_retry_verify(s) (SSL_want(s) == SSL_RETRY_VERIFY)
  847. # define SSL_want_async(s) (SSL_want(s) == SSL_ASYNC_PAUSED)
  848. # define SSL_want_async_job(s) (SSL_want(s) == SSL_ASYNC_NO_JOBS)
  849. # define SSL_want_client_hello_cb(s) (SSL_want(s) == SSL_CLIENT_HELLO_CB)
  850. # define SSL_MAC_FLAG_READ_MAC_STREAM 1
  851. # define SSL_MAC_FLAG_WRITE_MAC_STREAM 2
  852. # define SSL_MAC_FLAG_READ_MAC_TLSTREE 4
  853. # define SSL_MAC_FLAG_WRITE_MAC_TLSTREE 8
  854. /*
  855. * A callback for logging out TLS key material. This callback should log out
  856. * |line| followed by a newline.
  857. */
  858. typedef void (*SSL_CTX_keylog_cb_func)(const SSL *ssl, const char *line);
  859. /*
  860. * SSL_CTX_set_keylog_callback configures a callback to log key material. This
  861. * is intended for debugging use with tools like Wireshark. The cb function
  862. * should log line followed by a newline.
  863. */
  864. void SSL_CTX_set_keylog_callback(SSL_CTX *ctx, SSL_CTX_keylog_cb_func cb);
  865. /*
  866. * SSL_CTX_get_keylog_callback returns the callback configured by
  867. * SSL_CTX_set_keylog_callback.
  868. */
  869. SSL_CTX_keylog_cb_func SSL_CTX_get_keylog_callback(const SSL_CTX *ctx);
  870. int SSL_CTX_set_max_early_data(SSL_CTX *ctx, uint32_t max_early_data);
  871. uint32_t SSL_CTX_get_max_early_data(const SSL_CTX *ctx);
  872. int SSL_set_max_early_data(SSL *s, uint32_t max_early_data);
  873. uint32_t SSL_get_max_early_data(const SSL *s);
  874. int SSL_CTX_set_recv_max_early_data(SSL_CTX *ctx, uint32_t recv_max_early_data);
  875. uint32_t SSL_CTX_get_recv_max_early_data(const SSL_CTX *ctx);
  876. int SSL_set_recv_max_early_data(SSL *s, uint32_t recv_max_early_data);
  877. uint32_t SSL_get_recv_max_early_data(const SSL *s);
  878. #ifdef __cplusplus
  879. }
  880. #endif
  881. # include <openssl/ssl2.h>
  882. # include <openssl/ssl3.h>
  883. # include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */
  884. # include <openssl/dtls1.h> /* Datagram TLS */
  885. # include <openssl/srtp.h> /* Support for the use_srtp extension */
  886. # include <openssl/quic.h>
  887. #ifdef __cplusplus
  888. extern "C" {
  889. #endif
  890. /*
  891. * These need to be after the above set of includes due to a compiler bug
  892. * in VisualStudio 2015
  893. */
  894. SKM_DEFINE_STACK_OF_INTERNAL(SSL_CIPHER, const SSL_CIPHER, SSL_CIPHER)
  895. #define sk_SSL_CIPHER_num(sk) OPENSSL_sk_num(ossl_check_const_SSL_CIPHER_sk_type(sk))
  896. #define sk_SSL_CIPHER_value(sk, idx) ((const SSL_CIPHER *)OPENSSL_sk_value(ossl_check_const_SSL_CIPHER_sk_type(sk), (idx)))
  897. #define sk_SSL_CIPHER_new(cmp) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new(ossl_check_SSL_CIPHER_compfunc_type(cmp)))
  898. #define sk_SSL_CIPHER_new_null() ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new_null())
  899. #define sk_SSL_CIPHER_new_reserve(cmp, n) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_new_reserve(ossl_check_SSL_CIPHER_compfunc_type(cmp), (n)))
  900. #define sk_SSL_CIPHER_reserve(sk, n) OPENSSL_sk_reserve(ossl_check_SSL_CIPHER_sk_type(sk), (n))
  901. #define sk_SSL_CIPHER_free(sk) OPENSSL_sk_free(ossl_check_SSL_CIPHER_sk_type(sk))
  902. #define sk_SSL_CIPHER_zero(sk) OPENSSL_sk_zero(ossl_check_SSL_CIPHER_sk_type(sk))
  903. #define sk_SSL_CIPHER_delete(sk, i) ((const SSL_CIPHER *)OPENSSL_sk_delete(ossl_check_SSL_CIPHER_sk_type(sk), (i)))
  904. #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)))
  905. #define sk_SSL_CIPHER_push(sk, ptr) OPENSSL_sk_push(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))
  906. #define sk_SSL_CIPHER_unshift(sk, ptr) OPENSSL_sk_unshift(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))
  907. #define sk_SSL_CIPHER_pop(sk) ((const SSL_CIPHER *)OPENSSL_sk_pop(ossl_check_SSL_CIPHER_sk_type(sk)))
  908. #define sk_SSL_CIPHER_shift(sk) ((const SSL_CIPHER *)OPENSSL_sk_shift(ossl_check_SSL_CIPHER_sk_type(sk)))
  909. #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))
  910. #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))
  911. #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)))
  912. #define sk_SSL_CIPHER_find(sk, ptr) OPENSSL_sk_find(ossl_check_SSL_CIPHER_sk_type(sk), ossl_check_SSL_CIPHER_type(ptr))
  913. #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))
  914. #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)
  915. #define sk_SSL_CIPHER_sort(sk) OPENSSL_sk_sort(ossl_check_SSL_CIPHER_sk_type(sk))
  916. #define sk_SSL_CIPHER_is_sorted(sk) OPENSSL_sk_is_sorted(ossl_check_const_SSL_CIPHER_sk_type(sk))
  917. #define sk_SSL_CIPHER_dup(sk) ((STACK_OF(SSL_CIPHER) *)OPENSSL_sk_dup(ossl_check_const_SSL_CIPHER_sk_type(sk)))
  918. #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)))
  919. #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)))
  920. /* compatibility */
  921. # define SSL_set_app_data(s,arg) (SSL_set_ex_data(s,0,(char *)(arg)))
  922. # define SSL_get_app_data(s) (SSL_get_ex_data(s,0))
  923. # define SSL_SESSION_set_app_data(s,a) (SSL_SESSION_set_ex_data(s,0, \
  924. (char *)(a)))
  925. # define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s,0))
  926. # define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx,0))
  927. # define SSL_CTX_set_app_data(ctx,arg) (SSL_CTX_set_ex_data(ctx,0, \
  928. (char *)(arg)))
  929. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  930. OSSL_DEPRECATEDIN_1_1_0 void SSL_set_debug(SSL *s, int debug);
  931. # endif
  932. /* TLSv1.3 KeyUpdate message types */
  933. /* -1 used so that this is an invalid value for the on-the-wire protocol */
  934. #define SSL_KEY_UPDATE_NONE -1
  935. /* Values as defined for the on-the-wire protocol */
  936. #define SSL_KEY_UPDATE_NOT_REQUESTED 0
  937. #define SSL_KEY_UPDATE_REQUESTED 1
  938. /*
  939. * The valid handshake states (one for each type message sent and one for each
  940. * type of message received). There are also two "special" states:
  941. * TLS = TLS or DTLS state
  942. * DTLS = DTLS specific state
  943. * CR/SR = Client Read/Server Read
  944. * CW/SW = Client Write/Server Write
  945. *
  946. * The "special" states are:
  947. * TLS_ST_BEFORE = No handshake has been initiated yet
  948. * TLS_ST_OK = A handshake has been successfully completed
  949. */
  950. typedef enum {
  951. TLS_ST_BEFORE,
  952. TLS_ST_OK,
  953. DTLS_ST_CR_HELLO_VERIFY_REQUEST,
  954. TLS_ST_CR_SRVR_HELLO,
  955. TLS_ST_CR_CERT,
  956. TLS_ST_CR_COMP_CERT,
  957. TLS_ST_CR_CERT_STATUS,
  958. TLS_ST_CR_KEY_EXCH,
  959. TLS_ST_CR_CERT_REQ,
  960. TLS_ST_CR_SRVR_DONE,
  961. TLS_ST_CR_SESSION_TICKET,
  962. TLS_ST_CR_CHANGE,
  963. TLS_ST_CR_FINISHED,
  964. TLS_ST_CW_CLNT_HELLO,
  965. TLS_ST_CW_CERT,
  966. TLS_ST_CW_COMP_CERT,
  967. TLS_ST_CW_KEY_EXCH,
  968. TLS_ST_CW_CERT_VRFY,
  969. TLS_ST_CW_CHANGE,
  970. TLS_ST_CW_NEXT_PROTO,
  971. TLS_ST_CW_FINISHED,
  972. TLS_ST_SW_HELLO_REQ,
  973. TLS_ST_SR_CLNT_HELLO,
  974. DTLS_ST_SW_HELLO_VERIFY_REQUEST,
  975. TLS_ST_SW_SRVR_HELLO,
  976. TLS_ST_SW_CERT,
  977. TLS_ST_SW_COMP_CERT,
  978. TLS_ST_SW_KEY_EXCH,
  979. TLS_ST_SW_CERT_REQ,
  980. TLS_ST_SW_SRVR_DONE,
  981. TLS_ST_SR_CERT,
  982. TLS_ST_SR_COMP_CERT,
  983. TLS_ST_SR_KEY_EXCH,
  984. TLS_ST_SR_CERT_VRFY,
  985. TLS_ST_SR_NEXT_PROTO,
  986. TLS_ST_SR_CHANGE,
  987. TLS_ST_SR_FINISHED,
  988. TLS_ST_SW_SESSION_TICKET,
  989. TLS_ST_SW_CERT_STATUS,
  990. TLS_ST_SW_CHANGE,
  991. TLS_ST_SW_FINISHED,
  992. TLS_ST_SW_ENCRYPTED_EXTENSIONS,
  993. TLS_ST_CR_ENCRYPTED_EXTENSIONS,
  994. TLS_ST_CR_CERT_VRFY,
  995. TLS_ST_SW_CERT_VRFY,
  996. TLS_ST_CR_HELLO_REQ,
  997. TLS_ST_SW_KEY_UPDATE,
  998. TLS_ST_CW_KEY_UPDATE,
  999. TLS_ST_SR_KEY_UPDATE,
  1000. TLS_ST_CR_KEY_UPDATE,
  1001. TLS_ST_EARLY_DATA,
  1002. TLS_ST_PENDING_EARLY_DATA_END,
  1003. TLS_ST_CW_END_OF_EARLY_DATA,
  1004. TLS_ST_SR_END_OF_EARLY_DATA
  1005. } OSSL_HANDSHAKE_STATE;
  1006. /*
  1007. * Most of the following state values are no longer used and are defined to be
  1008. * the closest equivalent value in the current state machine code. Not all
  1009. * defines have an equivalent and are set to a dummy value (-1). SSL_ST_CONNECT
  1010. * and SSL_ST_ACCEPT are still in use in the definition of SSL_CB_ACCEPT_LOOP,
  1011. * SSL_CB_ACCEPT_EXIT, SSL_CB_CONNECT_LOOP and SSL_CB_CONNECT_EXIT.
  1012. */
  1013. # define SSL_ST_CONNECT 0x1000
  1014. # define SSL_ST_ACCEPT 0x2000
  1015. # define SSL_ST_MASK 0x0FFF
  1016. # define SSL_CB_LOOP 0x01
  1017. # define SSL_CB_EXIT 0x02
  1018. # define SSL_CB_READ 0x04
  1019. # define SSL_CB_WRITE 0x08
  1020. # define SSL_CB_ALERT 0x4000/* used in callback */
  1021. # define SSL_CB_READ_ALERT (SSL_CB_ALERT|SSL_CB_READ)
  1022. # define SSL_CB_WRITE_ALERT (SSL_CB_ALERT|SSL_CB_WRITE)
  1023. # define SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT|SSL_CB_LOOP)
  1024. # define SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT|SSL_CB_EXIT)
  1025. # define SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT|SSL_CB_LOOP)
  1026. # define SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT|SSL_CB_EXIT)
  1027. # define SSL_CB_HANDSHAKE_START 0x10
  1028. # define SSL_CB_HANDSHAKE_DONE 0x20
  1029. /* Is the SSL_connection established? */
  1030. # define SSL_in_connect_init(a) (SSL_in_init(a) && !SSL_is_server(a))
  1031. # define SSL_in_accept_init(a) (SSL_in_init(a) && SSL_is_server(a))
  1032. int SSL_in_init(const SSL *s);
  1033. int SSL_in_before(const SSL *s);
  1034. int SSL_is_init_finished(const SSL *s);
  1035. /*
  1036. * The following 3 states are kept in ssl->rlayer.rstate when reads fail, you
  1037. * should not need these
  1038. */
  1039. # define SSL_ST_READ_HEADER 0xF0
  1040. # define SSL_ST_READ_BODY 0xF1
  1041. # define SSL_ST_READ_DONE 0xF2
  1042. /*-
  1043. * Obtain latest Finished message
  1044. * -- that we sent (SSL_get_finished)
  1045. * -- that we expected from peer (SSL_get_peer_finished).
  1046. * Returns length (0 == no Finished so far), copies up to 'count' bytes.
  1047. */
  1048. size_t SSL_get_finished(const SSL *s, void *buf, size_t count);
  1049. size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count);
  1050. /*
  1051. * use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 3 options are
  1052. * 'ored' with SSL_VERIFY_PEER if they are desired
  1053. */
  1054. # define SSL_VERIFY_NONE 0x00
  1055. # define SSL_VERIFY_PEER 0x01
  1056. # define SSL_VERIFY_FAIL_IF_NO_PEER_CERT 0x02
  1057. # define SSL_VERIFY_CLIENT_ONCE 0x04
  1058. # define SSL_VERIFY_POST_HANDSHAKE 0x08
  1059. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1060. # define OpenSSL_add_ssl_algorithms() SSL_library_init()
  1061. # define SSLeay_add_ssl_algorithms() SSL_library_init()
  1062. # endif
  1063. /* More backward compatibility */
  1064. # define SSL_get_cipher(s) \
  1065. SSL_CIPHER_get_name(SSL_get_current_cipher(s))
  1066. # define SSL_get_cipher_bits(s,np) \
  1067. SSL_CIPHER_get_bits(SSL_get_current_cipher(s),np)
  1068. # define SSL_get_cipher_version(s) \
  1069. SSL_CIPHER_get_version(SSL_get_current_cipher(s))
  1070. # define SSL_get_cipher_name(s) \
  1071. SSL_CIPHER_get_name(SSL_get_current_cipher(s))
  1072. # define SSL_get_time(a) SSL_SESSION_get_time(a)
  1073. # define SSL_set_time(a,b) SSL_SESSION_set_time((a),(b))
  1074. # define SSL_get_timeout(a) SSL_SESSION_get_timeout(a)
  1075. # define SSL_set_timeout(a,b) SSL_SESSION_set_timeout((a),(b))
  1076. # define d2i_SSL_SESSION_bio(bp,s_id) ASN1_d2i_bio_of(SSL_SESSION,SSL_SESSION_new,d2i_SSL_SESSION,bp,s_id)
  1077. # define i2d_SSL_SESSION_bio(bp,s_id) ASN1_i2d_bio_of(SSL_SESSION,i2d_SSL_SESSION,bp,s_id)
  1078. DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION)
  1079. # define SSL_AD_REASON_OFFSET 1000/* offset to get SSL_R_... value
  1080. * from SSL_AD_... */
  1081. /* These alert types are for SSLv3 and TLSv1 */
  1082. # define SSL_AD_CLOSE_NOTIFY SSL3_AD_CLOSE_NOTIFY
  1083. /* fatal */
  1084. # define SSL_AD_UNEXPECTED_MESSAGE SSL3_AD_UNEXPECTED_MESSAGE
  1085. /* fatal */
  1086. # define SSL_AD_BAD_RECORD_MAC SSL3_AD_BAD_RECORD_MAC
  1087. # define SSL_AD_DECRYPTION_FAILED TLS1_AD_DECRYPTION_FAILED
  1088. # define SSL_AD_RECORD_OVERFLOW TLS1_AD_RECORD_OVERFLOW
  1089. /* fatal */
  1090. # define SSL_AD_DECOMPRESSION_FAILURE SSL3_AD_DECOMPRESSION_FAILURE
  1091. /* fatal */
  1092. # define SSL_AD_HANDSHAKE_FAILURE SSL3_AD_HANDSHAKE_FAILURE
  1093. /* Not for TLS */
  1094. # define SSL_AD_NO_CERTIFICATE SSL3_AD_NO_CERTIFICATE
  1095. # define SSL_AD_BAD_CERTIFICATE SSL3_AD_BAD_CERTIFICATE
  1096. # define SSL_AD_UNSUPPORTED_CERTIFICATE SSL3_AD_UNSUPPORTED_CERTIFICATE
  1097. # define SSL_AD_CERTIFICATE_REVOKED SSL3_AD_CERTIFICATE_REVOKED
  1098. # define SSL_AD_CERTIFICATE_EXPIRED SSL3_AD_CERTIFICATE_EXPIRED
  1099. # define SSL_AD_CERTIFICATE_UNKNOWN SSL3_AD_CERTIFICATE_UNKNOWN
  1100. /* fatal */
  1101. # define SSL_AD_ILLEGAL_PARAMETER SSL3_AD_ILLEGAL_PARAMETER
  1102. /* fatal */
  1103. # define SSL_AD_UNKNOWN_CA TLS1_AD_UNKNOWN_CA
  1104. /* fatal */
  1105. # define SSL_AD_ACCESS_DENIED TLS1_AD_ACCESS_DENIED
  1106. /* fatal */
  1107. # define SSL_AD_DECODE_ERROR TLS1_AD_DECODE_ERROR
  1108. # define SSL_AD_DECRYPT_ERROR TLS1_AD_DECRYPT_ERROR
  1109. /* fatal */
  1110. # define SSL_AD_EXPORT_RESTRICTION TLS1_AD_EXPORT_RESTRICTION
  1111. /* fatal */
  1112. # define SSL_AD_PROTOCOL_VERSION TLS1_AD_PROTOCOL_VERSION
  1113. /* fatal */
  1114. # define SSL_AD_INSUFFICIENT_SECURITY TLS1_AD_INSUFFICIENT_SECURITY
  1115. /* fatal */
  1116. # define SSL_AD_INTERNAL_ERROR TLS1_AD_INTERNAL_ERROR
  1117. # define SSL_AD_USER_CANCELLED TLS1_AD_USER_CANCELLED
  1118. # define SSL_AD_NO_RENEGOTIATION TLS1_AD_NO_RENEGOTIATION
  1119. # define SSL_AD_MISSING_EXTENSION TLS13_AD_MISSING_EXTENSION
  1120. # define SSL_AD_CERTIFICATE_REQUIRED TLS13_AD_CERTIFICATE_REQUIRED
  1121. # define SSL_AD_UNSUPPORTED_EXTENSION TLS1_AD_UNSUPPORTED_EXTENSION
  1122. # define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE
  1123. # define SSL_AD_UNRECOGNIZED_NAME TLS1_AD_UNRECOGNIZED_NAME
  1124. # define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE
  1125. # define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE
  1126. /* fatal */
  1127. # define SSL_AD_UNKNOWN_PSK_IDENTITY TLS1_AD_UNKNOWN_PSK_IDENTITY
  1128. /* fatal */
  1129. # define SSL_AD_INAPPROPRIATE_FALLBACK TLS1_AD_INAPPROPRIATE_FALLBACK
  1130. # define SSL_AD_NO_APPLICATION_PROTOCOL TLS1_AD_NO_APPLICATION_PROTOCOL
  1131. # define SSL_ERROR_NONE 0
  1132. # define SSL_ERROR_SSL 1
  1133. # define SSL_ERROR_WANT_READ 2
  1134. # define SSL_ERROR_WANT_WRITE 3
  1135. # define SSL_ERROR_WANT_X509_LOOKUP 4
  1136. # define SSL_ERROR_SYSCALL 5/* look at error stack/return
  1137. * value/errno */
  1138. # define SSL_ERROR_ZERO_RETURN 6
  1139. # define SSL_ERROR_WANT_CONNECT 7
  1140. # define SSL_ERROR_WANT_ACCEPT 8
  1141. # define SSL_ERROR_WANT_ASYNC 9
  1142. # define SSL_ERROR_WANT_ASYNC_JOB 10
  1143. # define SSL_ERROR_WANT_CLIENT_HELLO_CB 11
  1144. # define SSL_ERROR_WANT_RETRY_VERIFY 12
  1145. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1146. # define SSL_CTRL_SET_TMP_DH 3
  1147. # define SSL_CTRL_SET_TMP_ECDH 4
  1148. # define SSL_CTRL_SET_TMP_DH_CB 6
  1149. # endif
  1150. # define SSL_CTRL_GET_CLIENT_CERT_REQUEST 9
  1151. # define SSL_CTRL_GET_NUM_RENEGOTIATIONS 10
  1152. # define SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS 11
  1153. # define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS 12
  1154. # define SSL_CTRL_GET_FLAGS 13
  1155. # define SSL_CTRL_EXTRA_CHAIN_CERT 14
  1156. # define SSL_CTRL_SET_MSG_CALLBACK 15
  1157. # define SSL_CTRL_SET_MSG_CALLBACK_ARG 16
  1158. /* only applies to datagram connections */
  1159. # define SSL_CTRL_SET_MTU 17
  1160. /* Stats */
  1161. # define SSL_CTRL_SESS_NUMBER 20
  1162. # define SSL_CTRL_SESS_CONNECT 21
  1163. # define SSL_CTRL_SESS_CONNECT_GOOD 22
  1164. # define SSL_CTRL_SESS_CONNECT_RENEGOTIATE 23
  1165. # define SSL_CTRL_SESS_ACCEPT 24
  1166. # define SSL_CTRL_SESS_ACCEPT_GOOD 25
  1167. # define SSL_CTRL_SESS_ACCEPT_RENEGOTIATE 26
  1168. # define SSL_CTRL_SESS_HIT 27
  1169. # define SSL_CTRL_SESS_CB_HIT 28
  1170. # define SSL_CTRL_SESS_MISSES 29
  1171. # define SSL_CTRL_SESS_TIMEOUTS 30
  1172. # define SSL_CTRL_SESS_CACHE_FULL 31
  1173. # define SSL_CTRL_MODE 33
  1174. # define SSL_CTRL_GET_READ_AHEAD 40
  1175. # define SSL_CTRL_SET_READ_AHEAD 41
  1176. # define SSL_CTRL_SET_SESS_CACHE_SIZE 42
  1177. # define SSL_CTRL_GET_SESS_CACHE_SIZE 43
  1178. # define SSL_CTRL_SET_SESS_CACHE_MODE 44
  1179. # define SSL_CTRL_GET_SESS_CACHE_MODE 45
  1180. # define SSL_CTRL_GET_MAX_CERT_LIST 50
  1181. # define SSL_CTRL_SET_MAX_CERT_LIST 51
  1182. # define SSL_CTRL_SET_MAX_SEND_FRAGMENT 52
  1183. /* see tls1.h for macros based on these */
  1184. # define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB 53
  1185. # define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG 54
  1186. # define SSL_CTRL_SET_TLSEXT_HOSTNAME 55
  1187. # define SSL_CTRL_SET_TLSEXT_DEBUG_CB 56
  1188. # define SSL_CTRL_SET_TLSEXT_DEBUG_ARG 57
  1189. # define SSL_CTRL_GET_TLSEXT_TICKET_KEYS 58
  1190. # define SSL_CTRL_SET_TLSEXT_TICKET_KEYS 59
  1191. /*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT 60 */
  1192. /*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB 61 */
  1193. /*# define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB_ARG 62 */
  1194. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB 63
  1195. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG 64
  1196. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE 65
  1197. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS 66
  1198. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS 67
  1199. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS 68
  1200. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS 69
  1201. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP 70
  1202. # define SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP 71
  1203. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1204. # define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB 72
  1205. # endif
  1206. # define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME_CB 75
  1207. # define SSL_CTRL_SET_SRP_VERIFY_PARAM_CB 76
  1208. # define SSL_CTRL_SET_SRP_GIVE_CLIENT_PWD_CB 77
  1209. # define SSL_CTRL_SET_SRP_ARG 78
  1210. # define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME 79
  1211. # define SSL_CTRL_SET_TLS_EXT_SRP_STRENGTH 80
  1212. # define SSL_CTRL_SET_TLS_EXT_SRP_PASSWORD 81
  1213. # define DTLS_CTRL_GET_TIMEOUT 73
  1214. # define DTLS_CTRL_HANDLE_TIMEOUT 74
  1215. # define SSL_CTRL_GET_RI_SUPPORT 76
  1216. # define SSL_CTRL_CLEAR_MODE 78
  1217. # define SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB 79
  1218. # define SSL_CTRL_GET_EXTRA_CHAIN_CERTS 82
  1219. # define SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS 83
  1220. # define SSL_CTRL_CHAIN 88
  1221. # define SSL_CTRL_CHAIN_CERT 89
  1222. # define SSL_CTRL_GET_GROUPS 90
  1223. # define SSL_CTRL_SET_GROUPS 91
  1224. # define SSL_CTRL_SET_GROUPS_LIST 92
  1225. # define SSL_CTRL_GET_SHARED_GROUP 93
  1226. # define SSL_CTRL_SET_SIGALGS 97
  1227. # define SSL_CTRL_SET_SIGALGS_LIST 98
  1228. # define SSL_CTRL_CERT_FLAGS 99
  1229. # define SSL_CTRL_CLEAR_CERT_FLAGS 100
  1230. # define SSL_CTRL_SET_CLIENT_SIGALGS 101
  1231. # define SSL_CTRL_SET_CLIENT_SIGALGS_LIST 102
  1232. # define SSL_CTRL_GET_CLIENT_CERT_TYPES 103
  1233. # define SSL_CTRL_SET_CLIENT_CERT_TYPES 104
  1234. # define SSL_CTRL_BUILD_CERT_CHAIN 105
  1235. # define SSL_CTRL_SET_VERIFY_CERT_STORE 106
  1236. # define SSL_CTRL_SET_CHAIN_CERT_STORE 107
  1237. # define SSL_CTRL_GET_PEER_SIGNATURE_NID 108
  1238. # define SSL_CTRL_GET_PEER_TMP_KEY 109
  1239. # define SSL_CTRL_GET_RAW_CIPHERLIST 110
  1240. # define SSL_CTRL_GET_EC_POINT_FORMATS 111
  1241. # define SSL_CTRL_GET_CHAIN_CERTS 115
  1242. # define SSL_CTRL_SELECT_CURRENT_CERT 116
  1243. # define SSL_CTRL_SET_CURRENT_CERT 117
  1244. # define SSL_CTRL_SET_DH_AUTO 118
  1245. # define DTLS_CTRL_SET_LINK_MTU 120
  1246. # define DTLS_CTRL_GET_LINK_MIN_MTU 121
  1247. # define SSL_CTRL_GET_EXTMS_SUPPORT 122
  1248. # define SSL_CTRL_SET_MIN_PROTO_VERSION 123
  1249. # define SSL_CTRL_SET_MAX_PROTO_VERSION 124
  1250. # define SSL_CTRL_SET_SPLIT_SEND_FRAGMENT 125
  1251. # define SSL_CTRL_SET_MAX_PIPELINES 126
  1252. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_TYPE 127
  1253. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB 128
  1254. # define SSL_CTRL_GET_TLSEXT_STATUS_REQ_CB_ARG 129
  1255. # define SSL_CTRL_GET_MIN_PROTO_VERSION 130
  1256. # define SSL_CTRL_GET_MAX_PROTO_VERSION 131
  1257. # define SSL_CTRL_GET_SIGNATURE_NID 132
  1258. # define SSL_CTRL_GET_TMP_KEY 133
  1259. # define SSL_CTRL_GET_NEGOTIATED_GROUP 134
  1260. # define SSL_CTRL_GET_IANA_GROUPS 135
  1261. # define SSL_CTRL_SET_RETRY_VERIFY 136
  1262. # define SSL_CTRL_GET_VERIFY_CERT_STORE 137
  1263. # define SSL_CTRL_GET_CHAIN_CERT_STORE 138
  1264. # define SSL_CERT_SET_FIRST 1
  1265. # define SSL_CERT_SET_NEXT 2
  1266. # define SSL_CERT_SET_SERVER 3
  1267. # define DTLSv1_get_timeout(ssl, arg) \
  1268. SSL_ctrl(ssl,DTLS_CTRL_GET_TIMEOUT,0, (void *)(arg))
  1269. # define DTLSv1_handle_timeout(ssl) \
  1270. SSL_ctrl(ssl,DTLS_CTRL_HANDLE_TIMEOUT,0, NULL)
  1271. # define SSL_num_renegotiations(ssl) \
  1272. SSL_ctrl((ssl),SSL_CTRL_GET_NUM_RENEGOTIATIONS,0,NULL)
  1273. # define SSL_clear_num_renegotiations(ssl) \
  1274. SSL_ctrl((ssl),SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS,0,NULL)
  1275. # define SSL_total_renegotiations(ssl) \
  1276. SSL_ctrl((ssl),SSL_CTRL_GET_TOTAL_RENEGOTIATIONS,0,NULL)
  1277. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1278. # define SSL_CTX_set_tmp_dh(ctx,dh) \
  1279. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_DH,0,(char *)(dh))
  1280. # endif
  1281. # define SSL_CTX_set_dh_auto(ctx, onoff) \
  1282. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_DH_AUTO,onoff,NULL)
  1283. # define SSL_set_dh_auto(s, onoff) \
  1284. SSL_ctrl(s,SSL_CTRL_SET_DH_AUTO,onoff,NULL)
  1285. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1286. # define SSL_set_tmp_dh(ssl,dh) \
  1287. SSL_ctrl(ssl,SSL_CTRL_SET_TMP_DH,0,(char *)(dh))
  1288. # endif
  1289. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1290. # define SSL_CTX_set_tmp_ecdh(ctx,ecdh) \
  1291. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH,0,(char *)(ecdh))
  1292. # define SSL_set_tmp_ecdh(ssl,ecdh) \
  1293. SSL_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH,0,(char *)(ecdh))
  1294. # endif
  1295. # define SSL_CTX_add_extra_chain_cert(ctx,x509) \
  1296. SSL_CTX_ctrl(ctx,SSL_CTRL_EXTRA_CHAIN_CERT,0,(char *)(x509))
  1297. # define SSL_CTX_get_extra_chain_certs(ctx,px509) \
  1298. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,0,px509)
  1299. # define SSL_CTX_get_extra_chain_certs_only(ctx,px509) \
  1300. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,1,px509)
  1301. # define SSL_CTX_clear_extra_chain_certs(ctx) \
  1302. SSL_CTX_ctrl(ctx,SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS,0,NULL)
  1303. # define SSL_CTX_set0_chain(ctx,sk) \
  1304. SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)(sk))
  1305. # define SSL_CTX_set1_chain(ctx,sk) \
  1306. SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)(sk))
  1307. # define SSL_CTX_add0_chain_cert(ctx,x509) \
  1308. SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)(x509))
  1309. # define SSL_CTX_add1_chain_cert(ctx,x509) \
  1310. SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)(x509))
  1311. # define SSL_CTX_get0_chain_certs(ctx,px509) \
  1312. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
  1313. # define SSL_CTX_clear_chain_certs(ctx) \
  1314. SSL_CTX_set0_chain(ctx,NULL)
  1315. # define SSL_CTX_build_cert_chain(ctx, flags) \
  1316. SSL_CTX_ctrl(ctx,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
  1317. # define SSL_CTX_select_current_cert(ctx,x509) \
  1318. SSL_CTX_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)(x509))
  1319. # define SSL_CTX_set_current_cert(ctx, op) \
  1320. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURRENT_CERT, op, NULL)
  1321. # define SSL_CTX_set0_verify_cert_store(ctx,st) \
  1322. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)(st))
  1323. # define SSL_CTX_set1_verify_cert_store(ctx,st) \
  1324. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)(st))
  1325. # define SSL_CTX_get0_verify_cert_store(ctx,st) \
  1326. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_VERIFY_CERT_STORE,0,(char *)(st))
  1327. # define SSL_CTX_set0_chain_cert_store(ctx,st) \
  1328. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)(st))
  1329. # define SSL_CTX_set1_chain_cert_store(ctx,st) \
  1330. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)(st))
  1331. # define SSL_CTX_get0_chain_cert_store(ctx,st) \
  1332. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERT_STORE,0,(char *)(st))
  1333. # define SSL_set0_chain(s,sk) \
  1334. SSL_ctrl(s,SSL_CTRL_CHAIN,0,(char *)(sk))
  1335. # define SSL_set1_chain(s,sk) \
  1336. SSL_ctrl(s,SSL_CTRL_CHAIN,1,(char *)(sk))
  1337. # define SSL_add0_chain_cert(s,x509) \
  1338. SSL_ctrl(s,SSL_CTRL_CHAIN_CERT,0,(char *)(x509))
  1339. # define SSL_add1_chain_cert(s,x509) \
  1340. SSL_ctrl(s,SSL_CTRL_CHAIN_CERT,1,(char *)(x509))
  1341. # define SSL_get0_chain_certs(s,px509) \
  1342. SSL_ctrl(s,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
  1343. # define SSL_clear_chain_certs(s) \
  1344. SSL_set0_chain(s,NULL)
  1345. # define SSL_build_cert_chain(s, flags) \
  1346. SSL_ctrl(s,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
  1347. # define SSL_select_current_cert(s,x509) \
  1348. SSL_ctrl(s,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)(x509))
  1349. # define SSL_set_current_cert(s,op) \
  1350. SSL_ctrl(s,SSL_CTRL_SET_CURRENT_CERT, op, NULL)
  1351. # define SSL_set0_verify_cert_store(s,st) \
  1352. SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)(st))
  1353. # define SSL_set1_verify_cert_store(s,st) \
  1354. SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)(st))
  1355. #define SSL_get0_verify_cert_store(s,st) \
  1356. SSL_ctrl(s,SSL_CTRL_GET_VERIFY_CERT_STORE,0,(char *)(st))
  1357. # define SSL_set0_chain_cert_store(s,st) \
  1358. SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)(st))
  1359. # define SSL_set1_chain_cert_store(s,st) \
  1360. SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)(st))
  1361. #define SSL_get0_chain_cert_store(s,st) \
  1362. SSL_ctrl(s,SSL_CTRL_GET_CHAIN_CERT_STORE,0,(char *)(st))
  1363. # define SSL_get1_groups(s, glist) \
  1364. SSL_ctrl(s,SSL_CTRL_GET_GROUPS,0,(int*)(glist))
  1365. # define SSL_get0_iana_groups(s, plst) \
  1366. SSL_ctrl(s,SSL_CTRL_GET_IANA_GROUPS,0,(uint16_t **)(plst))
  1367. # define SSL_CTX_set1_groups(ctx, glist, glistlen) \
  1368. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_GROUPS,glistlen,(int *)(glist))
  1369. # define SSL_CTX_set1_groups_list(ctx, s) \
  1370. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_GROUPS_LIST,0,(char *)(s))
  1371. # define SSL_set1_groups(s, glist, glistlen) \
  1372. SSL_ctrl(s,SSL_CTRL_SET_GROUPS,glistlen,(char *)(glist))
  1373. # define SSL_set1_groups_list(s, str) \
  1374. SSL_ctrl(s,SSL_CTRL_SET_GROUPS_LIST,0,(char *)(str))
  1375. # define SSL_get_shared_group(s, n) \
  1376. SSL_ctrl(s,SSL_CTRL_GET_SHARED_GROUP,n,NULL)
  1377. # define SSL_get_negotiated_group(s) \
  1378. SSL_ctrl(s,SSL_CTRL_GET_NEGOTIATED_GROUP,0,NULL)
  1379. # define SSL_CTX_set1_sigalgs(ctx, slist, slistlen) \
  1380. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS,slistlen,(int *)(slist))
  1381. # define SSL_CTX_set1_sigalgs_list(ctx, s) \
  1382. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)(s))
  1383. # define SSL_set1_sigalgs(s, slist, slistlen) \
  1384. SSL_ctrl(s,SSL_CTRL_SET_SIGALGS,slistlen,(int *)(slist))
  1385. # define SSL_set1_sigalgs_list(s, str) \
  1386. SSL_ctrl(s,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)(str))
  1387. # define SSL_CTX_set1_client_sigalgs(ctx, slist, slistlen) \
  1388. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,slistlen,(int *)(slist))
  1389. # define SSL_CTX_set1_client_sigalgs_list(ctx, s) \
  1390. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)(s))
  1391. # define SSL_set1_client_sigalgs(s, slist, slistlen) \
  1392. SSL_ctrl(s,SSL_CTRL_SET_CLIENT_SIGALGS,slistlen,(int *)(slist))
  1393. # define SSL_set1_client_sigalgs_list(s, str) \
  1394. SSL_ctrl(s,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)(str))
  1395. # define SSL_get0_certificate_types(s, clist) \
  1396. SSL_ctrl(s, SSL_CTRL_GET_CLIENT_CERT_TYPES, 0, (char *)(clist))
  1397. # define SSL_CTX_set1_client_certificate_types(ctx, clist, clistlen) \
  1398. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen, \
  1399. (char *)(clist))
  1400. # define SSL_set1_client_certificate_types(s, clist, clistlen) \
  1401. SSL_ctrl(s,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)(clist))
  1402. # define SSL_get_signature_nid(s, pn) \
  1403. SSL_ctrl(s,SSL_CTRL_GET_SIGNATURE_NID,0,pn)
  1404. # define SSL_get_peer_signature_nid(s, pn) \
  1405. SSL_ctrl(s,SSL_CTRL_GET_PEER_SIGNATURE_NID,0,pn)
  1406. # define SSL_get_peer_tmp_key(s, pk) \
  1407. SSL_ctrl(s,SSL_CTRL_GET_PEER_TMP_KEY,0,pk)
  1408. # define SSL_get_tmp_key(s, pk) \
  1409. SSL_ctrl(s,SSL_CTRL_GET_TMP_KEY,0,pk)
  1410. # define SSL_get0_raw_cipherlist(s, plst) \
  1411. SSL_ctrl(s,SSL_CTRL_GET_RAW_CIPHERLIST,0,plst)
  1412. # define SSL_get0_ec_point_formats(s, plst) \
  1413. SSL_ctrl(s,SSL_CTRL_GET_EC_POINT_FORMATS,0,plst)
  1414. # define SSL_CTX_set_min_proto_version(ctx, version) \
  1415. SSL_CTX_ctrl(ctx, SSL_CTRL_SET_MIN_PROTO_VERSION, version, NULL)
  1416. # define SSL_CTX_set_max_proto_version(ctx, version) \
  1417. SSL_CTX_ctrl(ctx, SSL_CTRL_SET_MAX_PROTO_VERSION, version, NULL)
  1418. # define SSL_CTX_get_min_proto_version(ctx) \
  1419. SSL_CTX_ctrl(ctx, SSL_CTRL_GET_MIN_PROTO_VERSION, 0, NULL)
  1420. # define SSL_CTX_get_max_proto_version(ctx) \
  1421. SSL_CTX_ctrl(ctx, SSL_CTRL_GET_MAX_PROTO_VERSION, 0, NULL)
  1422. # define SSL_set_min_proto_version(s, version) \
  1423. SSL_ctrl(s, SSL_CTRL_SET_MIN_PROTO_VERSION, version, NULL)
  1424. # define SSL_set_max_proto_version(s, version) \
  1425. SSL_ctrl(s, SSL_CTRL_SET_MAX_PROTO_VERSION, version, NULL)
  1426. # define SSL_get_min_proto_version(s) \
  1427. SSL_ctrl(s, SSL_CTRL_GET_MIN_PROTO_VERSION, 0, NULL)
  1428. # define SSL_get_max_proto_version(s) \
  1429. SSL_ctrl(s, SSL_CTRL_GET_MAX_PROTO_VERSION, 0, NULL)
  1430. const char *SSL_get0_group_name(SSL *s);
  1431. const char *SSL_group_to_name(SSL *s, int id);
  1432. /* Backwards compatibility, original 1.1.0 names */
  1433. # define SSL_CTRL_GET_SERVER_TMP_KEY \
  1434. SSL_CTRL_GET_PEER_TMP_KEY
  1435. # define SSL_get_server_tmp_key(s, pk) \
  1436. SSL_get_peer_tmp_key(s, pk)
  1437. int SSL_set0_tmp_dh_pkey(SSL *s, EVP_PKEY *dhpkey);
  1438. int SSL_CTX_set0_tmp_dh_pkey(SSL_CTX *ctx, EVP_PKEY *dhpkey);
  1439. /*
  1440. * The following symbol names are old and obsolete. They are kept
  1441. * for compatibility reasons only and should not be used anymore.
  1442. */
  1443. # define SSL_CTRL_GET_CURVES SSL_CTRL_GET_GROUPS
  1444. # define SSL_CTRL_SET_CURVES SSL_CTRL_SET_GROUPS
  1445. # define SSL_CTRL_SET_CURVES_LIST SSL_CTRL_SET_GROUPS_LIST
  1446. # define SSL_CTRL_GET_SHARED_CURVE SSL_CTRL_GET_SHARED_GROUP
  1447. # define SSL_get1_curves SSL_get1_groups
  1448. # define SSL_CTX_set1_curves SSL_CTX_set1_groups
  1449. # define SSL_CTX_set1_curves_list SSL_CTX_set1_groups_list
  1450. # define SSL_set1_curves SSL_set1_groups
  1451. # define SSL_set1_curves_list SSL_set1_groups_list
  1452. # define SSL_get_shared_curve SSL_get_shared_group
  1453. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1454. /* Provide some compatibility macros for removed functionality. */
  1455. # define SSL_CTX_need_tmp_RSA(ctx) 0
  1456. # define SSL_CTX_set_tmp_rsa(ctx,rsa) 1
  1457. # define SSL_need_tmp_RSA(ssl) 0
  1458. # define SSL_set_tmp_rsa(ssl,rsa) 1
  1459. # define SSL_CTX_set_ecdh_auto(dummy, onoff) ((onoff) != 0)
  1460. # define SSL_set_ecdh_auto(dummy, onoff) ((onoff) != 0)
  1461. /*
  1462. * We "pretend" to call the callback to avoid warnings about unused static
  1463. * functions.
  1464. */
  1465. # define SSL_CTX_set_tmp_rsa_callback(ctx, cb) while(0) (cb)(NULL, 0, 0)
  1466. # define SSL_set_tmp_rsa_callback(ssl, cb) while(0) (cb)(NULL, 0, 0)
  1467. # endif
  1468. __owur const BIO_METHOD *BIO_f_ssl(void);
  1469. __owur BIO *BIO_new_ssl(SSL_CTX *ctx, int client);
  1470. __owur BIO *BIO_new_ssl_connect(SSL_CTX *ctx);
  1471. __owur BIO *BIO_new_buffer_ssl_connect(SSL_CTX *ctx);
  1472. __owur int BIO_ssl_copy_session_id(BIO *to, BIO *from);
  1473. void BIO_ssl_shutdown(BIO *ssl_bio);
  1474. __owur int SSL_CTX_set_cipher_list(SSL_CTX *, const char *str);
  1475. __owur SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth);
  1476. __owur SSL_CTX *SSL_CTX_new_ex(OSSL_LIB_CTX *libctx, const char *propq,
  1477. const SSL_METHOD *meth);
  1478. int SSL_CTX_up_ref(SSL_CTX *ctx);
  1479. void SSL_CTX_free(SSL_CTX *);
  1480. __owur long SSL_CTX_set_timeout(SSL_CTX *ctx, long t);
  1481. __owur long SSL_CTX_get_timeout(const SSL_CTX *ctx);
  1482. __owur X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *);
  1483. void SSL_CTX_set_cert_store(SSL_CTX *, X509_STORE *);
  1484. void SSL_CTX_set1_cert_store(SSL_CTX *, X509_STORE *);
  1485. __owur int SSL_want(const SSL *s);
  1486. __owur int SSL_clear(SSL *s);
  1487. #ifndef OPENSSL_NO_DEPRECATED_3_4
  1488. OSSL_DEPRECATEDIN_3_4_FOR("not Y2038-safe, replace with SSL_CTX_flush_sessions_ex()")
  1489. void SSL_CTX_flush_sessions(SSL_CTX *ctx, long tm);
  1490. #endif
  1491. void SSL_CTX_flush_sessions_ex(SSL_CTX *ctx, time_t tm);
  1492. __owur const SSL_CIPHER *SSL_get_current_cipher(const SSL *s);
  1493. __owur const SSL_CIPHER *SSL_get_pending_cipher(const SSL *s);
  1494. __owur int SSL_CIPHER_get_bits(const SSL_CIPHER *c, int *alg_bits);
  1495. __owur const char *SSL_CIPHER_get_version(const SSL_CIPHER *c);
  1496. __owur const char *SSL_CIPHER_get_name(const SSL_CIPHER *c);
  1497. __owur const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c);
  1498. __owur const char *OPENSSL_cipher_name(const char *rfc_name);
  1499. __owur uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *c);
  1500. __owur uint16_t SSL_CIPHER_get_protocol_id(const SSL_CIPHER *c);
  1501. __owur int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *c);
  1502. __owur int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *c);
  1503. __owur const EVP_MD *SSL_CIPHER_get_handshake_digest(const SSL_CIPHER *c);
  1504. __owur int SSL_CIPHER_is_aead(const SSL_CIPHER *c);
  1505. __owur int SSL_get_fd(const SSL *s);
  1506. __owur int SSL_get_rfd(const SSL *s);
  1507. __owur int SSL_get_wfd(const SSL *s);
  1508. __owur const char *SSL_get_cipher_list(const SSL *s, int n);
  1509. __owur char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size);
  1510. __owur int SSL_get_read_ahead(const SSL *s);
  1511. __owur int SSL_pending(const SSL *s);
  1512. __owur int SSL_has_pending(const SSL *s);
  1513. # ifndef OPENSSL_NO_SOCK
  1514. __owur int SSL_set_fd(SSL *s, int fd);
  1515. __owur int SSL_set_rfd(SSL *s, int fd);
  1516. __owur int SSL_set_wfd(SSL *s, int fd);
  1517. # endif
  1518. void SSL_set0_rbio(SSL *s, BIO *rbio);
  1519. void SSL_set0_wbio(SSL *s, BIO *wbio);
  1520. void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio);
  1521. __owur BIO *SSL_get_rbio(const SSL *s);
  1522. __owur BIO *SSL_get_wbio(const SSL *s);
  1523. __owur int SSL_set_cipher_list(SSL *s, const char *str);
  1524. __owur int SSL_CTX_set_ciphersuites(SSL_CTX *ctx, const char *str);
  1525. __owur int SSL_set_ciphersuites(SSL *s, const char *str);
  1526. void SSL_set_read_ahead(SSL *s, int yes);
  1527. __owur int SSL_get_verify_mode(const SSL *s);
  1528. __owur int SSL_get_verify_depth(const SSL *s);
  1529. __owur SSL_verify_cb SSL_get_verify_callback(const SSL *s);
  1530. void SSL_set_verify(SSL *s, int mode, SSL_verify_cb callback);
  1531. void SSL_set_verify_depth(SSL *s, int depth);
  1532. void SSL_set_cert_cb(SSL *s, int (*cb) (SSL *ssl, void *arg), void *arg);
  1533. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1534. OSSL_DEPRECATEDIN_3_0 __owur int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa);
  1535. OSSL_DEPRECATEDIN_3_0
  1536. __owur int SSL_use_RSAPrivateKey_ASN1(SSL *ssl,
  1537. const unsigned char *d, long len);
  1538. # endif
  1539. __owur int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey);
  1540. __owur int SSL_use_PrivateKey_ASN1(int pk, SSL *ssl, const unsigned char *d,
  1541. long len);
  1542. __owur int SSL_use_certificate(SSL *ssl, X509 *x);
  1543. __owur int SSL_use_certificate_ASN1(SSL *ssl, const unsigned char *d, int len);
  1544. __owur int SSL_use_cert_and_key(SSL *ssl, X509 *x509, EVP_PKEY *privatekey,
  1545. STACK_OF(X509) *chain, int override);
  1546. /* serverinfo file format versions */
  1547. # define SSL_SERVERINFOV1 1
  1548. # define SSL_SERVERINFOV2 2
  1549. /* Set serverinfo data for the current active cert. */
  1550. __owur int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo,
  1551. size_t serverinfo_length);
  1552. __owur int SSL_CTX_use_serverinfo_ex(SSL_CTX *ctx, unsigned int version,
  1553. const unsigned char *serverinfo,
  1554. size_t serverinfo_length);
  1555. __owur int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file);
  1556. #ifndef OPENSSL_NO_DEPRECATED_3_0
  1557. OSSL_DEPRECATEDIN_3_0
  1558. __owur int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, int type);
  1559. #endif
  1560. __owur int SSL_use_PrivateKey_file(SSL *ssl, const char *file, int type);
  1561. __owur int SSL_use_certificate_file(SSL *ssl, const char *file, int type);
  1562. #ifndef OPENSSL_NO_DEPRECATED_3_0
  1563. OSSL_DEPRECATEDIN_3_0
  1564. __owur int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, const char *file,
  1565. int type);
  1566. #endif
  1567. __owur int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file,
  1568. int type);
  1569. __owur int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file,
  1570. int type);
  1571. /* PEM type */
  1572. __owur int SSL_CTX_use_certificate_chain_file(SSL_CTX *ctx, const char *file);
  1573. __owur int SSL_use_certificate_chain_file(SSL *ssl, const char *file);
  1574. __owur STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
  1575. __owur STACK_OF(X509_NAME)
  1576. *SSL_load_client_CA_file_ex(const char *file, OSSL_LIB_CTX *libctx,
  1577. const char *propq);
  1578. __owur int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
  1579. const char *file);
  1580. int SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
  1581. const char *dir);
  1582. int SSL_add_store_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
  1583. const char *uri);
  1584. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1585. # define SSL_load_error_strings() \
  1586. OPENSSL_init_ssl(OPENSSL_INIT_LOAD_SSL_STRINGS \
  1587. | OPENSSL_INIT_LOAD_CRYPTO_STRINGS, NULL)
  1588. # endif
  1589. __owur const char *SSL_state_string(const SSL *s);
  1590. __owur const char *SSL_rstate_string(const SSL *s);
  1591. __owur const char *SSL_state_string_long(const SSL *s);
  1592. __owur const char *SSL_rstate_string_long(const SSL *s);
  1593. #ifndef OPENSSL_NO_DEPRECATED_3_4
  1594. OSSL_DEPRECATEDIN_3_4_FOR("not Y2038-safe, replace with SSL_SESSION_get_time_ex()")
  1595. __owur long SSL_SESSION_get_time(const SSL_SESSION *s);
  1596. OSSL_DEPRECATEDIN_3_4_FOR("not Y2038-safe, replace with SSL_SESSION_set_time_ex()")
  1597. __owur long SSL_SESSION_set_time(SSL_SESSION *s, long t);
  1598. #endif
  1599. __owur long SSL_SESSION_get_timeout(const SSL_SESSION *s);
  1600. __owur long SSL_SESSION_set_timeout(SSL_SESSION *s, long t);
  1601. __owur int SSL_SESSION_get_protocol_version(const SSL_SESSION *s);
  1602. __owur int SSL_SESSION_set_protocol_version(SSL_SESSION *s, int version);
  1603. __owur time_t SSL_SESSION_get_time_ex(const SSL_SESSION *s);
  1604. __owur time_t SSL_SESSION_set_time_ex(SSL_SESSION *s, time_t t);
  1605. __owur const char *SSL_SESSION_get0_hostname(const SSL_SESSION *s);
  1606. __owur int SSL_SESSION_set1_hostname(SSL_SESSION *s, const char *hostname);
  1607. void SSL_SESSION_get0_alpn_selected(const SSL_SESSION *s,
  1608. const unsigned char **alpn,
  1609. size_t *len);
  1610. __owur int SSL_SESSION_set1_alpn_selected(SSL_SESSION *s,
  1611. const unsigned char *alpn,
  1612. size_t len);
  1613. __owur const SSL_CIPHER *SSL_SESSION_get0_cipher(const SSL_SESSION *s);
  1614. __owur int SSL_SESSION_set_cipher(SSL_SESSION *s, const SSL_CIPHER *cipher);
  1615. __owur int SSL_SESSION_has_ticket(const SSL_SESSION *s);
  1616. __owur unsigned long SSL_SESSION_get_ticket_lifetime_hint(const SSL_SESSION *s);
  1617. void SSL_SESSION_get0_ticket(const SSL_SESSION *s, const unsigned char **tick,
  1618. size_t *len);
  1619. __owur uint32_t SSL_SESSION_get_max_early_data(const SSL_SESSION *s);
  1620. __owur int SSL_SESSION_set_max_early_data(SSL_SESSION *s,
  1621. uint32_t max_early_data);
  1622. __owur int SSL_copy_session_id(SSL *to, const SSL *from);
  1623. __owur X509 *SSL_SESSION_get0_peer(SSL_SESSION *s);
  1624. __owur int SSL_SESSION_set1_id_context(SSL_SESSION *s,
  1625. const unsigned char *sid_ctx,
  1626. unsigned int sid_ctx_len);
  1627. __owur int SSL_SESSION_set1_id(SSL_SESSION *s, const unsigned char *sid,
  1628. unsigned int sid_len);
  1629. __owur int SSL_SESSION_is_resumable(const SSL_SESSION *s);
  1630. __owur SSL_SESSION *SSL_SESSION_new(void);
  1631. __owur SSL_SESSION *SSL_SESSION_dup(const SSL_SESSION *src);
  1632. const unsigned char *SSL_SESSION_get_id(const SSL_SESSION *s,
  1633. unsigned int *len);
  1634. const unsigned char *SSL_SESSION_get0_id_context(const SSL_SESSION *s,
  1635. unsigned int *len);
  1636. __owur unsigned int SSL_SESSION_get_compress_id(const SSL_SESSION *s);
  1637. # ifndef OPENSSL_NO_STDIO
  1638. int SSL_SESSION_print_fp(FILE *fp, const SSL_SESSION *ses);
  1639. # endif
  1640. int SSL_SESSION_print(BIO *fp, const SSL_SESSION *ses);
  1641. int SSL_SESSION_print_keylog(BIO *bp, const SSL_SESSION *x);
  1642. int SSL_SESSION_up_ref(SSL_SESSION *ses);
  1643. void SSL_SESSION_free(SSL_SESSION *ses);
  1644. __owur int i2d_SSL_SESSION(const SSL_SESSION *in, unsigned char **pp);
  1645. __owur int SSL_set_session(SSL *to, SSL_SESSION *session);
  1646. int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *session);
  1647. int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *session);
  1648. __owur int SSL_CTX_set_generate_session_id(SSL_CTX *ctx, GEN_SESSION_CB cb);
  1649. __owur int SSL_set_generate_session_id(SSL *s, GEN_SESSION_CB cb);
  1650. __owur int SSL_has_matching_session_id(const SSL *s,
  1651. const unsigned char *id,
  1652. unsigned int id_len);
  1653. SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const unsigned char **pp,
  1654. long length);
  1655. SSL_SESSION *d2i_SSL_SESSION_ex(SSL_SESSION **a, const unsigned char **pp,
  1656. long length, OSSL_LIB_CTX *libctx,
  1657. const char *propq);
  1658. # ifdef OPENSSL_X509_H
  1659. __owur X509 *SSL_get0_peer_certificate(const SSL *s);
  1660. __owur X509 *SSL_get1_peer_certificate(const SSL *s);
  1661. /* Deprecated in 3.0.0 */
  1662. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1663. # define SSL_get_peer_certificate SSL_get1_peer_certificate
  1664. # endif
  1665. # endif
  1666. __owur STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s);
  1667. __owur int SSL_CTX_get_verify_mode(const SSL_CTX *ctx);
  1668. __owur int SSL_CTX_get_verify_depth(const SSL_CTX *ctx);
  1669. __owur SSL_verify_cb SSL_CTX_get_verify_callback(const SSL_CTX *ctx);
  1670. void SSL_CTX_set_verify(SSL_CTX *ctx, int mode, SSL_verify_cb callback);
  1671. void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth);
  1672. void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx,
  1673. int (*cb) (X509_STORE_CTX *, void *),
  1674. void *arg);
  1675. void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb) (SSL *ssl, void *arg),
  1676. void *arg);
  1677. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1678. OSSL_DEPRECATEDIN_3_0
  1679. __owur int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa);
  1680. OSSL_DEPRECATEDIN_3_0
  1681. __owur int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, const unsigned char *d,
  1682. long len);
  1683. # endif
  1684. __owur int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
  1685. __owur int SSL_CTX_use_PrivateKey_ASN1(int pk, SSL_CTX *ctx,
  1686. const unsigned char *d, long len);
  1687. __owur int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
  1688. __owur int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len,
  1689. const unsigned char *d);
  1690. __owur int SSL_CTX_use_cert_and_key(SSL_CTX *ctx, X509 *x509, EVP_PKEY *privatekey,
  1691. STACK_OF(X509) *chain, int override);
  1692. void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb);
  1693. void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u);
  1694. pem_password_cb *SSL_CTX_get_default_passwd_cb(SSL_CTX *ctx);
  1695. void *SSL_CTX_get_default_passwd_cb_userdata(SSL_CTX *ctx);
  1696. void SSL_set_default_passwd_cb(SSL *s, pem_password_cb *cb);
  1697. void SSL_set_default_passwd_cb_userdata(SSL *s, void *u);
  1698. pem_password_cb *SSL_get_default_passwd_cb(SSL *s);
  1699. void *SSL_get_default_passwd_cb_userdata(SSL *s);
  1700. __owur int SSL_CTX_check_private_key(const SSL_CTX *ctx);
  1701. __owur int SSL_check_private_key(const SSL *ctx);
  1702. __owur int SSL_CTX_set_session_id_context(SSL_CTX *ctx,
  1703. const unsigned char *sid_ctx,
  1704. unsigned int sid_ctx_len);
  1705. SSL *SSL_new(SSL_CTX *ctx);
  1706. int SSL_up_ref(SSL *s);
  1707. int SSL_is_dtls(const SSL *s);
  1708. int SSL_is_tls(const SSL *s);
  1709. int SSL_is_quic(const SSL *s);
  1710. __owur int SSL_set_session_id_context(SSL *ssl, const unsigned char *sid_ctx,
  1711. unsigned int sid_ctx_len);
  1712. __owur int SSL_CTX_set_purpose(SSL_CTX *ctx, int purpose);
  1713. __owur int SSL_set_purpose(SSL *ssl, int purpose);
  1714. __owur int SSL_CTX_set_trust(SSL_CTX *ctx, int trust);
  1715. __owur int SSL_set_trust(SSL *ssl, int trust);
  1716. __owur int SSL_set1_host(SSL *s, const char *hostname);
  1717. __owur int SSL_add1_host(SSL *s, const char *hostname);
  1718. __owur const char *SSL_get0_peername(SSL *s);
  1719. void SSL_set_hostflags(SSL *s, unsigned int flags);
  1720. __owur int SSL_CTX_dane_enable(SSL_CTX *ctx);
  1721. __owur int SSL_CTX_dane_mtype_set(SSL_CTX *ctx, const EVP_MD *md,
  1722. uint8_t mtype, uint8_t ord);
  1723. __owur int SSL_dane_enable(SSL *s, const char *basedomain);
  1724. __owur int SSL_dane_tlsa_add(SSL *s, uint8_t usage, uint8_t selector,
  1725. uint8_t mtype, const unsigned char *data, size_t dlen);
  1726. __owur int SSL_get0_dane_authority(SSL *s, X509 **mcert, EVP_PKEY **mspki);
  1727. __owur int SSL_get0_dane_tlsa(SSL *s, uint8_t *usage, uint8_t *selector,
  1728. uint8_t *mtype, const unsigned char **data,
  1729. size_t *dlen);
  1730. /*
  1731. * Bridge opacity barrier between libcrypt and libssl, also needed to support
  1732. * offline testing in test/danetest.c
  1733. */
  1734. SSL_DANE *SSL_get0_dane(SSL *ssl);
  1735. /*
  1736. * DANE flags
  1737. */
  1738. unsigned long SSL_CTX_dane_set_flags(SSL_CTX *ctx, unsigned long flags);
  1739. unsigned long SSL_CTX_dane_clear_flags(SSL_CTX *ctx, unsigned long flags);
  1740. unsigned long SSL_dane_set_flags(SSL *ssl, unsigned long flags);
  1741. unsigned long SSL_dane_clear_flags(SSL *ssl, unsigned long flags);
  1742. __owur int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm);
  1743. __owur int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm);
  1744. __owur X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx);
  1745. __owur X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl);
  1746. # ifndef OPENSSL_NO_SRP
  1747. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1748. OSSL_DEPRECATEDIN_3_0 int SSL_CTX_set_srp_username(SSL_CTX *ctx, char *name);
  1749. OSSL_DEPRECATEDIN_3_0 int SSL_CTX_set_srp_password(SSL_CTX *ctx, char *password);
  1750. OSSL_DEPRECATEDIN_3_0 int SSL_CTX_set_srp_strength(SSL_CTX *ctx, int strength);
  1751. OSSL_DEPRECATEDIN_3_0
  1752. int SSL_CTX_set_srp_client_pwd_callback(SSL_CTX *ctx,
  1753. char *(*cb) (SSL *, void *));
  1754. OSSL_DEPRECATEDIN_3_0
  1755. int SSL_CTX_set_srp_verify_param_callback(SSL_CTX *ctx,
  1756. int (*cb) (SSL *, void *));
  1757. OSSL_DEPRECATEDIN_3_0
  1758. int SSL_CTX_set_srp_username_callback(SSL_CTX *ctx,
  1759. int (*cb) (SSL *, int *, void *));
  1760. OSSL_DEPRECATEDIN_3_0 int SSL_CTX_set_srp_cb_arg(SSL_CTX *ctx, void *arg);
  1761. OSSL_DEPRECATEDIN_3_0
  1762. int SSL_set_srp_server_param(SSL *s, const BIGNUM *N, const BIGNUM *g,
  1763. BIGNUM *sa, BIGNUM *v, char *info);
  1764. OSSL_DEPRECATEDIN_3_0
  1765. int SSL_set_srp_server_param_pw(SSL *s, const char *user, const char *pass,
  1766. const char *grp);
  1767. OSSL_DEPRECATEDIN_3_0 __owur BIGNUM *SSL_get_srp_g(SSL *s);
  1768. OSSL_DEPRECATEDIN_3_0 __owur BIGNUM *SSL_get_srp_N(SSL *s);
  1769. OSSL_DEPRECATEDIN_3_0 __owur char *SSL_get_srp_username(SSL *s);
  1770. OSSL_DEPRECATEDIN_3_0 __owur char *SSL_get_srp_userinfo(SSL *s);
  1771. # endif
  1772. # endif
  1773. /*
  1774. * ClientHello callback and helpers.
  1775. */
  1776. # define SSL_CLIENT_HELLO_SUCCESS 1
  1777. # define SSL_CLIENT_HELLO_ERROR 0
  1778. # define SSL_CLIENT_HELLO_RETRY (-1)
  1779. typedef int (*SSL_client_hello_cb_fn) (SSL *s, int *al, void *arg);
  1780. void SSL_CTX_set_client_hello_cb(SSL_CTX *c, SSL_client_hello_cb_fn cb,
  1781. void *arg);
  1782. int SSL_client_hello_isv2(SSL *s);
  1783. unsigned int SSL_client_hello_get0_legacy_version(SSL *s);
  1784. size_t SSL_client_hello_get0_random(SSL *s, const unsigned char **out);
  1785. size_t SSL_client_hello_get0_session_id(SSL *s, const unsigned char **out);
  1786. size_t SSL_client_hello_get0_ciphers(SSL *s, const unsigned char **out);
  1787. size_t SSL_client_hello_get0_compression_methods(SSL *s,
  1788. const unsigned char **out);
  1789. int SSL_client_hello_get1_extensions_present(SSL *s, int **out, size_t *outlen);
  1790. int SSL_client_hello_get_extension_order(SSL *s, uint16_t *exts,
  1791. size_t *num_exts);
  1792. int SSL_client_hello_get0_ext(SSL *s, unsigned int type,
  1793. const unsigned char **out, size_t *outlen);
  1794. void SSL_certs_clear(SSL *s);
  1795. void SSL_free(SSL *ssl);
  1796. # ifdef OSSL_ASYNC_FD
  1797. /*
  1798. * Windows application developer has to include windows.h to use these.
  1799. */
  1800. __owur int SSL_waiting_for_async(SSL *s);
  1801. __owur int SSL_get_all_async_fds(SSL *s, OSSL_ASYNC_FD *fds, size_t *numfds);
  1802. __owur int SSL_get_changed_async_fds(SSL *s, OSSL_ASYNC_FD *addfd,
  1803. size_t *numaddfds, OSSL_ASYNC_FD *delfd,
  1804. size_t *numdelfds);
  1805. __owur int SSL_CTX_set_async_callback(SSL_CTX *ctx, SSL_async_callback_fn callback);
  1806. __owur int SSL_CTX_set_async_callback_arg(SSL_CTX *ctx, void *arg);
  1807. __owur int SSL_set_async_callback(SSL *s, SSL_async_callback_fn callback);
  1808. __owur int SSL_set_async_callback_arg(SSL *s, void *arg);
  1809. __owur int SSL_get_async_status(SSL *s, int *status);
  1810. # endif
  1811. __owur int SSL_accept(SSL *ssl);
  1812. __owur int SSL_stateless(SSL *s);
  1813. __owur int SSL_connect(SSL *ssl);
  1814. __owur int SSL_read(SSL *ssl, void *buf, int num);
  1815. __owur int SSL_read_ex(SSL *ssl, void *buf, size_t num, size_t *readbytes);
  1816. # define SSL_READ_EARLY_DATA_ERROR 0
  1817. # define SSL_READ_EARLY_DATA_SUCCESS 1
  1818. # define SSL_READ_EARLY_DATA_FINISH 2
  1819. __owur int SSL_read_early_data(SSL *s, void *buf, size_t num,
  1820. size_t *readbytes);
  1821. __owur int SSL_peek(SSL *ssl, void *buf, int num);
  1822. __owur int SSL_peek_ex(SSL *ssl, void *buf, size_t num, size_t *readbytes);
  1823. __owur ossl_ssize_t SSL_sendfile(SSL *s, int fd, off_t offset, size_t size,
  1824. int flags);
  1825. __owur int SSL_write(SSL *ssl, const void *buf, int num);
  1826. __owur int SSL_write_ex(SSL *s, const void *buf, size_t num, size_t *written);
  1827. __owur int SSL_write_early_data(SSL *s, const void *buf, size_t num,
  1828. size_t *written);
  1829. long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg);
  1830. long SSL_callback_ctrl(SSL *, int, void (*)(void));
  1831. long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg);
  1832. long SSL_CTX_callback_ctrl(SSL_CTX *, int, void (*)(void));
  1833. # define SSL_WRITE_FLAG_CONCLUDE (1U << 0)
  1834. __owur int SSL_write_ex2(SSL *s, const void *buf, size_t num,
  1835. uint64_t flags,
  1836. size_t *written);
  1837. # define SSL_EARLY_DATA_NOT_SENT 0
  1838. # define SSL_EARLY_DATA_REJECTED 1
  1839. # define SSL_EARLY_DATA_ACCEPTED 2
  1840. __owur int SSL_get_early_data_status(const SSL *s);
  1841. __owur int SSL_get_error(const SSL *s, int ret_code);
  1842. __owur const char *SSL_get_version(const SSL *s);
  1843. __owur int SSL_get_handshake_rtt(const SSL *s, uint64_t *rtt);
  1844. /* This sets the 'default' SSL version that SSL_new() will create */
  1845. # ifndef OPENSSL_NO_DEPRECATED_3_0
  1846. OSSL_DEPRECATEDIN_3_0
  1847. __owur int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth);
  1848. # endif
  1849. # ifndef OPENSSL_NO_SSL3_METHOD
  1850. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1851. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *SSLv3_method(void); /* SSLv3 */
  1852. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *SSLv3_server_method(void);
  1853. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *SSLv3_client_method(void);
  1854. # endif
  1855. # endif
  1856. #define SSLv23_method TLS_method
  1857. #define SSLv23_server_method TLS_server_method
  1858. #define SSLv23_client_method TLS_client_method
  1859. /* Negotiate highest available SSL/TLS version */
  1860. __owur const SSL_METHOD *TLS_method(void);
  1861. __owur const SSL_METHOD *TLS_server_method(void);
  1862. __owur const SSL_METHOD *TLS_client_method(void);
  1863. # ifndef OPENSSL_NO_TLS1_METHOD
  1864. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1865. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_method(void); /* TLSv1.0 */
  1866. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_server_method(void);
  1867. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_client_method(void);
  1868. # endif
  1869. # endif
  1870. # ifndef OPENSSL_NO_TLS1_1_METHOD
  1871. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1872. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_1_method(void); /* TLSv1.1 */
  1873. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_1_server_method(void);
  1874. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_1_client_method(void);
  1875. # endif
  1876. # endif
  1877. # ifndef OPENSSL_NO_TLS1_2_METHOD
  1878. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1879. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_2_method(void); /* TLSv1.2 */
  1880. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_2_server_method(void);
  1881. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *TLSv1_2_client_method(void);
  1882. # endif
  1883. # endif
  1884. # ifndef OPENSSL_NO_DTLS1_METHOD
  1885. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1886. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_method(void); /* DTLSv1.0 */
  1887. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_server_method(void);
  1888. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_client_method(void);
  1889. # endif
  1890. # endif
  1891. # ifndef OPENSSL_NO_DTLS1_2_METHOD
  1892. /* DTLSv1.2 */
  1893. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1894. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_2_method(void);
  1895. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_2_server_method(void);
  1896. OSSL_DEPRECATEDIN_1_1_0 __owur const SSL_METHOD *DTLSv1_2_client_method(void);
  1897. # endif
  1898. # endif
  1899. __owur const SSL_METHOD *DTLS_method(void); /* DTLS 1.0 and 1.2 */
  1900. __owur const SSL_METHOD *DTLS_server_method(void); /* DTLS 1.0 and 1.2 */
  1901. __owur const SSL_METHOD *DTLS_client_method(void); /* DTLS 1.0 and 1.2 */
  1902. __owur size_t DTLS_get_data_mtu(const SSL *s);
  1903. __owur STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s);
  1904. __owur STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx);
  1905. __owur STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *s);
  1906. __owur STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s);
  1907. __owur int SSL_do_handshake(SSL *s);
  1908. int SSL_key_update(SSL *s, int updatetype);
  1909. int SSL_get_key_update_type(const SSL *s);
  1910. int SSL_renegotiate(SSL *s);
  1911. int SSL_renegotiate_abbreviated(SSL *s);
  1912. __owur int SSL_renegotiate_pending(const SSL *s);
  1913. int SSL_new_session_ticket(SSL *s);
  1914. int SSL_shutdown(SSL *s);
  1915. __owur int SSL_verify_client_post_handshake(SSL *s);
  1916. void SSL_CTX_set_post_handshake_auth(SSL_CTX *ctx, int val);
  1917. void SSL_set_post_handshake_auth(SSL *s, int val);
  1918. __owur const SSL_METHOD *SSL_CTX_get_ssl_method(const SSL_CTX *ctx);
  1919. __owur const SSL_METHOD *SSL_get_ssl_method(const SSL *s);
  1920. __owur int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
  1921. __owur const char *SSL_alert_type_string_long(int value);
  1922. __owur const char *SSL_alert_type_string(int value);
  1923. __owur const char *SSL_alert_desc_string_long(int value);
  1924. __owur const char *SSL_alert_desc_string(int value);
  1925. void SSL_set0_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list);
  1926. void SSL_CTX_set0_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list);
  1927. __owur const STACK_OF(X509_NAME) *SSL_get0_CA_list(const SSL *s);
  1928. __owur const STACK_OF(X509_NAME) *SSL_CTX_get0_CA_list(const SSL_CTX *ctx);
  1929. __owur int SSL_add1_to_CA_list(SSL *ssl, const X509 *x);
  1930. __owur int SSL_CTX_add1_to_CA_list(SSL_CTX *ctx, const X509 *x);
  1931. __owur const STACK_OF(X509_NAME) *SSL_get0_peer_CA_list(const SSL *s);
  1932. void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list);
  1933. void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list);
  1934. __owur STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s);
  1935. __owur STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *s);
  1936. __owur int SSL_add_client_CA(SSL *ssl, X509 *x);
  1937. __owur int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *x);
  1938. void SSL_set_connect_state(SSL *s);
  1939. void SSL_set_accept_state(SSL *s);
  1940. __owur long SSL_get_default_timeout(const SSL *s);
  1941. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  1942. # define SSL_library_init() OPENSSL_init_ssl(0, NULL)
  1943. # endif
  1944. __owur char *SSL_CIPHER_description(const SSL_CIPHER *, char *buf, int size);
  1945. __owur STACK_OF(X509_NAME) *SSL_dup_CA_list(const STACK_OF(X509_NAME) *sk);
  1946. __owur SSL *SSL_dup(SSL *ssl);
  1947. __owur X509 *SSL_get_certificate(const SSL *ssl);
  1948. /*
  1949. * EVP_PKEY
  1950. */
  1951. struct evp_pkey_st *SSL_get_privatekey(const SSL *ssl);
  1952. __owur X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx);
  1953. __owur EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx);
  1954. void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode);
  1955. __owur int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx);
  1956. void SSL_set_quiet_shutdown(SSL *ssl, int mode);
  1957. __owur int SSL_get_quiet_shutdown(const SSL *ssl);
  1958. void SSL_set_shutdown(SSL *ssl, int mode);
  1959. __owur int SSL_get_shutdown(const SSL *ssl);
  1960. __owur int SSL_version(const SSL *ssl);
  1961. __owur int SSL_client_version(const SSL *s);
  1962. __owur int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx);
  1963. __owur int SSL_CTX_set_default_verify_dir(SSL_CTX *ctx);
  1964. __owur int SSL_CTX_set_default_verify_file(SSL_CTX *ctx);
  1965. __owur int SSL_CTX_set_default_verify_store(SSL_CTX *ctx);
  1966. __owur int SSL_CTX_load_verify_file(SSL_CTX *ctx, const char *CAfile);
  1967. __owur int SSL_CTX_load_verify_dir(SSL_CTX *ctx, const char *CApath);
  1968. __owur int SSL_CTX_load_verify_store(SSL_CTX *ctx, const char *CAstore);
  1969. __owur int SSL_CTX_load_verify_locations(SSL_CTX *ctx,
  1970. const char *CAfile,
  1971. const char *CApath);
  1972. # define SSL_get0_session SSL_get_session/* just peek at pointer */
  1973. __owur SSL_SESSION *SSL_get_session(const SSL *ssl);
  1974. __owur SSL_SESSION *SSL_get1_session(SSL *ssl); /* obtain a reference count */
  1975. __owur SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl);
  1976. SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx);
  1977. void SSL_set_info_callback(SSL *ssl,
  1978. void (*cb) (const SSL *ssl, int type, int val));
  1979. void (*SSL_get_info_callback(const SSL *ssl)) (const SSL *ssl, int type,
  1980. int val);
  1981. __owur OSSL_HANDSHAKE_STATE SSL_get_state(const SSL *ssl);
  1982. void SSL_set_verify_result(SSL *ssl, long v);
  1983. __owur long SSL_get_verify_result(const SSL *ssl);
  1984. __owur STACK_OF(X509) *SSL_get0_verified_chain(const SSL *s);
  1985. __owur size_t SSL_get_client_random(const SSL *ssl, unsigned char *out,
  1986. size_t outlen);
  1987. __owur size_t SSL_get_server_random(const SSL *ssl, unsigned char *out,
  1988. size_t outlen);
  1989. __owur size_t SSL_SESSION_get_master_key(const SSL_SESSION *sess,
  1990. unsigned char *out, size_t outlen);
  1991. __owur int SSL_SESSION_set1_master_key(SSL_SESSION *sess,
  1992. const unsigned char *in, size_t len);
  1993. uint8_t SSL_SESSION_get_max_fragment_length(const SSL_SESSION *sess);
  1994. #define SSL_get_ex_new_index(l, p, newf, dupf, freef) \
  1995. CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL, l, p, newf, dupf, freef)
  1996. __owur int SSL_set_ex_data(SSL *ssl, int idx, void *data);
  1997. void *SSL_get_ex_data(const SSL *ssl, int idx);
  1998. #define SSL_SESSION_get_ex_new_index(l, p, newf, dupf, freef) \
  1999. CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_SESSION, l, p, newf, dupf, freef)
  2000. __owur int SSL_SESSION_set_ex_data(SSL_SESSION *ss, int idx, void *data);
  2001. void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss, int idx);
  2002. #define SSL_CTX_get_ex_new_index(l, p, newf, dupf, freef) \
  2003. CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_CTX, l, p, newf, dupf, freef)
  2004. __owur int SSL_CTX_set_ex_data(SSL_CTX *ssl, int idx, void *data);
  2005. void *SSL_CTX_get_ex_data(const SSL_CTX *ssl, int idx);
  2006. __owur int SSL_get_ex_data_X509_STORE_CTX_idx(void);
  2007. # define SSL_CTX_sess_set_cache_size(ctx,t) \
  2008. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_SIZE,t,NULL)
  2009. # define SSL_CTX_sess_get_cache_size(ctx) \
  2010. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_SIZE,0,NULL)
  2011. # define SSL_CTX_set_session_cache_mode(ctx,m) \
  2012. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_MODE,m,NULL)
  2013. # define SSL_CTX_get_session_cache_mode(ctx) \
  2014. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_MODE,0,NULL)
  2015. # define SSL_CTX_get_default_read_ahead(ctx) SSL_CTX_get_read_ahead(ctx)
  2016. # define SSL_CTX_set_default_read_ahead(ctx,m) SSL_CTX_set_read_ahead(ctx,m)
  2017. # define SSL_CTX_get_read_ahead(ctx) \
  2018. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_READ_AHEAD,0,NULL)
  2019. # define SSL_CTX_set_read_ahead(ctx,m) \
  2020. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_READ_AHEAD,m,NULL)
  2021. # define SSL_CTX_get_max_cert_list(ctx) \
  2022. SSL_CTX_ctrl(ctx,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
  2023. # define SSL_CTX_set_max_cert_list(ctx,m) \
  2024. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
  2025. # define SSL_get_max_cert_list(ssl) \
  2026. SSL_ctrl(ssl,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
  2027. # define SSL_set_max_cert_list(ssl,m) \
  2028. SSL_ctrl(ssl,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
  2029. # define SSL_CTX_set_max_send_fragment(ctx,m) \
  2030. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
  2031. # define SSL_set_max_send_fragment(ssl,m) \
  2032. SSL_ctrl(ssl,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
  2033. # define SSL_CTX_set_split_send_fragment(ctx,m) \
  2034. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SPLIT_SEND_FRAGMENT,m,NULL)
  2035. # define SSL_set_split_send_fragment(ssl,m) \
  2036. SSL_ctrl(ssl,SSL_CTRL_SET_SPLIT_SEND_FRAGMENT,m,NULL)
  2037. # define SSL_CTX_set_max_pipelines(ctx,m) \
  2038. SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_PIPELINES,m,NULL)
  2039. # define SSL_set_max_pipelines(ssl,m) \
  2040. SSL_ctrl(ssl,SSL_CTRL_SET_MAX_PIPELINES,m,NULL)
  2041. # define SSL_set_retry_verify(ssl) \
  2042. (SSL_ctrl(ssl,SSL_CTRL_SET_RETRY_VERIFY,0,NULL) > 0)
  2043. void SSL_CTX_set_default_read_buffer_len(SSL_CTX *ctx, size_t len);
  2044. void SSL_set_default_read_buffer_len(SSL *s, size_t len);
  2045. # ifndef OPENSSL_NO_DH
  2046. # ifndef OPENSSL_NO_DEPRECATED_3_0
  2047. /* NB: the |keylength| is only applicable when is_export is true */
  2048. OSSL_DEPRECATEDIN_3_0
  2049. void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
  2050. DH *(*dh) (SSL *ssl, int is_export,
  2051. int keylength));
  2052. OSSL_DEPRECATEDIN_3_0
  2053. void SSL_set_tmp_dh_callback(SSL *ssl,
  2054. DH *(*dh) (SSL *ssl, int is_export,
  2055. int keylength));
  2056. # endif
  2057. # endif
  2058. __owur const COMP_METHOD *SSL_get_current_compression(const SSL *s);
  2059. __owur const COMP_METHOD *SSL_get_current_expansion(const SSL *s);
  2060. __owur const char *SSL_COMP_get_name(const COMP_METHOD *comp);
  2061. __owur const char *SSL_COMP_get0_name(const SSL_COMP *comp);
  2062. __owur int SSL_COMP_get_id(const SSL_COMP *comp);
  2063. STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void);
  2064. __owur STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP)
  2065. *meths);
  2066. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  2067. # define SSL_COMP_free_compression_methods() while(0) continue
  2068. # endif
  2069. __owur int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm);
  2070. const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr);
  2071. int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *c);
  2072. int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *c);
  2073. int SSL_bytes_to_cipher_list(SSL *s, const unsigned char *bytes, size_t len,
  2074. int isv2format, STACK_OF(SSL_CIPHER) **sk,
  2075. STACK_OF(SSL_CIPHER) **scsvs);
  2076. /* TLS extensions functions */
  2077. __owur int SSL_set_session_ticket_ext(SSL *s, void *ext_data, int ext_len);
  2078. __owur int SSL_set_session_ticket_ext_cb(SSL *s,
  2079. tls_session_ticket_ext_cb_fn cb,
  2080. void *arg);
  2081. /* Pre-shared secret session resumption functions */
  2082. __owur int SSL_set_session_secret_cb(SSL *s,
  2083. tls_session_secret_cb_fn session_secret_cb,
  2084. void *arg);
  2085. void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx,
  2086. int (*cb) (SSL *ssl,
  2087. int
  2088. is_forward_secure));
  2089. void SSL_set_not_resumable_session_callback(SSL *ssl,
  2090. int (*cb) (SSL *ssl,
  2091. int is_forward_secure));
  2092. void SSL_CTX_set_record_padding_callback(SSL_CTX *ctx,
  2093. size_t (*cb) (SSL *ssl, int type,
  2094. size_t len, void *arg));
  2095. void SSL_CTX_set_record_padding_callback_arg(SSL_CTX *ctx, void *arg);
  2096. void *SSL_CTX_get_record_padding_callback_arg(const SSL_CTX *ctx);
  2097. int SSL_CTX_set_block_padding(SSL_CTX *ctx, size_t block_size);
  2098. int SSL_CTX_set_block_padding_ex(SSL_CTX *ctx, size_t app_block_size,
  2099. size_t hs_block_size);
  2100. int SSL_set_record_padding_callback(SSL *ssl,
  2101. size_t (*cb) (SSL *ssl, int type,
  2102. size_t len, void *arg));
  2103. void SSL_set_record_padding_callback_arg(SSL *ssl, void *arg);
  2104. void *SSL_get_record_padding_callback_arg(const SSL *ssl);
  2105. int SSL_set_block_padding(SSL *ssl, size_t block_size);
  2106. int SSL_set_block_padding_ex(SSL *ssl, size_t app_block_size,
  2107. size_t hs_block_size);
  2108. int SSL_set_num_tickets(SSL *s, size_t num_tickets);
  2109. size_t SSL_get_num_tickets(const SSL *s);
  2110. int SSL_CTX_set_num_tickets(SSL_CTX *ctx, size_t num_tickets);
  2111. size_t SSL_CTX_get_num_tickets(const SSL_CTX *ctx);
  2112. /* QUIC support */
  2113. int SSL_handle_events(SSL *s);
  2114. __owur int SSL_get_event_timeout(SSL *s, struct timeval *tv, int *is_infinite);
  2115. __owur int SSL_get_rpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc);
  2116. __owur int SSL_get_wpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc);
  2117. __owur int SSL_net_read_desired(SSL *s);
  2118. __owur int SSL_net_write_desired(SSL *s);
  2119. __owur int SSL_set_blocking_mode(SSL *s, int blocking);
  2120. __owur int SSL_get_blocking_mode(SSL *s);
  2121. __owur int SSL_set1_initial_peer_addr(SSL *s, const BIO_ADDR *peer_addr);
  2122. __owur SSL *SSL_get0_connection(SSL *s);
  2123. __owur int SSL_is_connection(SSL *s);
  2124. #define SSL_STREAM_TYPE_NONE 0
  2125. #define SSL_STREAM_TYPE_READ (1U << 0)
  2126. #define SSL_STREAM_TYPE_WRITE (1U << 1)
  2127. #define SSL_STREAM_TYPE_BIDI (SSL_STREAM_TYPE_READ | SSL_STREAM_TYPE_WRITE)
  2128. __owur int SSL_get_stream_type(SSL *s);
  2129. __owur uint64_t SSL_get_stream_id(SSL *s);
  2130. __owur int SSL_is_stream_local(SSL *s);
  2131. #define SSL_DEFAULT_STREAM_MODE_NONE 0
  2132. #define SSL_DEFAULT_STREAM_MODE_AUTO_BIDI 1
  2133. #define SSL_DEFAULT_STREAM_MODE_AUTO_UNI 2
  2134. __owur int SSL_set_default_stream_mode(SSL *s, uint32_t mode);
  2135. #define SSL_STREAM_FLAG_UNI (1U << 0)
  2136. #define SSL_STREAM_FLAG_NO_BLOCK (1U << 1)
  2137. #define SSL_STREAM_FLAG_ADVANCE (1U << 2)
  2138. __owur SSL *SSL_new_stream(SSL *s, uint64_t flags);
  2139. #define SSL_INCOMING_STREAM_POLICY_AUTO 0
  2140. #define SSL_INCOMING_STREAM_POLICY_ACCEPT 1
  2141. #define SSL_INCOMING_STREAM_POLICY_REJECT 2
  2142. __owur int SSL_set_incoming_stream_policy(SSL *s, int policy, uint64_t aec);
  2143. #define SSL_ACCEPT_STREAM_NO_BLOCK (1U << 0)
  2144. __owur SSL *SSL_accept_stream(SSL *s, uint64_t flags);
  2145. __owur size_t SSL_get_accept_stream_queue_len(SSL *s);
  2146. # ifndef OPENSSL_NO_QUIC
  2147. __owur int SSL_inject_net_dgram(SSL *s, const unsigned char *buf,
  2148. size_t buf_len,
  2149. const BIO_ADDR *peer,
  2150. const BIO_ADDR *local);
  2151. # endif
  2152. typedef struct ssl_shutdown_ex_args_st {
  2153. uint64_t quic_error_code;
  2154. const char *quic_reason;
  2155. } SSL_SHUTDOWN_EX_ARGS;
  2156. #define SSL_SHUTDOWN_FLAG_RAPID (1U << 0)
  2157. #define SSL_SHUTDOWN_FLAG_NO_STREAM_FLUSH (1U << 1)
  2158. #define SSL_SHUTDOWN_FLAG_NO_BLOCK (1U << 2)
  2159. #define SSL_SHUTDOWN_FLAG_WAIT_PEER (1U << 3)
  2160. __owur int SSL_shutdown_ex(SSL *ssl, uint64_t flags,
  2161. const SSL_SHUTDOWN_EX_ARGS *args,
  2162. size_t args_len);
  2163. __owur int SSL_stream_conclude(SSL *ssl, uint64_t flags);
  2164. typedef struct ssl_stream_reset_args_st {
  2165. uint64_t quic_error_code;
  2166. } SSL_STREAM_RESET_ARGS;
  2167. __owur int SSL_stream_reset(SSL *ssl,
  2168. const SSL_STREAM_RESET_ARGS *args,
  2169. size_t args_len);
  2170. #define SSL_STREAM_STATE_NONE 0
  2171. #define SSL_STREAM_STATE_OK 1
  2172. #define SSL_STREAM_STATE_WRONG_DIR 2
  2173. #define SSL_STREAM_STATE_FINISHED 3
  2174. #define SSL_STREAM_STATE_RESET_LOCAL 4
  2175. #define SSL_STREAM_STATE_RESET_REMOTE 5
  2176. #define SSL_STREAM_STATE_CONN_CLOSED 6
  2177. __owur int SSL_get_stream_read_state(SSL *ssl);
  2178. __owur int SSL_get_stream_write_state(SSL *ssl);
  2179. __owur int SSL_get_stream_read_error_code(SSL *ssl, uint64_t *app_error_code);
  2180. __owur int SSL_get_stream_write_error_code(SSL *ssl, uint64_t *app_error_code);
  2181. #define SSL_CONN_CLOSE_FLAG_LOCAL (1U << 0)
  2182. #define SSL_CONN_CLOSE_FLAG_TRANSPORT (1U << 1)
  2183. typedef struct ssl_conn_close_info_st {
  2184. uint64_t error_code, frame_type;
  2185. const char *reason;
  2186. size_t reason_len;
  2187. uint32_t flags;
  2188. } SSL_CONN_CLOSE_INFO;
  2189. __owur int SSL_get_conn_close_info(SSL *ssl,
  2190. SSL_CONN_CLOSE_INFO *info,
  2191. size_t info_len);
  2192. # define SSL_VALUE_CLASS_GENERIC 0
  2193. # define SSL_VALUE_CLASS_FEATURE_REQUEST 1
  2194. # define SSL_VALUE_CLASS_FEATURE_PEER_REQUEST 2
  2195. # define SSL_VALUE_CLASS_FEATURE_NEGOTIATED 3
  2196. # define SSL_VALUE_NONE 0
  2197. # define SSL_VALUE_QUIC_STREAM_BIDI_LOCAL_AVAIL 1
  2198. # define SSL_VALUE_QUIC_STREAM_BIDI_REMOTE_AVAIL 2
  2199. # define SSL_VALUE_QUIC_STREAM_UNI_LOCAL_AVAIL 3
  2200. # define SSL_VALUE_QUIC_STREAM_UNI_REMOTE_AVAIL 4
  2201. # define SSL_VALUE_QUIC_IDLE_TIMEOUT 5
  2202. # define SSL_VALUE_EVENT_HANDLING_MODE 6
  2203. # define SSL_VALUE_STREAM_WRITE_BUF_SIZE 7
  2204. # define SSL_VALUE_STREAM_WRITE_BUF_USED 8
  2205. # define SSL_VALUE_STREAM_WRITE_BUF_AVAIL 9
  2206. # define SSL_VALUE_EVENT_HANDLING_MODE_INHERIT 0
  2207. # define SSL_VALUE_EVENT_HANDLING_MODE_IMPLICIT 1
  2208. # define SSL_VALUE_EVENT_HANDLING_MODE_EXPLICIT 2
  2209. int SSL_get_value_uint(SSL *s, uint32_t class_, uint32_t id, uint64_t *v);
  2210. int SSL_set_value_uint(SSL *s, uint32_t class_, uint32_t id, uint64_t v);
  2211. # define SSL_get_generic_value_uint(ssl, id, v) \
  2212. SSL_get_value_uint((ssl), SSL_VALUE_CLASS_GENERIC, (id), (v))
  2213. # define SSL_set_generic_value_uint(ssl, id, v) \
  2214. SSL_set_value_uint((ssl), SSL_VALUE_CLASS_GENERIC, (id), (v))
  2215. # define SSL_get_feature_request_uint(ssl, id, v) \
  2216. SSL_get_value_uint((ssl), SSL_VALUE_CLASS_FEATURE_REQUEST, (id), (v))
  2217. # define SSL_set_feature_request_uint(ssl, id, v) \
  2218. SSL_set_value_uint((ssl), SSL_VALUE_CLASS_FEATURE_REQUEST, (id), (v))
  2219. # define SSL_get_feature_peer_request_uint(ssl, id, v) \
  2220. SSL_get_value_uint((ssl), SSL_VALUE_CLASS_FEATURE_PEER_REQUEST, (id), (v))
  2221. # define SSL_get_feature_negotiated_uint(ssl, id, v) \
  2222. SSL_get_value_uint((ssl), SSL_VALUE_CLASS_FEATURE_NEGOTIATED, (id), (v))
  2223. # define SSL_get_quic_stream_bidi_local_avail(ssl, value) \
  2224. SSL_get_generic_value_uint((ssl), SSL_VALUE_QUIC_STREAM_BIDI_LOCAL_AVAIL, \
  2225. (value))
  2226. # define SSL_get_quic_stream_bidi_remote_avail(ssl, value) \
  2227. SSL_get_generic_value_uint((ssl), SSL_VALUE_QUIC_STREAM_BIDI_REMOTE_AVAIL, \
  2228. (value))
  2229. # define SSL_get_quic_stream_uni_local_avail(ssl, value) \
  2230. SSL_get_generic_value_uint((ssl), SSL_VALUE_QUIC_STREAM_UNI_LOCAL_AVAIL, \
  2231. (value))
  2232. # define SSL_get_quic_stream_uni_remote_avail(ssl, value) \
  2233. SSL_get_generic_value_uint((ssl), SSL_VALUE_QUIC_STREAM_UNI_REMOTE_AVAIL, \
  2234. (value))
  2235. # define SSL_get_event_handling_mode(ssl, value) \
  2236. SSL_get_generic_value_uint((ssl), SSL_VALUE_EVENT_HANDLING_MODE, \
  2237. (value))
  2238. # define SSL_set_event_handling_mode(ssl, value) \
  2239. SSL_set_generic_value_uint((ssl), SSL_VALUE_EVENT_HANDLING_MODE, \
  2240. (value))
  2241. # define SSL_get_stream_write_buf_size(ssl, value) \
  2242. SSL_get_generic_value_uint((ssl), SSL_VALUE_STREAM_WRITE_BUF_SIZE, \
  2243. (value))
  2244. # define SSL_get_stream_write_buf_used(ssl, value) \
  2245. SSL_get_generic_value_uint((ssl), SSL_VALUE_STREAM_WRITE_BUF_USED, \
  2246. (value))
  2247. # define SSL_get_stream_write_buf_avail(ssl, value) \
  2248. SSL_get_generic_value_uint((ssl), SSL_VALUE_STREAM_WRITE_BUF_AVAIL, \
  2249. (value))
  2250. # define SSL_POLL_EVENT_NONE 0
  2251. # define SSL_POLL_EVENT_F (1U << 0) /* F (Failure) */
  2252. # define SSL_POLL_EVENT_EL (1U << 1) /* EL (Exception on Listener) */
  2253. # define SSL_POLL_EVENT_EC (1U << 2) /* EC (Exception on Conn) */
  2254. # define SSL_POLL_EVENT_ECD (1U << 3) /* ECD (Exception on Conn Drained) */
  2255. # define SSL_POLL_EVENT_ER (1U << 4) /* ER (Exception on Read) */
  2256. # define SSL_POLL_EVENT_EW (1U << 5) /* EW (Exception on Write) */
  2257. # define SSL_POLL_EVENT_R (1U << 6) /* R (Readable) */
  2258. # define SSL_POLL_EVENT_W (1U << 7) /* W (Writable) */
  2259. # define SSL_POLL_EVENT_IC (1U << 8) /* IC (Incoming Connection) */
  2260. # define SSL_POLL_EVENT_ISB (1U << 9) /* ISB (Incoming Stream: Bidi) */
  2261. # define SSL_POLL_EVENT_ISU (1U << 10) /* ISU (Incoming Stream: Uni) */
  2262. # define SSL_POLL_EVENT_OSB (1U << 11) /* OSB (Outgoing Stream: Bidi) */
  2263. # define SSL_POLL_EVENT_OSU (1U << 12) /* OSU (Outgoing Stream: Uni) */
  2264. # define SSL_POLL_EVENT_RW (SSL_POLL_EVENT_R | SSL_POLL_EVENT_W)
  2265. # define SSL_POLL_EVENT_RE (SSL_POLL_EVENT_R | SSL_POLL_EVENT_ER)
  2266. # define SSL_POLL_EVENT_WE (SSL_POLL_EVENT_W | SSL_POLL_EVENT_EW)
  2267. # define SSL_POLL_EVENT_RWE (SSL_POLL_EVENT_RE | SSL_POLL_EVENT_WE)
  2268. # define SSL_POLL_EVENT_E (SSL_POLL_EVENT_EL | SSL_POLL_EVENT_EC \
  2269. | SSL_POLL_EVENT_ER | SSL_POLL_EVENT_EW)
  2270. # define SSL_POLL_EVENT_IS (SSL_POLL_EVENT_ISB | SSL_POLL_EVENT_ISU)
  2271. # define SSL_POLL_EVENT_ISE (SSL_POLL_EVENT_IS | SSL_POLL_EVENT_EC)
  2272. # define SSL_POLL_EVENT_I (SSL_POLL_EVENT_IS | SSL_POLL_EVENT_IC)
  2273. # define SSL_POLL_EVENT_OS (SSL_POLL_EVENT_OSB | SSL_POLL_EVENT_OSU)
  2274. # define SSL_POLL_EVENT_OSE (SSL_POLL_EVENT_OS | SSL_POLL_EVENT_EC)
  2275. typedef struct ssl_poll_item_st {
  2276. BIO_POLL_DESCRIPTOR desc;
  2277. uint64_t events, revents;
  2278. } SSL_POLL_ITEM;
  2279. # define SSL_POLL_FLAG_NO_HANDLE_EVENTS (1U << 0)
  2280. __owur int SSL_poll(SSL_POLL_ITEM *items,
  2281. size_t num_items,
  2282. size_t stride,
  2283. const struct timeval *timeout,
  2284. uint64_t flags,
  2285. size_t *result_count);
  2286. static ossl_inline ossl_unused BIO_POLL_DESCRIPTOR
  2287. SSL_as_poll_descriptor(SSL *s)
  2288. {
  2289. BIO_POLL_DESCRIPTOR d;
  2290. d.type = BIO_POLL_DESCRIPTOR_TYPE_SSL;
  2291. d.value.ssl = s;
  2292. return d;
  2293. }
  2294. # ifndef OPENSSL_NO_DEPRECATED_1_1_0
  2295. # define SSL_cache_hit(s) SSL_session_reused(s)
  2296. # endif
  2297. __owur int SSL_session_reused(const SSL *s);
  2298. __owur int SSL_is_server(const SSL *s);
  2299. __owur __owur SSL_CONF_CTX *SSL_CONF_CTX_new(void);
  2300. int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx);
  2301. void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx);
  2302. unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags);
  2303. __owur unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx,
  2304. unsigned int flags);
  2305. __owur int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre);
  2306. void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl);
  2307. void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx);
  2308. __owur int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value);
  2309. __owur int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv);
  2310. __owur int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd);
  2311. void SSL_add_ssl_module(void);
  2312. int SSL_config(SSL *s, const char *name);
  2313. int SSL_CTX_config(SSL_CTX *ctx, const char *name);
  2314. # ifndef OPENSSL_NO_SSL_TRACE
  2315. void SSL_trace(int write_p, int version, int content_type,
  2316. const void *buf, size_t len, SSL *ssl, void *arg);
  2317. # endif
  2318. # ifndef OPENSSL_NO_SOCK
  2319. int DTLSv1_listen(SSL *s, BIO_ADDR *client);
  2320. # endif
  2321. # ifndef OPENSSL_NO_CT
  2322. /*
  2323. * A callback for verifying that the received SCTs are sufficient.
  2324. * Expected to return 1 if they are sufficient, otherwise 0.
  2325. * May return a negative integer if an error occurs.
  2326. * A connection should be aborted if the SCTs are deemed insufficient.
  2327. */
  2328. typedef int (*ssl_ct_validation_cb)(const CT_POLICY_EVAL_CTX *ctx,
  2329. const STACK_OF(SCT) *scts, void *arg);
  2330. /*
  2331. * Sets a |callback| that is invoked upon receipt of ServerHelloDone to validate
  2332. * the received SCTs.
  2333. * If the callback returns a non-positive result, the connection is terminated.
  2334. * Call this function before beginning a handshake.
  2335. * If a NULL |callback| is provided, SCT validation is disabled.
  2336. * |arg| is arbitrary userdata that will be passed to the callback whenever it
  2337. * is invoked. Ownership of |arg| remains with the caller.
  2338. *
  2339. * NOTE: A side-effect of setting a CT callback is that an OCSP stapled response
  2340. * will be requested.
  2341. */
  2342. int SSL_set_ct_validation_callback(SSL *s, ssl_ct_validation_cb callback,
  2343. void *arg);
  2344. int SSL_CTX_set_ct_validation_callback(SSL_CTX *ctx,
  2345. ssl_ct_validation_cb callback,
  2346. void *arg);
  2347. #define SSL_disable_ct(s) \
  2348. ((void) SSL_set_validation_callback((s), NULL, NULL))
  2349. #define SSL_CTX_disable_ct(ctx) \
  2350. ((void) SSL_CTX_set_validation_callback((ctx), NULL, NULL))
  2351. /*
  2352. * The validation type enumerates the available behaviours of the built-in SSL
  2353. * CT validation callback selected via SSL_enable_ct() and SSL_CTX_enable_ct().
  2354. * The underlying callback is a static function in libssl.
  2355. */
  2356. enum {
  2357. SSL_CT_VALIDATION_PERMISSIVE = 0,
  2358. SSL_CT_VALIDATION_STRICT
  2359. };
  2360. /*
  2361. * Enable CT by setting up a callback that implements one of the built-in
  2362. * validation variants. The SSL_CT_VALIDATION_PERMISSIVE variant always
  2363. * continues the handshake, the application can make appropriate decisions at
  2364. * handshake completion. The SSL_CT_VALIDATION_STRICT variant requires at
  2365. * least one valid SCT, or else handshake termination will be requested. The
  2366. * handshake may continue anyway if SSL_VERIFY_NONE is in effect.
  2367. */
  2368. int SSL_enable_ct(SSL *s, int validation_mode);
  2369. int SSL_CTX_enable_ct(SSL_CTX *ctx, int validation_mode);
  2370. /*
  2371. * Report whether a non-NULL callback is enabled.
  2372. */
  2373. int SSL_ct_is_enabled(const SSL *s);
  2374. int SSL_CTX_ct_is_enabled(const SSL_CTX *ctx);
  2375. /* Gets the SCTs received from a connection */
  2376. const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s);
  2377. /*
  2378. * Loads the CT log list from the default location.
  2379. * If a CTLOG_STORE has previously been set using SSL_CTX_set_ctlog_store,
  2380. * the log information loaded from this file will be appended to the
  2381. * CTLOG_STORE.
  2382. * Returns 1 on success, 0 otherwise.
  2383. */
  2384. int SSL_CTX_set_default_ctlog_list_file(SSL_CTX *ctx);
  2385. /*
  2386. * Loads the CT log list from the specified file path.
  2387. * If a CTLOG_STORE has previously been set using SSL_CTX_set_ctlog_store,
  2388. * the log information loaded from this file will be appended to the
  2389. * CTLOG_STORE.
  2390. * Returns 1 on success, 0 otherwise.
  2391. */
  2392. int SSL_CTX_set_ctlog_list_file(SSL_CTX *ctx, const char *path);
  2393. /*
  2394. * Sets the CT log list used by all SSL connections created from this SSL_CTX.
  2395. * Ownership of the CTLOG_STORE is transferred to the SSL_CTX.
  2396. */
  2397. void SSL_CTX_set0_ctlog_store(SSL_CTX *ctx, CTLOG_STORE *logs);
  2398. /*
  2399. * Gets the CT log list used by all SSL connections created from this SSL_CTX.
  2400. * This will be NULL unless one of the following functions has been called:
  2401. * - SSL_CTX_set_default_ctlog_list_file
  2402. * - SSL_CTX_set_ctlog_list_file
  2403. * - SSL_CTX_set_ctlog_store
  2404. */
  2405. const CTLOG_STORE *SSL_CTX_get0_ctlog_store(const SSL_CTX *ctx);
  2406. # endif /* OPENSSL_NO_CT */
  2407. /* What the "other" parameter contains in security callback */
  2408. /* Mask for type */
  2409. # define SSL_SECOP_OTHER_TYPE 0xffff0000
  2410. # define SSL_SECOP_OTHER_NONE 0
  2411. # define SSL_SECOP_OTHER_CIPHER (1 << 16)
  2412. # define SSL_SECOP_OTHER_CURVE (2 << 16)
  2413. # define SSL_SECOP_OTHER_DH (3 << 16)
  2414. # define SSL_SECOP_OTHER_PKEY (4 << 16)
  2415. # define SSL_SECOP_OTHER_SIGALG (5 << 16)
  2416. # define SSL_SECOP_OTHER_CERT (6 << 16)
  2417. /* Indicated operation refers to peer key or certificate */
  2418. # define SSL_SECOP_PEER 0x1000
  2419. /* Values for "op" parameter in security callback */
  2420. /* Called to filter ciphers */
  2421. /* Ciphers client supports */
  2422. # define SSL_SECOP_CIPHER_SUPPORTED (1 | SSL_SECOP_OTHER_CIPHER)
  2423. /* Cipher shared by client/server */
  2424. # define SSL_SECOP_CIPHER_SHARED (2 | SSL_SECOP_OTHER_CIPHER)
  2425. /* Sanity check of cipher server selects */
  2426. # define SSL_SECOP_CIPHER_CHECK (3 | SSL_SECOP_OTHER_CIPHER)
  2427. /* Curves supported by client */
  2428. # define SSL_SECOP_CURVE_SUPPORTED (4 | SSL_SECOP_OTHER_CURVE)
  2429. /* Curves shared by client/server */
  2430. # define SSL_SECOP_CURVE_SHARED (5 | SSL_SECOP_OTHER_CURVE)
  2431. /* Sanity check of curve server selects */
  2432. # define SSL_SECOP_CURVE_CHECK (6 | SSL_SECOP_OTHER_CURVE)
  2433. /* Temporary DH key */
  2434. # define SSL_SECOP_TMP_DH (7 | SSL_SECOP_OTHER_PKEY)
  2435. /* SSL/TLS version */
  2436. # define SSL_SECOP_VERSION (9 | SSL_SECOP_OTHER_NONE)
  2437. /* Session tickets */
  2438. # define SSL_SECOP_TICKET (10 | SSL_SECOP_OTHER_NONE)
  2439. /* Supported signature algorithms sent to peer */
  2440. # define SSL_SECOP_SIGALG_SUPPORTED (11 | SSL_SECOP_OTHER_SIGALG)
  2441. /* Shared signature algorithm */
  2442. # define SSL_SECOP_SIGALG_SHARED (12 | SSL_SECOP_OTHER_SIGALG)
  2443. /* Sanity check signature algorithm allowed */
  2444. # define SSL_SECOP_SIGALG_CHECK (13 | SSL_SECOP_OTHER_SIGALG)
  2445. /* Used to get mask of supported public key signature algorithms */
  2446. # define SSL_SECOP_SIGALG_MASK (14 | SSL_SECOP_OTHER_SIGALG)
  2447. /* Use to see if compression is allowed */
  2448. # define SSL_SECOP_COMPRESSION (15 | SSL_SECOP_OTHER_NONE)
  2449. /* EE key in certificate */
  2450. # define SSL_SECOP_EE_KEY (16 | SSL_SECOP_OTHER_CERT)
  2451. /* CA key in certificate */
  2452. # define SSL_SECOP_CA_KEY (17 | SSL_SECOP_OTHER_CERT)
  2453. /* CA digest algorithm in certificate */
  2454. # define SSL_SECOP_CA_MD (18 | SSL_SECOP_OTHER_CERT)
  2455. /* Peer EE key in certificate */
  2456. # define SSL_SECOP_PEER_EE_KEY (SSL_SECOP_EE_KEY | SSL_SECOP_PEER)
  2457. /* Peer CA key in certificate */
  2458. # define SSL_SECOP_PEER_CA_KEY (SSL_SECOP_CA_KEY | SSL_SECOP_PEER)
  2459. /* Peer CA digest algorithm in certificate */
  2460. # define SSL_SECOP_PEER_CA_MD (SSL_SECOP_CA_MD | SSL_SECOP_PEER)
  2461. void SSL_set_security_level(SSL *s, int level);
  2462. __owur int SSL_get_security_level(const SSL *s);
  2463. void SSL_set_security_callback(SSL *s,
  2464. int (*cb) (const SSL *s, const SSL_CTX *ctx,
  2465. int op, int bits, int nid,
  2466. void *other, void *ex));
  2467. int (*SSL_get_security_callback(const SSL *s)) (const SSL *s,
  2468. const SSL_CTX *ctx, int op,
  2469. int bits, int nid, void *other,
  2470. void *ex);
  2471. void SSL_set0_security_ex_data(SSL *s, void *ex);
  2472. __owur void *SSL_get0_security_ex_data(const SSL *s);
  2473. void SSL_CTX_set_security_level(SSL_CTX *ctx, int level);
  2474. __owur int SSL_CTX_get_security_level(const SSL_CTX *ctx);
  2475. void SSL_CTX_set_security_callback(SSL_CTX *ctx,
  2476. int (*cb) (const SSL *s, const SSL_CTX *ctx,
  2477. int op, int bits, int nid,
  2478. void *other, void *ex));
  2479. int (*SSL_CTX_get_security_callback(const SSL_CTX *ctx)) (const SSL *s,
  2480. const SSL_CTX *ctx,
  2481. int op, int bits,
  2482. int nid,
  2483. void *other,
  2484. void *ex);
  2485. void SSL_CTX_set0_security_ex_data(SSL_CTX *ctx, void *ex);
  2486. __owur void *SSL_CTX_get0_security_ex_data(const SSL_CTX *ctx);
  2487. /* OPENSSL_INIT flag 0x010000 reserved for internal use */
  2488. # define OPENSSL_INIT_NO_LOAD_SSL_STRINGS 0x00100000L
  2489. # define OPENSSL_INIT_LOAD_SSL_STRINGS 0x00200000L
  2490. # define OPENSSL_INIT_SSL_DEFAULT \
  2491. (OPENSSL_INIT_LOAD_SSL_STRINGS | OPENSSL_INIT_LOAD_CRYPTO_STRINGS)
  2492. int OPENSSL_init_ssl(uint64_t opts, const OPENSSL_INIT_SETTINGS *settings);
  2493. # ifndef OPENSSL_NO_UNIT_TEST
  2494. __owur const struct openssl_ssl_test_functions *SSL_test_functions(void);
  2495. # endif
  2496. __owur int SSL_free_buffers(SSL *ssl);
  2497. __owur int SSL_alloc_buffers(SSL *ssl);
  2498. /* Status codes passed to the decrypt session ticket callback. Some of these
  2499. * are for internal use only and are never passed to the callback. */
  2500. typedef int SSL_TICKET_STATUS;
  2501. /* Support for ticket appdata */
  2502. /* fatal error, malloc failure */
  2503. # define SSL_TICKET_FATAL_ERR_MALLOC 0
  2504. /* fatal error, either from parsing or decrypting the ticket */
  2505. # define SSL_TICKET_FATAL_ERR_OTHER 1
  2506. /* No ticket present */
  2507. # define SSL_TICKET_NONE 2
  2508. /* Empty ticket present */
  2509. # define SSL_TICKET_EMPTY 3
  2510. /* the ticket couldn't be decrypted */
  2511. # define SSL_TICKET_NO_DECRYPT 4
  2512. /* a ticket was successfully decrypted */
  2513. # define SSL_TICKET_SUCCESS 5
  2514. /* same as above but the ticket needs to be renewed */
  2515. # define SSL_TICKET_SUCCESS_RENEW 6
  2516. /* Return codes for the decrypt session ticket callback */
  2517. typedef int SSL_TICKET_RETURN;
  2518. /* An error occurred */
  2519. #define SSL_TICKET_RETURN_ABORT 0
  2520. /* Do not use the ticket, do not send a renewed ticket to the client */
  2521. #define SSL_TICKET_RETURN_IGNORE 1
  2522. /* Do not use the ticket, send a renewed ticket to the client */
  2523. #define SSL_TICKET_RETURN_IGNORE_RENEW 2
  2524. /* Use the ticket, do not send a renewed ticket to the client */
  2525. #define SSL_TICKET_RETURN_USE 3
  2526. /* Use the ticket, send a renewed ticket to the client */
  2527. #define SSL_TICKET_RETURN_USE_RENEW 4
  2528. typedef int (*SSL_CTX_generate_session_ticket_fn)(SSL *s, void *arg);
  2529. typedef SSL_TICKET_RETURN (*SSL_CTX_decrypt_session_ticket_fn)(SSL *s, SSL_SESSION *ss,
  2530. const unsigned char *keyname,
  2531. size_t keyname_length,
  2532. SSL_TICKET_STATUS status,
  2533. void *arg);
  2534. int SSL_CTX_set_session_ticket_cb(SSL_CTX *ctx,
  2535. SSL_CTX_generate_session_ticket_fn gen_cb,
  2536. SSL_CTX_decrypt_session_ticket_fn dec_cb,
  2537. void *arg);
  2538. int SSL_SESSION_set1_ticket_appdata(SSL_SESSION *ss, const void *data, size_t len);
  2539. int SSL_SESSION_get0_ticket_appdata(SSL_SESSION *ss, void **data, size_t *len);
  2540. typedef unsigned int (*DTLS_timer_cb)(SSL *s, unsigned int timer_us);
  2541. void DTLS_set_timer_cb(SSL *s, DTLS_timer_cb cb);
  2542. typedef int (*SSL_allow_early_data_cb_fn)(SSL *s, void *arg);
  2543. void SSL_CTX_set_allow_early_data_cb(SSL_CTX *ctx,
  2544. SSL_allow_early_data_cb_fn cb,
  2545. void *arg);
  2546. void SSL_set_allow_early_data_cb(SSL *s,
  2547. SSL_allow_early_data_cb_fn cb,
  2548. void *arg);
  2549. /* store the default cipher strings inside the library */
  2550. const char *OSSL_default_cipher_list(void);
  2551. const char *OSSL_default_ciphersuites(void);
  2552. /* RFC8879 Certificate compression APIs */
  2553. int SSL_CTX_compress_certs(SSL_CTX *ctx, int alg);
  2554. int SSL_compress_certs(SSL *ssl, int alg);
  2555. int SSL_CTX_set1_cert_comp_preference(SSL_CTX *ctx, int *algs, size_t len);
  2556. int SSL_set1_cert_comp_preference(SSL *ssl, int *algs, size_t len);
  2557. int SSL_CTX_set1_compressed_cert(SSL_CTX *ctx, int algorithm, unsigned char *comp_data,
  2558. size_t comp_length, size_t orig_length);
  2559. int SSL_set1_compressed_cert(SSL *ssl, int algorithm, unsigned char *comp_data,
  2560. size_t comp_length, size_t orig_length);
  2561. size_t SSL_CTX_get1_compressed_cert(SSL_CTX *ctx, int alg, unsigned char **data, size_t *orig_len);
  2562. size_t SSL_get1_compressed_cert(SSL *ssl, int alg, unsigned char **data, size_t *orig_len);
  2563. __owur int SSL_add_expected_rpk(SSL *s, EVP_PKEY *rpk);
  2564. __owur EVP_PKEY *SSL_get0_peer_rpk(const SSL *s);
  2565. __owur EVP_PKEY *SSL_SESSION_get0_peer_rpk(SSL_SESSION *s);
  2566. __owur int SSL_get_negotiated_client_cert_type(const SSL *s);
  2567. __owur int SSL_get_negotiated_server_cert_type(const SSL *s);
  2568. __owur int SSL_set1_client_cert_type(SSL *s, const unsigned char *val, size_t len);
  2569. __owur int SSL_set1_server_cert_type(SSL *s, const unsigned char *val, size_t len);
  2570. __owur int SSL_CTX_set1_client_cert_type(SSL_CTX *ctx, const unsigned char *val, size_t len);
  2571. __owur int SSL_CTX_set1_server_cert_type(SSL_CTX *ctx, const unsigned char *val, size_t len);
  2572. __owur int SSL_get0_client_cert_type(const SSL *s, unsigned char **t, size_t *len);
  2573. __owur int SSL_get0_server_cert_type(const SSL *s, unsigned char **t, size_t *len);
  2574. __owur int SSL_CTX_get0_client_cert_type(const SSL_CTX *ctx, unsigned char **t, size_t *len);
  2575. __owur int SSL_CTX_get0_server_cert_type(const SSL_CTX *s, unsigned char **t, size_t *len);
  2576. # ifdef __cplusplus
  2577. }
  2578. # endif
  2579. #endif