0000: 3c 21 64 6f 63 74 79 70 65 20 68 74 6d 6c 20 70 <!doctype html p
0010: 75 62 6c 69 63 20 22 2d 2f 2f 57 33 43 2f 2f 44 ublic "-//W3C//D
0020: 54 44 20 48 54 4d 4c 20 34 2e 30 20 54 72 61 6e TD HTML 4.0 Tran
0030: 73 69 74 69 6f 6e 61 6c 2f 2f 45 4e 22 3e 0a 0a sitional//EN">..
0040: 3c 68 74 6d 6c 3e 0a 0a 3c 68 65 61 64 3e 0a 3c <html>..<head>.<
0050: 6d 65 74 61 20 68 74 74 70 2d 65 71 75 69 76 3d meta http-equiv=
0060: 22 43 6f 6e 74 65 6e 74 2d 54 79 70 65 22 0a 63 "Content-Type".c
0070: 6f 6e 74 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d ontent="text/htm
0080: 6c 3b 20 63 68 61 72 73 65 74 3d 69 73 6f 2d 38 l; charset=iso-8
0090: 38 35 39 2d 31 22 3e 0a 3c 6d 65 74 61 20 6e 61 859-1">.<meta na
00a0: 6d 65 3d 22 43 6f 70 79 72 69 67 68 74 22 20 63 me="Copyright" c
00b0: 6f 6e 74 65 6e 74 3d 22 31 39 39 39 20 4d 61 74 ontent="1999 Mat
00c0: 74 20 4e 65 77 6d 61 6e 20 2f 20 32 30 30 34 20 t Newman / 2004
00d0: 53 74 61 72 66 69 73 68 20 53 79 73 74 65 6d 73 Starfish Systems
00e0: 22 3e 0a 3c 74 69 74 6c 65 3e 54 4c 53 20 28 53 ">.<title>TLS (S
00f0: 53 4c 29 20 54 63 6c 20 43 6f 6d 6d 61 6e 64 73 SL) Tcl Commands
0100: 3c 2f 74 69 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e </title>.</head>
0110: 0a 0a 3c 62 6f 64 79 20 62 67 63 6f 6c 6f 72 3d ..<body bgcolor=
0120: 22 23 46 46 46 46 46 46 22 3e 0a 0a 3c 64 6c 3e "#FFFFFF">..<dl>
0130: 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 65 66 . <dd><a href
0140: 3d 22 23 4e 41 4d 45 22 3e 4e 41 4d 45 3c 2f 61 ="#NAME">NAME</a
0150: 3e 0a 20 20 20 20 3c 64 6c 3e 0a 09 3c 64 64 3e >. <dl>..<dd>
0160: 3c 62 3e 74 6c 73 3c 2f 62 3e 20 2d 20 62 69 6e <b>tls</b> - bin
0170: 64 69 6e 67 20 74 6f 20 3c 62 3e 4f 70 65 6e 53 ding to <b>OpenS
0180: 53 4c 3c 2f 62 3e 20 74 6f 6f 6c 6b 69 74 2e 3c SL</b> toolkit.<
0190: 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a 20 /dd>. </dl>.
01a0: 20 20 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 </dd>. <dd
01b0: 3e 3c 61 20 68 72 65 66 3d 22 23 53 59 4e 4f 50 ><a href="#SYNOP
01c0: 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 3c 2f 61 SIS">SYNOPSIS</a
01d0: 3e 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e > </dd>. <dd>
01e0: 3c 64 6c 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 <dl>.. <dd><b
01f0: 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 >package require
0200: 20 54 63 6c 3c 2f 62 3e 20 3c 65 6d 3e 3f 38 2e Tcl</b> <em>?8.
0210: 34 3f 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 4?</em></dd>..
0220: 20 20 3c 64 64 3e 3c 62 3e 70 61 63 6b 61 67 65 <dd><b>package
0230: 20 72 65 71 75 69 72 65 20 74 6c 73 3c 2f 62 3e require tls</b>
0240: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 74 3e 26 </dd>.. <dt>&
0250: 6e 62 73 70 3b 3c 2f 64 74 3e 0a 09 20 20 20 20 nbsp;</dt>..
0260: 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 69 6e 69 74 <dd><b>tls::init
0270: 3c 2f 62 3e 20 3c 65 6d 3e 3f 6f 70 74 69 6f 6e </b> <em>?option
0280: 73 3f 3c 2f 65 6d 3e 20 3c 2f 64 64 3e 0a 09 20 s?</em> </dd>..
0290: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 <dd><b>tls::s
02a0: 6f 63 6b 65 74 3c 2f 62 3e 20 3c 65 6d 3e 3f 6f ocket</b> <em>?o
02b0: 70 74 69 6f 6e 73 3f 20 68 6f 73 74 20 70 6f 72 ptions? host por
02c0: 74 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 t</em></dd>..
02d0: 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 6f 63 <dd><b>tls::soc
02e0: 6b 65 74 3c 2f 62 3e 20 3c 65 6d 3e 20 3f 2d 73 ket</b> <em> ?-s
02f0: 65 72 76 65 72 20 63 6f 6d 6d 61 6e 64 3f 20 3f erver command? ?
0300: 6f 70 74 69 6f 6e 73 3f 20 70 6f 72 74 3c 2f 65 options? port</e
0310: 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 m></dd>.. <dd
0320: 3e 3c 62 3e 74 6c 73 3a 3a 68 61 6e 64 73 68 61 ><b>tls::handsha
0330: 6b 65 3c 2f 62 3e 20 3c 65 6d 3e 20 63 68 61 6e ke</b> <em> chan
0340: 6e 65 6c 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 nel</em></dd>..
0350: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 <dd><b>tls::s
0360: 74 61 74 75 73 20 3c 2f 62 3e 20 3c 65 6d 3e 3f tatus </b> <em>?
0370: 2d 6c 6f 63 61 6c 3f 20 63 68 61 6e 6e 65 6c 3c -local? channel<
0380: 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c /em></dd>.. <
0390: 64 64 3e 3c 62 3e 74 6c 73 3a 3a 63 6f 6e 6e 65 dd><b>tls::conne
03a0: 63 74 69 6f 6e 20 3c 2f 62 3e 20 3c 65 6d 3e 63 ction </b> <em>c
03b0: 68 61 6e 6e 65 6c 3c 2f 65 6d 3e 3c 2f 64 64 3e hannel</em></dd>
03c0: 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 .. <dd><b>tls
03d0: 3a 3a 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c 65 6d ::import</b> <em
03e0: 3e 63 68 61 6e 6e 65 6c 20 3f 6f 70 74 69 6f 6e >channel ?option
03f0: 73 3f 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 s?</em></dd>..
0400: 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 75 6e <dd><b>tls::un
0410: 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c 65 6d 3e 63 import</b> <em>c
0420: 68 61 6e 6e 65 6c 3c 2f 65 6d 3e 3c 2f 64 64 3e hannel</em></dd>
0430: 0a 09 20 20 20 20 3c 64 74 3e 26 6e 62 73 70 3b .. <dt>
0440: 3c 2f 64 74 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dt>.. <dd><
0450: 62 3e 74 6c 73 3a 3a 63 69 70 68 65 72 73 20 3c b>tls::ciphers <
0460: 2f 62 3e 20 3c 65 6d 3e 70 72 6f 74 6f 63 6f 6c /b> <em>protocol
0470: 20 3f 76 65 72 62 6f 73 65 3f 20 3f 73 75 70 70 ?verbose? ?supp
0480: 6f 72 74 65 64 3f 3c 2f 65 6d 3e 3c 2f 64 64 3e orted?</em></dd>
0490: 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 .. <dd><b>tls
04a0: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c ::protocols</b><
04b0: 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 /dd>.. <dd><b
04c0: 3e 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 62 >tls::version</b
04d0: 3e 3c 2f 64 64 3e 0a 09 3c 2f 64 6c 3e 0a 20 20 ></dd>..</dl>.
04e0: 20 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e </dd>. <dd>
04f0: 3c 61 20 68 72 65 66 3d 22 23 43 4f 4d 4d 41 4e <a href="#COMMAN
0500: 44 53 22 3e 43 4f 4d 4d 41 4e 44 53 3c 2f 61 3e DS">COMMANDS</a>
0510: 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 </dd>. <dd><a
0520: 20 68 72 65 66 3d 22 23 43 41 4c 4c 42 41 43 4b href="#CALLBACK
0530: 20 4f 50 54 49 4f 4e 53 22 3e 43 41 4c 4c 42 41 OPTIONS">CALLBA
0540: 43 4b 20 4f 50 54 49 4f 4e 53 3c 2f 61 3e 3c 2f CK OPTIONS</a></
0550: 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 dd>. <dd><a h
0560: 72 65 66 3d 22 23 48 54 54 50 53 20 45 58 41 4d ref="#HTTPS EXAM
0570: 50 4c 45 22 3e 48 54 54 50 53 20 45 58 41 4d 50 PLE">HTTPS EXAMP
0580: 4c 45 3c 2f 61 3e 3c 2f 64 64 3e 0a 20 20 20 20 LE</a></dd>.
0590: 3c 64 64 3e 3c 61 20 68 72 65 66 3d 22 23 53 45 <dd><a href="#SE
05a0: 45 20 41 4c 53 4f 22 3e 53 50 45 43 49 41 4c 20 E ALSO">SPECIAL
05b0: 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e 53 3c 2f CONSIDERATIONS</
05c0: 61 3e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e a></dd>. <dd>
05d0: 3c 61 20 68 72 65 66 3d 22 23 53 45 45 20 41 4c <a href="#SEE AL
05e0: 53 4f 22 3e 53 45 45 20 41 4c 53 4f 3c 2f 61 3e SO">SEE ALSO</a>
05f0: 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 68 72 </dd>.</dl>..<hr
0600: 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 >..<h3><a name="
0610: 4e 41 4d 45 22 3e 4e 41 4d 45 3c 2f 61 3e 3c 2f NAME">NAME</a></
0620: 68 33 3e 0a 0a 3c 70 3e 3c 73 74 72 6f 6e 67 3e h3>..<p><strong>
0630: 74 6c 73 3c 2f 73 74 72 6f 6e 67 3e 20 2d 20 62 tls</strong> - b
0640: 69 6e 64 69 6e 67 20 74 6f 20 3c 73 74 72 6f 6e inding to <stron
0650: 67 3e 4f 70 65 6e 53 53 4c 3c 2f 73 74 72 6f 6e g>OpenSSL</stron
0660: 67 3e 0a 74 6f 6f 6c 6b 69 74 2e 3c 2f 70 3e 0a g>.toolkit.</p>.
0670: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 59 .<h3><a name="SY
0680: 4e 4f 50 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 NOPSIS">SYNOPSIS
0690: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 62 </a></h3>..<p><b
06a0: 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 >package require
06b0: 20 54 63 6c 20 38 2e 34 3c 2f 62 3e 3c 62 72 3e Tcl 8.4</b><br>
06c0: 0a 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 .<b>package requ
06d0: 69 72 65 20 74 6c 73 3c 2f 62 3e 3c 62 72 3e 0a ire tls</b><br>.
06e0: 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 <br>.<a href="#t
06f0: 6c 73 3a 3a 69 6e 69 74 22 3e 3c 62 3e 74 6c 73 ls::init"><b>tls
0700: 3a 3a 69 6e 69 74 3c 2f 62 3e 20 3c 69 3e 3f 6f ::init</b> <i>?o
0710: 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c ptions?</i></a><
0720: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0730: 73 3a 3a 73 6f 63 6b 65 74 22 3e 3c 62 3e 74 6c s::socket"><b>tl
0740: 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 3c 69 s::socket</b> <i
0750: 3e 3f 6f 70 74 69 6f 6e 73 3f 20 68 6f 73 74 20 >?options? host
0760: 70 6f 72 74 3c 2f 69 3e 3c 62 72 3e 0a 3c 61 20 port</i><br>.<a
0770: 68 72 65 66 3d 22 23 74 6c 73 3a 3a 73 6f 63 6b href="#tls::sock
0780: 65 74 22 3e 3c 62 3e 74 6c 73 3a 3a 73 6f 63 6b et"><b>tls::sock
0790: 65 74 3c 2f 62 3e 20 3c 69 3e 3f 2d 73 65 72 76 et</b> <i>?-serv
07a0: 65 72 20 63 6f 6d 6d 61 6e 64 3f 20 3f 6f 70 74 er command? ?opt
07b0: 69 6f 6e 73 3f 20 70 6f 72 74 3c 2f 69 3e 3c 2f ions? port</i></
07c0: 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 a><br>.<a href="
07d0: 23 74 6c 73 3a 3a 73 74 61 74 75 73 22 3e 3c 62 #tls::status"><b
07e0: 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 62 3e >tls::status</b>
07f0: 20 3c 69 3e 3f 2d 6c 6f 63 61 6c 3f 20 63 68 61 <i>?-local? cha
0800: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
0810: 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a .<a href="#tls::
0820: 63 6f 6e 6e 65 63 74 69 6f 6e 22 3e 3c 62 3e 74 connection"><b>t
0830: 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f ls::connection</
0840: 62 3e 20 3c 69 3e 63 68 61 6e 6e 65 6c 3c 2f 69 b> <i>channel</i
0850: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0860: 66 3d 22 23 74 6c 73 3a 3a 68 61 6e 64 73 68 61 f="#tls::handsha
0870: 6b 65 22 3e 3c 62 3e 74 6c 73 3a 3a 68 61 6e 64 ke"><b>tls::hand
0880: 73 68 61 6b 65 3c 2f 62 3e 20 3c 69 3e 63 68 61 shake</b> <i>cha
0890: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
08a0: 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a .<a href="#tls::
08b0: 69 6d 70 6f 72 74 22 3e 3c 62 3e 74 6c 73 3a 3a import"><b>tls::
08c0: 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c 69 3e 63 68 import</b> <i>ch
08d0: 61 6e 6e 65 6c 20 3f 6f 70 74 69 6f 6e 73 3f 3c annel ?options?<
08e0: 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 /i></a><br>.<a h
08f0: 72 65 66 3d 22 23 74 6c 73 3a 3a 75 6e 69 6d 70 ref="#tls::unimp
0900: 6f 72 74 22 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 69 ort"><b>tls::uni
0910: 6d 70 6f 72 74 3c 2f 62 3e 20 3c 69 3e 63 68 61 mport</b> <i>cha
0920: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
0930: 0a 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 .<br>.<a href="#
0940: 74 6c 73 3a 3a 63 69 70 68 65 72 73 22 3e 3c 62 tls::ciphers"><b
0950: 3e 74 6c 73 3a 3a 63 69 70 68 65 72 73 3c 2f 62 >tls::ciphers</b
0960: 3e 20 3c 69 3e 70 72 6f 74 6f 63 6f 6c 20 3f 76 > <i>protocol ?v
0970: 65 72 62 6f 73 65 3f 20 3f 73 75 70 70 6f 72 74 erbose? ?support
0980: 65 64 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a ed?</i></a><br>.
0990: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 70 <a href="#tls::p
09a0: 72 6f 74 6f 63 6f 6c 73 22 3e 3c 62 3e 74 6c 73 rotocols"><b>tls
09b0: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c ::protocols</b><
09c0: 2f 61 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c /a>.<a href="#tl
09d0: 73 3a 3a 76 65 72 73 69 6f 6e 22 3e 3c 62 3e 74 s::version"><b>t
09e0: 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 62 3e 3c ls::version</b><
09f0: 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 /a>.</p>..<h3><a
0a00: 20 6e 61 6d 65 3d 22 44 45 53 43 52 49 50 54 49 name="DESCRIPTI
0a10: 4f 4e 22 3e 44 45 53 43 52 49 50 54 49 4f 4e 3c ON">DESCRIPTION<
0a20: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 69 /a></h3>..<p>Thi
0a30: 73 20 65 78 74 65 6e 73 69 6f 6e 20 70 72 6f 76 s extension prov
0a40: 69 64 65 73 20 61 20 67 65 6e 65 72 69 63 20 62 ides a generic b
0a50: 69 6e 64 69 6e 67 20 74 6f 20 3c 61 0a 68 72 65 inding to <a.hre
0a60: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 70 f="http://www.op
0a70: 65 6e 73 73 6c 2e 6f 72 67 2f 22 3e 4f 70 65 6e enssl.org/">Open
0a80: 53 53 4c 3c 2f 61 3e 2c 20 75 74 69 6c 69 7a 69 SSL</a>, utilizi
0a90: 6e 67 20 74 68 65 0a 3c 73 74 72 6f 6e 67 3e 54 ng the.<strong>T
0aa0: 63 6c 5f 53 74 61 63 6b 43 68 61 6e 6e 65 6c 3c cl_StackChannel<
0ab0: 2f 73 74 72 6f 6e 67 3e 0a 41 50 49 20 66 6f 72 /strong>.API for
0ac0: 20 54 63 6c 20 38 2e 34 20 61 6e 64 20 68 69 67 Tcl 8.4 and hig
0ad0: 68 65 72 2e 20 54 68 65 20 73 6f 63 6b 65 74 73 her. The sockets
0ae0: 20 62 65 68 61 76 65 20 65 78 61 63 74 6c 79 20 behave exactly
0af0: 74 68 65 20 73 61 6d 65 0a 61 73 20 63 68 61 6e the same.as chan
0b00: 6e 65 6c 73 20 63 72 65 61 74 65 64 20 75 73 69 nels created usi
0b10: 6e 67 20 54 63 6c 27 73 20 62 75 69 6c 74 2d 69 ng Tcl's built-i
0b20: 6e 20 3c 73 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 n <strong>socket
0b30: 3c 2f 73 74 72 6f 6e 67 3e 0a 63 6f 6d 6d 61 6e </strong>.comman
0b40: 64 20 77 69 74 68 20 61 64 64 69 74 69 6f 6e 61 d with additiona
0b50: 6c 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 63 6f l options for co
0b60: 6e 74 72 6f 6c 6c 69 6e 67 20 74 68 65 20 53 53 ntrolling the SS
0b70: 4c 20 73 65 73 73 69 6f 6e 2e 0a 3c 2f 70 3e 0a L session..</p>.
0b80: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 43 4f .<h3><a name="CO
0b90: 4d 4d 41 4e 44 53 22 3e 43 4f 4d 4d 41 4e 44 53 MMANDS">COMMANDS
0ba0: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 79 </a></h3>..<p>Ty
0bb0: 70 69 63 61 6c 6c 79 20 6f 6e 65 20 77 6f 75 6c pically one woul
0bc0: 64 20 75 73 65 20 74 68 65 20 3c 73 74 72 6f 6e d use the <stron
0bd0: 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 3c 2f g>tls::socket </
0be0: 73 74 72 6f 6e 67 3e 63 6f 6d 6d 61 6e 64 0a 77 strong>command.w
0bf0: 68 69 63 68 20 70 72 6f 76 69 64 65 73 20 63 6f hich provides co
0c00: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 mpatibility with
0c10: 20 74 68 65 20 6e 61 74 69 76 65 20 54 63 6c 20 the native Tcl
0c20: 3c 73 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 3c 2f <strong>socket</
0c30: 73 74 72 6f 6e 67 3e 0a 63 6f 6d 6d 61 6e 64 2e strong>.command.
0c40: 20 49 6e 20 73 75 63 68 20 63 61 73 65 73 20 3c In such cases <
0c50: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 6d 70 6f strong>tls::impo
0c60: 72 74 3c 2f 73 74 72 6f 6e 67 3e 20 73 68 6f 75 rt</strong> shou
0c70: 6c 64 20 6e 6f 74 20 62 65 0a 75 73 65 64 20 64 ld not be.used d
0c80: 69 72 65 63 74 6c 79 2e 3c 2f 70 3e 0a 0a 3c 64 irectly.</p>..<d
0c90: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
0ca0: 6d 65 3d 22 74 6c 73 3a 3a 69 6e 69 74 22 3e 3c me="tls::init"><
0cb0: 62 3e 74 6c 73 3a 3a 69 6e 69 74 20 3c 2f 62 3e b>tls::init </b>
0cc0: 3c 69 3e 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e <i>?options?</i>
0cd0: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
0ce0: 64 3e 4f 70 74 69 6f 6e 61 6c 20 66 75 6e 63 74 d>Optional funct
0cf0: 69 6f 6e 20 74 6f 20 73 65 74 20 74 68 65 20 64 ion to set the d
0d00: 65 66 61 75 6c 74 20 6f 70 74 69 6f 6e 73 20 75 efault options u
0d10: 73 65 64 20 62 79 0a 09 3c 73 74 72 6f 6e 67 3e sed by..<strong>
0d20: 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 73 74 72 tls::socket</str
0d30: 6f 6e 67 3e 2e 20 49 66 20 79 6f 75 20 63 61 6c ong>. If you cal
0d40: 6c 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 l <strong>tls::i
0d50: 6d 70 6f 72 74 3c 2f 73 74 72 6f 6e 67 3e 0a 09 mport</strong>..
0d60: 64 69 72 65 63 74 6c 79 20 74 68 69 73 20 72 6f directly this ro
0d70: 75 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 utine has no eff
0d80: 65 63 74 2e 20 41 6e 79 20 6f 66 20 74 68 65 20 ect. Any of the
0d90: 6f 70 74 69 6f 6e 73 0a 09 74 68 61 74 20 3c 73 options..that <s
0da0: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 trong>tls::socke
0db0: 74 3c 2f 73 74 72 6f 6e 67 3e 20 61 63 63 65 70 t</strong> accep
0dc0: 74 73 20 63 61 6e 20 62 65 20 73 65 74 0a 09 75 ts can be set..u
0dd0: 73 69 6e 67 20 74 68 69 73 20 63 6f 6d 6d 61 6e sing this comman
0de0: 64 2c 20 74 68 6f 75 67 68 20 79 6f 75 20 73 68 d, though you sh
0df0: 6f 75 6c 64 20 6c 69 6d 69 74 20 79 6f 75 72 20 ould limit your
0e00: 6f 70 74 69 6f 6e 73 0a 09 74 6f 20 6f 6e 6c 79 options..to only
0e10: 20 54 4c 53 20 72 65 6c 61 74 65 64 20 6f 6e 65 TLS related one
0e20: 73 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 3e s.</dd>. <dt>
0e30: 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 20 </dt>.
0e40: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
0e50: 3a 3a 73 6f 63 6b 65 74 22 3e 3c 62 3e 74 6c 73 ::socket"><b>tls
0e60: 3a 3a 73 6f 63 6b 65 74 20 3c 2f 62 3e 3c 65 6d ::socket </b><em
0e70: 3e 3f 6f 70 74 69 6f 6e 73 3f 0a 09 68 6f 73 74 >?options?..host
0e80: 20 70 6f 72 74 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f port</em></a></
0e90: 64 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 62 3e 74 dt>. <dt><b>t
0ea0: 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e 3c 65 ls::socket</b><e
0eb0: 6d 3e 20 3f 2d 73 65 72 76 65 72 20 63 6f 6d 6d m> ?-server comm
0ec0: 61 6e 64 3f 20 3f 6f 70 74 69 6f 6e 73 3f 20 70 and? ?options? p
0ed0: 6f 72 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 20 20 ort</em></dt>.
0ee0: 20 20 3c 64 64 3e 54 68 69 73 20 69 73 20 61 20 <dd>This is a
0ef0: 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 helper function
0f00: 74 68 61 74 20 75 74 69 6c 69 7a 65 73 20 74 68 that utilizes th
0f10: 65 20 75 6e 64 65 72 6c 79 69 6e 67 0a 09 63 6f e underlying..co
0f20: 6d 6d 61 6e 64 73 20 28 3c 73 74 72 6f 6e 67 3e mmands (<strong>
0f30: 74 6c 73 3a 3a 69 6d 70 6f 72 74 3c 2f 73 74 72 tls::import</str
0f40: 6f 6e 67 3e 29 2e 20 49 74 20 62 65 68 61 76 65 ong>). It behave
0f50: 73 0a 09 65 78 61 63 74 6c 79 20 74 68 65 20 73 s..exactly the s
0f60: 61 6d 65 20 61 73 20 74 68 65 20 6e 61 74 69 76 ame as the nativ
0f70: 65 20 54 63 6c 20 3c 73 74 72 6f 6e 67 3e 73 6f e Tcl <strong>so
0f80: 63 6b 65 74 3c 2f 73 74 72 6f 6e 67 3e 0a 09 63 cket</strong>..c
0f90: 6f 6d 6d 61 6e 64 20 65 78 63 65 70 74 20 74 68 ommand except th
0fa0: 61 74 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 63 at the options c
0fb0: 61 6e 20 69 6e 63 6c 75 64 65 20 61 6e 79 20 6f an include any o
0fc0: 66 20 74 68 65 0a 09 61 70 70 6c 69 63 61 62 6c f the..applicabl
0fd0: 65 20 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a e <a href="#tls:
0fe0: 3a 69 6d 70 6f 72 74 22 3e 3c 73 74 72 6f 6e 67 :import"><strong
0ff0: 3e 74 6c 73 3a 69 6d 70 6f 72 74 3c 2f 73 74 72 >tls:import</str
1000: 6f 6e 67 3e 3c 2f 61 3e 0a 09 6f 70 74 69 6f 6e ong></a>..option
1010: 73 20 77 69 74 68 20 6f 6e 65 20 61 64 64 69 74 s with one addit
1020: 69 6f 6e 61 6c 20 6f 70 74 69 6f 6e 3a 0a 3c 62 ional option:.<b
1030: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
1040: 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dl>..<dt><strong
1050: 3e 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 6d 65 >-autoservername
1060: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f </strong> <em>bo
1070: 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 ol</em></dt>..<d
1080: 64 3e 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 d>Automatically
1090: 73 65 6e 64 20 74 68 65 20 2d 73 65 72 76 65 72 send the -server
10a0: 6e 61 6d 65 20 61 73 20 74 68 65 20 3c 65 6d 3e name as the <em>
10b0: 68 6f 73 74 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 host</em> argume
10c0: 6e 74 0a 09 20 20 20 20 28 64 65 66 61 75 6c 74 nt.. (default
10d0: 20 69 73 20 3c 65 6d 3e 66 61 6c 73 65 3c 2f 65 is <em>false</e
10e0: 6d 3e 29 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 m>)</dd>. </d
10f0: 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e l>.</blockquote>
1100: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
1110: 65 3d 22 74 6c 73 3a 3a 69 6d 70 6f 72 74 22 3e e="tls::import">
1120: 3c 62 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 20 3c <b>tls::import <
1130: 2f 62 3e 3c 69 3e 63 68 61 6e 6e 65 6c 0a 09 3f /b><i>channel..?
1140: 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e options?</i></a>
1150: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 53 </dt>. <dd>SS
1160: 4c 2d 65 6e 61 62 6c 65 20 61 20 72 65 67 75 6c L-enable a regul
1170: 61 72 20 54 63 6c 20 63 68 61 6e 6e 65 6c 20 2d ar Tcl channel -
1180: 20 69 74 20 6e 65 65 64 20 6e 6f 74 20 62 65 20 it need not be
1190: 61 0a 09 73 6f 63 6b 65 74 2c 20 62 75 74 20 6d a..socket, but m
11a0: 75 73 74 20 70 72 6f 76 69 64 65 20 62 69 2d 64 ust provide bi-d
11b0: 69 72 65 63 74 69 6f 6e 61 6c 20 66 6c 6f 77 2e irectional flow.
11c0: 20 41 6c 73 6f 0a 09 73 65 74 74 69 6e 67 20 73 Also..setting s
11d0: 65 73 73 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 ession parameter
11e0: 73 20 66 6f 72 20 53 53 4c 20 68 61 6e 64 73 68 s for SSL handsh
11f0: 61 6b 65 2e 3c 2f 64 64 3e 0a 0a 3c 62 6c 6f 63 ake.</dd>..<bloc
1200: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 64 6c 3e kquote>. <dl>
1210: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 61 ..<dt><strong>-a
1220: 6c 70 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d lpn</strong> <em
1230: 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >list</em></dt>.
1240: 09 3c 64 64 3e 4c 69 73 74 20 6f 66 20 70 72 6f .<dd>List of pro
1250: 74 6f 63 6f 6c 73 20 74 6f 20 6f 66 66 65 72 20 tocols to offer
1260: 64 75 72 69 6e 67 20 41 70 70 6c 69 63 61 74 69 during Applicati
1270: 6f 6e 2d 4c 61 79 65 72 0a 09 20 20 20 20 50 72 on-Layer.. Pr
1280: 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 61 74 69 otocol Negotiati
1290: 6f 6e 20 28 41 4c 50 4e 29 2e 20 46 6f 72 20 65 on (ALPN). For e
12a0: 78 61 6d 70 6c 65 3a 20 3c 65 6d 3e 68 32 3c 2f xample: <em>h2</
12b0: 65 6d 3e 20 61 6e 64 0a 09 20 20 20 20 3c 65 6d em> and.. <em
12c0: 3e 68 74 74 70 2f 31 2e 31 3c 2f 65 6d 3e 2c 20 >http/1.1</em>,
12d0: 62 75 74 20 6e 6f 74 20 3c 65 6d 3e 68 33 3c 2f but not <em>h3</
12e0: 65 6d 3e 20 6f 72 20 3c 65 6d 3e 71 75 69 63 3c em> or <em>quic<
12f0: 2f 65 6d 3e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e /em>.</dd>..<dt>
1300: 3c 73 74 72 6f 6e 67 3e 2d 63 61 64 69 72 3c 2f <strong>-cadir</
1310: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 69 72 3c strong> <em>dir<
1320: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
1330: 65 74 20 74 68 65 20 43 41 20 63 65 72 74 69 66 et the CA certif
1340: 69 63 61 74 65 73 20 70 61 74 68 2e 20 54 68 65 icates path. The
1350: 20 64 65 66 61 75 6c 74 20 64 69 72 65 63 74 6f default directo
1360: 72 79 20 69 73 20 70 6c 61 74 66 6f 72 6d 0a 09 ry is platform..
1370: 20 20 20 20 73 70 65 63 69 66 69 63 20 61 6e 64 specific and
1380: 20 63 61 6e 20 62 65 20 73 65 74 20 61 74 20 63 can be set at c
1390: 6f 6d 70 69 6c 65 20 74 69 6d 65 2e 20 54 68 69 ompile time. Thi
13a0: 73 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 s can be overrid
13b0: 64 65 6e 0a 09 20 20 20 20 76 69 61 20 74 68 65 den.. via the
13c0: 20 3c 62 3e 53 53 4c 5f 43 45 52 54 5f 44 49 52 <b>SSL_CERT_DIR
13d0: 3c 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 </b> environment
13e0: 20 76 61 72 69 61 62 6c 65 2e 3c 2f 64 64 3e 0a variable.</dd>.
13f0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 61 .<dt><strong>-ca
1400: 66 69 6c 65 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 file </strong><e
1410: 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c m>filename</em><
1420: 2f 64 74 3e 0a 09 3c 64 64 3e 53 65 74 20 74 68 /dt>..<dd>Set th
1430: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 75 e certificate au
1440: 74 68 6f 72 69 74 79 20 28 43 41 29 20 63 65 72 thority (CA) cer
1450: 74 69 66 69 63 61 74 65 73 20 66 69 6c 65 2e 20 tificates file.
1460: 54 68 65 20 64 65 66 61 75 6c 74 0a 09 20 20 20 The default..
1470: 20 69 73 20 74 68 65 20 63 65 72 74 2e 70 65 6d is the cert.pem
1480: 20 66 69 6c 65 20 69 6e 20 74 68 65 20 4f 70 73 file in the Ops
1490: 6e 53 53 4c 20 64 69 72 65 63 74 6f 72 79 2e 20 nSSL directory.
14a0: 54 68 69 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 This can also be
14b0: 0a 09 20 20 20 20 6f 76 65 72 72 69 64 64 65 6e .. overridden
14c0: 20 76 69 61 20 74 68 65 20 3c 62 3e 53 53 4c 5f via the <b>SSL_
14d0: 43 45 52 54 5f 46 49 4c 45 3c 2f 62 3e 20 65 6e CERT_FILE</b> en
14e0: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
14f0: 6c 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 le.</dd>..<dt><s
1500: 74 72 6f 6e 67 3e 2d 63 65 72 74 66 69 6c 65 3c trong>-certfile<
1510: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c /strong> <em>fil
1520: 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a ename</em></dt>.
1530: 09 3c 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 .<dd>Specify the
1540: 20 66 69 6c 65 6e 61 6d 65 20 77 69 74 68 20 74 filename with t
1550: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 74 he certificate t
1560: 6f 20 75 73 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 o use.</dd>..<dt
1570: 3e 3c 73 74 72 6f 6e 67 3e 2d 63 65 72 74 3c 2f ><strong>-cert</
1580: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c 65 strong> <em>file
1590: 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 name</em></dt>..
15a0: 3c 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 20 <dd>Specify the
15b0: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 63 65 contents of a ce
15c0: 72 74 69 66 69 63 61 74 65 20 74 6f 20 75 73 65 rtificate to use
15d0: 2c 20 61 73 20 61 20 44 45 52 0a 09 20 20 20 20 , as a DER..
15e0: 65 6e 63 6f 64 65 64 20 62 69 6e 61 72 79 20 76 encoded binary v
15f0: 61 6c 75 65 20 28 58 2e 35 30 39 20 44 45 52 29 alue (X.509 DER)
1600: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
1610: 6f 6e 67 3e 2d 63 69 70 68 65 72 3c 2f 73 74 72 ong>-cipher</str
1620: 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c ong> <em>string<
1630: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c /em></dt>..<dd>L
1640: 69 73 74 20 6f 66 20 63 69 70 68 65 72 73 20 74 ist of ciphers t
1650: 6f 20 75 73 65 2e 20 53 74 72 69 6e 67 20 69 73 o use. String is
1660: 20 61 20 63 6f 6c 6f 6e 20 28 22 3a 22 29 20 73 a colon (":") s
1670: 65 70 61 72 61 74 65 64 20 6c 69 73 74 0a 09 20 eparated list..
1680: 20 20 20 6f 66 20 63 69 70 68 65 72 73 20 6f 72 of ciphers or
1690: 20 63 69 70 68 65 72 20 73 75 69 74 65 73 2e 20 cipher suites.
16a0: 43 69 70 68 65 72 20 73 75 69 74 65 73 20 63 61 Cipher suites ca
16b0: 6e 20 62 65 20 63 6f 6d 62 69 6e 65 64 0a 09 20 n be combined..
16c0: 20 20 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e using the <b>
16d0: 2b 3c 2f 62 3e 20 63 68 61 72 61 63 74 65 72 2e +</b> character.
16e0: 20 50 72 65 66 69 78 65 73 20 63 61 6e 20 62 65 Prefixes can be
16f0: 20 75 73 65 64 20 74 6f 20 70 65 72 6d 61 6e 65 used to permane
1700: 6e 74 6c 79 0a 09 20 20 20 20 72 65 6d 6f 76 65 ntly.. remove
1710: 20 28 22 21 22 29 2c 20 64 65 6c 65 74 65 20 28 ("!"), delete (
1720: 22 2d 22 29 2c 20 6f 72 20 6d 6f 76 65 20 61 20 "-"), or move a
1730: 63 79 70 68 65 72 20 74 6f 20 74 68 65 20 65 6e cypher to the en
1740: 64 20 6f 66 0a 09 20 20 20 20 74 68 65 20 6c 69 d of.. the li
1750: 73 74 20 28 22 2b 22 29 2e 20 4b 65 79 77 6f 72 st ("+"). Keywor
1760: 64 73 20 3c 62 3e 40 53 54 52 45 4e 47 54 48 3c ds <b>@STRENGTH<
1770: 2f 62 3e 20 28 73 6f 72 74 20 62 79 20 61 6c 67 /b> (sort by alg
1780: 6f 72 69 74 68 6d 0a 09 20 20 20 20 6b 65 79 20 orithm.. key
1790: 6c 65 6e 67 74 68 29 2c 20 3c 62 3e 40 53 45 43 length), <b>@SEC
17a0: 4c 45 56 45 4c 3d 3c 2f 62 3e 3c 69 3e 6e 3c 2f LEVEL=</b><i>n</
17b0: 69 3e 20 28 73 65 74 20 73 65 63 75 72 69 74 79 i> (set security
17c0: 20 6c 65 76 65 6c 20 74 6f 0a 09 20 20 20 20 6e level to.. n
17d0: 29 2c 20 61 6e 64 20 3c 62 3e 44 45 46 41 55 4c ), and <b>DEFAUL
17e0: 54 3c 2f 62 3e 20 28 75 73 65 20 64 65 66 61 75 T</b> (use defau
17f0: 6c 74 20 63 69 70 68 65 72 20 6c 69 73 74 2c 20 lt cipher list,
1800: 61 74 20 73 74 61 72 74 20 6f 6e 6c 79 29 0a 09 at start only)..
1810: 20 20 20 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 can also be
1820: 73 70 65 63 69 66 69 65 64 2e 20 53 65 65 20 4f specified. See O
1830: 70 65 6e 53 53 4c 20 64 6f 63 75 6d 65 6e 74 61 penSSL documenta
1840: 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 66 75 6c tion for the ful
1850: 6c 0a 09 20 20 20 20 6c 69 73 74 20 6f 66 20 76 l.. list of v
1860: 61 6c 69 64 20 76 61 6c 75 65 73 2e 20 28 54 4c alid values. (TL
1870: 53 20 31 2e 32 20 61 6e 64 20 65 61 72 6c 69 65 S 1.2 and earlie
1880: 72 20 6f 6e 6c 79 29 3c 2f 64 64 3e 0a 09 3c 64 r only)</dd>..<d
1890: 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 69 70 68 65 t><strong>-ciphe
18a0: 72 73 75 69 74 65 73 3c 2f 73 74 72 6f 6e 67 3e rsuites</strong>
18b0: 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e <em>string</em>
18c0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 74 20 </dt>..<dd>List
18d0: 6f 66 20 63 69 70 68 65 72 20 73 75 69 74 65 73 of cipher suites
18e0: 20 74 6f 20 75 73 65 2e 20 53 74 72 69 6e 67 20 to use. String
18f0: 69 73 20 61 20 63 6f 6c 6f 6e 20 28 22 3a 22 29 is a colon (":")
1900: 0a 09 20 20 20 20 73 65 70 61 72 61 74 65 64 20 .. separated
1910: 6c 69 73 74 20 6f 66 20 63 69 70 68 65 72 20 73 list of cipher s
1920: 75 69 74 65 20 6e 61 6d 65 73 2e 20 28 54 4c 53 uite names. (TLS
1930: 20 31 2e 33 20 6f 6e 6c 79 29 3c 2f 64 64 3e 0a 1.3 only)</dd>.
1940: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 6f .<dt><strong>-co
1950: 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c mmand</strong> <
1960: 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e em>callback</em>
1970: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 61 6c 6c 62 </dt>..<dd>Callb
1980: 61 63 6b 20 74 6f 20 69 6e 76 6f 6b 65 20 61 74 ack to invoke at
1990: 20 73 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 20 several points
19a0: 64 75 72 69 6e 67 20 74 68 65 20 68 61 6e 64 73 during the hands
19b0: 68 61 6b 65 2e 0a 09 20 20 20 20 54 68 69 73 20 hake... This
19c0: 69 73 20 75 73 65 64 20 74 6f 20 70 61 73 73 20 is used to pass
19d0: 65 72 72 6f 72 73 20 61 6e 64 20 74 72 61 63 69 errors and traci
19e0: 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 ng information,
19f0: 61 6e 64 0a 09 20 20 20 20 69 74 20 63 61 6e 20 and.. it can
1a00: 61 6c 6c 6f 77 20 54 63 6c 20 73 63 72 69 70 74 allow Tcl script
1a10: 73 20 74 6f 20 70 65 72 66 6f 72 6d 20 74 68 65 s to perform the
1a20: 69 72 20 6f 77 6e 20 63 65 72 74 69 66 69 63 61 ir own certifica
1a30: 74 65 0a 09 20 20 20 20 76 61 6c 69 64 61 74 69 te.. validati
1a40: 6f 6e 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 on in place of t
1a50: 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 69 64 he default valid
1a60: 61 74 69 6f 6e 20 70 72 6f 76 69 64 65 64 20 62 ation provided b
1a70: 79 0a 09 20 20 20 20 4f 70 65 6e 53 53 4c 2e 20 y.. OpenSSL.
1a80: 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 43 41 See <a href="#CA
1a90: 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 3e LLBACK OPTIONS">
1aa0: 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 CALLBACK OPTIONS
1ab0: 3c 2f 61 3e 0a 09 20 20 20 20 66 6f 72 20 66 75 </a>.. for fu
1ac0: 72 74 68 65 72 20 64 69 73 63 75 73 73 69 6f 6e rther discussion
1ad0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
1ae0: 6f 6e 67 3e 2d 64 68 70 61 72 61 6d 73 20 3c 2f ong>-dhparams </
1af0: 73 74 72 6f 6e 67 3e 3c 65 6d 3e 66 69 6c 65 6e strong><em>filen
1b00: 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ame</em></dt>..<
1b10: 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 20 44 dd>Specify the D
1b20: 69 66 66 69 65 2d 48 65 6c 6c 6d 61 6e 20 70 61 iffie-Hellman pa
1b30: 72 61 6d 65 74 65 72 73 20 66 69 6c 65 2e 3c 2f rameters file.</
1b40: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
1b50: 3e 2d 6b 65 79 66 69 6c 65 3c 2f 73 74 72 6f 6e >-keyfile</stron
1b60: 67 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c g> <em>filename<
1b70: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
1b80: 70 65 63 69 66 79 20 74 68 65 20 70 72 69 76 61 pecify the priva
1b90: 74 65 20 6b 65 79 20 66 69 6c 65 2e 20 28 64 65 te key file. (de
1ba0: 66 61 75 6c 74 20 69 73 0a 09 20 20 20 20 76 61 fault is.. va
1bb0: 6c 75 65 20 6f 66 20 2d 63 65 72 74 66 69 6c 65 lue of -certfile
1bc0: 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 )</dd>..<dt><str
1bd0: 6f 6e 67 3e 2d 6b 65 79 3c 2f 73 74 72 6f 6e 67 ong>-key</strong
1be0: 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f > <em>filename</
1bf0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 70 em></dt>..<dd>Sp
1c00: 65 63 69 66 79 20 74 68 65 20 70 72 69 76 61 74 ecify the privat
1c10: 65 20 6b 65 79 20 74 6f 20 75 73 65 20 61 73 20 e key to use as
1c20: 61 20 44 45 52 20 65 6e 63 6f 64 65 64 20 76 61 a DER encoded va
1c30: 6c 75 65 20 28 50 4b 43 53 23 31 20 44 45 52 29 lue (PKCS#1 DER)
1c40: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
1c50: 6e 67 3e 2d 6d 6f 64 65 6c 3c 2f 73 74 72 6f 6e ng>-model</stron
1c60: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 3c 2f g> <em>channel</
1c70: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 46 6f em></dt>..<dd>Fo
1c80: 72 63 65 20 74 68 69 73 20 63 68 61 6e 6e 65 6c rce this channel
1c90: 20 74 6f 20 73 68 61 72 65 20 74 68 65 20 73 61 to share the sa
1ca0: 6d 65 20 3c 65 6d 3e 3c 73 74 72 6f 6e 67 3e 53 me <em><strong>S
1cb0: 53 4c 5f 43 54 58 3c 2f 73 74 72 6f 6e 67 3e 3c SL_CTX</strong><
1cc0: 2f 65 6d 3e 0a 09 20 20 20 20 73 74 72 75 63 74 /em>.. struct
1cd0: 75 72 65 20 61 73 20 74 68 65 20 73 70 65 63 69 ure as the speci
1ce0: 66 69 65 64 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c fied <em>channel
1cf0: 3c 2f 65 6d 3e 2c 20 61 6e 64 0a 09 20 20 20 20 </em>, and..
1d00: 74 68 65 72 65 66 6f 72 65 20 73 68 61 72 65 20 therefore share
1d10: 63 61 6c 6c 62 61 63 6b 73 20 65 74 63 2e 3c 2f callbacks etc.</
1d20: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
1d30: 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f >-password</stro
1d40: 6e 67 3e 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b ng> <em>callback
1d50: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
1d60: 43 61 6c 6c 62 61 63 6b 20 74 6f 20 69 6e 76 6f Callback to invo
1d70: 6b 65 20 77 68 65 6e 20 4f 70 65 6e 53 53 4c 20 ke when OpenSSL
1d80: 6e 65 65 64 73 20 74 6f 20 6f 62 74 61 69 6e 20 needs to obtain
1d90: 61 20 70 61 73 73 77 6f 72 64 2c 0a 09 20 20 20 a password,..
1da0: 20 74 79 70 69 63 61 6c 6c 79 20 74 6f 20 75 6e typically to un
1db0: 6c 6f 63 6b 20 74 68 65 20 70 72 69 76 61 74 65 lock the private
1dc0: 20 6b 65 79 20 6f 66 20 61 20 63 65 72 74 69 66 key of a certif
1dd0: 69 63 61 74 65 2e 20 54 68 65 0a 09 20 20 20 20 icate. The..
1de0: 63 61 6c 6c 62 61 63 6b 20 73 68 6f 75 6c 64 20 callback should
1df0: 72 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20 return a string
1e00: 77 68 69 63 68 20 72 65 70 72 65 73 65 6e 74 73 which represents
1e10: 20 74 68 65 20 70 61 73 73 77 6f 72 64 0a 09 20 the password..
1e20: 20 20 20 74 6f 20 62 65 20 75 73 65 64 2e 20 53 to be used. S
1e30: 65 65 20 3c 61 20 68 72 65 66 3d 22 23 43 41 4c ee <a href="#CAL
1e40: 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 3e 43 LBACK OPTIONS">C
1e50: 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 3c ALLBACK OPTIONS<
1e60: 2f 61 3e 0a 09 20 20 20 20 66 6f 72 20 66 75 72 /a>.. for fur
1e70: 74 68 65 72 20 64 69 73 63 75 73 73 69 6f 6e 2e ther discussion.
1e80: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
1e90: 6e 67 3e 2d 70 6f 73 74 5f 68 61 6e 64 73 68 61 ng>-post_handsha
1ea0: 6b 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e ke</strong> <em>
1eb0: 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 bool</em></dt>..
1ec0: 3c 64 64 3e 41 6c 6c 6f 77 20 70 6f 73 74 2d 68 <dd>Allow post-h
1ed0: 61 6e 64 73 68 61 6b 65 20 74 69 63 6b 65 74 20 andshake ticket
1ee0: 75 70 64 61 74 65 73 2e 3c 2f 64 64 3e 0a 09 3c updates.</dd>..<
1ef0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 72 65 71 75 dt><strong>-requ
1f00: 65 73 74 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 6d est </strong><em
1f10: 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >bool</em></dt>.
1f20: 09 3c 64 64 3e 52 65 71 75 65 73 74 20 61 20 63 .<dd>Request a c
1f30: 65 72 74 69 66 69 63 61 74 65 20 66 72 6f 6d 20 ertificate from
1f40: 70 65 65 72 20 64 75 72 69 6e 67 20 53 53 4c 20 peer during SSL
1f50: 68 61 6e 64 73 68 61 6b 65 2e 0a 09 20 20 20 20 handshake...
1f60: 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e (default is <em>
1f70: 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a true</em>)</dd>.
1f80: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 72 65 .<dt><strong>-re
1f90: 71 75 69 72 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c quire</strong> <
1fa0: 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 em>bool</em></dt
1fb0: 3e 0a 09 3c 64 64 3e 52 65 71 75 69 72 65 20 61 >..<dd>Require a
1fc0: 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 61 valid certifica
1fd0: 74 65 20 66 72 6f 6d 20 70 65 65 72 20 64 75 72 te from peer dur
1fe0: 69 6e 67 20 53 53 4c 20 68 61 6e 64 73 68 61 6b ing SSL handshak
1ff0: 65 2e 0a 09 20 20 20 20 49 66 20 74 68 69 73 20 e... If this
2000: 69 73 20 73 65 74 20 74 6f 20 74 72 75 65 2c 20 is set to true,
2010: 74 68 65 6e 20 3c 73 74 72 6f 6e 67 3e 2d 72 65 then <strong>-re
2020: 71 75 65 73 74 3c 2f 73 74 72 6f 6e 67 3e 20 6d quest</strong> m
2030: 75 73 74 0a 09 20 20 20 20 61 6c 73 6f 20 62 65 ust.. also be
2040: 20 73 65 74 20 74 6f 20 74 72 75 65 2e 20 28 64 set to true. (d
2050: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 66 61 efault is <em>fa
2060: 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 lse</em>)</dd>..
2070: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 65 63 <dt><strong>-sec
2080: 75 72 69 74 79 6c 65 76 65 6c 3c 2f 73 74 72 6f uritylevel</stro
2090: 6e 67 3e 20 3c 65 6d 3e 69 6e 74 65 67 65 72 3c ng> <em>integer<
20a0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
20b0: 65 74 20 73 65 63 75 72 69 74 79 20 6c 65 76 65 et security leve
20c0: 6c 2e 20 4d 75 73 74 20 62 65 20 30 20 74 6f 20 l. Must be 0 to
20d0: 35 2e 20 54 68 65 20 73 65 63 75 72 69 74 79 20 5. The security
20e0: 6c 65 76 65 6c 20 61 66 66 65 63 74 73 0a 09 20 level affects..
20f0: 20 20 20 63 69 70 68 65 72 20 73 75 69 74 65 20 cipher suite
2100: 65 6e 63 72 79 70 74 69 6f 6e 20 61 6c 67 6f 72 encryption algor
2110: 69 74 68 6d 73 2c 20 73 75 70 70 6f 72 74 65 64 ithms, supported
2120: 20 45 43 43 20 63 75 72 76 65 73 2c 0a 09 20 20 ECC curves,..
2130: 20 20 73 75 70 70 6f 72 74 65 64 20 73 69 67 6e supported sign
2140: 61 74 75 72 65 20 61 6c 67 6f 72 69 74 68 6d 73 ature algorithms
2150: 2c 20 44 48 20 70 61 72 61 6d 65 74 65 72 20 73 , DH parameter s
2160: 69 7a 65 73 2c 20 63 65 72 74 69 66 69 63 61 74 izes, certificat
2170: 65 0a 09 20 20 20 20 6b 65 79 20 73 69 7a 65 73 e.. key sizes
2180: 20 61 6e 64 20 73 69 67 6e 61 74 75 72 65 20 61 and signature a
2190: 6c 67 6f 72 69 74 68 6d 73 2e 20 54 68 65 20 64 lgorithms. The d
21a0: 65 66 61 75 6c 74 20 69 73 20 31 2e 0a 09 20 20 efault is 1...
21b0: 20 20 4c 65 76 65 6c 20 33 20 61 6e 64 20 68 69 Level 3 and hi
21c0: 67 68 65 72 20 64 69 73 61 62 6c 65 20 73 75 70 gher disable sup
21d0: 70 6f 72 74 20 66 6f 72 20 73 65 73 73 69 6f 6e port for session
21e0: 20 74 69 63 6b 65 74 73 20 61 6e 64 20 6f 6e 6c tickets and onl
21f0: 79 0a 09 20 20 20 20 61 63 63 65 70 74 20 63 69 y.. accept ci
2200: 70 68 65 72 20 73 75 69 74 65 73 20 74 68 61 74 pher suites that
2210: 20 70 72 6f 76 69 64 65 20 66 6f 72 77 61 72 64 provide forward
2220: 20 73 65 63 72 65 63 79 2e 3c 2f 64 64 3e 0a 09 secrecy.</dd>..
2230: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 65 72 <dt><strong>-ser
2240: 76 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ver</strong> <em
2250: 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >bool</em></dt>.
2260: 09 3c 64 64 3e 48 61 6e 64 73 68 61 6b 65 20 61 .<dd>Handshake a
2270: 73 20 73 65 72 76 65 72 20 69 66 20 74 72 75 65 s server if true
2280: 2c 20 65 6c 73 65 20 68 61 6e 64 73 68 61 6b 65 , else handshake
2290: 20 61 73 0a 09 20 20 20 20 63 6c 69 65 6e 74 2e as.. client.
22a0: 20 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d (default is <em
22b0: 3e 66 61 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 >false</em>)</dd
22c0: 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d >..<dt><strong>-
22d0: 73 65 72 76 65 72 6e 61 6d 65 3c 2f 73 74 72 6f servername</stro
22e0: 6e 67 3e 20 3c 65 6d 3e 68 6f 73 74 3c 2f 65 6d ng> <em>host</em
22f0: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 70 65 63 ></dt>..<dd>Spec
2300: 69 66 79 20 73 65 72 76 65 72 20 68 6f 73 74 6e ify server hostn
2310: 61 6d 65 2e 20 4f 6e 6c 79 20 61 76 61 69 6c 61 ame. Only availa
2320: 62 6c 65 20 69 66 20 74 68 65 20 4f 70 65 6e 53 ble if the OpenS
2330: 53 4c 20 6c 69 62 72 61 72 79 0a 09 20 20 20 20 SL library..
2340: 74 68 65 20 70 61 63 6b 61 67 65 20 69 73 20 6c the package is l
2350: 69 6e 6b 65 64 20 61 67 61 69 6e 73 74 20 73 75 inked against su
2360: 70 70 6f 72 74 73 20 74 68 65 20 54 4c 53 20 68 pports the TLS h
2370: 6f 73 74 6e 61 6d 65 20 65 78 74 65 6e 73 69 6f ostname extensio
2380: 6e 0a 09 20 20 20 20 66 6f 72 20 27 53 65 72 76 n.. for 'Serv
2390: 65 72 20 4e 61 6d 65 20 49 6e 64 69 63 61 74 69 er Name Indicati
23a0: 6f 6e 27 20 28 53 4e 49 29 2e 20 55 73 65 20 74 on' (SNI). Use t
23b0: 6f 20 6e 61 6d 65 20 74 68 65 20 6c 6f 67 69 63 o name the logic
23c0: 61 6c 20 68 6f 73 74 0a 09 20 20 20 20 77 65 20 al host.. we
23d0: 61 72 65 20 74 61 6c 6b 69 6e 67 20 74 6f 20 61 are talking to a
23e0: 6e 64 20 65 78 70 65 63 74 69 6e 67 20 61 20 63 nd expecting a c
23f0: 65 72 74 69 66 69 63 61 74 65 20 66 6f 72 2e 3c ertificate for.<
2400: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
2410: 67 3e 2d 73 65 73 73 69 6f 6e 5f 69 64 3c 2f 73 g>-session_id</s
2420: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
2430: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
2440: 3e 53 65 73 73 69 6f 6e 20 69 64 20 74 6f 20 72 >Session id to r
2450: 65 73 75 6d 65 20 73 65 73 73 69 6f 6e 2e 3c 2f esume session.</
2460: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
2470: 3e 2d 73 73 6c 32 3c 2f 73 74 72 6f 6e 67 3e 20 >-ssl2</strong>
2480: 3c 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 <em>bool</em></d
2490: 74 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 20 75 t>..<dd>Enable u
24a0: 73 65 20 6f 66 20 53 53 4c 20 76 32 2e 20 28 64 se of SSL v2. (d
24b0: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 66 61 efault is <em>fa
24c0: 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 lse</em>)</dd>..
24d0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 73 6c <dt><strong>-ssl
24e0: 33 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 6d 3e 62 3 </strong><em>b
24f0: 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ool</em></dt>..<
2500: 64 64 3e 45 6e 61 62 6c 65 20 75 73 65 20 6f 66 dd>Enable use of
2510: 20 53 53 4c 20 76 33 2e 20 28 64 65 66 61 75 6c SSL v3. (defaul
2520: 74 20 69 73 20 3c 65 6d 3e 66 61 6c 73 65 3c 2f t is <em>false</
2530: 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e 2d em>)</dd>..<dt>-
2540: 3c 73 74 72 6f 6e 67 3e 74 6c 73 31 3c 2f 73 74 <strong>tls1</st
2550: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 3c 2f rong> <em>bool</
2560: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 45 6e em></dt>..<dd>En
2570: 61 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 able use of TLS
2580: 76 31 2e 20 28 64 65 66 61 75 6c 74 20 69 73 20 v1. (default is
2590: 3c 65 6d 3e 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f <em>true</em>)</
25a0: 64 64 3e 0a 09 3c 64 74 3e 2d 3c 73 74 72 6f 6e dd>..<dt>-<stron
25b0: 67 3e 74 6c 73 31 2e 31 3c 2f 73 74 72 6f 6e 67 g>tls1.1</strong
25c0: 3e 20 3c 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c > <em>bool</em><
25d0: 2f 64 74 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 /dt>..<dd>Enable
25e0: 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 2e 31 use of TLS v1.1
25f0: 20 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d (default is <em
2600: 3e 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e >true</em>)</dd>
2610: 0a 09 3c 64 74 3e 2d 3c 73 74 72 6f 6e 67 3e 74 ..<dt>-<strong>t
2620: 6c 73 31 2e 32 3c 2f 73 74 72 6f 6e 67 3e 20 3c ls1.2</strong> <
2630: 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 em>bool</em></dt
2640: 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 20 75 73 >..<dd>Enable us
2650: 65 20 6f 66 20 54 4c 53 20 76 31 2e 32 20 28 64 e of TLS v1.2 (d
2660: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 74 72 efault is <em>tr
2670: 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c ue</em>)</dd>..<
2680: 64 74 3e 2d 3c 73 74 72 6f 6e 67 3e 74 6c 73 31 dt>-<strong>tls1
2690: 2e 33 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e .3</strong> <em>
26a0: 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 bool</em></dt>..
26b0: 3c 64 64 3e 45 6e 61 62 6c 65 20 75 73 65 20 6f <dd>Enable use o
26c0: 66 20 54 4c 53 20 76 31 2e 33 20 28 64 65 66 61 f TLS v1.3 (defa
26d0: 75 6c 74 20 69 73 20 3c 65 6d 3e 74 72 75 65 3c ult is <em>true<
26e0: 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e /em>)</dd>..<dt>
26f0: 3c 73 74 72 6f 6e 67 3e 2d 76 61 6c 69 64 61 74 <strong>-validat
2700: 65 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 ecommand</strong
2710: 3e 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f > <em>callback</
2720: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 61 em></dt>..<dd>Ca
2730: 6c 6c 62 61 63 6b 20 74 6f 20 69 6e 76 6f 6b 65 llback to invoke
2740: 20 74 6f 20 76 65 72 69 66 79 20 6f 72 20 76 61 to verify or va
2750: 6c 69 64 61 74 65 20 70 72 6f 74 6f 63 6f 6c 20 lidate protocol
2760: 63 6f 6e 66 69 67 0a 09 20 20 20 20 70 61 72 61 config.. para
2770: 6d 65 74 65 72 73 20 64 75 72 69 6e 67 20 74 68 meters during th
2780: 65 20 70 72 6f 74 6f 63 6f 6c 20 6e 65 67 6f 74 e protocol negot
2790: 69 61 74 69 6f 6e 20 70 68 61 73 65 2e 20 53 65 iation phase. Se
27a0: 65 0a 09 20 20 20 20 3c 61 20 68 72 65 66 3d 22 e.. <a href="
27b0: 23 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e #CALLBACK OPTION
27c0: 53 22 3e 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 S">CALLBACK OPTI
27d0: 4f 4e 53 3c 2f 61 3e 0a 09 20 20 20 20 66 6f 72 ONS</a>.. for
27e0: 20 66 75 72 74 68 65 72 20 64 69 73 63 75 73 73 further discuss
27f0: 69 6f 6e 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f ion.</dd>. </
2800: 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 dl>.</blockquote
2810: 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 >.. <dt><a na
2820: 6d 65 3d 22 74 6c 73 3a 3a 75 6e 69 6d 70 6f 72 me="tls::unimpor
2830: 74 22 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 69 6d 70 t"><b>tls::unimp
2840: 6f 72 74 20 3c 2f 62 3e 3c 69 3e 63 68 61 6e 6e ort </b><i>chann
2850: 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a el</i></a></dt>.
2860: 20 20 20 20 3c 64 64 3e 50 72 6f 76 69 64 65 64 <dd>Provided
2870: 20 66 6f 72 20 73 79 6d 6d 65 74 72 79 20 74 6f for symmetry to
2880: 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 6d <strong>tls::im
2890: 70 6f 72 74 3c 2f 73 74 72 6f 6e 67 3e 2c 20 74 port</strong>, t
28a0: 68 69 73 0a 20 20 20 20 20 20 75 6e 73 74 61 63 his. unstac
28b0: 6b 73 20 74 68 65 20 53 53 4c 2d 65 6e 61 62 6c ks the SSL-enabl
28c0: 69 6e 67 20 6f 66 20 61 20 72 65 67 75 6c 61 72 ing of a regular
28d0: 20 54 63 6c 20 63 68 61 6e 6e 65 6c 2e 20 20 41 Tcl channel. A
28e0: 6e 20 65 72 72 6f 72 0a 20 20 20 20 20 20 69 73 n error. is
28f0: 20 74 68 72 6f 77 6e 20 69 66 20 54 4c 53 20 69 thrown if TLS i
2900: 73 20 6e 6f 74 20 74 68 65 20 74 6f 70 20 73 74 s not the top st
2910: 61 63 6b 65 64 20 63 68 61 6e 6e 65 6c 20 74 79 acked channel ty
2920: 70 65 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 pe.</dd>. <dt
2930: 3e 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 > </dt>.
2940: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
2950: 73 3a 3a 68 61 6e 64 73 68 61 6b 65 22 3e 3c 73 s::handshake"><s
2960: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 68 61 6e 64 73 trong>tls::hands
2970: 68 61 6b 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 hake</strong> <e
2980: 6d 3e 63 68 61 6e 6e 65 6c 3c 2f 65 6d 3e 3c 2f m>channel</em></
2990: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
29a0: 46 6f 72 63 65 73 20 68 61 6e 64 73 68 61 6b 65 Forces handshake
29b0: 20 74 6f 20 74 61 6b 65 20 70 6c 61 63 65 2c 20 to take place,
29c0: 61 6e 64 20 72 65 74 75 72 6e 73 20 30 20 69 66 and returns 0 if
29d0: 0a 09 68 61 6e 64 73 68 61 6b 65 20 69 73 20 73 ..handshake is s
29e0: 74 69 6c 6c 20 69 6e 20 70 72 6f 67 72 65 73 73 till in progress
29f0: 20 28 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 29 2c (non-blocking),
2a00: 20 6f 72 20 31 20 69 66 0a 09 74 68 65 20 68 61 or 1 if..the ha
2a10: 6e 64 73 68 61 6b 65 20 77 61 73 20 73 75 63 63 ndshake was succ
2a20: 65 73 73 66 75 6c 2e 20 49 66 20 74 68 65 20 68 essful. If the h
2a30: 61 6e 64 73 68 61 6b 65 20 66 61 69 6c 65 64 0a andshake failed.
2a40: 09 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 .this routine wi
2a50: 6c 6c 20 74 68 72 6f 77 20 61 6e 20 65 72 72 6f ll throw an erro
2a60: 72 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 3e r.</dd>. <dt>
2a70: 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 20 </dt>.
2a80: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
2a90: 3a 3a 73 74 61 74 75 73 22 3e 3c 73 74 72 6f 6e ::status"><stron
2aa0: 67 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 73 g>tls::status</s
2ab0: 74 72 6f 6e 67 3e 0a 20 20 20 20 3c 65 6d 3e 3f trong>. <em>?
2ac0: 2d 6c 6f 63 61 6c 3f 20 63 68 61 6e 6e 65 6c 3c -local? channel<
2ad0: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
2ae0: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
2af0: 65 20 63 75 72 72 65 6e 74 20 73 74 61 74 75 73 e current status
2b00: 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 63 of the certific
2b10: 61 74 65 20 66 6f 72 20 61 6e 20 53 53 4c 0a 09 ate for an SSL..
2b20: 63 68 61 6e 6e 65 6c 2e 20 54 68 65 20 72 65 73 channel. The res
2b30: 75 6c 74 20 69 73 20 61 20 6c 69 73 74 20 6f 66 ult is a list of
2b40: 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 key-value pairs
2b50: 20 64 65 73 63 72 69 62 69 6e 67 0a 09 74 68 65 describing..the
2b60: 20 63 65 72 74 69 66 69 63 61 74 65 2e 20 49 66 certificate. If
2b70: 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 the result is a
2b80: 6e 20 65 6d 70 74 79 20 6c 69 73 74 20 74 68 65 n empty list the
2b90: 6e 20 74 68 65 0a 09 53 53 4c 20 68 61 6e 64 73 n the..SSL hands
2ba0: 68 61 6b 65 20 68 61 73 20 6e 6f 74 20 79 65 74 hake has not yet
2bb0: 20 63 6f 6d 70 6c 65 74 65 64 2e 20 49 66 20 3c completed. If <
2bc0: 65 6d 3e 2d 6c 6f 63 61 6c 3c 2f 65 6d 3e 20 69 em>-local</em> i
2bd0: 73 0a 09 73 70 65 63 69 66 69 65 64 2c 20 74 68 s..specified, th
2be0: 65 6e 20 74 68 65 20 6c 6f 63 61 6c 20 63 65 72 en the local cer
2bf0: 74 69 66 69 63 61 74 65 20 69 73 20 75 73 65 64 tificate is used
2c00: 2e 3c 2f 64 64 3e 0a 3c 62 6c 6f 63 6b 71 75 6f .</dd>.<blockquo
2c10: 74 65 3e 0a 09 3c 62 3e 53 53 4c 20 53 74 61 74 te>..<b>SSL Stat
2c20: 75 73 3c 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e 0a us</b>. <dl>.
2c30: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 61 6c 70 .<dt><strong>alp
2c40: 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 70 n</strong> <em>p
2c50: 72 6f 74 6f 63 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 rotocol</em></dt
2c60: 3e 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 6f >..<dd>The proto
2c70: 63 6f 6c 20 73 65 6c 65 63 74 65 64 20 61 66 74 col selected aft
2c80: 65 72 20 41 70 70 6c 69 63 61 74 69 6f 6e 2d 4c er Application-L
2c90: 61 79 65 72 20 50 72 6f 74 6f 63 6f 6c 0a 09 20 ayer Protocol..
2ca0: 20 20 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 28 Negotiation (
2cb0: 41 4c 50 4e 29 2e 3c 2f 64 64 3e 0a 09 3c 64 74 ALPN).</dd>..<dt
2cc0: 3e 3c 73 74 72 6f 6e 67 3e 63 69 70 68 65 72 3c ><strong>cipher<
2cd0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 69 70 /strong> <em>cip
2ce0: 68 65 72 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c her</em></dt>..<
2cf0: 64 64 3e 54 68 65 20 63 75 72 72 65 6e 74 20 63 dd>The current c
2d00: 69 70 68 65 72 20 69 6e 20 75 73 65 20 62 65 74 ipher in use bet
2d10: 77 65 65 6e 20 74 68 65 20 63 6c 69 65 6e 74 20 ween the client
2d20: 61 6e 64 0a 09 20 20 20 20 73 65 72 76 65 72 20 and.. server
2d30: 63 68 61 6e 6e 65 6c 73 2e 3c 2f 64 64 3e 0a 09 channels.</dd>..
2d40: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 65 65 72 <dt><strong>peer
2d50: 6e 61 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 name</strong> <e
2d60: 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e m>name</em></dt>
2d70: 0a 09 3c 64 64 3e 54 68 65 20 70 65 65 72 6e 61 ..<dd>The peerna
2d80: 6d 65 20 66 72 6f 6d 20 74 68 65 20 63 65 72 74 me from the cert
2d90: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c ificate.</dd>..<
2da0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 72 6f 74 6f dt><strong>proto
2db0: 63 6f 6c 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d col</strong> <em
2dc0: 3e 76 65 72 73 69 6f 6e 3c 2f 65 6d 3e 3c 2f 64 >version</em></d
2dd0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 t>..<dd>The prot
2de0: 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 ocol version use
2df0: 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 d for the connec
2e00: 74 69 6f 6e 3a 0a 09 20 20 20 20 53 53 4c 32 2c tion:.. SSL2,
2e10: 20 53 53 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 SSL3, TLS1, TLS
2e20: 31 2e 31 2c 20 54 4c 53 31 2e 32 2c 20 54 4c 53 1.1, TLS1.2, TLS
2e30: 31 2e 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 2e 1.3, or unknown.
2e40: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
2e50: 6e 67 3e 73 62 69 74 73 3c 2f 73 74 72 6f 6e 67 ng>sbits</strong
2e60: 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 > <em>n</em></dt
2e70: 3e 0a 09 3c 64 64 3e 54 68 65 20 6e 75 6d 62 65 >..<dd>The numbe
2e80: 72 20 6f 66 20 62 69 74 73 20 75 73 65 64 20 66 r of bits used f
2e90: 6f 72 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6b or the session k
2ea0: 65 79 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ey.</dd>..<dt><s
2eb0: 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 72 65 48 trong>signatureH
2ec0: 61 73 68 41 6c 67 6f 72 69 74 68 6d 3c 2f 73 74 ashAlgorithm</st
2ed0: 72 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 rong> <em>algori
2ee0: 74 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c thm</em></dt>..<
2ef0: 64 64 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 dd>The signature
2f00: 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 2e hash algorithm.
2f10: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
2f20: 6e 67 3e 73 69 67 6e 61 74 75 72 65 5f 74 79 70 ng>signature_typ
2f30: 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 74 e</strong> <em>t
2f40: 79 70 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ype</em></dt>..<
2f50: 64 64 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 dd>The signature
2f60: 20 74 79 70 65 20 76 61 6c 75 65 2e 3c 2f 64 64 type value.</dd
2f70: 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 76 >..<dt><strong>v
2f80: 65 72 69 66 69 63 61 74 69 6f 6e 3c 2f 73 74 72 erification</str
2f90: 6f 6e 67 3e 20 3c 65 6d 3e 72 65 73 75 6c 74 3c ong> <em>result<
2fa0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 /em></dt>..<dd>C
2fb0: 65 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 ertificate verif
2fc0: 69 63 61 74 69 6f 6e 20 72 65 73 75 6c 74 2e 3c ication result.<
2fd0: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
2fe0: 67 3e 63 61 5f 6e 61 6d 65 73 3c 2f 73 74 72 6f g>ca_names</stro
2ff0: 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f 65 6d ng> <em>list</em
3000: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 74 ></dt>..<dd>List
3010: 20 6f 66 20 74 68 65 20 43 65 72 74 69 66 69 63 of the Certific
3020: 61 74 65 20 41 75 74 68 6f 72 69 74 69 65 73 20 ate Authorities
3030: 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 used to create t
3040: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 2e 3c he certificate.<
3050: 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a 3c /dd>. </dl>.<
3060: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 6c /blockquote>.<bl
3070: 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e 43 65 ockquote>..<b>Ce
3080: 72 74 69 66 69 63 61 74 65 20 53 74 61 74 75 73 rtificate Status
3090: 3c 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e 0a 09 3c </b>. <dl>..<
30a0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 61 6c 6c 3c 2f dt><strong>all</
30b0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 strong> <em>stri
30c0: 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 ng</em></dt>..<d
30d0: 64 3e 44 75 6d 70 20 6f 66 20 61 6c 6c 20 63 65 d>Dump of all ce
30e0: 72 74 69 66 69 63 61 74 65 20 69 6e 66 6f 2e 3c rtificate info.<
30f0: 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f /dd>...<dt><stro
3100: 6e 67 3e 76 65 72 73 69 6f 6e 3c 2f 73 74 72 6f ng>version</stro
3110: 6e 67 3e 20 3c 65 6d 3e 76 61 6c 75 65 3c 2f 65 ng> <em>value</e
3120: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 m></dt>..<dd>The
3130: 20 63 65 72 74 69 66 69 63 61 74 65 20 76 65 72 certificate ver
3140: 73 69 6f 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e sion.</dd>..<dt>
3150: 3c 73 74 72 6f 6e 67 3e 73 65 72 69 61 6c 4e 75 <strong>serialNu
3160: 6d 62 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 mber</strong> <e
3170: 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c m>n</em></dt>..<
3180: 64 64 3e 54 68 65 20 73 65 72 69 61 6c 20 6e 75 dd>The serial nu
3190: 6d 62 65 72 20 6f 66 20 74 68 65 20 63 65 72 74 mber of the cert
31a0: 69 66 69 63 61 74 65 20 61 73 20 68 65 78 20 73 ificate as hex s
31b0: 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 09 3c 64 74 tring.</dd>..<dt
31c0: 3e 3c 73 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 ><strong>signatu
31d0: 72 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e re</strong> <em>
31e0: 61 6c 67 6f 72 69 74 68 6d 3c 2f 65 6d 3e 3c 2f algorithm</em></
31f0: 64 74 3e 0a 09 3c 64 64 3e 43 69 70 68 65 72 20 dt>..<dd>Cipher
3200: 61 6c 67 6f 72 69 74 68 6d 20 75 73 65 64 20 66 algorithm used f
3210: 6f 72 20 63 65 72 74 69 66 69 63 61 74 65 20 73 or certificate s
3220: 69 67 6e 61 74 75 72 65 2e 3c 2f 64 64 3e 0a 09 ignature.</dd>..
3230: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 73 73 75 <dt><strong>issu
3240: 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e er</strong> <em>
3250: 64 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 dn</em></dt>..<d
3260: 64 3e 54 68 65 20 64 69 73 74 69 6e 67 75 69 73 d>The distinguis
3270: 68 65 64 20 6e 61 6d 65 20 28 44 4e 29 20 6f 66 hed name (DN) of
3280: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
3290: 20 69 73 73 75 65 72 2e 3c 2f 64 64 3e 0a 09 3c issuer.</dd>..<
32a0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 6e 6f 74 42 65 dt><strong>notBe
32b0: 66 6f 72 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 fore</strong> <e
32c0: 6d 3e 64 61 74 65 3c 2f 65 6d 3e 3c 2f 64 74 3e m>date</em></dt>
32d0: 0a 09 3c 64 64 3e 54 68 65 20 62 65 67 69 6e 20 ..<dd>The begin
32e0: 64 61 74 65 20 66 6f 72 20 74 68 65 20 76 61 6c date for the val
32f0: 69 64 69 74 79 20 6f 66 20 74 68 65 20 63 65 72 idity of the cer
3300: 74 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 tificate.</dd>..
3310: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 6e 6f 74 41 <dt><strong>notA
3320: 66 74 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 fter</strong> <e
3330: 6d 3e 64 61 74 65 3c 2f 65 6d 3e 3c 2f 64 74 3e m>date</em></dt>
3340: 0a 09 3c 64 64 3e 54 68 65 20 65 78 70 69 72 61 ..<dd>The expira
3350: 74 69 6f 6e 20 64 61 74 65 20 66 6f 72 20 74 68 tion date for th
3360: 65 20 63 65 72 74 69 66 69 63 61 74 65 2e 3c 2f e certificate.</
3370: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
3380: 3e 73 75 62 6a 65 63 74 3c 2f 73 74 72 6f 6e 67 >subject</strong
3390: 3e 20 3c 65 6d 3e 64 6e 3c 2f 65 6d 3e 3c 2f 64 > <em>dn</em></d
33a0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 64 69 73 74 t>..<dd>The dist
33b0: 69 6e 67 75 69 73 68 65 64 20 6e 61 6d 65 20 28 inguished name (
33c0: 44 4e 29 20 6f 66 20 74 68 65 20 63 65 72 74 69 DN) of the certi
33d0: 66 69 63 61 74 65 20 73 75 62 6a 65 63 74 2e 0a ficate subject..
33e0: 09 20 20 20 20 46 69 65 6c 64 73 20 69 6e 63 6c . Fields incl
33f0: 75 64 65 3a 20 43 6f 6d 6d 6f 6e 20 4e 61 6d 65 ude: Common Name
3400: 20 28 43 4e 29 2c 20 4f 72 67 61 6e 69 7a 61 74 (CN), Organizat
3410: 69 6f 6e 20 28 4f 29 2c 20 4c 6f 63 61 6c 69 74 ion (O), Localit
3420: 79 0a 09 20 20 20 20 6f 72 20 43 69 74 79 20 28 y.. or City (
3430: 4c 29 2c 20 53 74 61 74 65 20 6f 72 20 50 72 6f L), State or Pro
3440: 76 69 6e 63 65 20 28 53 29 2c 20 61 6e 64 20 43 vince (S), and C
3450: 6f 75 6e 74 72 79 20 4e 61 6d 65 20 28 43 29 2e ountry Name (C).
3460: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
3470: 6e 67 3e 69 73 73 75 65 72 55 6e 69 71 75 65 49 ng>issuerUniqueI
3480: 44 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 D</strong> <em>s
3490: 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a tring</em></dt>.
34a0: 09 3c 64 64 3e 54 68 65 20 69 73 73 75 65 72 20 .<dd>The issuer
34b0: 75 6e 69 71 75 65 20 69 64 2e 3c 2f 64 64 3e 0a unique id.</dd>.
34c0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 .<dt><strong>sub
34d0: 6a 65 63 74 55 6e 69 71 75 65 49 44 3c 2f 73 74 jectUniqueID</st
34e0: 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 rong> <em>string
34f0: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
3500: 54 68 65 20 73 75 62 6a 65 63 74 20 75 6e 69 71 The subject uniq
3510: 75 65 20 69 64 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 ue id.</dd>...<d
3520: 74 3e 3c 73 74 72 6f 6e 67 3e 6e 75 6d 5f 65 78 t><strong>num_ex
3530: 74 65 6e 73 69 6f 6e 73 3c 2f 73 74 72 6f 6e 67 tensions</strong
3540: 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 > <em>n</em></dt
3550: 3e 0a 09 3c 64 64 3e 4e 75 6d 62 65 72 20 6f 66 >..<dd>Number of
3560: 20 63 65 72 74 69 66 69 63 61 74 65 20 65 78 74 certificate ext
3570: 65 6e 73 69 6f 6e 73 2e 3c 2f 64 64 3e 0a 09 3c ensions.</dd>..<
3580: 64 74 3e 3c 73 74 72 6f 6e 67 3e 65 78 74 65 6e dt><strong>exten
3590: 73 69 6f 6e 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c sions</strong> <
35a0: 65 6d 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 em>list</em></dt
35b0: 3e 0a 09 3c 64 64 3e 4c 69 73 74 20 6f 66 20 63 >..<dd>List of c
35c0: 65 72 74 69 66 69 63 61 74 65 20 65 78 74 65 6e ertificate exten
35d0: 73 69 6f 6e 20 6e 61 6d 65 73 2e 3c 2f 64 64 3e sion names.</dd>
35e0: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 61 75 ..<dt><strong>au
35f0: 74 68 6f 72 69 74 79 4b 65 79 49 64 65 6e 74 69 thorityKeyIdenti
3600: 66 69 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 fier</strong> <e
3610: 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 m>string</em></d
3620: 74 3e 0a 09 3c 64 64 3e 28 41 4b 49 29 20 4b 65 t>..<dd>(AKI) Ke
3630: 79 20 69 64 65 6e 74 69 66 69 65 72 20 6f 66 20 y identifier of
3640: 74 68 65 20 49 73 73 75 69 6e 67 20 43 41 20 63 the Issuing CA c
3650: 65 72 74 69 66 69 63 61 74 65 20 74 68 61 74 20 ertificate that
3660: 73 69 67 6e 65 64 0a 09 20 20 20 20 74 68 65 20 signed.. the
3670: 53 53 4c 20 63 65 72 74 69 66 69 63 61 74 65 20 SSL certificate
3680: 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 20 54 as hex string. T
3690: 68 69 73 20 76 61 6c 75 65 20 6d 61 74 63 68 65 his value matche
36a0: 73 20 74 68 65 20 53 4b 49 0a 09 20 20 20 20 76 s the SKI.. v
36b0: 61 6c 75 65 20 6f 66 20 74 68 65 20 49 6e 74 65 alue of the Inte
36c0: 72 6d 65 64 69 61 74 65 20 43 41 20 63 65 72 74 rmediate CA cert
36d0: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c ificate.</dd>..<
36e0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 6a 65 dt><strong>subje
36f0: 63 74 4b 65 79 49 64 65 6e 74 69 66 69 65 72 3c ctKeyIdentifier<
3700: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 /strong> <em>str
3710: 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ing</em></dt>..<
3720: 64 64 3e 28 53 4b 49 29 20 48 61 73 68 20 6f 66 dd>(SKI) Hash of
3730: 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 79 20 the public key
3740: 69 6e 73 69 64 65 20 74 68 65 20 63 65 72 74 69 inside the certi
3750: 66 69 63 61 74 65 20 61 73 20 68 65 78 0a 09 20 ficate as hex..
3760: 20 20 73 74 72 69 6e 67 2e 20 55 73 65 64 20 74 string. Used t
3770: 6f 20 69 64 65 6e 74 69 66 79 20 63 65 72 74 69 o identify certi
3780: 66 69 63 61 74 65 73 20 74 68 61 74 20 63 6f 6e ficates that con
3790: 74 61 69 6e 20 61 20 70 61 72 74 69 63 75 6c 61 tain a particula
37a0: 72 0a 09 20 20 20 70 75 62 6c 69 63 20 6b 65 79 r.. public key
37b0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
37c0: 6f 6e 67 3e 73 75 62 6a 65 63 74 41 6c 74 4e 61 ong>subjectAltNa
37d0: 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e me</strong> <em>
37e0: 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 list</em></dt>..
37f0: 3c 64 64 3e 4c 69 73 74 20 6f 66 20 61 6c 6c 20 <dd>List of all
3800: 6f 66 20 74 68 65 20 61 6c 74 65 72 6e 61 74 69 of the alternati
3810: 76 65 20 64 6f 6d 61 69 6e 20 6e 61 6d 65 73 2c ve domain names,
3820: 20 73 75 62 20 64 6f 6d 61 69 6e 73 2c 0a 09 20 sub domains,..
3830: 20 20 20 61 6e 64 20 49 50 20 61 64 64 72 65 73 and IP addres
3840: 73 65 73 20 74 68 61 74 20 61 72 65 20 73 65 63 ses that are sec
3850: 75 72 65 64 20 62 79 20 74 68 65 20 63 65 72 74 ured by the cert
3860: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c ificate.</dd>..<
3870: 64 74 3e 3c 73 74 72 6f 6e 67 3e 6f 63 73 70 3c dt><strong>ocsp<
3880: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 /strong> <em>lis
3890: 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 t</em></dt>..<dd
38a0: 3e 4c 69 73 74 20 6f 66 20 61 6c 6c 20 4f 6e 6c >List of all Onl
38b0: 69 6e 65 20 43 65 72 74 69 66 69 63 61 74 65 20 ine Certificate
38c0: 53 74 61 74 75 73 20 50 72 6f 74 6f 63 6f 6c 20 Status Protocol
38d0: 28 4f 43 53 50 29 20 55 52 4c 73 2e 3c 2f 64 64 (OCSP) URLs.</dd
38e0: 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e >...<dt><strong>
38f0: 63 65 72 74 69 66 69 63 61 74 65 3c 2f 73 74 72 certificate</str
3900: 6f 6e 67 3e 20 3c 65 6d 3e 63 65 72 74 3c 2f 65 ong> <em>cert</e
3910: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 m></dt>..<dd>The
3920: 20 50 45 4d 20 65 6e 63 6f 64 65 64 20 63 65 72 PEM encoded cer
3930: 74 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 0a tificate.</dd>..
3940: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 69 67 .<dt><strong>sig
3950: 6e 61 74 75 72 65 41 6c 67 6f 72 69 74 68 6d 3c natureAlgorithm<
3960: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 /strong> <em>alg
3970: 6f 72 69 74 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e orithm</em></dt>
3980: 0a 09 3c 64 64 3e 43 69 70 68 65 72 20 61 6c 67 ..<dd>Cipher alg
3990: 6f 72 69 74 68 6d 20 75 73 65 64 20 66 6f 72 20 orithm used for
39a0: 63 65 72 74 69 66 69 63 61 74 65 20 73 69 67 6e certificate sign
39b0: 61 74 75 72 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 ature.</dd>..<dt
39c0: 3e 3c 73 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 ><strong>signatu
39d0: 72 65 56 61 6c 75 65 3c 2f 73 74 72 6f 6e 67 3e reValue</strong>
39e0: 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e <em>string</em>
39f0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 65 72 74 69 </dt>..<dd>Certi
3a00: 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 ficate signature
3a10: 20 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c as hex string.<
3a20: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
3a30: 67 3e 73 69 67 6e 61 74 75 72 65 44 69 67 65 73 g>signatureDiges
3a40: 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 76 t</strong> <em>v
3a50: 65 72 73 69 6f 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e ersion</em></dt>
3a60: 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 61 74 ..<dd>Certificat
3a70: 65 20 73 69 67 6e 69 6e 67 20 64 69 67 65 73 74 e signing digest
3a80: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3a90: 6f 6e 67 3e 70 75 62 6c 69 63 4b 65 79 41 6c 67 ong>publicKeyAlg
3aa0: 6f 72 69 74 68 6d 3c 2f 73 74 72 6f 6e 67 3e 20 orithm</strong>
3ab0: 3c 65 6d 3e 61 6c 67 6f 72 69 74 68 6d 3c 2f 65 <em>algorithm</e
3ac0: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 65 72 m></dt>..<dd>Cer
3ad0: 74 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 tificate signatu
3ae0: 72 65 20 70 75 62 6c 69 63 20 6b 65 79 20 61 6c re public key al
3af0: 67 6f 72 69 74 68 6d 2e 3c 2f 64 64 3e 0a 09 3c gorithm.</dd>..<
3b00: 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 75 62 6c 69 dt><strong>publi
3b10: 63 4b 65 79 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 cKey</strong> <e
3b20: 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 m>string</em></d
3b30: 74 3e 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 t>..<dd>Certific
3b40: 61 74 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 ate signature pu
3b50: 62 6c 69 63 20 6b 65 79 20 61 73 20 68 65 78 20 blic key as hex
3b60: 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 09 3c 64 string.</dd>..<d
3b70: 74 3e 3c 73 74 72 6f 6e 67 3e 62 69 74 73 3c 2f t><strong>bits</
3b80: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 strong> <em>n</e
3b90: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4e 75 6d m></dt>..<dd>Num
3ba0: 62 65 72 20 6f 66 20 62 69 74 73 20 75 73 65 64 ber of bits used
3bb0: 20 66 6f 72 20 63 65 72 74 69 66 69 63 61 74 65 for certificate
3bc0: 20 73 69 67 6e 61 74 75 72 65 20 6b 65 79 3c 2f signature key</
3bd0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
3be0: 3e 73 65 6c 66 5f 73 69 67 6e 65 64 3c 2f 73 74 >self_signed</st
3bf0: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 61 rong> <em>boolea
3c00: 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 n</em></dt>..<dd
3c10: 3e 49 73 20 63 65 72 74 69 66 69 63 61 74 65 20 >Is certificate
3c20: 73 69 67 6e 61 74 75 72 65 20 73 65 6c 66 20 73 signature self s
3c30: 69 67 6e 65 64 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 igned.</dd>...<d
3c40: 74 3e 3c 73 74 72 6f 6e 67 3e 73 68 61 31 5f 68 t><strong>sha1_h
3c50: 61 73 68 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ash</strong> <em
3c60: 3e 68 61 73 68 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >hash</em></dt>.
3c70: 09 3c 64 64 3e 54 68 65 20 53 48 41 31 20 68 61 .<dd>The SHA1 ha
3c80: 73 68 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 sh of the certif
3c90: 69 63 61 74 65 20 61 73 20 68 65 78 20 73 74 72 icate as hex str
3ca0: 69 6e 67 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c ing.</dd>..<dt><
3cb0: 73 74 72 6f 6e 67 3e 73 68 61 32 35 36 5f 68 61 strong>sha256_ha
3cc0: 73 68 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e sh</strong> <em>
3cd0: 68 61 73 68 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 hash</em></dt>..
3ce0: 3c 64 64 3e 54 68 65 20 53 48 41 32 35 36 20 68 <dd>The SHA256 h
3cf0: 61 73 68 20 6f 66 20 74 68 65 20 63 65 72 74 69 ash of the certi
3d00: 66 69 63 61 74 65 20 61 73 20 68 65 78 20 73 74 ficate as hex st
3d10: 72 69 6e 67 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c ring.</dd>. <
3d20: 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 /dl>.</blockquot
3d30: 65 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e e>.. <dt><a n
3d40: 61 6d 65 3d 22 74 6c 73 3a 3a 63 6f 6e 6e 65 63 ame="tls::connec
3d50: 74 69 6f 6e 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c tion"><strong>tl
3d60: 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 73 s::connection</s
3d70: 74 72 6f 6e 67 3e 0a 20 20 20 20 3c 65 6d 3e 63 trong>. <em>c
3d80: 68 61 6e 6e 65 6c 3c 2f 65 6d 3e 3c 2f 61 3e 3c hannel</em></a><
3d90: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 /dt>. <dd>Ret
3da0: 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e 74 urns the current
3db0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 74 61 74 connection stat
3dc0: 75 73 20 6f 66 20 61 6e 20 53 53 4c 20 63 68 61 us of an SSL cha
3dd0: 6e 6e 65 6c 2e 20 54 68 65 0a 09 72 65 73 75 6c nnel. The..resul
3de0: 74 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 6b t is a list of k
3df0: 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 20 64 ey-value pairs d
3e00: 65 73 63 72 69 62 69 6e 67 20 74 68 65 0a 09 63 escribing the..c
3e10: 6f 6e 6e 65 63 74 65 64 20 70 65 65 72 2e 3c 2f onnected peer.</
3e20: 64 64 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e dd>.<blockquote>
3e30: 0a 09 3c 62 3e 53 53 4c 20 53 74 61 74 75 73 3c ..<b>SSL Status<
3e40: 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e 0a 09 3c 64 /b>. <dl>..<d
3e50: 74 3e 3c 73 74 72 6f 6e 67 3e 73 74 61 74 65 3c t><strong>state<
3e60: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 61 /strong> <em>sta
3e70: 74 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 te</em></dt>..<d
3e80: 64 3e 53 74 61 74 65 20 6f 66 20 74 68 65 20 63 d>State of the c
3e90: 6f 6e 6e 65 63 74 69 6f 6e 2e 3c 2f 64 64 3e 0a onnection.</dd>.
3ea0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 72 .<dt><strong>ser
3eb0: 76 65 72 6e 61 6d 65 3c 2f 73 74 72 6f 6e 67 3e vername</strong>
3ec0: 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f <em>name</em></
3ed0: 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 6e 61 6d dt>..<dd>The nam
3ee0: 65 20 6f 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 e of the connect
3ef0: 65 64 20 74 6f 20 73 65 72 76 65 72 2e 3c 2f 64 ed to server.</d
3f00: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
3f10: 70 72 6f 74 6f 63 6f 6c 3c 2f 73 74 72 6f 6e 67 protocol</strong
3f20: 3e 20 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c 2f 65 > <em>version</e
3f30: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 m></dt>..<dd>The
3f40: 20 70 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f protocol versio
3f50: 6e 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 63 n used for the c
3f60: 6f 6e 6e 65 63 74 69 6f 6e 3a 0a 09 20 20 20 20 onnection:..
3f70: 53 53 4c 32 2c 20 53 53 4c 33 2c 20 54 4c 53 31 SSL2, SSL3, TLS1
3f80: 2c 20 54 4c 53 31 2e 31 2c 20 54 4c 53 31 2e 32 , TLS1.1, TLS1.2
3f90: 2c 20 54 4c 53 31 2e 33 2c 20 6f 72 20 75 6e 6b , TLS1.3, or unk
3fa0: 6e 6f 77 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e nown.</dd>..<dt>
3fb0: 3c 73 74 72 6f 6e 67 3e 72 65 6e 65 67 6f 74 69 <strong>renegoti
3fc0: 61 74 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c ation</strong> <
3fd0: 65 6d 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c em>boolean</em><
3fe0: 2f 64 74 3e 0a 09 3c 64 64 3e 57 68 65 74 68 65 /dt>..<dd>Whethe
3ff0: 72 20 70 72 6f 74 6f 63 6f 6c 20 72 65 6e 65 67 r protocol reneg
4000: 6f 74 69 61 74 69 6f 6e 20 69 73 20 73 75 70 70 otiation is supp
4010: 6f 72 74 65 64 20 6f 72 20 6e 6f 74 2e 3c 2f 64 orted or not.</d
4020: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
4030: 73 65 63 75 72 69 74 79 6c 65 76 65 6c 3c 2f 73 securitylevel</s
4040: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 65 76 65 6c trong> <em>level
4050: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
4060: 54 68 65 20 73 65 63 75 72 69 74 79 20 6c 65 76 The security lev
4070: 65 6c 20 75 73 65 64 20 66 6f 72 20 73 65 6c 65 el used for sele
4080: 63 74 69 6f 6e 20 6f 66 20 63 69 70 68 65 72 73 ction of ciphers
4090: 2c 20 6b 65 79 20 73 69 7a 65 2c 20 65 74 63 2e , key size, etc.
40a0: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
40b0: 6e 67 3e 73 65 73 73 69 6f 6e 5f 72 65 75 73 65 ng>session_reuse
40c0: 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 d</strong> <em>b
40d0: 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e oolean</em></dt>
40e0: 0a 09 3c 64 64 3e 57 68 65 74 68 65 72 20 74 68 ..<dd>Whether th
40f0: 65 20 73 65 73 73 69 6f 6e 20 68 61 73 20 62 65 e session has be
4100: 65 6e 20 72 65 75 73 65 64 20 6f 72 20 6e 6f 74 en reused or not
4110: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4120: 6f 6e 67 3e 69 73 5f 73 65 72 76 65 72 3c 2f 73 ong>is_server</s
4130: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 trong> <em>boole
4140: 61 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 an</em></dt>..<d
4150: 64 3e 57 68 65 74 68 65 72 20 74 68 65 20 63 6f d>Whether the co
4160: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 6f 6e 66 nnection is conf
4170: 69 67 75 72 65 64 20 61 73 20 61 20 73 65 72 76 igured as a serv
4180: 65 72 20 28 31 29 20 6f 72 20 63 6c 69 65 6e 74 er (1) or client
4190: 20 28 30 29 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e (0).</dd>..<dt>
41a0: 3c 73 74 72 6f 6e 67 3e 63 6f 6d 70 72 65 73 73 <strong>compress
41b0: 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ion</strong> <em
41c0: 3e 6d 6f 64 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >mode</em></dt>.
41d0: 09 3c 64 64 3e 43 6f 6d 70 72 65 73 73 69 6f 6e .<dd>Compression
41e0: 20 6d 65 74 68 6f 64 2e 3c 2f 64 64 3e 0a 09 3c method.</dd>..<
41f0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 65 78 70 61 6e dt><strong>expan
4200: 73 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 sion</strong> <e
4210: 6d 3e 6d 6f 64 65 3c 2f 65 6d 3e 3c 2f 64 74 3e m>mode</em></dt>
4220: 0a 09 3c 64 64 3e 45 78 70 61 6e 73 69 6f 6e 20 ..<dd>Expansion
4230: 6d 65 74 68 6f 64 2e 3c 2f 64 64 3e 0a 20 20 20 method.</dd>.
4240: 20 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 </dl>.</blockqu
4250: 6f 74 65 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 ote>.<blockquote
4260: 3e 0a 09 3c 62 3e 43 69 70 68 65 72 20 49 6e 66 >..<b>Cipher Inf
4270: 6f 3c 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e 0a 09 o</b>. <dl>..
4280: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 63 69 70 68 <dt><strong>ciph
4290: 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e er</strong> <em>
42a0: 63 69 70 68 65 72 3c 2f 65 6d 3e 3c 2f 64 74 3e cipher</em></dt>
42b0: 0a 09 3c 64 64 3e 54 68 65 20 63 75 72 72 65 6e ..<dd>The curren
42c0: 74 20 63 69 70 68 65 72 20 69 6e 20 75 73 65 20 t cipher in use
42d0: 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 for the connecti
42e0: 6f 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 on.</dd>..<dt><s
42f0: 74 72 6f 6e 67 3e 73 74 61 6e 64 61 72 64 5f 6e trong>standard_n
4300: 61 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ame</strong> <em
4310: 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >name</em></dt>.
4320: 09 3c 64 64 3e 54 68 65 20 73 74 61 6e 64 61 72 .<dd>The standar
4330: 64 20 52 46 43 20 6e 61 6d 65 20 6f 66 20 63 69 d RFC name of ci
4340: 70 68 65 72 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e pher.</dd>..<dt>
4350: 3c 73 74 72 6f 6e 67 3e 62 69 74 73 3c 2f 73 74 <strong>bits</st
4360: 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e rong> <em>n</em>
4370: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 6e </dt>..<dd>The n
4380: 75 6d 62 65 72 20 6f 66 20 70 72 6f 63 65 73 73 umber of process
4390: 65 64 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 ed bits used for
43a0: 20 63 69 70 68 65 72 2e 3c 2f 64 64 3e 0a 09 3c cipher.</dd>..<
43b0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 63 72 65 dt><strong>secre
43c0: 74 5f 62 69 74 73 3c 2f 73 74 72 6f 6e 67 3e 20 t_bits</strong>
43d0: 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a <em>n</em></dt>.
43e0: 09 3c 64 64 3e 54 68 65 20 6e 75 6d 62 65 72 20 .<dd>The number
43f0: 6f 66 20 73 65 63 72 65 74 20 62 69 74 73 20 75 of secret bits u
4400: 73 65 64 20 66 6f 72 20 63 69 70 68 65 72 2e 3c sed for cipher.<
4410: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
4420: 67 3e 6d 69 6e 5f 76 65 72 73 69 6f 6e 3c 2f 73 g>min_version</s
4430: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 76 65 72 73 69 trong> <em>versi
4440: 6f 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 on</em></dt>..<d
4450: 64 3e 54 68 65 20 6d 69 6e 69 6d 75 6d 20 70 72 d>The minimum pr
4460: 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 66 otocol version f
4470: 6f 72 20 63 69 70 68 65 72 2e 3c 2f 64 64 3e 0a or cipher.</dd>.
4480: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 64 3c .<dt><strong>id<
4490: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 69 64 3c /strong> <em>id<
44a0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
44b0: 68 65 20 4f 70 65 6e 53 53 4c 20 63 69 70 68 65 he OpenSSL ciphe
44c0: 72 20 69 64 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e r id.</dd>..<dt>
44d0: 3c 73 74 72 6f 6e 67 3e 64 65 73 63 72 69 70 74 <strong>descript
44e0: 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ion</strong> <em
44f0: 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 >string</em></dt
4500: 3e 0a 09 3c 64 64 3e 41 20 74 65 78 74 20 64 65 >..<dd>A text de
4510: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 scription of the
4520: 20 63 69 70 68 65 72 2e 3c 2f 64 64 3e 0a 20 20 cipher.</dd>.
4530: 20 20 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 </dl>.</blockq
4540: 75 6f 74 65 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 uote>.<blockquot
4550: 65 3e 0a 09 3c 62 3e 53 65 73 73 69 6f 6e 20 49 e>..<b>Session I
4560: 6e 66 6f 3c 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e nfo</b>. <dl>
4570: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 61 6c ..<dt><strong>al
4580: 70 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e pn</strong> <em>
4590: 70 72 6f 74 6f 63 6f 6c 3c 2f 65 6d 3e 3c 2f 64 protocol</em></d
45a0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 t>..<dd>The prot
45b0: 6f 63 6f 6c 20 73 65 6c 65 63 74 65 64 20 61 66 ocol selected af
45c0: 74 65 72 20 41 70 70 6c 69 63 61 74 69 6f 6e 2d ter Application-
45d0: 4c 61 79 65 72 20 50 72 6f 74 6f 63 6f 6c 0a 09 Layer Protocol..
45e0: 20 20 20 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 Negotiation
45f0: 28 41 4c 50 4e 29 2e 3c 2f 64 64 3e 0a 09 3c 64 (ALPN).</dd>..<d
4600: 74 3e 3c 73 74 72 6f 6e 67 3e 72 65 73 75 6d 61 t><strong>resuma
4610: 62 6c 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ble</strong> <em
4620: 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c 2f 64 >boolean</em></d
4630: 74 3e 0a 09 3c 64 64 3e 43 61 6e 20 74 68 65 20 t>..<dd>Can the
4640: 73 65 73 73 69 6f 6e 20 62 65 20 72 65 73 75 6d session be resum
4650: 65 64 20 6f 72 20 6e 6f 74 2e 3c 2f 64 64 3e 0a ed or not.</dd>.
4660: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 74 61 .<dt><strong>sta
4670: 72 74 5f 74 69 6d 65 3c 2f 73 74 72 6f 6e 67 3e rt_time</strong>
4680: 20 3c 65 6d 3e 73 65 63 6f 6e 64 73 3c 2f 65 6d <em>seconds</em
4690: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 69 6d 65 ></dt>..<dd>Time
46a0: 20 73 69 6e 63 65 20 73 65 73 73 69 6f 6e 20 73 since session s
46b0: 74 61 72 74 65 64 20 69 6e 20 73 65 63 6f 6e 64 tarted in second
46c0: 73 20 73 69 6e 63 65 20 65 70 6f 63 68 2e 3c 2f s since epoch.</
46d0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
46e0: 3e 74 69 6d 65 6f 75 74 3c 2f 73 74 72 6f 6e 67 >timeout</strong
46f0: 3e 20 3c 65 6d 3e 73 65 63 6f 6e 64 73 3c 2f 65 > <em>seconds</e
4700: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4d 61 78 m></dt>..<dd>Max
4710: 20 64 75 72 61 74 69 6f 6e 20 6f 66 20 73 65 73 duration of ses
4720: 73 69 6f 6e 20 69 6e 20 73 65 63 6f 6e 64 73 20 sion in seconds
4730: 62 65 66 6f 72 65 20 74 69 6d 65 2d 6f 75 74 2e before time-out.
4740: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
4750: 6e 67 3e 6c 69 66 65 74 69 6d 65 3c 2f 73 74 72 ng>lifetime</str
4760: 6f 6e 67 3e 20 3c 65 6d 3e 73 65 63 6f 6e 64 73 ong> <em>seconds
4770: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
4780: 53 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 6c Session ticket l
4790: 69 66 65 74 69 6d 65 20 68 69 6e 74 20 69 6e 20 ifetime hint in
47a0: 73 65 63 6f 6e 64 73 2e 3c 2f 64 64 3e 0a 09 3c seconds.</dd>..<
47b0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 73 73 69 dt><strong>sessi
47c0: 6f 6e 5f 69 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c on_id</strong> <
47d0: 65 6d 3e 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 em>binary_string
47e0: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
47f0: 55 6e 69 71 75 65 20 73 65 73 73 69 6f 6e 20 69 Unique session i
4800: 64 20 66 6f 72 20 75 73 65 20 69 6e 20 72 65 73 d for use in res
4810: 75 6d 69 6e 67 20 74 68 65 20 73 65 73 73 69 6f uming the sessio
4820: 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 n.</dd>..<dt><st
4830: 72 6f 6e 67 3e 73 65 73 73 69 6f 6e 5f 74 69 63 rong>session_tic
4840: 6b 65 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ket</strong> <em
4850: 3e 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 3c 2f >binary_string</
4860: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 55 6e em></dt>..<dd>Un
4870: 69 71 75 65 20 73 65 73 73 69 6f 6e 20 74 69 63 ique session tic
4880: 6b 65 74 20 66 6f 72 20 75 73 65 20 69 6e 20 72 ket for use in r
4890: 65 73 75 6d 69 6e 67 20 74 68 65 20 73 65 73 73 esuming the sess
48a0: 69 6f 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c ion.</dd>..<dt><
48b0: 73 74 72 6f 6e 67 3e 74 69 63 6b 65 74 5f 61 70 strong>ticket_ap
48c0: 70 5f 64 61 74 61 3c 2f 73 74 72 6f 6e 67 3e 20 p_data</strong>
48d0: 3c 65 6d 3e 62 69 6e 61 72 79 5f 73 74 72 69 6e <em>binary_strin
48e0: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
48f0: 3e 55 6e 69 71 75 65 20 73 65 73 73 69 6f 6e 20 >Unique session
4900: 74 69 63 6b 65 74 20 61 70 70 6c 69 63 61 74 69 ticket applicati
4910: 6f 6e 20 64 61 74 61 2e 3c 2f 64 64 3e 0a 09 3c on data.</dd>..<
4920: 64 74 3e 3c 73 74 72 6f 6e 67 3e 6d 61 73 74 65 dt><strong>maste
4930: 72 5f 6b 65 79 3c 2f 73 74 72 6f 6e 67 3e 20 3c r_key</strong> <
4940: 65 6d 3e 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 em>binary_string
4950: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
4960: 55 6e 69 71 75 65 20 73 65 73 73 69 6f 6e 20 6d Unique session m
4970: 61 73 74 65 72 20 6b 65 79 2e 3c 2f 64 64 3e 0a aster key.</dd>.
4980: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 73 .<dt><strong>ses
4990: 73 69 6f 6e 5f 63 61 63 68 65 5f 6d 6f 64 65 3c sion_cache_mode<
49a0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6d 6f 64 /strong> <em>mod
49b0: 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 e</em></dt>..<dd
49c0: 3e 53 65 72 76 65 72 20 63 61 63 68 65 20 6d 6f >Server cache mo
49d0: 64 65 20 28 63 6c 69 65 6e 74 2c 20 73 65 72 76 de (client, serv
49e0: 65 72 2c 20 6f 72 20 62 6f 74 68 29 2e 3c 2f 64 er, or both).</d
49f0: 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a 3c 2f 62 d>. </dl>.</b
4a00: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 20 lockquote>..
4a10: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
4a20: 3a 3a 63 69 70 68 65 72 73 22 3e 3c 73 74 72 6f ::ciphers"><stro
4a30: 6e 67 3e 74 6c 73 3a 3a 63 69 70 68 65 72 73 3c ng>tls::ciphers<
4a40: 2f 73 74 72 6f 6e 67 3e 0a 20 20 20 20 3c 65 6d /strong>. <em
4a50: 3e 70 72 6f 74 6f 63 6f 6c 20 3f 76 65 72 62 6f >protocol ?verbo
4a60: 73 65 3f 20 3f 73 75 70 70 6f 72 74 65 64 3f 3c se? ?supported?<
4a70: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
4a80: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 61 20 <dd>Returns a
4a90: 6c 69 73 74 20 6f 66 20 73 75 70 70 6f 72 74 65 list of supporte
4aa0: 64 20 63 69 70 68 65 72 73 20 61 76 61 69 6c 61 d ciphers availa
4ab0: 62 6c 65 20 66 6f 72 20 3c 65 6d 3e 70 72 6f 74 ble for <em>prot
4ac0: 6f 63 6f 6c 3c 2f 65 6d 3e 2c 0a 09 77 68 65 72 ocol</em>,..wher
4ad0: 65 20 70 72 6f 74 6f 63 6f 6c 20 6d 75 73 74 20 e protocol must
4ae0: 62 65 20 6f 6e 65 20 6f 66 20 3c 62 3e 73 73 6c be one of <b>ssl
4af0: 32 2c 20 73 73 6c 33 2c 20 74 6c 73 31 2c 20 74 2, ssl3, tls1, t
4b00: 6c 73 31 2e 31 2c 0a 09 74 6c 73 31 2e 32 2c 3c ls1.1,..tls1.2,<
4b10: 2f 62 3e 20 6f 72 20 3c 62 3e 74 6c 73 31 2e 33 /b> or <b>tls1.3
4b20: 3c 2f 62 3e 2e 20 49 66 20 3c 65 6d 3e 76 65 72 </b>. If <em>ver
4b30: 62 6f 73 65 3c 2f 65 6d 3e 20 69 73 20 73 70 65 bose</em> is spe
4b40: 63 69 66 69 65 64 20 61 73 0a 09 74 72 75 65 20 cified as..true
4b50: 74 68 65 6e 20 61 20 76 65 72 62 6f 73 65 2c 20 then a verbose,
4b60: 68 75 6d 61 6e 20 72 65 61 64 61 62 6c 65 20 6c human readable l
4b70: 69 73 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 ist is returned
4b80: 77 69 74 68 0a 09 61 64 64 69 74 69 6f 6e 61 6c with..additional
4b90: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 information on
4ba0: 74 68 65 20 63 69 70 68 65 72 2e 20 49 66 20 3c the cipher. If <
4bb0: 65 6d 3e 73 75 70 70 6f 72 74 65 64 3c 2f 65 6d em>supported</em
4bc0: 3e 0a 09 69 73 20 73 70 65 63 69 66 69 65 64 20 >..is specified
4bd0: 61 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e as true, then on
4be0: 6c 79 20 74 68 65 20 63 69 70 68 65 72 73 20 73 ly the ciphers s
4bf0: 75 70 70 6f 72 74 65 64 20 66 6f 72 20 70 72 6f upported for pro
4c00: 74 6f 63 6f 6c 0a 09 77 69 6c 6c 20 62 65 20 6c tocol..will be l
4c10: 69 73 74 65 64 2e 3c 2f 64 64 3e 0a 0a 20 20 20 isted.</dd>..
4c20: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
4c30: 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 22 3e 3c 73 s::protocols"><s
4c40: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 72 6f 74 6f trong>tls::proto
4c50: 63 6f 6c 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 cols</strong></a
4c60: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 ></dt>. <dd>R
4c70: 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 eturns a list of
4c80: 20 73 75 70 70 6f 72 74 65 64 20 70 72 6f 74 6f supported proto
4c90: 63 6f 6c 73 2e 20 56 61 6c 69 64 20 76 61 6c 75 cols. Valid valu
4ca0: 65 73 20 61 72 65 3a 0a 09 3c 62 3e 73 73 6c 32 es are:..<b>ssl2
4cb0: 3c 2f 62 3e 2c 20 3c 62 3e 73 73 6c 33 3c 2f 62 </b>, <b>ssl3</b
4cc0: 3e 2c 20 3c 62 3e 74 6c 73 31 3c 2f 62 3e 2c 20 >, <b>tls1</b>,
4cd0: 3c 62 3e 74 6c 73 31 2e 31 3c 2f 62 3e 2c 20 3c <b>tls1.1</b>, <
4ce0: 62 3e 74 6c 73 31 2e 32 3c 2f 62 3e 2c 0a 09 61 b>tls1.2</b>,..a
4cf0: 6e 64 20 3c 62 3e 74 6c 73 31 2e 33 3c 2f 62 3e nd <b>tls1.3</b>
4d00: 2e 20 45 78 61 63 74 20 6c 69 73 74 20 64 65 70 . Exact list dep
4d10: 65 6e 64 73 20 6f 6e 20 4f 70 65 6e 53 53 4c 20 ends on OpenSSL
4d20: 76 65 72 73 69 6f 6e 20 61 6e 64 0a 09 63 6f 6d version and..com
4d30: 70 69 6c 65 20 74 69 6d 65 20 66 6c 61 67 73 2e pile time flags.
4d40: 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c </dd>.. <dt><
4d50: 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 76 65 72 a name="tls::ver
4d60: 73 69 6f 6e 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c sion"><strong>tl
4d70: 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 73 74 72 6f s::version</stro
4d80: 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 ng></a></dt>.
4d90: 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 65 <dd>Returns the
4da0: 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 69 6f 6e OpenSSL version
4db0: 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 3c 2f string.</dd>.</
4dc0: 64 6c 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 dl>..<h3><a name
4dd0: 3d 22 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f ="CALLBACK OPTIO
4de0: 4e 53 22 3e 43 41 4c 4c 42 41 43 4b 20 4f 50 54 NS">CALLBACK OPT
4df0: 49 4f 4e 53 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c IONS</a></h3>..<
4e00: 70 3e 0a 41 73 20 69 6e 64 69 63 61 74 65 64 20 p>.As indicated
4e10: 61 62 6f 76 65 2c 20 69 6e 64 69 76 69 64 75 61 above, individua
4e20: 6c 20 63 68 61 6e 6e 65 6c 73 20 63 61 6e 20 62 l channels can b
4e30: 65 20 67 69 76 65 6e 20 74 68 65 69 72 20 6f 77 e given their ow
4e40: 6e 20 63 61 6c 6c 62 61 63 6b 73 0a 74 6f 20 68 n callbacks.to h
4e50: 61 6e 64 6c 65 20 69 6e 74 65 72 6d 65 64 69 61 andle intermedia
4e60: 74 65 20 70 72 6f 63 65 73 73 69 6e 67 20 62 79 te processing by
4e70: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 6c 69 62 the OpenSSL lib
4e80: 72 61 72 79 2c 20 75 73 69 6e 67 20 74 68 65 0a rary, using the.
4e90: 3c 73 74 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 <strong>-command
4ea0: 3c 2f 73 74 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f </strong>, <stro
4eb0: 6e 67 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 ng>-password</st
4ec0: 72 6f 6e 67 3e 2c 20 61 6e 64 0a 3c 73 74 72 6f rong>, and.<stro
4ed0: 6e 67 3e 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d ng>-validate_com
4ee0: 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 6f 70 mand</strong> op
4ef0: 74 69 6f 6e 73 20 70 61 73 73 65 64 20 74 6f 20 tions passed to
4f00: 65 69 74 68 65 72 20 6f 66 0a 3c 73 74 72 6f 6e either of.<stron
4f10: 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 73 g>tls::socket</s
4f20: 74 72 6f 6e 67 3e 20 6f 72 20 3c 73 74 72 6f 6e trong> or <stron
4f30: 67 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 3c 2f 73 g>tls::import</s
4f40: 74 72 6f 6e 67 3e 2e 0a 49 66 20 74 68 65 20 63 trong>..If the c
4f50: 61 6c 6c 62 61 63 6b 20 67 65 6e 65 72 61 74 65 allback generate
4f60: 73 20 61 6e 20 65 72 72 6f 72 2c 20 74 68 65 20 s an error, the
4f70: 3c 62 3e 62 67 65 72 72 6f 72 3c 2f 62 3e 20 63 <b>bgerror</b> c
4f80: 6f 6d 6d 61 6e 64 20 77 69 74 68 20 62 65 0a 69 ommand with be.i
4f90: 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20 nvoked with the
4fa0: 65 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f error informatio
4fb0: 6e 2e 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 n..</p>..<blockq
4fc0: 75 6f 74 65 3e 0a 3c 64 6c 3e 0a 0a 20 20 20 20 uote>.<dl>..
4fd0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 6f 6d <dt><strong>-com
4fe0: 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 mand</strong> <e
4ff0: 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 3c m>callback</em><
5000: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 0a 09 49 /dt>. <dd>..I
5010: 6e 76 6f 6b 65 73 20 74 68 65 20 73 70 65 63 69 nvokes the speci
5020: 66 69 65 64 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 fied <em>callbac
5030: 6b 3c 2f 65 6d 3e 20 73 63 72 69 70 74 20 61 74 k</em> script at
5040: 20 73 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 0a several points.
5050: 09 64 75 72 69 6e 67 20 74 68 65 20 4f 70 65 6e .during the Open
5060: 53 53 4c 20 68 61 6e 64 73 68 61 6b 65 20 61 6e SSL handshake an
5070: 64 20 75 73 65 2e 20 53 65 65 20 62 65 6c 6f 77 d use. See below
5080: 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 6c for the possibl
5090: 65 0a 09 61 72 67 75 6d 65 6e 74 73 20 70 61 73 e..arguments pas
50a0: 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 62 sed to the callb
50b0: 61 63 6b 20 73 63 72 69 70 74 2e 20 56 61 6c 75 ack script. Valu
50c0: 65 73 20 72 65 74 75 72 6e 65 64 20 66 72 6f 6d es returned from
50d0: 20 74 68 65 0a 09 63 61 6c 6c 62 61 63 6b 20 61 the..callback a
50e0: 72 65 20 69 67 6e 6f 72 65 64 2e 0a 0a 09 3c 62 re ignored....<b
50f0: 72 3e 0a 09 3c 62 72 3e 0a 0a 09 3c 64 6c 3e 0a r>..<br>...<dl>.
5100: 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e ..<dt>.. <stron
5110: 67 3e 65 72 72 6f 72 3c 2f 73 74 72 6f 6e 67 3e g>error</strong>
5120: 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 6d 65 73 <em>channel mes
5130: 73 61 67 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e sage</em>..</dt>
5140: 0a 09 3c 64 64 3e 0a 09 20 20 54 68 65 20 3c 65 ..<dd>.. The <e
5150: 6d 3e 6d 65 73 73 61 67 65 3c 2f 65 6d 3e 20 61 m>message</em> a
5160: 72 67 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 rgument contains
5170: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 an error messag
5180: 65 20 67 65 6e 65 72 61 74 65 64 0a 09 20 20 62 e generated.. b
5190: 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 y the OpenSSL fu
51a0: 6e 63 74 69 6f 6e 20 3c 63 6f 64 65 3e 45 52 52 nction <code>ERR
51b0: 5f 72 65 61 73 6f 6e 5f 65 72 72 6f 72 5f 73 74 _reason_error_st
51c0: 72 69 6e 67 28 29 3c 2f 63 6f 64 65 3e 2e 0a 09 ring()</code>...
51d0: 3c 2f 64 64 3e 0a 0a 09 3c 62 72 3e 0a 0a 09 3c </dd>...<br>...<
51e0: 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 69 dt>.. <strong>i
51f0: 6e 66 6f 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d nfo</strong> <em
5200: 3e 63 68 61 6e 6e 65 6c 20 6d 61 6a 6f 72 20 6d >channel major m
5210: 69 6e 6f 72 20 6d 65 73 73 61 67 65 20 74 79 70 inor message typ
5220: 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c e</em>..</dt>..<
5230: 64 64 3e 0a 09 20 20 54 68 69 73 20 66 6f 72 6d dd>.. This form
5240: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
5250: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f invoked by the O
5260: 70 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a penSSL function.
5270: 09 20 20 3c 63 6f 64 65 3e 53 53 4c 5f 43 54 58 . <code>SSL_CTX
5280: 5f 73 65 74 5f 69 6e 66 6f 5f 63 61 6c 6c 62 61 _set_info_callba
5290: 63 6b 28 29 3c 2f 63 6f 64 65 3e 20 64 75 72 69 ck()</code> duri
52a0: 6e 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 65 ng connection se
52b0: 74 75 70 0a 09 20 20 61 6e 64 20 75 73 65 2e 0a tup.. and use..
52c0: 09 20 20 3c 62 72 3e 0a 09 20 20 3c 75 6c 3e 0a . <br>.. <ul>.
52d0: 09 20 20 3c 6c 69 3e 50 6f 73 73 69 62 6c 65 20 . <li>Possible
52e0: 76 61 6c 75 65 73 20 66 6f 72 20 3c 65 6d 3e 6d values for <em>m
52f0: 61 6a 6f 72 3c 2f 65 6d 3e 20 61 72 65 3a 0a 09 ajor</em> are:..
5300: 20 20 3c 63 6f 64 65 3e 68 61 6e 64 73 68 61 6b <code>handshak
5310: 65 2c 20 61 6c 65 72 74 2c 20 63 6f 6e 6e 65 63 e, alert, connec
5320: 74 2c 20 61 63 63 65 70 74 3c 2f 63 6f 64 65 3e t, accept</code>
5330: 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 50 6f .</li>.. <li>Po
5340: 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f ssible values fo
5350: 72 20 3c 65 6d 3e 6d 69 6e 6f 72 3c 2f 65 6d 3e r <em>minor</em>
5360: 20 61 72 65 3a 0a 09 20 20 3c 63 6f 64 65 3e 73 are:.. <code>s
5370: 74 61 72 74 2c 20 64 6f 6e 65 2c 20 72 65 61 64 tart, done, read
5380: 2c 20 77 72 69 74 65 2c 20 6c 6f 6f 70 2c 20 65 , write, loop, e
5390: 78 69 74 3c 2f 63 6f 64 65 3e 2e 3c 2f 6c 69 3e xit</code>.</li>
53a0: 0a 09 20 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e .. <li>The <em>
53b0: 6d 65 73 73 61 67 65 3c 2f 65 6d 3e 20 61 72 67 message</em> arg
53c0: 75 6d 65 6e 74 20 69 73 20 61 20 64 65 73 63 72 ument is a descr
53d0: 69 70 74 69 76 65 20 73 74 72 69 6e 67 20 77 68 iptive string wh
53e0: 69 63 68 20 6d 61 79 0a 09 20 20 62 65 20 67 65 ich may.. be ge
53f0: 6e 65 72 61 74 65 64 20 65 69 74 68 65 72 20 62 nerated either b
5400: 79 20 3c 63 6f 64 65 3e 53 53 4c 5f 73 74 61 74 y <code>SSL_stat
5410: 65 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 28 29 3c e_string_long()<
5420: 2f 63 6f 64 65 3e 20 6f 72 20 62 79 0a 09 20 20 /code> or by..
5430: 3c 63 6f 64 65 3e 53 53 4c 5f 61 6c 65 72 74 5f <code>SSL_alert_
5440: 64 65 73 63 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 desc_string_long
5450: 28 29 3c 2f 63 6f 64 65 3e 2c 20 64 65 70 65 6e ()</code>, depen
5460: 64 69 6e 67 20 6f 6e 20 74 68 65 20 63 6f 6e 74 ding on the cont
5470: 65 78 74 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 ext.</li>.. <li
5480: 3e 46 6f 72 20 61 6c 65 72 74 73 2c 20 74 68 65 >For alerts, the
5490: 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 possible values
54a0: 20 66 6f 72 20 3c 65 6d 3e 74 79 70 65 3c 2f 65 for <em>type</e
54b0: 6d 3e 20 61 72 65 3a 0a 09 20 20 3c 63 6f 64 65 m> are:.. <code
54c0: 3e 77 61 72 6e 69 6e 67 2c 20 66 61 74 61 6c 2c >warning, fatal,
54d0: 20 61 6e 64 20 75 6e 6b 6e 6f 77 6e 3c 2f 63 6f and unknown</co
54e0: 64 65 3e 2e 20 46 6f 72 20 6f 74 68 65 72 73 2c de>. For others,
54f0: 0a 09 20 20 3c 63 6f 64 65 3e 69 6e 66 6f 3c 2f .. <code>info</
5500: 63 6f 64 65 3e 20 69 73 20 75 73 65 64 2e 3c 2f code> is used.</
5510: 6c 69 3e 0a 09 20 20 3c 2f 75 6c 3e 0a 09 3c 2f li>.. </ul>..</
5520: 64 64 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 dd>...<dt>.. <s
5530: 74 72 6f 6e 67 3e 6d 65 73 73 61 67 65 3c 2f 73 trong>message</s
5540: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e trong> <em>chann
5550: 65 6c 20 64 69 72 65 63 74 69 6f 6e 20 76 65 72 el direction ver
5560: 73 69 6f 6e 20 63 6f 6e 74 65 6e 74 5f 74 79 70 sion content_typ
5570: 65 20 64 61 74 61 3c 2f 65 6d 3e 0a 09 3c 2f 64 e data</em>..</d
5580: 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 68 69 73 t>..<dd>.. This
5590: 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 form of callbac
55a0: 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 k is invoked by
55b0: 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 6e 63 the OpenSSL func
55c0: 74 69 6f 6e 0a 09 20 20 3c 63 6f 64 65 3e 53 53 tion.. <code>SS
55d0: 4c 5f 73 65 74 5f 6d 73 67 5f 63 61 6c 6c 62 61 L_set_msg_callba
55e0: 63 6b 28 29 3c 2f 63 6f 64 65 3e 20 77 68 65 6e ck()</code> when
55f0: 65 76 65 72 20 61 20 6d 65 73 73 61 67 65 20 69 ever a message i
5600: 73 20 73 65 6e 74 20 6f 72 0a 09 20 20 72 65 63 s sent or.. rec
5610: 65 69 76 65 64 2e 20 49 74 20 69 73 20 6f 6e 6c eived. It is onl
5620: 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e y available when
5630: 0a 09 20 20 4f 70 65 6e 53 53 4c 20 69 73 20 63 .. OpenSSL is c
5640: 6f 6d 70 6c 69 65 64 20 77 69 74 68 20 74 68 65 omplied with the
5650: 20 3c 65 6d 3e 65 6e 61 62 6c 65 2d 73 73 6c 2d <em>enable-ssl-
5660: 74 72 61 63 65 3c 2f 65 6d 3e 20 6f 70 74 69 6f trace</em> optio
5670: 6e 2e 0a 09 20 20 57 68 65 72 65 20 3c 65 6d 3e n... Where <em>
5680: 64 69 72 65 63 74 69 6f 6e 3c 2f 65 6d 3e 20 69 direction</em> i
5690: 73 20 53 65 6e 74 20 6f 72 20 52 65 63 65 69 76 s Sent or Receiv
56a0: 65 64 2c 20 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c ed, <em>version<
56b0: 2f 65 6d 3e 20 69 73 20 74 68 65 0a 09 20 20 70 /em> is the.. p
56c0: 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 2c rotocol version,
56d0: 20 3c 65 6d 3e 63 6f 6e 74 65 6e 74 5f 74 79 70 <em>content_typ
56e0: 65 3c 2f 65 6d 3e 20 69 73 20 74 68 65 20 6d 65 e</em> is the me
56f0: 73 73 61 67 65 20 63 6f 6e 74 65 6e 74 20 74 79 ssage content ty
5700: 70 65 2c 0a 09 20 20 61 6e 64 20 3c 65 6d 3e 64 pe,.. and <em>d
5710: 61 74 61 3c 2f 65 6d 3e 20 69 73 20 6d 6f 72 65 ata</em> is more
5720: 20 69 6e 66 6f 20 6f 6e 20 74 68 65 20 6d 65 73 info on the mes
5730: 73 61 67 65 20 66 72 6f 6d 20 74 68 65 20 3c 63 sage from the <c
5740: 6f 64 65 3e 53 53 4c 5f 74 72 61 63 65 3c 2f 63 ode>SSL_trace</c
5750: 6f 64 65 3e 20 41 50 49 2e 0a 09 3c 2f 64 64 3e ode> API...</dd>
5760: 0a 09 3c 62 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 ..<br>...<dt>..
5770: 20 3c 73 74 72 6f 6e 67 3e 73 65 73 73 69 6f 6e <strong>session
5780: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 65 </strong> <em>se
5790: 73 73 69 6f 6e 5f 69 64 20 74 69 63 6b 65 74 20 ssion_id ticket
57a0: 6c 69 66 65 74 69 6d 65 3c 2f 65 6d 3e 0a 09 3c lifetime</em>..<
57b0: 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 68 /dt>..<dd>.. Th
57c0: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
57d0: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
57e0: 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 y the OpenSSL fu
57f0: 6e 63 74 69 6f 6e 0a 09 20 20 3c 63 6f 64 65 3e nction.. <code>
5800: 53 53 4c 5f 43 54 58 5f 73 65 73 73 5f 73 65 74 SSL_CTX_sess_set
5810: 5f 6e 65 77 5f 63 62 28 29 3c 2f 63 6f 64 65 3e _new_cb()</code>
5820: 2e 0a 09 20 20 57 68 65 72 65 20 3c 65 6d 3e 73 ... Where <em>s
5830: 65 73 73 69 6f 6e 5f 69 64 3c 2f 65 6d 3e 20 69 ession_id</em> i
5840: 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 s the current se
5850: 73 73 69 6f 6e 20 69 64 65 6e 74 69 66 69 65 72 ssion identifier
5860: 2c 0a 09 20 20 3c 65 6d 3e 74 69 63 6b 65 74 3c ,.. <em>ticket<
5870: 2f 65 6d 3e 20 69 73 20 74 68 65 20 73 65 73 73 /em> is the sess
5880: 69 6f 6e 20 74 69 63 6b 65 74 20 69 6e 66 6f 2c ion ticket info,
5890: 20 61 6e 64 20 3c 65 6d 3e 6c 69 66 65 74 69 6d and <em>lifetim
58a0: 65 3c 2f 65 6d 3e 0a 09 20 20 69 73 20 74 68 65 e</em>.. is the
58b0: 20 74 68 65 20 74 69 63 6b 65 74 20 6c 69 66 65 the ticket life
58c0: 74 69 6d 65 20 69 6e 20 73 65 63 6f 6e 64 73 2e time in seconds.
58d0: 0a 09 3c 2f 64 64 3e 0a 09 3c 62 72 3e 0a 09 3c ..</dd>..<br>..<
58e0: 2f 64 6c 3e 0a 20 20 20 20 3c 2f 64 64 3e 0a 0a /dl>. </dd>..
58f0: 20 20 20 20 3c 62 72 3e 0a 0a 20 20 20 20 3c 64 <br>.. <d
5900: 74 3e 3c 73 74 72 6f 6e 67 3e 2d 70 61 73 73 77 t><strong>-passw
5910: 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ord</strong> <em
5920: 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 3c 2f >callback</em></
5930: 64 74 3e 0a 20 20 20 20 3c 64 64 3e 0a 09 49 6e dt>. <dd>..In
5940: 76 6f 6b 65 73 20 74 68 65 20 73 70 65 63 69 66 vokes the specif
5950: 69 65 64 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b ied <em>callback
5960: 3c 2f 65 6d 3e 20 73 63 72 69 70 74 20 77 68 65 </em> script whe
5970: 6e 20 4f 70 65 6e 53 53 4c 20 6e 65 65 64 73 20 n OpenSSL needs
5980: 74 6f 0a 09 6f 62 74 61 69 6e 20 61 20 70 61 73 to..obtain a pas
5990: 73 77 6f 72 64 2e 20 53 65 65 20 62 65 6c 6f 77 sword. See below
59a0: 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 6c for the possibl
59b0: 65 20 61 72 67 75 6d 65 6e 74 73 20 70 61 73 73 e arguments pass
59c0: 65 64 20 74 6f 0a 09 74 68 65 20 63 61 6c 6c 62 ed to..the callb
59d0: 61 63 6b 20 73 63 72 69 70 74 2e 20 53 65 65 20 ack script. See
59e0: 62 65 6c 6f 77 20 66 6f 72 20 76 61 6c 69 64 20 below for valid
59f0: 72 65 74 75 72 6e 20 76 61 6c 75 65 73 2e 0a 0a return values...
5a00: 09 3c 62 72 3e 0a 09 3c 62 72 3e 0a 0a 09 3c 64 .<br>..<br>...<d
5a10: 6c 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 l>...<dt>.. <st
5a20: 72 6f 6e 67 3e 70 61 73 73 77 6f 72 64 3c 2f 73 rong>password</s
5a30: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 72 77 66 6c 61 trong> <em>rwfla
5a40: 67 20 73 69 7a 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 g size</em>..</d
5a50: 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 49 6e 76 6f t>..<dd>.. Invo
5a60: 6b 65 64 20 77 68 65 6e 20 6c 6f 61 64 69 6e 67 ked when loading
5a70: 20 6f 72 20 73 74 6f 72 69 6e 67 20 61 20 50 45 or storing a PE
5a80: 4d 20 63 65 72 74 69 66 69 63 61 74 65 20 77 69 M certificate wi
5a90: 74 68 20 65 6e 63 72 79 70 74 69 6f 6e 2e 0a 09 th encryption...
5aa0: 20 20 57 68 65 72 65 20 3c 65 6d 3e 72 77 66 6c Where <em>rwfl
5ab0: 61 67 3c 2f 65 6d 3e 20 69 73 20 30 20 66 6f 72 ag</em> is 0 for
5ac0: 20 72 65 61 64 69 6e 67 2f 64 65 63 72 79 70 74 reading/decrypt
5ad0: 69 6f 6e 20 6f 72 20 31 20 66 6f 72 0a 09 20 20 ion or 1 for..
5ae0: 77 72 69 74 69 6e 67 2f 65 6e 63 72 79 70 74 69 writing/encrypti
5af0: 6f 6e 20 28 63 61 6e 20 70 72 6f 6d 70 74 20 75 on (can prompt u
5b00: 73 65 72 20 74 6f 20 63 6f 6e 66 69 72 6d 29 20 ser to confirm)
5b10: 61 6e 64 0a 09 20 20 3c 65 6d 3e 73 69 7a 65 3c and.. <em>size<
5b20: 2f 65 6d 3e 20 69 73 20 74 68 65 20 6d 61 78 20 /em> is the max
5b30: 70 61 73 73 77 6f 72 64 20 6c 65 6e 67 74 68 20 password length
5b40: 69 6e 20 62 79 74 65 73 2e 0a 09 20 20 54 68 65 in bytes... The
5b50: 20 63 61 6c 6c 62 61 63 6b 20 73 68 6f 75 6c 64 callback should
5b60: 20 72 65 74 75 72 6e 20 74 68 65 20 70 61 73 73 return the pass
5b70: 77 6f 72 64 20 61 73 20 61 20 73 74 72 69 6e 67 word as a string
5b80: 2e 0a 09 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 ...</dd>. </d
5b90: 64 3e 0a 0a 20 20 20 20 3c 62 72 3e 0a 0a 0a 20 d>.. <br>...
5ba0: 20 20 20 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d <dt><strong>-
5bb0: 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 6e 64 3c validatecommand<
5bc0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 61 6c /strong> <em>cal
5bd0: 6c 62 61 63 6b 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a lback</em></dt>.
5be0: 20 20 20 20 3c 64 64 3e 0a 09 49 6e 76 6f 6b 65 <dd>..Invoke
5bf0: 73 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 s the specified
5c00: 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d <em>callback</em
5c10: 3e 20 73 63 72 69 70 74 20 64 75 72 69 6e 67 20 > script during
5c20: 68 61 6e 64 73 68 61 6b 65 20 69 6e 0a 09 6f 72 handshake in..or
5c30: 64 65 72 20 74 6f 20 76 61 6c 69 64 61 74 65 20 der to validate
5c40: 74 68 65 20 70 72 6f 76 69 64 65 64 20 76 61 6c the provided val
5c50: 75 65 28 73 29 2e 20 53 65 65 20 62 65 6c 6f 77 ue(s). See below
5c60: 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 6c for the possibl
5c70: 65 0a 09 61 72 67 75 6d 65 6e 74 73 20 70 61 73 e..arguments pas
5c80: 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 62 sed to the callb
5c90: 61 63 6b 20 73 63 72 69 70 74 2e 0a 09 54 6f 20 ack script...To
5ca0: 72 65 6a 65 63 74 20 74 68 65 20 76 61 6c 75 65 reject the value
5cb0: 20 61 6e 64 20 61 62 6f 72 74 20 63 6f 6e 6e 65 and abort conne
5cc0: 63 74 69 6f 6e 2c 20 74 68 65 20 63 61 6c 6c 62 ction, the callb
5cd0: 61 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 ack should retur
5ce0: 6e 20 30 2e 0a 09 54 6f 20 61 63 63 65 70 74 20 n 0...To accept
5cf0: 74 68 65 20 76 61 6c 75 65 20 61 6e 64 20 63 6f the value and co
5d00: 6e 74 69 6e 75 65 20 74 68 65 20 63 6f 6e 6e 65 ntinue the conne
5d10: 63 74 69 6f 6e 2c 20 69 74 20 73 68 6f 75 6c 64 ction, it should
5d20: 20 72 65 74 75 72 6e 20 31 2e 0a 09 54 6f 20 72 return 1...To r
5d30: 65 6a 65 63 74 20 74 68 65 20 76 61 6c 75 65 2c eject the value,
5d40: 20 62 75 74 20 63 6f 6e 74 69 6e 75 65 20 74 68 but continue th
5d50: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 74 e connection, it
5d60: 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 32 should return 2
5d70: 2e 0a 0a 09 3c 62 72 3e 0a 09 3c 62 72 3e 0a 0a ....<br>..<br>..
5d80: 09 3c 64 6c 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 .<dl>...<dt>..
5d90: 3c 73 74 72 6f 6e 67 3e 61 6c 70 6e 3c 2f 73 74 <strong>alpn</st
5da0: 72 6f 6e 67 3e 20 3c 65 6d 3e 70 72 6f 74 6f 63 rong> <em>protoc
5db0: 6f 6c 20 6d 61 74 63 68 3c 2f 65 6d 3e 0a 09 3c ol match</em>..<
5dc0: 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 46 6f /dt>..<dd>.. Fo
5dd0: 72 20 73 65 72 76 65 72 73 2c 20 74 68 69 73 20 r servers, this
5de0: 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 6b form of callback
5df0: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e is invoked when
5e00: 20 74 68 65 20 63 6c 69 65 6e 74 20 41 4c 50 4e the client ALPN
5e10: 0a 09 20 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 .. extension is
5e20: 20 72 65 63 65 69 76 65 64 2e 20 49 66 20 3c 65 received. If <e
5e30: 6d 3e 6d 61 74 63 68 3c 2f 65 6d 3e 20 69 73 20 m>match</em> is
5e40: 74 72 75 65 2c 20 3c 65 6d 3e 70 72 6f 74 6f 63 true, <em>protoc
5e50: 6f 6c 3c 2f 65 6d 3e 0a 09 20 20 69 73 20 74 68 ol</em>.. is th
5e60: 65 20 66 69 72 73 74 20 3c 62 3e 2d 61 6c 70 6e e first <b>-alpn
5e70: 3c 2f 62 3e 20 73 70 65 63 69 66 69 65 64 20 70 </b> specified p
5e80: 72 6f 74 6f 63 6f 6c 20 63 6f 6d 6d 6f 6e 20 74 rotocol common t
5e90: 6f 20 74 68 65 20 62 6f 74 68 20 74 68 65 0a 09 o the both the..
5ea0: 20 20 63 6c 69 65 6e 74 20 61 6e 64 20 73 65 72 client and ser
5eb0: 76 65 72 2e 20 49 66 20 6e 6f 74 2c 20 74 68 65 ver. If not, the
5ec0: 20 66 69 72 73 74 20 63 6c 69 65 6e 74 20 73 70 first client sp
5ed0: 65 63 69 66 69 65 64 20 70 72 6f 74 6f 63 6f 6c ecified protocol
5ee0: 20 69 73 0a 09 20 20 75 73 65 64 2e 20 43 61 6c is.. used. Cal
5ef0: 6c 65 64 20 61 66 74 65 72 20 68 65 6c 6c 6f 20 led after hello
5f00: 61 6e 64 20 41 4c 50 4e 20 63 61 6c 6c 62 61 63 and ALPN callbac
5f10: 6b 73 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c 62 72 ks...</dd>...<br
5f20: 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 72 >...<dt>.. <str
5f30: 6f 6e 67 3e 68 65 6c 6c 6f 3c 2f 73 74 72 6f 6e ong>hello</stron
5f40: 67 3e 20 3c 65 6d 3e 73 65 72 76 65 72 6e 61 6d g> <em>servernam
5f50: 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c e</em>..</dt>..<
5f60: 64 64 3e 0a 09 20 20 46 6f 72 20 73 65 72 76 65 dd>.. For serve
5f70: 72 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f 66 rs, this form of
5f80: 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 callback is inv
5f90: 6f 6b 65 64 20 64 75 72 69 6e 67 20 63 6c 69 65 oked during clie
5fa0: 6e 74 20 68 65 6c 6c 6f 0a 09 20 20 6d 65 73 73 nt hello.. mess
5fb0: 61 67 65 20 70 72 6f 63 65 73 73 69 6e 67 2e 20 age processing.
5fc0: 49 74 20 69 73 20 75 73 65 64 20 74 6f 20 73 65 It is used to se
5fd0: 6c 65 63 74 20 61 6e 20 61 70 70 72 6f 70 72 69 lect an appropri
5fe0: 61 74 65 20 63 65 72 74 69 66 69 63 61 74 65 20 ate certificate
5ff0: 74 6f 0a 09 20 20 70 72 65 73 65 6e 74 2c 20 61 to.. present, a
6000: 6e 64 20 6d 61 6b 65 20 6f 74 68 65 72 20 63 6f nd make other co
6010: 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 64 6a 75 nfiguration adju
6020: 73 74 6d 65 6e 74 73 20 72 65 6c 65 76 61 6e 74 stments relevant
6030: 20 74 6f 20 74 68 61 74 0a 09 20 20 73 65 72 76 to that.. serv
6040: 65 72 20 6e 61 6d 65 20 61 6e 64 20 69 74 73 20 er name and its
6050: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 43 configuration. C
6060: 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 53 4e 49 alled before SNI
6070: 20 61 6e 64 20 41 4c 50 4e 20 63 61 6c 6c 62 61 and ALPN callba
6080: 63 6b 73 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c 62 cks...</dd>...<b
6090: 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 r>...<dt>.. <st
60a0: 72 6f 6e 67 3e 73 6e 69 3c 2f 73 74 72 6f 6e 67 rong>sni</strong
60b0: 3e 20 3c 65 6d 3e 73 65 72 76 65 72 6e 61 6d 65 > <em>servername
60c0: 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 </em>..</dt>..<d
60d0: 64 3e 0a 09 20 20 46 6f 72 20 73 65 72 76 65 72 d>.. For server
60e0: 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 s, this form of
60f0: 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f callback is invo
6100: 6b 65 64 20 77 68 65 6e 20 74 68 65 20 53 4e 49 ked when the SNI
6110: 20 65 78 74 65 6e 73 69 6f 6e 0a 09 20 20 66 72 extension.. fr
6120: 6f 6d 20 74 68 65 20 63 6c 69 65 6e 74 20 69 73 om the client is
6130: 20 72 65 63 65 69 76 65 64 2e 20 57 68 65 72 65 received. Where
6140: 20 3c 65 6d 3e 73 65 72 76 65 72 6e 61 6d 65 3c <em>servername<
6150: 2f 65 6d 3e 20 69 73 20 74 68 65 20 63 6c 69 65 /em> is the clie
6160: 6e 74 0a 09 20 20 70 72 6f 76 69 64 65 64 20 73 nt.. provided s
6170: 65 72 76 65 72 20 6e 61 6d 65 20 66 72 6f 6d 20 erver name from
6180: 74 68 65 20 3c 62 3e 2d 73 65 72 76 65 72 6e 61 the <b>-serverna
6190: 6d 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 2e 20 54 me</b> option. T
61a0: 68 69 73 20 69 73 0a 09 20 20 75 73 65 64 20 77 his is.. used w
61b0: 68 65 6e 20 61 20 73 65 72 76 65 72 20 73 75 70 hen a server sup
61c0: 70 6f 72 74 73 20 6d 75 6c 74 69 70 6c 65 20 6e ports multiple n
61d0: 61 6d 65 73 2c 20 73 6f 20 74 68 65 20 72 69 67 ames, so the rig
61e0: 68 74 20 63 65 72 74 69 66 69 63 61 74 65 0a 09 ht certificate..
61f0: 20 20 63 61 6e 20 62 65 20 75 73 65 64 2e 20 43 can be used. C
6200: 61 6c 6c 65 64 20 61 66 74 65 72 20 68 65 6c 6c alled after hell
6210: 6f 20 63 61 6c 6c 62 61 63 6b 20 62 75 74 20 62 o callback but b
6220: 65 66 6f 72 65 20 41 4c 50 4e 20 63 61 6c 6c 62 efore ALPN callb
6230: 61 63 6b 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c 62 ack...</dd>...<b
6240: 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 r>...<dt>.. <st
6250: 72 6f 6e 67 3e 76 65 72 69 66 79 3c 2f 73 74 72 rong>verify</str
6260: 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c ong> <em>channel
6270: 20 64 65 70 74 68 20 63 65 72 74 20 73 74 61 74 depth cert stat
6280: 75 73 20 65 72 72 6f 72 3c 2f 65 6d 3e 0a 09 3c us error</em>..<
6290: 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 68 /dt>..<dd>.. Th
62a0: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
62b0: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
62c0: 79 20 4f 70 65 6e 53 53 4c 20 77 68 65 6e 20 61 y OpenSSL when a
62d0: 20 6e 65 77 20 63 65 72 74 69 66 69 63 61 74 65 new certificate
62e0: 0a 09 20 20 69 73 20 72 65 63 65 69 76 65 64 20 .. is received
62f0: 66 72 6f 6d 20 74 68 65 20 70 65 65 72 2e 20 49 from the peer. I
6300: 74 20 61 6c 6c 6f 77 73 20 74 68 65 20 63 6c 69 t allows the cli
6310: 65 6e 74 20 74 6f 20 63 68 65 63 6b 20 74 68 65 ent to check the
6320: 0a 09 20 20 63 65 72 74 69 66 69 63 61 74 65 20 .. certificate
6330: 76 65 72 69 66 69 63 61 74 69 6f 6e 20 72 65 73 verification res
6340: 75 6c 74 73 20 61 6e 64 20 63 68 6f 6f 73 65 20 ults and choose
6350: 77 68 65 74 68 65 72 20 74 6f 20 63 6f 6e 74 69 whether to conti
6360: 6e 75 65 0a 09 20 20 6f 72 20 6e 6f 74 2e 20 49 nue.. or not. I
6370: 74 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 t is called for
6380: 65 61 63 68 20 63 65 72 74 69 66 69 63 61 74 65 each certificate
6390: 20 69 6e 20 74 68 65 20 63 65 72 74 69 66 69 63 in the certific
63a0: 61 74 65 20 63 68 61 69 6e 2e 0a 09 20 20 3c 75 ate chain... <u
63b0: 6c 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 3c 65 l>.. <li>The <e
63c0: 6d 3e 64 65 70 74 68 3c 2f 65 6d 3e 20 61 72 67 m>depth</em> arg
63d0: 75 6d 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 65 ument is an inte
63e0: 67 65 72 20 72 65 70 72 65 73 65 6e 74 69 6e 67 ger representing
63f0: 20 74 68 65 0a 09 20 20 63 75 72 72 65 6e 74 20 the.. current
6400: 64 65 70 74 68 20 6f 6e 20 74 68 65 20 63 65 72 depth on the cer
6410: 74 69 66 69 63 61 74 65 20 63 68 61 69 6e 2c 20 tificate chain,
6420: 77 69 74 68 0a 09 20 20 3c 63 6f 64 65 3e 30 3c with.. <code>0<
6430: 2f 63 6f 64 65 3e 20 61 73 20 74 68 65 20 70 65 /code> as the pe
6440: 65 72 20 63 65 72 74 69 66 69 63 61 74 65 20 61 er certificate a
6450: 6e 64 20 68 69 67 68 65 72 20 76 61 6c 75 65 73 nd higher values
6460: 20 67 6f 69 6e 67 0a 09 20 20 75 70 20 74 6f 20 going.. up to
6470: 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 20 the Certificate
6480: 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 2e 3c Authority (CA).<
6490: 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 /li>.. <li>The
64a0: 3c 65 6d 3e 63 65 72 74 3c 2f 65 6d 3e 20 61 72 <em>cert</em> ar
64b0: 67 75 6d 65 6e 74 20 69 73 20 61 20 6c 69 73 74 gument is a list
64c0: 20 6f 66 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 of key-value pa
64d0: 69 72 73 20 73 69 6d 69 6c 61 72 0a 09 20 20 74 irs similar.. t
64e0: 6f 20 74 68 6f 73 65 20 72 65 74 75 72 6e 65 64 o those returned
64f0: 20 62 79 0a 09 20 20 3c 61 20 68 72 65 66 3d 22 by.. <a href="
6500: 23 74 6c 73 3a 3a 73 74 61 74 75 73 22 3e 3c 73 #tls::status"><s
6510: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 74 61 74 75 trong>tls::statu
6520: 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 2e 3c s</strong></a>.<
6530: 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 /li>.. <li>The
6540: 3c 65 6d 3e 73 74 61 74 75 73 3c 2f 65 6d 3e 20 <em>status</em>
6550: 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 62 argument is an b
6560: 6f 6f 6c 65 61 6e 20 72 65 70 72 65 73 65 6e 74 oolean represent
6570: 69 6e 67 20 74 68 65 0a 09 20 20 76 61 6c 69 64 ing the.. valid
6580: 69 74 79 20 6f 66 20 74 68 65 20 63 75 72 72 65 ity of the curre
6590: 6e 74 20 63 65 72 74 69 66 69 63 61 74 65 2e 0a nt certificate..
65a0: 09 20 20 41 20 76 61 6c 75 65 20 6f 66 20 3c 63 . A value of <c
65b0: 6f 64 65 3e 30 3c 2f 63 6f 64 65 3e 20 6d 65 61 ode>0</code> mea
65c0: 6e 73 20 74 68 65 20 63 65 72 74 69 66 69 63 61 ns the certifica
65d0: 74 65 20 69 73 20 64 65 65 6d 65 64 20 69 6e 76 te is deemed inv
65e0: 61 6c 69 64 2e 0a 09 20 20 41 20 76 61 6c 75 65 alid... A value
65f0: 20 6f 66 20 3c 63 6f 64 65 3e 31 3c 2f 63 6f 64 of <code>1</cod
6600: 65 3e 20 6d 65 61 6e 73 20 74 68 65 20 63 65 72 e> means the cer
6610: 74 69 66 69 63 61 74 65 20 69 73 20 64 65 65 6d tificate is deem
6620: 65 64 20 76 61 6c 69 64 2e 3c 2f 6c 69 3e 0a 09 ed valid.</li>..
6630: 20 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e 65 72 <li>The <em>er
6640: 72 6f 72 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e ror</em> argumen
6650: 74 20 73 75 70 70 6c 69 65 73 20 74 68 65 20 6d t supplies the m
6660: 65 73 73 61 67 65 2c 20 69 66 20 61 6e 79 2c 20 essage, if any,
6670: 67 65 6e 65 72 61 74 65 64 0a 09 20 20 62 79 20 generated.. by
6680: 3c 63 6f 64 65 3e 58 35 30 39 5f 53 54 4f 52 45 <code>X509_STORE
6690: 5f 43 54 58 5f 67 65 74 5f 65 72 72 6f 72 28 29 _CTX_get_error()
66a0: 3c 2f 63 6f 64 65 3e 2e 3c 2f 6c 69 3e 0a 09 20 </code>.</li>..
66b0: 20 3c 2f 75 6c 3e 0a 09 3c 2f 64 64 3e 0a 09 3c </ul>..</dd>..<
66c0: 62 72 3e 0a 09 3c 2f 64 6c 3e 0a 20 20 20 20 3c br>..</dl>. <
66d0: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f /dd>.</dl>.</blo
66e0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 52 65 ckquote>..<p>.Re
66f0: 66 65 72 65 6e 63 65 20 69 6d 70 6c 65 6d 65 6e ference implemen
6700: 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 73 65 tations of these
6710: 20 63 61 6c 6c 62 61 63 6b 73 20 61 72 65 20 70 callbacks are p
6720: 72 6f 76 69 64 65 64 20 69 6e 20 74 68 65 0a 64 rovided in the.d
6730: 69 73 74 72 69 62 75 74 69 6f 6e 20 61 73 20 3c istribution as <
6740: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 61 6c 6c strong>tls::call
6750: 62 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 2c 20 3c back</strong>, <
6760: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 61 73 73 strong>tls::pass
6770: 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 0a 61 word</strong>,.a
6780: 6e 64 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a nd <strong>tls::
6790: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
67a0: 3c 2f 73 74 72 6f 6e 67 3e 20 72 65 73 70 65 63 </strong> respec
67b0: 74 69 76 65 6c 79 2e 20 20 4e 6f 74 65 20 74 68 tively. Note th
67c0: 61 74 20 74 68 65 73 65 20 61 72 65 0a 3c 65 6d at these are.<em
67d0: 3e 73 61 6d 70 6c 65 3c 2f 65 6d 3e 20 69 6d 70 >sample</em> imp
67e0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 6e 6c lementations onl
67f0: 79 2e 20 20 49 6e 20 61 20 6d 6f 72 65 20 72 65 y. In a more re
6800: 61 6c 69 73 74 69 63 20 64 65 70 6c 6f 79 6d 65 alistic deployme
6810: 6e 74 0a 79 6f 75 20 77 6f 75 6c 64 20 73 70 65 nt.you would spe
6820: 63 69 66 79 20 79 6f 75 72 20 6f 77 6e 20 63 61 cify your own ca
6830: 6c 6c 62 61 63 6b 20 73 63 72 69 70 74 73 20 6f llback scripts o
6840: 6e 20 65 61 63 68 20 54 4c 53 20 63 68 61 6e 6e n each TLS chann
6850: 65 6c 20 75 73 69 6e 67 20 74 68 65 0a 3c 73 74 el using the.<st
6860: 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 rong>-command</s
6870: 74 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e trong>, <strong>
6880: 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e -password</stron
6890: 67 3e 2c 20 61 6e 64 20 3c 73 74 72 6f 6e 67 3e g>, and <strong>
68a0: 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e -validate_comman
68b0: 64 3c 2f 73 74 72 6f 6e 67 3e 20 6f 70 74 69 6f d</strong> optio
68c0: 6e 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 ns..</p>..<p>.Th
68d0: 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 e default behavi
68e0: 6f 72 20 77 68 65 6e 20 74 68 65 20 3c 73 74 72 or when the <str
68f0: 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 74 ong>-command</st
6900: 72 6f 6e 67 3e 20 61 6e 64 20 3c 73 74 72 6f 6e rong> and <stron
6910: 67 3e 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d g>-validate_comm
6920: 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 0a 6f 70 74 and</strong>.opt
6930: 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 73 70 65 ions are not spe
6940: 63 69 66 69 65 64 20 69 73 20 66 6f 72 20 54 4c cified is for TL
6950: 53 20 74 6f 20 70 72 6f 63 65 73 73 20 74 68 65 S to process the
6960: 20 61 73 73 6f 63 69 61 74 65 64 20 6c 69 62 72 associated libr
6970: 61 72 79 20 63 61 6c 6c 62 61 63 6b 73 0a 69 6e ary callbacks.in
6980: 74 65 72 6e 61 6c 6c 79 2e 20 54 68 65 20 64 65 ternally. The de
6990: 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 77 fault behavior w
69a0: 68 65 6e 20 74 68 65 20 3c 73 74 72 6f 6e 67 3e hen the <strong>
69b0: 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e -password</stron
69c0: 67 3e 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 74 g> option is not
69d0: 0a 73 70 65 63 69 66 69 65 64 20 69 73 20 66 6f .specified is fo
69e0: 72 20 54 4c 53 20 74 6f 20 70 72 6f 63 65 73 73 r TLS to process
69f0: 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 the associated
6a00: 6c 69 62 72 61 72 79 20 63 61 6c 6c 62 61 63 6b library callback
6a10: 73 20 62 79 20 61 74 74 65 6d 70 74 69 6e 67 0a s by attempting.
6a20: 74 6f 20 63 61 6c 6c 20 3c 73 74 72 6f 6e 67 3e to call <strong>
6a30: 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 3c 2f 73 tls::password</s
6a40: 74 72 6f 6e 67 3e 2e 0a 54 68 65 20 64 69 66 66 trong>..The diff
6a50: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 erence between t
6a60: 68 65 73 65 20 74 77 6f 20 62 65 68 61 76 69 6f hese two behavio
6a70: 72 73 20 69 73 20 61 20 63 6f 6e 73 65 71 75 65 rs is a conseque
6a80: 6e 63 65 20 6f 66 20 6d 61 69 6e 74 61 69 6e 69 nce of maintaini
6a90: 6e 67 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 ng.compatibility
6aa0: 20 77 69 74 68 20 65 61 72 6c 69 65 72 20 69 6d with earlier im
6ab0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2e 0a 3c plementations..<
6ac0: 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 3c 73 74 /p>..<p>.The <st
6ad0: 72 6f 6e 67 3e 74 6c 73 3a 3a 64 65 62 75 67 3c rong>tls::debug<
6ae0: 2f 73 74 72 6f 6e 67 3e 20 76 61 72 69 61 62 6c /strong> variabl
6af0: 65 20 70 72 6f 76 69 64 65 73 20 73 6f 6d 65 20 e provides some
6b00: 61 64 64 69 74 69 6f 6e 61 6c 0a 63 6f 6e 74 72 additional.contr
6b10: 6f 6c 20 6f 76 65 72 20 74 68 65 73 65 20 72 65 ol over these re
6b20: 66 65 72 65 6e 63 65 20 63 61 6c 6c 62 61 63 6b ference callback
6b30: 73 2e 20 20 49 74 73 20 76 61 6c 75 65 20 69 73 s. Its value is
6b40: 20 7a 65 72 6f 20 62 79 20 64 65 66 61 75 6c 74 zero by default
6b50: 2e 0a 48 69 67 68 65 72 20 76 61 6c 75 65 73 20 ..Higher values
6b60: 70 72 6f 64 75 63 65 20 6d 6f 72 65 20 64 69 61 produce more dia
6b70: 67 6e 6f 73 74 69 63 20 6f 75 74 70 75 74 2c 20 gnostic output,
6b80: 61 6e 64 20 77 69 6c 6c 20 61 6c 73 6f 20 66 6f and will also fo
6b90: 72 63 65 20 74 68 65 0a 76 65 72 69 66 79 20 6d rce the.verify m
6ba0: 65 74 68 6f 64 20 69 6e 20 3c 73 74 72 6f 6e 67 ethod in <strong
6bb0: 3e 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 3c 2f >tls::callback</
6bc0: 73 74 72 6f 6e 67 3e 20 74 6f 20 61 63 63 65 70 strong> to accep
6bd0: 74 20 74 68 65 0a 63 65 72 74 69 66 69 63 61 74 t the.certificat
6be0: 65 2c 20 65 76 65 6e 20 77 68 65 6e 20 69 74 20 e, even when it
6bf0: 69 73 20 69 6e 76 61 6c 69 64 2e 0a 3c 2f 70 3e is invalid..</p>
6c00: 0a 0a 3c 70 3e 0a 3c 65 6d 3e 0a 54 68 65 20 75 ..<p>.<em>.The u
6c10: 73 65 20 6f 66 20 74 68 65 20 72 65 66 65 72 65 se of the refere
6c20: 6e 63 65 20 63 61 6c 6c 62 61 63 6b 73 20 3c 73 nce callbacks <s
6c30: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 61 6c 6c 62 trong>tls::callb
6c40: 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 2c 0a 3c 73 ack</strong>,.<s
6c50: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 61 73 73 77 trong>tls::passw
6c60: 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 20 61 6e ord</strong>, an
6c70: 64 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 76 d <strong>tls::v
6c80: 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 3c alidate_command<
6c90: 2f 73 74 72 6f 6e 67 3e 0a 69 73 20 6e 6f 74 20 /strong>.is not
6ca0: 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 20 20 54 68 recommended. Th
6cb0: 65 79 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 ey may be remove
6cc0: 64 20 66 72 6f 6d 20 66 75 74 75 72 65 20 72 65 d from future re
6cd0: 6c 65 61 73 65 73 2e 0a 3c 2f 65 6d 3e 0a 3c 2f leases..</em>.</
6ce0: 70 3e 0a 0a 3c 70 3e 0a 3c 65 6d 3e 0a 54 68 65 p>..<p>.<em>.The
6cf0: 20 75 73 65 20 6f 66 20 74 68 65 20 76 61 72 69 use of the vari
6d00: 61 62 6c 65 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 able <strong>tls
6d10: 3a 3a 64 65 62 75 67 3c 2f 73 74 72 6f 6e 67 3e ::debug</strong>
6d20: 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e is not recommen
6d30: 64 65 64 2e 0a 49 74 20 6d 61 79 20 62 65 20 72 ded..It may be r
6d40: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 66 75 74 75 emoved from futu
6d50: 72 65 20 72 65 6c 65 61 73 65 73 2e 0a 3c 2f 65 re releases..</e
6d60: 6d 3e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 20 m>.</p>..<h3><a
6d70: 6e 61 6d 65 3d 22 44 45 42 55 47 22 3e 44 45 42 name="DEBUG">DEB
6d80: 55 47 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 54 4c 53 UG</a></h3>..TLS
6d90: 20 6b 65 79 20 6c 6f 67 67 69 6e 67 20 63 61 6e key logging can
6da0: 20 62 65 20 65 6e 61 62 6c 65 64 20 62 79 20 73 be enabled by s
6db0: 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 72 etting the envir
6dc0: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 0a onment variable.
6dd0: 3c 62 3e 53 53 4c 4b 45 59 4c 4f 47 46 49 4c 45 <b>SSLKEYLOGFILE
6de0: 3c 2f 62 3e 20 74 6f 20 74 68 65 20 6e 61 6d 65 </b> to the name
6df0: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f 20 of the file to
6e00: 6c 6f 67 20 74 6f 2e 20 54 68 65 6e 20 77 68 65 log to. Then whe
6e10: 6e 65 76 65 72 20 54 4c 53 0a 6b 65 79 20 6d 61 never TLS.key ma
6e20: 74 65 72 69 61 6c 20 69 73 20 67 65 6e 65 72 61 terial is genera
6e30: 74 65 64 20 6f 72 20 72 65 63 65 69 76 65 64 20 ted or received
6e40: 69 74 20 77 69 6c 6c 20 62 65 20 6c 6f 67 67 65 it will be logge
6e50: 64 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 54 d to the file. T
6e60: 68 69 73 0a 69 73 20 75 73 65 66 75 6c 20 66 6f his.is useful fo
6e70: 72 20 6c 6f 67 67 69 6e 67 20 6b 65 79 20 64 61 r logging key da
6e80: 74 61 20 66 6f 72 20 6e 65 74 77 6f 72 6b 20 6c ta for network l
6e90: 6f 67 67 69 6e 67 20 74 6f 6f 6c 73 20 74 6f 20 ogging tools to
6ea0: 75 73 65 20 74 6f 0a 64 65 63 72 79 70 74 20 74 use to.decrypt t
6eb0: 68 65 20 64 61 74 61 2e 0a 0a 3c 68 33 3e 3c 61 he data...<h3><a
6ec0: 20 6e 61 6d 65 3d 22 48 54 54 50 53 20 45 58 41 name="HTTPS EXA
6ed0: 4d 50 4c 45 22 3e 48 54 54 50 53 20 45 58 41 4d MPLE">HTTPS EXAM
6ee0: 50 4c 45 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 PLE</a></h3>..<p
6ef0: 3e 54 68 69 73 20 65 78 61 6d 70 6c 65 20 75 73 >This example us
6f00: 65 73 20 61 20 73 61 6d 70 6c 65 20 73 65 72 76 es a sample serv
6f10: 65 72 2e 70 65 6d 20 70 72 6f 76 69 64 65 64 20 er.pem provided
6f20: 77 69 74 68 20 74 68 65 20 54 4c 53 20 72 65 6c with the TLS rel
6f30: 65 61 73 65 2c 0a 63 6f 75 72 74 65 73 79 20 6f ease,.courtesy o
6f40: 66 20 74 68 65 20 3c 73 74 72 6f 6e 67 3e 4f 70 f the <strong>Op
6f50: 65 6e 53 53 4c 3c 2f 73 74 72 6f 6e 67 3e 20 70 enSSL</strong> p
6f60: 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a 3c 70 72 roject.</p>..<pr
6f70: 65 3e 3c 63 6f 64 65 3e 0a 70 61 63 6b 61 67 65 e><code>.package
6f80: 20 72 65 71 75 69 72 65 20 68 74 74 70 0a 70 61 require http.pa
6f90: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 6c ckage require tl
6fa0: 73 0a 0a 68 74 74 70 3a 3a 72 65 67 69 73 74 65 s..http::registe
6fb0: 72 20 68 74 74 70 73 20 34 34 33 20 5b 6c 69 73 r https 443 [lis
6fc0: 74 20 3a 3a 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 t ::tls::socket
6fd0: 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 6d 65 20 -autoservername
6fe0: 74 72 75 65 20 2d 72 65 71 75 69 72 65 20 74 72 true -require tr
6ff0: 75 65 20 2d 63 61 64 69 72 20 2f 65 74 63 2f 73 ue -cadir /etc/s
7000: 73 6c 2f 63 65 72 74 73 5d 0a 0a 73 65 74 20 74 sl/certs]..set t
7010: 6f 6b 20 5b 68 74 74 70 3a 3a 67 65 74 75 72 6c ok [http::geturl
7020: 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 74 63 6c https://www.tcl
7030: 2e 74 6b 2f 5d 0a 3c 2f 63 6f 64 65 3e 3c 2f 70 .tk/].</code></p
7040: 72 65 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 re>..<h3><a name
7050: 3d 22 53 50 45 43 49 41 4c 20 43 4f 4e 53 49 44 ="SPECIAL CONSID
7060: 45 52 41 54 49 4f 4e 53 22 3e 53 50 45 43 49 41 ERATIONS">SPECIA
7070: 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e 53 L CONSIDERATIONS
7080: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 </a></h3>..<p>Th
7090: 65 20 63 61 70 61 62 69 6c 69 74 69 65 73 20 6f e capabilities o
70a0: 66 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 63 f this package c
70b0: 61 6e 20 76 61 72 79 20 65 6e 6f 72 6d 6f 75 73 an vary enormous
70c0: 6c 79 20 62 61 73 65 64 20 75 70 6f 6e 20 68 6f ly based upon ho
70d0: 77 20 79 6f 75 72 0a 4f 70 65 6e 53 53 4c 20 6c w your.OpenSSL l
70e0: 69 62 72 61 72 79 20 77 61 73 20 63 6f 6e 66 69 ibrary was confi
70f0: 67 75 72 65 64 20 61 6e 64 20 62 75 69 6c 74 2e gured and built.
7100: 20 4e 65 77 20 76 65 72 73 69 6f 6e 73 20 6d 61 New versions ma
7110: 79 20 6f 62 73 6f 6c 65 74 65 20 6f 6c 64 65 72 y obsolete older
7120: 0a 70 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f .protocol versio
7130: 6e 73 2c 20 61 64 64 20 6f 72 20 72 65 6d 6f 76 ns, add or remov
7140: 65 20 63 69 70 68 65 72 73 2c 20 63 68 61 6e 67 e ciphers, chang
7150: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 e default values
7160: 2c 20 65 74 63 2e 20 55 73 65 20 74 68 65 0a 3c , etc. Use the.<
7170: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 69 70 68 strong>tls::ciph
7180: 65 72 73 3c 2f 73 74 72 6f 6e 67 3e 20 61 6e 64 ers</strong> and
7190: 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 72 <strong>tls::pr
71a0: 6f 74 6f 63 6f 6c 73 3c 2f 73 74 72 6f 6e 67 3e otocols</strong>
71b0: 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 6f 62 74 commands to.obt
71c0: 61 69 6e 20 74 68 65 20 73 75 70 70 6f 72 74 65 ain the supporte
71d0: 64 20 76 65 72 73 69 6f 6e 73 2e 3c 2f 70 3e 0a d versions.</p>.
71e0: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 45 .<h3><a name="SE
71f0: 45 20 41 4c 53 4f 22 3e 53 45 45 20 41 4c 53 4f E ALSO">SEE ALSO
7200: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 73 </a></h3>..<p><s
7210: 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 3c 2f 73 74 trong>socket</st
7220: 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e 66 rong>, <strong>f
7230: 69 6c 65 65 76 65 6e 74 2c 20 3c 2f 73 74 72 6f ileevent, </stro
7240: 6e 67 3e 3c 61 0a 68 72 65 66 3d 22 68 74 74 70 ng><a.href="http
7250: 3a 2f 2f 77 77 77 2e 6f 70 65 6e 73 73 6c 2e 6f ://www.openssl.o
7260: 72 67 2f 22 3e 3c 73 74 72 6f 6e 67 3e 4f 70 65 rg/"><strong>Ope
7270: 6e 53 53 4c 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 nSSL</strong></a
7280: 3e 3c 2f 70 3e 0a 0a 3c 68 72 3e 0a 0a 3c 70 72 ></p>..<hr>..<pr
7290: 65 3e 0a 43 6f 70 79 72 69 67 68 74 20 26 63 6f e>.Copyright &co
72a0: 70 79 3b 20 31 39 39 39 20 4d 61 74 74 20 4e 65 py; 1999 Matt Ne
72b0: 77 6d 61 6e 2e 0a 43 6f 70 79 72 69 67 68 74 20 wman..Copyright
72c0: 26 63 6f 70 79 3b 20 32 30 30 34 20 53 74 61 72 © 2004 Star
72d0: 66 69 73 68 20 53 79 73 74 65 6d 73 2e 0a 3c 2f fish Systems..</
72e0: 70 72 65 3e 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 pre>.</body>.</h
72f0: 74 6d 6c 3e 0a tml>.