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 3c 2f b>tls::ciphers</
0460: 62 3e 20 3c 65 6d 3e 3f 70 72 6f 74 6f 63 6f 6c b> <em>?protocol
0470: 3f 20 3f 76 65 72 62 6f 73 65 3f 20 3f 73 75 70 ? ?verbose? ?sup
0480: 70 6f 72 74 65 64 3f 3c 2f 65 6d 3e 3c 2f 64 64 ported?</em></dd
0490: 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c >.. <dd><b>tl
04a0: 73 3a 3a 64 69 67 65 73 74 73 3c 2f 62 3e 20 3c s::digests</b> <
04b0: 65 6d 3e 3f 6e 61 6d 65 3f 3c 2f 65 6d 3e 3c 2f em>?name?</em></
04c0: 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e dd>.. <dd><b>
04d0: 74 6c 73 3a 3a 6d 61 63 73 3c 2f 62 3e 3c 2f 64 tls::macs</b></d
04e0: 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 d>.. <dd><b>t
04f0: 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 ls::protocols</b
0500: 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e ></dd>.. <dd>
0510: 3c 62 3e 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c <b>tls::version<
0520: 2f 62 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 /b></dd>.. <d
0530: 74 3e 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 09 20 t> </dt>..
0540: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 64 <dd><b>tls::d
0550: 69 67 65 73 74 3c 2f 62 3e 20 3c 62 3e 2d 64 69 igest</b> <b>-di
0560: 67 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 6d gest</b> <em>nam
0570: 65 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e e ?options?</em>
0580: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dd>.. <dd><
0590: 62 3e 74 6c 73 3a 3a 63 6d 61 63 3c 2f 62 3e 20 b>tls::cmac</b>
05a0: 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c <b>-cipher</b> <
05b0: 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e em>name</em> <b>
05c0: 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 -key</b> <em>key
05d0: 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c ?options?</em><
05e0: 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 /dd>.. <dd><b
05f0: 3e 74 6c 73 3a 3a 68 6d 61 63 3c 2f 62 3e 20 3c >tls::hmac</b> <
0600: 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 65 b>-digest</b> <e
0610: 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 2d m>name</em> <b>-
0620: 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 key</b> <em>key
0630: 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c 2f ?options?</em></
0640: 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e dd>.. <dd><b>
0650: 74 6c 73 3a 3a 6d 64 34 3c 2f 62 3e 20 3c 65 6d tls::md4</b> <em
0660: 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a >data</em></dd>.
0670: 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a . <dd><b>tls:
0680: 3a 6d 64 35 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 :md5</b> <em>dat
0690: 61 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 a</em></dd>..
06a0: 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 <dd><b>tls::sha
06b0: 31 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 1</b> <em>data</
06c0: 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 em></dd>.. <d
06d0: 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 32 35 36 d><b>tls::sha256
06e0: 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 </b> <em>data</e
06f0: 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 m></dd>.. <dd
0700: 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 35 31 32 3c ><b>tls::sha512<
0710: 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d /b> <em>data</em
0720: 3e 3c 2f 64 64 3e 0a 09 3c 2f 64 6c 3e 0a 20 20 ></dd>..</dl>.
0730: 20 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e </dd>. <dd>
0740: 3c 61 20 68 72 65 66 3d 22 23 43 4f 4d 4d 41 4e <a href="#COMMAN
0750: 44 53 22 3e 43 4f 4d 4d 41 4e 44 53 3c 2f 61 3e DS">COMMANDS</a>
0760: 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 </dd>. <dd><a
0770: 20 68 72 65 66 3d 22 23 43 41 4c 4c 42 41 43 4b href="#CALLBACK
0780: 20 4f 50 54 49 4f 4e 53 22 3e 43 41 4c 4c 42 41 OPTIONS">CALLBA
0790: 43 4b 20 4f 50 54 49 4f 4e 53 3c 2f 61 3e 3c 2f CK OPTIONS</a></
07a0: 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 dd>. <dd><a h
07b0: 72 65 66 3d 22 23 48 54 54 50 53 20 45 58 41 4d ref="#HTTPS EXAM
07c0: 50 4c 45 22 3e 48 54 54 50 53 20 45 58 41 4d 50 PLE">HTTPS EXAMP
07d0: 4c 45 3c 2f 61 3e 3c 2f 64 64 3e 0a 20 20 20 20 LE</a></dd>.
07e0: 3c 64 64 3e 3c 61 20 68 72 65 66 3d 22 23 53 45 <dd><a href="#SE
07f0: 45 20 41 4c 53 4f 22 3e 53 50 45 43 49 41 4c 20 E ALSO">SPECIAL
0800: 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e 53 3c 2f CONSIDERATIONS</
0810: 61 3e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e a></dd>. <dd>
0820: 3c 61 20 68 72 65 66 3d 22 23 53 45 45 20 41 4c <a href="#SEE AL
0830: 53 4f 22 3e 53 45 45 20 41 4c 53 4f 3c 2f 61 3e SO">SEE ALSO</a>
0840: 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 68 72 </dd>.</dl>..<hr
0850: 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 >..<h3><a name="
0860: 4e 41 4d 45 22 3e 4e 41 4d 45 3c 2f 61 3e 3c 2f NAME">NAME</a></
0870: 68 33 3e 0a 0a 3c 70 3e 3c 73 74 72 6f 6e 67 3e h3>..<p><strong>
0880: 74 6c 73 3c 2f 73 74 72 6f 6e 67 3e 20 2d 20 62 tls</strong> - b
0890: 69 6e 64 69 6e 67 20 74 6f 20 3c 73 74 72 6f 6e inding to <stron
08a0: 67 3e 4f 70 65 6e 53 53 4c 3c 2f 73 74 72 6f 6e g>OpenSSL</stron
08b0: 67 3e 0a 74 6f 6f 6c 6b 69 74 2e 3c 2f 70 3e 0a g>.toolkit.</p>.
08c0: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 59 .<h3><a name="SY
08d0: 4e 4f 50 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 NOPSIS">SYNOPSIS
08e0: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 62 </a></h3>..<p><b
08f0: 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 >package require
0900: 20 54 63 6c 20 38 2e 35 3c 2f 62 3e 3c 62 72 3e Tcl 8.5</b><br>
0910: 0a 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 .<b>package requ
0920: 69 72 65 20 74 6c 73 3c 2f 62 3e 3c 62 72 3e 0a ire tls</b><br>.
0930: 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 <br>.<a href="#t
0940: 6c 73 3a 3a 69 6e 69 74 22 3e 3c 62 3e 74 6c 73 ls::init"><b>tls
0950: 3a 3a 69 6e 69 74 3c 2f 62 3e 20 3c 69 3e 3f 6f ::init</b> <i>?o
0960: 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c ptions?</i></a><
0970: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0980: 73 3a 3a 73 6f 63 6b 65 74 22 3e 3c 62 3e 74 6c s::socket"><b>tl
0990: 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 3c 69 s::socket</b> <i
09a0: 3e 3f 6f 70 74 69 6f 6e 73 3f 20 68 6f 73 74 20 >?options? host
09b0: 70 6f 72 74 3c 2f 69 3e 3c 62 72 3e 0a 3c 61 20 port</i><br>.<a
09c0: 68 72 65 66 3d 22 23 74 6c 73 3a 3a 73 6f 63 6b href="#tls::sock
09d0: 65 74 22 3e 3c 62 3e 74 6c 73 3a 3a 73 6f 63 6b et"><b>tls::sock
09e0: 65 74 3c 2f 62 3e 20 3c 69 3e 3f 2d 73 65 72 76 et</b> <i>?-serv
09f0: 65 72 20 63 6f 6d 6d 61 6e 64 3f 20 3f 6f 70 74 er command? ?opt
0a00: 69 6f 6e 73 3f 20 70 6f 72 74 3c 2f 69 3e 3c 2f ions? port</i></
0a10: 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 a><br>.<a href="
0a20: 23 74 6c 73 3a 3a 73 74 61 74 75 73 22 3e 3c 62 #tls::status"><b
0a30: 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 62 3e >tls::status</b>
0a40: 20 3c 69 3e 3f 2d 6c 6f 63 61 6c 3f 20 63 68 61 <i>?-local? cha
0a50: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
0a60: 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a .<a href="#tls::
0a70: 63 6f 6e 6e 65 63 74 69 6f 6e 22 3e 3c 62 3e 74 connection"><b>t
0a80: 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f ls::connection</
0a90: 62 3e 20 3c 69 3e 63 68 61 6e 6e 65 6c 3c 2f 69 b> <i>channel</i
0aa0: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0ab0: 66 3d 22 23 74 6c 73 3a 3a 68 61 6e 64 73 68 61 f="#tls::handsha
0ac0: 6b 65 22 3e 3c 62 3e 74 6c 73 3a 3a 68 61 6e 64 ke"><b>tls::hand
0ad0: 73 68 61 6b 65 3c 2f 62 3e 20 3c 69 3e 63 68 61 shake</b> <i>cha
0ae0: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
0af0: 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a .<a href="#tls::
0b00: 69 6d 70 6f 72 74 22 3e 3c 62 3e 74 6c 73 3a 3a import"><b>tls::
0b10: 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c 69 3e 63 68 import</b> <i>ch
0b20: 61 6e 6e 65 6c 20 3f 6f 70 74 69 6f 6e 73 3f 3c annel ?options?<
0b30: 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 /i></a><br>.<a h
0b40: 72 65 66 3d 22 23 74 6c 73 3a 3a 75 6e 69 6d 70 ref="#tls::unimp
0b50: 6f 72 74 22 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 69 ort"><b>tls::uni
0b60: 6d 70 6f 72 74 3c 2f 62 3e 20 3c 69 3e 63 68 61 mport</b> <i>cha
0b70: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e nnel</i></a><br>
0b80: 0a 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 .<br>.<a href="#
0b90: 74 6c 73 3a 3a 63 69 70 68 65 72 73 22 3e 3c 62 tls::ciphers"><b
0ba0: 3e 74 6c 73 3a 3a 63 69 70 68 65 72 73 3c 2f 62 >tls::ciphers</b
0bb0: 3e 20 3c 69 3e 3f 70 72 6f 74 6f 63 6f 6c 3f 20 > <i>?protocol?
0bc0: 3f 76 65 72 62 6f 73 65 3f 20 3f 73 75 70 70 6f ?verbose? ?suppo
0bd0: 72 74 65 64 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 rted?</i></a><br
0be0: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0bf0: 3a 64 69 67 65 73 74 73 22 3e 3c 62 3e 74 6c 73 :digests"><b>tls
0c00: 3a 3a 64 69 67 65 73 74 73 3c 2f 62 3e 20 3c 69 ::digests</b> <i
0c10: 3e 3f 6e 61 6d 65 3f 3c 2f 69 3e 3c 2f 61 3e 3c >?name?</i></a><
0c20: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0c30: 73 3a 3a 6d 61 63 73 22 3e 3c 62 3e 74 6c 73 3a s::macs"><b>tls:
0c40: 3a 6d 61 63 73 3c 2f 62 3e 3c 2f 61 3e 3c 62 72 :macs</b></a><br
0c50: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0c60: 3a 70 72 6f 74 6f 63 6f 6c 73 22 3e 3c 62 3e 74 :protocols"><b>t
0c70: 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 ls::protocols</b
0c80: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0c90: 66 3d 22 23 74 6c 73 3a 3a 76 65 72 73 69 6f 6e f="#tls::version
0ca0: 22 3e 3c 62 3e 74 6c 73 3a 3a 76 65 72 73 69 6f "><b>tls::versio
0cb0: 6e 3c 2f 62 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 62 n</b></a><br>.<b
0cc0: 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 r>.<a href="#tls
0cd0: 3a 3a 64 69 67 65 73 74 22 3e 3c 62 3e 74 6c 73 ::digest"><b>tls
0ce0: 3a 3a 64 69 67 65 73 74 3c 2f 62 3e 20 3c 62 3e ::digest</b> <b>
0cf0: 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 69 3e 6e -digest</b> <i>n
0d00: 61 6d 65 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 ame ?options?</i
0d10: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0d20: 66 3d 22 23 74 6c 73 3a 3a 63 6d 61 63 22 3e 3c f="#tls::cmac"><
0d30: 62 3e 74 6c 73 3a 3a 63 6d 61 63 3c 2f 62 3e 20 b>tls::cmac</b>
0d40: 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c <b>-cipher</b> <
0d50: 69 3e 6e 61 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b i>name</i> <b>-k
0d60: 65 79 3c 2f 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f ey</b> <i>key ?o
0d70: 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c ptions?</i></a><
0d80: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0d90: 73 3a 3a 68 6d 61 63 22 3e 3c 62 3e 74 6c 73 3a s::hmac"><b>tls:
0da0: 3a 68 6d 61 63 3c 2f 62 3e 20 3c 62 3e 2d 64 69 :hmac</b> <b>-di
0db0: 67 65 73 74 3c 2f 62 3e 20 3c 69 3e 6e 61 6d 65 gest</b> <i>name
0dc0: 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 3c 2f 62 3e </i> <b>-key</b>
0dd0: 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 69 6f 6e 73 <i>key ?options
0de0: 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 ?</i></a><br>.<a
0df0: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 6d 64 34 href="#tls::md4
0e00: 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 64 34 3c 2f 62 "><b>tls::md4</b
0e10: 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c 2f 61 > <i>data</i></a
0e20: 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 ><br>.<a href="#
0e30: 74 6c 73 3a 3a 6d 64 35 22 3e 3c 62 3e 74 6c 73 tls::md5"><b>tls
0e40: 3a 3a 6d 64 35 3c 2f 62 3e 20 3c 69 3e 64 61 74 ::md5</b> <i>dat
0e50: 61 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 a</i></a><br>.<a
0e60: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 73 68 61 href="#tls::sha
0e70: 31 22 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 31 3c 1"><b>tls::sha1<
0e80: 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c /b> <i>data</i><
0e90: 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d /a><br>.<a href=
0ea0: 22 23 74 6c 73 3a 3a 73 68 61 32 35 36 22 3e 3c "#tls::sha256"><
0eb0: 62 3e 74 6c 73 3a 3a 73 68 61 32 35 36 3c 2f 62 b>tls::sha256</b
0ec0: 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c 2f 61 > <i>data</i></a
0ed0: 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 ><br>.<a href="#
0ee0: 74 6c 73 3a 3a 73 68 61 35 31 32 22 3e 3c 62 3e tls::sha512"><b>
0ef0: 74 6c 73 3a 3a 73 68 61 35 31 32 3c 2f 62 3e 20 tls::sha512</b>
0f00: 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c 2f 61 3e 3c <i>data</i></a><
0f10: 62 72 3e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 br>.</p>..<h3><a
0f20: 20 6e 61 6d 65 3d 22 44 45 53 43 52 49 50 54 49 name="DESCRIPTI
0f30: 4f 4e 22 3e 44 45 53 43 52 49 50 54 49 4f 4e 3c ON">DESCRIPTION<
0f40: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 69 /a></h3>..<p>Thi
0f50: 73 20 65 78 74 65 6e 73 69 6f 6e 20 70 72 6f 76 s extension prov
0f60: 69 64 65 73 20 61 20 67 65 6e 65 72 69 63 20 62 ides a generic b
0f70: 69 6e 64 69 6e 67 20 74 6f 20 3c 61 0a 68 72 65 inding to <a.hre
0f80: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 70 f="http://www.op
0f90: 65 6e 73 73 6c 2e 6f 72 67 2f 22 3e 4f 70 65 6e enssl.org/">Open
0fa0: 53 53 4c 3c 2f 61 3e 2c 20 75 74 69 6c 69 7a 69 SSL</a>, utilizi
0fb0: 6e 67 20 74 68 65 0a 3c 73 74 72 6f 6e 67 3e 54 ng the.<strong>T
0fc0: 63 6c 5f 53 74 61 63 6b 43 68 61 6e 6e 65 6c 3c cl_StackChannel<
0fd0: 2f 73 74 72 6f 6e 67 3e 0a 41 50 49 20 66 6f 72 /strong>.API for
0fe0: 20 54 63 6c 20 38 2e 34 20 61 6e 64 20 68 69 67 Tcl 8.4 and hig
0ff0: 68 65 72 2e 20 54 68 65 20 73 6f 63 6b 65 74 73 her. The sockets
1000: 20 62 65 68 61 76 65 20 65 78 61 63 74 6c 79 20 behave exactly
1010: 74 68 65 20 73 61 6d 65 0a 61 73 20 63 68 61 6e the same.as chan
1020: 6e 65 6c 73 20 63 72 65 61 74 65 64 20 75 73 69 nels created usi
1030: 6e 67 20 54 63 6c 27 73 20 62 75 69 6c 74 2d 69 ng Tcl's built-i
1040: 6e 20 3c 73 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 n <strong>socket
1050: 3c 2f 73 74 72 6f 6e 67 3e 0a 63 6f 6d 6d 61 6e </strong>.comman
1060: 64 20 77 69 74 68 20 61 64 64 69 74 69 6f 6e 61 d with additiona
1070: 6c 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 63 6f l options for co
1080: 6e 74 72 6f 6c 6c 69 6e 67 20 74 68 65 20 53 53 ntrolling the SS
1090: 4c 20 73 65 73 73 69 6f 6e 2e 0a 3c 2f 70 3e 0a L session..</p>.
10a0: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 43 4f .<h3><a name="CO
10b0: 4d 4d 41 4e 44 53 22 3e 43 4f 4d 4d 41 4e 44 53 MMANDS">COMMANDS
10c0: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 79 </a></h3>..<p>Ty
10d0: 70 69 63 61 6c 6c 79 20 6f 6e 65 20 77 6f 75 6c pically one woul
10e0: 64 20 75 73 65 20 74 68 65 20 3c 73 74 72 6f 6e d use the <stron
10f0: 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 3c 2f g>tls::socket </
1100: 73 74 72 6f 6e 67 3e 63 6f 6d 6d 61 6e 64 0a 77 strong>command.w
1110: 68 69 63 68 20 70 72 6f 76 69 64 65 73 20 63 6f hich provides co
1120: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 mpatibility with
1130: 20 74 68 65 20 6e 61 74 69 76 65 20 54 63 6c 20 the native Tcl
1140: 3c 73 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 3c 2f <strong>socket</
1150: 73 74 72 6f 6e 67 3e 0a 63 6f 6d 6d 61 6e 64 2e strong>.command.
1160: 20 49 6e 20 73 75 63 68 20 63 61 73 65 73 20 3c In such cases <
1170: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 6d 70 6f strong>tls::impo
1180: 72 74 3c 2f 73 74 72 6f 6e 67 3e 20 73 68 6f 75 rt</strong> shou
1190: 6c 64 20 6e 6f 74 20 62 65 0a 75 73 65 64 20 64 ld not be.used d
11a0: 69 72 65 63 74 6c 79 2e 3c 2f 70 3e 0a 0a 3c 64 irectly.</p>..<d
11b0: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
11c0: 6d 65 3d 22 74 6c 73 3a 3a 69 6e 69 74 22 3e 3c me="tls::init"><
11d0: 62 3e 74 6c 73 3a 3a 69 6e 69 74 20 3c 2f 62 3e b>tls::init </b>
11e0: 3c 69 3e 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e <i>?options?</i>
11f0: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
1200: 64 3e 4f 70 74 69 6f 6e 61 6c 20 66 75 6e 63 74 d>Optional funct
1210: 69 6f 6e 20 74 6f 20 73 65 74 20 74 68 65 20 64 ion to set the d
1220: 65 66 61 75 6c 74 20 6f 70 74 69 6f 6e 73 20 75 efault options u
1230: 73 65 64 20 62 79 0a 09 3c 73 74 72 6f 6e 67 3e sed by..<strong>
1240: 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 73 74 72 tls::socket</str
1250: 6f 6e 67 3e 2e 20 49 66 20 79 6f 75 20 63 61 6c ong>. If you cal
1260: 6c 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 l <strong>tls::i
1270: 6d 70 6f 72 74 3c 2f 73 74 72 6f 6e 67 3e 0a 09 mport</strong>..
1280: 64 69 72 65 63 74 6c 79 20 74 68 69 73 20 72 6f directly this ro
1290: 75 74 69 6e 65 20 68 61 73 20 6e 6f 20 65 66 66 utine has no eff
12a0: 65 63 74 2e 20 41 6e 79 20 6f 66 20 74 68 65 20 ect. Any of the
12b0: 6f 70 74 69 6f 6e 73 0a 09 74 68 61 74 20 3c 73 options..that <s
12c0: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 trong>tls::socke
12d0: 74 3c 2f 73 74 72 6f 6e 67 3e 20 61 63 63 65 70 t</strong> accep
12e0: 74 73 20 63 61 6e 20 62 65 20 73 65 74 0a 09 75 ts can be set..u
12f0: 73 69 6e 67 20 74 68 69 73 20 63 6f 6d 6d 61 6e sing this comman
1300: 64 2c 20 74 68 6f 75 67 68 20 79 6f 75 20 73 68 d, though you sh
1310: 6f 75 6c 64 20 6c 69 6d 69 74 20 79 6f 75 72 20 ould limit your
1320: 6f 70 74 69 6f 6e 73 0a 09 74 6f 20 6f 6e 6c 79 options..to only
1330: 20 54 4c 53 20 72 65 6c 61 74 65 64 20 6f 6e 65 TLS related one
1340: 73 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 3e s.</dd>. <dt>
1350: 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 20 </dt>.
1360: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
1370: 3a 3a 73 6f 63 6b 65 74 22 3e 3c 62 3e 74 6c 73 ::socket"><b>tls
1380: 3a 3a 73 6f 63 6b 65 74 20 3c 2f 62 3e 3c 65 6d ::socket </b><em
1390: 3e 3f 6f 70 74 69 6f 6e 73 3f 0a 09 68 6f 73 74 >?options?..host
13a0: 20 70 6f 72 74 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f port</em></a></
13b0: 64 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 62 3e 74 dt>. <dt><b>t
13c0: 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e 3c 65 ls::socket</b><e
13d0: 6d 3e 20 3f 2d 73 65 72 76 65 72 20 63 6f 6d 6d m> ?-server comm
13e0: 61 6e 64 3f 20 3f 6f 70 74 69 6f 6e 73 3f 20 70 and? ?options? p
13f0: 6f 72 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 20 20 ort</em></dt>.
1400: 20 20 3c 64 64 3e 54 68 69 73 20 69 73 20 61 20 <dd>This is a
1410: 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 helper function
1420: 74 68 61 74 20 75 74 69 6c 69 7a 65 73 20 74 68 that utilizes th
1430: 65 20 75 6e 64 65 72 6c 79 69 6e 67 0a 09 63 6f e underlying..co
1440: 6d 6d 61 6e 64 73 20 28 3c 73 74 72 6f 6e 67 3e mmands (<strong>
1450: 74 6c 73 3a 3a 69 6d 70 6f 72 74 3c 2f 73 74 72 tls::import</str
1460: 6f 6e 67 3e 29 2e 20 49 74 20 62 65 68 61 76 65 ong>). It behave
1470: 73 0a 09 65 78 61 63 74 6c 79 20 74 68 65 20 73 s..exactly the s
1480: 61 6d 65 20 61 73 20 74 68 65 20 6e 61 74 69 76 ame as the nativ
1490: 65 20 54 63 6c 20 3c 73 74 72 6f 6e 67 3e 73 6f e Tcl <strong>so
14a0: 63 6b 65 74 3c 2f 73 74 72 6f 6e 67 3e 0a 09 63 cket</strong>..c
14b0: 6f 6d 6d 61 6e 64 20 65 78 63 65 70 74 20 74 68 ommand except th
14c0: 61 74 20 74 68 65 20 6f 70 74 69 6f 6e 73 20 63 at the options c
14d0: 61 6e 20 69 6e 63 6c 75 64 65 20 61 6e 79 20 6f an include any o
14e0: 66 20 74 68 65 0a 09 61 70 70 6c 69 63 61 62 6c f the..applicabl
14f0: 65 20 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a e <a href="#tls:
1500: 3a 69 6d 70 6f 72 74 22 3e 3c 73 74 72 6f 6e 67 :import"><strong
1510: 3e 74 6c 73 3a 69 6d 70 6f 72 74 3c 2f 73 74 72 >tls:import</str
1520: 6f 6e 67 3e 3c 2f 61 3e 0a 09 6f 70 74 69 6f 6e ong></a>..option
1530: 73 20 77 69 74 68 20 6f 6e 65 20 61 64 64 69 74 s with one addit
1540: 69 6f 6e 61 6c 20 6f 70 74 69 6f 6e 3a 0a 3c 62 ional option:.<b
1550: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c lockquote>. <
1560: 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dl>..<dt><strong
1570: 3e 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 6d 65 >-autoservername
1580: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f </strong> <em>bo
1590: 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 ol</em></dt>..<d
15a0: 64 3e 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 d>Automatically
15b0: 73 65 6e 64 20 74 68 65 20 2d 73 65 72 76 65 72 send the -server
15c0: 6e 61 6d 65 20 61 73 20 74 68 65 20 3c 65 6d 3e name as the <em>
15d0: 68 6f 73 74 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 host</em> argume
15e0: 6e 74 0a 09 20 20 20 20 28 64 65 66 61 75 6c 74 nt.. (default
15f0: 20 69 73 20 3c 65 6d 3e 66 61 6c 73 65 3c 2f 65 is <em>false</e
1600: 6d 3e 29 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 m>)</dd>. </d
1610: 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e l>.</blockquote>
1620: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
1630: 65 3d 22 74 6c 73 3a 3a 69 6d 70 6f 72 74 22 3e e="tls::import">
1640: 3c 62 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 20 3c <b>tls::import <
1650: 2f 62 3e 3c 69 3e 63 68 61 6e 6e 65 6c 0a 09 3f /b><i>channel..?
1660: 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e options?</i></a>
1670: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 53 </dt>. <dd>SS
1680: 4c 2d 65 6e 61 62 6c 65 20 61 20 72 65 67 75 6c L-enable a regul
1690: 61 72 20 54 63 6c 20 63 68 61 6e 6e 65 6c 20 2d ar Tcl channel -
16a0: 20 69 74 20 6e 65 65 64 20 6e 6f 74 20 62 65 20 it need not be
16b0: 61 0a 09 73 6f 63 6b 65 74 2c 20 62 75 74 20 6d a..socket, but m
16c0: 75 73 74 20 70 72 6f 76 69 64 65 20 62 69 2d 64 ust provide bi-d
16d0: 69 72 65 63 74 69 6f 6e 61 6c 20 66 6c 6f 77 2e irectional flow.
16e0: 20 41 6c 73 6f 0a 09 73 65 74 74 69 6e 67 20 73 Also..setting s
16f0: 65 73 73 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 ession parameter
1700: 73 20 66 6f 72 20 53 53 4c 20 68 61 6e 64 73 68 s for SSL handsh
1710: 61 6b 65 2e 3c 2f 64 64 3e 0a 0a 3c 62 6c 6f 63 ake.</dd>..<bloc
1720: 6b 71 75 6f 74 65 3e 0a 20 20 20 20 3c 64 6c 3e kquote>. <dl>
1730: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 61 ..<dt><strong>-a
1740: 6c 70 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d lpn</strong> <em
1750: 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >list</em></dt>.
1760: 09 3c 64 64 3e 4c 69 73 74 20 6f 66 20 70 72 6f .<dd>List of pro
1770: 74 6f 63 6f 6c 73 20 74 6f 20 6f 66 66 65 72 20 tocols to offer
1780: 64 75 72 69 6e 67 20 41 70 70 6c 69 63 61 74 69 during Applicati
1790: 6f 6e 2d 4c 61 79 65 72 0a 09 20 20 20 20 50 72 on-Layer.. Pr
17a0: 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 61 74 69 otocol Negotiati
17b0: 6f 6e 20 28 41 4c 50 4e 29 2e 20 46 6f 72 20 65 on (ALPN). For e
17c0: 78 61 6d 70 6c 65 3a 20 3c 65 6d 3e 68 32 3c 2f xample: <em>h2</
17d0: 65 6d 3e 20 61 6e 64 0a 09 20 20 20 20 3c 65 6d em> and.. <em
17e0: 3e 68 74 74 70 2f 31 2e 31 3c 2f 65 6d 3e 2c 20 >http/1.1</em>,
17f0: 62 75 74 20 6e 6f 74 20 3c 65 6d 3e 68 33 3c 2f but not <em>h3</
1800: 65 6d 3e 20 6f 72 20 3c 65 6d 3e 71 75 69 63 3c em> or <em>quic<
1810: 2f 65 6d 3e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e /em>.</dd>..<dt>
1820: 3c 73 74 72 6f 6e 67 3e 2d 63 61 64 69 72 3c 2f <strong>-cadir</
1830: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 69 72 3c strong> <em>dir<
1840: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
1850: 65 74 20 74 68 65 20 43 41 20 63 65 72 74 69 66 et the CA certif
1860: 69 63 61 74 65 73 20 70 61 74 68 2e 20 54 68 65 icates path. The
1870: 20 64 65 66 61 75 6c 74 20 64 69 72 65 63 74 6f default directo
1880: 72 79 20 69 73 20 70 6c 61 74 66 6f 72 6d 0a 09 ry is platform..
1890: 20 20 20 20 73 70 65 63 69 66 69 63 20 61 6e 64 specific and
18a0: 20 63 61 6e 20 62 65 20 73 65 74 20 61 74 20 63 can be set at c
18b0: 6f 6d 70 69 6c 65 20 74 69 6d 65 2e 20 54 68 69 ompile time. Thi
18c0: 73 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 s can be overrid
18d0: 64 65 6e 0a 09 20 20 20 20 76 69 61 20 74 68 65 den.. via the
18e0: 20 3c 62 3e 53 53 4c 5f 43 45 52 54 5f 44 49 52 <b>SSL_CERT_DIR
18f0: 3c 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 </b> environment
1900: 20 76 61 72 69 61 62 6c 65 2e 3c 2f 64 64 3e 0a variable.</dd>.
1910: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 61 .<dt><strong>-ca
1920: 66 69 6c 65 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 file </strong><e
1930: 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c m>filename</em><
1940: 2f 64 74 3e 0a 09 3c 64 64 3e 53 65 74 20 74 68 /dt>..<dd>Set th
1950: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 75 e certificate au
1960: 74 68 6f 72 69 74 79 20 28 43 41 29 20 63 65 72 thority (CA) cer
1970: 74 69 66 69 63 61 74 65 73 20 66 69 6c 65 2e 20 tificates file.
1980: 54 68 65 20 64 65 66 61 75 6c 74 0a 09 20 20 20 The default..
1990: 20 69 73 20 74 68 65 20 63 65 72 74 2e 70 65 6d is the cert.pem
19a0: 20 66 69 6c 65 20 69 6e 20 74 68 65 20 4f 70 73 file in the Ops
19b0: 6e 53 53 4c 20 64 69 72 65 63 74 6f 72 79 2e 20 nSSL directory.
19c0: 54 68 69 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 This can also be
19d0: 0a 09 20 20 20 20 6f 76 65 72 72 69 64 64 65 6e .. overridden
19e0: 20 76 69 61 20 74 68 65 20 3c 62 3e 53 53 4c 5f via the <b>SSL_
19f0: 43 45 52 54 5f 46 49 4c 45 3c 2f 62 3e 20 65 6e CERT_FILE</b> en
1a00: 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 vironment variab
1a10: 6c 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 le.</dd>..<dt><s
1a20: 74 72 6f 6e 67 3e 2d 63 65 72 74 66 69 6c 65 3c trong>-certfile<
1a30: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c /strong> <em>fil
1a40: 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a ename</em></dt>.
1a50: 09 3c 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 .<dd>Specify the
1a60: 20 66 69 6c 65 6e 61 6d 65 20 77 69 74 68 20 74 filename with t
1a70: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 74 he certificate t
1a80: 6f 20 75 73 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 o use.</dd>..<dt
1a90: 3e 3c 73 74 72 6f 6e 67 3e 2d 63 65 72 74 3c 2f ><strong>-cert</
1aa0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c 65 strong> <em>file
1ab0: 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 name</em></dt>..
1ac0: 3c 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 20 <dd>Specify the
1ad0: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 63 65 contents of a ce
1ae0: 72 74 69 66 69 63 61 74 65 20 74 6f 20 75 73 65 rtificate to use
1af0: 2c 20 61 73 20 61 20 44 45 52 0a 09 20 20 20 20 , as a DER..
1b00: 65 6e 63 6f 64 65 64 20 62 69 6e 61 72 79 20 76 encoded binary v
1b10: 61 6c 75 65 20 28 58 2e 35 30 39 20 44 45 52 29 alue (X.509 DER)
1b20: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
1b30: 6f 6e 67 3e 2d 63 69 70 68 65 72 3c 2f 73 74 72 ong>-cipher</str
1b40: 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c ong> <em>string<
1b50: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c /em></dt>..<dd>L
1b60: 69 73 74 20 6f 66 20 63 69 70 68 65 72 73 20 74 ist of ciphers t
1b70: 6f 20 75 73 65 2e 20 53 74 72 69 6e 67 20 69 73 o use. String is
1b80: 20 61 20 63 6f 6c 6f 6e 20 28 22 3a 22 29 20 73 a colon (":") s
1b90: 65 70 61 72 61 74 65 64 20 6c 69 73 74 0a 09 20 eparated list..
1ba0: 20 20 20 6f 66 20 63 69 70 68 65 72 73 20 6f 72 of ciphers or
1bb0: 20 63 69 70 68 65 72 20 73 75 69 74 65 73 2e 20 cipher suites.
1bc0: 43 69 70 68 65 72 20 73 75 69 74 65 73 20 63 61 Cipher suites ca
1bd0: 6e 20 62 65 20 63 6f 6d 62 69 6e 65 64 0a 09 20 n be combined..
1be0: 20 20 20 75 73 69 6e 67 20 74 68 65 20 3c 62 3e using the <b>
1bf0: 2b 3c 2f 62 3e 20 63 68 61 72 61 63 74 65 72 2e +</b> character.
1c00: 20 50 72 65 66 69 78 65 73 20 63 61 6e 20 62 65 Prefixes can be
1c10: 20 75 73 65 64 20 74 6f 20 70 65 72 6d 61 6e 65 used to permane
1c20: 6e 74 6c 79 0a 09 20 20 20 20 72 65 6d 6f 76 65 ntly.. remove
1c30: 20 28 22 21 22 29 2c 20 64 65 6c 65 74 65 20 28 ("!"), delete (
1c40: 22 2d 22 29 2c 20 6f 72 20 6d 6f 76 65 20 61 20 "-"), or move a
1c50: 63 79 70 68 65 72 20 74 6f 20 74 68 65 20 65 6e cypher to the en
1c60: 64 20 6f 66 0a 09 20 20 20 20 74 68 65 20 6c 69 d of.. the li
1c70: 73 74 20 28 22 2b 22 29 2e 20 4b 65 79 77 6f 72 st ("+"). Keywor
1c80: 64 73 20 3c 62 3e 40 53 54 52 45 4e 47 54 48 3c ds <b>@STRENGTH<
1c90: 2f 62 3e 20 28 73 6f 72 74 20 62 79 20 61 6c 67 /b> (sort by alg
1ca0: 6f 72 69 74 68 6d 0a 09 20 20 20 20 6b 65 79 20 orithm.. key
1cb0: 6c 65 6e 67 74 68 29 2c 20 3c 62 3e 40 53 45 43 length), <b>@SEC
1cc0: 4c 45 56 45 4c 3d 3c 2f 62 3e 3c 69 3e 6e 3c 2f LEVEL=</b><i>n</
1cd0: 69 3e 20 28 73 65 74 20 73 65 63 75 72 69 74 79 i> (set security
1ce0: 20 6c 65 76 65 6c 20 74 6f 0a 09 20 20 20 20 6e level to.. n
1cf0: 29 2c 20 61 6e 64 20 3c 62 3e 44 45 46 41 55 4c ), and <b>DEFAUL
1d00: 54 3c 2f 62 3e 20 28 75 73 65 20 64 65 66 61 75 T</b> (use defau
1d10: 6c 74 20 63 69 70 68 65 72 20 6c 69 73 74 2c 20 lt cipher list,
1d20: 61 74 20 73 74 61 72 74 20 6f 6e 6c 79 29 0a 09 at start only)..
1d30: 20 20 20 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 can also be
1d40: 73 70 65 63 69 66 69 65 64 2e 20 53 65 65 20 4f specified. See O
1d50: 70 65 6e 53 53 4c 20 64 6f 63 75 6d 65 6e 74 61 penSSL documenta
1d60: 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 66 75 6c tion for the ful
1d70: 6c 0a 09 20 20 20 20 6c 69 73 74 20 6f 66 20 76 l.. list of v
1d80: 61 6c 69 64 20 76 61 6c 75 65 73 2e 20 28 54 4c alid values. (TL
1d90: 53 20 31 2e 32 20 61 6e 64 20 65 61 72 6c 69 65 S 1.2 and earlie
1da0: 72 20 6f 6e 6c 79 29 3c 2f 64 64 3e 0a 09 3c 64 r only)</dd>..<d
1db0: 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 69 70 68 65 t><strong>-ciphe
1dc0: 72 73 75 69 74 65 73 3c 2f 73 74 72 6f 6e 67 3e rsuites</strong>
1dd0: 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e <em>string</em>
1de0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 74 20 </dt>..<dd>List
1df0: 6f 66 20 63 69 70 68 65 72 20 73 75 69 74 65 73 of cipher suites
1e00: 20 74 6f 20 75 73 65 2e 20 53 74 72 69 6e 67 20 to use. String
1e10: 69 73 20 61 20 63 6f 6c 6f 6e 20 28 22 3a 22 29 is a colon (":")
1e20: 0a 09 20 20 20 20 73 65 70 61 72 61 74 65 64 20 .. separated
1e30: 6c 69 73 74 20 6f 66 20 63 69 70 68 65 72 20 73 list of cipher s
1e40: 75 69 74 65 20 6e 61 6d 65 73 2e 20 28 54 4c 53 uite names. (TLS
1e50: 20 31 2e 33 20 6f 6e 6c 79 29 3c 2f 64 64 3e 0a 1.3 only)</dd>.
1e60: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 6f .<dt><strong>-co
1e70: 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c mmand</strong> <
1e80: 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e em>callback</em>
1e90: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 61 6c 6c 62 </dt>..<dd>Callb
1ea0: 61 63 6b 20 74 6f 20 69 6e 76 6f 6b 65 20 61 74 ack to invoke at
1eb0: 20 73 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 20 several points
1ec0: 64 75 72 69 6e 67 20 74 68 65 20 68 61 6e 64 73 during the hands
1ed0: 68 61 6b 65 2e 0a 09 20 20 20 20 54 68 69 73 20 hake... This
1ee0: 69 73 20 75 73 65 64 20 74 6f 20 70 61 73 73 20 is used to pass
1ef0: 65 72 72 6f 72 73 20 61 6e 64 20 74 72 61 63 69 errors and traci
1f00: 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 ng information,
1f10: 61 6e 64 0a 09 20 20 20 20 69 74 20 63 61 6e 20 and.. it can
1f20: 61 6c 6c 6f 77 20 54 63 6c 20 73 63 72 69 70 74 allow Tcl script
1f30: 73 20 74 6f 20 70 65 72 66 6f 72 6d 20 74 68 65 s to perform the
1f40: 69 72 20 6f 77 6e 20 63 65 72 74 69 66 69 63 61 ir own certifica
1f50: 74 65 0a 09 20 20 20 20 76 61 6c 69 64 61 74 69 te.. validati
1f60: 6f 6e 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 on in place of t
1f70: 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 69 64 he default valid
1f80: 61 74 69 6f 6e 20 70 72 6f 76 69 64 65 64 20 62 ation provided b
1f90: 79 0a 09 20 20 20 20 4f 70 65 6e 53 53 4c 2e 20 y.. OpenSSL.
1fa0: 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 43 41 See <a href="#CA
1fb0: 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 3e LLBACK OPTIONS">
1fc0: 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 CALLBACK OPTIONS
1fd0: 3c 2f 61 3e 0a 09 20 20 20 20 66 6f 72 20 66 75 </a>.. for fu
1fe0: 72 74 68 65 72 20 64 69 73 63 75 73 73 69 6f 6e rther discussion
1ff0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
2000: 6f 6e 67 3e 2d 64 68 70 61 72 61 6d 73 20 3c 2f ong>-dhparams </
2010: 73 74 72 6f 6e 67 3e 3c 65 6d 3e 66 69 6c 65 6e strong><em>filen
2020: 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ame</em></dt>..<
2030: 64 64 3e 53 70 65 63 69 66 79 20 74 68 65 20 44 dd>Specify the D
2040: 69 66 66 69 65 2d 48 65 6c 6c 6d 61 6e 20 70 61 iffie-Hellman pa
2050: 72 61 6d 65 74 65 72 73 20 66 69 6c 65 2e 3c 2f rameters file.</
2060: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
2070: 3e 2d 6b 65 79 66 69 6c 65 3c 2f 73 74 72 6f 6e >-keyfile</stron
2080: 67 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c g> <em>filename<
2090: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
20a0: 70 65 63 69 66 79 20 74 68 65 20 70 72 69 76 61 pecify the priva
20b0: 74 65 20 6b 65 79 20 66 69 6c 65 2e 20 28 64 65 te key file. (de
20c0: 66 61 75 6c 74 20 69 73 0a 09 20 20 20 20 76 61 fault is.. va
20d0: 6c 75 65 20 6f 66 20 2d 63 65 72 74 66 69 6c 65 lue of -certfile
20e0: 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 )</dd>..<dt><str
20f0: 6f 6e 67 3e 2d 6b 65 79 3c 2f 73 74 72 6f 6e 67 ong>-key</strong
2100: 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f > <em>filename</
2110: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 70 em></dt>..<dd>Sp
2120: 65 63 69 66 79 20 74 68 65 20 70 72 69 76 61 74 ecify the privat
2130: 65 20 6b 65 79 20 74 6f 20 75 73 65 20 61 73 20 e key to use as
2140: 61 20 44 45 52 20 65 6e 63 6f 64 65 64 20 76 61 a DER encoded va
2150: 6c 75 65 20 28 50 4b 43 53 23 31 20 44 45 52 29 lue (PKCS#1 DER)
2160: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
2170: 6e 67 3e 2d 6d 6f 64 65 6c 3c 2f 73 74 72 6f 6e ng>-model</stron
2180: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 3c 2f g> <em>channel</
2190: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 46 6f em></dt>..<dd>Fo
21a0: 72 63 65 20 74 68 69 73 20 63 68 61 6e 6e 65 6c rce this channel
21b0: 20 74 6f 20 73 68 61 72 65 20 74 68 65 20 73 61 to share the sa
21c0: 6d 65 20 3c 65 6d 3e 3c 73 74 72 6f 6e 67 3e 53 me <em><strong>S
21d0: 53 4c 5f 43 54 58 3c 2f 73 74 72 6f 6e 67 3e 3c SL_CTX</strong><
21e0: 2f 65 6d 3e 0a 09 20 20 20 20 73 74 72 75 63 74 /em>.. struct
21f0: 75 72 65 20 61 73 20 74 68 65 20 73 70 65 63 69 ure as the speci
2200: 66 69 65 64 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c fied <em>channel
2210: 3c 2f 65 6d 3e 2c 20 61 6e 64 0a 09 20 20 20 20 </em>, and..
2220: 74 68 65 72 65 66 6f 72 65 20 73 68 61 72 65 20 therefore share
2230: 63 61 6c 6c 62 61 63 6b 73 20 65 74 63 2e 3c 2f callbacks etc.</
2240: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
2250: 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f >-password</stro
2260: 6e 67 3e 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b ng> <em>callback
2270: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
2280: 43 61 6c 6c 62 61 63 6b 20 74 6f 20 69 6e 76 6f Callback to invo
2290: 6b 65 20 77 68 65 6e 20 4f 70 65 6e 53 53 4c 20 ke when OpenSSL
22a0: 6e 65 65 64 73 20 74 6f 20 6f 62 74 61 69 6e 20 needs to obtain
22b0: 61 20 70 61 73 73 77 6f 72 64 2c 0a 09 20 20 20 a password,..
22c0: 20 74 79 70 69 63 61 6c 6c 79 20 74 6f 20 75 6e typically to un
22d0: 6c 6f 63 6b 20 74 68 65 20 70 72 69 76 61 74 65 lock the private
22e0: 20 6b 65 79 20 6f 66 20 61 20 63 65 72 74 69 66 key of a certif
22f0: 69 63 61 74 65 2e 20 54 68 65 0a 09 20 20 20 20 icate. The..
2300: 63 61 6c 6c 62 61 63 6b 20 73 68 6f 75 6c 64 20 callback should
2310: 72 65 74 75 72 6e 20 61 20 73 74 72 69 6e 67 20 return a string
2320: 77 68 69 63 68 20 72 65 70 72 65 73 65 6e 74 73 which represents
2330: 20 74 68 65 20 70 61 73 73 77 6f 72 64 0a 09 20 the password..
2340: 20 20 20 74 6f 20 62 65 20 75 73 65 64 2e 20 53 to be used. S
2350: 65 65 20 3c 61 20 68 72 65 66 3d 22 23 43 41 4c ee <a href="#CAL
2360: 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 3e 43 LBACK OPTIONS">C
2370: 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 3c ALLBACK OPTIONS<
2380: 2f 61 3e 0a 09 20 20 20 20 66 6f 72 20 66 75 72 /a>.. for fur
2390: 74 68 65 72 20 64 69 73 63 75 73 73 69 6f 6e 2e ther discussion.
23a0: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
23b0: 6e 67 3e 2d 70 6f 73 74 5f 68 61 6e 64 73 68 61 ng>-post_handsha
23c0: 6b 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e ke</strong> <em>
23d0: 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 bool</em></dt>..
23e0: 3c 64 64 3e 41 6c 6c 6f 77 20 70 6f 73 74 2d 68 <dd>Allow post-h
23f0: 61 6e 64 73 68 61 6b 65 20 74 69 63 6b 65 74 20 andshake ticket
2400: 75 70 64 61 74 65 73 2e 3c 2f 64 64 3e 0a 09 3c updates.</dd>..<
2410: 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 72 65 71 75 dt><strong>-requ
2420: 65 73 74 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 6d est </strong><em
2430: 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >bool</em></dt>.
2440: 09 3c 64 64 3e 52 65 71 75 65 73 74 20 61 20 63 .<dd>Request a c
2450: 65 72 74 69 66 69 63 61 74 65 20 66 72 6f 6d 20 ertificate from
2460: 70 65 65 72 20 64 75 72 69 6e 67 20 53 53 4c 20 peer during SSL
2470: 68 61 6e 64 73 68 61 6b 65 2e 0a 09 20 20 20 20 handshake...
2480: 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e (default is <em>
2490: 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a true</em>)</dd>.
24a0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 72 65 .<dt><strong>-re
24b0: 71 75 69 72 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c quire</strong> <
24c0: 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 em>bool</em></dt
24d0: 3e 0a 09 3c 64 64 3e 52 65 71 75 69 72 65 20 61 >..<dd>Require a
24e0: 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 61 valid certifica
24f0: 74 65 20 66 72 6f 6d 20 70 65 65 72 20 64 75 72 te from peer dur
2500: 69 6e 67 20 53 53 4c 20 68 61 6e 64 73 68 61 6b ing SSL handshak
2510: 65 2e 0a 09 20 20 20 20 49 66 20 74 68 69 73 20 e... If this
2520: 69 73 20 73 65 74 20 74 6f 20 74 72 75 65 2c 20 is set to true,
2530: 74 68 65 6e 20 3c 73 74 72 6f 6e 67 3e 2d 72 65 then <strong>-re
2540: 71 75 65 73 74 3c 2f 73 74 72 6f 6e 67 3e 20 6d quest</strong> m
2550: 75 73 74 0a 09 20 20 20 20 61 6c 73 6f 20 62 65 ust.. also be
2560: 20 73 65 74 20 74 6f 20 74 72 75 65 2e 20 28 64 set to true. (d
2570: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 66 61 efault is <em>fa
2580: 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 lse</em>)</dd>..
2590: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 65 63 <dt><strong>-sec
25a0: 75 72 69 74 79 6c 65 76 65 6c 3c 2f 73 74 72 6f uritylevel</stro
25b0: 6e 67 3e 20 3c 65 6d 3e 69 6e 74 65 67 65 72 3c ng> <em>integer<
25c0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 /em></dt>..<dd>S
25d0: 65 74 20 73 65 63 75 72 69 74 79 20 6c 65 76 65 et security leve
25e0: 6c 2e 20 4d 75 73 74 20 62 65 20 30 20 74 6f 20 l. Must be 0 to
25f0: 35 2e 20 54 68 65 20 73 65 63 75 72 69 74 79 20 5. The security
2600: 6c 65 76 65 6c 20 61 66 66 65 63 74 73 0a 09 20 level affects..
2610: 20 20 20 63 69 70 68 65 72 20 73 75 69 74 65 20 cipher suite
2620: 65 6e 63 72 79 70 74 69 6f 6e 20 61 6c 67 6f 72 encryption algor
2630: 69 74 68 6d 73 2c 20 73 75 70 70 6f 72 74 65 64 ithms, supported
2640: 20 45 43 43 20 63 75 72 76 65 73 2c 0a 09 20 20 ECC curves,..
2650: 20 20 73 75 70 70 6f 72 74 65 64 20 73 69 67 6e supported sign
2660: 61 74 75 72 65 20 61 6c 67 6f 72 69 74 68 6d 73 ature algorithms
2670: 2c 20 44 48 20 70 61 72 61 6d 65 74 65 72 20 73 , DH parameter s
2680: 69 7a 65 73 2c 20 63 65 72 74 69 66 69 63 61 74 izes, certificat
2690: 65 0a 09 20 20 20 20 6b 65 79 20 73 69 7a 65 73 e.. key sizes
26a0: 20 61 6e 64 20 73 69 67 6e 61 74 75 72 65 20 61 and signature a
26b0: 6c 67 6f 72 69 74 68 6d 73 2e 20 54 68 65 20 64 lgorithms. The d
26c0: 65 66 61 75 6c 74 20 69 73 20 31 2e 0a 09 20 20 efault is 1...
26d0: 20 20 4c 65 76 65 6c 20 33 20 61 6e 64 20 68 69 Level 3 and hi
26e0: 67 68 65 72 20 64 69 73 61 62 6c 65 20 73 75 70 gher disable sup
26f0: 70 6f 72 74 20 66 6f 72 20 73 65 73 73 69 6f 6e port for session
2700: 20 74 69 63 6b 65 74 73 20 61 6e 64 20 6f 6e 6c tickets and onl
2710: 79 0a 09 20 20 20 20 61 63 63 65 70 74 20 63 69 y.. accept ci
2720: 70 68 65 72 20 73 75 69 74 65 73 20 74 68 61 74 pher suites that
2730: 20 70 72 6f 76 69 64 65 20 66 6f 72 77 61 72 64 provide forward
2740: 20 73 65 63 72 65 63 79 2e 3c 2f 64 64 3e 0a 09 secrecy.</dd>..
2750: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 65 72 <dt><strong>-ser
2760: 76 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ver</strong> <em
2770: 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >bool</em></dt>.
2780: 09 3c 64 64 3e 48 61 6e 64 73 68 61 6b 65 20 61 .<dd>Handshake a
2790: 73 20 73 65 72 76 65 72 20 69 66 20 74 72 75 65 s server if true
27a0: 2c 20 65 6c 73 65 20 68 61 6e 64 73 68 61 6b 65 , else handshake
27b0: 20 61 73 0a 09 20 20 20 20 63 6c 69 65 6e 74 2e as.. client.
27c0: 20 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d (default is <em
27d0: 3e 66 61 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 >false</em>)</dd
27e0: 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d >..<dt><strong>-
27f0: 73 65 72 76 65 72 6e 61 6d 65 3c 2f 73 74 72 6f servername</stro
2800: 6e 67 3e 20 3c 65 6d 3e 68 6f 73 74 3c 2f 65 6d ng> <em>host</em
2810: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 70 65 63 ></dt>..<dd>Spec
2820: 69 66 79 20 73 65 72 76 65 72 20 68 6f 73 74 6e ify server hostn
2830: 61 6d 65 2e 20 4f 6e 6c 79 20 61 76 61 69 6c 61 ame. Only availa
2840: 62 6c 65 20 69 66 20 74 68 65 20 4f 70 65 6e 53 ble if the OpenS
2850: 53 4c 20 6c 69 62 72 61 72 79 0a 09 20 20 20 20 SL library..
2860: 74 68 65 20 70 61 63 6b 61 67 65 20 69 73 20 6c the package is l
2870: 69 6e 6b 65 64 20 61 67 61 69 6e 73 74 20 73 75 inked against su
2880: 70 70 6f 72 74 73 20 74 68 65 20 54 4c 53 20 68 pports the TLS h
2890: 6f 73 74 6e 61 6d 65 20 65 78 74 65 6e 73 69 6f ostname extensio
28a0: 6e 0a 09 20 20 20 20 66 6f 72 20 27 53 65 72 76 n.. for 'Serv
28b0: 65 72 20 4e 61 6d 65 20 49 6e 64 69 63 61 74 69 er Name Indicati
28c0: 6f 6e 27 20 28 53 4e 49 29 2e 20 55 73 65 20 74 on' (SNI). Use t
28d0: 6f 20 6e 61 6d 65 20 74 68 65 20 6c 6f 67 69 63 o name the logic
28e0: 61 6c 20 68 6f 73 74 0a 09 20 20 20 20 77 65 20 al host.. we
28f0: 61 72 65 20 74 61 6c 6b 69 6e 67 20 74 6f 20 61 are talking to a
2900: 6e 64 20 65 78 70 65 63 74 69 6e 67 20 61 20 63 nd expecting a c
2910: 65 72 74 69 66 69 63 61 74 65 20 66 6f 72 2e 3c ertificate for.<
2920: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
2930: 67 3e 2d 73 65 73 73 69 6f 6e 5f 69 64 3c 2f 73 g>-session_id</s
2940: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
2950: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
2960: 3e 53 65 73 73 69 6f 6e 20 69 64 20 74 6f 20 72 >Session id to r
2970: 65 73 75 6d 65 20 73 65 73 73 69 6f 6e 2e 3c 2f esume session.</
2980: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
2990: 3e 2d 73 73 6c 32 3c 2f 73 74 72 6f 6e 67 3e 20 >-ssl2</strong>
29a0: 3c 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 <em>bool</em></d
29b0: 74 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 20 75 t>..<dd>Enable u
29c0: 73 65 20 6f 66 20 53 53 4c 20 76 32 2e 20 28 64 se of SSL v2. (d
29d0: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 66 61 efault is <em>fa
29e0: 6c 73 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 lse</em>)</dd>..
29f0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 73 73 6c <dt><strong>-ssl
2a00: 33 20 3c 2f 73 74 72 6f 6e 67 3e 3c 65 6d 3e 62 3 </strong><em>b
2a10: 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ool</em></dt>..<
2a20: 64 64 3e 45 6e 61 62 6c 65 20 75 73 65 20 6f 66 dd>Enable use of
2a30: 20 53 53 4c 20 76 33 2e 20 28 64 65 66 61 75 6c SSL v3. (defaul
2a40: 74 20 69 73 20 3c 65 6d 3e 66 61 6c 73 65 3c 2f t is <em>false</
2a50: 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e 2d em>)</dd>..<dt>-
2a60: 3c 73 74 72 6f 6e 67 3e 74 6c 73 31 3c 2f 73 74 <strong>tls1</st
2a70: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 3c 2f rong> <em>bool</
2a80: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 45 6e em></dt>..<dd>En
2a90: 61 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 able use of TLS
2aa0: 76 31 2e 20 28 64 65 66 61 75 6c 74 20 69 73 20 v1. (default is
2ab0: 3c 65 6d 3e 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f <em>true</em>)</
2ac0: 64 64 3e 0a 09 3c 64 74 3e 2d 3c 73 74 72 6f 6e dd>..<dt>-<stron
2ad0: 67 3e 74 6c 73 31 2e 31 3c 2f 73 74 72 6f 6e 67 g>tls1.1</strong
2ae0: 3e 20 3c 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c > <em>bool</em><
2af0: 2f 64 74 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 /dt>..<dd>Enable
2b00: 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 2e 31 use of TLS v1.1
2b10: 20 28 64 65 66 61 75 6c 74 20 69 73 20 3c 65 6d (default is <em
2b20: 3e 74 72 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e >true</em>)</dd>
2b30: 0a 09 3c 64 74 3e 2d 3c 73 74 72 6f 6e 67 3e 74 ..<dt>-<strong>t
2b40: 6c 73 31 2e 32 3c 2f 73 74 72 6f 6e 67 3e 20 3c ls1.2</strong> <
2b50: 65 6d 3e 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 em>bool</em></dt
2b60: 3e 0a 09 3c 64 64 3e 45 6e 61 62 6c 65 20 75 73 >..<dd>Enable us
2b70: 65 20 6f 66 20 54 4c 53 20 76 31 2e 32 20 28 64 e of TLS v1.2 (d
2b80: 65 66 61 75 6c 74 20 69 73 20 3c 65 6d 3e 74 72 efault is <em>tr
2b90: 75 65 3c 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c ue</em>)</dd>..<
2ba0: 64 74 3e 2d 3c 73 74 72 6f 6e 67 3e 74 6c 73 31 dt>-<strong>tls1
2bb0: 2e 33 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e .3</strong> <em>
2bc0: 62 6f 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 bool</em></dt>..
2bd0: 3c 64 64 3e 45 6e 61 62 6c 65 20 75 73 65 20 6f <dd>Enable use o
2be0: 66 20 54 4c 53 20 76 31 2e 33 20 28 64 65 66 61 f TLS v1.3 (defa
2bf0: 75 6c 74 20 69 73 20 3c 65 6d 3e 74 72 75 65 3c ult is <em>true<
2c00: 2f 65 6d 3e 29 3c 2f 64 64 3e 0a 09 3c 64 74 3e /em>)</dd>..<dt>
2c10: 3c 73 74 72 6f 6e 67 3e 2d 76 61 6c 69 64 61 74 <strong>-validat
2c20: 65 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 ecommand</strong
2c30: 3e 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f > <em>callback</
2c40: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 61 em></dt>..<dd>Ca
2c50: 6c 6c 62 61 63 6b 20 74 6f 20 69 6e 76 6f 6b 65 llback to invoke
2c60: 20 74 6f 20 76 65 72 69 66 79 20 6f 72 20 76 61 to verify or va
2c70: 6c 69 64 61 74 65 20 70 72 6f 74 6f 63 6f 6c 20 lidate protocol
2c80: 63 6f 6e 66 69 67 0a 09 20 20 20 20 70 61 72 61 config.. para
2c90: 6d 65 74 65 72 73 20 64 75 72 69 6e 67 20 74 68 meters during th
2ca0: 65 20 70 72 6f 74 6f 63 6f 6c 20 6e 65 67 6f 74 e protocol negot
2cb0: 69 61 74 69 6f 6e 20 70 68 61 73 65 2e 20 53 65 iation phase. Se
2cc0: 65 0a 09 20 20 20 20 3c 61 20 68 72 65 66 3d 22 e.. <a href="
2cd0: 23 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e #CALLBACK OPTION
2ce0: 53 22 3e 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 S">CALLBACK OPTI
2cf0: 4f 4e 53 3c 2f 61 3e 0a 09 20 20 20 20 66 6f 72 ONS</a>.. for
2d00: 20 66 75 72 74 68 65 72 20 64 69 73 63 75 73 73 further discuss
2d10: 69 6f 6e 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f ion.</dd>. </
2d20: 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 dl>.</blockquote
2d30: 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 >.. <dt><a na
2d40: 6d 65 3d 22 74 6c 73 3a 3a 75 6e 69 6d 70 6f 72 me="tls::unimpor
2d50: 74 22 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 69 6d 70 t"><b>tls::unimp
2d60: 6f 72 74 20 3c 2f 62 3e 3c 69 3e 63 68 61 6e 6e ort </b><i>chann
2d70: 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a el</i></a></dt>.
2d80: 20 20 20 20 3c 64 64 3e 50 72 6f 76 69 64 65 64 <dd>Provided
2d90: 20 66 6f 72 20 73 79 6d 6d 65 74 72 79 20 74 6f for symmetry to
2da0: 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 69 6d <strong>tls::im
2db0: 70 6f 72 74 3c 2f 73 74 72 6f 6e 67 3e 2c 20 74 port</strong>, t
2dc0: 68 69 73 0a 20 20 20 20 20 20 75 6e 73 74 61 63 his. unstac
2dd0: 6b 73 20 74 68 65 20 53 53 4c 2d 65 6e 61 62 6c ks the SSL-enabl
2de0: 69 6e 67 20 6f 66 20 61 20 72 65 67 75 6c 61 72 ing of a regular
2df0: 20 54 63 6c 20 63 68 61 6e 6e 65 6c 2e 20 20 41 Tcl channel. A
2e00: 6e 20 65 72 72 6f 72 0a 20 20 20 20 20 20 69 73 n error. is
2e10: 20 74 68 72 6f 77 6e 20 69 66 20 54 4c 53 20 69 thrown if TLS i
2e20: 73 20 6e 6f 74 20 74 68 65 20 74 6f 70 20 73 74 s not the top st
2e30: 61 63 6b 65 64 20 63 68 61 6e 6e 65 6c 20 74 79 acked channel ty
2e40: 70 65 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 pe.</dd>. <dt
2e50: 3e 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 > </dt>.
2e60: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
2e70: 73 3a 3a 68 61 6e 64 73 68 61 6b 65 22 3e 3c 73 s::handshake"><s
2e80: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 68 61 6e 64 73 trong>tls::hands
2e90: 68 61 6b 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 hake</strong> <e
2ea0: 6d 3e 63 68 61 6e 6e 65 6c 3c 2f 65 6d 3e 3c 2f m>channel</em></
2eb0: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
2ec0: 46 6f 72 63 65 73 20 68 61 6e 64 73 68 61 6b 65 Forces handshake
2ed0: 20 74 6f 20 74 61 6b 65 20 70 6c 61 63 65 2c 20 to take place,
2ee0: 61 6e 64 20 72 65 74 75 72 6e 73 20 30 20 69 66 and returns 0 if
2ef0: 0a 09 68 61 6e 64 73 68 61 6b 65 20 69 73 20 73 ..handshake is s
2f00: 74 69 6c 6c 20 69 6e 20 70 72 6f 67 72 65 73 73 till in progress
2f10: 20 28 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 29 2c (non-blocking),
2f20: 20 6f 72 20 31 20 69 66 0a 09 74 68 65 20 68 61 or 1 if..the ha
2f30: 6e 64 73 68 61 6b 65 20 77 61 73 20 73 75 63 63 ndshake was succ
2f40: 65 73 73 66 75 6c 2e 20 49 66 20 74 68 65 20 68 essful. If the h
2f50: 61 6e 64 73 68 61 6b 65 20 66 61 69 6c 65 64 0a andshake failed.
2f60: 09 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 .this routine wi
2f70: 6c 6c 20 74 68 72 6f 77 20 61 6e 20 65 72 72 6f ll throw an erro
2f80: 72 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 74 3e r.</dd>. <dt>
2f90: 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 20 20 20 20 </dt>.
2fa0: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
2fb0: 3a 3a 73 74 61 74 75 73 22 3e 3c 73 74 72 6f 6e ::status"><stron
2fc0: 67 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 73 g>tls::status</s
2fd0: 74 72 6f 6e 67 3e 0a 20 20 20 20 3c 65 6d 3e 3f trong>. <em>?
2fe0: 2d 6c 6f 63 61 6c 3f 20 63 68 61 6e 6e 65 6c 3c -local? channel<
2ff0: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
3000: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
3010: 65 20 63 75 72 72 65 6e 74 20 73 74 61 74 75 73 e current status
3020: 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 63 of the certific
3030: 61 74 65 20 66 6f 72 20 61 6e 20 53 53 4c 0a 09 ate for an SSL..
3040: 63 68 61 6e 6e 65 6c 2e 20 54 68 65 20 72 65 73 channel. The res
3050: 75 6c 74 20 69 73 20 61 20 6c 69 73 74 20 6f 66 ult is a list of
3060: 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 key-value pairs
3070: 20 64 65 73 63 72 69 62 69 6e 67 0a 09 74 68 65 describing..the
3080: 20 63 65 72 74 69 66 69 63 61 74 65 2e 20 49 66 certificate. If
3090: 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 the result is a
30a0: 6e 20 65 6d 70 74 79 20 6c 69 73 74 20 74 68 65 n empty list the
30b0: 6e 20 74 68 65 0a 09 53 53 4c 20 68 61 6e 64 73 n the..SSL hands
30c0: 68 61 6b 65 20 68 61 73 20 6e 6f 74 20 79 65 74 hake has not yet
30d0: 20 63 6f 6d 70 6c 65 74 65 64 2e 20 49 66 20 3c completed. If <
30e0: 65 6d 3e 2d 6c 6f 63 61 6c 3c 2f 65 6d 3e 20 69 em>-local</em> i
30f0: 73 0a 09 73 70 65 63 69 66 69 65 64 2c 20 74 68 s..specified, th
3100: 65 6e 20 74 68 65 20 6c 6f 63 61 6c 20 63 65 72 en the local cer
3110: 74 69 66 69 63 61 74 65 20 69 73 20 75 73 65 64 tificate is used
3120: 2e 3c 2f 64 64 3e 0a 3c 62 6c 6f 63 6b 71 75 6f .</dd>.<blockquo
3130: 74 65 3e 0a 09 3c 62 3e 53 53 4c 20 53 74 61 74 te>..<b>SSL Stat
3140: 75 73 3c 2f 62 3e 0a 20 20 20 20 3c 64 6c 3e 0a us</b>. <dl>.
3150: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 61 6c 70 .<dt><strong>alp
3160: 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 70 n</strong> <em>p
3170: 72 6f 74 6f 63 6f 6c 3c 2f 65 6d 3e 3c 2f 64 74 rotocol</em></dt
3180: 3e 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 6f >..<dd>The proto
3190: 63 6f 6c 20 73 65 6c 65 63 74 65 64 20 61 66 74 col selected aft
31a0: 65 72 20 41 70 70 6c 69 63 61 74 69 6f 6e 2d 4c er Application-L
31b0: 61 79 65 72 20 50 72 6f 74 6f 63 6f 6c 0a 09 20 ayer Protocol..
31c0: 20 20 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 28 Negotiation (
31d0: 41 4c 50 4e 29 2e 3c 2f 64 64 3e 0a 09 3c 64 74 ALPN).</dd>..<dt
31e0: 3e 3c 73 74 72 6f 6e 67 3e 63 69 70 68 65 72 3c ><strong>cipher<
31f0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 69 70 /strong> <em>cip
3200: 68 65 72 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c her</em></dt>..<
3210: 64 64 3e 54 68 65 20 63 75 72 72 65 6e 74 20 63 dd>The current c
3220: 69 70 68 65 72 20 69 6e 20 75 73 65 20 62 65 74 ipher in use bet
3230: 77 65 65 6e 20 74 68 65 20 63 6c 69 65 6e 74 20 ween the client
3240: 61 6e 64 0a 09 20 20 20 20 73 65 72 76 65 72 20 and.. server
3250: 63 68 61 6e 6e 65 6c 73 2e 3c 2f 64 64 3e 0a 09 channels.</dd>..
3260: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 65 65 72 <dt><strong>peer
3270: 6e 61 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 name</strong> <e
3280: 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e m>name</em></dt>
3290: 0a 09 3c 64 64 3e 54 68 65 20 70 65 65 72 6e 61 ..<dd>The peerna
32a0: 6d 65 20 66 72 6f 6d 20 74 68 65 20 63 65 72 74 me from the cert
32b0: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c ificate.</dd>..<
32c0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 72 6f 74 6f dt><strong>proto
32d0: 63 6f 6c 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d col</strong> <em
32e0: 3e 76 65 72 73 69 6f 6e 3c 2f 65 6d 3e 3c 2f 64 >version</em></d
32f0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 t>..<dd>The prot
3300: 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 ocol version use
3310: 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 d for the connec
3320: 74 69 6f 6e 3a 0a 09 20 20 20 20 53 53 4c 32 2c tion:.. SSL2,
3330: 20 53 53 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 SSL3, TLS1, TLS
3340: 31 2e 31 2c 20 54 4c 53 31 2e 32 2c 20 54 4c 53 1.1, TLS1.2, TLS
3350: 31 2e 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 2e 1.3, or unknown.
3360: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
3370: 6e 67 3e 73 62 69 74 73 3c 2f 73 74 72 6f 6e 67 ng>sbits</strong
3380: 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 > <em>n</em></dt
3390: 3e 0a 09 3c 64 64 3e 54 68 65 20 6e 75 6d 62 65 >..<dd>The numbe
33a0: 72 20 6f 66 20 62 69 74 73 20 75 73 65 64 20 66 r of bits used f
33b0: 6f 72 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6b or the session k
33c0: 65 79 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ey.</dd>..<dt><s
33d0: 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 72 65 48 trong>signatureH
33e0: 61 73 68 41 6c 67 6f 72 69 74 68 6d 3c 2f 73 74 ashAlgorithm</st
33f0: 72 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 rong> <em>algori
3400: 74 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c thm</em></dt>..<
3410: 64 64 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 dd>The signature
3420: 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 2e hash algorithm.
3430: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
3440: 6e 67 3e 73 69 67 6e 61 74 75 72 65 54 79 70 65 ng>signatureType
3450: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 74 79 </strong> <em>ty
3460: 70 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 pe</em></dt>..<d
3470: 64 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 20 d>The signature
3480: 74 79 70 65 20 76 61 6c 75 65 2e 3c 2f 64 64 3e type value.</dd>
3490: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 76 65 ..<dt><strong>ve
34a0: 72 69 66 79 44 65 70 74 68 3c 2f 73 74 72 6f 6e rifyDepth</stron
34b0: 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 g> <em>n</em></d
34c0: 74 3e 0a 09 3c 64 64 3e 4d 61 78 69 6d 75 6d 20 t>..<dd>Maximum
34d0: 64 65 70 74 68 20 66 6f 72 20 74 68 65 20 63 65 depth for the ce
34e0: 72 74 69 66 69 63 61 74 65 20 63 68 61 69 6e 20 rtificate chain
34f0: 76 65 72 69 66 69 63 61 74 69 6f 6e 2e 0a 09 20 verification...
3500: 20 20 20 44 65 66 61 75 6c 74 20 69 73 20 2d 31 Default is -1
3510: 2c 20 74 6f 20 63 68 65 63 6b 20 61 6c 6c 2e 3c , to check all.<
3520: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
3530: 67 3e 76 65 72 69 66 79 4d 6f 64 65 3c 2f 73 74 g>verifyMode</st
3540: 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f rong> <em>list</
3550: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 em></dt>..<dd>Li
3560: 73 74 20 6f 66 20 63 65 72 74 69 66 69 63 61 74 st of certificat
3570: 65 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 6d e verification m
3580: 6f 64 65 73 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e odes.</dd>..<dt>
3590: 3c 73 74 72 6f 6e 67 3e 76 65 72 69 66 79 52 65 <strong>verifyRe
35a0: 73 75 6c 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 sult</strong> <e
35b0: 6d 3e 72 65 73 75 6c 74 3c 2f 65 6d 3e 3c 2f 64 m>result</em></d
35c0: 74 3e 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 t>..<dd>Certific
35d0: 61 74 65 20 76 65 72 69 66 69 63 61 74 69 6f 6e ate verification
35e0: 20 72 65 73 75 6c 74 2e 3c 2f 64 64 3e 0a 09 3c result.</dd>..<
35f0: 64 74 3e 3c 73 74 72 6f 6e 67 3e 63 61 5f 6e 61 dt><strong>ca_na
3600: 6d 65 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d mes</strong> <em
3610: 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a >list</em></dt>.
3620: 09 3c 64 64 3e 4c 69 73 74 20 6f 66 20 74 68 65 .<dd>List of the
3630: 20 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 Certificate Aut
3640: 68 6f 72 69 74 69 65 73 20 75 73 65 64 20 74 6f horities used to
3650: 20 63 72 65 61 74 65 20 74 68 65 20 63 65 72 74 create the cert
3660: 69 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 20 20 ificate.</dd>.
3670: 20 20 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 </dl>.</blockq
3680: 75 6f 74 65 3e 0a 3c 62 6c 6f 63 6b 71 75 6f 74 uote>.<blockquot
3690: 65 3e 0a 09 3c 62 3e 43 65 72 74 69 66 69 63 61 e>..<b>Certifica
36a0: 74 65 20 53 74 61 74 75 73 3c 2f 62 3e 0a 20 20 te Status</b>.
36b0: 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 <dl>..<dt><str
36c0: 6f 6e 67 3e 61 6c 6c 3c 2f 73 74 72 6f 6e 67 3e ong>all</strong>
36d0: 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e <em>string</em>
36e0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 44 75 6d 70 20 </dt>..<dd>Dump
36f0: 6f 66 20 61 6c 6c 20 63 65 72 74 69 66 69 63 61 of all certifica
3700: 74 65 20 69 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 09 te info.</dd>...
3710: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 76 65 72 73 <dt><strong>vers
3720: 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ion</strong> <em
3730: 3e 76 61 6c 75 65 3c 2f 65 6d 3e 3c 2f 64 74 3e >value</em></dt>
3740: 0a 09 3c 64 64 3e 54 68 65 20 63 65 72 74 69 66 ..<dd>The certif
3750: 69 63 61 74 65 20 76 65 72 73 69 6f 6e 2e 3c 2f icate version.</
3760: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
3770: 3e 73 65 72 69 61 6c 4e 75 6d 62 65 72 3c 2f 73 >serialNumber</s
3780: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f 65 6d trong> <em>n</em
3790: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 ></dt>..<dd>The
37a0: 73 65 72 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 serial number of
37b0: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
37c0: 20 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c as hex string.<
37d0: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
37e0: 67 3e 73 69 67 6e 61 74 75 72 65 3c 2f 73 74 72 g>signature</str
37f0: 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 74 ong> <em>algorit
3800: 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 hm</em></dt>..<d
3810: 64 3e 43 69 70 68 65 72 20 61 6c 67 6f 72 69 74 d>Cipher algorit
3820: 68 6d 20 75 73 65 64 20 66 6f 72 20 63 65 72 74 hm used for cert
3830: 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 ificate signatur
3840: 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 e.</dd>..<dt><st
3850: 72 6f 6e 67 3e 69 73 73 75 65 72 3c 2f 73 74 72 rong>issuer</str
3860: 6f 6e 67 3e 20 3c 65 6d 3e 64 6e 3c 2f 65 6d 3e ong> <em>dn</em>
3870: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 64 </dt>..<dd>The d
3880: 69 73 74 69 6e 67 75 69 73 68 65 64 20 6e 61 6d istinguished nam
3890: 65 20 28 44 4e 29 20 6f 66 20 74 68 65 20 63 65 e (DN) of the ce
38a0: 72 74 69 66 69 63 61 74 65 20 69 73 73 75 65 72 rtificate issuer
38b0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
38c0: 6f 6e 67 3e 6e 6f 74 42 65 66 6f 72 65 3c 2f 73 ong>notBefore</s
38d0: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 65 3c trong> <em>date<
38e0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
38f0: 68 65 20 62 65 67 69 6e 20 64 61 74 65 20 66 6f he begin date fo
3900: 72 20 74 68 65 20 76 61 6c 69 64 69 74 79 20 6f r the validity o
3910: 66 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 f the certificat
3920: 65 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 e.</dd>..<dt><st
3930: 72 6f 6e 67 3e 6e 6f 74 41 66 74 65 72 3c 2f 73 rong>notAfter</s
3940: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 65 3c trong> <em>date<
3950: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
3960: 68 65 20 65 78 70 69 72 61 74 69 6f 6e 20 64 61 he expiration da
3970: 74 65 20 66 6f 72 20 74 68 65 20 63 65 72 74 69 te for the certi
3980: 66 69 63 61 74 65 2e 3c 2f 64 64 3e 0a 09 3c 64 ficate.</dd>..<d
3990: 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 6a 65 63 t><strong>subjec
39a0: 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 t</strong> <em>d
39b0: 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 n</em></dt>..<dd
39c0: 3e 54 68 65 20 64 69 73 74 69 6e 67 75 69 73 68 >The distinguish
39d0: 65 64 20 6e 61 6d 65 20 28 44 4e 29 20 6f 66 20 ed name (DN) of
39e0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
39f0: 73 75 62 6a 65 63 74 2e 0a 09 20 20 20 20 46 69 subject... Fi
3a00: 65 6c 64 73 20 69 6e 63 6c 75 64 65 3a 20 43 6f elds include: Co
3a10: 6d 6d 6f 6e 20 4e 61 6d 65 20 28 43 4e 29 2c 20 mmon Name (CN),
3a20: 4f 72 67 61 6e 69 7a 61 74 69 6f 6e 20 28 4f 29 Organization (O)
3a30: 2c 20 4c 6f 63 61 6c 69 74 79 0a 09 20 20 20 20 , Locality..
3a40: 6f 72 20 43 69 74 79 20 28 4c 29 2c 20 53 74 61 or City (L), Sta
3a50: 74 65 20 6f 72 20 50 72 6f 76 69 6e 63 65 20 28 te or Province (
3a60: 53 29 2c 20 61 6e 64 20 43 6f 75 6e 74 72 79 20 S), and Country
3a70: 4e 61 6d 65 20 28 43 29 2e 3c 2f 64 64 3e 0a 09 Name (C).</dd>..
3a80: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 73 73 75 <dt><strong>issu
3a90: 65 72 55 6e 69 71 75 65 49 44 3c 2f 73 74 72 6f erUniqueID</stro
3aa0: 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f ng> <em>string</
3ab0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
3ac0: 65 20 69 73 73 75 65 72 20 75 6e 69 71 75 65 20 e issuer unique
3ad0: 69 64 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 id.</dd>..<dt><s
3ae0: 74 72 6f 6e 67 3e 73 75 62 6a 65 63 74 55 6e 69 trong>subjectUni
3af0: 71 75 65 49 44 3c 2f 73 74 72 6f 6e 67 3e 20 3c queID</strong> <
3b00: 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f em>string</em></
3b10: 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 73 75 62 dt>..<dd>The sub
3b20: 6a 65 63 74 20 75 6e 69 71 75 65 20 69 64 2e 3c ject unique id.<
3b30: 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f /dd>...<dt><stro
3b40: 6e 67 3e 6e 75 6d 5f 65 78 74 65 6e 73 69 6f 6e ng>num_extension
3b50: 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e s</strong> <em>n
3b60: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
3b70: 4e 75 6d 62 65 72 20 6f 66 20 63 65 72 74 69 66 Number of certif
3b80: 69 63 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 73 icate extensions
3b90: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3ba0: 6f 6e 67 3e 65 78 74 65 6e 73 69 6f 6e 73 3c 2f ong>extensions</
3bb0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 strong> <em>list
3bc0: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
3bd0: 4c 69 73 74 20 6f 66 20 63 65 72 74 69 66 69 63 List of certific
3be0: 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6e 61 ate extension na
3bf0: 6d 65 73 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c mes.</dd>..<dt><
3c00: 73 74 72 6f 6e 67 3e 61 75 74 68 6f 72 69 74 79 strong>authority
3c10: 4b 65 79 49 64 65 6e 74 69 66 69 65 72 3c 2f 73 KeyIdentifier</s
3c20: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
3c30: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
3c40: 3e 28 41 4b 49 29 20 4b 65 79 20 69 64 65 6e 74 >(AKI) Key ident
3c50: 69 66 69 65 72 20 6f 66 20 74 68 65 20 49 73 73 ifier of the Iss
3c60: 75 69 6e 67 20 43 41 20 63 65 72 74 69 66 69 63 uing CA certific
3c70: 61 74 65 20 74 68 61 74 20 73 69 67 6e 65 64 0a ate that signed.
3c80: 09 20 20 20 20 74 68 65 20 53 53 4c 20 63 65 72 . the SSL cer
3c90: 74 69 66 69 63 61 74 65 20 61 73 20 68 65 78 20 tificate as hex
3ca0: 73 74 72 69 6e 67 2e 20 54 68 69 73 20 76 61 6c string. This val
3cb0: 75 65 20 6d 61 74 63 68 65 73 20 74 68 65 20 53 ue matches the S
3cc0: 4b 49 0a 09 20 20 20 20 76 61 6c 75 65 20 6f 66 KI.. value of
3cd0: 20 74 68 65 20 49 6e 74 65 72 6d 65 64 69 61 74 the Intermediat
3ce0: 65 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 e CA certificate
3cf0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3d00: 6f 6e 67 3e 73 75 62 6a 65 63 74 4b 65 79 49 64 ong>subjectKeyId
3d10: 65 6e 74 69 66 69 65 72 3c 2f 73 74 72 6f 6e 67 entifier</strong
3d20: 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d > <em>string</em
3d30: 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 28 53 4b 49 ></dt>..<dd>(SKI
3d40: 29 20 48 61 73 68 20 6f 66 20 74 68 65 20 70 75 ) Hash of the pu
3d50: 62 6c 69 63 20 6b 65 79 20 69 6e 73 69 64 65 20 blic key inside
3d60: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
3d70: 61 73 20 68 65 78 0a 09 20 20 20 73 74 72 69 6e as hex.. strin
3d80: 67 2e 20 55 73 65 64 20 74 6f 20 69 64 65 6e 74 g. Used to ident
3d90: 69 66 79 20 63 65 72 74 69 66 69 63 61 74 65 73 ify certificates
3da0: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 20 61 20 that contain a
3db0: 70 61 72 74 69 63 75 6c 61 72 0a 09 20 20 20 70 particular.. p
3dc0: 75 62 6c 69 63 20 6b 65 79 2e 3c 2f 64 64 3e 0a ublic key.</dd>.
3dd0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 75 62 .<dt><strong>sub
3de0: 6a 65 63 74 41 6c 74 4e 61 6d 65 3c 2f 73 74 72 jectAltName</str
3df0: 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f 65 ong> <em>list</e
3e00: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 m></dt>..<dd>Lis
3e10: 74 20 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 20 t of all of the
3e20: 61 6c 74 65 72 6e 61 74 69 76 65 20 64 6f 6d 61 alternative doma
3e30: 69 6e 20 6e 61 6d 65 73 2c 20 73 75 62 20 64 6f in names, sub do
3e40: 6d 61 69 6e 73 2c 0a 09 20 20 20 20 61 6e 64 20 mains,.. and
3e50: 49 50 20 61 64 64 72 65 73 73 65 73 20 74 68 61 IP addresses tha
3e60: 74 20 61 72 65 20 73 65 63 75 72 65 64 20 62 79 t are secured by
3e70: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
3e80: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
3e90: 6f 6e 67 3e 6f 63 73 70 3c 2f 73 74 72 6f 6e 67 ong>ocsp</strong
3ea0: 3e 20 3c 65 6d 3e 6c 69 73 74 3c 2f 65 6d 3e 3c > <em>list</em><
3eb0: 2f 64 74 3e 0a 09 3c 64 64 3e 4c 69 73 74 20 6f /dt>..<dd>List o
3ec0: 66 20 61 6c 6c 20 4f 6e 6c 69 6e 65 20 43 65 72 f all Online Cer
3ed0: 74 69 66 69 63 61 74 65 20 53 74 61 74 75 73 20 tificate Status
3ee0: 50 72 6f 74 6f 63 6f 6c 20 28 4f 43 53 50 29 20 Protocol (OCSP)
3ef0: 55 52 4c 73 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 74 URLs.</dd>...<dt
3f00: 3e 3c 73 74 72 6f 6e 67 3e 63 65 72 74 69 66 69 ><strong>certifi
3f10: 63 61 74 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 cate</strong> <e
3f20: 6d 3e 63 65 72 74 3c 2f 65 6d 3e 3c 2f 64 74 3e m>cert</em></dt>
3f30: 0a 09 3c 64 64 3e 54 68 65 20 50 45 4d 20 65 6e ..<dd>The PEM en
3f40: 63 6f 64 65 64 20 63 65 72 74 69 66 69 63 61 74 coded certificat
3f50: 65 2e 3c 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 e.</dd>...<dt><s
3f60: 74 72 6f 6e 67 3e 73 69 67 6e 61 74 75 72 65 41 trong>signatureA
3f70: 6c 67 6f 72 69 74 68 6d 3c 2f 73 74 72 6f 6e 67 lgorithm</strong
3f80: 3e 20 3c 65 6d 3e 61 6c 67 6f 72 69 74 68 6d 3c > <em>algorithm<
3f90: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 /em></dt>..<dd>C
3fa0: 69 70 68 65 72 20 61 6c 67 6f 72 69 74 68 6d 20 ipher algorithm
3fb0: 75 73 65 64 20 66 6f 72 20 63 65 72 74 69 66 69 used for certifi
3fc0: 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 2e 3c cate signature.<
3fd0: 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e /dd>..<dt><stron
3fe0: 67 3e 73 69 67 6e 61 74 75 72 65 56 61 6c 75 65 g>signatureValue
3ff0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 </strong> <em>st
4000: 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 ring</em></dt>..
4010: 3c 64 64 3e 43 65 72 74 69 66 69 63 61 74 65 20 <dd>Certificate
4020: 73 69 67 6e 61 74 75 72 65 20 61 73 20 68 65 78 signature as hex
4030: 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 09 3c string.</dd>..<
4040: 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 69 67 6e 61 dt><strong>signa
4050: 74 75 72 65 44 69 67 65 73 74 3c 2f 73 74 72 6f tureDigest</stro
4060: 6e 67 3e 20 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c ng> <em>version<
4070: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 /em></dt>..<dd>C
4080: 65 72 74 69 66 69 63 61 74 65 20 73 69 67 6e 69 ertificate signi
4090: 6e 67 20 64 69 67 65 73 74 2e 3c 2f 64 64 3e 0a ng digest.</dd>.
40a0: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 70 75 62 .<dt><strong>pub
40b0: 6c 69 63 4b 65 79 41 6c 67 6f 72 69 74 68 6d 3c licKeyAlgorithm<
40c0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 61 6c 67 /strong> <em>alg
40d0: 6f 72 69 74 68 6d 3c 2f 65 6d 3e 3c 2f 64 74 3e orithm</em></dt>
40e0: 0a 09 3c 64 64 3e 43 65 72 74 69 66 69 63 61 74 ..<dd>Certificat
40f0: 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 62 6c e signature publ
4100: 69 63 20 6b 65 79 20 61 6c 67 6f 72 69 74 68 6d ic key algorithm
4110: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4120: 6f 6e 67 3e 70 75 62 6c 69 63 4b 65 79 3c 2f 73 ong>publicKey</s
4130: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
4140: 67 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 g</em></dt>..<dd
4150: 3e 43 65 72 74 69 66 69 63 61 74 65 20 73 69 67 >Certificate sig
4160: 6e 61 74 75 72 65 20 70 75 62 6c 69 63 20 6b 65 nature public ke
4170: 79 20 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e y as hex string.
4180: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
4190: 6e 67 3e 62 69 74 73 3c 2f 73 74 72 6f 6e 67 3e ng>bits</strong>
41a0: 20 3c 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e <em>n</em></dt>
41b0: 0a 09 3c 64 64 3e 4e 75 6d 62 65 72 20 6f 66 20 ..<dd>Number of
41c0: 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 63 65 bits used for ce
41d0: 72 74 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 rtificate signat
41e0: 75 72 65 20 6b 65 79 3c 2f 64 64 3e 0a 09 3c 64 ure key</dd>..<d
41f0: 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 6c 66 5f 73 t><strong>self_s
4200: 69 67 6e 65 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c igned</strong> <
4210: 65 6d 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c em>boolean</em><
4220: 2f 64 74 3e 0a 09 3c 64 64 3e 49 73 20 63 65 72 /dt>..<dd>Is cer
4230: 74 69 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 tificate signatu
4240: 72 65 20 73 65 6c 66 20 73 69 67 6e 65 64 2e 3c re self signed.<
4250: 2f 64 64 3e 0a 0a 09 3c 64 74 3e 3c 73 74 72 6f /dd>...<dt><stro
4260: 6e 67 3e 73 68 61 31 5f 68 61 73 68 3c 2f 73 74 ng>sha1_hash</st
4270: 72 6f 6e 67 3e 20 3c 65 6d 3e 68 61 73 68 3c 2f rong> <em>hash</
4280: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
4290: 65 20 53 48 41 31 20 68 61 73 68 20 6f 66 20 74 e SHA1 hash of t
42a0: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 he certificate a
42b0: 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 s hex string.</d
42c0: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
42d0: 73 68 61 32 35 36 5f 68 61 73 68 3c 2f 73 74 72 sha256_hash</str
42e0: 6f 6e 67 3e 20 3c 65 6d 3e 68 61 73 68 3c 2f 65 ong> <em>hash</e
42f0: 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 m></dt>..<dd>The
4300: 20 53 48 41 32 35 36 20 68 61 73 68 20 6f 66 20 SHA256 hash of
4310: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
4320: 61 73 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f as hex string.</
4330: 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a 3c 2f dd>. </dl>.</
4340: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 20 blockquote>..
4350: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
4360: 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 22 3e 3c s::connection"><
4370: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 6f 6e 6e strong>tls::conn
4380: 65 63 74 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 0a ection</strong>.
4390: 20 20 20 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 3c <em>channel<
43a0: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
43b0: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
43c0: 65 20 63 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63 e current connec
43d0: 74 69 6f 6e 20 73 74 61 74 75 73 20 6f 66 20 61 tion status of a
43e0: 6e 20 53 53 4c 20 63 68 61 6e 6e 65 6c 2e 20 54 n SSL channel. T
43f0: 68 65 0a 09 72 65 73 75 6c 74 20 69 73 20 61 20 he..result is a
4400: 6c 69 73 74 20 6f 66 20 6b 65 79 2d 76 61 6c 75 list of key-valu
4410: 65 20 70 61 69 72 73 20 64 65 73 63 72 69 62 69 e pairs describi
4420: 6e 67 20 74 68 65 0a 09 63 6f 6e 6e 65 63 74 65 ng the..connecte
4430: 64 20 70 65 65 72 2e 3c 2f 64 64 3e 0a 3c 62 6c d peer.</dd>.<bl
4440: 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e 53 53 ockquote>..<b>SS
4450: 4c 20 53 74 61 74 75 73 3c 2f 62 3e 0a 20 20 20 L Status</b>.
4460: 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f <dl>..<dt><stro
4470: 6e 67 3e 73 74 61 74 65 3c 2f 73 74 72 6f 6e 67 ng>state</strong
4480: 3e 20 3c 65 6d 3e 73 74 61 74 65 3c 2f 65 6d 3e > <em>state</em>
4490: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 53 74 61 74 65 </dt>..<dd>State
44a0: 20 6f 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 of the connecti
44b0: 6f 6e 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 on.</dd>..<dt><s
44c0: 74 72 6f 6e 67 3e 73 65 72 76 65 72 6e 61 6d 65 trong>servername
44d0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 </strong> <em>na
44e0: 6d 65 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 me</em></dt>..<d
44f0: 64 3e 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 d>The name of th
4500: 65 20 63 6f 6e 6e 65 63 74 65 64 20 74 6f 20 73 e connected to s
4510: 65 72 76 65 72 2e 3c 2f 64 64 3e 0a 09 3c 64 74 erver.</dd>..<dt
4520: 3e 3c 73 74 72 6f 6e 67 3e 70 72 6f 74 6f 63 6f ><strong>protoco
4530: 6c 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 76 l</strong> <em>v
4540: 65 72 73 69 6f 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e ersion</em></dt>
4550: 0a 09 3c 64 64 3e 54 68 65 20 70 72 6f 74 6f 63 ..<dd>The protoc
4560: 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 ol version used
4570: 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 for the connecti
4580: 6f 6e 3a 0a 09 20 20 20 20 53 53 4c 32 2c 20 53 on:.. SSL2, S
4590: 53 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 31 2e SL3, TLS1, TLS1.
45a0: 31 2c 20 54 4c 53 31 2e 32 2c 20 54 4c 53 31 2e 1, TLS1.2, TLS1.
45b0: 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 2e 3c 2f 3, or unknown.</
45c0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
45d0: 3e 72 65 6e 65 67 6f 74 69 61 74 69 6f 6e 3c 2f >renegotiation</
45e0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c strong> <em>bool
45f0: 65 61 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c ean</em></dt>..<
4600: 64 64 3e 57 68 65 74 68 65 72 20 70 72 6f 74 6f dd>Whether proto
4610: 63 6f 6c 20 72 65 6e 65 67 6f 74 69 61 74 69 6f col renegotiatio
4620: 6e 20 69 73 20 73 75 70 70 6f 72 74 65 64 20 6f n is supported o
4630: 72 20 6e 6f 74 2e 3c 2f 64 64 3e 0a 09 3c 64 74 r not.</dd>..<dt
4640: 3e 3c 73 74 72 6f 6e 67 3e 73 65 63 75 72 69 74 ><strong>securit
4650: 79 6c 65 76 65 6c 3c 2f 73 74 72 6f 6e 67 3e 20 ylevel</strong>
4660: 3c 65 6d 3e 6c 65 76 65 6c 3c 2f 65 6d 3e 3c 2f <em>level</em></
4670: 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 73 65 63 dt>..<dd>The sec
4680: 75 72 69 74 79 20 6c 65 76 65 6c 20 75 73 65 64 urity level used
4690: 20 66 6f 72 20 73 65 6c 65 63 74 69 6f 6e 20 6f for selection o
46a0: 66 20 63 69 70 68 65 72 73 2c 20 6b 65 79 20 73 f ciphers, key s
46b0: 69 7a 65 2c 20 65 74 63 2e 3c 2f 64 64 3e 0a 09 ize, etc.</dd>..
46c0: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 73 73 <dt><strong>sess
46d0: 69 6f 6e 5f 72 65 75 73 65 64 3c 2f 73 74 72 6f ion_reused</stro
46e0: 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 61 6e 3c ng> <em>boolean<
46f0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 57 /em></dt>..<dd>W
4700: 68 65 74 68 65 72 20 74 68 65 20 73 65 73 73 69 hether the sessi
4710: 6f 6e 20 68 61 73 20 62 65 65 6e 20 72 65 75 73 on has been reus
4720: 65 64 20 6f 72 20 6e 6f 74 2e 3c 2f 64 64 3e 0a ed or not.</dd>.
4730: 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 69 73 5f .<dt><strong>is_
4740: 73 65 72 76 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 server</strong>
4750: 3c 65 6d 3e 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e <em>boolean</em>
4760: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 57 68 65 74 68 </dt>..<dd>Wheth
4770: 65 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f er the connectio
4780: 6e 20 69 73 20 63 6f 6e 66 69 67 75 72 65 64 20 n is configured
4790: 61 73 20 61 20 73 65 72 76 65 72 20 28 31 29 20 as a server (1)
47a0: 6f 72 20 63 6c 69 65 6e 74 20 28 30 29 2e 3c 2f or client (0).</
47b0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
47c0: 3e 63 6f 6d 70 72 65 73 73 69 6f 6e 3c 2f 73 74 >compression</st
47d0: 72 6f 6e 67 3e 20 3c 65 6d 3e 6d 6f 64 65 3c 2f rong> <em>mode</
47e0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 43 6f em></dt>..<dd>Co
47f0: 6d 70 72 65 73 73 69 6f 6e 20 6d 65 74 68 6f 64 mpression method
4800: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4810: 6f 6e 67 3e 65 78 70 61 6e 73 69 6f 6e 3c 2f 73 ong>expansion</s
4820: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6d 6f 64 65 3c trong> <em>mode<
4830: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 45 /em></dt>..<dd>E
4840: 78 70 61 6e 73 69 6f 6e 20 6d 65 74 68 6f 64 2e xpansion method.
4850: 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e 0a </dd>. </dl>.
4860: 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 62 </blockquote>.<b
4870: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e 43 lockquote>..<b>C
4880: 69 70 68 65 72 20 49 6e 66 6f 3c 2f 62 3e 0a 20 ipher Info</b>.
4890: 20 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c 73 74 <dl>..<dt><st
48a0: 72 6f 6e 67 3e 63 69 70 68 65 72 3c 2f 73 74 72 rong>cipher</str
48b0: 6f 6e 67 3e 20 3c 65 6d 3e 63 69 70 68 65 72 3c ong> <em>cipher<
48c0: 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 /em></dt>..<dd>T
48d0: 68 65 20 63 75 72 72 65 6e 74 20 63 69 70 68 65 he current ciphe
48e0: 72 20 69 6e 20 75 73 65 20 66 6f 72 20 74 68 65 r in use for the
48f0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 3c 2f 64 64 connection.</dd
4900: 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 >..<dt><strong>s
4910: 74 61 6e 64 61 72 64 5f 6e 61 6d 65 3c 2f 73 74 tandard_name</st
4920: 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f rong> <em>name</
4930: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
4940: 65 20 73 74 61 6e 64 61 72 64 20 52 46 43 20 6e e standard RFC n
4950: 61 6d 65 20 6f 66 20 63 69 70 68 65 72 2e 3c 2f ame of cipher.</
4960: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
4970: 3e 62 69 74 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c >bits</strong> <
4980: 65 6d 3e 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 em>n</em></dt>..
4990: 3c 64 64 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f <dd>The number o
49a0: 66 20 70 72 6f 63 65 73 73 65 64 20 62 69 74 73 f processed bits
49b0: 20 75 73 65 64 20 66 6f 72 20 63 69 70 68 65 72 used for cipher
49c0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
49d0: 6f 6e 67 3e 73 65 63 72 65 74 5f 62 69 74 73 3c ong>secret_bits<
49e0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 3c 2f /strong> <em>n</
49f0: 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 em></dt>..<dd>Th
4a00: 65 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 63 72 e number of secr
4a10: 65 74 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 et bits used for
4a20: 20 63 69 70 68 65 72 2e 3c 2f 64 64 3e 0a 09 3c cipher.</dd>..<
4a30: 64 74 3e 3c 73 74 72 6f 6e 67 3e 6d 69 6e 5f 76 dt><strong>min_v
4a40: 65 72 73 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 20 ersion</strong>
4a50: 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c 2f 65 6d 3e <em>version</em>
4a60: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 54 68 65 20 6d </dt>..<dd>The m
4a70: 69 6e 69 6d 75 6d 20 70 72 6f 74 6f 63 6f 6c 20 inimum protocol
4a80: 76 65 72 73 69 6f 6e 20 66 6f 72 20 63 69 70 68 version for ciph
4a90: 65 72 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 er.</dd>..<dt><s
4aa0: 74 72 6f 6e 67 3e 69 64 3c 2f 73 74 72 6f 6e 67 trong>id</strong
4ab0: 3e 20 3c 65 6d 3e 69 64 3c 2f 65 6d 3e 3c 2f 64 > <em>id</em></d
4ac0: 74 3e 0a 09 3c 64 64 3e 54 68 65 20 4f 70 65 6e t>..<dd>The Open
4ad0: 53 53 4c 20 63 69 70 68 65 72 20 69 64 2e 3c 2f SSL cipher id.</
4ae0: 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 dd>..<dt><strong
4af0: 3e 64 65 73 63 72 69 70 74 69 6f 6e 3c 2f 73 74 >description</st
4b00: 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 rong> <em>string
4b10: 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 3e </em></dt>..<dd>
4b20: 41 20 74 65 78 74 20 64 65 73 63 72 69 70 74 69 A text descripti
4b30: 6f 6e 20 6f 66 20 74 68 65 20 63 69 70 68 65 72 on of the cipher
4b40: 2e 3c 2f 64 64 3e 0a 20 20 20 20 3c 2f 64 6c 3e .</dd>. </dl>
4b50: 0a 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c .</blockquote>.<
4b60: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 09 3c 62 3e blockquote>..<b>
4b70: 53 65 73 73 69 6f 6e 20 49 6e 66 6f 3c 2f 62 3e Session Info</b>
4b80: 0a 20 20 20 20 3c 64 6c 3e 0a 09 3c 64 74 3e 3c . <dl>..<dt><
4b90: 73 74 72 6f 6e 67 3e 61 6c 70 6e 3c 2f 73 74 72 strong>alpn</str
4ba0: 6f 6e 67 3e 20 3c 65 6d 3e 70 72 6f 74 6f 63 6f ong> <em>protoco
4bb0: 6c 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 l</em></dt>..<dd
4bc0: 3e 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 73 65 >The protocol se
4bd0: 6c 65 63 74 65 64 20 61 66 74 65 72 20 41 70 70 lected after App
4be0: 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 20 50 lication-Layer P
4bf0: 72 6f 74 6f 63 6f 6c 0a 09 20 20 20 20 4e 65 67 rotocol.. Neg
4c00: 6f 74 69 61 74 69 6f 6e 20 28 41 4c 50 4e 29 2e otiation (ALPN).
4c10: 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f </dd>..<dt><stro
4c20: 6e 67 3e 72 65 73 75 6d 61 62 6c 65 3c 2f 73 74 ng>resumable</st
4c30: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f 6f 6c 65 61 rong> <em>boolea
4c40: 6e 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 09 3c 64 64 n</em></dt>..<dd
4c50: 3e 43 61 6e 20 74 68 65 20 73 65 73 73 69 6f 6e >Can the session
4c60: 20 62 65 20 72 65 73 75 6d 65 64 20 6f 72 20 6e be resumed or n
4c70: 6f 74 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ot.</dd>..<dt><s
4c80: 74 72 6f 6e 67 3e 73 74 61 72 74 5f 74 69 6d 65 trong>start_time
4c90: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 65 </strong> <em>se
4ca0: 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a conds</em></dt>.
4cb0: 09 3c 64 64 3e 54 69 6d 65 20 73 69 6e 63 65 20 .<dd>Time since
4cc0: 73 65 73 73 69 6f 6e 20 73 74 61 72 74 65 64 20 session started
4cd0: 69 6e 20 73 65 63 6f 6e 64 73 20 73 69 6e 63 65 in seconds since
4ce0: 20 65 70 6f 63 68 2e 3c 2f 64 64 3e 0a 09 3c 64 epoch.</dd>..<d
4cf0: 74 3e 3c 73 74 72 6f 6e 67 3e 74 69 6d 65 6f 75 t><strong>timeou
4d00: 74 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 t</strong> <em>s
4d10: 65 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f 64 74 3e econds</em></dt>
4d20: 0a 09 3c 64 64 3e 4d 61 78 20 64 75 72 61 74 69 ..<dd>Max durati
4d30: 6f 6e 20 6f 66 20 73 65 73 73 69 6f 6e 20 69 6e on of session in
4d40: 20 73 65 63 6f 6e 64 73 20 62 65 66 6f 72 65 20 seconds before
4d50: 74 69 6d 65 2d 6f 75 74 2e 3c 2f 64 64 3e 0a 09 time-out.</dd>..
4d60: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 6c 69 66 65 <dt><strong>life
4d70: 74 69 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 time</strong> <e
4d80: 6d 3e 73 65 63 6f 6e 64 73 3c 2f 65 6d 3e 3c 2f m>seconds</em></
4d90: 64 74 3e 0a 09 3c 64 64 3e 53 65 73 73 69 6f 6e dt>..<dd>Session
4da0: 20 74 69 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 ticket lifetime
4db0: 20 68 69 6e 74 20 69 6e 20 73 65 63 6f 6e 64 73 hint in seconds
4dc0: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4dd0: 6f 6e 67 3e 73 65 73 73 69 6f 6e 5f 69 64 3c 2f ong>session_id</
4de0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 strong> <em>bina
4df0: 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f ry_string</em></
4e00: 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 dt>..<dd>Unique
4e10: 73 65 73 73 69 6f 6e 20 69 64 20 66 6f 72 20 75 session id for u
4e20: 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 20 74 se in resuming t
4e30: 68 65 20 73 65 73 73 69 6f 6e 2e 3c 2f 64 64 3e he session.</dd>
4e40: 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 73 65 ..<dt><strong>se
4e50: 73 73 69 6f 6e 5f 74 69 63 6b 65 74 3c 2f 73 74 ssion_ticket</st
4e60: 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 72 79 rong> <em>binary
4e70: 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 64 74 _string</em></dt
4e80: 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 73 65 >..<dd>Unique se
4e90: 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 66 6f 72 ssion ticket for
4ea0: 20 75 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 use in resuming
4eb0: 20 74 68 65 20 73 65 73 73 69 6f 6e 2e 3c 2f 64 the session.</d
4ec0: 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e d>..<dt><strong>
4ed0: 74 69 63 6b 65 74 5f 61 70 70 5f 64 61 74 61 3c ticket_app_data<
4ee0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e /strong> <em>bin
4ef0: 61 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c ary_string</em><
4f00: 2f 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 /dt>..<dd>Unique
4f10: 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 session ticket
4f20: 61 70 70 6c 69 63 61 74 69 6f 6e 20 64 61 74 61 application data
4f30: 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 74 72 .</dd>..<dt><str
4f40: 6f 6e 67 3e 6d 61 73 74 65 72 5f 6b 65 79 3c 2f ong>master_key</
4f50: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 69 6e 61 strong> <em>bina
4f60: 72 79 5f 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f ry_string</em></
4f70: 64 74 3e 0a 09 3c 64 64 3e 55 6e 69 71 75 65 20 dt>..<dd>Unique
4f80: 73 65 73 73 69 6f 6e 20 6d 61 73 74 65 72 20 6b session master k
4f90: 65 79 2e 3c 2f 64 64 3e 0a 09 3c 64 74 3e 3c 73 ey.</dd>..<dt><s
4fa0: 74 72 6f 6e 67 3e 73 65 73 73 69 6f 6e 5f 63 61 trong>session_ca
4fb0: 63 68 65 5f 6d 6f 64 65 3c 2f 73 74 72 6f 6e 67 che_mode</strong
4fc0: 3e 20 3c 65 6d 3e 6d 6f 64 65 3c 2f 65 6d 3e 3c > <em>mode</em><
4fd0: 2f 64 74 3e 0a 09 3c 64 64 3e 53 65 72 76 65 72 /dt>..<dd>Server
4fe0: 20 63 61 63 68 65 20 6d 6f 64 65 20 28 63 6c 69 cache mode (cli
4ff0: 65 6e 74 2c 20 73 65 72 76 65 72 2c 20 6f 72 20 ent, server, or
5000: 62 6f 74 68 29 2e 3c 2f 64 64 3e 0a 20 20 20 20 both).</dd>.
5010: 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f 63 6b 71 75 6f </dl>.</blockquo
5020: 74 65 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 te>.. <dt><a
5030: 6e 61 6d 65 3d 22 74 6c 73 3a 3a 63 69 70 68 65 name="tls::ciphe
5040: 72 73 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a rs"><strong>tls:
5050: 3a 63 69 70 68 65 72 73 3c 2f 73 74 72 6f 6e 67 :ciphers</strong
5060: 3e 0a 20 20 20 20 3c 65 6d 3e 3f 70 72 6f 74 6f >. <em>?proto
5070: 63 6f 6c 3f 20 3f 76 65 72 62 6f 73 65 3f 20 3f col? ?verbose? ?
5080: 73 75 70 70 6f 72 74 65 64 3f 3c 2f 65 6d 3e 3c supported?</em><
5090: 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 /a></dt>. <dd
50a0: 3e 57 69 74 68 6f 75 74 20 61 6e 79 20 61 72 67 >Without any arg
50b0: 73 2c 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 s, returns a lis
50c0: 74 20 6f 66 20 61 6c 6c 20 63 69 70 68 65 72 73 t of all ciphers
50d0: 2e 20 57 69 74 68 20 3c 65 6d 3e 70 72 6f 74 6f . With <em>proto
50e0: 63 6f 6c 3c 2f 65 6d 3e 2c 0a 09 6f 6e 6c 79 20 col</em>,..only
50f0: 74 68 65 20 63 69 70 68 65 72 73 20 73 75 70 70 the ciphers supp
5100: 6f 72 74 65 64 20 66 6f 72 20 74 68 61 74 20 70 orted for that p
5110: 72 6f 74 6f 63 6f 6c 20 61 72 65 20 72 65 74 75 rotocol are retu
5120: 72 6e 65 64 2e 20 53 65 65 0a 09 3c 62 3e 74 6c rned. See..<b>tl
5130: 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e s::protocols</b>
5140: 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 65 command for the
5150: 20 73 75 70 70 6f 72 74 65 64 20 70 72 6f 74 6f supported proto
5160: 63 6f 6c 73 2e 20 49 66 0a 09 3c 65 6d 3e 76 65 cols. If..<em>ve
5170: 72 62 6f 73 65 3c 2f 65 6d 3e 20 69 73 20 73 70 rbose</em> is sp
5180: 65 63 69 66 69 65 64 20 61 73 20 74 72 75 65 20 ecified as true
5190: 74 68 65 6e 20 61 20 76 65 72 62 6f 73 65 2c 20 then a verbose,
51a0: 68 75 6d 61 6e 20 72 65 61 64 61 62 6c 65 0a 09 human readable..
51b0: 6c 69 73 74 20 69 73 20 72 65 74 75 72 6e 65 64 list is returned
51c0: 20 77 69 74 68 20 61 64 64 69 74 69 6f 6e 61 6c with additional
51d0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 information on
51e0: 74 68 65 20 63 69 70 68 65 72 2e 20 49 66 0a 09 the cipher. If..
51f0: 3c 65 6d 3e 73 75 70 70 6f 72 74 65 64 3c 2f 65 <em>supported</e
5200: 6d 3e 20 69 73 20 73 70 65 63 69 66 69 65 64 20 m> is specified
5210: 61 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e as true, then on
5220: 6c 79 20 74 68 65 20 63 69 70 68 65 72 73 0a 09 ly the ciphers..
5230: 73 75 70 70 6f 72 74 65 64 20 66 6f 72 20 70 72 supported for pr
5240: 6f 74 6f 63 6f 6c 20 77 69 6c 6c 20 62 65 20 6c otocol will be l
5250: 69 73 74 65 64 2e 3c 2f 64 64 3e 0a 0a 20 20 20 isted.</dd>..
5260: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
5270: 73 3a 3a 64 69 67 65 73 74 73 22 3e 3c 73 74 72 s::digests"><str
5280: 6f 6e 67 3e 74 6c 73 3a 3a 64 69 67 65 73 74 73 ong>tls::digests
5290: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 3f 6e </strong> <em>?n
52a0: 61 6d 65 3f 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 ame?</em></a></d
52b0: 74 3e 0a 20 20 20 20 3c 64 64 3e 57 69 74 68 6f t>. <dd>Witho
52c0: 75 74 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e ut <em>name</em>
52d0: 2c 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 , returns a list
52e0: 20 6f 66 20 74 68 65 20 73 75 70 70 6f 72 74 65 of the supporte
52f0: 64 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d d hash algorithm
5300: 73 0a 09 66 6f 72 20 3c 62 3e 74 6c 73 3a 3a 64 s..for <b>tls::d
5310: 69 67 65 73 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e igest</b> comman
5320: 64 2e 20 57 69 74 68 20 3c 65 6d 3e 6e 61 6d 65 d. With <em>name
5330: 3c 2f 65 6d 3e 2c 20 72 65 74 75 72 6e 73 20 61 </em>, returns a
5340: 20 6c 69 73 74 20 6f 66 0a 09 70 72 6f 70 65 72 list of..proper
5350: 74 79 20 6e 61 6d 65 73 20 61 6e 64 20 76 61 6c ty names and val
5360: 75 65 73 20 64 65 73 63 72 69 62 69 6e 67 20 64 ues describing d
5370: 69 67 65 73 74 20 3c 69 3e 6e 61 6d 65 3c 2f 69 igest <i>name</i
5380: 3e 2e 20 50 72 6f 70 65 72 74 69 65 73 0a 09 69 >. Properties..i
5390: 6e 63 6c 75 64 65 20 6e 61 6d 65 2c 20 64 65 73 nclude name, des
53a0: 63 72 69 70 74 69 6f 6e 2c 20 73 69 7a 65 2c 20 cription, size,
53b0: 62 6c 6f 63 6b 5f 73 69 7a 65 2c 20 74 79 70 65 block_size, type
53c0: 2c 20 61 6e 64 20 66 6c 61 67 73 20 6c 69 73 74 , and flags list
53d0: 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e .</dd>.. <dt>
53e0: 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6d 61 <a name="tls::ma
53f0: 63 73 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a cs"><strong>tls:
5400: 3a 6d 61 63 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f :macs</strong></
5410: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
5420: 52 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f Returns a list o
5430: 66 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 f the available
5440: 4d 65 73 73 61 67 65 20 41 75 74 68 65 6e 74 69 Message Authenti
5450: 63 61 74 69 6f 6e 20 43 6f 64 65 73 20 28 4d 41 cation Codes (MA
5460: 43 29 20 66 6f 72 0a 09 74 68 65 20 3c 62 3e 74 C) for..the <b>t
5470: 6c 73 3a 3a 64 69 67 65 73 74 3c 2f 62 3e 20 63 ls::digest</b> c
5480: 6f 6d 6d 61 6e 64 2e 3c 2f 64 64 3e 0a 0a 20 20 ommand.</dd>..
5490: 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 <dt><a name="t
54a0: 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 22 3e 3c ls::protocols"><
54b0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 72 6f 74 strong>tls::prot
54c0: 6f 63 6f 6c 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f ocols</strong></
54d0: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
54e0: 52 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f Returns a list o
54f0: 66 20 73 75 70 70 6f 72 74 65 64 20 70 72 6f 74 f supported prot
5500: 6f 63 6f 6c 73 2e 20 56 61 6c 69 64 20 76 61 6c ocols. Valid val
5510: 75 65 73 20 61 72 65 3a 0a 09 3c 62 3e 73 73 6c ues are:..<b>ssl
5520: 32 3c 2f 62 3e 2c 20 3c 62 3e 73 73 6c 33 3c 2f 2</b>, <b>ssl3</
5530: 62 3e 2c 20 3c 62 3e 74 6c 73 31 3c 2f 62 3e 2c b>, <b>tls1</b>,
5540: 20 3c 62 3e 74 6c 73 31 2e 31 3c 2f 62 3e 2c 20 <b>tls1.1</b>,
5550: 3c 62 3e 74 6c 73 31 2e 32 3c 2f 62 3e 2c 0a 09 <b>tls1.2</b>,..
5560: 61 6e 64 20 3c 62 3e 74 6c 73 31 2e 33 3c 2f 62 and <b>tls1.3</b
5570: 3e 2e 20 45 78 61 63 74 20 6c 69 73 74 20 64 65 >. Exact list de
5580: 70 65 6e 64 73 20 6f 6e 20 4f 70 65 6e 53 53 4c pends on OpenSSL
5590: 20 76 65 72 73 69 6f 6e 20 61 6e 64 0a 09 63 6f version and..co
55a0: 6d 70 69 6c 65 20 74 69 6d 65 20 66 6c 61 67 73 mpile time flags
55b0: 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e .</dd>.. <dt>
55c0: 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 76 65 <a name="tls::ve
55d0: 72 73 69 6f 6e 22 3e 3c 73 74 72 6f 6e 67 3e 74 rsion"><strong>t
55e0: 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 73 74 72 ls::version</str
55f0: 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 ong></a></dt>.
5600: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
5610: 65 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 69 6f e OpenSSL versio
5620: 6e 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 0a n string.</dd>..
5630: 20 20 20 20 3c 62 72 3e 0a 20 20 20 20 3c 64 74 <br>. <dt
5640: 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 64 ><a name="tls::d
5650: 69 67 65 73 74 22 3e 3c 73 74 72 6f 6e 67 3e 74 igest"><strong>t
5660: 6c 73 3a 3a 64 69 67 65 73 74 3c 2f 73 74 72 6f ls::digest</stro
5670: 6e 67 3e 20 3c 62 3e 2d 64 69 67 65 73 74 3c 2f ng> <b>-digest</
5680: 62 3e 0a 09 3c 65 6d 3e 6e 61 6d 65 20 3f 2d 62 b>..<em>name ?-b
5690: 69 6e 7c 2d 68 65 78 3f 20 5b 2d 66 69 6c 65 20 in|-hex? [-file
56a0: 66 69 6c 65 6e 61 6d 65 20 7c 20 2d 63 6f 6d 6d filename | -comm
56b0: 61 6e 64 20 63 6d 64 4e 61 6d 65 20 7c 0a 09 2d and cmdName |..-
56c0: 63 68 61 6e 20 63 68 61 6e 6e 65 6c 49 64 20 7c chan channelId |
56d0: 20 2d 64 61 74 61 20 64 61 74 61 5d 3c 2f 65 6d -data data]</em
56e0: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
56f0: 64 64 3e 43 61 6c 63 75 6c 61 74 65 20 74 68 65 dd>Calculate the
5700: 20 6d 65 73 73 61 67 65 20 64 69 67 65 73 74 20 message digest
5710: 66 6f 72 20 64 61 74 61 20 75 73 69 6e 67 20 3c for data using <
5720: 65 6d 3e 64 69 67 65 73 74 3c 2f 65 6d 3e 20 68 em>digest</em> h
5730: 61 73 68 0a 09 66 75 6e 63 74 69 6f 6e 2e 20 52 ash..function. R
5740: 65 74 75 72 6e 73 20 76 61 6c 75 65 20 61 73 20 eturns value as
5750: 61 20 68 65 78 20 73 74 72 69 6e 67 20 28 64 65 a hex string (de
5760: 66 61 75 6c 74 29 20 6f 72 20 61 73 20 61 20 62 fault) or as a b
5770: 69 6e 61 72 79 20 76 61 6c 75 65 0a 09 77 69 74 inary value..wit
5780: 68 20 3c 62 3e 2d 62 69 6e 3c 2f 62 3e 20 6f 72 h <b>-bin</b> or
5790: 20 3c 62 3e 2d 62 69 6e 61 72 79 3c 2f 62 3e 20 <b>-binary</b>
57a0: 6f 70 74 69 6f 6e 2e 20 44 69 67 65 73 74 20 63 option. Digest c
57b0: 61 6e 20 62 65 20 61 6e 79 20 4f 70 65 6e 53 53 an be any OpenSS
57c0: 4c 0a 09 73 75 70 70 6f 72 74 65 64 20 68 61 73 L..supported has
57d0: 68 20 66 75 6e 63 74 69 6f 6e 20 69 6e 63 6c 75 h function inclu
57e0: 64 69 6e 67 3a 20 3c 62 3e 6d 64 34 3c 2f 62 3e ding: <b>md4</b>
57f0: 2c 20 3c 62 3e 6d 64 35 3c 2f 62 3e 2c 20 3c 62 , <b>md5</b>, <b
5800: 3e 73 68 61 31 3c 2f 62 3e 2c 0a 09 3c 62 3e 73 >sha1</b>,..<b>s
5810: 68 61 32 35 36 3c 2f 62 3e 2c 20 3c 62 3e 73 68 ha256</b>, <b>sh
5820: 61 35 31 32 3c 2f 62 3e 2c 20 3c 62 3e 73 68 61 a512</b>, <b>sha
5830: 33 2d 32 35 36 3c 2f 62 3e 2c 20 65 74 63 2e 20 3-256</b>, etc.
5840: 53 65 65 0a 09 3c 62 3e 74 6c 73 3a 3a 64 69 67 See..<b>tls::dig
5850: 65 73 74 73 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 ests</b> command
5860: 20 66 6f 72 20 61 20 66 75 6c 6c 20 6c 69 73 74 for a full list
5870: 2e 0a 09 3c 62 72 3e 0a 09 55 73 69 6e 67 20 74 ...<br>..Using t
5880: 68 65 20 3c 62 3e 2d 64 61 74 61 3c 2f 62 3e 20 he <b>-data</b>
5890: 6f 70 74 69 6f 6e 20 77 69 6c 6c 20 69 6d 6d 65 option will imme
58a0: 64 69 61 74 65 6c 79 20 72 65 74 75 72 6e 20 74 diately return t
58b0: 68 65 20 6d 65 73 73 61 67 65 0a 09 64 69 67 65 he message..dige
58c0: 73 74 20 66 6f 72 20 3c 65 6d 3e 64 61 74 61 3c st for <em>data<
58d0: 2f 65 6d 3e 20 69 6e 20 74 68 65 20 73 70 65 63 /em> in the spec
58e0: 69 66 69 65 64 20 66 6f 72 6d 61 74 2e 0a 09 3c ified format...<
58f0: 62 72 3e 0a 09 55 73 69 6e 67 20 74 68 65 20 3c br>..Using the <
5900: 62 3e 2d 66 69 6c 65 3c 2f 62 3e 20 6f 72 20 3c b>-file</b> or <
5910: 62 3e 2d 66 69 6c 65 6e 61 6d 65 3c 2f 62 3e 20 b>-filename</b>
5920: 6f 70 74 69 6f 6e 20 77 69 6c 6c 20 6f 70 65 6e option will open
5930: 20 66 69 6c 65 0a 09 3c 65 6d 3e 66 69 6c 65 6e file..<em>filen
5940: 61 6d 65 3c 2f 65 6d 3e 2c 20 72 65 61 64 20 74 ame</em>, read t
5950: 68 65 20 66 69 6c 65 20 64 61 74 61 2c 20 63 6c he file data, cl
5960: 6f 73 65 20 74 68 65 20 66 69 6c 65 2c 20 61 6e ose the file, an
5970: 64 20 72 65 74 75 72 6e 20 74 68 65 0a 09 6d 65 d return the..me
5980: 73 73 61 67 65 20 64 69 67 65 73 74 20 69 6e 20 ssage digest in
5990: 74 68 65 20 73 70 65 63 69 66 69 65 64 20 66 6f the specified fo
59a0: 72 6d 61 74 2e 20 54 68 69 73 20 75 73 65 73 20 rmat. This uses
59b0: 74 68 65 20 54 43 4c 20 41 50 49 73 2c 20 73 6f the TCL APIs, so
59c0: 20 56 46 53 0a 09 66 69 6c 65 73 20 61 72 65 20 VFS..files are
59d0: 73 75 70 70 6f 72 74 65 64 2e 0a 09 3c 62 72 3e supported...<br>
59e0: 0a 09 55 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d ..Using the <b>-
59f0: 63 68 61 6e 3c 2f 62 3e 20 6f 72 20 3c 62 3e 2d chan</b> or <b>-
5a00: 63 68 61 6e 6e 65 6c 3c 2f 62 3e 20 6f 70 74 69 channel</b> opti
5a10: 6f 6e 2c 20 61 20 73 74 61 63 6b 65 64 20 63 68 on, a stacked ch
5a20: 61 6e 6e 65 6c 20 69 73 0a 09 63 72 65 61 74 65 annel is..create
5a30: 64 20 66 6f 72 20 3c 65 6d 3e 63 68 61 6e 6e 65 d for <em>channe
5a40: 6c 49 64 3c 2f 65 6d 3e 20 61 6e 64 20 64 61 74 lId</em> and dat
5a50: 61 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 a read from the
5a60: 63 68 61 6e 6e 65 6c 20 69 73 20 75 73 65 64 0a channel is used.
5a70: 09 74 6f 20 63 61 6c 63 75 6c 61 74 65 20 61 20 .to calculate a
5a80: 6d 65 73 73 61 67 65 20 64 69 67 65 73 74 20 77 message digest w
5a90: 69 74 68 20 74 68 65 20 72 65 73 75 6c 74 20 72 ith the result r
5aa0: 65 74 75 72 6e 65 64 20 77 69 74 68 20 74 68 65 eturned with the
5ab0: 20 6c 61 73 74 0a 09 72 65 61 64 20 6f 70 65 72 last..read oper
5ac0: 61 74 69 6f 6e 20 62 65 66 6f 72 65 20 45 4f 46 ation before EOF
5ad0: 2e 20 43 68 61 6e 6e 65 6c 20 69 73 20 61 75 74 . Channel is aut
5ae0: 6f 6d 61 74 69 63 61 6c 6c 79 20 73 65 74 20 74 omatically set t
5af0: 6f 20 62 69 6e 61 72 79 20 6d 6f 64 65 2e 0a 09 o binary mode...
5b00: 3c 62 72 3e 0a 09 55 73 69 6e 67 20 74 68 65 20 <br>..Using the
5b10: 3c 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 <b>-command</b>
5b20: 6f 70 74 69 6f 6e 2c 20 61 20 6e 65 77 20 63 6f option, a new co
5b30: 6d 6d 61 6e 64 20 3c 65 6d 3e 63 6d 64 4e 61 6d mmand <em>cmdNam
5b40: 65 3c 2f 65 6d 3e 20 69 73 0a 09 63 72 65 61 74 e</em> is..creat
5b50: 65 64 20 61 6e 64 20 72 65 74 75 72 6e 65 64 2e ed and returned.
5b60: 20 54 6f 20 61 64 64 20 64 61 74 61 20 74 6f 20 To add data to
5b70: 74 68 65 20 68 61 73 68 20 66 75 6e 63 74 69 6f the hash functio
5b80: 6e 2c 20 63 61 6c 6c 0a 09 26 71 75 6f 74 3b 3c n, call.."<
5b90: 65 6d 3e 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 em>cmdName</em>
5ba0: 3c 62 3e 75 70 64 61 74 65 3c 2f 62 3e 20 3c 65 <b>update</b> <e
5bb0: 6d 3e 64 61 74 61 3c 2f 65 6d 3e 26 71 75 6f 74 m>data</em>"
5bc0: 3b 2c 20 77 68 65 72 65 20 64 61 74 61 20 69 73 ;, where data is
5bd0: 0a 09 74 68 65 20 64 61 74 61 20 74 6f 20 61 64 ..the data to ad
5be0: 64 2e 20 57 68 65 6e 20 64 6f 6e 65 2c 20 63 61 d. When done, ca
5bf0: 6c 6c 20 26 71 75 6f 74 3b 3c 65 6d 3e 63 6d 64 ll "<em>cmd
5c00: 4e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 66 69 6e Name</em> <b>fin
5c10: 61 6c 69 7a 65 3c 2f 62 3e 26 71 75 6f 74 3b 0a alize</b>".
5c20: 09 74 6f 20 72 65 74 75 72 6e 20 74 68 65 20 6d .to return the m
5c30: 65 73 73 61 67 65 20 64 69 67 65 73 74 2e 0a 09 essage digest...
5c40: 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c </dd>.. <dt><
5c50: 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 63 6d 61 a name="tls::cma
5c60: 63 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a c"><strong>tls::
5c70: 63 6d 61 63 3c 2f 73 74 72 6f 6e 67 3e 20 3c 62 cmac</strong> <b
5c80: 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 65 6d >-cipher</b> <em
5c90: 3e 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d >name</em>..<b>-
5ca0: 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 key</b> <em>key
5cb0: 3f 2d 62 69 6e 7c 2d 68 65 78 3f 20 5b 2d 66 69 ?-bin|-hex? [-fi
5cc0: 6c 65 20 66 69 6c 65 6e 61 6d 65 20 7c 20 2d 63 le filename | -c
5cd0: 6f 6d 6d 61 6e 64 20 63 6d 64 4e 61 6d 65 20 7c ommand cmdName |
5ce0: 0a 09 2d 63 68 61 6e 20 63 68 61 6e 6e 65 6c 49 ..-chan channelI
5cf0: 64 20 7c 20 2d 64 61 74 61 20 64 61 74 61 5d 3c d | -data data]<
5d00: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
5d10: 20 20 3c 64 64 3e 43 61 6c 63 75 6c 61 74 65 20 <dd>Calculate
5d20: 74 68 65 20 43 69 70 68 65 72 2d 62 61 73 65 64 the Cipher-based
5d30: 20 4d 65 73 73 61 67 65 20 41 75 74 68 65 6e 74 Message Authent
5d40: 69 63 61 74 69 6f 6e 20 43 6f 64 65 20 28 43 4d ication Code (CM
5d50: 41 43 29 2e 20 53 61 6d 65 20 61 72 67 75 6d 65 AC). Same argume
5d60: 6e 74 73 0a 09 61 73 20 3c 62 3e 74 6c 73 3a 3a nts..as <b>tls::
5d70: 64 69 67 65 73 74 3c 2f 62 3e 20 77 69 74 68 20 digest</b> with
5d80: 61 64 64 69 74 69 6f 6e 61 6c 20 6f 70 74 69 6f additional optio
5d90: 6e 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e n <b>-cipher</b>
5da0: 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 0a to specify the.
5db0: 09 63 69 70 68 65 72 20 74 6f 20 75 73 65 20 61 .cipher to use a
5dc0: 6e 64 20 66 6f 72 20 63 65 72 74 61 69 6e 20 63 nd for certain c
5dd0: 69 70 68 65 72 73 2c 20 3c 62 3e 2d 6b 65 79 3c iphers, <b>-key<
5de0: 2f 62 3e 20 74 6f 20 73 70 65 63 69 66 79 20 74 /b> to specify t
5df0: 68 65 20 6b 65 79 2e 3c 2f 64 64 3e 0a 0a 20 20 he key.</dd>..
5e00: 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 <dt><a name="t
5e10: 6c 73 3a 3a 68 6d 61 63 22 3e 3c 73 74 72 6f 6e ls::hmac"><stron
5e20: 67 3e 74 6c 73 3a 3a 68 6d 61 63 3c 2f 73 74 72 g>tls::hmac</str
5e30: 6f 6e 67 3e 20 3c 62 3e 2d 64 69 67 65 73 74 3c ong> <b>-digest<
5e40: 2f 62 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d /b> <em>name</em
5e50: 3e 0a 09 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c >..<b>-key</b> <
5e60: 65 6d 3e 6b 65 79 20 3f 2d 62 69 6e 7c 2d 68 65 em>key ?-bin|-he
5e70: 78 3f 20 5b 2d 66 69 6c 65 20 66 69 6c 65 6e 61 x? [-file filena
5e80: 6d 65 20 7c 20 2d 63 6f 6d 6d 61 6e 64 20 63 6d me | -command cm
5e90: 64 4e 61 6d 65 20 7c 0a 09 2d 63 68 61 6e 20 63 dName |..-chan c
5ea0: 68 61 6e 6e 65 6c 49 64 20 7c 20 2d 64 61 74 61 hannelId | -data
5eb0: 20 64 61 74 61 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c data]</em></a><
5ec0: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 43 61 6c /dt>. <dd>Cal
5ed0: 63 75 6c 61 74 65 20 74 68 65 20 48 61 73 68 65 culate the Hashe
5ee0: 64 20 4d 65 73 73 61 67 65 20 41 75 74 68 65 6e d Message Authen
5ef0: 74 69 63 61 74 69 6f 6e 20 43 6f 64 65 20 28 48 tication Code (H
5f00: 4d 41 43 29 2e 20 53 61 6d 65 20 61 72 67 75 6d MAC). Same argum
5f10: 65 6e 74 73 0a 09 61 73 20 3c 62 3e 74 6c 73 3a ents..as <b>tls:
5f20: 3a 64 69 67 65 73 74 3c 2f 62 3e 20 77 69 74 68 :digest</b> with
5f30: 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 70 74 69 additional opti
5f40: 6f 6e 20 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 74 on <b>-key</b> t
5f50: 6f 20 73 70 65 63 69 66 79 20 74 68 65 0a 09 6b o specify the..k
5f60: 65 79 20 74 6f 20 75 73 65 2e 20 54 6f 20 73 61 ey to use. To sa
5f70: 6c 74 20 61 20 70 61 73 73 77 6f 72 64 2c 20 61 lt a password, a
5f80: 70 70 65 6e 64 20 6f 72 20 70 72 65 70 65 6e 64 ppend or prepend
5f90: 20 74 68 65 20 73 61 6c 74 0a 09 64 61 74 61 20 the salt..data
5fa0: 74 6f 20 74 68 65 20 70 61 73 73 77 6f 72 64 2e to the password.
5fb0: 20 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e </dd>.. <dt>
5fc0: 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6d 64 <a name="tls::md
5fd0: 34 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 4"><strong>tls::
5fe0: 6d 64 34 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d md4</strong> <em
5ff0: 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f >data</em></a></
6000: 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 dt>. <dd>Retu
6010: 72 6e 73 20 74 68 65 20 4d 44 34 20 6d 65 73 73 rns the MD4 mess
6020: 61 67 65 2d 64 69 67 65 73 74 20 66 6f 72 20 3c age-digest for <
6030: 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 73 20 em>data</em> as
6040: 61 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 a hex string.</d
6050: 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e d>.. <dt><a n
6060: 61 6d 65 3d 22 74 6c 73 3a 3a 6d 64 35 22 3e 3c ame="tls::md5"><
6070: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6d 64 35 3c strong>tls::md5<
6080: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 /strong> <em>dat
6090: 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a a</em></a></dt>.
60a0: 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 <dd>Returns
60b0: 74 68 65 20 4d 44 35 20 6d 65 73 73 61 67 65 2d the MD5 message-
60c0: 64 69 67 65 73 74 20 66 6f 72 20 3c 65 6d 3e 64 digest for <em>d
60d0: 61 74 61 3c 2f 65 6d 3e 20 61 73 20 61 20 68 65 ata</em> as a he
60e0: 78 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 0a x string.</dd>..
60f0: 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d <dt><a name=
6100: 22 74 6c 73 3a 3a 73 68 61 31 22 3e 3c 73 74 72 "tls::sha1"><str
6110: 6f 6e 67 3e 74 6c 73 3a 3a 73 68 61 31 3c 2f 73 ong>tls::sha1</s
6120: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 61 3c trong> <em>data<
6130: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
6140: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 68 <dd>Returns th
6150: 65 20 53 48 41 31 20 73 65 63 75 72 65 20 68 61 e SHA1 secure ha
6160: 73 68 20 61 6c 67 6f 72 69 74 68 6d 20 64 69 67 sh algorithm dig
6170: 65 73 74 20 66 6f 72 20 3c 65 6d 3e 64 61 74 61 est for <em>data
6180: 3c 2f 65 6d 3e 20 61 73 20 61 20 68 65 78 20 73 </em> as a hex s
6190: 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 0a 20 20 20 tring.</dd>..
61a0: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
61b0: 73 3a 3a 73 68 61 32 35 36 22 3e 3c 73 74 72 6f s::sha256"><stro
61c0: 6e 67 3e 74 6c 73 3a 3a 73 68 61 32 35 36 3c 2f ng>tls::sha256</
61d0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 61 strong> <em>data
61e0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
61f0: 20 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 <dd>Returns t
6200: 68 65 20 53 48 41 2d 32 20 53 48 41 32 35 36 20 he SHA-2 SHA256
6210: 73 65 63 75 72 65 20 68 61 73 68 20 61 6c 67 6f secure hash algo
6220: 72 69 74 68 6d 20 64 69 67 65 73 74 20 66 6f 72 rithm digest for
6230: 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 <em>data</em> a
6240: 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 2e 3c s a hex string.<
6250: 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 /dd>.. <dt><a
6260: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 73 68 61 35 name="tls::sha5
6270: 31 32 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 12"><strong>tls:
6280: 3a 73 68 61 35 31 32 3c 2f 73 74 72 6f 6e 67 3e :sha512</strong>
6290: 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f <em>data</em></
62a0: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
62b0: 52 65 74 75 72 6e 73 20 74 68 65 20 53 48 41 2d Returns the SHA-
62c0: 32 20 53 48 41 35 31 32 20 73 65 63 75 72 65 20 2 SHA512 secure
62d0: 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 20 64 hash algorithm d
62e0: 69 67 65 73 74 20 66 6f 72 20 3c 65 6d 3e 64 61 igest for <em>da
62f0: 74 61 3c 2f 65 6d 3e 20 61 73 20 61 20 68 65 78 ta</em> as a hex
6300: 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 3c 2f string.</dd>.</
6310: 64 6c 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 dl>..<h3><a name
6320: 3d 22 43 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f ="CALLBACK OPTIO
6330: 4e 53 22 3e 43 41 4c 4c 42 41 43 4b 20 4f 50 54 NS">CALLBACK OPT
6340: 49 4f 4e 53 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c IONS</a></h3>..<
6350: 70 3e 0a 41 73 20 69 6e 64 69 63 61 74 65 64 20 p>.As indicated
6360: 61 62 6f 76 65 2c 20 69 6e 64 69 76 69 64 75 61 above, individua
6370: 6c 20 63 68 61 6e 6e 65 6c 73 20 63 61 6e 20 62 l channels can b
6380: 65 20 67 69 76 65 6e 20 74 68 65 69 72 20 6f 77 e given their ow
6390: 6e 20 63 61 6c 6c 62 61 63 6b 73 0a 74 6f 20 68 n callbacks.to h
63a0: 61 6e 64 6c 65 20 69 6e 74 65 72 6d 65 64 69 61 andle intermedia
63b0: 74 65 20 70 72 6f 63 65 73 73 69 6e 67 20 62 79 te processing by
63c0: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 6c 69 62 the OpenSSL lib
63d0: 72 61 72 79 2c 20 75 73 69 6e 67 20 74 68 65 0a rary, using the.
63e0: 3c 73 74 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 <strong>-command
63f0: 3c 2f 73 74 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f </strong>, <stro
6400: 6e 67 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 ng>-password</st
6410: 72 6f 6e 67 3e 2c 20 61 6e 64 0a 3c 73 74 72 6f rong>, and.<stro
6420: 6e 67 3e 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d ng>-validate_com
6430: 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 6f 70 mand</strong> op
6440: 74 69 6f 6e 73 20 70 61 73 73 65 64 20 74 6f 20 tions passed to
6450: 65 69 74 68 65 72 20 6f 66 0a 3c 73 74 72 6f 6e either of.<stron
6460: 67 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 73 g>tls::socket</s
6470: 74 72 6f 6e 67 3e 20 6f 72 20 3c 73 74 72 6f 6e trong> or <stron
6480: 67 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 3c 2f 73 g>tls::import</s
6490: 74 72 6f 6e 67 3e 2e 0a 49 66 20 74 68 65 20 63 trong>..If the c
64a0: 61 6c 6c 62 61 63 6b 20 67 65 6e 65 72 61 74 65 allback generate
64b0: 73 20 61 6e 20 65 72 72 6f 72 2c 20 74 68 65 20 s an error, the
64c0: 3c 62 3e 62 67 65 72 72 6f 72 3c 2f 62 3e 20 63 <b>bgerror</b> c
64d0: 6f 6d 6d 61 6e 64 20 77 69 74 68 20 62 65 0a 69 ommand with be.i
64e0: 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20 nvoked with the
64f0: 65 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f error informatio
6500: 6e 2e 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 n..</p>..<blockq
6510: 75 6f 74 65 3e 0a 3c 64 6c 3e 0a 0a 20 20 20 20 uote>.<dl>..
6520: 3c 64 74 3e 3c 73 74 72 6f 6e 67 3e 2d 63 6f 6d <dt><strong>-com
6530: 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 mand</strong> <e
6540: 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 3c m>callback</em><
6550: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 0a 09 49 /dt>. <dd>..I
6560: 6e 76 6f 6b 65 73 20 74 68 65 20 73 70 65 63 69 nvokes the speci
6570: 66 69 65 64 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 fied <em>callbac
6580: 6b 3c 2f 65 6d 3e 20 73 63 72 69 70 74 20 61 74 k</em> script at
6590: 20 73 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 0a several points.
65a0: 09 64 75 72 69 6e 67 20 74 68 65 20 4f 70 65 6e .during the Open
65b0: 53 53 4c 20 68 61 6e 64 73 68 61 6b 65 20 61 6e SSL handshake an
65c0: 64 20 75 73 65 2e 20 53 65 65 20 62 65 6c 6f 77 d use. See below
65d0: 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 6c for the possibl
65e0: 65 0a 09 61 72 67 75 6d 65 6e 74 73 20 70 61 73 e..arguments pas
65f0: 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 62 sed to the callb
6600: 61 63 6b 20 73 63 72 69 70 74 2e 20 56 61 6c 75 ack script. Valu
6610: 65 73 20 72 65 74 75 72 6e 65 64 20 66 72 6f 6d es returned from
6620: 20 74 68 65 0a 09 63 61 6c 6c 62 61 63 6b 20 61 the..callback a
6630: 72 65 20 69 67 6e 6f 72 65 64 2e 0a 0a 09 3c 62 re ignored....<b
6640: 72 3e 0a 09 3c 62 72 3e 0a 0a 09 3c 64 6c 3e 0a r>..<br>...<dl>.
6650: 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e ..<dt>.. <stron
6660: 67 3e 65 72 72 6f 72 3c 2f 73 74 72 6f 6e 67 3e g>error</strong>
6670: 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 6d 65 73 <em>channel mes
6680: 73 61 67 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e sage</em>..</dt>
6690: 0a 09 3c 64 64 3e 0a 09 20 20 54 68 65 20 3c 65 ..<dd>.. The <e
66a0: 6d 3e 6d 65 73 73 61 67 65 3c 2f 65 6d 3e 20 61 m>message</em> a
66b0: 72 67 75 6d 65 6e 74 20 63 6f 6e 74 61 69 6e 73 rgument contains
66c0: 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 an error messag
66d0: 65 20 67 65 6e 65 72 61 74 65 64 0a 09 20 20 62 e generated.. b
66e0: 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 y the OpenSSL fu
66f0: 6e 63 74 69 6f 6e 20 3c 63 6f 64 65 3e 45 52 52 nction <code>ERR
6700: 5f 72 65 61 73 6f 6e 5f 65 72 72 6f 72 5f 73 74 _reason_error_st
6710: 72 69 6e 67 28 29 3c 2f 63 6f 64 65 3e 2e 0a 09 ring()</code>...
6720: 3c 2f 64 64 3e 0a 0a 09 3c 62 72 3e 0a 0a 09 3c </dd>...<br>...<
6730: 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 69 dt>.. <strong>i
6740: 6e 66 6f 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d nfo</strong> <em
6750: 3e 63 68 61 6e 6e 65 6c 20 6d 61 6a 6f 72 20 6d >channel major m
6760: 69 6e 6f 72 20 6d 65 73 73 61 67 65 20 74 79 70 inor message typ
6770: 65 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c e</em>..</dt>..<
6780: 64 64 3e 0a 09 20 20 54 68 69 73 20 66 6f 72 6d dd>.. This form
6790: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
67a0: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f invoked by the O
67b0: 70 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a penSSL function.
67c0: 09 20 20 3c 63 6f 64 65 3e 53 53 4c 5f 43 54 58 . <code>SSL_CTX
67d0: 5f 73 65 74 5f 69 6e 66 6f 5f 63 61 6c 6c 62 61 _set_info_callba
67e0: 63 6b 28 29 3c 2f 63 6f 64 65 3e 20 64 75 72 69 ck()</code> duri
67f0: 6e 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 65 ng connection se
6800: 74 75 70 0a 09 20 20 61 6e 64 20 75 73 65 2e 0a tup.. and use..
6810: 09 20 20 3c 62 72 3e 0a 09 20 20 3c 75 6c 3e 0a . <br>.. <ul>.
6820: 09 20 20 3c 6c 69 3e 50 6f 73 73 69 62 6c 65 20 . <li>Possible
6830: 76 61 6c 75 65 73 20 66 6f 72 20 3c 65 6d 3e 6d values for <em>m
6840: 61 6a 6f 72 3c 2f 65 6d 3e 20 61 72 65 3a 0a 09 ajor</em> are:..
6850: 20 20 3c 63 6f 64 65 3e 68 61 6e 64 73 68 61 6b <code>handshak
6860: 65 2c 20 61 6c 65 72 74 2c 20 63 6f 6e 6e 65 63 e, alert, connec
6870: 74 2c 20 61 63 63 65 70 74 3c 2f 63 6f 64 65 3e t, accept</code>
6880: 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 50 6f .</li>.. <li>Po
6890: 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f ssible values fo
68a0: 72 20 3c 65 6d 3e 6d 69 6e 6f 72 3c 2f 65 6d 3e r <em>minor</em>
68b0: 20 61 72 65 3a 0a 09 20 20 3c 63 6f 64 65 3e 73 are:.. <code>s
68c0: 74 61 72 74 2c 20 64 6f 6e 65 2c 20 72 65 61 64 tart, done, read
68d0: 2c 20 77 72 69 74 65 2c 20 6c 6f 6f 70 2c 20 65 , write, loop, e
68e0: 78 69 74 3c 2f 63 6f 64 65 3e 2e 3c 2f 6c 69 3e xit</code>.</li>
68f0: 0a 09 20 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e .. <li>The <em>
6900: 6d 65 73 73 61 67 65 3c 2f 65 6d 3e 20 61 72 67 message</em> arg
6910: 75 6d 65 6e 74 20 69 73 20 61 20 64 65 73 63 72 ument is a descr
6920: 69 70 74 69 76 65 20 73 74 72 69 6e 67 20 77 68 iptive string wh
6930: 69 63 68 20 6d 61 79 0a 09 20 20 62 65 20 67 65 ich may.. be ge
6940: 6e 65 72 61 74 65 64 20 65 69 74 68 65 72 20 62 nerated either b
6950: 79 20 3c 63 6f 64 65 3e 53 53 4c 5f 73 74 61 74 y <code>SSL_stat
6960: 65 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 28 29 3c e_string_long()<
6970: 2f 63 6f 64 65 3e 20 6f 72 20 62 79 0a 09 20 20 /code> or by..
6980: 3c 63 6f 64 65 3e 53 53 4c 5f 61 6c 65 72 74 5f <code>SSL_alert_
6990: 64 65 73 63 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 desc_string_long
69a0: 28 29 3c 2f 63 6f 64 65 3e 2c 20 64 65 70 65 6e ()</code>, depen
69b0: 64 69 6e 67 20 6f 6e 20 74 68 65 20 63 6f 6e 74 ding on the cont
69c0: 65 78 74 2e 3c 2f 6c 69 3e 0a 09 20 20 3c 6c 69 ext.</li>.. <li
69d0: 3e 46 6f 72 20 61 6c 65 72 74 73 2c 20 74 68 65 >For alerts, the
69e0: 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 possible values
69f0: 20 66 6f 72 20 3c 65 6d 3e 74 79 70 65 3c 2f 65 for <em>type</e
6a00: 6d 3e 20 61 72 65 3a 0a 09 20 20 3c 63 6f 64 65 m> are:.. <code
6a10: 3e 77 61 72 6e 69 6e 67 2c 20 66 61 74 61 6c 2c >warning, fatal,
6a20: 20 61 6e 64 20 75 6e 6b 6e 6f 77 6e 3c 2f 63 6f and unknown</co
6a30: 64 65 3e 2e 20 46 6f 72 20 6f 74 68 65 72 73 2c de>. For others,
6a40: 0a 09 20 20 3c 63 6f 64 65 3e 69 6e 66 6f 3c 2f .. <code>info</
6a50: 63 6f 64 65 3e 20 69 73 20 75 73 65 64 2e 3c 2f code> is used.</
6a60: 6c 69 3e 0a 09 20 20 3c 2f 75 6c 3e 0a 09 3c 2f li>.. </ul>..</
6a70: 64 64 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 dd>...<dt>.. <s
6a80: 74 72 6f 6e 67 3e 6d 65 73 73 61 67 65 3c 2f 73 trong>message</s
6a90: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e trong> <em>chann
6aa0: 65 6c 20 64 69 72 65 63 74 69 6f 6e 20 76 65 72 el direction ver
6ab0: 73 69 6f 6e 20 63 6f 6e 74 65 6e 74 5f 74 79 70 sion content_typ
6ac0: 65 20 64 61 74 61 3c 2f 65 6d 3e 0a 09 3c 2f 64 e data</em>..</d
6ad0: 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 68 69 73 t>..<dd>.. This
6ae0: 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 form of callbac
6af0: 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 k is invoked by
6b00: 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 6e 63 the OpenSSL func
6b10: 74 69 6f 6e 0a 09 20 20 3c 63 6f 64 65 3e 53 53 tion.. <code>SS
6b20: 4c 5f 73 65 74 5f 6d 73 67 5f 63 61 6c 6c 62 61 L_set_msg_callba
6b30: 63 6b 28 29 3c 2f 63 6f 64 65 3e 20 77 68 65 6e ck()</code> when
6b40: 65 76 65 72 20 61 20 6d 65 73 73 61 67 65 20 69 ever a message i
6b50: 73 20 73 65 6e 74 20 6f 72 0a 09 20 20 72 65 63 s sent or.. rec
6b60: 65 69 76 65 64 2e 20 49 74 20 69 73 20 6f 6e 6c eived. It is onl
6b70: 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e y available when
6b80: 0a 09 20 20 4f 70 65 6e 53 53 4c 20 69 73 20 63 .. OpenSSL is c
6b90: 6f 6d 70 6c 69 65 64 20 77 69 74 68 20 74 68 65 omplied with the
6ba0: 20 3c 65 6d 3e 65 6e 61 62 6c 65 2d 73 73 6c 2d <em>enable-ssl-
6bb0: 74 72 61 63 65 3c 2f 65 6d 3e 20 6f 70 74 69 6f trace</em> optio
6bc0: 6e 2e 0a 09 20 20 57 68 65 72 65 20 3c 65 6d 3e n... Where <em>
6bd0: 64 69 72 65 63 74 69 6f 6e 3c 2f 65 6d 3e 20 69 direction</em> i
6be0: 73 20 53 65 6e 74 20 6f 72 20 52 65 63 65 69 76 s Sent or Receiv
6bf0: 65 64 2c 20 3c 65 6d 3e 76 65 72 73 69 6f 6e 3c ed, <em>version<
6c00: 2f 65 6d 3e 20 69 73 20 74 68 65 0a 09 20 20 70 /em> is the.. p
6c10: 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 2c rotocol version,
6c20: 20 3c 65 6d 3e 63 6f 6e 74 65 6e 74 5f 74 79 70 <em>content_typ
6c30: 65 3c 2f 65 6d 3e 20 69 73 20 74 68 65 20 6d 65 e</em> is the me
6c40: 73 73 61 67 65 20 63 6f 6e 74 65 6e 74 20 74 79 ssage content ty
6c50: 70 65 2c 0a 09 20 20 61 6e 64 20 3c 65 6d 3e 64 pe,.. and <em>d
6c60: 61 74 61 3c 2f 65 6d 3e 20 69 73 20 6d 6f 72 65 ata</em> is more
6c70: 20 69 6e 66 6f 20 6f 6e 20 74 68 65 20 6d 65 73 info on the mes
6c80: 73 61 67 65 20 66 72 6f 6d 20 74 68 65 20 3c 63 sage from the <c
6c90: 6f 64 65 3e 53 53 4c 5f 74 72 61 63 65 3c 2f 63 ode>SSL_trace</c
6ca0: 6f 64 65 3e 20 41 50 49 2e 0a 09 3c 2f 64 64 3e ode> API...</dd>
6cb0: 0a 09 3c 62 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 ..<br>...<dt>..
6cc0: 20 3c 73 74 72 6f 6e 67 3e 73 65 73 73 69 6f 6e <strong>session
6cd0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 </strong> <em>ch
6ce0: 61 6e 6e 65 6c 20 73 65 73 73 69 6f 6e 5f 69 64 annel session_id
6cf0: 20 74 69 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 ticket lifetime
6d00: 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 </em>..</dt>..<d
6d10: 64 3e 0a 09 20 20 54 68 69 73 20 66 6f 72 6d 20 d>.. This form
6d20: 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 of callback is i
6d30: 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f 70 nvoked by the Op
6d40: 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a 09 enSSL function..
6d50: 20 20 3c 63 6f 64 65 3e 53 53 4c 5f 43 54 58 5f <code>SSL_CTX_
6d60: 73 65 73 73 5f 73 65 74 5f 6e 65 77 5f 63 62 28 sess_set_new_cb(
6d70: 29 3c 2f 63 6f 64 65 3e 2e 0a 09 20 20 57 68 65 )</code>... Whe
6d80: 72 65 20 3c 65 6d 3e 73 65 73 73 69 6f 6e 5f 69 re <em>session_i
6d90: 64 3c 2f 65 6d 3e 20 69 73 20 74 68 65 20 63 75 d</em> is the cu
6da0: 72 72 65 6e 74 20 73 65 73 73 69 6f 6e 20 69 64 rrent session id
6db0: 65 6e 74 69 66 69 65 72 2c 0a 09 20 20 3c 65 6d entifier,.. <em
6dc0: 3e 74 69 63 6b 65 74 3c 2f 65 6d 3e 20 69 73 20 >ticket</em> is
6dd0: 74 68 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b the session tick
6de0: 65 74 20 69 6e 66 6f 2c 20 61 6e 64 20 3c 65 6d et info, and <em
6df0: 3e 6c 69 66 65 74 69 6d 65 3c 2f 65 6d 3e 0a 09 >lifetime</em>..
6e00: 20 20 69 73 20 74 68 65 20 74 68 65 20 74 69 63 is the the tic
6e10: 6b 65 74 20 6c 69 66 65 74 69 6d 65 20 69 6e 20 ket lifetime in
6e20: 73 65 63 6f 6e 64 73 2e 0a 09 3c 2f 64 64 3e 0a seconds...</dd>.
6e30: 09 3c 62 72 3e 0a 09 3c 2f 64 6c 3e 0a 20 20 20 .<br>..</dl>.
6e40: 20 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 62 72 3e </dd>.. <br>
6e50: 0a 0a 20 20 20 20 3c 64 74 3e 3c 73 74 72 6f 6e .. <dt><stron
6e60: 67 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 g>-password</str
6e70: 6f 6e 67 3e 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 ong> <em>callbac
6e80: 6b 3c 2f 65 6d 3e 3c 2f 64 74 3e 0a 20 20 20 20 k</em></dt>.
6e90: 3c 64 64 3e 0a 09 49 6e 76 6f 6b 65 73 20 74 68 <dd>..Invokes th
6ea0: 65 20 73 70 65 63 69 66 69 65 64 20 3c 65 6d 3e e specified <em>
6eb0: 63 61 6c 6c 62 61 63 6b 3c 2f 65 6d 3e 20 73 63 callback</em> sc
6ec0: 72 69 70 74 20 77 68 65 6e 20 4f 70 65 6e 53 53 ript when OpenSS
6ed0: 4c 20 6e 65 65 64 73 20 74 6f 0a 09 6f 62 74 61 L needs to..obta
6ee0: 69 6e 20 61 20 70 61 73 73 77 6f 72 64 2e 20 53 in a password. S
6ef0: 65 65 20 62 65 6c 6f 77 20 66 6f 72 20 74 68 65 ee below for the
6f00: 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d 65 possible argume
6f10: 6e 74 73 20 70 61 73 73 65 64 20 74 6f 0a 09 74 nts passed to..t
6f20: 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 he callback scri
6f30: 70 74 2e 20 53 65 65 20 62 65 6c 6f 77 20 66 6f pt. See below fo
6f40: 72 20 76 61 6c 69 64 20 72 65 74 75 72 6e 20 76 r valid return v
6f50: 61 6c 75 65 73 2e 0a 0a 09 3c 62 72 3e 0a 09 3c alues....<br>..<
6f60: 62 72 3e 0a 0a 09 3c 64 6c 3e 0a 0a 09 3c 64 74 br>...<dl>...<dt
6f70: 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 70 61 73 >.. <strong>pas
6f80: 73 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 20 3c sword</strong> <
6f90: 65 6d 3e 72 77 66 6c 61 67 20 73 69 7a 65 3c 2f em>rwflag size</
6fa0: 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 64 3e em>..</dt>..<dd>
6fb0: 0a 09 20 20 49 6e 76 6f 6b 65 64 20 77 68 65 6e .. Invoked when
6fc0: 20 6c 6f 61 64 69 6e 67 20 6f 72 20 73 74 6f 72 loading or stor
6fd0: 69 6e 67 20 61 20 50 45 4d 20 63 65 72 74 69 66 ing a PEM certif
6fe0: 69 63 61 74 65 20 77 69 74 68 20 65 6e 63 72 79 icate with encry
6ff0: 70 74 69 6f 6e 2e 0a 09 20 20 57 68 65 72 65 20 ption... Where
7000: 3c 65 6d 3e 72 77 66 6c 61 67 3c 2f 65 6d 3e 20 <em>rwflag</em>
7010: 69 73 20 30 20 66 6f 72 20 72 65 61 64 69 6e 67 is 0 for reading
7020: 2f 64 65 63 72 79 70 74 69 6f 6e 20 6f 72 20 31 /decryption or 1
7030: 20 66 6f 72 0a 09 20 20 77 72 69 74 69 6e 67 2f for.. writing/
7040: 65 6e 63 72 79 70 74 69 6f 6e 20 28 63 61 6e 20 encryption (can
7050: 70 72 6f 6d 70 74 20 75 73 65 72 20 74 6f 20 63 prompt user to c
7060: 6f 6e 66 69 72 6d 29 20 61 6e 64 0a 09 20 20 3c onfirm) and.. <
7070: 65 6d 3e 73 69 7a 65 3c 2f 65 6d 3e 20 69 73 20 em>size</em> is
7080: 74 68 65 20 6d 61 78 20 70 61 73 73 77 6f 72 64 the max password
7090: 20 6c 65 6e 67 74 68 20 69 6e 20 62 79 74 65 73 length in bytes
70a0: 2e 0a 09 20 20 54 68 65 20 63 61 6c 6c 62 61 63 ... The callbac
70b0: 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 k should return
70c0: 74 68 65 20 70 61 73 73 77 6f 72 64 20 61 73 20 the password as
70d0: 61 20 73 74 72 69 6e 67 2e 0a 09 3c 2f 64 64 3e a string...</dd>
70e0: 0a 20 20 20 20 3c 2f 64 64 3e 0a 0a 20 20 20 20 . </dd>..
70f0: 3c 62 72 3e 0a 0a 0a 20 20 20 20 3c 64 74 3e 3c <br>... <dt><
7100: 73 74 72 6f 6e 67 3e 2d 76 61 6c 69 64 61 74 65 strong>-validate
7110: 63 6f 6d 6d 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e command</strong>
7120: 20 3c 65 6d 3e 63 61 6c 6c 62 61 63 6b 3c 2f 65 <em>callback</e
7130: 6d 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e m></dt>. <dd>
7140: 0a 09 49 6e 76 6f 6b 65 73 20 74 68 65 20 73 70 ..Invokes the sp
7150: 65 63 69 66 69 65 64 20 3c 65 6d 3e 63 61 6c 6c ecified <em>call
7160: 62 61 63 6b 3c 2f 65 6d 3e 20 73 63 72 69 70 74 back</em> script
7170: 20 64 75 72 69 6e 67 20 68 61 6e 64 73 68 61 6b during handshak
7180: 65 20 69 6e 0a 09 6f 72 64 65 72 20 74 6f 20 76 e in..order to v
7190: 61 6c 69 64 61 74 65 20 74 68 65 20 70 72 6f 76 alidate the prov
71a0: 69 64 65 64 20 76 61 6c 75 65 28 73 29 2e 20 53 ided value(s). S
71b0: 65 65 20 62 65 6c 6f 77 20 66 6f 72 20 74 68 65 ee below for the
71c0: 20 70 6f 73 73 69 62 6c 65 0a 09 61 72 67 75 6d possible..argum
71d0: 65 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 ents passed to t
71e0: 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 he callback scri
71f0: 70 74 2e 0a 09 54 6f 20 72 65 6a 65 63 74 20 74 pt...To reject t
7200: 68 65 20 76 61 6c 75 65 20 61 6e 64 20 61 62 6f he value and abo
7210: 72 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 74 rt connection, t
7220: 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 68 6f 75 he callback shou
7230: 6c 64 20 72 65 74 75 72 6e 20 30 2e 0a 09 54 6f ld return 0...To
7240: 20 61 63 63 65 70 74 20 74 68 65 20 76 61 6c 75 accept the valu
7250: 65 20 61 6e 64 20 63 6f 6e 74 69 6e 75 65 20 74 e and continue t
7260: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 he connection, i
7270: 74 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 t should return
7280: 31 2e 0a 09 54 6f 20 72 65 6a 65 63 74 20 74 68 1...To reject th
7290: 65 20 76 61 6c 75 65 2c 20 62 75 74 20 63 6f 6e e value, but con
72a0: 74 69 6e 75 65 20 74 68 65 20 63 6f 6e 6e 65 63 tinue the connec
72b0: 74 69 6f 6e 2c 20 69 74 20 73 68 6f 75 6c 64 20 tion, it should
72c0: 72 65 74 75 72 6e 20 32 2e 0a 0a 09 3c 62 72 3e return 2....<br>
72d0: 0a 09 3c 62 72 3e 0a 0a 09 3c 64 6c 3e 0a 0a 09 ..<br>...<dl>...
72e0: 3c 64 74 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e <dt>.. <strong>
72f0: 61 6c 70 6e 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 alpn</strong> <e
7300: 6d 3e 63 68 61 6e 6e 65 6c 20 70 72 6f 74 6f 63 m>channel protoc
7310: 6f 6c 20 6d 61 74 63 68 3c 2f 65 6d 3e 0a 09 3c ol match</em>..<
7320: 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 46 6f /dt>..<dd>.. Fo
7330: 72 20 73 65 72 76 65 72 73 2c 20 74 68 69 73 20 r servers, this
7340: 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 6b form of callback
7350: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e is invoked when
7360: 20 74 68 65 20 63 6c 69 65 6e 74 20 41 4c 50 4e the client ALPN
7370: 0a 09 20 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 .. extension is
7380: 20 72 65 63 65 69 76 65 64 2e 20 49 66 20 3c 65 received. If <e
7390: 6d 3e 6d 61 74 63 68 3c 2f 65 6d 3e 20 69 73 20 m>match</em> is
73a0: 74 72 75 65 2c 20 3c 65 6d 3e 70 72 6f 74 6f 63 true, <em>protoc
73b0: 6f 6c 3c 2f 65 6d 3e 0a 09 20 20 69 73 20 74 68 ol</em>.. is th
73c0: 65 20 66 69 72 73 74 20 3c 62 3e 2d 61 6c 70 6e e first <b>-alpn
73d0: 3c 2f 62 3e 20 73 70 65 63 69 66 69 65 64 20 70 </b> specified p
73e0: 72 6f 74 6f 63 6f 6c 20 63 6f 6d 6d 6f 6e 20 74 rotocol common t
73f0: 6f 20 74 68 65 20 62 6f 74 68 20 74 68 65 0a 09 o the both the..
7400: 20 20 63 6c 69 65 6e 74 20 61 6e 64 20 73 65 72 client and ser
7410: 76 65 72 2e 20 49 66 20 6e 6f 74 2c 20 74 68 65 ver. If not, the
7420: 20 66 69 72 73 74 20 63 6c 69 65 6e 74 20 73 70 first client sp
7430: 65 63 69 66 69 65 64 20 70 72 6f 74 6f 63 6f 6c ecified protocol
7440: 20 69 73 0a 09 20 20 75 73 65 64 2e 20 43 61 6c is.. used. Cal
7450: 6c 65 64 20 61 66 74 65 72 20 68 65 6c 6c 6f 20 led after hello
7460: 61 6e 64 20 41 4c 50 4e 20 63 61 6c 6c 62 61 63 and ALPN callbac
7470: 6b 73 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c 62 72 ks...</dd>...<br
7480: 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 72 >...<dt>.. <str
7490: 6f 6e 67 3e 68 65 6c 6c 6f 3c 2f 73 74 72 6f 6e ong>hello</stron
74a0: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 20 73 g> <em>channel s
74b0: 65 72 76 65 72 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 ervername</em>..
74c0: 3c 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 46 </dt>..<dd>.. F
74d0: 6f 72 20 73 65 72 76 65 72 73 2c 20 74 68 69 73 or servers, this
74e0: 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 form of callbac
74f0: 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 64 75 72 k is invoked dur
7500: 69 6e 67 20 63 6c 69 65 6e 74 20 68 65 6c 6c 6f ing client hello
7510: 0a 09 20 20 6d 65 73 73 61 67 65 20 70 72 6f 63 .. message proc
7520: 65 73 73 69 6e 67 2e 20 49 74 20 69 73 20 75 73 essing. It is us
7530: 65 64 20 74 6f 20 73 65 6c 65 63 74 20 61 6e 20 ed to select an
7540: 61 70 70 72 6f 70 72 69 61 74 65 20 63 65 72 74 appropriate cert
7550: 69 66 69 63 61 74 65 20 74 6f 0a 09 20 20 70 72 ificate to.. pr
7560: 65 73 65 6e 74 2c 20 61 6e 64 20 6d 61 6b 65 20 esent, and make
7570: 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 61 74 other configurat
7580: 69 6f 6e 20 61 64 6a 75 73 74 6d 65 6e 74 73 20 ion adjustments
7590: 72 65 6c 65 76 61 6e 74 20 74 6f 20 74 68 61 74 relevant to that
75a0: 0a 09 20 20 73 65 72 76 65 72 20 6e 61 6d 65 20 .. server name
75b0: 61 6e 64 20 69 74 73 20 63 6f 6e 66 69 67 75 72 and its configur
75c0: 61 74 69 6f 6e 2e 20 43 61 6c 6c 65 64 20 62 65 ation. Called be
75d0: 66 6f 72 65 20 53 4e 49 20 61 6e 64 20 41 4c 50 fore SNI and ALP
75e0: 4e 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 09 3c 2f N callbacks...</
75f0: 64 64 3e 0a 0a 09 3c 62 72 3e 0a 0a 09 3c 64 74 dd>...<br>...<dt
7600: 3e 0a 09 20 20 3c 73 74 72 6f 6e 67 3e 73 6e 69 >.. <strong>sni
7610: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 </strong> <em>ch
7620: 61 6e 6e 65 6c 20 73 65 72 76 65 72 6e 61 6d 65 annel servername
7630: 3c 2f 65 6d 3e 0a 09 3c 2f 64 74 3e 0a 09 3c 64 </em>..</dt>..<d
7640: 64 3e 0a 09 20 20 46 6f 72 20 73 65 72 76 65 72 d>.. For server
7650: 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 s, this form of
7660: 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f callback is invo
7670: 6b 65 64 20 77 68 65 6e 20 74 68 65 20 53 4e 49 ked when the SNI
7680: 20 65 78 74 65 6e 73 69 6f 6e 0a 09 20 20 66 72 extension.. fr
7690: 6f 6d 20 74 68 65 20 63 6c 69 65 6e 74 20 69 73 om the client is
76a0: 20 72 65 63 65 69 76 65 64 2e 20 57 68 65 72 65 received. Where
76b0: 20 3c 65 6d 3e 73 65 72 76 65 72 6e 61 6d 65 3c <em>servername<
76c0: 2f 65 6d 3e 20 69 73 20 74 68 65 20 63 6c 69 65 /em> is the clie
76d0: 6e 74 0a 09 20 20 70 72 6f 76 69 64 65 64 20 73 nt.. provided s
76e0: 65 72 76 65 72 20 6e 61 6d 65 20 66 72 6f 6d 20 erver name from
76f0: 74 68 65 20 3c 62 3e 2d 73 65 72 76 65 72 6e 61 the <b>-serverna
7700: 6d 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 2e 20 54 me</b> option. T
7710: 68 69 73 20 69 73 0a 09 20 20 75 73 65 64 20 77 his is.. used w
7720: 68 65 6e 20 61 20 73 65 72 76 65 72 20 73 75 70 hen a server sup
7730: 70 6f 72 74 73 20 6d 75 6c 74 69 70 6c 65 20 6e ports multiple n
7740: 61 6d 65 73 2c 20 73 6f 20 74 68 65 20 72 69 67 ames, so the rig
7750: 68 74 20 63 65 72 74 69 66 69 63 61 74 65 0a 09 ht certificate..
7760: 20 20 63 61 6e 20 62 65 20 75 73 65 64 2e 20 43 can be used. C
7770: 61 6c 6c 65 64 20 61 66 74 65 72 20 68 65 6c 6c alled after hell
7780: 6f 20 63 61 6c 6c 62 61 63 6b 20 62 75 74 20 62 o callback but b
7790: 65 66 6f 72 65 20 41 4c 50 4e 20 63 61 6c 6c 62 efore ALPN callb
77a0: 61 63 6b 2e 0a 09 3c 2f 64 64 3e 0a 0a 09 3c 62 ack...</dd>...<b
77b0: 72 3e 0a 0a 09 3c 64 74 3e 0a 09 20 20 3c 73 74 r>...<dt>.. <st
77c0: 72 6f 6e 67 3e 76 65 72 69 66 79 3c 2f 73 74 72 rong>verify</str
77d0: 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c ong> <em>channel
77e0: 20 64 65 70 74 68 20 63 65 72 74 20 73 74 61 74 depth cert stat
77f0: 75 73 20 65 72 72 6f 72 3c 2f 65 6d 3e 0a 09 3c us error</em>..<
7800: 2f 64 74 3e 0a 09 3c 64 64 3e 0a 09 20 20 54 68 /dt>..<dd>.. Th
7810: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
7820: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
7830: 79 20 4f 70 65 6e 53 53 4c 20 77 68 65 6e 20 61 y OpenSSL when a
7840: 20 6e 65 77 20 63 65 72 74 69 66 69 63 61 74 65 new certificate
7850: 0a 09 20 20 69 73 20 72 65 63 65 69 76 65 64 20 .. is received
7860: 66 72 6f 6d 20 74 68 65 20 70 65 65 72 2e 20 49 from the peer. I
7870: 74 20 61 6c 6c 6f 77 73 20 74 68 65 20 63 6c 69 t allows the cli
7880: 65 6e 74 20 74 6f 20 63 68 65 63 6b 20 74 68 65 ent to check the
7890: 0a 09 20 20 63 65 72 74 69 66 69 63 61 74 65 20 .. certificate
78a0: 76 65 72 69 66 69 63 61 74 69 6f 6e 20 72 65 73 verification res
78b0: 75 6c 74 73 20 61 6e 64 20 63 68 6f 6f 73 65 20 ults and choose
78c0: 77 68 65 74 68 65 72 20 74 6f 20 63 6f 6e 74 69 whether to conti
78d0: 6e 75 65 0a 09 20 20 6f 72 20 6e 6f 74 2e 20 49 nue.. or not. I
78e0: 74 20 69 73 20 63 61 6c 6c 65 64 20 66 6f 72 20 t is called for
78f0: 65 61 63 68 20 63 65 72 74 69 66 69 63 61 74 65 each certificate
7900: 20 69 6e 20 74 68 65 20 63 65 72 74 69 66 69 63 in the certific
7910: 61 74 65 20 63 68 61 69 6e 2e 0a 09 20 20 3c 75 ate chain... <u
7920: 6c 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 3c 65 l>.. <li>The <e
7930: 6d 3e 64 65 70 74 68 3c 2f 65 6d 3e 20 61 72 67 m>depth</em> arg
7940: 75 6d 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 65 ument is an inte
7950: 67 65 72 20 72 65 70 72 65 73 65 6e 74 69 6e 67 ger representing
7960: 20 74 68 65 0a 09 20 20 63 75 72 72 65 6e 74 20 the.. current
7970: 64 65 70 74 68 20 6f 6e 20 74 68 65 20 63 65 72 depth on the cer
7980: 74 69 66 69 63 61 74 65 20 63 68 61 69 6e 2c 20 tificate chain,
7990: 77 69 74 68 0a 09 20 20 3c 63 6f 64 65 3e 30 3c with.. <code>0<
79a0: 2f 63 6f 64 65 3e 20 61 73 20 74 68 65 20 70 65 /code> as the pe
79b0: 65 72 20 63 65 72 74 69 66 69 63 61 74 65 20 61 er certificate a
79c0: 6e 64 20 68 69 67 68 65 72 20 76 61 6c 75 65 73 nd higher values
79d0: 20 67 6f 69 6e 67 0a 09 20 20 75 70 20 74 6f 20 going.. up to
79e0: 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 20 the Certificate
79f0: 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 2e 3c Authority (CA).<
7a00: 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 /li>.. <li>The
7a10: 3c 65 6d 3e 63 65 72 74 3c 2f 65 6d 3e 20 61 72 <em>cert</em> ar
7a20: 67 75 6d 65 6e 74 20 69 73 20 61 20 6c 69 73 74 gument is a list
7a30: 20 6f 66 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 of key-value pa
7a40: 69 72 73 20 73 69 6d 69 6c 61 72 0a 09 20 20 74 irs similar.. t
7a50: 6f 20 74 68 6f 73 65 20 72 65 74 75 72 6e 65 64 o those returned
7a60: 20 62 79 0a 09 20 20 3c 61 20 68 72 65 66 3d 22 by.. <a href="
7a70: 23 74 6c 73 3a 3a 73 74 61 74 75 73 22 3e 3c 73 #tls::status"><s
7a80: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 74 61 74 75 trong>tls::statu
7a90: 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 2e 3c s</strong></a>.<
7aa0: 2f 6c 69 3e 0a 09 20 20 3c 6c 69 3e 54 68 65 20 /li>.. <li>The
7ab0: 3c 65 6d 3e 73 74 61 74 75 73 3c 2f 65 6d 3e 20 <em>status</em>
7ac0: 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 62 argument is an b
7ad0: 6f 6f 6c 65 61 6e 20 72 65 70 72 65 73 65 6e 74 oolean represent
7ae0: 69 6e 67 20 74 68 65 0a 09 20 20 76 61 6c 69 64 ing the.. valid
7af0: 69 74 79 20 6f 66 20 74 68 65 20 63 75 72 72 65 ity of the curre
7b00: 6e 74 20 63 65 72 74 69 66 69 63 61 74 65 2e 0a nt certificate..
7b10: 09 20 20 41 20 76 61 6c 75 65 20 6f 66 20 3c 63 . A value of <c
7b20: 6f 64 65 3e 30 3c 2f 63 6f 64 65 3e 20 6d 65 61 ode>0</code> mea
7b30: 6e 73 20 74 68 65 20 63 65 72 74 69 66 69 63 61 ns the certifica
7b40: 74 65 20 69 73 20 64 65 65 6d 65 64 20 69 6e 76 te is deemed inv
7b50: 61 6c 69 64 2e 0a 09 20 20 41 20 76 61 6c 75 65 alid... A value
7b60: 20 6f 66 20 3c 63 6f 64 65 3e 31 3c 2f 63 6f 64 of <code>1</cod
7b70: 65 3e 20 6d 65 61 6e 73 20 74 68 65 20 63 65 72 e> means the cer
7b80: 74 69 66 69 63 61 74 65 20 69 73 20 64 65 65 6d tificate is deem
7b90: 65 64 20 76 61 6c 69 64 2e 3c 2f 6c 69 3e 0a 09 ed valid.</li>..
7ba0: 20 20 3c 6c 69 3e 54 68 65 20 3c 65 6d 3e 65 72 <li>The <em>er
7bb0: 72 6f 72 3c 2f 65 6d 3e 20 61 72 67 75 6d 65 6e ror</em> argumen
7bc0: 74 20 73 75 70 70 6c 69 65 73 20 74 68 65 20 6d t supplies the m
7bd0: 65 73 73 61 67 65 2c 20 69 66 20 61 6e 79 2c 20 essage, if any,
7be0: 67 65 6e 65 72 61 74 65 64 0a 09 20 20 62 79 20 generated.. by
7bf0: 3c 63 6f 64 65 3e 58 35 30 39 5f 53 54 4f 52 45 <code>X509_STORE
7c00: 5f 43 54 58 5f 67 65 74 5f 65 72 72 6f 72 28 29 _CTX_get_error()
7c10: 3c 2f 63 6f 64 65 3e 2e 3c 2f 6c 69 3e 0a 09 20 </code>.</li>..
7c20: 20 3c 2f 75 6c 3e 0a 09 3c 2f 64 64 3e 0a 09 3c </ul>..</dd>..<
7c30: 62 72 3e 0a 09 3c 2f 64 6c 3e 0a 20 20 20 20 3c br>..</dl>. <
7c40: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 3c 2f 62 6c 6f /dd>.</dl>.</blo
7c50: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 52 65 ckquote>..<p>.Re
7c60: 66 65 72 65 6e 63 65 20 69 6d 70 6c 65 6d 65 6e ference implemen
7c70: 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 73 65 tations of these
7c80: 20 63 61 6c 6c 62 61 63 6b 73 20 61 72 65 20 70 callbacks are p
7c90: 72 6f 76 69 64 65 64 20 69 6e 20 74 68 65 0a 64 rovided in the.d
7ca0: 69 73 74 72 69 62 75 74 69 6f 6e 20 61 73 20 3c istribution as <
7cb0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 61 6c 6c strong>tls::call
7cc0: 62 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 2c 20 3c back</strong>, <
7cd0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 61 73 73 strong>tls::pass
7ce0: 77 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 0a 61 word</strong>,.a
7cf0: 6e 64 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a nd <strong>tls::
7d00: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
7d10: 3c 2f 73 74 72 6f 6e 67 3e 20 72 65 73 70 65 63 </strong> respec
7d20: 74 69 76 65 6c 79 2e 20 20 4e 6f 74 65 20 74 68 tively. Note th
7d30: 61 74 20 74 68 65 73 65 20 61 72 65 0a 3c 65 6d at these are.<em
7d40: 3e 73 61 6d 70 6c 65 3c 2f 65 6d 3e 20 69 6d 70 >sample</em> imp
7d50: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 6e 6c lementations onl
7d60: 79 2e 20 20 49 6e 20 61 20 6d 6f 72 65 20 72 65 y. In a more re
7d70: 61 6c 69 73 74 69 63 20 64 65 70 6c 6f 79 6d 65 alistic deployme
7d80: 6e 74 0a 79 6f 75 20 77 6f 75 6c 64 20 73 70 65 nt.you would spe
7d90: 63 69 66 79 20 79 6f 75 72 20 6f 77 6e 20 63 61 cify your own ca
7da0: 6c 6c 62 61 63 6b 20 73 63 72 69 70 74 73 20 6f llback scripts o
7db0: 6e 20 65 61 63 68 20 54 4c 53 20 63 68 61 6e 6e n each TLS chann
7dc0: 65 6c 20 75 73 69 6e 67 20 74 68 65 0a 3c 73 74 el using the.<st
7dd0: 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 rong>-command</s
7de0: 74 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e trong>, <strong>
7df0: 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e -password</stron
7e00: 67 3e 2c 20 61 6e 64 20 3c 73 74 72 6f 6e 67 3e g>, and <strong>
7e10: 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e -validate_comman
7e20: 64 3c 2f 73 74 72 6f 6e 67 3e 20 6f 70 74 69 6f d</strong> optio
7e30: 6e 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 ns..</p>..<p>.Th
7e40: 65 20 64 65 66 61 75 6c 74 20 62 65 68 61 76 69 e default behavi
7e50: 6f 72 20 77 68 65 6e 20 74 68 65 20 3c 73 74 72 or when the <str
7e60: 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 74 ong>-command</st
7e70: 72 6f 6e 67 3e 20 61 6e 64 20 3c 73 74 72 6f 6e rong> and <stron
7e80: 67 3e 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d g>-validate_comm
7e90: 61 6e 64 3c 2f 73 74 72 6f 6e 67 3e 0a 6f 70 74 and</strong>.opt
7ea0: 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 73 70 65 ions are not spe
7eb0: 63 69 66 69 65 64 20 69 73 20 66 6f 72 20 54 4c cified is for TL
7ec0: 53 20 74 6f 20 70 72 6f 63 65 73 73 20 74 68 65 S to process the
7ed0: 20 61 73 73 6f 63 69 61 74 65 64 20 6c 69 62 72 associated libr
7ee0: 61 72 79 20 63 61 6c 6c 62 61 63 6b 73 0a 69 6e ary callbacks.in
7ef0: 74 65 72 6e 61 6c 6c 79 2e 20 54 68 65 20 64 65 ternally. The de
7f00: 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 77 fault behavior w
7f10: 68 65 6e 20 74 68 65 20 3c 73 74 72 6f 6e 67 3e hen the <strong>
7f20: 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e -password</stron
7f30: 67 3e 20 6f 70 74 69 6f 6e 20 69 73 20 6e 6f 74 g> option is not
7f40: 0a 73 70 65 63 69 66 69 65 64 20 69 73 20 66 6f .specified is fo
7f50: 72 20 54 4c 53 20 74 6f 20 70 72 6f 63 65 73 73 r TLS to process
7f60: 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 the associated
7f70: 6c 69 62 72 61 72 79 20 63 61 6c 6c 62 61 63 6b library callback
7f80: 73 20 62 79 20 61 74 74 65 6d 70 74 69 6e 67 0a s by attempting.
7f90: 74 6f 20 63 61 6c 6c 20 3c 73 74 72 6f 6e 67 3e to call <strong>
7fa0: 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 3c 2f 73 tls::password</s
7fb0: 74 72 6f 6e 67 3e 2e 0a 54 68 65 20 64 69 66 66 trong>..The diff
7fc0: 65 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 erence between t
7fd0: 68 65 73 65 20 74 77 6f 20 62 65 68 61 76 69 6f hese two behavio
7fe0: 72 73 20 69 73 20 61 20 63 6f 6e 73 65 71 75 65 rs is a conseque
7ff0: 6e 63 65 20 6f 66 20 6d 61 69 6e 74 61 69 6e 69 nce of maintaini
8000: 6e 67 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 ng.compatibility
8010: 20 77 69 74 68 20 65 61 72 6c 69 65 72 20 69 6d with earlier im
8020: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 2e 0a 3c plementations..<
8030: 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65 20 3c 73 74 /p>..<p>.The <st
8040: 72 6f 6e 67 3e 74 6c 73 3a 3a 64 65 62 75 67 3c rong>tls::debug<
8050: 2f 73 74 72 6f 6e 67 3e 20 76 61 72 69 61 62 6c /strong> variabl
8060: 65 20 70 72 6f 76 69 64 65 73 20 73 6f 6d 65 20 e provides some
8070: 61 64 64 69 74 69 6f 6e 61 6c 0a 63 6f 6e 74 72 additional.contr
8080: 6f 6c 20 6f 76 65 72 20 74 68 65 73 65 20 72 65 ol over these re
8090: 66 65 72 65 6e 63 65 20 63 61 6c 6c 62 61 63 6b ference callback
80a0: 73 2e 20 20 49 74 73 20 76 61 6c 75 65 20 69 73 s. Its value is
80b0: 20 7a 65 72 6f 20 62 79 20 64 65 66 61 75 6c 74 zero by default
80c0: 2e 0a 48 69 67 68 65 72 20 76 61 6c 75 65 73 20 ..Higher values
80d0: 70 72 6f 64 75 63 65 20 6d 6f 72 65 20 64 69 61 produce more dia
80e0: 67 6e 6f 73 74 69 63 20 6f 75 74 70 75 74 2c 20 gnostic output,
80f0: 61 6e 64 20 77 69 6c 6c 20 61 6c 73 6f 20 66 6f and will also fo
8100: 72 63 65 20 74 68 65 0a 76 65 72 69 66 79 20 6d rce the.verify m
8110: 65 74 68 6f 64 20 69 6e 20 3c 73 74 72 6f 6e 67 ethod in <strong
8120: 3e 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 3c 2f >tls::callback</
8130: 73 74 72 6f 6e 67 3e 20 74 6f 20 61 63 63 65 70 strong> to accep
8140: 74 20 74 68 65 0a 63 65 72 74 69 66 69 63 61 74 t the.certificat
8150: 65 2c 20 65 76 65 6e 20 77 68 65 6e 20 69 74 20 e, even when it
8160: 69 73 20 69 6e 76 61 6c 69 64 2e 0a 3c 2f 70 3e is invalid..</p>
8170: 0a 0a 3c 70 3e 0a 3c 65 6d 3e 0a 54 68 65 20 75 ..<p>.<em>.The u
8180: 73 65 20 6f 66 20 74 68 65 20 72 65 66 65 72 65 se of the refere
8190: 6e 63 65 20 63 61 6c 6c 62 61 63 6b 73 20 3c 73 nce callbacks <s
81a0: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 61 6c 6c 62 trong>tls::callb
81b0: 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 2c 0a 3c 73 ack</strong>,.<s
81c0: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 61 73 73 77 trong>tls::passw
81d0: 6f 72 64 3c 2f 73 74 72 6f 6e 67 3e 2c 20 61 6e ord</strong>, an
81e0: 64 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 76 d <strong>tls::v
81f0: 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 3c alidate_command<
8200: 2f 73 74 72 6f 6e 67 3e 0a 69 73 20 6e 6f 74 20 /strong>.is not
8210: 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 20 20 54 68 recommended. Th
8220: 65 79 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 ey may be remove
8230: 64 20 66 72 6f 6d 20 66 75 74 75 72 65 20 72 65 d from future re
8240: 6c 65 61 73 65 73 2e 0a 3c 2f 65 6d 3e 0a 3c 2f leases..</em>.</
8250: 70 3e 0a 0a 3c 70 3e 0a 3c 65 6d 3e 0a 54 68 65 p>..<p>.<em>.The
8260: 20 75 73 65 20 6f 66 20 74 68 65 20 76 61 72 69 use of the vari
8270: 61 62 6c 65 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 able <strong>tls
8280: 3a 3a 64 65 62 75 67 3c 2f 73 74 72 6f 6e 67 3e ::debug</strong>
8290: 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e is not recommen
82a0: 64 65 64 2e 0a 49 74 20 6d 61 79 20 62 65 20 72 ded..It may be r
82b0: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 66 75 74 75 emoved from futu
82c0: 72 65 20 72 65 6c 65 61 73 65 73 2e 0a 3c 2f 65 re releases..</e
82d0: 6d 3e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 20 m>.</p>..<h3><a
82e0: 6e 61 6d 65 3d 22 44 45 42 55 47 22 3e 44 45 42 name="DEBUG">DEB
82f0: 55 47 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 54 4c 53 UG</a></h3>..TLS
8300: 20 6b 65 79 20 6c 6f 67 67 69 6e 67 20 63 61 6e key logging can
8310: 20 62 65 20 65 6e 61 62 6c 65 64 20 62 79 20 73 be enabled by s
8320: 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 69 72 etting the envir
8330: 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 0a onment variable.
8340: 3c 62 3e 53 53 4c 4b 45 59 4c 4f 47 46 49 4c 45 <b>SSLKEYLOGFILE
8350: 3c 2f 62 3e 20 74 6f 20 74 68 65 20 6e 61 6d 65 </b> to the name
8360: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 6f 20 of the file to
8370: 6c 6f 67 20 74 6f 2e 20 54 68 65 6e 20 77 68 65 log to. Then whe
8380: 6e 65 76 65 72 20 54 4c 53 0a 6b 65 79 20 6d 61 never TLS.key ma
8390: 74 65 72 69 61 6c 20 69 73 20 67 65 6e 65 72 61 terial is genera
83a0: 74 65 64 20 6f 72 20 72 65 63 65 69 76 65 64 20 ted or received
83b0: 69 74 20 77 69 6c 6c 20 62 65 20 6c 6f 67 67 65 it will be logge
83c0: 64 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 54 d to the file. T
83d0: 68 69 73 0a 69 73 20 75 73 65 66 75 6c 20 66 6f his.is useful fo
83e0: 72 20 6c 6f 67 67 69 6e 67 20 6b 65 79 20 64 61 r logging key da
83f0: 74 61 20 66 6f 72 20 6e 65 74 77 6f 72 6b 20 6c ta for network l
8400: 6f 67 67 69 6e 67 20 74 6f 6f 6c 73 20 74 6f 20 ogging tools to
8410: 75 73 65 20 74 6f 0a 64 65 63 72 79 70 74 20 74 use to.decrypt t
8420: 68 65 20 64 61 74 61 2e 0a 0a 3c 68 33 3e 3c 61 he data...<h3><a
8430: 20 6e 61 6d 65 3d 22 48 54 54 50 53 20 45 58 41 name="HTTPS EXA
8440: 4d 50 4c 45 22 3e 48 54 54 50 53 20 45 58 41 4d MPLE">HTTPS EXAM
8450: 50 4c 45 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 PLE</a></h3>..<p
8460: 3e 54 68 69 73 20 65 78 61 6d 70 6c 65 20 75 73 >This example us
8470: 65 73 20 61 20 73 61 6d 70 6c 65 20 73 65 72 76 es a sample serv
8480: 65 72 2e 70 65 6d 20 70 72 6f 76 69 64 65 64 20 er.pem provided
8490: 77 69 74 68 20 74 68 65 20 54 4c 53 20 72 65 6c with the TLS rel
84a0: 65 61 73 65 2c 0a 63 6f 75 72 74 65 73 79 20 6f ease,.courtesy o
84b0: 66 20 74 68 65 20 3c 73 74 72 6f 6e 67 3e 4f 70 f the <strong>Op
84c0: 65 6e 53 53 4c 3c 2f 73 74 72 6f 6e 67 3e 20 70 enSSL</strong> p
84d0: 72 6f 6a 65 63 74 2e 3c 2f 70 3e 0a 0a 3c 70 72 roject.</p>..<pr
84e0: 65 3e 3c 63 6f 64 65 3e 0a 70 61 63 6b 61 67 65 e><code>.package
84f0: 20 72 65 71 75 69 72 65 20 68 74 74 70 0a 70 61 require http.pa
8500: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 6c ckage require tl
8510: 73 0a 0a 68 74 74 70 3a 3a 72 65 67 69 73 74 65 s..http::registe
8520: 72 20 68 74 74 70 73 20 34 34 33 20 5b 6c 69 73 r https 443 [lis
8530: 74 20 3a 3a 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 t ::tls::socket
8540: 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 6d 65 20 -autoservername
8550: 74 72 75 65 20 2d 72 65 71 75 69 72 65 20 74 72 true -require tr
8560: 75 65 20 2d 63 61 64 69 72 20 2f 65 74 63 2f 73 ue -cadir /etc/s
8570: 73 6c 2f 63 65 72 74 73 5d 0a 0a 73 65 74 20 74 sl/certs]..set t
8580: 6f 6b 20 5b 68 74 74 70 3a 3a 67 65 74 75 72 6c ok [http::geturl
8590: 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 74 63 6c https://www.tcl
85a0: 2e 74 6b 2f 5d 0a 3c 2f 63 6f 64 65 3e 3c 2f 70 .tk/].</code></p
85b0: 72 65 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 re>..<h3><a name
85c0: 3d 22 53 50 45 43 49 41 4c 20 43 4f 4e 53 49 44 ="SPECIAL CONSID
85d0: 45 52 41 54 49 4f 4e 53 22 3e 53 50 45 43 49 41 ERATIONS">SPECIA
85e0: 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e 53 L CONSIDERATIONS
85f0: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 </a></h3>..<p>Th
8600: 65 20 63 61 70 61 62 69 6c 69 74 69 65 73 20 6f e capabilities o
8610: 66 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 63 f this package c
8620: 61 6e 20 76 61 72 79 20 65 6e 6f 72 6d 6f 75 73 an vary enormous
8630: 6c 79 20 62 61 73 65 64 20 75 70 6f 6e 20 68 6f ly based upon ho
8640: 77 20 79 6f 75 72 0a 4f 70 65 6e 53 53 4c 20 6c w your.OpenSSL l
8650: 69 62 72 61 72 79 20 77 61 73 20 63 6f 6e 66 69 ibrary was confi
8660: 67 75 72 65 64 20 61 6e 64 20 62 75 69 6c 74 2e gured and built.
8670: 20 4e 65 77 20 76 65 72 73 69 6f 6e 73 20 6d 61 New versions ma
8680: 79 20 6f 62 73 6f 6c 65 74 65 20 6f 6c 64 65 72 y obsolete older
8690: 0a 70 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f .protocol versio
86a0: 6e 73 2c 20 61 64 64 20 6f 72 20 72 65 6d 6f 76 ns, add or remov
86b0: 65 20 63 69 70 68 65 72 73 2c 20 63 68 61 6e 67 e ciphers, chang
86c0: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 e default values
86d0: 2c 20 65 74 63 2e 20 55 73 65 20 74 68 65 0a 3c , etc. Use the.<
86e0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 69 70 68 strong>tls::ciph
86f0: 65 72 73 3c 2f 73 74 72 6f 6e 67 3e 20 61 6e 64 ers</strong> and
8700: 20 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 72 <strong>tls::pr
8710: 6f 74 6f 63 6f 6c 73 3c 2f 73 74 72 6f 6e 67 3e otocols</strong>
8720: 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 6f 62 74 commands to.obt
8730: 61 69 6e 20 74 68 65 20 73 75 70 70 6f 72 74 65 ain the supporte
8740: 64 20 76 65 72 73 69 6f 6e 73 2e 3c 2f 70 3e 0a d versions.</p>.
8750: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 45 .<h3><a name="SE
8760: 45 20 41 4c 53 4f 22 3e 53 45 45 20 41 4c 53 4f E ALSO">SEE ALSO
8770: 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 73 </a></h3>..<p><s
8780: 74 72 6f 6e 67 3e 73 6f 63 6b 65 74 3c 2f 73 74 trong>socket</st
8790: 72 6f 6e 67 3e 2c 20 3c 73 74 72 6f 6e 67 3e 66 rong>, <strong>f
87a0: 69 6c 65 65 76 65 6e 74 2c 20 3c 2f 73 74 72 6f ileevent, </stro
87b0: 6e 67 3e 3c 61 0a 68 72 65 66 3d 22 68 74 74 70 ng><a.href="http
87c0: 3a 2f 2f 77 77 77 2e 6f 70 65 6e 73 73 6c 2e 6f ://www.openssl.o
87d0: 72 67 2f 22 3e 3c 73 74 72 6f 6e 67 3e 4f 70 65 rg/"><strong>Ope
87e0: 6e 53 53 4c 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 nSSL</strong></a
87f0: 3e 3c 2f 70 3e 0a 0a 3c 68 72 3e 0a 0a 3c 70 72 ></p>..<hr>..<pr
8800: 65 3e 0a 43 6f 70 79 72 69 67 68 74 20 26 63 6f e>.Copyright &co
8810: 70 79 3b 20 31 39 39 39 20 4d 61 74 74 20 4e 65 py; 1999 Matt Ne
8820: 77 6d 61 6e 2e 0a 43 6f 70 79 72 69 67 68 74 20 wman..Copyright
8830: 26 63 6f 70 79 3b 20 32 30 30 34 20 53 74 61 72 © 2004 Star
8840: 66 69 73 68 20 53 79 73 74 65 6d 73 2e 0a 3c 2f fish Systems..</
8850: 70 72 65 3e 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 pre>.</body>.</h
8860: 74 6d 6c 3e 0a tml>.