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 54 79 70 65 ng>signatureType
2f30: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 74 79 </strong> <em>ty
2f40: 70 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 pe</em></dt>..<d
2f50: 64 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 20 d>The signature
2f60: 74 79 70 65 20 76 61 6c 75 65 2e 3c 2f 64 64 3e type value.</dd>
2f70: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 76 65 ..<dt><strong>ve
2f80: 72 69 66 79 44 65 70 74 68 3c 2f 73 74 72 6f 6e rifyDepth</stron
2f90: 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 g> <em>n</em></d
2fa0: 74 3e 0a 09 3c 64 64 3e 4d 61 78 69 6d 75 6d 20 t>..<dd>Maximum
2fb0: 64 65 70 74 68 20 66 6f 72 20 74 68 65 20 63 65 depth for the ce
2fc0: 72 74 69 66 69 63 61 74 65 20 63 68 61 69 6e 20 rtificate chain
2fd0: 76 65 72 69 66 69 63 61 74 69 6f 6e 2e 0a 09 20 verification...
2fe0: 20 20 20 44 65 66 61 75 6c 74 20 69 73 20 2d 31 Default is -1
2ff0: 2c 20 74 6f 20 63 68 65 63 6b 20 61 6c 6c 2e 3c , to check all.<
3000: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
3010: 67 3e 76 65 72 69 66 79 4d 6f 64 65 3c 2f 73 74 g>verifyMode</st
3020: 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f rong> <em>list</
3030: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 em></dt>..<dd>Li
3040: 73 74 20 6f 66 20 63 65 72 74 69 66 69 63 61 74 st of certificat
3050: 65 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 6d e verification m
3060: 6f 64 65 73 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e odes.</dd>..<dt>
3070: 3c 73 74 72 6f 6e 67 3e 76 65 72 69 66 79 52 65 <strong>verifyRe
3080: 73 75 6c 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 sult</strong> <e
3090: 6d 3e 72 65 73 75 6c 74 3c 2f 65 6d 3e 3c 2f 64 m>result</em></d
30a0: 74 3e 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 t>..<dd>Certific
30b0: 61 74 65 20 76 65 72 69 66 69 63 61 74 69 6f 6e ate verification
30c0: 20 72 65 73 75 6c 74 2e 3c 2f 64 64 3e 0a 09 3c result.</dd>..<
30d0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 63 61 5f 6e 61 dt><strong>ca_na
30e0: 6d 65 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d mes</strong> <em
30f0: 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >list</em></dt>.
3100: 09 3c 64 64 3e 4c 69 73 74 20 6f 66 20 74 68 65 .<dd>List of the
3110: 20 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 Certificate Aut
3120: 68 6f 72 69 74 69 65 73 20 75 73 65 64 20 74 6f horities used to
3130: 20 63 72 65 61 74 65 20 74 68 65 20 63 65 72 74 create the cert
3140: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 20 20 ificate.</dd>.
3150: 20 20 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 </dl>.</blockq
3160: 75 6f 74 65 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 uote>.<blockquot
3170: 65 3e 0a 09 3c 62 3e 43 65 72 74 69 66 69 63 61 e>..<b>Certifica
3180: 74 65 20 53 74 61 74 75 73 3c 2f 62 3e 0a 20 20 te Status</b>.
3190: 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 <dl>..<dt><str
31a0: 6f 6e 67 3e 61 6c 6c 3c 2f 73 74 72 6f 6e 67 3e ong>all</strong>
31b0: 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e <em>string</em>
31c0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 44 75 6d 70 20 </dt>..<dd>Dump
31d0: 6f 66 20 61 6c 6c 20 63 65 72 74 69 66 69 63 61 of all certifica
31e0: 74 65 20 69 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 09 te info.</dd>...
31f0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 76 65 72 73 <dt><strong>vers
3200: 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ion</strong> <em
3210: 3e 76 61 6c 75 65 3c 2f 65 6d 3e 3c 2f 64 74 3e >value</em></dt>
3220: 0a 09 3c 64 64 3e 54 68 65 20 63 65 72 74 69 66 ..<dd>The certif
3230: 69 63 61 74 65 20 76 65 72 73 69 6f 6e 2e 3c 2f icate version.</
3240: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
3250: 3e 73 65 72 69 61 6c 4e 75 6d 62 65 72 3c 2f 73 >serialNumber</s
3260: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d trong> <em>n</em
3270: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 ></dt>..<dd>The
3280: 73 65 72 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 serial number of
3290: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
32a0: 20 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c as hex string.<
32b0: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
32c0: 67 3e 73 69 67 6e 61 74 75 72 65 3c 2f 73 74 72 g>signature</str
32d0: 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 74 ong> <em>algorit
32e0: 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 hm</em></dt>..<d
32f0: 64 3e 43 69 70 68 65 72 20 61 6c 67 6f 72 69 74 d>Cipher algorit
3300: 68 6d 20 75 73 65 64 20 66 6f 72 20 63 65 72 74 hm used for cert
3310: 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 ificate signatur
3320: 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 e.</dd>..<dt><st
3330: 72 6f 6e 67 3e 69 73 73 75 65 72 3c 2f 73 74 72 rong>issuer</str
3340: 6f 6e 67 3e 20 3c 65 6d 3e 64 6e 3c 2f 65 6d 3e ong> <em>dn</em>
3350: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 64 </dt>..<dd>The d
3360: 69 73 74 69 6e 67 75 69 73 68 65 64 20 6e 61 6d istinguished nam
3370: 65 20 28 44 4e 29 20 6f 66 20 74 68 65 20 63 65 e (DN) of the ce
3380: 72 74 69 66 69 63 61 74 65 20 69 73 73 75 65 72 rtificate issuer
3390: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
33a0: 6f 6e 67 3e 6e 6f 74 42 65 66 6f 72 65 3c 2f 73 ong>notBefore</s
33b0: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 65 3c trong> <em>date<
33c0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
33d0: 68 65 20 62 65 67 69 6e 20 64 61 74 65 20 66 6f he begin date fo
33e0: 72 20 74 68 65 20 76 61 6c 69 64 69 74 79 20 6f r the validity o
33f0: 66 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 f the certificat
3400: 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 e.</dd>..<dt><st
3410: 72 6f 6e 67 3e 6e 6f 74 41 66 74 65 72 3c 2f 73 rong>notAfter</s
3420: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 65 3c trong> <em>date<
3430: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
3440: 68 65 20 65 78 70 69 72 61 74 69 6f 6e 20 64 61 he expiration da
3450: 74 65 20 66 6f 72 20 74 68 65 20 63 65 72 74 69 te for the certi
3460: 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c 64 ficate.</dd>..<d
3470: 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 6a 65 63 t><strong>subjec
3480: 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 t</strong> <em>d
3490: 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 n</em></dt>..<dd
34a0: 3e 54 68 65 20 64 69 73 74 69 6e 67 75 69 73 68 >The distinguish
34b0: 65 64 20 6e 61 6d 65 20 28 44 4e 29 20 6f 66 20 ed name (DN) of
34c0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
34d0: 73 75 62 6a 65 63 74 2e 0a 09 20 20 20 20 46 69 subject... Fi
34e0: 65 6c 64 73 20 69 6e 63 6c 75 64 65 3a 20 43 6f elds include: Co
34f0: 6d 6d 6f 6e 20 4e 61 6d 65 20 28 43 4e 29 2c 20 mmon Name (CN),
3500: 4f 72 67 61 6e 69 7a 61 74 69 6f 6e 20 28 4f 29 Organization (O)
3510: 2c 20 4c 6f 63 61 6c 69 74 79 0a 09 20 20 20 20 , Locality..
3520: 6f 72 20 43 69 74 79 20 28 4c 29 2c 20 53 74 61 or City (L), Sta
3530: 74 65 20 6f 72 20 50 72 6f 76 69 6e 63 65 20 28 te or Province (
3540: 53 29 2c 20 61 6e 64 20 43 6f 75 6e 74 72 79 20 S), and Country
3550: 4e 61 6d 65 20 28 43 29 2e 3c 2f 64 64 3e 0a 09 Name (C).</dd>..
3560: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 73 73 75 <dt><strong>issu
3570: 65 72 55 6e 69 71 75 65 49 44 3c 2f 73 74 72 6f erUniqueID</stro
3580: 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f ng> <em>string</
3590: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
35a0: 65 20 69 73 73 75 65 72 20 75 6e 69 71 75 65 20 e issuer unique
35b0: 69 64 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 id.</dd>..<dt><s
35c0: 74 72 6f 6e 67 3e 73 75 62 6a 65 63 74 55 6e 69 trong>subjectUni
35d0: 71 75 65 49 44 3c 2f 73 74 72 6f 6e 67 3e 20 3c queID</strong> <
35e0: 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f em>string</em></
35f0: 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 73 75 62 dt>..<dd>The sub
3600: 6a 65 63 74 20 75 6e 69 71 75 65 20 69 64 2e 3c ject unique id.<
3610: 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f /dd>...<dt><stro
3620: 6e 67 3e 6e 75 6d 5f 65 78 74 65 6e 73 69 6f 6e ng>num_extension
3630: 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e s</strong> <em>n
3640: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
3650: 4e 75 6d 62 65 72 20 6f 66 20 63 65 72 74 69 66 Number of certif
3660: 69 63 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 73 icate extensions
3670: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3680: 6f 6e 67 3e 65 78 74 65 6e 73 69 6f 6e 73 3c 2f ong>extensions</
3690: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 strong> <em>list
36a0: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
36b0: 4c 69 73 74 20 6f 66 20 63 65 72 74 69 66 69 63 List of certific
36c0: 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6e 61 ate extension na
36d0: 6d 65 73 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c mes.</dd>..<dt><
36e0: 73 74 72 6f 6e 67 3e 61 75 74 68 6f 72 69 74 79 strong>authority
36f0: 4b 65 79 49 64 65 6e 74 69 66 69 65 72 3c 2f 73 KeyIdentifier</s
3700: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
3710: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
3720: 3e 28 41 4b 49 29 20 4b 65 79 20 69 64 65 6e 74 >(AKI) Key ident
3730: 69 66 69 65 72 20 6f 66 20 74 68 65 20 49 73 73 ifier of the Iss
3740: 75 69 6e 67 20 43 41 20 63 65 72 74 69 66 69 63 uing CA certific
3750: 61 74 65 20 74 68 61 74 20 73 69 67 6e 65 64 0a ate that signed.
3760: 09 20 20 20 20 74 68 65 20 53 53 4c 20 63 65 72 . the SSL cer
3770: 74 69 66 69 63 61 74 65 20 61 73 20 68 65 78 20 tificate as hex
3780: 73 74 72 69 6e 67 2e 20 54 68 69 73 20 76 61 6c string. This val
3790: 75 65 20 6d 61 74 63 68 65 73 20 74 68 65 20 53 ue matches the S
37a0: 4b 49 0a 09 20 20 20 20 76 61 6c 75 65 20 6f 66 KI.. value of
37b0: 20 74 68 65 20 49 6e 74 65 72 6d 65 64 69 61 74 the Intermediat
37c0: 65 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 e CA certificate
37d0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
37e0: 6f 6e 67 3e 73 75 62 6a 65 63 74 4b 65 79 49 64 ong>subjectKeyId
37f0: 65 6e 74 69 66 69 65 72 3c 2f 73 74 72 6f 6e 67 entifier</strong
3800: 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d > <em>string</em
3810: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 28 53 4b 49 ></dt>..<dd>(SKI
3820: 29 20 48 61 73 68 20 6f 66 20 74 68 65 20 70 75 ) Hash of the pu
3830: 62 6c 69 63 20 6b 65 79 20 69 6e 73 69 64 65 20 blic key inside
3840: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
3850: 61 73 20 68 65 78 0a 09 20 20 20 73 74 72 69 6e as hex.. strin
3860: 67 2e 20 55 73 65 64 20 74 6f 20 69 64 65 6e 74 g. Used to ident
3870: 69 66 79 20 63 65 72 74 69 66 69 63 61 74 65 73 ify certificates
3880: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 20 61 20 that contain a
3890: 70 61 72 74 69 63 75 6c 61 72 0a 09 20 20 20 70 particular.. p
38a0: 75 62 6c 69 63 20 6b 65 79 2e 3c 2f 64 64 3e 0a ublic key.</dd>.
38b0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 .<dt><strong>sub
38c0: 6a 65 63 74 41 6c 74 4e 61 6d 65 3c 2f 73 74 72 jectAltName</str
38d0: 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f 65 ong> <em>list</e
38e0: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 m></dt>..<dd>Lis
38f0: 74 20 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 20 t of all of the
3900: 61 6c 74 65 72 6e 61 74 69 76 65 20 64 6f 6d 61 alternative doma
3910: 69 6e 20 6e 61 6d 65 73 2c 20 73 75 62 20 64 6f in names, sub do
3920: 6d 61 69 6e 73 2c 0a 09 20 20 20 20 61 6e 64 20 mains,.. and
3930: 49 50 20 61 64 64 72 65 73 73 65 73 20 74 68 61 IP addresses tha
3940: 74 20 61 72 65 20 73 65 63 75 72 65 64 20 62 79 t are secured by
3950: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
3960: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3970: 6f 6e 67 3e 6f 63 73 70 3c 2f 73 74 72 6f 6e 67 ong>ocsp</strong
3980: 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f 65 6d 3e 3c > <em>list</em><
3990: 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 74 20 6f /dt>..<dd>List o
39a0: 66 20 61 6c 6c 20 4f 6e 6c 69 6e 65 20 43 65 72 f all Online Cer
39b0: 74 69 66 69 63 61 74 65 20 53 74 61 74 75 73 20 tificate Status
39c0: 50 72 6f 74 6f 63 6f 6c 20 28 4f 43 53 50 29 20 Protocol (OCSP)
39d0: 55 52 4c 73 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 74 URLs.</dd>...<dt
39e0: 3e 3c 73 74 72 6f 6e 67 3e 63 65 72 74 69 66 69 ><strong>certifi
39f0: 63 61 74 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 cate</strong> <e
3a00: 6d 3e 63 65 72 74 3c 2f 65 6d 3e 3c 2f 64 74 3e m>cert</em></dt>
3a10: 0a 09 3c 64 64 3e 54 68 65 20 50 45 4d 20 65 6e ..<dd>The PEM en
3a20: 63 6f 64 65 64 20 63 65 72 74 69 66 69 63 61 74 coded certificat
3a30: 65 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 e.</dd>...<dt><s
3a40: 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 72 65 41 trong>signatureA
3a50: 6c 67 6f 72 69 74 68 6d 3c 2f 73 74 72 6f 6e 67 lgorithm</strong
3a60: 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 74 68 6d 3c > <em>algorithm<
3a70: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 /em></dt>..<dd>C
3a80: 69 70 68 65 72 20 61 6c 67 6f 72 69 74 68 6d 20 ipher algorithm
3a90: 75 73 65 64 20 66 6f 72 20 63 65 72 74 69 66 69 used for certifi
3aa0: 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 2e 3c cate signature.<
3ab0: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
3ac0: 67 3e 73 69 67 6e 61 74 75 72 65 56 61 6c 75 65 g>signatureValue
3ad0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 </strong> <em>st
3ae0: 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 ring</em></dt>..
3af0: 3c 64 64 3e 43 65 72 74 69 66 69 63 61 74 65 20 <dd>Certificate
3b00: 73 69 67 6e 61 74 75 72 65 20 61 73 20 68 65 78 signature as hex
3b10: 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 09 3c string.</dd>..<
3b20: 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 69 67 6e 61 dt><strong>signa
3b30: 74 75 72 65 44 69 67 65 73 74 3c 2f 73 74 72 6f tureDigest</stro
3b40: 6e 67 3e 20 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c ng> <em>version<
3b50: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 /em></dt>..<dd>C
3b60: 65 72 74 69 66 69 63 61 74 65 20 73 69 67 6e 69 ertificate signi
3b70: 6e 67 20 64 69 67 65 73 74 2e 3c 2f 64 64 3e 0a ng digest.</dd>.
3b80: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 75 62 .<dt><strong>pub
3b90: 6c 69 63 4b 65 79 41 6c 67 6f 72 69 74 68 6d 3c licKeyAlgorithm<
3ba0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 /strong> <em>alg
3bb0: 6f 72 69 74 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e orithm</em></dt>
3bc0: 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 61 74 ..<dd>Certificat
3bd0: 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 62 6c e signature publ
3be0: 69 63 20 6b 65 79 20 61 6c 67 6f 72 69 74 68 6d ic key algorithm
3bf0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3c00: 6f 6e 67 3e 70 75 62 6c 69 63 4b 65 79 3c 2f 73 ong>publicKey</s
3c10: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
3c20: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
3c30: 3e 43 65 72 74 69 66 69 63 61 74 65 20 73 69 67 >Certificate sig
3c40: 6e 61 74 75 72 65 20 70 75 62 6c 69 63 20 6b 65 nature public ke
3c50: 79 20 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e y as hex string.
3c60: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
3c70: 6e 67 3e 62 69 74 73 3c 2f 73 74 72 6f 6e 67 3e ng>bits</strong>
3c80: 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e <em>n</em></dt>
3c90: 0a 09 3c 64 64 3e 4e 75 6d 62 65 72 20 6f 66 20 ..<dd>Number of
3ca0: 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 63 65 bits used for ce
3cb0: 72 74 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 rtificate signat
3cc0: 75 72 65 20 6b 65 79 3c 2f 64 64 3e 0a 09 3c 64 ure key</dd>..<d
3cd0: 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 6c 66 5f 73 t><strong>self_s
3ce0: 69 67 6e 65 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c igned</strong> <
3cf0: 65 6d 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c em>boolean</em><
3d00: 2f 64 74 3e 0a 09 3c 64 64 3e 49 73 20 63 65 72 /dt>..<dd>Is cer
3d10: 74 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 tificate signatu
3d20: 72 65 20 73 65 6c 66 20 73 69 67 6e 65 64 2e 3c re self signed.<
3d30: 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f /dd>...<dt><stro
3d40: 6e 67 3e 73 68 61 31 5f 68 61 73 68 3c 2f 73 74 ng>sha1_hash</st
3d50: 72 6f 6e 67 3e 20 3c 65 6d 3e 68 61 73 68 3c 2f rong> <em>hash</
3d60: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
3d70: 65 20 53 48 41 31 20 68 61 73 68 20 6f 66 20 74 e SHA1 hash of t
3d80: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 he certificate a
3d90: 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 s hex string.</d
3da0: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
3db0: 73 68 61 32 35 36 5f 68 61 73 68 3c 2f 73 74 72 sha256_hash</str
3dc0: 6f 6e 67 3e 20 3c 65 6d 3e 68 61 73 68 3c 2f 65 ong> <em>hash</e
3dd0: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 m></dt>..<dd>The
3de0: 20 53 48 41 32 35 36 20 68 61 73 68 20 6f 66 20 SHA256 hash of
3df0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
3e00: 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f as hex string.</
3e10: 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a 3c 2f dd>. </dl>.</
3e20: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
3e30: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
3e40: 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 22 3e 3c s::connection"><
3e50: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 6f 6e 6e strong>tls::conn
3e60: 65 63 74 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 0a ection</strong>.
3e70: 20 20 20 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 3c <em>channel<
3e80: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
3e90: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
3ea0: 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63 e current connec
3eb0: 74 69 6f 6e 20 73 74 61 74 75 73 20 6f 66 20 61 tion status of a
3ec0: 6e 20 53 53 4c 20 63 68 61 6e 6e 65 6c 2e 20 54 n SSL channel. T
3ed0: 68 65 0a 09 72 65 73 75 6c 74 20 69 73 20 61 20 he..result is a
3ee0: 6c 69 73 74 20 6f 66 20 6b 65 79 2d 76 61 6c 75 list of key-valu
3ef0: 65 20 70 61 69 72 73 20 64 65 73 63 72 69 62 69 e pairs describi
3f00: 6e 67 20 74 68 65 0a 09 63 6f 6e 6e 65 63 74 65 ng the..connecte
3f10: 64 20 70 65 65 72 2e 3c 2f 64 64 3e 0a 3c 62 6c d peer.</dd>.<bl
3f20: 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e 53 53 ockquote>..<b>SS
3f30: 4c 20 53 74 61 74 75 73 3c 2f 62 3e 0a 20 20 20 L Status</b>.
3f40: 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f <dl>..<dt><stro
3f50: 6e 67 3e 73 74 61 74 65 3c 2f 73 74 72 6f 6e 67 ng>state</strong
3f60: 3e 20 3c 65 6d 3e 73 74 61 74 65 3c 2f 65 6d 3e > <em>state</em>
3f70: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 74 61 74 65 </dt>..<dd>State
3f80: 20 6f 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 of the connecti
3f90: 6f 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 on.</dd>..<dt><s
3fa0: 74 72 6f 6e 67 3e 73 65 72 76 65 72 6e 61 6d 65 trong>servername
3fb0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 </strong> <em>na
3fc0: 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 me</em></dt>..<d
3fd0: 64 3e 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 d>The name of th
3fe0: 65 20 63 6f 6e 6e 65 63 74 65 64 20 74 6f 20 73 e connected to s
3ff0: 65 72 76 65 72 2e 3c 2f 64 64 3e 0a 09 3c 64 74 erver.</dd>..<dt
4000: 3e 3c 73 74 72 6f 6e 67 3e 70 72 6f 74 6f 63 6f ><strong>protoco
4010: 6c 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 76 l</strong> <em>v
4020: 65 72 73 69 6f 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e ersion</em></dt>
4030: 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 6f 63 ..<dd>The protoc
4040: 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 ol version used
4050: 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 for the connecti
4060: 6f 6e 3a 0a 09 20 20 20 20 53 53 4c 32 2c 20 53 on:.. SSL2, S
4070: 53 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 31 2e SL3, TLS1, TLS1.
4080: 31 2c 20 54 4c 53 31 2e 32 2c 20 54 4c 53 31 2e 1, TLS1.2, TLS1.
4090: 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 2e 3c 2f 3, or unknown.</
40a0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
40b0: 3e 72 65 6e 65 67 6f 74 69 61 74 69 6f 6e 3c 2f >renegotiation</
40c0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c strong> <em>bool
40d0: 65 61 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ean</em></dt>..<
40e0: 64 64 3e 57 68 65 74 68 65 72 20 70 72 6f 74 6f dd>Whether proto
40f0: 63 6f 6c 20 72 65 6e 65 67 6f 74 69 61 74 69 6f col renegotiatio
4100: 6e 20 69 73 20 73 75 70 70 6f 72 74 65 64 20 6f n is supported o
4110: 72 20 6e 6f 74 2e 3c 2f 64 64 3e 0a 09 3c 64 74 r not.</dd>..<dt
4120: 3e 3c 73 74 72 6f 6e 67 3e 73 65 63 75 72 69 74 ><strong>securit
4130: 79 6c 65 76 65 6c 3c 2f 73 74 72 6f 6e 67 3e 20 ylevel</strong>
4140: 3c 65 6d 3e 6c 65 76 65 6c 3c 2f 65 6d 3e 3c 2f <em>level</em></
4150: 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 73 65 63 dt>..<dd>The sec
4160: 75 72 69 74 79 20 6c 65 76 65 6c 20 75 73 65 64 urity level used
4170: 20 66 6f 72 20 73 65 6c 65 63 74 69 6f 6e 20 6f for selection o
4180: 66 20 63 69 70 68 65 72 73 2c 20 6b 65 79 20 73 f ciphers, key s
4190: 69 7a 65 2c 20 65 74 63 2e 3c 2f 64 64 3e 0a 09 ize, etc.</dd>..
41a0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 73 73 <dt><strong>sess
41b0: 69 6f 6e 5f 72 65 75 73 65 64 3c 2f 73 74 72 6f ion_reused</stro
41c0: 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 61 6e 3c ng> <em>boolean<
41d0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 57 /em></dt>..<dd>W
41e0: 68 65 74 68 65 72 20 74 68 65 20 73 65 73 73 69 hether the sessi
41f0: 6f 6e 20 68 61 73 20 62 65 65 6e 20 72 65 75 73 on has been reus
4200: 65 64 20 6f 72 20 6e 6f 74 2e 3c 2f 64 64 3e 0a ed or not.</dd>.
4210: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 73 5f .<dt><strong>is_
4220: 73 65 72 76 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 server</strong>
4230: 3c 65 6d 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e <em>boolean</em>
4240: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 57 68 65 74 68 </dt>..<dd>Wheth
4250: 65 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f er the connectio
4260: 6e 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 n is configured
4270: 61 73 20 61 20 73 65 72 76 65 72 20 28 31 29 20 as a server (1)
4280: 6f 72 20 63 6c 69 65 6e 74 20 28 30 29 2e 3c 2f or client (0).</
4290: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
42a0: 3e 63 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 73 74 >compression</st
42b0: 72 6f 6e 67 3e 20 3c 65 6d 3e 6d 6f 64 65 3c 2f rong> <em>mode</
42c0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 6f em></dt>..<dd>Co
42d0: 6d 70 72 65 73 73 69 6f 6e 20 6d 65 74 68 6f 64 mpression method
42e0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
42f0: 6f 6e 67 3e 65 78 70 61 6e 73 69 6f 6e 3c 2f 73 ong>expansion</s
4300: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6d 6f 64 65 3c trong> <em>mode<
4310: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 45 /em></dt>..<dd>E
4320: 78 70 61 6e 73 69 6f 6e 20 6d 65 74 68 6f 64 2e xpansion method.
4330: 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a </dd>. </dl>.
4340: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 </blockquote>.<b
4350: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e 43 lockquote>..<b>C
4360: 69 70 68 65 72 20 49 6e 66 6f 3c 2f 62 3e 0a 20 ipher Info</b>.
4370: 20 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 <dl>..<dt><st
4380: 72 6f 6e 67 3e 63 69 70 68 65 72 3c 2f 73 74 72 rong>cipher</str
4390: 6f 6e 67 3e 20 3c 65 6d 3e 63 69 70 68 65 72 3c ong> <em>cipher<
43a0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
43b0: 68 65 20 63 75 72 72 65 6e 74 20 63 69 70 68 65 he current ciphe
43c0: 72 20 69 6e 20 75 73 65 20 66 6f 72 20 74 68 65 r in use for the
43d0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 3c 2f 64 64 connection.</dd
43e0: 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 >..<dt><strong>s
43f0: 74 61 6e 64 61 72 64 5f 6e 61 6d 65 3c 2f 73 74 tandard_name</st
4400: 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f rong> <em>name</
4410: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
4420: 65 20 73 74 61 6e 64 61 72 64 20 52 46 43 20 6e e standard RFC n
4430: 61 6d 65 20 6f 66 20 63 69 70 68 65 72 2e 3c 2f ame of cipher.</
4440: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
4450: 3e 62 69 74 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c >bits</strong> <
4460: 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 em>n</em></dt>..
4470: 3c 64 64 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f <dd>The number o
4480: 66 20 70 72 6f 63 65 73 73 65 64 20 62 69 74 73 f processed bits
4490: 20 75 73 65 64 20 66 6f 72 20 63 69 70 68 65 72 used for cipher
44a0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
44b0: 6f 6e 67 3e 73 65 63 72 65 74 5f 62 69 74 73 3c ong>secret_bits<
44c0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f /strong> <em>n</
44d0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
44e0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 63 72 e number of secr
44f0: 65 74 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 et bits used for
4500: 20 63 69 70 68 65 72 2e 3c 2f 64 64 3e 0a 09 3c cipher.</dd>..<
4510: 64 74 3e 3c 73 74 72 6f 6e 67 3e 6d 69 6e 5f 76 dt><strong>min_v
4520: 65 72 73 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 ersion</strong>
4530: 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c 2f 65 6d 3e <em>version</em>
4540: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 6d </dt>..<dd>The m
4550: 69 6e 69 6d 75 6d 20 70 72 6f 74 6f 63 6f 6c 20 inimum protocol
4560: 76 65 72 73 69 6f 6e 20 66 6f 72 20 63 69 70 68 version for ciph
4570: 65 72 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 er.</dd>..<dt><s
4580: 74 72 6f 6e 67 3e 69 64 3c 2f 73 74 72 6f 6e 67 trong>id</strong
4590: 3e 20 3c 65 6d 3e 69 64 3c 2f 65 6d 3e 3c 2f 64 > <em>id</em></d
45a0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 4f 70 65 6e t>..<dd>The Open
45b0: 53 53 4c 20 63 69 70 68 65 72 20 69 64 2e 3c 2f SSL cipher id.</
45c0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
45d0: 3e 64 65 73 63 72 69 70 74 69 6f 6e 3c 2f 73 74 >description</st
45e0: 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 rong> <em>string
45f0: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
4600: 41 20 74 65 78 74 20 64 65 73 63 72 69 70 74 69 A text descripti
4610: 6f 6e 20 6f 66 20 74 68 65 20 63 69 70 68 65 72 on of the cipher
4620: 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e .</dd>. </dl>
4630: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c .</blockquote>.<
4640: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e blockquote>..<b>
4650: 53 65 73 73 69 6f 6e 20 49 6e 66 6f 3c 2f 62 3e Session Info</b>
4660: 0a 20 20 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c . <dl>..<dt><
4670: 73 74 72 6f 6e 67 3e 61 6c 70 6e 3c 2f 73 74 72 strong>alpn</str
4680: 6f 6e 67 3e 20 3c 65 6d 3e 70 72 6f 74 6f 63 6f ong> <em>protoco
4690: 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 l</em></dt>..<dd
46a0: 3e 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 73 65 >The protocol se
46b0: 6c 65 63 74 65 64 20 61 66 74 65 72 20 41 70 70 lected after App
46c0: 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 20 50 lication-Layer P
46d0: 72 6f 74 6f 63 6f 6c 0a 09 20 20 20 20 4e 65 67 rotocol.. Neg
46e0: 6f 74 69 61 74 69 6f 6e 20 28 41 4c 50 4e 29 2e otiation (ALPN).
46f0: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
4700: 6e 67 3e 72 65 73 75 6d 61 62 6c 65 3c 2f 73 74 ng>resumable</st
4710: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 61 rong> <em>boolea
4720: 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 n</em></dt>..<dd
4730: 3e 43 61 6e 20 74 68 65 20 73 65 73 73 69 6f 6e >Can the session
4740: 20 62 65 20 72 65 73 75 6d 65 64 20 6f 72 20 6e be resumed or n
4750: 6f 74 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ot.</dd>..<dt><s
4760: 74 72 6f 6e 67 3e 73 74 61 72 74 5f 74 69 6d 65 trong>start_time
4770: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 65 </strong> <em>se
4780: 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a conds</em></dt>.
4790: 09 3c 64 64 3e 54 69 6d 65 20 73 69 6e 63 65 20 .<dd>Time since
47a0: 73 65 73 73 69 6f 6e 20 73 74 61 72 74 65 64 20 session started
47b0: 69 6e 20 73 65 63 6f 6e 64 73 20 73 69 6e 63 65 in seconds since
47c0: 20 65 70 6f 63 68 2e 3c 2f 64 64 3e 0a 09 3c 64 epoch.</dd>..<d
47d0: 74 3e 3c 73 74 72 6f 6e 67 3e 74 69 6d 65 6f 75 t><strong>timeou
47e0: 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 t</strong> <em>s
47f0: 65 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f 64 74 3e econds</em></dt>
4800: 0a 09 3c 64 64 3e 4d 61 78 20 64 75 72 61 74 69 ..<dd>Max durati
4810: 6f 6e 20 6f 66 20 73 65 73 73 69 6f 6e 20 69 6e on of session in
4820: 20 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 seconds before
4830: 74 69 6d 65 2d 6f 75 74 2e 3c 2f 64 64 3e 0a 09 time-out.</dd>..
4840: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 6c 69 66 65 <dt><strong>life
4850: 74 69 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 time</strong> <e
4860: 6d 3e 73 65 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f m>seconds</em></
4870: 64 74 3e 0a 09 3c 64 64 3e 53 65 73 73 69 6f 6e dt>..<dd>Session
4880: 20 74 69 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 ticket lifetime
4890: 20 68 69 6e 74 20 69 6e 20 73 65 63 6f 6e 64 73 hint in seconds
48a0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
48b0: 6f 6e 67 3e 73 65 73 73 69 6f 6e 5f 69 64 3c 2f ong>session_id</
48c0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 strong> <em>bina
48d0: 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f ry_string</em></
48e0: 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 dt>..<dd>Unique
48f0: 73 65 73 73 69 6f 6e 20 69 64 20 66 6f 72 20 75 session id for u
4900: 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 20 74 se in resuming t
4910: 68 65 20 73 65 73 73 69 6f 6e 2e 3c 2f 64 64 3e he session.</dd>
4920: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 ..<dt><strong>se
4930: 73 73 69 6f 6e 5f 74 69 63 6b 65 74 3c 2f 73 74 ssion_ticket</st
4940: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 72 79 rong> <em>binary
4950: 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 _string</em></dt
4960: 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 73 65 >..<dd>Unique se
4970: 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 66 6f 72 ssion ticket for
4980: 20 75 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 use in resuming
4990: 20 74 68 65 20 73 65 73 73 69 6f 6e 2e 3c 2f 64 the session.</d
49a0: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
49b0: 74 69 63 6b 65 74 5f 61 70 70 5f 64 61 74 61 3c ticket_app_data<
49c0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e /strong> <em>bin
49d0: 61 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c ary_string</em><
49e0: 2f 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 /dt>..<dd>Unique
49f0: 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 session ticket
4a00: 61 70 70 6c 69 63 61 74 69 6f 6e 20 64 61 74 61 application data
4a10: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4a20: 6f 6e 67 3e 6d 61 73 74 65 72 5f 6b 65 79 3c 2f ong>master_key</
4a30: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 strong> <em>bina
4a40: 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f ry_string</em></
4a50: 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 dt>..<dd>Unique
4a60: 73 65 73 73 69 6f 6e 20 6d 61 73 74 65 72 20 6b session master k
4a70: 65 79 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ey.</dd>..<dt><s
4a80: 74 72 6f 6e 67 3e 73 65 73 73 69 6f 6e 5f 63 61 trong>session_ca
4a90: 63 68 65 5f 6d 6f 64 65 3c 2f 73 74 72 6f 6e 67 che_mode</strong
4aa0: 3e 20 3c 65 6d 3e 6d 6f 64 65 3c 2f 65 6d 3e 3c > <em>mode</em><
4ab0: 2f 64 74 3e 0a 09 3c 64 64 3e 53 65 72 76 65 72 /dt>..<dd>Server
4ac0: 20 63 61 63 68 65 20 6d 6f 64 65 20 28 63 6c 69 cache mode (cli
4ad0: 65 6e 74 2c 20 73 65 72 76 65 72 2c 20 6f 72 20 ent, server, or
4ae0: 62 6f 74 68 29 2e 3c 2f 64 64 3e 0a 20 20 20 20 both).</dd>.
4af0: 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </dl>.</blockquo
4b00: 74 65 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 te>.. <dt><a
4b10: 6e 61 6d 65 3d 22 74 6c 73 3a 3a 63 69 70 68 65 name="tls::ciphe
4b20: 72 73 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a rs"><strong>tls:
4b30: 3a 63 69 70 68 65 72 73 3c 2f 73 74 72 6f 6e 67 :ciphers</strong
4b40: 3e 0a 20 20 20 20 3c 65 6d 3e 70 72 6f 74 6f 63 >. <em>protoc
4b50: 6f 6c 20 3f 76 65 72 62 6f 73 65 3f 20 3f 73 75 ol ?verbose? ?su
4b60: 70 70 6f 72 74 65 64 3f 3c 2f 65 6d 3e 3c 2f 61 pported?</em></a
4b70: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 ></dt>. <dd>R
4b80: 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 eturns a list of
4b90: 20 73 75 70 70 6f 72 74 65 64 20 63 69 70 68 65 supported ciphe
4ba0: 72 73 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 rs available for
4bb0: 20 3c 65 6d 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 65 <em>protocol</e
4bc0: 6d 3e 2c 0a 09 77 68 65 72 65 20 70 72 6f 74 6f m>,..where proto
4bd0: 63 6f 6c 20 6d 75 73 74 20 62 65 20 6f 6e 65 20 col must be one
4be0: 6f 66 20 3c 62 3e 73 73 6c 32 2c 20 73 73 6c 33 of <b>ssl2, ssl3
4bf0: 2c 20 74 6c 73 31 2c 20 74 6c 73 31 2e 31 2c 0a , tls1, tls1.1,.
4c00: 09 74 6c 73 31 2e 32 2c 3c 2f 62 3e 20 6f 72 20 .tls1.2,</b> or
4c10: 3c 62 3e 74 6c 73 31 2e 33 3c 2f 62 3e 2e 20 49 <b>tls1.3</b>. I
4c20: 66 20 3c 65 6d 3e 76 65 72 62 6f 73 65 3c 2f 65 f <em>verbose</e
4c30: 6d 3e 20 69 73 20 73 70 65 63 69 66 69 65 64 20 m> is specified
4c40: 61 73 0a 09 74 72 75 65 20 74 68 65 6e 20 61 20 as..true then a
4c50: 76 65 72 62 6f 73 65 2c 20 68 75 6d 61 6e 20 72 verbose, human r
4c60: 65 61 64 61 62 6c 65 20 6c 69 73 74 20 69 73 20 eadable list is
4c70: 72 65 74 75 72 6e 65 64 20 77 69 74 68 0a 09 61 returned with..a
4c80: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d dditional inform
4c90: 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 63 69 70 ation on the cip
4ca0: 68 65 72 2e 20 49 66 20 3c 65 6d 3e 73 75 70 70 her. If <em>supp
4cb0: 6f 72 74 65 64 3c 2f 65 6d 3e 0a 09 69 73 20 73 orted</em>..is s
4cc0: 70 65 63 69 66 69 65 64 20 61 73 20 74 72 75 65 pecified as true
4cd0: 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 20 , then only the
4ce0: 63 69 70 68 65 72 73 20 73 75 70 70 6f 72 74 65 ciphers supporte
4cf0: 64 20 66 6f 72 20 70 72 6f 74 6f 63 6f 6c 0a 09 d for protocol..
4d00: 77 69 6c 6c 20 62 65 20 6c 69 73 74 65 64 2e 3c will be listed.<
4d10: 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 /dd>.. <dt><a
4d20: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 70 72 6f 74 name="tls::prot
4d30: 6f 63 6f 6c 73 22 3e 3c 73 74 72 6f 6e 67 3e 74 ocols"><strong>t
4d40: 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 73 ls::protocols</s
4d50: 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a trong></a></dt>.
4d60: 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 <dd>Returns
4d70: 61 20 6c 69 73 74 20 6f 66 20 73 75 70 70 6f 72 a list of suppor
4d80: 74 65 64 20 70 72 6f 74 6f 63 6f 6c 73 2e 20 56 ted protocols. V
4d90: 61 6c 69 64 20 76 61 6c 75 65 73 20 61 72 65 3a alid values are:
4da0: 0a 09 3c 62 3e 73 73 6c 32 3c 2f 62 3e 2c 20 3c ..<b>ssl2</b>, <
4db0: 62 3e 73 73 6c 33 3c 2f 62 3e 2c 20 3c 62 3e 74 b>ssl3</b>, <b>t
4dc0: 6c 73 31 3c 2f 62 3e 2c 20 3c 62 3e 74 6c 73 31 ls1</b>, <b>tls1
4dd0: 2e 31 3c 2f 62 3e 2c 20 3c 62 3e 74 6c 73 31 2e .1</b>, <b>tls1.
4de0: 32 3c 2f 62 3e 2c 0a 09 61 6e 64 20 3c 62 3e 74 2</b>,..and <b>t
4df0: 6c 73 31 2e 33 3c 2f 62 3e 2e 20 45 78 61 63 74 ls1.3</b>. Exact
4e00: 20 6c 69 73 74 20 64 65 70 65 6e 64 73 20 6f 6e list depends on
4e10: 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 69 6f 6e OpenSSL version
4e20: 20 61 6e 64 0a 09 63 6f 6d 70 69 6c 65 20 74 69 and..compile ti
4e30: 6d 65 20 66 6c 61 67 73 2e 3c 2f 64 64 3e 0a 0a me flags.</dd>..
4e40: 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d <dt><a name=
4e50: 22 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 22 3e 3c "tls::version"><
4e60: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 76 65 72 73 strong>tls::vers
4e70: 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e ion</strong></a>
4e80: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 </dt>. <dd>Re
4e90: 74 75 72 6e 73 20 74 68 65 20 4f 70 65 6e 53 53 turns the OpenSS
4ea0: 4c 20 76 65 72 73 69 6f 6e 20 73 74 72 69 6e 67 L version string
4eb0: 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 68 .</dd>.</dl>..<h
4ec0: 33 3e 3c 61 20 6e 61 6d 65 3d 22 43 41 4c 4c 42 3><a name="CALLB
4ed0: 41 43 4b 20 4f 50 54 49 4f 4e 53 22 3e 43 41 4c ACK OPTIONS">CAL
4ee0: 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 3c 2f 61 LBACK OPTIONS</a
4ef0: 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 0a 41 73 20 69 ></h3>..<p>.As i
4f00: 6e 64 69 63 61 74 65 64 20 61 62 6f 76 65 2c 20 ndicated above,
4f10: 69 6e 64 69 76 69 64 75 61 6c 20 63 68 61 6e 6e individual chann
4f20: 65 6c 73 20 63 61 6e 20 62 65 20 67 69 76 65 6e els can be given
4f30: 20 74 68 65 69 72 20 6f 77 6e 20 63 61 6c 6c 62 their own callb
4f40: 61 63 6b 73 0a 74 6f 20 68 61 6e 64 6c 65 20 69 acks.to handle i
4f50: 6e 74 65 72 6d 65 64 69 61 74 65 20 70 72 6f 63 ntermediate proc
4f60: 65 73 73 69 6e 67 20 62 79 20 74 68 65 20 4f 70 essing by the Op
4f70: 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 2c 20 75 enSSL library, u
4f80: 73 69 6e 67 20 74 68 65 0a 3c 73 74 72 6f 6e 67 sing the.<strong
4f90: 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e >-command</stron
4fa0: 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e 2d 70 61 73 g>, <strong>-pas
4fb0: 73 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 20 sword</strong>,
4fc0: 61 6e 64 0a 3c 73 74 72 6f 6e 67 3e 2d 76 61 6c and.<strong>-val
4fd0: 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 3c 2f 73 idate_command</s
4fe0: 74 72 6f 6e 67 3e 20 6f 70 74 69 6f 6e 73 20 70 trong> options p
4ff0: 61 73 73 65 64 20 74 6f 20 65 69 74 68 65 72 20 assed to either
5000: 6f 66 0a 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a of.<strong>tls::
5010: 73 6f 63 6b 65 74 3c 2f 73 74 72 6f 6e 67 3e 20 socket</strong>
5020: 6f 72 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a or <strong>tls::
5030: 69 6d 70 6f 72 74 3c 2f 73 74 72 6f 6e 67 3e 2e import</strong>.
5040: 0a 49 66 20 74 68 65 20 63 61 6c 6c 62 61 63 6b .If the callback
5050: 20 67 65 6e 65 72 61 74 65 73 20 61 6e 20 65 72 generates an er
5060: 72 6f 72 2c 20 74 68 65 20 3c 62 3e 62 67 65 72 ror, the <b>bger
5070: 72 6f 72 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 20 ror</b> command
5080: 77 69 74 68 20 62 65 0a 69 6e 76 6f 6b 65 64 20 with be.invoked
5090: 77 69 74 68 20 74 68 65 20 65 72 72 6f 72 20 69 with the error i
50a0: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 3c 2f 70 3e nformation..</p>
50b0: 0a 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c ..<blockquote>.<
50c0: 64 6c 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 73 74 dl>.. <dt><st
50d0: 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 rong>-command</s
50e0: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 61 6c 6c 62 trong> <em>callb
50f0: 61 63 6b 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 20 20 ack</em></dt>.
5100: 20 20 3c 64 64 3e 0a 09 49 6e 76 6f 6b 65 73 20 <dd>..Invokes
5110: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 3c 65 the specified <e
5120: 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 20 m>callback</em>
5130: 73 63 72 69 70 74 20 61 74 20 73 65 76 65 72 61 script at severa
5140: 6c 20 70 6f 69 6e 74 73 0a 09 64 75 72 69 6e 67 l points..during
5150: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 68 61 6e the OpenSSL han
5160: 64 73 68 61 6b 65 20 61 6e 64 20 75 73 65 2e 20 dshake and use.
5170: 53 65 65 20 62 65 6c 6f 77 20 66 6f 72 20 74 68 See below for th
5180: 65 20 70 6f 73 73 69 62 6c 65 0a 09 61 72 67 75 e possible..argu
5190: 6d 65 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 ments passed to
51a0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 63 72 the callback scr
51b0: 69 70 74 2e 20 56 61 6c 75 65 73 20 72 65 74 75 ipt. Values retu
51c0: 72 6e 65 64 20 66 72 6f 6d 20 74 68 65 0a 09 63 rned from the..c
51d0: 61 6c 6c 62 61 63 6b 20 61 72 65 20 69 67 6e 6f allback are igno
51e0: 72 65 64 2e 0a 0a 09 3c 62 72 3e 0a 09 3c 62 72 red....<br>..<br
51f0: 3e 0a 0a 09 3c 64 6c 3e 0a 0a 09 3c 64 74 3e 0a >...<dl>...<dt>.
5200: 09 20 20 3c 73 74 72 6f 6e 67 3e 65 72 72 6f 72 . <strong>error
5210: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 </strong> <em>ch
5220: 61 6e 6e 65 6c 20 6d 65 73 73 61 67 65 3c 2f 65 annel message</e
5230: 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 64 3e 0a m>..</dt>..<dd>.
5240: 09 20 20 54 68 65 20 3c 65 6d 3e 6d 65 73 73 61 . The <em>messa
5250: 67 65 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e 74 ge</em> argument
5260: 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 65 72 72 contains an err
5270: 6f 72 20 6d 65 73 73 61 67 65 20 67 65 6e 65 72 or message gener
5280: 61 74 65 64 0a 09 20 20 62 79 20 74 68 65 20 4f ated.. by the O
5290: 70 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 20 penSSL function
52a0: 3c 63 6f 64 65 3e 45 52 52 5f 72 65 61 73 6f 6e <code>ERR_reason
52b0: 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 29 3c _error_string()<
52c0: 2f 63 6f 64 65 3e 2e 0a 09 3c 2f 64 64 3e 0a 0a /code>...</dd>..
52d0: 09 3c 62 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 .<br>...<dt>..
52e0: 3c 73 74 72 6f 6e 67 3e 69 6e 66 6f 3c 2f 73 74 <strong>info</st
52f0: 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 rong> <em>channe
5300: 6c 20 6d 61 6a 6f 72 20 6d 69 6e 6f 72 20 6d 65 l major minor me
5310: 73 73 61 67 65 20 74 79 70 65 3c 2f 65 6d 3e 0a ssage type</em>.
5320: 09 3c 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 .</dt>..<dd>..
5330: 54 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c This form of cal
5340: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
5350: 20 62 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 by the OpenSSL
5360: 66 75 6e 63 74 69 6f 6e 0a 09 20 20 3c 63 6f 64 function.. <cod
5370: 65 3e 53 53 4c 5f 43 54 58 5f 73 65 74 5f 69 6e e>SSL_CTX_set_in
5380: 66 6f 5f 63 61 6c 6c 62 61 63 6b 28 29 3c 2f 63 fo_callback()</c
5390: 6f 64 65 3e 20 64 75 72 69 6e 67 20 63 6f 6e 6e ode> during conn
53a0: 65 63 74 69 6f 6e 20 73 65 74 75 70 0a 09 20 20 ection setup..
53b0: 61 6e 64 20 75 73 65 2e 0a 09 20 20 3c 62 72 3e and use... <br>
53c0: 0a 09 20 20 3c 75 6c 3e 0a 09 20 20 3c 6c 69 3e .. <ul>.. <li>
53d0: 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 Possible values
53e0: 66 6f 72 20 3c 65 6d 3e 6d 61 6a 6f 72 3c 2f 65 for <em>major</e
53f0: 6d 3e 20 61 72 65 3a 0a 09 20 20 3c 63 6f 64 65 m> are:.. <code
5400: 3e 68 61 6e 64 73 68 61 6b 65 2c 20 61 6c 65 72 >handshake, aler
5410: 74 2c 20 63 6f 6e 6e 65 63 74 2c 20 61 63 63 65 t, connect, acce
5420: 70 74 3c 2f 63 6f 64 65 3e 2e 3c 2f 6c 69 3e 0a pt</code>.</li>.
5430: 09 20 20 3c 6c 69 3e 50 6f 73 73 69 62 6c 65 20 . <li>Possible
5440: 76 61 6c 75 65 73 20 66 6f 72 20 3c 65 6d 3e 6d values for <em>m
5450: 69 6e 6f 72 3c 2f 65 6d 3e 20 61 72 65 3a 0a 09 inor</em> are:..
5460: 20 20 3c 63 6f 64 65 3e 73 74 61 72 74 2c 20 64 <code>start, d
5470: 6f 6e 65 2c 20 72 65 61 64 2c 20 77 72 69 74 65 one, read, write
5480: 2c 20 6c 6f 6f 70 2c 20 65 78 69 74 3c 2f 63 6f , loop, exit</co
5490: 64 65 3e 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 de>.</li>.. <li
54a0: 3e 54 68 65 20 3c 65 6d 3e 6d 65 73 73 61 67 65 >The <em>message
54b0: 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e 74 20 69 </em> argument i
54c0: 73 20 61 20 64 65 73 63 72 69 70 74 69 76 65 20 s a descriptive
54d0: 73 74 72 69 6e 67 20 77 68 69 63 68 20 6d 61 79 string which may
54e0: 0a 09 20 20 62 65 20 67 65 6e 65 72 61 74 65 64 .. be generated
54f0: 20 65 69 74 68 65 72 20 62 79 20 3c 63 6f 64 65 either by <code
5500: 3e 53 53 4c 5f 73 74 61 74 65 5f 73 74 72 69 6e >SSL_state_strin
5510: 67 5f 6c 6f 6e 67 28 29 3c 2f 63 6f 64 65 3e 20 g_long()</code>
5520: 6f 72 20 62 79 0a 09 20 20 3c 63 6f 64 65 3e 53 or by.. <code>S
5530: 53 4c 5f 61 6c 65 72 74 5f 64 65 73 63 5f 73 74 SL_alert_desc_st
5540: 72 69 6e 67 5f 6c 6f 6e 67 28 29 3c 2f 63 6f 64 ring_long()</cod
5550: 65 3e 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e e>, depending on
5560: 20 74 68 65 20 63 6f 6e 74 65 78 74 2e 3c 2f 6c the context.</l
5570: 69 3e 0a 09 20 20 3c 6c 69 3e 46 6f 72 20 61 6c i>.. <li>For al
5580: 65 72 74 73 2c 20 74 68 65 20 70 6f 73 73 69 62 erts, the possib
5590: 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20 3c 65 le values for <e
55a0: 6d 3e 74 79 70 65 3c 2f 65 6d 3e 20 61 72 65 3a m>type</em> are:
55b0: 0a 09 20 20 3c 63 6f 64 65 3e 77 61 72 6e 69 6e .. <code>warnin
55c0: 67 2c 20 66 61 74 61 6c 2c 20 61 6e 64 20 75 6e g, fatal, and un
55d0: 6b 6e 6f 77 6e 3c 2f 63 6f 64 65 3e 2e 20 46 6f known</code>. Fo
55e0: 72 20 6f 74 68 65 72 73 2c 0a 09 20 20 3c 63 6f r others,.. <co
55f0: 64 65 3e 69 6e 66 6f 3c 2f 63 6f 64 65 3e 20 69 de>info</code> i
5600: 73 20 75 73 65 64 2e 3c 2f 6c 69 3e 0a 09 20 20 s used.</li>..
5610: 3c 2f 75 6c 3e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c </ul>..</dd>...<
5620: 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 6d dt>.. <strong>m
5630: 65 73 73 61 67 65 3c 2f 73 74 72 6f 6e 67 3e 20 essage</strong>
5640: 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 64 69 72 65 <em>channel dire
5650: 63 74 69 6f 6e 20 76 65 72 73 69 6f 6e 20 63 6f ction version co
5660: 6e 74 65 6e 74 5f 74 79 70 65 20 64 61 74 61 3c ntent_type data<
5670: 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 64 /em>..</dt>..<dd
5680: 3e 0a 09 20 20 54 68 69 73 20 66 6f 72 6d 20 6f >.. This form o
5690: 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e f callback is in
56a0: 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f 70 65 voked by the Ope
56b0: 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a 09 20 nSSL function..
56c0: 20 3c 63 6f 64 65 3e 53 53 4c 5f 73 65 74 5f 6d <code>SSL_set_m
56d0: 73 67 5f 63 61 6c 6c 62 61 63 6b 28 29 3c 2f 63 sg_callback()</c
56e0: 6f 64 65 3e 20 77 68 65 6e 65 76 65 72 20 61 20 ode> whenever a
56f0: 6d 65 73 73 61 67 65 20 69 73 20 73 65 6e 74 20 message is sent
5700: 6f 72 0a 09 20 20 72 65 63 65 69 76 65 64 2e 20 or.. received.
5710: 49 74 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c It is only avail
5720: 61 62 6c 65 20 77 68 65 6e 0a 09 20 20 4f 70 65 able when.. Ope
5730: 6e 53 53 4c 20 69 73 20 63 6f 6d 70 6c 69 65 64 nSSL is complied
5740: 20 77 69 74 68 20 74 68 65 20 3c 65 6d 3e 65 6e with the <em>en
5750: 61 62 6c 65 2d 73 73 6c 2d 74 72 61 63 65 3c 2f able-ssl-trace</
5760: 65 6d 3e 20 6f 70 74 69 6f 6e 2e 0a 09 20 20 57 em> option... W
5770: 68 65 72 65 20 3c 65 6d 3e 64 69 72 65 63 74 69 here <em>directi
5780: 6f 6e 3c 2f 65 6d 3e 20 69 73 20 53 65 6e 74 20 on</em> is Sent
5790: 6f 72 20 52 65 63 65 69 76 65 64 2c 20 3c 65 6d or Received, <em
57a0: 3e 76 65 72 73 69 6f 6e 3c 2f 65 6d 3e 20 69 73 >version</em> is
57b0: 20 74 68 65 0a 09 20 20 70 72 6f 74 6f 63 6f 6c the.. protocol
57c0: 20 76 65 72 73 69 6f 6e 2c 20 3c 65 6d 3e 63 6f version, <em>co
57d0: 6e 74 65 6e 74 5f 74 79 70 65 3c 2f 65 6d 3e 20 ntent_type</em>
57e0: 69 73 20 74 68 65 20 6d 65 73 73 61 67 65 20 63 is the message c
57f0: 6f 6e 74 65 6e 74 20 74 79 70 65 2c 0a 09 20 20 ontent type,..
5800: 61 6e 64 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d and <em>data</em
5810: 3e 20 69 73 20 6d 6f 72 65 20 69 6e 66 6f 20 6f > is more info o
5820: 6e 20 74 68 65 20 6d 65 73 73 61 67 65 20 66 72 n the message fr
5830: 6f 6d 20 74 68 65 20 3c 63 6f 64 65 3e 53 53 4c om the <code>SSL
5840: 5f 74 72 61 63 65 3c 2f 63 6f 64 65 3e 20 41 50 _trace</code> AP
5850: 49 2e 0a 09 3c 2f 64 64 3e 0a 09 3c 62 72 3e 0a I...</dd>..<br>.
5860: 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e ..<dt>.. <stron
5870: 67 3e 73 65 73 73 69 6f 6e 3c 2f 73 74 72 6f 6e g>session</stron
5880: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 73 g> <em>channel s
5890: 65 73 73 69 6f 6e 5f 69 64 20 74 69 63 6b 65 74 ession_id ticket
58a0: 20 6c 69 66 65 74 69 6d 65 3c 2f 65 6d 3e 0a 09 lifetime</em>..
58b0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 </dt>..<dd>.. T
58c0: 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c his form of call
58d0: 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 back is invoked
58e0: 62 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 by the OpenSSL f
58f0: 75 6e 63 74 69 6f 6e 0a 09 20 20 3c 63 6f 64 65 unction.. <code
5900: 3e 53 53 4c 5f 43 54 58 5f 73 65 73 73 5f 73 65 >SSL_CTX_sess_se
5910: 74 5f 6e 65 77 5f 63 62 28 29 3c 2f 63 6f 64 65 t_new_cb()</code
5920: 3e 2e 0a 09 20 20 57 68 65 72 65 20 3c 65 6d 3e >... Where <em>
5930: 73 65 73 73 69 6f 6e 5f 69 64 3c 2f 65 6d 3e 20 session_id</em>
5940: 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 is the current s
5950: 65 73 73 69 6f 6e 20 69 64 65 6e 74 69 66 69 65 ession identifie
5960: 72 2c 0a 09 20 20 3c 65 6d 3e 74 69 63 6b 65 74 r,.. <em>ticket
5970: 3c 2f 65 6d 3e 20 69 73 20 74 68 65 20 73 65 73 </em> is the ses
5980: 73 69 6f 6e 20 74 69 63 6b 65 74 20 69 6e 66 6f sion ticket info
5990: 2c 20 61 6e 64 20 3c 65 6d 3e 6c 69 66 65 74 69 , and <em>lifeti
59a0: 6d 65 3c 2f 65 6d 3e 0a 09 20 20 69 73 20 74 68 me</em>.. is th
59b0: 65 20 74 68 65 20 74 69 63 6b 65 74 20 6c 69 66 e the ticket lif
59c0: 65 74 69 6d 65 20 69 6e 20 73 65 63 6f 6e 64 73 etime in seconds
59d0: 2e 0a 09 3c 2f 64 64 3e 0a 09 3c 62 72 3e 0a 09 ...</dd>..<br>..
59e0: 3c 2f 64 6c 3e 0a 20 20 20 20 3c 2f 64 64 3e 0a </dl>. </dd>.
59f0: 0a 20 20 20 20 3c 62 72 3e 0a 0a 20 20 20 20 3c . <br>.. <
5a00: 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 70 61 73 73 dt><strong>-pass
5a10: 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 word</strong> <e
5a20: 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 3c m>callback</em><
5a30: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 0a 09 49 /dt>. <dd>..I
5a40: 6e 76 6f 6b 65 73 20 74 68 65 20 73 70 65 63 69 nvokes the speci
5a50: 66 69 65 64 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 fied <em>callbac
5a60: 6b 3c 2f 65 6d 3e 20 73 63 72 69 70 74 20 77 68 k</em> script wh
5a70: 65 6e 20 4f 70 65 6e 53 53 4c 20 6e 65 65 64 73 en OpenSSL needs
5a80: 20 74 6f 0a 09 6f 62 74 61 69 6e 20 61 20 70 61 to..obtain a pa
5a90: 73 73 77 6f 72 64 2e 20 53 65 65 20 62 65 6c 6f ssword. See belo
5aa0: 77 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 w for the possib
5ab0: 6c 65 20 61 72 67 75 6d 65 6e 74 73 20 70 61 73 le arguments pas
5ac0: 73 65 64 20 74 6f 0a 09 74 68 65 20 63 61 6c 6c sed to..the call
5ad0: 62 61 63 6b 20 73 63 72 69 70 74 2e 20 53 65 65 back script. See
5ae0: 20 62 65 6c 6f 77 20 66 6f 72 20 76 61 6c 69 64 below for valid
5af0: 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 2e 0a return values..
5b00: 0a 09 3c 62 72 3e 0a 09 3c 62 72 3e 0a 0a 09 3c ..<br>..<br>...<
5b10: 64 6c 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 dl>...<dt>.. <s
5b20: 74 72 6f 6e 67 3e 70 61 73 73 77 6f 72 64 3c 2f trong>password</
5b30: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 72 77 66 6c strong> <em>rwfl
5b40: 61 67 20 73 69 7a 65 3c 2f 65 6d 3e 0a 09 3c 2f ag size</em>..</
5b50: 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 49 6e 76 dt>..<dd>.. Inv
5b60: 6f 6b 65 64 20 77 68 65 6e 20 6c 6f 61 64 69 6e oked when loadin
5b70: 67 20 6f 72 20 73 74 6f 72 69 6e 67 20 61 20 50 g or storing a P
5b80: 45 4d 20 63 65 72 74 69 66 69 63 61 74 65 20 77 EM certificate w
5b90: 69 74 68 20 65 6e 63 72 79 70 74 69 6f 6e 2e 0a ith encryption..
5ba0: 09 20 20 57 68 65 72 65 20 3c 65 6d 3e 72 77 66 . Where <em>rwf
5bb0: 6c 61 67 3c 2f 65 6d 3e 20 69 73 20 30 20 66 6f lag</em> is 0 fo
5bc0: 72 20 72 65 61 64 69 6e 67 2f 64 65 63 72 79 70 r reading/decryp
5bd0: 74 69 6f 6e 20 6f 72 20 31 20 66 6f 72 0a 09 20 tion or 1 for..
5be0: 20 77 72 69 74 69 6e 67 2f 65 6e 63 72 79 70 74 writing/encrypt
5bf0: 69 6f 6e 20 28 63 61 6e 20 70 72 6f 6d 70 74 20 ion (can prompt
5c00: 75 73 65 72 20 74 6f 20 63 6f 6e 66 69 72 6d 29 user to confirm)
5c10: 20 61 6e 64 0a 09 20 20 3c 65 6d 3e 73 69 7a 65 and.. <em>size
5c20: 3c 2f 65 6d 3e 20 69 73 20 74 68 65 20 6d 61 78 </em> is the max
5c30: 20 70 61 73 73 77 6f 72 64 20 6c 65 6e 67 74 68 password length
5c40: 20 69 6e 20 62 79 74 65 73 2e 0a 09 20 20 54 68 in bytes... Th
5c50: 65 20 63 61 6c 6c 62 61 63 6b 20 73 68 6f 75 6c e callback shoul
5c60: 64 20 72 65 74 75 72 6e 20 74 68 65 20 70 61 73 d return the pas
5c70: 73 77 6f 72 64 20 61 73 20 61 20 73 74 72 69 6e sword as a strin
5c80: 67 2e 0a 09 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f g...</dd>. </
5c90: 64 64 3e 0a 0a 20 20 20 20 3c 62 72 3e 0a 0a 0a dd>.. <br>...
5ca0: 20 20 20 20 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e <dt><strong>
5cb0: 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 6e 64 -validatecommand
5cc0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 61 </strong> <em>ca
5cd0: 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 3c 2f 64 74 3e llback</em></dt>
5ce0: 0a 20 20 20 20 3c 64 64 3e 0a 09 49 6e 76 6f 6b . <dd>..Invok
5cf0: 65 73 20 74 68 65 20 73 70 65 63 69 66 69 65 64 es the specified
5d00: 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 <em>callback</e
5d10: 6d 3e 20 73 63 72 69 70 74 20 64 75 72 69 6e 67 m> script during
5d20: 20 68 61 6e 64 73 68 61 6b 65 20 69 6e 0a 09 6f handshake in..o
5d30: 72 64 65 72 20 74 6f 20 76 61 6c 69 64 61 74 65 rder to validate
5d40: 20 74 68 65 20 70 72 6f 76 69 64 65 64 20 76 61 the provided va
5d50: 6c 75 65 28 73 29 2e 20 53 65 65 20 62 65 6c 6f lue(s). See belo
5d60: 77 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 w for the possib
5d70: 6c 65 0a 09 61 72 67 75 6d 65 6e 74 73 20 70 61 le..arguments pa
5d80: 73 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c ssed to the call
5d90: 62 61 63 6b 20 73 63 72 69 70 74 2e 0a 09 54 6f back script...To
5da0: 20 72 65 6a 65 63 74 20 74 68 65 20 76 61 6c 75 reject the valu
5db0: 65 20 61 6e 64 20 61 62 6f 72 74 20 63 6f 6e 6e e and abort conn
5dc0: 65 63 74 69 6f 6e 2c 20 74 68 65 20 63 61 6c 6c ection, the call
5dd0: 62 61 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 back should retu
5de0: 72 6e 20 30 2e 0a 09 54 6f 20 61 63 63 65 70 74 rn 0...To accept
5df0: 20 74 68 65 20 76 61 6c 75 65 20 61 6e 64 20 63 the value and c
5e00: 6f 6e 74 69 6e 75 65 20 74 68 65 20 63 6f 6e 6e ontinue the conn
5e10: 65 63 74 69 6f 6e 2c 20 69 74 20 73 68 6f 75 6c ection, it shoul
5e20: 64 20 72 65 74 75 72 6e 20 31 2e 0a 09 54 6f 20 d return 1...To
5e30: 72 65 6a 65 63 74 20 74 68 65 20 76 61 6c 75 65 reject the value
5e40: 2c 20 62 75 74 20 63 6f 6e 74 69 6e 75 65 20 74 , but continue t
5e50: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 he connection, i
5e60: 74 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 t should return
5e70: 32 2e 0a 0a 09 3c 62 72 3e 0a 09 3c 62 72 3e 0a 2....<br>..<br>.
5e80: 0a 09 3c 64 6c 3e 0a 0a 09 3c 64 74 3e 0a 09 20 ..<dl>...<dt>..
5e90: 20 3c 73 74 72 6f 6e 67 3e 61 6c 70 6e 3c 2f 73 <strong>alpn</s
5ea0: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e trong> <em>chann
5eb0: 65 6c 20 70 72 6f 74 6f 63 6f 6c 20 6d 61 74 63 el protocol matc
5ec0: 68 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c h</em>..</dt>..<
5ed0: 64 64 3e 0a 09 20 20 46 6f 72 20 73 65 72 76 65 dd>.. For serve
5ee0: 72 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f 66 rs, this form of
5ef0: 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 callback is inv
5f00: 6f 6b 65 64 20 77 68 65 6e 20 74 68 65 20 63 6c oked when the cl
5f10: 69 65 6e 74 20 41 4c 50 4e 0a 09 20 20 65 78 74 ient ALPN.. ext
5f20: 65 6e 73 69 6f 6e 20 69 73 20 72 65 63 65 69 76 ension is receiv
5f30: 65 64 2e 20 49 66 20 3c 65 6d 3e 6d 61 74 63 68 ed. If <em>match
5f40: 3c 2f 65 6d 3e 20 69 73 20 74 72 75 65 2c 20 3c </em> is true, <
5f50: 65 6d 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 65 6d 3e em>protocol</em>
5f60: 0a 09 20 20 69 73 20 74 68 65 20 66 69 72 73 74 .. is the first
5f70: 20 3c 62 3e 2d 61 6c 70 6e 3c 2f 62 3e 20 73 70 <b>-alpn</b> sp
5f80: 65 63 69 66 69 65 64 20 70 72 6f 74 6f 63 6f 6c ecified protocol
5f90: 20 63 6f 6d 6d 6f 6e 20 74 6f 20 74 68 65 20 62 common to the b
5fa0: 6f 74 68 20 74 68 65 0a 09 20 20 63 6c 69 65 6e oth the.. clien
5fb0: 74 20 61 6e 64 20 73 65 72 76 65 72 2e 20 49 66 t and server. If
5fc0: 20 6e 6f 74 2c 20 74 68 65 20 66 69 72 73 74 20 not, the first
5fd0: 63 6c 69 65 6e 74 20 73 70 65 63 69 66 69 65 64 client specified
5fe0: 20 70 72 6f 74 6f 63 6f 6c 20 69 73 0a 09 20 20 protocol is..
5ff0: 75 73 65 64 2e 20 43 61 6c 6c 65 64 20 61 66 74 used. Called aft
6000: 65 72 20 68 65 6c 6c 6f 20 61 6e 64 20 41 4c 50 er hello and ALP
6010: 4e 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 09 3c 2f N callbacks...</
6020: 64 64 3e 0a 0a 09 3c 62 72 3e 0a 0a 09 3c 64 74 dd>...<br>...<dt
6030: 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 68 65 6c >.. <strong>hel
6040: 6c 6f 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e lo</strong> <em>
6050: 63 68 61 6e 6e 65 6c 20 73 65 72 76 65 72 6e 61 channel serverna
6060: 6d 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 me</em>..</dt>..
6070: 3c 64 64 3e 0a 09 20 20 46 6f 72 20 73 65 72 76 <dd>.. For serv
6080: 65 72 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f ers, this form o
6090: 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e f callback is in
60a0: 76 6f 6b 65 64 20 64 75 72 69 6e 67 20 63 6c 69 voked during cli
60b0: 65 6e 74 20 68 65 6c 6c 6f 0a 09 20 20 6d 65 73 ent hello.. mes
60c0: 73 61 67 65 20 70 72 6f 63 65 73 73 69 6e 67 2e sage processing.
60d0: 20 49 74 20 69 73 20 75 73 65 64 20 74 6f 20 73 It is used to s
60e0: 65 6c 65 63 74 20 61 6e 20 61 70 70 72 6f 70 72 elect an appropr
60f0: 69 61 74 65 20 63 65 72 74 69 66 69 63 61 74 65 iate certificate
6100: 20 74 6f 0a 09 20 20 70 72 65 73 65 6e 74 2c 20 to.. present,
6110: 61 6e 64 20 6d 61 6b 65 20 6f 74 68 65 72 20 63 and make other c
6120: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 61 64 6a onfiguration adj
6130: 75 73 74 6d 65 6e 74 73 20 72 65 6c 65 76 61 6e ustments relevan
6140: 74 20 74 6f 20 74 68 61 74 0a 09 20 20 73 65 72 t to that.. ser
6150: 76 65 72 20 6e 61 6d 65 20 61 6e 64 20 69 74 73 ver name and its
6160: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 20 configuration.
6170: 43 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 53 4e Called before SN
6180: 49 20 61 6e 64 20 41 4c 50 4e 20 63 61 6c 6c 62 I and ALPN callb
6190: 61 63 6b 73 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c acks...</dd>...<
61a0: 62 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 br>...<dt>.. <s
61b0: 74 72 6f 6e 67 3e 73 6e 69 3c 2f 73 74 72 6f 6e trong>sni</stron
61c0: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 73 g> <em>channel s
61d0: 65 72 76 65 72 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 ervername</em>..
61e0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 46 </dt>..<dd>.. F
61f0: 6f 72 20 73 65 72 76 65 72 73 2c 20 74 68 69 73 or servers, this
6200: 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 form of callbac
6210: 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 65 k is invoked whe
6220: 6e 20 74 68 65 20 53 4e 49 20 65 78 74 65 6e 73 n the SNI extens
6230: 69 6f 6e 0a 09 20 20 66 72 6f 6d 20 74 68 65 20 ion.. from the
6240: 63 6c 69 65 6e 74 20 69 73 20 72 65 63 65 69 76 client is receiv
6250: 65 64 2e 20 57 68 65 72 65 20 3c 65 6d 3e 73 65 ed. Where <em>se
6260: 72 76 65 72 6e 61 6d 65 3c 2f 65 6d 3e 20 69 73 rvername</em> is
6270: 20 74 68 65 20 63 6c 69 65 6e 74 0a 09 20 20 70 the client.. p
6280: 72 6f 76 69 64 65 64 20 73 65 72 76 65 72 20 6e rovided server n
6290: 61 6d 65 20 66 72 6f 6d 20 74 68 65 20 3c 62 3e ame from the <b>
62a0: 2d 73 65 72 76 65 72 6e 61 6d 65 3c 2f 62 3e 20 -servername</b>
62b0: 6f 70 74 69 6f 6e 2e 20 54 68 69 73 20 69 73 0a option. This is.
62c0: 09 20 20 75 73 65 64 20 77 68 65 6e 20 61 20 73 . used when a s
62d0: 65 72 76 65 72 20 73 75 70 70 6f 72 74 73 20 6d erver supports m
62e0: 75 6c 74 69 70 6c 65 20 6e 61 6d 65 73 2c 20 73 ultiple names, s
62f0: 6f 20 74 68 65 20 72 69 67 68 74 20 63 65 72 74 o the right cert
6300: 69 66 69 63 61 74 65 0a 09 20 20 63 61 6e 20 62 ificate.. can b
6310: 65 20 75 73 65 64 2e 20 43 61 6c 6c 65 64 20 61 e used. Called a
6320: 66 74 65 72 20 68 65 6c 6c 6f 20 63 61 6c 6c 62 fter hello callb
6330: 61 63 6b 20 62 75 74 20 62 65 66 6f 72 65 20 41 ack but before A
6340: 4c 50 4e 20 63 61 6c 6c 62 61 63 6b 2e 0a 09 3c LPN callback...<
6350: 2f 64 64 3e 0a 0a 09 3c 62 72 3e 0a 0a 09 3c 64 /dd>...<br>...<d
6360: 74 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 76 65 t>.. <strong>ve
6370: 72 69 66 79 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 rify</strong> <e
6380: 6d 3e 63 68 61 6e 6e 65 6c 20 64 65 70 74 68 20 m>channel depth
6390: 63 65 72 74 20 73 74 61 74 75 73 20 65 72 72 6f cert status erro
63a0: 72 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c r</em>..</dt>..<
63b0: 64 64 3e 0a 09 20 20 54 68 69 73 20 66 6f 72 6d dd>.. This form
63c0: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
63d0: 69 6e 76 6f 6b 65 64 20 62 79 20 4f 70 65 6e 53 invoked by OpenS
63e0: 53 4c 20 77 68 65 6e 20 61 20 6e 65 77 20 63 65 SL when a new ce
63f0: 72 74 69 66 69 63 61 74 65 0a 09 20 20 69 73 20 rtificate.. is
6400: 72 65 63 65 69 76 65 64 20 66 72 6f 6d 20 74 68 received from th
6410: 65 20 70 65 65 72 2e 20 49 74 20 61 6c 6c 6f 77 e peer. It allow
6420: 73 20 74 68 65 20 63 6c 69 65 6e 74 20 74 6f 20 s the client to
6430: 63 68 65 63 6b 20 74 68 65 0a 09 20 20 63 65 72 check the.. cer
6440: 74 69 66 69 63 61 74 65 20 76 65 72 69 66 69 63 tificate verific
6450: 61 74 69 6f 6e 20 72 65 73 75 6c 74 73 20 61 6e ation results an
6460: 64 20 63 68 6f 6f 73 65 20 77 68 65 74 68 65 72 d choose whether
6470: 20 74 6f 20 63 6f 6e 74 69 6e 75 65 0a 09 20 20 to continue..
6480: 6f 72 20 6e 6f 74 2e 20 49 74 20 69 73 20 63 61 or not. It is ca
6490: 6c 6c 65 64 20 66 6f 72 20 65 61 63 68 20 63 65 lled for each ce
64a0: 72 74 69 66 69 63 61 74 65 20 69 6e 20 74 68 65 rtificate in the
64b0: 20 63 65 72 74 69 66 69 63 61 74 65 20 63 68 61 certificate cha
64c0: 69 6e 2e 0a 09 20 20 3c 75 6c 3e 0a 09 20 20 3c in... <ul>.. <
64d0: 6c 69 3e 54 68 65 20 3c 65 6d 3e 64 65 70 74 68 li>The <em>depth
64e0: 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e 74 20 69 </em> argument i
64f0: 73 20 61 6e 20 69 6e 74 65 67 65 72 20 72 65 70 s an integer rep
6500: 72 65 73 65 6e 74 69 6e 67 20 74 68 65 0a 09 20 resenting the..
6510: 20 63 75 72 72 65 6e 74 20 64 65 70 74 68 20 6f current depth o
6520: 6e 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 n the certificat
6530: 65 20 63 68 61 69 6e 2c 20 77 69 74 68 0a 09 20 e chain, with..
6540: 20 3c 63 6f 64 65 3e 30 3c 2f 63 6f 64 65 3e 20 <code>0</code>
6550: 61 73 20 74 68 65 20 70 65 65 72 20 63 65 72 74 as the peer cert
6560: 69 66 69 63 61 74 65 20 61 6e 64 20 68 69 67 68 ificate and high
6570: 65 72 20 76 61 6c 75 65 73 20 67 6f 69 6e 67 0a er values going.
6580: 09 20 20 75 70 20 74 6f 20 74 68 65 20 43 65 72 . up to the Cer
6590: 74 69 66 69 63 61 74 65 20 41 75 74 68 6f 72 69 tificate Authori
65a0: 74 79 20 28 43 41 29 2e 3c 2f 6c 69 3e 0a 09 20 ty (CA).</li>..
65b0: 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e 63 65 72 <li>The <em>cer
65c0: 74 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e 74 20 t</em> argument
65d0: 69 73 20 61 20 6c 69 73 74 20 6f 66 20 6b 65 79 is a list of key
65e0: 2d 76 61 6c 75 65 20 70 61 69 72 73 20 73 69 6d -value pairs sim
65f0: 69 6c 61 72 0a 09 20 20 74 6f 20 74 68 6f 73 65 ilar.. to those
6600: 20 72 65 74 75 72 6e 65 64 20 62 79 0a 09 20 20 returned by..
6610: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 73 <a href="#tls::s
6620: 74 61 74 75 73 22 3e 3c 73 74 72 6f 6e 67 3e 74 tatus"><strong>t
6630: 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 73 74 72 6f ls::status</stro
6640: 6e 67 3e 3c 2f 61 3e 2e 3c 2f 6c 69 3e 0a 09 20 ng></a>.</li>..
6650: 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e 73 74 61 <li>The <em>sta
6660: 74 75 73 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e tus</em> argumen
6670: 74 20 69 73 20 61 6e 20 62 6f 6f 6c 65 61 6e 20 t is an boolean
6680: 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 representing the
6690: 0a 09 20 20 76 61 6c 69 64 69 74 79 20 6f 66 20 .. validity of
66a0: 74 68 65 20 63 75 72 72 65 6e 74 20 63 65 72 74 the current cert
66b0: 69 66 69 63 61 74 65 2e 0a 09 20 20 41 20 76 61 ificate... A va
66c0: 6c 75 65 20 6f 66 20 3c 63 6f 64 65 3e 30 3c 2f lue of <code>0</
66d0: 63 6f 64 65 3e 20 6d 65 61 6e 73 20 74 68 65 20 code> means the
66e0: 63 65 72 74 69 66 69 63 61 74 65 20 69 73 20 64 certificate is d
66f0: 65 65 6d 65 64 20 69 6e 76 61 6c 69 64 2e 0a 09 eemed invalid...
6700: 20 20 41 20 76 61 6c 75 65 20 6f 66 20 3c 63 6f A value of <co
6710: 64 65 3e 31 3c 2f 63 6f 64 65 3e 20 6d 65 61 6e de>1</code> mean
6720: 73 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 s the certificat
6730: 65 20 69 73 20 64 65 65 6d 65 64 20 76 61 6c 69 e is deemed vali
6740: 64 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 54 d.</li>.. <li>T
6750: 68 65 20 3c 65 6d 3e 65 72 72 6f 72 3c 2f 65 6d he <em>error</em
6760: 3e 20 61 72 67 75 6d 65 6e 74 20 73 75 70 70 6c > argument suppl
6770: 69 65 73 20 74 68 65 20 6d 65 73 73 61 67 65 2c ies the message,
6780: 20 69 66 20 61 6e 79 2c 20 67 65 6e 65 72 61 74 if any, generat
6790: 65 64 0a 09 20 20 62 79 20 3c 63 6f 64 65 3e 58 ed.. by <code>X
67a0: 35 30 39 5f 53 54 4f 52 45 5f 43 54 58 5f 67 65 509_STORE_CTX_ge
67b0: 74 5f 65 72 72 6f 72 28 29 3c 2f 63 6f 64 65 3e t_error()</code>
67c0: 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 2f 75 6c 3e 0a .</li>.. </ul>.
67d0: 09 3c 2f 64 64 3e 0a 09 3c 62 72 3e 0a 09 3c 2f .</dd>..<br>..</
67e0: 64 6c 3e 0a 20 20 20 20 3c 2f 64 64 3e 0a 3c 2f dl>. </dd>.</
67f0: 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 dl>.</blockquote
6800: 3e 0a 0a 3c 70 3e 0a 52 65 66 65 72 65 6e 63 65 >..<p>.Reference
6810: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
6820: 20 6f 66 20 74 68 65 73 65 20 63 61 6c 6c 62 61 of these callba
6830: 63 6b 73 20 61 72 65 20 70 72 6f 76 69 64 65 64 cks are provided
6840: 20 69 6e 20 74 68 65 0a 64 69 73 74 72 69 62 75 in the.distribu
6850: 74 69 6f 6e 20 61 73 20 3c 73 74 72 6f 6e 67 3e tion as <strong>
6860: 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 3c 2f 73 tls::callback</s
6870: 74 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e trong>, <strong>
6880: 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 3c 2f 73 tls::password</s
6890: 74 72 6f 6e 67 3e 2c 0a 61 6e 64 20 3c 73 74 72 trong>,.and <str
68a0: 6f 6e 67 3e 74 6c 73 3a 3a 76 61 6c 69 64 61 74 ong>tls::validat
68b0: 65 5f 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e e_command</stron
68c0: 67 3e 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e g> respectively.
68d0: 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 73 Note that thes
68e0: 65 20 61 72 65 0a 3c 65 6d 3e 73 61 6d 70 6c 65 e are.<em>sample
68f0: 3c 2f 65 6d 3e 20 69 6d 70 6c 65 6d 65 6e 74 61 </em> implementa
6900: 74 69 6f 6e 73 20 6f 6e 6c 79 2e 20 20 49 6e 20 tions only. In
6910: 61 20 6d 6f 72 65 20 72 65 61 6c 69 73 74 69 63 a more realistic
6920: 20 64 65 70 6c 6f 79 6d 65 6e 74 0a 79 6f 75 20 deployment.you
6930: 77 6f 75 6c 64 20 73 70 65 63 69 66 79 20 79 6f would specify yo
6940: 75 72 20 6f 77 6e 20 63 61 6c 6c 62 61 63 6b 20 ur own callback
6950: 73 63 72 69 70 74 73 20 6f 6e 20 65 61 63 68 20 scripts on each
6960: 54 4c 53 20 63 68 61 6e 6e 65 6c 20 75 73 69 6e TLS channel usin
6970: 67 20 74 68 65 0a 3c 73 74 72 6f 6e 67 3e 2d 63 g the.<strong>-c
6980: 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 2c ommand</strong>,
6990: 20 3c 73 74 72 6f 6e 67 3e 2d 70 61 73 73 77 6f <strong>-passwo
69a0: 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 20 61 6e 64 rd</strong>, and
69b0: 20 3c 73 74 72 6f 6e 67 3e 2d 76 61 6c 69 64 61 <strong>-valida
69c0: 74 65 5f 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f te_command</stro
69d0: 6e 67 3e 20 6f 70 74 69 6f 6e 73 2e 0a 3c 2f 70 ng> options..</p
69e0: 3e 0a 0a 3c 70 3e 0a 54 68 65 20 64 65 66 61 75 >..<p>.The defau
69f0: 6c 74 20 62 65 68 61 76 69 6f 72 20 77 68 65 6e lt behavior when
6a00: 20 74 68 65 20 3c 73 74 72 6f 6e 67 3e 2d 63 6f the <strong>-co
6a10: 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 61 mmand</strong> a
6a20: 6e 64 20 3c 73 74 72 6f 6e 67 3e 2d 76 61 6c 69 nd <strong>-vali
6a30: 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 3c 2f 73 74 date_command</st
6a40: 72 6f 6e 67 3e 0a 6f 70 74 69 6f 6e 73 20 61 72 rong>.options ar
6a50: 65 20 6e 6f 74 20 73 70 65 63 69 66 69 65 64 20 e not specified
6a60: 69 73 20 66 6f 72 20 54 4c 53 20 74 6f 20 70 72 is for TLS to pr
6a70: 6f 63 65 73 73 20 74 68 65 20 61 73 73 6f 63 69 ocess the associ
6a80: 61 74 65 64 20 6c 69 62 72 61 72 79 20 63 61 6c ated library cal
6a90: 6c 62 61 63 6b 73 0a 69 6e 74 65 72 6e 61 6c 6c lbacks.internall
6aa0: 79 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 62 y. The default b
6ab0: 65 68 61 76 69 6f 72 20 77 68 65 6e 20 74 68 65 ehavior when the
6ac0: 20 3c 73 74 72 6f 6e 67 3e 2d 70 61 73 73 77 6f <strong>-passwo
6ad0: 72 64 3c 2f 73 74 72 6f 6e 67 3e 20 6f 70 74 69 rd</strong> opti
6ae0: 6f 6e 20 69 73 20 6e 6f 74 0a 73 70 65 63 69 66 on is not.specif
6af0: 69 65 64 20 69 73 20 66 6f 72 20 54 4c 53 20 74 ied is for TLS t
6b00: 6f 20 70 72 6f 63 65 73 73 20 74 68 65 20 61 73 o process the as
6b10: 73 6f 63 69 61 74 65 64 20 6c 69 62 72 61 72 79 sociated library
6b20: 20 63 61 6c 6c 62 61 63 6b 73 20 62 79 20 61 74 callbacks by at
6b30: 74 65 6d 70 74 69 6e 67 0a 74 6f 20 63 61 6c 6c tempting.to call
6b40: 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 61 <strong>tls::pa
6b50: 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2e ssword</strong>.
6b60: 0a 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 .The difference
6b70: 62 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 between these tw
6b80: 6f 20 62 65 68 61 76 69 6f 72 73 20 69 73 20 61 o behaviors is a
6b90: 20 63 6f 6e 73 65 71 75 65 6e 63 65 20 6f 66 20 consequence of
6ba0: 6d 61 69 6e 74 61 69 6e 69 6e 67 0a 63 6f 6d 70 maintaining.comp
6bb0: 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 65 atibility with e
6bc0: 61 72 6c 69 65 72 20 69 6d 70 6c 65 6d 65 6e 74 arlier implement
6bd0: 61 74 69 6f 6e 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 ations..</p>..<p
6be0: 3e 0a 54 68 65 20 3c 73 74 72 6f 6e 67 3e 74 6c >.The <strong>tl
6bf0: 73 3a 3a 64 65 62 75 67 3c 2f 73 74 72 6f 6e 67 s::debug</strong
6c00: 3e 20 76 61 72 69 61 62 6c 65 20 70 72 6f 76 69 > variable provi
6c10: 64 65 73 20 73 6f 6d 65 20 61 64 64 69 74 69 6f des some additio
6c20: 6e 61 6c 0a 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 nal.control over
6c30: 20 74 68 65 73 65 20 72 65 66 65 72 65 6e 63 65 these reference
6c40: 20 63 61 6c 6c 62 61 63 6b 73 2e 20 20 49 74 73 callbacks. Its
6c50: 20 76 61 6c 75 65 20 69 73 20 7a 65 72 6f 20 62 value is zero b
6c60: 79 20 64 65 66 61 75 6c 74 2e 0a 48 69 67 68 65 y default..Highe
6c70: 72 20 76 61 6c 75 65 73 20 70 72 6f 64 75 63 65 r values produce
6c80: 20 6d 6f 72 65 20 64 69 61 67 6e 6f 73 74 69 63 more diagnostic
6c90: 20 6f 75 74 70 75 74 2c 20 61 6e 64 20 77 69 6c output, and wil
6ca0: 6c 20 61 6c 73 6f 20 66 6f 72 63 65 20 74 68 65 l also force the
6cb0: 0a 76 65 72 69 66 79 20 6d 65 74 68 6f 64 20 69 .verify method i
6cc0: 6e 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 n <strong>tls::c
6cd0: 61 6c 6c 62 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e allback</strong>
6ce0: 20 74 6f 20 61 63 63 65 70 74 20 74 68 65 0a 63 to accept the.c
6cf0: 65 72 74 69 66 69 63 61 74 65 2c 20 65 76 65 6e ertificate, even
6d00: 20 77 68 65 6e 20 69 74 20 69 73 20 69 6e 76 61 when it is inva
6d10: 6c 69 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 3c lid..</p>..<p>.<
6d20: 65 6d 3e 0a 54 68 65 20 75 73 65 20 6f 66 20 74 em>.The use of t
6d30: 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 61 6c he reference cal
6d40: 6c 62 61 63 6b 73 20 3c 73 74 72 6f 6e 67 3e 74 lbacks <strong>t
6d50: 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 3c 2f 73 74 ls::callback</st
6d60: 72 6f 6e 67 3e 2c 0a 3c 73 74 72 6f 6e 67 3e 74 rong>,.<strong>t
6d70: 6c 73 3a 3a 70 61 73 73 77 6f 72 64 3c 2f 73 74 ls::password</st
6d80: 72 6f 6e 67 3e 2c 20 61 6e 64 20 3c 73 74 72 6f rong>, and <stro
6d90: 6e 67 3e 74 6c 73 3a 3a 76 61 6c 69 64 61 74 65 ng>tls::validate
6da0: 5f 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 _command</strong
6db0: 3e 0a 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 >.is not recomme
6dc0: 6e 64 65 64 2e 20 20 54 68 65 79 20 6d 61 79 20 nded. They may
6dd0: 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 be removed from
6de0: 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 2e future releases.
6df0: 0a 3c 2f 65 6d 3e 0a 3c 2f 70 3e 0a 0a 3c 70 3e .</em>.</p>..<p>
6e00: 0a 3c 65 6d 3e 0a 54 68 65 20 75 73 65 20 6f 66 .<em>.The use of
6e10: 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 3c 73 the variable <s
6e20: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 64 65 62 75 67 trong>tls::debug
6e30: 3c 2f 73 74 72 6f 6e 67 3e 20 69 73 20 6e 6f 74 </strong> is not
6e40: 20 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 0a 49 74 recommended..It
6e50: 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 64 20 may be removed
6e60: 66 72 6f 6d 20 66 75 74 75 72 65 20 72 65 6c 65 from future rele
6e70: 61 73 65 73 2e 0a 3c 2f 65 6d 3e 0a 3c 2f 70 3e ases..</em>.</p>
6e80: 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 44 ..<h3><a name="D
6e90: 45 42 55 47 22 3e 44 45 42 55 47 3c 2f 61 3e 3c EBUG">DEBUG</a><
6ea0: 2f 68 33 3e 0a 0a 54 4c 53 20 6b 65 79 20 6c 6f /h3>..TLS key lo
6eb0: 67 67 69 6e 67 20 63 61 6e 20 62 65 20 65 6e 61 gging can be ena
6ec0: 62 6c 65 64 20 62 79 20 73 65 74 74 69 6e 67 20 bled by setting
6ed0: 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 the environment
6ee0: 76 61 72 69 61 62 6c 65 0a 3c 62 3e 53 53 4c 4b variable.<b>SSLK
6ef0: 45 59 4c 4f 47 46 49 4c 45 3c 2f 62 3e 20 74 6f EYLOGFILE</b> to
6f00: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 the name of the
6f10: 20 66 69 6c 65 20 74 6f 20 6c 6f 67 20 74 6f 2e file to log to.
6f20: 20 54 68 65 6e 20 77 68 65 6e 65 76 65 72 20 54 Then whenever T
6f30: 4c 53 0a 6b 65 79 20 6d 61 74 65 72 69 61 6c 20 LS.key material
6f40: 69 73 20 67 65 6e 65 72 61 74 65 64 20 6f 72 20 is generated or
6f50: 72 65 63 65 69 76 65 64 20 69 74 20 77 69 6c 6c received it will
6f60: 20 62 65 20 6c 6f 67 67 65 64 20 74 6f 20 74 68 be logged to th
6f70: 65 20 66 69 6c 65 2e 20 54 68 69 73 0a 69 73 20 e file. This.is
6f80: 75 73 65 66 75 6c 20 66 6f 72 20 6c 6f 67 67 69 useful for loggi
6f90: 6e 67 20 6b 65 79 20 64 61 74 61 20 66 6f 72 20 ng key data for
6fa0: 6e 65 74 77 6f 72 6b 20 6c 6f 67 67 69 6e 67 20 network logging
6fb0: 74 6f 6f 6c 73 20 74 6f 20 75 73 65 20 74 6f 0a tools to use to.
6fc0: 64 65 63 72 79 70 74 20 74 68 65 20 64 61 74 61 decrypt the data
6fd0: 2e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 ...<h3><a name="
6fe0: 48 54 54 50 53 20 45 58 41 4d 50 4c 45 22 3e 48 HTTPS EXAMPLE">H
6ff0: 54 54 50 53 20 45 58 41 4d 50 4c 45 3c 2f 61 3e TTPS EXAMPLE</a>
7000: 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 69 73 20 65 </h3>..<p>This e
7010: 78 61 6d 70 6c 65 20 75 73 65 73 20 61 20 73 61 xample uses a sa
7020: 6d 70 6c 65 20 73 65 72 76 65 72 2e 70 65 6d 20 mple server.pem
7030: 70 72 6f 76 69 64 65 64 20 77 69 74 68 20 74 68 provided with th
7040: 65 20 54 4c 53 20 72 65 6c 65 61 73 65 2c 0a 63 e TLS release,.c
7050: 6f 75 72 74 65 73 79 20 6f 66 20 74 68 65 20 3c ourtesy of the <
7060: 73 74 72 6f 6e 67 3e 4f 70 65 6e 53 53 4c 3c 2f strong>OpenSSL</
7070: 73 74 72 6f 6e 67 3e 20 70 72 6f 6a 65 63 74 2e strong> project.
7080: 3c 2f 70 3e 0a 0a 3c 70 72 65 3e 3c 63 6f 64 65 </p>..<pre><code
7090: 3e 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 >.package requir
70a0: 65 20 68 74 74 70 0a 70 61 63 6b 61 67 65 20 72 e http.package r
70b0: 65 71 75 69 72 65 20 74 6c 73 0a 0a 68 74 74 70 equire tls..http
70c0: 3a 3a 72 65 67 69 73 74 65 72 20 68 74 74 70 73 ::register https
70d0: 20 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 6c 73 443 [list ::tls
70e0: 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f 73 65 ::socket -autose
70f0: 72 76 65 72 6e 61 6d 65 20 74 72 75 65 20 2d 72 rvername true -r
7100: 65 71 75 69 72 65 20 74 72 75 65 20 2d 63 61 64 equire true -cad
7110: 69 72 20 2f 65 74 63 2f 73 73 6c 2f 63 65 72 74 ir /etc/ssl/cert
7120: 73 5d 0a 0a 73 65 74 20 74 6f 6b 20 5b 68 74 74 s]..set tok [htt
7130: 70 3a 3a 67 65 74 75 72 6c 20 68 74 74 70 73 3a p::geturl https:
7140: 2f 2f 77 77 77 2e 74 63 6c 2e 74 6b 2f 5d 0a 3c //www.tcl.tk/].<
7150: 2f 63 6f 64 65 3e 3c 2f 70 72 65 3e 0a 0a 3c 68 /code></pre>..<h
7160: 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 50 45 43 49 3><a name="SPECI
7170: 41 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e AL CONSIDERATION
7180: 53 22 3e 53 50 45 43 49 41 4c 20 43 4f 4e 53 49 S">SPECIAL CONSI
7190: 44 45 52 41 54 49 4f 4e 53 3c 2f 61 3e 3c 2f 68 DERATIONS</a></h
71a0: 33 3e 0a 0a 3c 70 3e 54 68 65 20 63 61 70 61 62 3>..<p>The capab
71b0: 69 6c 69 74 69 65 73 20 6f 66 20 74 68 69 73 20 ilities of this
71c0: 70 61 63 6b 61 67 65 20 63 61 6e 20 76 61 72 79 package can vary
71d0: 20 65 6e 6f 72 6d 6f 75 73 6c 79 20 62 61 73 65 enormously base
71e0: 64 20 75 70 6f 6e 20 68 6f 77 20 79 6f 75 72 0a d upon how your.
71f0: 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 20 OpenSSL library
7200: 77 61 73 20 63 6f 6e 66 69 67 75 72 65 64 20 61 was configured a
7210: 6e 64 20 62 75 69 6c 74 2e 20 4e 65 77 20 76 65 nd built. New ve
7220: 72 73 69 6f 6e 73 20 6d 61 79 20 6f 62 73 6f 6c rsions may obsol
7230: 65 74 65 20 6f 6c 64 65 72 0a 70 72 6f 74 6f 63 ete older.protoc
7240: 6f 6c 20 76 65 72 73 69 6f 6e 73 2c 20 61 64 64 ol versions, add
7250: 20 6f 72 20 72 65 6d 6f 76 65 20 63 69 70 68 65 or remove ciphe
7260: 72 73 2c 20 63 68 61 6e 67 65 20 64 65 66 61 75 rs, change defau
7270: 6c 74 20 76 61 6c 75 65 73 2c 20 65 74 63 2e 20 lt values, etc.
7280: 55 73 65 20 74 68 65 0a 3c 73 74 72 6f 6e 67 3e Use the.<strong>
7290: 74 6c 73 3a 3a 63 69 70 68 65 72 73 3c 2f 73 74 tls::ciphers</st
72a0: 72 6f 6e 67 3e 20 61 6e 64 20 3c 73 74 72 6f 6e rong> and <stron
72b0: 67 3e 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 g>tls::protocols
72c0: 3c 2f 73 74 72 6f 6e 67 3e 20 63 6f 6d 6d 61 6e </strong> comman
72d0: 64 73 20 74 6f 0a 6f 62 74 61 69 6e 20 74 68 65 ds to.obtain the
72e0: 20 73 75 70 70 6f 72 74 65 64 20 76 65 72 73 69 supported versi
72f0: 6f 6e 73 2e 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 ons.</p>..<h3><a
7300: 20 6e 61 6d 65 3d 22 53 45 45 20 41 4c 53 4f 22 name="SEE ALSO"
7310: 3e 53 45 45 20 41 4c 53 4f 3c 2f 61 3e 3c 2f 68 >SEE ALSO</a></h
7320: 33 3e 0a 0a 3c 70 3e 3c 73 74 72 6f 6e 67 3e 73 3>..<p><strong>s
7330: 6f 63 6b 65 74 3c 2f 73 74 72 6f 6e 67 3e 2c 20 ocket</strong>,
7340: 3c 73 74 72 6f 6e 67 3e 66 69 6c 65 65 76 65 6e <strong>fileeven
7350: 74 2c 20 3c 2f 73 74 72 6f 6e 67 3e 3c 61 0a 68 t, </strong><a.h
7360: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e ref="http://www.
7370: 6f 70 65 6e 73 73 6c 2e 6f 72 67 2f 22 3e 3c 73 openssl.org/"><s
7380: 74 72 6f 6e 67 3e 4f 70 65 6e 53 53 4c 3c 2f 73 trong>OpenSSL</s
7390: 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 70 3e 0a 0a trong></a></p>..
73a0: 3c 68 72 3e 0a 0a 3c 70 72 65 3e 0a 43 6f 70 79 <hr>..<pre>.Copy
73b0: 72 69 67 68 74 20 26 63 6f 70 79 3b 20 31 39 39 right © 199
73c0: 39 20 4d 61 74 74 20 4e 65 77 6d 61 6e 2e 0a 43 9 Matt Newman..C
73d0: 6f 70 79 72 69 67 68 74 20 26 63 6f 70 79 3b 20 opyright ©
73e0: 32 30 30 34 20 53 74 61 72 66 69 73 68 20 53 79 2004 Starfish Sy
73f0: 73 74 65 6d 73 2e 0a 3c 2f 70 72 65 3e 0a 3c 2f stems..</pre>.</
7400: 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c 3e 0a body>.</html>.