ssl.h 120 KB

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