0000: 44 20 32 30 32 36 2d 30 31 2d 32 31 54 30 34 3a D 2026-01-21T04:
0010: 33 36 3a 33 39 2e 35 34 35 0a 4c 20 44 6f 63 75 36:39.545.L Docu
0020: 6d 65 6e 74 61 74 69 6f 6e 0a 50 20 32 35 65 36 mentation.P 25e6
0030: 34 30 33 35 36 63 34 65 61 62 36 37 36 33 33 32 40356c4eab676332
0040: 31 66 32 35 33 33 36 63 64 63 30 35 39 63 36 37 1f25336cdc059c67
0050: 63 37 34 39 65 61 66 37 66 36 38 38 39 65 30 38 c749eaf7f6889e08
0060: 65 32 63 65 38 36 38 35 62 61 63 38 0a 55 20 62 e2ce8685bac8.U b
0070: 6f 68 61 67 61 6e 0a 57 20 35 36 34 33 32 0a 3c ohagan.W 56432.<
0080: 74 69 74 6c 65 3e 74 6c 73 20 2d 20 54 63 6c 20 title>tls - Tcl
0090: 54 4c 53 20 65 78 74 65 6e 73 69 6f 6e 3c 2f 74 TLS extension</t
00a0: 69 74 6c 65 3e 0d 0a 0d 0a 3c 68 31 20 63 6c 61 itle>....<h1 cla
00b0: 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 74 69 74 ss="doctools_tit
00c0: 6c 65 22 3e 74 6c 73 28 6e 29 20 32 2e 30 20 74 le">tls(n) 2.0 t
00d0: 6c 73 20 26 71 75 6f 74 3b 54 63 6c 20 54 4c 53 ls "Tcl TLS
00e0: 20 65 78 74 65 6e 73 69 6f 6e 26 71 75 6f 74 3b extension"
00f0: 3c 2f 68 31 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 </h1>..<div id="
0100: 6e 61 6d 65 22 20 63 6c 61 73 73 3d 22 64 6f 63 name" class="doc
0110: 74 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e 22 3e 3c tools_section"><
0120: 68 32 3e 3c 61 20 6e 61 6d 65 3d 22 6e 61 6d 65 h2><a name="name
0130: 22 3e 4e 61 6d 65 3c 2f 61 3e 3c 2f 68 32 3e 0d ">Name</a></h2>.
0140: 0a 3c 70 3e 74 6c 73 20 2d 20 62 69 6e 64 69 6e .<p>tls - bindin
0150: 67 20 74 6f 20 74 68 65 20 4f 70 65 6e 53 53 4c g to the OpenSSL
0160: 20 6c 69 62 72 61 72 79 20 66 6f 72 20 65 6e 63 library for enc
0170: 72 79 70 74 65 64 20 73 6f 63 6b 65 74 20 61 6e rypted socket an
0180: 64 20 49 2f 4f 20 63 68 61 6e 6e 65 6c 20 63 6f d I/O channel co
0190: 6d 6d 75 6e 69 63 61 74 69 6f 6e 73 3c 2f 70 3e mmunications</p>
01a0: 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 ..</div>..<div i
01b0: 64 3d 22 74 6f 63 22 20 63 6c 61 73 73 3d 22 64 d="toc" class="d
01c0: 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e 22 octools_section"
01d0: 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 3d 22 74 6f ><h2><a name="to
01e0: 63 22 3e 54 61 62 6c 65 20 4f 66 20 43 6f 6e 74 c">Table Of Cont
01f0: 65 6e 74 73 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a 3c ents</a></h2>..<
0200: 75 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f ul class="doctoo
0210: 6c 73 5f 74 6f 63 22 3e 0d 0a 3c 6c 69 20 63 6c ls_toc">..<li cl
0220: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
0230: 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 ction"><a href="
0240: 23 74 6f 63 22 3e 54 61 62 6c 65 20 4f 66 20 43 #toc">Table Of C
0250: 6f 6e 74 65 6e 74 73 3c 2f 61 3e 3c 2f 6c 69 3e ontents</a></li>
0260: 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 6f 63 ..<li class="doc
0270: 74 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e 22 3e 3c tools_section"><
0280: 61 20 68 72 65 66 3d 22 23 73 79 6e 6f 70 73 69 a href="#synopsi
0290: 73 22 3e 53 79 6e 6f 70 73 69 73 3c 2f 61 3e 3c s">Synopsis</a><
02a0: 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d /li>..<li class=
02b0: 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f "doctools_sectio
02c0: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 n"><a href="#sec
02d0: 74 69 6f 6e 31 22 3e 44 65 73 63 72 69 70 74 69 tion1">Descripti
02e0: 6f 6e 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 on</a></li>..<li
02f0: 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 class="doctools
0300: 5f 73 65 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 _section"><a hre
0310: 66 3d 22 23 73 65 63 74 69 6f 6e 32 22 3e 43 6f f="#section2">Co
0320: 6d 70 61 74 69 62 69 6c 69 74 79 3c 2f 61 3e 3c mpatibility</a><
0330: 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d /li>..<li class=
0340: 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f "doctools_sectio
0350: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 n"><a href="#sec
0360: 74 69 6f 6e 33 22 3e 43 6f 6d 6d 61 6e 64 73 3c tion3">Commands<
0370: 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c /a></li>..<li cl
0380: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
0390: 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 ction"><a href="
03a0: 23 73 65 63 74 69 6f 6e 34 22 3e 43 65 72 74 69 #section4">Certi
03b0: 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 6f ficate Validatio
03c0: 6e 3c 2f 61 3e 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 n</a>..<ul>..<li
03d0: 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 class="doctools
03e0: 5f 73 75 62 73 65 63 74 69 6f 6e 22 3e 3c 61 20 _subsection"><a
03f0: 68 72 65 66 3d 22 23 73 75 62 73 65 63 74 69 6f href="#subsectio
0400: 6e 31 22 3e 50 4b 49 20 61 6e 64 20 43 65 72 74 n1">PKI and Cert
0410: 69 66 69 63 61 74 65 73 3c 2f 61 3e 3c 2f 6c 69 ificates</a></li
0420: 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 6f >..<li class="do
0430: 63 74 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 6f ctools_subsectio
0440: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 75 62 n"><a href="#sub
0450: 73 65 63 74 69 6f 6e 32 22 3e 53 75 6d 6d 61 72 section2">Summar
0460: 79 20 6f 66 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e y of command lin
0470: 65 20 6f 70 74 69 6f 6e 73 3c 2f 61 3e 3c 2f 6c e options</a></l
0480: 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 i>..<li class="d
0490: 6f 63 74 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 octools_subsecti
04a0: 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 75 on"><a href="#su
04b0: 62 73 65 63 74 69 6f 6e 33 22 3e 57 68 65 6e 20 bsection3">When
04c0: 61 72 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 are command line
04d0: 20 6f 70 74 69 6f 6e 73 20 6e 65 65 64 65 64 3f options needed?
04e0: 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e </a></li>..</ul>
04f0: 0d 0a 3c 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 ..</li>..<li cla
0500: 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 ss="doctools_sec
0510: 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 tion"><a href="#
0520: 73 65 63 74 69 6f 6e 35 22 3e 43 61 6c 6c 62 61 section5">Callba
0530: 63 6b 20 4f 70 74 69 6f 6e 73 3c 2f 61 3e 0d 0a ck Options</a>..
0540: 3c 75 6c 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d <ul>..<li class=
0550: 22 64 6f 63 74 6f 6f 6c 73 5f 73 75 62 73 65 63 "doctools_subsec
0560: 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 tion"><a href="#
0570: 73 75 62 73 65 63 74 69 6f 6e 34 22 3e 56 61 6c subsection4">Val
0580: 75 65 73 20 66 6f 72 20 43 6f 6d 6d 61 6e 64 20 ues for Command
0590: 43 61 6c 6c 62 61 63 6b 3c 2f 61 3e 3c 2f 6c 69 Callback</a></li
05a0: 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 6f >..<li class="do
05b0: 63 74 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 6f ctools_subsectio
05c0: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 75 62 n"><a href="#sub
05d0: 73 65 63 74 69 6f 6e 35 22 3e 56 61 6c 75 65 73 section5">Values
05e0: 20 66 6f 72 20 50 61 73 73 77 6f 72 64 20 43 61 for Password Ca
05f0: 6c 6c 62 61 63 6b 3c 2f 61 3e 3c 2f 6c 69 3e 0d llback</a></li>.
0600: 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 6f 63 74 .<li class="doct
0610: 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 6f 6e 22 ools_subsection"
0620: 3e 3c 61 20 68 72 65 66 3d 22 23 73 75 62 73 65 ><a href="#subse
0630: 63 74 69 6f 6e 36 22 3e 56 61 6c 75 65 73 20 66 ction6">Values f
0640: 6f 72 20 56 61 6c 69 64 61 74 65 20 43 6f 6d 6d or Validate Comm
0650: 61 6e 64 20 43 61 6c 6c 62 61 63 6b 3c 2f 61 3e and Callback</a>
0660: 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f </li>..</ul>..</
0670: 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 li>..<li class="
0680: 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e doctools_section
0690: 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 "><a href="#sect
06a0: 69 6f 6e 36 22 3e 44 65 62 75 67 3c 2f 61 3e 3c ion6">Debug</a><
06b0: 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d /li>..<li class=
06c0: 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f "doctools_sectio
06d0: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 n"><a href="#sec
06e0: 74 69 6f 6e 37 22 3e 45 78 61 6d 70 6c 65 73 3c tion7">Examples<
06f0: 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c /a></li>..<li cl
0700: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
0710: 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 ction"><a href="
0720: 23 73 65 63 74 69 6f 6e 38 22 3e 53 70 65 63 69 #section8">Speci
0730: 61 6c 20 43 6f 6e 73 69 64 65 72 61 74 69 6f 6e al Consideration
0740: 73 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 20 s</a></li>..<li
0750: 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f class="doctools_
0760: 73 65 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 section"><a href
0770: 3d 22 23 73 65 63 74 69 6f 6e 39 22 3e 45 72 72 ="#section9">Err
0780: 6f 72 20 4d 65 73 73 61 67 65 73 3c 2f 61 3e 3c or Messages</a><
0790: 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d /li>..<li class=
07a0: 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f "doctools_sectio
07b0: 6e 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 65 n"><a href="#see
07c0: 2d 61 6c 73 6f 22 3e 53 65 65 20 41 6c 73 6f 3c -also">See Also<
07d0: 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 20 63 6c /a></li>..<li cl
07e0: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
07f0: 63 74 69 6f 6e 22 3e 3c 61 20 68 72 65 66 3d 22 ction"><a href="
0800: 23 6b 65 79 77 6f 72 64 73 22 3e 4b 65 79 77 6f #keywords">Keywo
0810: 72 64 73 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c rds</a></li>..<l
0820: 69 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c i class="doctool
0830: 73 5f 73 65 63 74 69 6f 6e 22 3e 3c 61 20 68 72 s_section"><a hr
0840: 65 66 3d 22 23 63 61 74 65 67 6f 72 79 22 3e 43 ef="#category">C
0850: 61 74 65 67 6f 72 79 3c 2f 61 3e 3c 2f 6c 69 3e ategory</a></li>
0860: 0d 0a 3c 6c 69 20 63 6c 61 73 73 3d 22 64 6f 63 ..<li class="doc
0870: 74 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e 22 3e 3c tools_section"><
0880: 61 20 68 72 65 66 3d 22 23 63 6f 70 79 72 69 67 a href="#copyrig
0890: 68 74 22 3e 43 6f 70 79 72 69 67 68 74 3c 2f 61 ht">Copyright</a
08a0: 3e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c ></li>..</ul>..<
08b0: 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 /div>..<div id="
08c0: 73 79 6e 6f 70 73 69 73 22 20 63 6c 61 73 73 3d synopsis" class=
08d0: 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 6f "doctools_sectio
08e0: 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 3d 22 n"><h2><a name="
08f0: 73 79 6e 6f 70 73 69 73 22 3e 53 79 6e 6f 70 73 synopsis">Synops
0900: 69 73 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a 3c 64 69 is</a></h2>..<di
0910: 76 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c v class="doctool
0920: 73 5f 73 79 6e 6f 70 73 69 73 22 3e 0d 0a 3c 75 s_synopsis">..<u
0930: 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c l class="doctool
0940: 73 5f 72 65 71 75 69 72 65 6d 65 6e 74 73 22 3e s_requirements">
0950: 0d 0a 3c 6c 69 3e 70 61 63 6b 61 67 65 20 72 65 ..<li>package re
0960: 71 75 69 72 65 20 3c 62 20 63 6c 61 73 73 3d 22 quire <b class="
0970: 70 6b 67 6e 61 6d 65 22 3e 54 63 6c 20 38 2e 35 pkgname">Tcl 8.5
0980: 2d 3c 2f 62 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e -</b></li>..<li>
0990: 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 package require
09a0: 3c 62 20 63 6c 61 73 73 3d 22 70 6b 67 6e 61 6d <b class="pkgnam
09b0: 65 22 3e 74 6c 73 20 32 2e 30 3c 2f 62 3e 3c 2f e">tls 2.0</b></
09c0: 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 75 6c 20 li>..</ul>..<ul
09d0: 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f class="doctools_
09e0: 73 79 6e 74 61 78 22 3e 0d 0a 3c 6c 69 3e 3c 61 syntax">..<li><a
09f0: 20 68 72 65 66 3d 22 23 31 22 3e 3c 62 20 63 6c href="#1"><b cl
0a00: 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 69 ass="cmd">tls::i
0a10: 6e 69 74 3c 2f 62 3e 20 3c 73 70 61 6e 20 63 6c nit</b> <span cl
0a20: 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c ass="opt">?<i cl
0a30: 61 73 73 3d 22 61 72 67 22 3e 2d 6f 70 74 69 6f ass="arg">-optio
0a40: 6e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 n</i>?</span> <s
0a50: 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e pan class="opt">
0a60: 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e ?<i class="arg">
0a70: 76 61 6c 75 65 3c 2f 69 3e 3f 3c 2f 73 70 61 6e value</i>?</span
0a80: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
0a90: 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 pt">?<i class="a
0aa0: 72 67 22 3e 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 rg">-option valu
0ab0: 65 20 2e 2e 2e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e e ...</i>?</span
0ac0: 3e 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e ></a></li>..<li>
0ad0: 3c 61 20 68 72 65 66 3d 22 23 32 22 3e 3c 62 20 <a href="#2"><b
0ae0: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
0af0: 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 3c 73 70 61 :socket</b> <spa
0b00: 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c n class="opt">?<
0b10: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f i class="arg">-o
0b20: 70 74 69 6f 6e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e ption</i>?</span
0b30: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
0b40: 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 pt">?<i class="a
0b50: 72 67 22 3e 76 61 6c 75 65 3c 2f 69 3e 3f 3c 2f rg">value</i>?</
0b60: 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 73 span> <span clas
0b70: 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 s="opt">?<i clas
0b80: 73 3d 22 61 72 67 22 3e 2d 6f 70 74 69 6f 6e 20 s="arg">-option
0b90: 76 61 6c 75 65 20 2e 2e 2e 3c 2f 69 3e 3f 3c 2f value ...</i>?</
0ba0: 73 70 61 6e 3e 20 3c 69 20 63 6c 61 73 73 3d 22 span> <i class="
0bb0: 61 72 67 22 3e 68 6f 73 74 3c 2f 69 3e 20 3c 69 arg">host</i> <i
0bc0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 70 6f 72 class="arg">por
0bd0: 74 3c 2f 69 3e 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a t</i></a></li>..
0be0: 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 22 23 33 22 <li><a href="#3"
0bf0: 3e 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e ><b class="cmd">
0c00: 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 tls::socket</b>
0c10: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
0c20: 22 3e 2d 73 65 72 76 65 72 3c 2f 62 3e 20 3c 69 ">-server</b> <i
0c30: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 6f 6d class="arg">com
0c40: 6d 61 6e 64 3c 2f 69 3e 20 3c 73 70 61 6e 20 63 mand</i> <span c
0c50: 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 lass="opt">?<i c
0c60: 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f 70 74 69 lass="arg">-opti
0c70: 6f 6e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c on</i>?</span> <
0c80: 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 span class="opt"
0c90: 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 >?<i class="arg"
0ca0: 3e 76 61 6c 75 65 3c 2f 69 3e 3f 3c 2f 73 70 61 >value</i>?</spa
0cb0: 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 n> <span class="
0cc0: 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 opt">?<i class="
0cd0: 61 72 67 22 3e 2d 6f 70 74 69 6f 6e 20 76 61 6c arg">-option val
0ce0: 75 65 20 2e 2e 2e 3c 2f 69 3e 3f 3c 2f 73 70 61 ue ...</i>?</spa
0cf0: 6e 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 n> <i class="arg
0d00: 22 3e 70 6f 72 74 3c 2f 69 3e 3c 2f 61 3e 3c 2f ">port</i></a></
0d10: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 li>..<li><a href
0d20: 3d 22 23 34 22 3e 3c 62 20 63 6c 61 73 73 3d 22 ="#4"><b class="
0d30: 63 6d 64 22 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 cmd">tls::import
0d40: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
0d50: 72 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f 69 3e 20 rg">channel</i>
0d60: 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 <span class="opt
0d70: 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 ">?<i class="arg
0d80: 22 3e 2d 6f 70 74 69 6f 6e 3c 2f 69 3e 3f 3c 2f ">-option</i>?</
0d90: 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 73 span> <span clas
0da0: 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 s="opt">?<i clas
0db0: 73 3d 22 61 72 67 22 3e 76 61 6c 75 65 3c 2f 69 s="arg">value</i
0dc0: 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 >?</span> <span
0dd0: 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 class="opt">?<i
0de0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f 70 74 class="arg">-opt
0df0: 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 3c 2f 69 ion value ...</i
0e00: 3e 3f 3c 2f 73 70 61 6e 3e 3c 2f 61 3e 3c 2f 6c >?</span></a></l
0e10: 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d i>..<li><a href=
0e20: 22 23 35 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 "#5"><b class="c
0e30: 6d 64 22 3e 74 6c 73 3a 3a 73 74 61 72 74 74 6c md">tls::starttl
0e40: 73 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 s</b> <i class="
0e50: 61 72 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f 69 3e arg">channel</i>
0e60: 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 <span class="op
0e70: 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 t">?<i class="ar
0e80: 67 22 3e 2d 6f 70 74 69 6f 6e 3c 2f 69 3e 3f 3c g">-option</i>?<
0e90: 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 /span> <span cla
0ea0: 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 ss="opt">?<i cla
0eb0: 73 73 3d 22 61 72 67 22 3e 76 61 6c 75 65 3c 2f ss="arg">value</
0ec0: 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e i>?</span> <span
0ed0: 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 class="opt">?<i
0ee0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f 70 class="arg">-op
0ef0: 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 3c 2f tion value ...</
0f00: 69 3e 3f 3c 2f 73 70 61 6e 3e 3c 2f 61 3e 3c 2f i>?</span></a></
0f10: 6c 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 li>..<li><a href
0f20: 3d 22 23 36 22 3e 3c 62 20 63 6c 61 73 73 3d 22 ="#6"><b class="
0f30: 63 6d 64 22 3e 74 6c 73 3a 3a 68 61 6e 64 73 68 cmd">tls::handsh
0f40: 61 6b 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ake</b> <i class
0f50: 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f ="arg">channel</
0f60: 69 3e 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 i></a></li>..<li
0f70: 3e 3c 61 20 68 72 65 66 3d 22 23 37 22 3e 3c 62 ><a href="#7"><b
0f80: 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 class="cmd">tls
0f90: 3a 3a 73 68 75 74 64 6f 77 6e 3c 2f 62 3e 20 3c ::shutdown</b> <
0fa0: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 i class="arg">ch
0fb0: 61 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 6c annel</i></a></l
0fc0: 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d i>..<li><a href=
0fd0: 22 23 38 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 "#8"><b class="c
0fe0: 6d 64 22 3e 74 6c 73 3a 3a 75 6e 69 6d 70 6f 72 md">tls::unimpor
0ff0: 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 t</b> <i class="
1000: 61 72 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f 69 3e arg">channel</i>
1010: 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c </a></li>..<li><
1020: 61 20 68 72 65 66 3d 22 23 39 22 3e 3c 62 20 63 a href="#9"><b c
1030: 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a lass="cmd">tls::
1040: 75 6e 73 74 61 63 6b 3c 2f 62 3e 20 3c 69 20 63 unstack</b> <i c
1050: 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e lass="arg">chann
1060: 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 6c 69 3e 0d el</i></a></li>.
1070: 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 22 23 31 .<li><a href="#1
1080: 30 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 0"><b class="cmd
1090: 22 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 62 ">tls::status</b
10a0: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
10b0: 70 74 22 3e 3f 3c 62 20 63 6c 61 73 73 3d 22 6f pt">?<b class="o
10c0: 70 74 69 6f 6e 22 3e 2d 6c 6f 63 61 6c 3c 2f 62 ption">-local</b
10d0: 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 69 20 63 6c 61 >?</span> <i cla
10e0: 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 6c ss="arg">channel
10f0: 3c 2f 69 3e 3c 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c </i></a></li>..<
1100: 6c 69 3e 3c 61 20 68 72 65 66 3d 22 23 31 31 22 li><a href="#11"
1110: 3e 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e ><b class="cmd">
1120: 74 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 3c tls::connection<
1130: 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 /b> <i class="ar
1140: 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f 69 3e 3c 2f g">channel</i></
1150: 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 a></li>..<li><a
1160: 68 72 65 66 3d 22 23 31 32 22 3e 3c 62 20 63 6c href="#12"><b cl
1170: 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 63 ass="cmd">tls::c
1180: 69 70 68 65 72 73 3c 2f 62 3e 20 3c 73 70 61 6e iphers</b> <span
1190: 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 class="opt">?<i
11a0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 70 72 6f class="arg">pro
11b0: 74 6f 63 6f 6c 3c 2f 69 3e 3f 3c 2f 73 70 61 6e tocol</i>?</span
11c0: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
11d0: 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 pt">?<i class="a
11e0: 72 67 22 3e 76 65 72 62 6f 73 65 3c 2f 69 3e 3f rg">verbose</i>?
11f0: 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c </span> <span cl
1200: 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c ass="opt">?<i cl
1210: 61 73 73 3d 22 61 72 67 22 3e 73 75 70 70 6f 72 ass="arg">suppor
1220: 74 65 64 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 3c ted</i>?</span><
1230: 2f 61 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 61 /a></li>..<li><a
1240: 20 68 72 65 66 3d 22 23 31 33 22 3e 3c 62 20 63 href="#13"><b c
1250: 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a lass="cmd">tls::
1260: 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c 2f 61 protocols</b></a
1270: 3e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 3c 61 20 68 ></li>..<li><a h
1280: 72 65 66 3d 22 23 31 34 22 3e 3c 62 20 63 6c 61 ref="#14"><b cla
1290: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 76 65 ss="cmd">tls::ve
12a0: 72 73 69 6f 6e 3c 2f 62 3e 3c 2f 61 3e 3c 2f 6c rsion</b></a></l
12b0: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 64 69 76 i>..</ul>..</div
12c0: 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 >..</div>..<div
12d0: 69 64 3d 22 73 65 63 74 69 6f 6e 31 22 20 63 6c id="section1" cl
12e0: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
12f0: 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 ction"><h2><a na
1300: 6d 65 3d 22 73 65 63 74 69 6f 6e 31 22 3e 44 65 me="section1">De
1310: 73 63 72 69 70 74 69 6f 6e 3c 2f 61 3e 3c 2f 68 scription</a></h
1320: 32 3e 0d 0a 3c 70 3e 54 68 69 73 20 65 78 74 65 2>..<p>This exte
1330: 6e 73 69 6f 6e 20 70 72 6f 76 69 64 65 73 20 54 nsion provides T
1340: 43 4c 20 73 63 72 69 70 74 20 61 63 63 65 73 73 CL script access
1350: 20 74 6f 20 53 65 63 75 72 65 20 53 6f 63 6b 65 to Secure Socke
1360: 74 20 4c 61 79 65 72 20 28 53 53 4c 29 0d 0a 63 t Layer (SSL)..c
1370: 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 73 20 75 73 ommunications us
1380: 69 6e 67 20 74 68 65 20 54 72 61 6e 73 70 6f 72 ing the Transpor
1390: 74 20 4c 61 79 65 72 20 53 65 63 75 72 69 74 79 t Layer Security
13a0: 20 28 54 4c 53 29 20 70 72 6f 74 6f 63 6f 6c 2e (TLS) protocol.
13b0: 20 49 74 20 70 72 6f 76 69 64 65 73 20 61 0d 0a It provides a..
13c0: 67 65 6e 65 72 69 63 20 62 69 6e 64 69 6e 67 20 generic binding
13d0: 74 6f 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 to <a href="http
13e0: 73 3a 2f 2f 77 77 77 2e 6f 70 65 6e 73 73 6c 2e s://www.openssl.
13f0: 6f 72 67 2f 22 3e 4f 70 65 6e 53 53 4c 3c 2f 61 org/">OpenSSL</a
1400: 3e 2c 20 75 74 69 6c 69 7a 69 6e 67 20 74 68 65 >, utilizing the
1410: 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 73 79 73 63 ..<b class="sysc
1420: 6d 64 22 3e 54 63 6c 5f 53 74 61 63 6b 43 68 61 md">Tcl_StackCha
1430: 6e 6e 65 6c 3c 2f 62 3e 20 41 50 49 20 69 6e 20 nnel</b> API in
1440: 54 43 4c 20 38 2e 34 20 6f 72 20 6c 61 74 65 72 TCL 8.4 or later
1450: 2e 20 54 68 65 73 65 20 73 6f 63 6b 65 74 73 20 . These sockets
1460: 62 65 68 61 76 65 20 65 78 61 63 74 6c 79 0d 0a behave exactly..
1470: 74 68 65 20 73 61 6d 65 20 61 73 20 63 68 61 6e the same as chan
1480: 6e 65 6c 73 20 63 72 65 61 74 65 64 20 75 73 69 nels created usi
1490: 6e 67 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 ng the built-in
14a0: 3c 62 20 63 6c 61 73 73 3d 22 73 79 73 63 6d 64 <b class="syscmd
14b0: 22 3e 73 6f 63 6b 65 74 3c 2f 62 3e 20 63 6f 6d ">socket</b> com
14c0: 6d 61 6e 64 2c 20 62 75 74 0d 0a 70 72 6f 76 69 mand, but..provi
14d0: 64 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 70 de additional op
14e0: 74 69 6f 6e 73 20 66 6f 72 20 63 6f 6e 74 72 6f tions for contro
14f0: 6c 6c 69 6e 67 20 74 68 65 20 53 53 4c 2f 54 4c lling the SSL/TL
1500: 53 20 73 65 73 73 69 6f 6e 2e 3c 2f 70 3e 0d 0a S session.</p>..
1510: 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d </div>..<div id=
1520: 22 73 65 63 74 69 6f 6e 32 22 20 63 6c 61 73 73 "section2" class
1530: 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 ="doctools_secti
1540: 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 3d on"><h2><a name=
1550: 22 73 65 63 74 69 6f 6e 32 22 3e 43 6f 6d 70 61 "section2">Compa
1560: 74 69 62 69 6c 69 74 79 3c 2f 61 3e 3c 2f 68 32 tibility</a></h2
1570: 3e 0d 0a 3c 70 3e 54 68 69 73 20 65 78 74 65 6e >..<p>This exten
1580: 73 69 6f 6e 20 69 73 20 63 6f 6d 70 61 74 69 62 sion is compatib
1590: 6c 65 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 le with OpenSSL
15a0: 31 2e 31 2e 31 20 6f 72 20 6c 61 74 65 72 2e 20 1.1.1 or later.
15b0: 49 74 20 72 65 71 75 69 72 65 73 20 54 63 6c 0d It requires Tcl.
15c0: 0a 76 65 72 73 69 6f 6e 20 38 2e 35 20 6f 72 20 .version 8.5 or
15d0: 6c 61 74 65 72 20 61 6e 64 20 77 69 6c 6c 20 77 later and will w
15e0: 6f 72 6b 20 77 69 74 68 20 54 63 6c 20 39 2e 30 ork with Tcl 9.0
15f0: 2e 3c 2f 70 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c .</p>..</div>..<
1600: 64 69 76 20 69 64 3d 22 73 65 63 74 69 6f 6e 33 div id="section3
1610: 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c " class="doctool
1620: 73 5f 73 65 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c s_section"><h2><
1630: 61 20 6e 61 6d 65 3d 22 73 65 63 74 69 6f 6e 33 a name="section3
1640: 22 3e 43 6f 6d 6d 61 6e 64 73 3c 2f 61 3e 3c 2f ">Commands</a></
1650: 68 32 3e 0d 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c h2>..<p>The foll
1660: 6f 77 69 6e 67 20 61 72 65 20 74 68 65 20 63 6f owing are the co
1670: 6d 6d 61 6e 64 73 20 70 72 6f 76 69 64 65 64 20 mmands provided
1680: 62 79 20 74 68 65 20 54 63 4c 54 4c 53 20 70 61 by the TcLTLS pa
1690: 63 6b 61 67 65 2e 20 53 65 65 0d 0a 3c 73 70 61 ckage. See..<spa
16a0: 6e 20 63 6c 61 73 73 3d 22 73 65 63 74 72 65 66 n class="sectref
16b0: 22 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 "><a href="#sect
16c0: 69 6f 6e 37 22 3e 45 78 61 6d 70 6c 65 73 3c 2f ion7">Examples</
16d0: 61 3e 3c 2f 73 70 61 6e 3e 20 66 6f 72 20 65 78 a></span> for ex
16e0: 61 6d 70 6c 65 20 75 73 61 67 65 20 61 6e 64 20 ample usage and
16f0: 74 68 65 20 26 71 75 6f 74 3b 3c 62 20 63 6c 61 the "<b cla
1700: 73 73 3d 22 66 69 6c 65 22 3e 64 65 6d 6f 73 3c ss="file">demos<
1710: 2f 62 3e 26 71 75 6f 74 3b 20 64 69 72 65 63 74 /b>" direct
1720: 6f 72 79 20 66 6f 72 0d 0a 6d 6f 72 65 20 65 78 ory for..more ex
1730: 61 6d 70 6c 65 20 75 73 61 67 65 2e 3c 2f 70 3e ample usage.</p>
1740: 0d 0a 3c 64 6c 20 63 6c 61 73 73 3d 22 64 6f 63 ..<dl class="doc
1750: 74 6f 6f 6c 73 5f 64 65 66 69 6e 69 74 69 6f 6e tools_definition
1760: 73 22 3e 0d 0a 3c 64 74 3e 3c 61 20 6e 61 6d 65 s">..<dt><a name
1770: 3d 22 31 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 ="1"><b class="c
1780: 6d 64 22 3e 74 6c 73 3a 3a 69 6e 69 74 3c 2f 62 md">tls::init</b
1790: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
17a0: 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 pt">?<i class="a
17b0: 72 67 22 3e 2d 6f 70 74 69 6f 6e 3c 2f 69 3e 3f rg">-option</i>?
17c0: 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c </span> <span cl
17d0: 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c ass="opt">?<i cl
17e0: 61 73 73 3d 22 61 72 67 22 3e 76 61 6c 75 65 3c ass="arg">value<
17f0: 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 /i>?</span> <spa
1800: 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c n class="opt">?<
1810: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f i class="arg">-o
1820: 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 3c ption value ...<
1830: 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 3c 2f 61 3e 3c /i>?</span></a><
1840: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 4f 70 74 /dt>..<dd><p>Opt
1850: 69 6f 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 74 ional function t
1860: 6f 20 73 65 74 20 74 68 65 20 64 65 66 61 75 6c o set the defaul
1870: 74 20 6f 70 74 69 6f 6e 73 20 75 73 65 64 20 62 t options used b
1880: 79 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 y <b class="cmd"
1890: 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 3e >tls::socket</b>
18a0: 2e 20 49 66 20 79 6f 75 0d 0a 63 61 6c 6c 20 3c . If you..call <
18b0: 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c b class="cmd">tl
18c0: 73 3a 3a 69 6d 70 6f 72 74 3c 2f 62 3e 20 64 69 s::import</b> di
18d0: 72 65 63 74 6c 79 2c 20 74 68 65 20 76 61 6c 75 rectly, the valu
18e0: 65 73 20 73 65 74 20 62 79 20 74 68 69 73 20 63 es set by this c
18f0: 6f 6d 6d 61 6e 64 20 68 61 76 65 20 6e 6f 20 65 ommand have no e
1900: 66 66 65 63 74 2e 0d 0a 54 68 69 73 20 63 6f 6d ffect...This com
1910: 6d 61 6e 64 20 73 75 70 70 6f 72 74 73 20 61 6c mand supports al
1920: 6c 20 6f 66 20 74 68 65 20 73 61 6d 65 20 6f 70 l of the same op
1930: 74 69 6f 6e 73 20 61 73 20 74 68 65 20 3c 62 20 tions as the <b
1940: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
1950: 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 63 6f 6d 6d :socket</b> comm
1960: 61 6e 64 2c 0d 0a 74 68 6f 75 67 68 20 79 6f 75 and,..though you
1970: 20 73 68 6f 75 6c 64 20 6c 69 6d 69 74 20 79 6f should limit yo
1980: 75 72 20 6f 70 74 69 6f 6e 73 20 74 6f 20 6f 6e ur options to on
1990: 6c 79 20 74 68 65 20 54 4c 53 20 72 65 6c 61 74 ly the TLS relat
19a0: 65 64 20 6f 6e 65 73 2e 3c 2f 70 3e 3c 2f 64 64 ed ones.</p></dd
19b0: 3e 0d 0a 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 >..<dt><a name="
19c0: 32 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 2"><b class="cmd
19d0: 22 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 ">tls::socket</b
19e0: 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f > <span class="o
19f0: 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 pt">?<i class="a
1a00: 72 67 22 3e 2d 6f 70 74 69 6f 6e 3c 2f 69 3e 3f rg">-option</i>?
1a10: 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c </span> <span cl
1a20: 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c ass="opt">?<i cl
1a30: 61 73 73 3d 22 61 72 67 22 3e 76 61 6c 75 65 3c ass="arg">value<
1a40: 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 /i>?</span> <spa
1a50: 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c n class="opt">?<
1a60: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f i class="arg">-o
1a70: 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e 2e 3c ption value ...<
1a80: 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 69 20 63 /i>?</span> <i c
1a90: 6c 61 73 73 3d 22 61 72 67 22 3e 68 6f 73 74 3c lass="arg">host<
1aa0: 2f 69 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 /i> <i class="ar
1ab0: 67 22 3e 70 6f 72 74 3c 2f 69 3e 3c 2f 61 3e 3c g">port</i></a><
1ac0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 69 /dt>..<dd><p>Thi
1ad0: 73 20 69 73 20 61 20 68 65 6c 70 65 72 20 66 75 s is a helper fu
1ae0: 6e 63 74 69 6f 6e 20 74 68 61 74 20 75 74 69 6c nction that util
1af0: 69 7a 65 73 20 74 68 65 20 75 6e 64 65 72 6c 79 izes the underly
1b00: 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 3c 62 20 ing commands <b
1b10: 63 6c 61 73 73 3d 22 73 79 73 63 6d 64 22 3e 73 class="syscmd">s
1b20: 6f 63 6b 65 74 3c 2f 62 3e 0d 0a 61 6e 64 20 3c ocket</b>..and <
1b30: 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c b class="cmd">tl
1b40: 73 3a 3a 69 6d 70 6f 72 74 3c 2f 62 3e 20 74 6f s::import</b> to
1b50: 20 63 72 65 61 74 65 20 74 68 65 20 63 6f 6e 6e create the conn
1b60: 65 63 74 69 6f 6e 2e 20 49 74 20 62 65 68 61 76 ection. It behav
1b70: 65 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 es the same as t
1b80: 68 65 0d 0a 6e 61 74 69 76 65 20 54 43 4c 20 3c he..native TCL <
1b90: 62 20 63 6c 61 73 73 3d 22 73 79 73 63 6d 64 22 b class="syscmd"
1ba0: 3e 73 6f 63 6b 65 74 3c 2f 62 3e 20 63 6f 6d 6d >socket</b> comm
1bb0: 61 6e 64 2c 20 62 75 74 20 61 6c 73 6f 20 73 75 and, but also su
1bc0: 70 70 6f 72 74 73 20 74 68 65 20 3c 62 20 63 6c pports the <b cl
1bd0: 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 69 ass="cmd">tls::i
1be0: 6d 70 6f 72 74 3c 2f 62 3e 0d 0a 63 6f 6d 6d 61 mport</b>..comma
1bf0: 6e 64 20 6f 70 74 69 6f 6e 73 20 77 69 74 68 20 nd options with
1c00: 6f 6e 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f one additional o
1c10: 70 74 69 6f 6e 2e 20 49 74 20 72 65 74 75 72 6e ption. It return
1c20: 73 20 74 68 65 20 63 68 61 6e 6e 65 6c 20 68 61 s the channel ha
1c30: 6e 64 6c 65 20 69 64 0d 0a 66 6f 72 20 74 68 65 ndle id..for the
1c40: 20 6e 65 77 20 73 6f 63 6b 65 74 2e 20 41 64 64 new socket. Add
1c50: 69 74 69 6f 6e 61 6c 20 6f 70 74 69 6f 6e 73 20 itional options
1c60: 61 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c are:</p>..<dl cl
1c70: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 6f 70 ass="doctools_op
1c80: 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e 3c 62 20 tions">..<dt><b
1c90: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
1ca0: 61 75 74 6f 73 65 72 76 65 72 6e 61 6d 65 3c 2f autoservername</
1cb0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
1cc0: 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d ">bool</i></dt>.
1cd0: 0a 3c 64 64 3e 3c 70 3e 49 66 20 3c 62 20 63 6c .<dd><p>If <b cl
1ce0: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 72 75 65 ass="const">true
1cf0: 3c 2f 62 3e 2c 20 61 75 74 6f 6d 61 74 69 63 61 </b>, automatica
1d00: 6c 6c 79 20 73 65 74 20 74 68 65 20 3c 62 20 63 lly set the <b c
1d10: 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 73 lass="option">-s
1d20: 65 72 76 65 72 6e 61 6d 65 3c 2f 62 3e 20 61 72 ervername</b> ar
1d30: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 0d 0a 3c gument to the..<
1d40: 65 6d 3e 68 6f 73 74 3c 2f 65 6d 3e 20 61 72 67 em>host</em> arg
1d50: 75 6d 65 6e 74 2e 20 50 72 69 6f 72 20 74 6f 20 ument. Prior to
1d60: 54 63 6c 54 4c 53 20 32 2e 30 2c 20 74 68 65 20 TclTLS 2.0, the
1d70: 64 65 66 61 75 6c 74 20 69 73 20 3c 62 20 63 6c default is <b cl
1d80: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 66 61 6c 73 ass="const">fals
1d90: 65 3c 2f 62 3e 2e 0d 0a 53 74 61 72 74 69 6e 67 e</b>...Starting
1da0: 20 69 6e 20 54 63 6c 54 4c 53 20 32 2e 30 2c 20 in TclTLS 2.0,
1db0: 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 3c the default is <
1dc0: 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e b class="const">
1dd0: 74 72 75 65 3c 2f 62 3e 20 75 6e 6c 65 73 73 20 true</b> unless
1de0: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
1df0: 22 3e 2d 73 65 72 76 65 72 6e 61 6d 65 3c 2f 62 ">-servername</b
1e00: 3e 0d 0a 69 73 20 61 6c 73 6f 20 73 70 65 63 69 >..is also speci
1e10: 66 69 65 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a fied.</p></dd>..
1e20: 3c 2f 64 6c 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e </dl></dd>..<dt>
1e30: 3c 61 20 6e 61 6d 65 3d 22 33 22 3e 3c 62 20 63 <a name="3"><b c
1e40: 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a lass="cmd">tls::
1e50: 73 6f 63 6b 65 74 3c 2f 62 3e 20 3c 62 20 63 6c socket</b> <b cl
1e60: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 73 65 ass="option">-se
1e70: 72 76 65 72 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 rver</b> <i clas
1e80: 73 3d 22 61 72 67 22 3e 63 6f 6d 6d 61 6e 64 3c s="arg">command<
1e90: 2f 69 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d /i> <span class=
1ea0: 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d "opt">?<i class=
1eb0: 22 61 72 67 22 3e 2d 6f 70 74 69 6f 6e 3c 2f 69 "arg">-option</i
1ec0: 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 >?</span> <span
1ed0: 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 class="opt">?<i
1ee0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 76 61 6c 75 class="arg">valu
1ef0: 65 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 e</i>?</span> <s
1f00: 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e pan class="opt">
1f10: 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e ?<i class="arg">
1f20: 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e 2e -option value ..
1f30: 2e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 69 .</i>?</span> <i
1f40: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 70 6f 72 class="arg">por
1f50: 74 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 3e 0d 0a t</i></a></dt>..
1f60: 3c 64 64 3e 3c 70 3e 53 61 6d 65 20 61 73 20 70 <dd><p>Same as p
1f70: 72 65 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 2c revious command,
1f80: 20 62 75 74 20 69 6e 73 74 65 61 64 20 63 72 65 but instead cre
1f90: 61 74 65 73 20 61 20 73 65 72 76 65 72 20 73 6f ates a server so
1fa0: 63 6b 65 74 20 66 6f 72 20 63 6c 69 65 6e 74 73 cket for clients
1fb0: 20 74 6f 0d 0a 63 6f 6e 6e 65 63 74 20 74 6f 20 to..connect to
1fc0: 6a 75 73 74 20 6c 69 6b 65 20 74 68 65 20 54 63 just like the Tc
1fd0: 6c 20 3c 62 20 63 6c 61 73 73 3d 22 73 79 73 63 l <b class="sysc
1fe0: 6d 64 22 3e 73 6f 63 6b 65 74 20 2d 73 65 72 76 md">socket -serv
1ff0: 65 72 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 20 er</b> command.
2000: 49 74 20 72 65 74 75 72 6e 73 20 74 68 65 0d 0a It returns the..
2010: 63 68 61 6e 6e 65 6c 20 68 61 6e 64 6c 65 20 69 channel handle i
2020: 64 20 66 6f 72 20 74 68 65 20 6e 65 77 20 73 6f d for the new so
2030: 63 6b 65 74 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a cket.</p></dd>..
2040: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 34 22 3e <dt><a name="4">
2050: 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 <b class="cmd">t
2060: 6c 73 3a 3a 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c ls::import</b> <
2070: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 i class="arg">ch
2080: 61 6e 6e 65 6c 3c 2f 69 3e 20 3c 73 70 61 6e 20 annel</i> <span
2090: 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 class="opt">?<i
20a0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 2d 6f 70 74 class="arg">-opt
20b0: 69 6f 6e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 ion</i>?</span>
20c0: 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 <span class="opt
20d0: 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 ">?<i class="arg
20e0: 22 3e 76 61 6c 75 65 3c 2f 69 3e 3f 3c 2f 73 70 ">value</i>?</sp
20f0: 61 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d an> <span class=
2100: 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d "opt">?<i class=
2110: 22 61 72 67 22 3e 2d 6f 70 74 69 6f 6e 20 76 61 "arg">-option va
2120: 6c 75 65 20 2e 2e 2e 3c 2f 69 3e 3f 3c 2f 73 70 lue ...</i>?</sp
2130: 61 6e 3e 3c 2f 61 3e 3c 2f 64 74 3e 0d 0a 3c 64 an></a></dt>..<d
2140: 64 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 61 20 d></dd>..<dt><a
2150: 6e 61 6d 65 3d 22 35 22 3e 3c 62 20 63 6c 61 73 name="5"><b clas
2160: 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 73 74 61 s="cmd">tls::sta
2170: 72 74 74 6c 73 3c 2f 62 3e 20 3c 69 20 63 6c 61 rttls</b> <i cla
2180: 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 6c ss="arg">channel
2190: 3c 2f 69 3e 20 3c 73 70 61 6e 20 63 6c 61 73 73 </i> <span class
21a0: 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 73 73 ="opt">?<i class
21b0: 3d 22 61 72 67 22 3e 2d 6f 70 74 69 6f 6e 3c 2f ="arg">-option</
21c0: 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 73 70 61 6e i>?</span> <span
21d0: 20 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 class="opt">?<i
21e0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 76 61 6c class="arg">val
21f0: 75 65 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 20 3c ue</i>?</span> <
2200: 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 74 22 span class="opt"
2210: 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 >?<i class="arg"
2220: 3e 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 2e >-option value .
2230: 2e 2e 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 3c 2f ..</i>?</span></
2240: 61 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e a></dt>..<dd><p>
2250: 53 74 61 72 74 20 54 4c 53 20 65 6e 63 72 79 70 Start TLS encryp
2260: 74 69 6f 6e 20 6f 6e 20 54 43 4c 20 63 68 61 6e tion on TCL chan
2270: 6e 65 6c 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 nel <i class="ar
2280: 67 22 3e 63 68 61 6e 6e 65 6c 3c 2f 69 3e 20 76 g">channel</i> v
2290: 69 61 20 61 20 73 74 61 63 6b 65 64 20 63 68 61 ia a stacked cha
22a0: 6e 6e 65 6c 2e 20 49 74 0d 0a 6e 65 65 64 20 6e nnel. It..need n
22b0: 6f 74 20 62 65 20 61 20 73 6f 63 6b 65 74 2c 20 ot be a socket,
22c0: 62 75 74 20 6d 75 73 74 20 70 72 6f 76 69 64 65 but must provide
22d0: 20 62 69 2d 64 69 72 65 63 74 69 6f 6e 61 6c 20 bi-directional
22e0: 66 6c 6f 77 2e 20 41 6c 73 6f 20 73 65 74 73 20 flow. Also sets
22f0: 73 65 73 73 69 6f 6e 0d 0a 70 61 72 61 6d 65 74 session..paramet
2300: 65 72 73 20 66 6f 72 20 53 53 4c 20 68 61 6e 64 ers for SSL hand
2310: 73 68 61 6b 65 2e 20 56 61 6c 69 64 20 6f 70 74 shake. Valid opt
2320: 69 6f 6e 73 20 61 72 65 3a 3c 2f 70 3e 0d 0a 3c ions are:</p>..<
2330: 64 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f dl class="doctoo
2340: 6c 73 5f 6f 70 74 69 6f 6e 73 22 3e 0d 0a 3c 64 ls_options">..<d
2350: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 t><b class="opti
2360: 6f 6e 22 3e 2d 61 6c 70 6e 3c 2f 62 3e 20 3c 69 on">-alpn</b> <i
2370: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 6c 69 73 class="arg">lis
2380: 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e t</i></dt>..<dd>
2390: 3c 70 3e 4c 69 73 74 20 6f 66 20 70 72 6f 74 6f <p>List of proto
23a0: 63 6f 6c 73 20 74 6f 20 6f 66 66 65 72 20 64 75 cols to offer du
23b0: 72 69 6e 67 20 41 70 70 6c 69 63 61 74 69 6f 6e ring Application
23c0: 2d 4c 61 79 65 72 20 50 72 6f 74 6f 63 6f 6c 20 -Layer Protocol
23d0: 4e 65 67 6f 74 69 61 74 69 6f 6e 0d 0a 28 41 4c Negotiation..(AL
23e0: 50 4e 29 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 PN). For example
23f0: 3a 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 : <b class="cons
2400: 74 22 3e 68 32 3c 2f 62 3e 20 61 6e 64 20 3c 62 t">h2</b> and <b
2410: 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 68 class="const">h
2420: 74 74 70 2f 31 2e 31 3c 2f 62 3e 2c 20 62 75 74 ttp/1.1</b>, but
2430: 20 6e 6f 74 20 3c 62 20 63 6c 61 73 73 3d 22 63 not <b class="c
2440: 6f 6e 73 74 22 3e 68 33 3c 2f 62 3e 20 6f 72 0d onst">h3</b> or.
2450: 0a 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 .<b class="const
2460: 22 3e 71 75 69 63 3c 2f 62 3e 2e 20 54 68 69 73 ">quic</b>. This
2470: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 option is new f
2480: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f or TclTLS 1.8.</
2490: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
24a0: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
24b0: 63 61 64 69 72 3c 2f 62 3e 20 3c 69 20 63 6c 61 cadir</b> <i cla
24c0: 73 73 3d 22 61 72 67 22 3e 64 69 72 65 63 74 6f ss="arg">directo
24d0: 72 79 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 ry</i></dt>..<dd
24e0: 3e 3c 70 3e 53 70 65 63 69 66 69 65 73 20 74 68 ><p>Specifies th
24f0: 65 20 64 69 72 65 63 74 6f 72 79 20 77 68 65 72 e directory wher
2500: 65 20 74 68 65 20 43 65 72 74 69 66 69 63 61 74 e the Certificat
2510: 65 20 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 e Authority (CA)
2520: 20 63 65 72 74 69 66 69 63 61 74 65 73 20 61 72 certificates ar
2530: 65 0d 0a 73 74 6f 72 65 64 2e 20 54 68 65 20 64 e..stored. The d
2540: 65 66 61 75 6c 74 20 69 73 20 70 6c 61 74 66 6f efault is platfo
2550: 72 6d 20 73 70 65 63 69 66 69 63 20 61 6e 64 20 rm specific and
2560: 63 61 6e 20 62 65 20 73 65 74 20 61 74 20 63 6f can be set at co
2570: 6d 70 69 6c 65 20 74 69 6d 65 2e 20 54 68 65 0d mpile time. The.
2580: 0a 64 65 66 61 75 6c 74 20 6c 6f 63 61 74 69 6f .default locatio
2590: 6e 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 n can be overrid
25a0: 64 65 6e 20 62 79 20 74 68 65 20 3c 62 20 63 6c den by the <b cl
25b0: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 53 ass="variable">S
25c0: 53 4c 5f 43 45 52 54 5f 44 49 52 3c 2f 62 3e 20 SL_CERT_DIR</b>
25d0: 65 6e 76 69 72 6f 6e 6d 65 6e 74 0d 0a 76 61 72 environment..var
25e0: 69 61 62 6c 65 2e 20 53 65 65 20 3c 73 70 61 6e iable. See <span
25f0: 20 63 6c 61 73 73 3d 22 73 65 63 74 72 65 66 22 class="sectref"
2600: 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 69 ><a href="#secti
2610: 6f 6e 34 22 3e 43 65 72 74 69 66 69 63 61 74 65 on4">Certificate
2620: 20 56 61 6c 69 64 61 74 69 6f 6e 3c 2f 61 3e 3c Validation</a><
2630: 2f 73 70 61 6e 3e 20 66 6f 72 20 6d 6f 72 65 20 /span> for more
2640: 64 65 74 61 69 6c 73 2e 3c 2f 70 3e 3c 2f 64 64 details.</p></dd
2650: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
2660: 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 66 69 6c 65 "option">-cafile
2670: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
2680: 72 67 22 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e rg">filename</i>
2690: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 </dt>..<dd><p>Sp
26a0: 65 63 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 ecifies the file
26b0: 20 77 69 74 68 20 74 68 65 20 43 65 72 74 69 66 with the Certif
26c0: 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 icate Authority
26d0: 28 43 41 29 20 63 65 72 74 69 66 69 63 61 74 65 (CA) certificate
26e0: 73 20 74 6f 20 75 73 65 20 69 6e 0d 0a 3c 62 20 s to use in..<b
26f0: 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 50 45 class="const">PE
2700: 4d 3c 2f 62 3e 20 66 69 6c 65 20 66 6f 72 6d 61 M</b> file forma
2710: 74 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 t. The default i
2720: 73 20 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 73 s "<b class
2730: 3d 22 66 69 6c 65 22 3e 63 65 72 74 2e 70 65 6d ="file">cert.pem
2740: 3c 2f 62 3e 26 71 75 6f 74 3b 2c 20 69 6e 20 74 </b>", in t
2750: 68 65 20 4f 70 65 6e 53 53 4c 0d 0a 64 69 72 65 he OpenSSL..dire
2760: 63 74 6f 72 79 2e 20 54 68 65 20 64 65 66 61 75 ctory. The defau
2770: 6c 74 20 66 69 6c 65 20 63 61 6e 20 62 65 20 6f lt file can be o
2780: 76 65 72 72 69 64 64 65 6e 20 62 79 20 74 68 65 verridden by the
2790: 20 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 <b class="varia
27a0: 62 6c 65 22 3e 53 53 4c 5f 43 45 52 54 5f 46 49 ble">SSL_CERT_FI
27b0: 4c 45 3c 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 LE</b> environme
27c0: 6e 74 0d 0a 76 61 72 69 61 62 6c 65 2e 20 53 65 nt..variable. Se
27d0: 65 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 73 e <span class="s
27e0: 65 63 74 72 65 66 22 3e 3c 61 20 68 72 65 66 3d ectref"><a href=
27f0: 22 23 73 65 63 74 69 6f 6e 34 22 3e 43 65 72 74 "#section4">Cert
2800: 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 ificate Validati
2810: 6f 6e 3c 2f 61 3e 3c 2f 73 70 61 6e 3e 20 66 6f on</a></span> fo
2820: 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 3c r more details.<
2830: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
2840: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
2850: 2d 63 61 73 74 6f 72 65 3c 2f 62 3e 20 3c 69 20 -castore</b> <i
2860: 63 6c 61 73 73 3d 22 61 72 67 22 3e 55 52 49 3c class="arg">URI<
2870: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
2880: 3e 53 70 65 63 69 66 69 65 73 20 74 68 65 20 55 >Specifies the U
2890: 6e 69 66 6f 72 6d 20 52 65 73 6f 75 72 63 65 20 niform Resource
28a0: 49 64 65 6e 74 69 66 69 65 72 20 28 55 52 49 29 Identifier (URI)
28b0: 20 66 6f 72 20 74 68 65 20 43 65 72 74 69 66 69 for the Certifi
28c0: 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 0d 0a cate Authority..
28d0: 28 43 41 29 20 73 74 6f 72 65 2c 20 77 68 69 63 (CA) store, whic
28e0: 68 20 6d 61 79 20 62 65 20 61 20 73 69 6e 67 6c h may be a singl
28f0: 65 20 63 6f 6e 74 61 69 6e 65 72 20 6f 72 20 61 e container or a
2900: 20 63 61 74 61 6c 6f 67 20 6f 66 20 63 6f 6e 74 catalog of cont
2910: 61 69 6e 65 72 73 2e 0d 0a 53 74 61 72 74 69 6e ainers...Startin
2920: 67 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 33 g with OpenSSL 3
2930: 2e 32 20 6f 6e 20 4d 53 20 57 69 6e 64 6f 77 73 .2 on MS Windows
2940: 2c 20 73 65 74 20 74 6f 20 26 71 75 6f 74 3b 3c , set to "<
2950: 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e b class="const">
2960: 6f 72 67 2e 6f 70 65 6e 73 73 6c 2e 77 69 6e 73 org.openssl.wins
2970: 74 6f 72 65 3a 2f 2f 3c 2f 62 3e 26 71 75 6f 74 tore://</b>"
2980: 3b 0d 0a 74 6f 20 75 73 65 20 74 68 65 20 62 75 ;..to use the bu
2990: 69 6c 74 2d 69 6e 20 4d 53 20 57 69 6e 64 6f 77 ilt-in MS Window
29a0: 73 20 43 65 72 74 69 66 69 63 61 74 65 20 53 74 s Certificate St
29b0: 6f 72 65 2e 0d 0a 53 65 65 20 3c 73 70 61 6e 20 ore...See <span
29c0: 63 6c 61 73 73 3d 22 73 65 63 74 72 65 66 22 3e class="sectref">
29d0: 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 69 6f <a href="#sectio
29e0: 6e 34 22 3e 43 65 72 74 69 66 69 63 61 74 65 20 n4">Certificate
29f0: 56 61 6c 69 64 61 74 69 6f 6e 3c 2f 61 3e 3c 2f Validation</a></
2a00: 73 70 61 6e 3e 20 66 6f 72 20 6d 6f 72 65 20 64 span> for more d
2a10: 65 74 61 69 6c 73 2e 0d 0a 54 68 69 73 20 6f 70 etails...This op
2a20: 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 tion is new for
2a30: 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c TclTLS 1.8.</p><
2a40: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
2a50: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 65 72 ss="option">-cer
2a60: 74 66 69 6c 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 tfile</b> <i cla
2a70: 73 73 3d 22 61 72 67 22 3e 66 69 6c 65 6e 61 6d ss="arg">filenam
2a80: 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e e</i></dt>..<dd>
2a90: 3c 70 3e 53 70 65 63 69 66 69 65 73 20 74 68 65 <p>Specifies the
2aa0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c name of the fil
2ab0: 65 20 77 69 74 68 20 74 68 65 20 63 65 72 74 69 e with the certi
2ac0: 66 69 63 61 74 65 20 74 6f 20 75 73 65 20 69 6e ficate to use in
2ad0: 20 50 45 4d 20 66 6f 72 6d 61 74 0d 0a 61 73 20 PEM format..as
2ae0: 74 68 65 20 6c 6f 63 61 6c 20 28 63 6c 69 65 6e the local (clien
2af0: 74 20 6f 72 20 73 65 72 76 65 72 29 20 63 65 72 t or server) cer
2b00: 74 69 66 69 63 61 74 65 2e 20 49 74 20 61 6c 73 tificate. It als
2b10: 6f 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 o contains the p
2b20: 75 62 6c 69 63 20 6b 65 79 2e 3c 2f 70 3e 3c 2f ublic key.</p></
2b30: 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 dd>..<dt><b clas
2b40: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 65 72 74 s="option">-cert
2b50: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
2b60: 72 67 22 3e 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f rg">string</i></
2b70: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 63 dt>..<dd><p>Spec
2b80: 69 66 69 65 73 20 74 68 65 20 63 65 72 74 69 66 ifies the certif
2b90: 69 63 61 74 65 20 74 6f 20 75 73 65 20 61 73 20 icate to use as
2ba0: 61 20 44 45 52 20 65 6e 63 6f 64 65 64 20 73 74 a DER encoded st
2bb0: 72 69 6e 67 20 28 58 2e 35 30 39 20 44 45 52 29 ring (X.509 DER)
2bc0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
2bd0: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
2be0: 22 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 ">-cipher</b> <i
2bf0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 73 74 72 class="arg">str
2c00: 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ing</i></dt>..<d
2c10: 64 3e 3c 70 3e 53 70 65 63 69 66 69 65 73 20 74 d><p>Specifies t
2c20: 68 65 20 6c 69 73 74 20 6f 66 20 63 69 70 68 65 he list of ciphe
2c30: 72 73 20 74 6f 20 75 73 65 20 66 6f 72 20 54 4c rs to use for TL
2c40: 53 20 31 2e 32 20 61 6e 64 20 65 61 72 6c 69 65 S 1.2 and earlie
2c50: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0d 0a r connections...
2c60: 53 74 72 69 6e 67 20 69 73 20 61 20 63 6f 6c 6f String is a colo
2c70: 6e 20 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 73 n "<b class
2c80: 3d 22 63 6f 6e 73 74 22 3e 3a 3c 2f 62 3e 26 71 ="const">:</b>&q
2c90: 75 6f 74 3b 20 73 65 70 61 72 61 74 65 64 20 6c uot; separated l
2ca0: 69 73 74 20 6f 66 20 63 69 70 68 65 72 73 2e 0d ist of ciphers..
2cb0: 0a 43 69 70 68 65 72 73 20 63 61 6e 20 62 65 20 .Ciphers can be
2cc0: 63 6f 6d 62 69 6e 65 64 20 75 73 69 6e 67 20 74 combined using t
2cd0: 68 65 20 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 he "<b clas
2ce0: 73 3d 22 63 6f 6e 73 74 22 3e 2b 3c 2f 62 3e 26 s="const">+</b>&
2cf0: 71 75 6f 74 3b 20 63 68 61 72 61 63 74 65 72 2e quot; character.
2d00: 0d 0a 50 72 65 66 69 78 65 73 20 63 61 6e 20 62 ..Prefixes can b
2d10: 65 20 75 73 65 64 20 74 6f 20 70 65 72 6d 61 6e e used to perman
2d20: 65 6e 74 6c 79 20 72 65 6d 6f 76 65 20 26 71 75 ently remove &qu
2d30: 6f 74 3b 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e ot;<b class="con
2d40: 73 74 22 3e 21 3c 2f 62 3e 26 71 75 6f 74 3b 2c st">!</b>",
2d50: 20 64 65 6c 65 74 65 20 26 71 75 6f 74 3b 3c 62 delete "<b
2d60: 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 2d class="const">-
2d70: 3c 2f 62 3e 26 71 75 6f 74 3b 2c 20 6f 72 0d 0a </b>", or..
2d80: 6d 6f 76 65 20 74 6f 20 74 68 65 20 65 6e 64 20 move to the end
2d90: 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 73 3d 22 "<b class="
2da0: 63 6f 6e 73 74 22 3e 2b 3c 2f 62 3e 26 71 75 6f const">+</b>&quo
2db0: 74 3b 20 61 20 73 70 65 63 69 66 69 65 64 20 63 t; a specified c
2dc0: 69 70 68 65 72 2e 0d 0a 4b 65 79 77 6f 72 64 73 ipher...Keywords
2dd0: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
2de0: 22 3e 40 53 54 52 45 4e 47 54 48 3c 2f 62 3e 20 ">@STRENGTH</b>
2df0: 28 73 6f 72 74 20 62 79 20 61 6c 67 6f 72 69 74 (sort by algorit
2e00: 68 6d 20 6b 65 79 20 6c 65 6e 67 74 68 29 2c 0d hm key length),.
2e10: 0a 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 .<b class="const
2e20: 22 3e 40 53 45 43 4c 45 56 45 4c 3d 3c 2f 62 3e ">@SECLEVEL=</b>
2e30: 3c 65 6d 3e 6e 3c 2f 65 6d 3e 20 28 73 65 74 20 <em>n</em> (set
2e40: 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 74 security level t
2e50: 6f 20 6e 29 2c 20 61 6e 64 0d 0a 3c 62 20 63 6c o n), and..<b cl
2e60: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 44 45 46 41 ass="const">DEFA
2e70: 55 4c 54 3c 2f 62 3e 20 28 75 73 65 20 64 65 66 ULT</b> (use def
2e80: 61 75 6c 74 20 63 69 70 68 65 72 20 6c 69 73 74 ault cipher list
2e90: 2c 20 61 74 20 73 74 61 72 74 20 6f 6e 6c 79 29 , at start only)
2ea0: 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 73 70 65 can also be spe
2eb0: 63 69 66 69 65 64 2e 0d 0a 53 65 65 20 74 68 65 cified...See the
2ec0: 20 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 3a <a href="https:
2ed0: 2f 2f 64 6f 63 73 2e 6f 70 65 6e 73 73 6c 2e 6f //docs.openssl.o
2ee0: 72 67 2f 6d 61 73 74 65 72 2f 6d 61 6e 31 2f 6f rg/master/man1/o
2ef0: 70 65 6e 73 73 6c 2d 63 69 70 68 65 72 73 2f 23 penssl-ciphers/#
2f00: 6f 70 74 69 6f 6e 73 22 3e 4f 70 65 6e 53 53 4c options">OpenSSL
2f10: 3c 2f 61 3e 0d 0a 64 6f 63 75 6d 65 6e 74 61 74 </a>..documentat
2f20: 69 6f 6e 20 66 6f 72 20 74 68 65 20 66 75 6c 6c ion for the full
2f30: 20 6c 69 73 74 20 6f 66 20 76 61 6c 69 64 20 76 list of valid v
2f40: 61 6c 75 65 73 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d alues.</p></dd>.
2f50: 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f .<dt><b class="o
2f60: 70 74 69 6f 6e 22 3e 2d 63 69 70 68 65 72 73 75 ption">-ciphersu
2f70: 69 74 65 73 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 ites</b> <i clas
2f80: 73 3d 22 61 72 67 22 3e 73 74 72 69 6e 67 3c 2f s="arg">string</
2f90: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
2fa0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 69 Specifies the li
2fb0: 73 74 20 6f 66 20 63 69 70 68 65 72 20 73 75 69 st of cipher sui
2fc0: 74 65 73 20 74 6f 20 75 73 65 20 66 6f 72 20 54 tes to use for T
2fd0: 4c 53 20 31 2e 33 20 61 73 20 61 20 63 6f 6c 6f LS 1.3 as a colo
2fe0: 6e 0d 0a 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 n.."<b clas
2ff0: 73 3d 22 63 6f 6e 73 74 22 3e 3a 3c 2f 62 3e 26 s="const">:</b>&
3000: 71 75 6f 74 3b 20 73 65 70 61 72 61 74 65 64 20 quot; separated
3010: 6c 69 73 74 20 6f 66 20 63 69 70 68 65 72 20 73 list of cipher s
3020: 75 69 74 65 20 6e 61 6d 65 73 2e 20 53 65 65 20 uite names. See
3030: 74 68 65 0d 0a 3c 61 20 68 72 65 66 3d 22 68 74 the..<a href="ht
3040: 74 70 73 3a 2f 2f 64 6f 63 73 2e 6f 70 65 6e 73 tps://docs.opens
3050: 73 6c 2e 6f 72 67 2f 6d 61 73 74 65 72 2f 6d 61 sl.org/master/ma
3060: 6e 31 2f 6f 70 65 6e 73 73 6c 2d 63 69 70 68 65 n1/openssl-ciphe
3070: 72 73 2f 23 6f 70 74 69 6f 6e 73 22 3e 4f 70 65 rs/#options">Ope
3080: 6e 53 53 4c 3c 2f 61 3e 0d 0a 64 6f 63 75 6d 65 nSSL</a>..docume
3090: 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 ntation for the
30a0: 66 75 6c 6c 20 6c 69 73 74 20 6f 66 20 76 61 6c full list of val
30b0: 69 64 20 76 61 6c 75 65 73 2e 0d 0a 54 68 69 73 id values...This
30c0: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 option is new f
30d0: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f or TclTLS 1.8.</
30e0: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
30f0: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
3100: 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c 69 20 63 command</b> <i c
3110: 6c 61 73 73 3d 22 61 72 67 22 3e 63 61 6c 6c 62 lass="arg">callb
3120: 61 63 6b 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ack</i></dt>..<d
3130: 64 3e 3c 70 3e 53 70 65 63 69 66 69 65 73 20 74 d><p>Specifies t
3140: 68 65 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6d 6d he callback comm
3150: 61 6e 64 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 and to be invoke
3160: 64 20 61 74 20 73 65 76 65 72 61 6c 20 70 6f 69 d at several poi
3170: 6e 74 73 20 64 75 72 69 6e 67 20 74 68 65 0d 0a nts during the..
3180: 68 61 6e 64 73 68 61 6b 65 20 74 6f 20 70 61 73 handshake to pas
3190: 73 20 65 72 72 6f 72 73 2c 20 74 72 61 63 69 6e s errors, tracin
31a0: 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 61 g information, a
31b0: 6e 64 20 70 72 6f 74 6f 63 6f 6c 20 6d 65 73 73 nd protocol mess
31c0: 61 67 65 73 2e 0d 0a 53 65 65 20 3c 73 70 61 6e ages...See <span
31d0: 20 63 6c 61 73 73 3d 22 73 65 63 74 72 65 66 22 class="sectref"
31e0: 3e 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 69 ><a href="#secti
31f0: 6f 6e 35 22 3e 43 61 6c 6c 62 61 63 6b 20 4f 70 on5">Callback Op
3200: 74 69 6f 6e 73 3c 2f 61 3e 3c 2f 73 70 61 6e 3e tions</a></span>
3210: 20 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 2e 3c for more info.<
3220: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
3230: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
3240: 2d 64 68 70 61 72 61 6d 73 3c 2f 62 3e 20 3c 69 -dhparams</b> <i
3250: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 66 69 6c class="arg">fil
3260: 65 6e 61 6d 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a ename</i></dt>..
3270: 3c 64 64 3e 3c 70 3e 53 70 65 63 69 66 69 65 73 <dd><p>Specifies
3280: 20 74 68 65 20 44 69 66 66 69 65 2d 48 65 6c 6c the Diffie-Hell
3290: 6d 61 6e 20 28 44 48 29 20 70 61 72 61 6d 65 74 man (DH) paramet
32a0: 65 72 73 20 66 69 6c 65 2e 3c 2f 70 3e 3c 2f 64 ers file.</p></d
32b0: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
32c0: 3d 22 6f 70 74 69 6f 6e 22 3e 2d 6b 65 79 66 69 ="option">-keyfi
32d0: 6c 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d le</b> <i class=
32e0: 22 61 72 67 22 3e 66 69 6c 65 6e 61 6d 65 3c 2f "arg">filename</
32f0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
3300: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 70 72 Specifies the pr
3310: 69 76 61 74 65 20 6b 65 79 20 66 69 6c 65 2e 20 ivate key file.
3320: 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 74 The default is t
3330: 6f 20 75 73 65 20 74 68 65 20 66 69 6c 65 0d 0a o use the file..
3340: 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 specified by the
3350: 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f <b class="optio
3360: 6e 22 3e 2d 63 65 72 74 66 69 6c 65 3c 2f 62 3e n">-certfile</b>
3370: 20 6f 70 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 option.</p></dd
3380: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
3390: 22 6f 70 74 69 6f 6e 22 3e 2d 6b 65 79 3c 2f 62 "option">-key</b
33a0: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
33b0: 3e 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e >string</i></dt>
33c0: 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 63 69 66 69 ..<dd><p>Specifi
33d0: 65 73 20 74 68 65 20 70 72 69 76 61 74 65 20 6b es the private k
33e0: 65 79 20 74 6f 20 75 73 65 20 61 73 20 61 20 44 ey to use as a D
33f0: 45 52 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e ER encoded strin
3400: 67 20 28 50 4b 43 53 23 31 20 44 45 52 29 2e 3c g (PKCS#1 DER).<
3410: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
3420: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
3430: 2d 6d 6f 64 65 6c 3c 2f 62 3e 20 3c 69 20 63 6c -model</b> <i cl
3440: 61 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 ass="arg">channe
3450: 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e l</i></dt>..<dd>
3460: 3c 70 3e 46 6f 72 63 65 20 74 68 69 73 20 63 68 <p>Force this ch
3470: 61 6e 6e 65 6c 20 74 6f 20 73 68 61 72 65 20 74 annel to share t
3480: 68 65 20 73 61 6d 65 20 3c 69 20 63 6c 61 73 73 he same <i class
3490: 3d 22 74 65 72 6d 22 3e 53 53 4c 5f 43 54 58 3c ="term">SSL_CTX<
34a0: 2f 69 3e 20 73 74 72 75 63 74 75 72 65 20 61 73 /i> structure as
34b0: 20 74 68 65 0d 0a 73 70 65 63 69 66 69 65 64 20 the..specified
34c0: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 <i class="arg">c
34d0: 68 61 6e 6e 65 6c 3c 2f 69 3e 2c 20 61 6e 64 20 hannel</i>, and
34e0: 74 68 65 72 65 66 6f 72 65 20 73 68 61 72 65 20 therefore share
34f0: 63 6f 6e 66 69 67 2c 20 63 61 6c 6c 62 61 63 6b config, callback
3500: 73 2c 20 65 74 63 2e 3c 2f 70 3e 3c 2f 64 64 3e s, etc.</p></dd>
3510: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
3520: 6f 70 74 69 6f 6e 22 3e 2d 70 61 73 73 77 6f 72 option">-passwor
3530: 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 d</b> <i class="
3540: 61 72 67 22 3e 63 61 6c 6c 62 61 63 6b 3c 2f 69 arg">callback</i
3550: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 ></dt>..<dd><p>S
3560: 70 65 63 69 66 69 65 73 20 74 68 65 20 63 61 6c pecifies the cal
3570: 6c 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 74 6f lback command to
3580: 20 69 6e 76 6f 6b 65 20 77 68 65 6e 20 4f 70 65 invoke when Ope
3590: 6e 53 53 4c 20 6e 65 65 64 73 20 74 6f 20 6f 62 nSSL needs to ob
35a0: 74 61 69 6e 20 61 0d 0a 70 61 73 73 77 6f 72 64 tain a..password
35b0: 2e 20 54 68 69 73 20 69 73 20 74 79 70 69 63 61 . This is typica
35c0: 6c 6c 79 20 75 73 65 64 20 74 6f 20 75 6e 6c 6f lly used to unlo
35d0: 63 6b 20 74 68 65 20 70 72 69 76 61 74 65 20 6b ck the private k
35e0: 65 79 20 6f 66 20 61 20 63 65 72 74 69 66 69 63 ey of a certific
35f0: 61 74 65 2e 0d 0a 54 68 65 20 63 61 6c 6c 62 61 ate...The callba
3600: 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e ck should return
3610: 20 61 20 70 61 73 73 77 6f 72 64 20 73 74 72 69 a password stri
3620: 6e 67 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 ng. This option
3630: 68 61 73 20 63 68 61 6e 67 65 64 20 66 6f 72 0d has changed for.
3640: 0a 54 63 6c 54 4c 53 20 31 2e 38 2e 20 53 65 65 .TclTLS 1.8. See
3650: 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 73 65 <span class="se
3660: 63 74 72 65 66 22 3e 3c 61 20 68 72 65 66 3d 22 ctref"><a href="
3670: 23 73 65 63 74 69 6f 6e 35 22 3e 43 61 6c 6c 62 #section5">Callb
3680: 61 63 6b 20 4f 70 74 69 6f 6e 73 3c 2f 61 3e 3c ack Options</a><
3690: 2f 73 70 61 6e 3e 20 66 6f 72 20 6d 6f 72 65 20 /span> for more
36a0: 69 6e 66 6f 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a info.</p></dd>..
36b0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 <dt><b class="op
36c0: 74 69 6f 6e 22 3e 2d 70 6f 73 74 5f 68 61 6e 64 tion">-post_hand
36d0: 73 68 61 6b 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 shake</b> <i cla
36e0: 73 73 3d 22 61 72 67 22 3e 62 6f 6f 6c 3c 2f 69 ss="arg">bool</i
36f0: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 41 ></dt>..<dd><p>A
3700: 6c 6c 6f 77 20 70 6f 73 74 2d 68 61 6e 64 73 68 llow post-handsh
3710: 61 6b 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b ake session tick
3720: 65 74 20 75 70 64 61 74 65 73 2e 20 54 68 69 73 et updates. This
3730: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 option is new f
3740: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f or TclTLS 1.8.</
3750: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
3760: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
3770: 72 65 71 75 65 73 74 3c 2f 62 3e 20 3c 69 20 63 request</b> <i c
3780: 6c 61 73 73 3d 22 61 72 67 22 3e 62 6f 6f 6c 3c lass="arg">bool<
3790: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
37a0: 3e 52 65 71 75 65 73 74 20 61 20 63 65 72 74 69 >Request a certi
37b0: 66 69 63 61 74 65 20 66 72 6f 6d 20 74 68 65 20 ficate from the
37c0: 70 65 65 72 20 64 75 72 69 6e 67 20 74 68 65 20 peer during the
37d0: 53 53 4c 20 68 61 6e 64 73 68 61 6b 65 2e 20 54 SSL handshake. T
37e0: 68 69 73 20 69 73 20 6e 65 65 64 65 64 0d 0a 74 his is needed..t
37f0: 6f 20 64 6f 20 43 65 72 74 69 66 69 63 61 74 65 o do Certificate
3800: 20 56 61 6c 69 64 61 74 69 6f 6e 2e 20 53 74 61 Validation. Sta
3810: 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 rting in TclTLS
3820: 31 2e 38 2c 20 74 68 65 20 64 65 66 61 75 6c 74 1.8, the default
3830: 20 69 73 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 63 is..<b class="c
3840: 6f 6e 73 74 22 3e 74 72 75 65 3c 2f 62 3e 20 66 onst">true</b> f
3850: 6f 72 20 63 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 or client connec
3860: 74 69 6f 6e 73 2e 20 53 74 61 72 74 69 6e 67 20 tions. Starting
3870: 69 6e 20 54 63 6c 54 4c 53 20 32 2e 30 2c 20 69 in TclTLS 2.0, i
3880: 66 20 73 65 74 20 74 6f 0d 0a 3c 62 20 63 6c 61 f set to..<b cla
3890: 73 73 3d 22 63 6f 6e 73 74 22 3e 66 61 6c 73 65 ss="const">false
38a0: 3c 2f 62 3e 20 61 6e 64 20 3c 62 20 63 6c 61 73 </b> and <b clas
38b0: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 72 65 71 75 s="option">-requ
38c0: 69 72 65 3c 2f 62 3e 20 69 73 20 3c 62 20 63 6c ire</b> is <b cl
38d0: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 72 75 65 ass="const">true
38e0: 3c 2f 62 3e 2c 20 74 68 65 6e 20 74 68 69 73 20 </b>, then this
38f0: 77 69 6c 6c 20 62 65 0d 0a 6f 76 65 72 72 69 64 will be..overrid
3900: 64 65 6e 20 74 6f 20 3c 62 20 63 6c 61 73 73 3d den to <b class=
3910: 22 63 6f 6e 73 74 22 3e 74 72 75 65 3c 2f 62 3e "const">true</b>
3920: 2e 0d 0a 53 65 65 20 3c 73 70 61 6e 20 63 6c 61 ...See <span cla
3930: 73 73 3d 22 73 65 63 74 72 65 66 22 3e 3c 61 20 ss="sectref"><a
3940: 68 72 65 66 3d 22 23 73 65 63 74 69 6f 6e 34 22 href="#section4"
3950: 3e 43 65 72 74 69 66 69 63 61 74 65 20 56 61 6c >Certificate Val
3960: 69 64 61 74 69 6f 6e 3c 2f 61 3e 3c 2f 73 70 61 idation</a></spa
3970: 6e 3e 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 n> for more deta
3980: 69 6c 73 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c ils.</p></dd>..<
3990: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 dt><b class="opt
39a0: 69 6f 6e 22 3e 2d 72 65 71 75 69 72 65 3c 2f 62 ion">-require</b
39b0: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
39c0: 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >bool</i></dt>..
39d0: 3c 64 64 3e 3c 70 3e 52 65 71 75 69 72 65 20 61 <dd><p>Require a
39e0: 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 61 valid certifica
39f0: 74 65 20 66 72 6f 6d 20 74 68 65 20 70 65 65 72 te from the peer
3a00: 20 64 75 72 69 6e 67 20 74 68 65 20 53 53 4c 20 during the SSL
3a10: 68 61 6e 64 73 68 61 6b 65 2e 20 49 66 20 74 68 handshake. If th
3a20: 69 73 20 69 73 0d 0a 73 65 74 20 74 6f 20 74 72 is is..set to tr
3a30: 75 65 2c 20 74 68 65 6e 20 3c 62 20 63 6c 61 73 ue, then <b clas
3a40: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 72 65 71 75 s="option">-requ
3a50: 65 73 74 3c 2f 62 3e 20 6d 75 73 74 20 61 6c 73 est</b> must als
3a60: 6f 20 62 65 20 73 65 74 20 74 6f 20 74 72 75 65 o be set to true
3a70: 20 61 6e 64 20 61 20 65 69 74 68 65 72 0d 0a 3c and a either..<
3a80: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
3a90: 3e 2d 63 61 64 69 72 3c 2f 62 3e 2c 20 3c 62 20 >-cadir</b>, <b
3aa0: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
3ab0: 63 61 66 69 6c 65 3c 2f 62 3e 2c 20 3c 62 20 63 cafile</b>, <b c
3ac0: 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 lass="option">-c
3ad0: 61 73 74 6f 72 65 3c 2f 62 3e 2c 20 6f 72 20 61 astore</b>, or a
3ae0: 20 70 6c 61 74 66 6f 72 6d 20 64 65 66 61 75 6c platform defaul
3af0: 74 0d 0a 6d 75 73 74 20 62 65 20 70 72 6f 76 69 t..must be provi
3b00: 64 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ded in order to
3b10: 76 61 6c 69 64 61 74 65 20 61 67 61 69 6e 73 74 validate against
3b20: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 6e . The default in
3b30: 20 54 63 6c 54 4c 53 20 31 2e 38 20 61 6e 64 0d TclTLS 1.8 and.
3b40: 0a 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e .earlier version
3b50: 73 20 69 73 20 3c 62 20 63 6c 61 73 73 3d 22 63 s is <b class="c
3b60: 6f 6e 73 74 22 3e 66 61 6c 73 65 3c 2f 62 3e 20 onst">false</b>
3b70: 73 69 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 70 6c since not all pl
3b80: 61 74 66 6f 72 6d 73 20 68 61 76 65 20 63 65 72 atforms have cer
3b90: 74 69 66 69 63 61 74 65 73 20 74 6f 0d 0a 76 61 tificates to..va
3ba0: 6c 69 64 61 74 65 20 61 67 61 69 6e 73 74 20 69 lidate against i
3bb0: 6e 20 61 20 66 6f 72 6d 20 63 6f 6d 70 61 74 69 n a form compati
3bc0: 62 6c 65 20 77 69 74 68 20 4f 70 65 6e 53 53 4c ble with OpenSSL
3bd0: 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 . Starting in Tc
3be0: 6c 54 4c 53 20 32 2e 30 2c 0d 0a 74 68 65 20 64 lTLS 2.0,..the d
3bf0: 65 66 61 75 6c 74 20 69 73 20 3c 62 20 63 6c 61 efault is <b cla
3c00: 73 73 3d 22 63 6f 6e 73 74 22 3e 74 72 75 65 3c ss="const">true<
3c10: 2f 62 3e 20 66 6f 72 20 63 6c 69 65 6e 74 20 63 /b> for client c
3c20: 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0d 0a 53 65 65 onnections...See
3c30: 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 73 65 <span class="se
3c40: 63 74 72 65 66 22 3e 3c 61 20 68 72 65 66 3d 22 ctref"><a href="
3c50: 23 73 65 63 74 69 6f 6e 34 22 3e 43 65 72 74 69 #section4">Certi
3c60: 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 6f ficate Validatio
3c70: 6e 3c 2f 61 3e 3c 2f 73 70 61 6e 3e 20 66 6f 72 n</a></span> for
3c80: 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 3c 2f more details.</
3c90: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
3ca0: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
3cb0: 73 65 63 75 72 69 74 79 5f 6c 65 76 65 6c 3c 2f security_level</
3cc0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
3cd0: 22 3e 69 6e 74 65 67 65 72 3c 2f 69 3e 3c 2f 64 ">integer</i></d
3ce0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 63 69 t>..<dd><p>Speci
3cf0: 66 69 65 73 20 74 68 65 20 73 65 63 75 72 69 74 fies the securit
3d00: 79 20 6c 65 76 65 6c 20 28 76 61 6c 75 65 20 66 y level (value f
3d10: 72 6f 6d 20 30 20 74 6f 20 35 29 2e 20 54 68 65 rom 0 to 5). The
3d20: 20 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 security level
3d30: 61 66 66 65 63 74 73 0d 0a 74 68 65 20 61 6c 6c affects..the all
3d40: 6f 77 65 64 20 63 69 70 68 65 72 20 73 75 69 74 owed cipher suit
3d50: 65 20 65 6e 63 72 79 70 74 69 6f 6e 20 61 6c 67 e encryption alg
3d60: 6f 72 69 74 68 6d 73 2c 20 73 75 70 70 6f 72 74 orithms, support
3d70: 65 64 20 45 43 43 20 63 75 72 76 65 73 2c 0d 0a ed ECC curves,..
3d80: 73 75 70 70 6f 72 74 65 64 20 73 69 67 6e 61 74 supported signat
3d90: 75 72 65 20 61 6c 67 6f 72 69 74 68 6d 73 2c 20 ure algorithms,
3da0: 44 48 20 70 61 72 61 6d 65 74 65 72 20 73 69 7a DH parameter siz
3db0: 65 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 20 es, certificate
3dc0: 6b 65 79 20 73 69 7a 65 73 0d 0a 61 6e 64 20 73 key sizes..and s
3dd0: 69 67 6e 61 74 75 72 65 20 61 6c 67 6f 72 69 74 ignature algorit
3de0: 68 6d 73 2e 20 54 68 65 20 64 65 66 61 75 6c 74 hms. The default
3df0: 20 69 73 20 31 20 70 72 69 6f 72 20 74 6f 20 4f is 1 prior to O
3e00: 70 65 6e 53 53 4c 20 33 2e 32 20 61 6e 64 20 32 penSSL 3.2 and 2
3e10: 0d 0a 74 68 65 72 65 61 66 74 65 72 2e 20 4c 65 ..thereafter. Le
3e20: 76 65 6c 20 33 20 61 6e 64 20 68 69 67 68 65 72 vel 3 and higher
3e30: 20 64 69 73 61 62 6c 65 20 73 75 70 70 6f 72 74 disable support
3e40: 20 66 6f 72 20 73 65 73 73 69 6f 6e 20 74 69 63 for session tic
3e50: 6b 65 74 73 20 61 6e 64 0d 0a 6f 6e 6c 79 20 61 kets and..only a
3e60: 63 63 65 70 74 20 63 69 70 68 65 72 20 73 75 69 ccept cipher sui
3e70: 74 65 73 20 74 68 61 74 20 70 72 6f 76 69 64 65 tes that provide
3e80: 20 66 6f 72 77 61 72 64 20 73 65 63 72 65 63 79 forward secrecy
3e90: 2e 0d 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 ...This option i
3ea0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
3eb0: 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 1.8.</p></dd>..
3ec0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 <dt><b class="op
3ed0: 74 69 6f 6e 22 3e 2d 73 65 72 76 65 72 3c 2f 62 tion">-server</b
3ee0: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
3ef0: 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >bool</i></dt>..
3f00: 3c 64 64 3e 3c 70 3e 53 70 65 63 69 66 69 65 73 <dd><p>Specifies
3f10: 20 77 68 65 74 68 65 72 20 74 6f 20 61 63 74 20 whether to act
3f20: 61 73 20 61 20 73 65 72 76 65 72 20 61 6e 64 20 as a server and
3f30: 72 65 73 70 6f 6e 64 20 77 69 74 68 20 61 20 73 respond with a s
3f40: 65 72 76 65 72 20 68 61 6e 64 73 68 61 6b 65 20 erver handshake
3f50: 77 68 65 6e 20 61 0d 0a 63 6c 69 65 6e 74 20 63 when a..client c
3f60: 6f 6e 6e 65 63 74 73 20 61 6e 64 20 70 72 6f 76 onnects and prov
3f70: 69 64 65 73 20 61 20 63 6c 69 65 6e 74 20 68 61 ides a client ha
3f80: 6e 64 73 68 61 6b 65 2e 20 54 68 65 20 64 65 66 ndshake. The def
3f90: 61 75 6c 74 20 69 73 20 3c 62 20 63 6c 61 73 73 ault is <b class
3fa0: 3d 22 63 6f 6e 73 74 22 3e 66 61 6c 73 65 3c 2f ="const">false</
3fb0: 62 3e 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 b>.</p></dd>..<d
3fc0: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 t><b class="opti
3fd0: 6f 6e 22 3e 2d 73 65 72 76 65 72 6e 61 6d 65 3c on">-servername<
3fe0: 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 /b> <i class="ar
3ff0: 67 22 3e 68 6f 73 74 6e 61 6d 65 3c 2f 69 3e 3c g">hostname</i><
4000: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 /dt>..<dd><p>Spe
4010: 63 69 66 79 20 74 68 65 20 70 65 65 72 27 73 20 cify the peer's
4020: 68 6f 73 74 6e 61 6d 65 2e 20 54 68 69 73 20 69 hostname. This i
4030: 73 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 s used to set th
4040: 65 20 54 4c 53 20 53 65 72 76 65 72 20 4e 61 6d e TLS Server Nam
4050: 65 20 49 6e 64 69 63 61 74 69 6f 6e 0d 0a 28 53 e Indication..(S
4060: 4e 49 29 20 65 78 74 65 6e 73 69 6f 6e 2e 20 53 NI) extension. S
4070: 65 74 20 74 68 69 73 20 74 6f 20 74 68 65 20 65 et this to the e
4080: 78 70 65 63 74 65 64 20 73 65 72 76 65 72 6e 61 xpected serverna
4090: 6d 65 20 69 6e 20 74 68 65 20 73 65 72 76 65 72 me in the server
40a0: 27 73 20 63 65 72 74 69 66 69 63 61 74 65 0d 0a 's certificate..
40b0: 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 75 or one of the Su
40c0: 62 6a 65 63 74 20 41 6c 74 65 72 6e 61 74 65 20 bject Alternate
40d0: 4e 61 6d 65 73 20 28 53 41 4e 29 2e 20 53 74 61 Names (SAN). Sta
40e0: 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 rting in TclTLS
40f0: 32 2e 30 2c 20 74 68 69 73 20 77 69 6c 6c 0d 0a 2.0, this will..
4100: 64 65 66 61 75 6c 74 20 74 6f 20 74 68 65 20 68 default to the h
4110: 6f 73 74 20 66 72 6f 6d 20 74 68 65 20 3c 62 20 ost from the <b
4120: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
4130: 3a 73 6f 63 6b 65 74 3c 2f 62 3e 20 63 6f 6d 6d :socket</b> comm
4140: 61 6e 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c and.</p></dd>..<
4150: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 dt><b class="opt
4160: 69 6f 6e 22 3e 2d 73 65 73 73 69 6f 6e 5f 69 64 ion">-session_id
4170: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
4180: 72 67 22 3e 62 69 6e 61 72 79 5f 73 74 72 69 6e rg">binary_strin
4190: 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e g</i></dt>..<dd>
41a0: 3c 70 3e 53 70 65 63 69 66 69 65 73 20 74 68 65 <p>Specifies the
41b0: 20 73 65 73 73 69 6f 6e 20 69 64 20 74 6f 20 72 session id to r
41c0: 65 73 75 6d 65 20 61 20 73 65 73 73 69 6f 6e 2e esume a session.
41d0: 20 4e 6f 74 20 73 75 70 70 6f 72 74 65 64 20 79 Not supported y
41e0: 65 74 2e 0d 0a 54 68 69 73 20 6f 70 74 69 6f 6e et...This option
41f0: 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 is new for TclT
4200: 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e LS 1.8.</p></dd>
4210: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
4220: 6f 70 74 69 6f 6e 22 3e 2d 73 73 6c 32 3c 2f 62 option">-ssl2</b
4230: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
4240: 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >bool</i></dt>..
4250: 3c 64 64 3e 3c 70 3e 45 6e 61 62 6c 65 20 75 73 <dd><p>Enable us
4260: 65 20 6f 66 20 53 53 4c 20 76 32 2e 54 68 65 20 e of SSL v2.The
4270: 64 65 66 61 75 6c 74 20 69 73 20 3c 62 20 63 6c default is <b cl
4280: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 66 61 6c 73 ass="const">fals
4290: 65 3c 2f 62 3e 2e 0d 0a 4f 70 65 6e 53 53 4c 20 e</b>...OpenSSL
42a0: 31 2e 31 2b 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 1.1+ no longer s
42b0: 75 70 70 6f 72 74 73 20 53 53 4c 20 76 32 2c 20 upports SSL v2,
42c0: 73 6f 20 74 68 69 73 20 6d 61 79 20 6e 6f 74 20 so this may not
42d0: 68 61 76 65 20 61 6e 79 20 65 66 66 65 63 74 2e have any effect.
42e0: 0d 0a 53 65 65 20 74 68 65 20 3c 62 20 63 6c 61 ..See the <b cla
42f0: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 70 72 ss="cmd">tls::pr
4300: 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 20 63 6f 6d 6d otocols</b> comm
4310: 61 6e 64 20 66 6f 72 20 73 75 70 70 6f 72 74 65 and for supporte
4320: 64 20 70 72 6f 74 6f 63 6f 6c 73 2e 3c 2f 70 3e d protocols.</p>
4330: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
4340: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 73 73 ass="option">-ss
4350: 6c 33 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d l3</b> <i class=
4360: 22 61 72 67 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f "arg">bool</i></
4370: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 45 6e 61 62 dt>..<dd><p>Enab
4380: 6c 65 20 75 73 65 20 6f 66 20 53 53 4c 20 76 33 le use of SSL v3
4390: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 . The default is
43a0: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
43b0: 22 3e 66 61 6c 73 65 3c 2f 62 3e 2e 20 53 74 61 ">false</b>. Sta
43c0: 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 rting in TclTLS
43d0: 31 2e 38 2c 0d 0a 75 73 65 20 6f 66 20 53 53 4c 1.8,..use of SSL
43e0: 20 76 33 20 69 66 20 6f 6e 6c 79 20 61 76 61 69 v3 if only avai
43f0: 6c 61 62 6c 65 20 76 69 61 20 61 20 63 6f 6d 70 lable via a comp
4400: 69 6c 65 20 74 69 6d 65 20 6f 70 74 69 6f 6e 2e ile time option.
4410: 0d 0a 53 65 65 20 74 68 65 20 3c 62 20 63 6c 61 ..See the <b cla
4420: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 70 72 ss="cmd">tls::pr
4430: 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 20 63 6f 6d 6d otocols</b> comm
4440: 61 6e 64 20 66 6f 72 20 73 75 70 70 6f 72 74 65 and for supporte
4450: 64 20 70 72 6f 74 6f 63 6f 6c 73 2e 3c 2f 70 3e d protocols.</p>
4460: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
4470: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 74 6c ass="option">-tl
4480: 73 31 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d s1</b> <i class=
4490: 22 61 72 67 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f "arg">bool</i></
44a0: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 45 6e 61 62 dt>..<dd><p>Enab
44b0: 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 le use of TLS v1
44c0: 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 . Starting in Tc
44d0: 6c 54 4c 53 20 32 2e 30 2c 20 74 68 65 20 64 65 lTLS 2.0, the de
44e0: 66 61 75 6c 74 20 69 73 20 3c 62 20 63 6c 61 73 fault is <b clas
44f0: 73 3d 22 63 6f 6e 73 74 22 3e 66 61 6c 73 65 3c s="const">false<
4500: 2f 62 3e 2e 0d 0a 4e 6f 74 65 3a 20 54 4c 53 20 /b>...Note: TLS
4510: 31 2e 30 20 6e 65 65 64 73 20 53 48 41 31 20 74 1.0 needs SHA1 t
4520: 6f 20 6f 70 65 72 61 74 65 2c 20 77 68 69 63 68 o operate, which
4530: 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 is only availab
4540: 6c 65 20 69 6e 20 73 65 63 75 72 69 74 79 20 6c le in security l
4550: 65 76 65 6c 0d 0a 30 20 66 6f 72 20 4f 70 65 6e evel..0 for Open
4560: 20 53 53 4c 20 33 2e 30 2b 2e 20 53 65 65 20 74 SSL 3.0+. See t
4570: 68 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 he <b class="opt
4580: 69 6f 6e 22 3e 2d 73 65 63 75 72 69 74 79 5f 6c ion">-security_l
4590: 65 76 65 6c 3c 2f 62 3e 20 6f 70 74 69 6f 6e 2e evel</b> option.
45a0: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
45b0: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
45c0: 3e 2d 74 6c 73 31 2e 31 3c 2f 62 3e 20 3c 69 20 >-tls1.1</b> <i
45d0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 62 6f 6f 6c class="arg">bool
45e0: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
45f0: 70 3e 45 6e 61 62 6c 65 20 75 73 65 20 6f 66 20 p>Enable use of
4600: 54 4c 53 20 76 31 2e 31 2e 20 53 74 61 72 74 69 TLS v1.1. Starti
4610: 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 32 2e 30 ng in TclTLS 2.0
4620: 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 , the default is
4630: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
4640: 22 3e 66 61 6c 73 65 3c 2f 62 3e 2e 0d 0a 4e 6f ">false</b>...No
4650: 74 65 3a 20 54 4c 53 20 31 2e 31 20 6e 65 65 64 te: TLS 1.1 need
4660: 73 20 53 48 41 31 20 74 6f 20 6f 70 65 72 61 74 s SHA1 to operat
4670: 65 2c 20 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 e, which is only
4680: 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 73 65 available in se
4690: 63 75 72 69 74 79 20 6c 65 76 65 6c 0d 0a 30 20 curity level..0
46a0: 66 6f 72 20 4f 70 65 6e 20 53 53 4c 20 33 2e 30 for Open SSL 3.0
46b0: 2b 2e 20 53 65 65 20 74 68 65 20 3c 62 20 63 6c +. See the <b cl
46c0: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 73 65 ass="option">-se
46d0: 63 75 72 69 74 79 5f 6c 65 76 65 6c 3c 2f 62 3e curity_level</b>
46e0: 20 6f 70 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 option.</p></dd
46f0: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
4700: 22 6f 70 74 69 6f 6e 22 3e 2d 74 6c 73 31 2e 32 "option">-tls1.2
4710: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
4720: 72 67 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 rg">bool</i></dt
4730: 3e 0d 0a 3c 64 64 3e 3c 70 3e 45 6e 61 62 6c 65 >..<dd><p>Enable
4740: 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 2e 32 use of TLS v1.2
4750: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 . The default is
4760: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
4770: 22 3e 74 72 75 65 3c 2f 62 3e 2e 3c 2f 70 3e 3c ">true</b>.</p><
4780: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
4790: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 74 6c 73 ss="option">-tls
47a0: 31 2e 33 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 1.3</b> <i class
47b0: 3d 22 61 72 67 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c ="arg">bool</i><
47c0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 45 6e 61 /dt>..<dd><p>Ena
47d0: 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 76 ble use of TLS v
47e0: 31 2e 33 2e 20 54 68 65 20 64 65 66 61 75 6c 74 1.3. The default
47f0: 20 69 73 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f is <b class="co
4800: 6e 73 74 22 3e 74 72 75 65 3c 2f 62 3e 2e 20 54 nst">true</b>. T
4810: 68 69 73 20 69 73 20 6f 6e 6c 79 20 61 76 61 69 his is only avai
4820: 6c 61 62 6c 65 0d 0a 73 74 61 72 74 69 6e 67 20 lable..starting
4830: 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 31 2e 31 with OpenSSL 1.1
4840: 2e 31 20 61 6e 64 20 54 63 6c 54 4c 53 20 31 2e .1 and TclTLS 1.
4850: 37 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 7.</p></dd>..<dt
4860: 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f ><b class="optio
4870: 6e 22 3e 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d n">-validatecomm
4880: 61 6e 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 and</b> <i class
4890: 3d 22 61 72 67 22 3e 63 61 6c 6c 62 61 63 6b 3c ="arg">callback<
48a0: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
48b0: 3e 53 70 65 63 69 66 69 65 73 20 74 68 65 20 63 >Specifies the c
48c0: 61 6c 6c 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 allback command
48d0: 74 6f 20 69 6e 76 6f 6b 65 20 74 6f 20 76 61 6c to invoke to val
48e0: 69 64 61 74 65 20 74 68 65 20 70 65 65 72 20 63 idate the peer c
48f0: 65 72 74 69 66 69 63 61 74 65 73 0d 0a 61 6e 64 ertificates..and
4900: 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 20 69 6e other config in
4910: 66 6f 20 64 75 72 69 6e 67 20 74 68 65 20 70 72 fo during the pr
4920: 6f 74 6f 63 6f 6c 20 6e 65 67 6f 74 69 61 74 69 otocol negotiati
4930: 6f 6e 20 70 68 61 73 65 2e 20 54 68 69 73 20 63 on phase. This c
4940: 61 6e 20 62 65 20 75 73 65 64 0d 0a 62 79 20 54 an be used..by T
4950: 43 4c 20 73 63 72 69 70 74 73 20 74 6f 20 70 65 CL scripts to pe
4960: 72 66 6f 72 6d 20 74 68 65 69 72 20 6f 77 6e 20 rform their own
4970: 43 65 72 74 69 66 69 63 61 74 65 20 56 61 6c 69 Certificate Vali
4980: 64 61 74 69 6f 6e 20 74 6f 20 73 75 70 70 6c 65 dation to supple
4990: 6d 65 6e 74 20 74 68 65 0d 0a 64 65 66 61 75 6c ment the..defaul
49a0: 74 20 76 61 6c 69 64 61 74 69 6f 6e 20 70 72 6f t validation pro
49b0: 76 69 64 65 64 20 62 79 20 4f 70 65 6e 53 53 4c vided by OpenSSL
49c0: 2e 20 54 68 65 20 73 63 72 69 70 74 20 6d 75 73 . The script mus
49d0: 74 20 72 65 74 75 72 6e 20 61 20 62 6f 6f 6c 65 t return a boole
49e0: 61 6e 20 74 72 75 65 0d 0a 74 6f 20 63 6f 6e 74 an true..to cont
49f0: 69 6e 75 65 20 74 68 65 20 6e 65 67 6f 74 69 61 inue the negotia
4a00: 74 69 6f 6e 2e 20 53 65 65 20 3c 73 70 61 6e 20 tion. See <span
4a10: 63 6c 61 73 73 3d 22 73 65 63 74 72 65 66 22 3e class="sectref">
4a20: 3c 61 20 68 72 65 66 3d 22 23 73 65 63 74 69 6f <a href="#sectio
4a30: 6e 35 22 3e 43 61 6c 6c 62 61 63 6b 20 4f 70 74 n5">Callback Opt
4a40: 69 6f 6e 73 3c 2f 61 3e 3c 2f 73 70 61 6e 3e 20 ions</a></span>
4a50: 66 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 2e 0d 0a for more info...
4a60: 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e This option is n
4a70: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
4a80: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 8.</p></dd>..</d
4a90: 6c 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 61 20 l></dd>..<dt><a
4aa0: 6e 61 6d 65 3d 22 36 22 3e 3c 62 20 63 6c 61 73 name="6"><b clas
4ab0: 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 68 61 6e s="cmd">tls::han
4ac0: 64 73 68 61 6b 65 3c 2f 62 3e 20 3c 69 20 63 6c dshake</b> <i cl
4ad0: 61 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 ass="arg">channe
4ae0: 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 3e 0d 0a l</i></a></dt>..
4af0: 3c 64 64 3e 3c 70 3e 46 6f 72 63 65 73 20 74 68 <dd><p>Forces th
4b00: 65 20 54 4c 53 20 6e 65 67 6f 74 69 61 74 69 6f e TLS negotiatio
4b10: 6e 20 68 61 6e 64 73 68 61 6b 65 20 74 6f 20 74 n handshake to t
4b20: 61 6b 65 20 70 6c 61 63 65 20 69 6d 6d 65 64 69 ake place immedi
4b30: 61 74 65 6c 79 2c 20 61 6e 64 20 72 65 74 75 72 ately, and retur
4b40: 6e 73 20 30 0d 0a 69 66 20 68 61 6e 64 73 68 61 ns 0..if handsha
4b50: 6b 65 20 69 73 20 73 74 69 6c 6c 20 69 6e 20 70 ke is still in p
4b60: 72 6f 67 72 65 73 73 20 28 6e 6f 6e 2d 62 6c 6f rogress (non-blo
4b70: 63 6b 69 6e 67 29 2c 20 6f 72 20 31 20 69 66 20 cking), or 1 if
4b80: 74 68 65 20 68 61 6e 64 73 68 61 6b 65 20 77 61 the handshake wa
4b90: 73 0d 0a 73 75 63 63 65 73 73 66 75 6c 2e 20 49 s..successful. I
4ba0: 66 20 74 68 65 20 68 61 6e 64 73 68 61 6b 65 20 f the handshake
4bb0: 66 61 69 6c 65 64 2c 20 61 6e 20 65 72 72 6f 72 failed, an error
4bc0: 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
4bd0: 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 d.</p></dd>..<dt
4be0: 3e 3c 61 20 6e 61 6d 65 3d 22 37 22 3e 3c 62 20 ><a name="7"><b
4bf0: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
4c00: 3a 73 68 75 74 64 6f 77 6e 3c 2f 62 3e 20 3c 69 :shutdown</b> <i
4c10: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 61 class="arg">cha
4c20: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 nnel</i></a></dt
4c30: 3e 0d 0a 3c 64 64 3e 3c 2f 64 64 3e 0d 0a 3c 64 >..<dd></dd>..<d
4c40: 74 3e 3c 61 20 6e 61 6d 65 3d 22 38 22 3e 3c 62 t><a name="8"><b
4c50: 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 class="cmd">tls
4c60: 3a 3a 75 6e 69 6d 70 6f 72 74 3c 2f 62 3e 20 3c ::unimport</b> <
4c70: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 i class="arg">ch
4c80: 61 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 annel</i></a></d
4c90: 74 3e 0d 0a 3c 64 64 3e 3c 2f 64 64 3e 0d 0a 3c t>..<dd></dd>..<
4ca0: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 39 22 3e 3c dt><a name="9"><
4cb0: 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c b class="cmd">tl
4cc0: 73 3a 3a 75 6e 73 74 61 63 6b 3c 2f 62 3e 20 3c s::unstack</b> <
4cd0: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 i class="arg">ch
4ce0: 61 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 annel</i></a></d
4cf0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 69 73 20 t>..<dd><p>This
4d00: 74 65 72 6d 69 6e 61 74 65 73 20 74 68 65 20 53 terminates the S
4d10: 53 4c 2f 54 4c 53 20 73 65 73 73 69 6f 6e 20 62 SL/TLS session b
4d20: 79 20 73 65 6e 64 69 6e 67 20 74 68 65 20 26 71 y sending the &q
4d30: 75 6f 74 3b 63 6c 6f 73 65 5f 6e 6f 74 69 66 79 uot;close_notify
4d40: 26 71 75 6f 74 3b 20 6d 65 73 73 61 67 65 20 61 " message a
4d50: 6e 64 0d 0a 72 65 6d 6f 76 65 73 20 74 68 65 20 nd..removes the
4d60: 74 6f 70 20 6c 65 76 65 6c 20 73 74 61 63 6b 65 top level stacke
4d70: 64 20 63 68 61 6e 6e 65 6c 20 66 72 6f 6d 20 3c d channel from <
4d80: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 i class="arg">ch
4d90: 61 6e 6e 65 6c 3c 2f 69 3e 2c 20 62 75 74 20 69 annel</i>, but i
4da0: 74 20 64 6f 65 73 20 6e 6f 74 20 63 6c 6f 73 65 t does not close
4db0: 0d 0a 74 68 65 20 73 6f 63 6b 65 74 2e 20 49 74 ..the socket. It
4dc0: 20 69 73 20 74 68 65 20 63 6f 6d 70 6c 69 6d 65 is the complime
4dd0: 6e 74 20 74 6f 20 3c 62 20 63 6c 61 73 73 3d 22 nt to <b class="
4de0: 63 6d 64 22 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 cmd">tls::import
4df0: 3c 2f 62 3e 20 62 79 20 65 6e 64 69 6e 67 20 65 </b> by ending e
4e00: 6e 63 72 79 70 74 69 6f 6e 20 6f 66 0d 0a 61 20 ncryption of..a
4e10: 54 43 4c 20 63 68 61 6e 6e 65 6c 2e 20 41 6e 20 TCL channel. An
4e20: 65 72 72 6f 72 20 69 73 20 74 68 72 6f 77 6e 20 error is thrown
4e30: 69 66 20 54 4c 53 20 69 73 20 6e 6f 74 20 74 68 if TLS is not th
4e40: 65 20 74 6f 70 20 73 74 61 63 6b 65 64 20 63 68 e top stacked ch
4e50: 61 6e 6e 65 6c 20 74 79 70 65 2e 3c 2f 70 3e 3c annel type.</p><
4e60: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 61 20 6e 61 6d /dd>..<dt><a nam
4e70: 65 3d 22 31 30 22 3e 3c 62 20 63 6c 61 73 73 3d e="10"><b class=
4e80: 22 63 6d 64 22 3e 74 6c 73 3a 3a 73 74 61 74 75 "cmd">tls::statu
4e90: 73 3c 2f 62 3e 20 3c 73 70 61 6e 20 63 6c 61 73 s</b> <span clas
4ea0: 73 3d 22 6f 70 74 22 3e 3f 3c 62 20 63 6c 61 73 s="opt">?<b clas
4eb0: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 6c 6f 63 61 s="option">-loca
4ec0: 6c 3c 2f 62 3e 3f 3c 2f 73 70 61 6e 3e 20 3c 69 l</b>?</span> <i
4ed0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 61 class="arg">cha
4ee0: 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c 2f 64 74 nnel</i></a></dt
4ef0: 3e 0d 0a 3c 64 64 3e 3c 70 3e 52 65 74 75 72 6e >..<dd><p>Return
4f00: 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 74 s the current st
4f10: 61 74 75 73 20 6f 66 20 61 6e 20 53 53 4c 20 63 atus of an SSL c
4f20: 68 61 6e 6e 65 6c 2e 20 54 68 65 20 72 65 73 75 hannel. The resu
4f30: 6c 74 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 lt is a list of
4f40: 6b 65 79 2d 76 61 6c 75 65 0d 0a 70 61 69 72 73 key-value..pairs
4f50: 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 20 describing the
4f60: 53 53 4c 2c 20 63 65 72 74 69 66 69 63 61 74 65 SSL, certificate
4f70: 2c 20 61 6e 64 20 63 65 72 74 69 66 69 63 61 74 , and certificat
4f80: 65 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 73 e verification s
4f90: 74 61 74 75 73 2e 20 49 66 0d 0a 74 68 65 20 53 tatus. If..the S
4fa0: 53 4c 20 68 61 6e 64 73 68 61 6b 65 20 68 61 73 SL handshake has
4fb0: 20 6e 6f 74 20 79 65 74 20 63 6f 6d 70 6c 65 74 not yet complet
4fc0: 65 64 2c 20 61 6e 20 65 6d 70 74 79 20 6c 69 73 ed, an empty lis
4fd0: 74 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 t is returned. I
4fe0: 66 20 74 68 65 0d 0a 3c 62 20 63 6c 61 73 73 3d f the..<b class=
4ff0: 22 6f 70 74 69 6f 6e 22 3e 2d 6c 6f 63 61 6c 3c "option">-local<
5000: 2f 62 3e 20 6f 70 74 69 6f 6e 20 69 73 20 73 70 /b> option is sp
5010: 65 63 69 66 69 65 64 2c 20 74 68 65 6e 20 74 68 ecified, then th
5020: 65 20 6c 6f 63 61 6c 20 63 65 72 74 69 66 69 63 e local certific
5030: 61 74 65 20 69 73 20 75 73 65 64 2e 0d 0a 52 65 ate is used...Re
5040: 74 75 72 6e 65 64 20 76 61 6c 75 65 73 20 69 6e turned values in
5050: 63 6c 75 64 65 3a 3c 2f 70 3e 0d 0a 3c 70 3e 53 clude:</p>..<p>S
5060: 53 4c 20 53 74 61 74 75 73 3c 2f 70 3e 0d 0a 3c SL Status</p>..<
5070: 64 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f dl class="doctoo
5080: 6c 73 5f 64 65 66 69 6e 69 74 69 6f 6e 73 22 3e ls_definitions">
5090: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
50a0: 76 61 72 69 61 62 6c 65 22 3e 61 6c 70 6e 3c 2f variable">alpn</
50b0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
50c0: 22 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 69 3e 3c 2f ">protocol</i></
50d0: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 dt>..<dd><p>The
50e0: 70 72 6f 74 6f 63 6f 6c 20 73 65 6c 65 63 74 65 protocol selecte
50f0: 64 20 61 66 74 65 72 20 41 70 70 6c 69 63 61 74 d after Applicat
5100: 69 6f 6e 2d 4c 61 79 65 72 20 50 72 6f 74 6f 63 ion-Layer Protoc
5110: 6f 6c 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 28 ol Negotiation (
5120: 41 4c 50 4e 29 2e 0d 0a 54 68 69 73 20 76 61 6c ALPN)...This val
5130: 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 ue is new for Tc
5140: 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 lTLS 1.8.</p></d
5150: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
5160: 3d 22 76 61 72 69 61 62 6c 65 22 3e 63 69 70 68 ="variable">ciph
5170: 65 72 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d er</b> <i class=
5180: 22 61 72 67 22 3e 63 69 70 68 65 72 3c 2f 69 3e "arg">cipher</i>
5190: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 </dt>..<dd><p>Th
51a0: 65 20 63 75 72 72 65 6e 74 20 63 69 70 68 65 72 e current cipher
51b0: 20 69 6e 20 75 73 65 20 66 6f 72 20 74 68 65 20 in use for the
51c0: 73 65 73 73 69 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 session.</p></dd
51d0: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
51e0: 22 76 61 72 69 61 62 6c 65 22 3e 70 65 65 72 6e "variable">peern
51f0: 61 6d 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ame</b> <i class
5200: 3d 22 61 72 67 22 3e 6e 61 6d 65 3c 2f 69 3e 3c ="arg">name</i><
5210: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 /dt>..<dd><p>The
5220: 20 70 65 65 72 6e 61 6d 65 20 66 72 6f 6d 20 74 peername from t
5230: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 2e 0d he certificate..
5240: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5250: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
5260: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 8.</p></dd>..<dt
5270: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5280: 62 6c 65 22 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 62 ble">protocol</b
5290: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
52a0: 3e 76 65 72 73 69 6f 6e 3c 2f 69 3e 3c 2f 64 74 >version</i></dt
52b0: 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 70 72 >..<dd><p>The pr
52c0: 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 75 otocol version u
52d0: 73 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e sed for the conn
52e0: 65 63 74 69 6f 6e 3a 20 53 53 4c 32 2c 20 53 53 ection: SSL2, SS
52f0: 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 31 2e 31 L3, TLS1, TLS1.1
5300: 2c 20 54 4c 53 31 2e 32 2c 0d 0a 54 4c 53 31 2e , TLS1.2,..TLS1.
5310: 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 2e 20 54 3, or unknown. T
5320: 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 his value is new
5330: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e for TclTLS 1.8.
5340: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
5350: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
5360: 65 22 3e 73 62 69 74 73 3c 2f 62 3e 20 3c 69 20 e">sbits</b> <i
5370: 63 6c 61 73 73 3d 22 61 72 67 22 3e 6e 3c 2f 69 class="arg">n</i
5380: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 ></dt>..<dd><p>T
5390: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 69 74 he number of bit
53a0: 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 73 s used for the s
53b0: 65 73 73 69 6f 6e 20 6b 65 79 2e 3c 2f 70 3e 3c ession key.</p><
53c0: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
53d0: 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 73 69 ss="variable">si
53e0: 67 6e 61 74 75 72 65 48 61 73 68 41 6c 67 6f 72 gnatureHashAlgor
53f0: 69 74 68 6d 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 ithm</b> <i clas
5400: 73 3d 22 61 72 67 22 3e 61 6c 67 6f 72 69 74 68 s="arg">algorith
5410: 6d 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e m</i></dt>..<dd>
5420: 3c 70 3e 54 68 65 20 73 69 67 6e 61 74 75 72 65 <p>The signature
5430: 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 2e hash algorithm.
5440: 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
5450: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
5460: 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 .8.</p></dd>..<d
5470: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 t><b class="vari
5480: 61 62 6c 65 22 3e 73 69 67 6e 61 74 75 72 65 54 able">signatureT
5490: 79 70 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ype</b> <i class
54a0: 3d 22 61 72 67 22 3e 74 79 70 65 3c 2f 69 3e 3c ="arg">type</i><
54b0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 /dt>..<dd><p>The
54c0: 20 73 69 67 6e 61 74 75 72 65 20 74 79 70 65 20 signature type
54d0: 76 61 6c 75 65 2e 0d 0a 54 68 69 73 20 76 61 6c value...This val
54e0: 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 ue is new for Tc
54f0: 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 lTLS 1.8.</p></d
5500: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
5510: 3d 22 76 61 72 69 61 62 6c 65 22 3e 76 65 72 69 ="variable">veri
5520: 66 79 44 65 70 74 68 3c 2f 62 3e 20 3c 69 20 63 fyDepth</b> <i c
5530: 6c 61 73 73 3d 22 61 72 67 22 3e 6e 3c 2f 69 3e lass="arg">n</i>
5540: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 4d 61 </dt>..<dd><p>Ma
5550: 78 69 6d 75 6d 20 64 65 70 74 68 20 66 6f 72 20 ximum depth for
5560: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
5570: 63 68 61 69 6e 20 76 65 72 69 66 69 63 61 74 69 chain verificati
5580: 6f 6e 2e 20 44 65 66 61 75 6c 74 20 69 73 20 2d on. Default is -
5590: 31 2c 20 74 6f 20 63 68 65 63 6b 20 61 6c 6c 2e 1, to check all.
55a0: 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
55b0: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
55c0: 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 .8.</p></dd>..<d
55d0: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 t><b class="vari
55e0: 61 62 6c 65 22 3e 76 65 72 69 66 79 4d 6f 64 65 able">verifyMode
55f0: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
5600: 72 67 22 3e 6c 69 73 74 3c 2f 69 3e 3c 2f 64 74 rg">list</i></dt
5610: 3e 0d 0a 3c 64 64 3e 3c 70 3e 4c 69 73 74 20 6f >..<dd><p>List o
5620: 66 20 63 65 72 74 69 66 69 63 61 74 65 20 76 65 f certificate ve
5630: 72 69 66 69 63 61 74 69 6f 6e 20 6d 6f 64 65 73 rification modes
5640: 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 ...This value is
5650: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
5660: 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 1.8.</p></dd>..<
5670: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 dt><b class="var
5680: 69 61 62 6c 65 22 3e 76 65 72 69 66 79 52 65 73 iable">verifyRes
5690: 75 6c 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ult</b> <i class
56a0: 3d 22 61 72 67 22 3e 72 65 73 75 6c 74 3c 2f 69 ="arg">result</i
56b0: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 ></dt>..<dd><p>C
56c0: 65 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 ertificate verif
56d0: 69 63 61 74 69 6f 6e 20 72 65 73 75 6c 74 2e 0d ication result..
56e0: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
56f0: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
5700: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 8.</p></dd>..<dt
5710: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5720: 62 6c 65 22 3e 63 61 5f 6e 61 6d 65 73 3c 2f 62 ble">ca_names</b
5730: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
5740: 3e 6c 69 73 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >list</i></dt>..
5750: 3c 64 64 3e 3c 70 3e 4c 69 73 74 20 6f 66 20 74 <dd><p>List of t
5760: 68 65 20 43 65 72 74 69 66 69 63 61 74 65 20 41 he Certificate A
5770: 75 74 68 6f 72 69 74 69 65 73 20 75 73 65 64 20 uthorities used
5780: 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 63 65 to create the ce
5790: 72 74 69 66 69 63 61 74 65 2e 0d 0a 54 68 69 73 rtificate...This
57a0: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
57b0: 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 r TclTLS 1.8.</p
57c0: 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 0d 0a 3c ></dd>..</dl>..<
57d0: 70 3e 43 65 72 74 69 66 69 63 61 74 65 20 53 74 p>Certificate St
57e0: 61 74 75 73 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c atus</p>..<dl cl
57f0: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 ass="doctools_de
5800: 66 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 finitions">..<dt
5810: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5820: 62 6c 65 22 3e 61 6c 6c 3c 2f 62 3e 20 3c 69 20 ble">all</b> <i
5830: 63 6c 61 73 73 3d 22 61 72 67 22 3e 73 74 72 69 class="arg">stri
5840: 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 ng</i></dt>..<dd
5850: 3e 3c 70 3e 44 75 6d 70 20 6f 66 20 61 6c 6c 20 ><p>Dump of all
5860: 63 65 72 74 69 66 69 63 61 74 65 20 69 6e 66 6f certificate info
5870: 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 ...This value is
5880: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
5890: 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 1.8.</p></dd>..<
58a0: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 dt><b class="var
58b0: 69 61 62 6c 65 22 3e 76 65 72 73 69 6f 6e 3c 2f iable">version</
58c0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
58d0: 22 3e 76 61 6c 75 65 3c 2f 69 3e 3c 2f 64 74 3e ">value</i></dt>
58e0: 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 63 65 72 ..<dd><p>The cer
58f0: 74 69 66 69 63 61 74 65 20 76 65 72 73 69 6f 6e tificate version
5900: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
5910: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
5920: 6c 65 22 3e 73 65 72 69 61 6c 4e 75 6d 62 65 72 le">serialNumber
5930: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
5940: 72 67 22 3e 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f rg">string</i></
5950: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 dt>..<dd><p>The
5960: 73 65 72 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 serial number of
5970: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
5980: 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 as a hex string
5990: 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 77 61 ...This value wa
59a0: 73 20 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 73 s changed from s
59b0: 65 72 69 61 6c 20 69 6e 20 54 63 6c 54 4c 53 20 erial in TclTLS
59c0: 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 1.8.</p></dd>..<
59d0: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 dt><b class="var
59e0: 69 61 62 6c 65 22 3e 73 69 67 6e 61 74 75 72 65 iable">signature
59f0: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
5a00: 72 67 22 3e 61 6c 67 6f 72 69 74 68 6d 3c 2f 69 rg">algorithm</i
5a10: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 ></dt>..<dd><p>C
5a20: 69 70 68 65 72 20 61 6c 67 6f 72 69 74 68 6d 20 ipher algorithm
5a30: 75 73 65 64 20 66 6f 72 20 63 65 72 74 69 66 69 used for certifi
5a40: 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 2e 0d cate signature..
5a50: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5a60: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
5a70: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 8.</p></dd>..<dt
5a80: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5a90: 62 6c 65 22 3e 69 73 73 75 65 72 3c 2f 62 3e 20 ble">issuer</b>
5aa0: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 73 <i class="arg">s
5ab0: 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a tring</i></dt>..
5ac0: 3c 64 64 3e 3c 70 3e 54 68 65 20 64 69 73 74 69 <dd><p>The disti
5ad0: 6e 67 75 69 73 68 65 64 20 6e 61 6d 65 20 28 44 nguished name (D
5ae0: 4e 29 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 N) of the certif
5af0: 69 63 61 74 65 20 69 73 73 75 65 72 2e 3c 2f 70 icate issuer.</p
5b00: 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ></dd>..<dt><b c
5b10: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
5b20: 6e 6f 74 42 65 66 6f 72 65 3c 2f 62 3e 20 3c 69 notBefore</b> <i
5b30: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 64 61 74 class="arg">dat
5b40: 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e e</i></dt>..<dd>
5b50: 3c 70 3e 54 68 65 20 62 65 67 69 6e 6e 69 6e 67 <p>The beginning
5b60: 20 64 61 74 65 20 6f 66 20 74 68 65 20 63 65 72 date of the cer
5b70: 74 69 66 69 63 61 74 65 20 76 61 6c 69 64 69 74 tificate validit
5b80: 79 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 y.</p></dd>..<dt
5b90: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5ba0: 62 6c 65 22 3e 6e 6f 74 41 66 74 65 72 3c 2f 62 ble">notAfter</b
5bb0: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
5bc0: 3e 64 61 74 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >date</i></dt>..
5bd0: 3c 64 64 3e 3c 70 3e 54 68 65 20 65 78 70 69 72 <dd><p>The expir
5be0: 61 74 69 6f 6e 20 64 61 74 65 20 6f 66 20 74 68 ation date of th
5bf0: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 76 61 e certificate va
5c00: 6c 69 64 69 74 79 2e 3c 2f 70 3e 3c 2f 64 64 3e lidity.</p></dd>
5c10: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
5c20: 76 61 72 69 61 62 6c 65 22 3e 73 75 62 6a 65 63 variable">subjec
5c30: 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 t</b> <i class="
5c40: 61 72 67 22 3e 73 74 72 69 6e 67 3c 2f 69 3e 3c arg">string</i><
5c50: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 /dt>..<dd><p>The
5c60: 20 64 69 73 74 69 6e 67 75 69 73 68 65 64 20 6e distinguished n
5c70: 61 6d 65 20 28 44 4e 29 20 6f 66 20 74 68 65 20 ame (DN) of the
5c80: 63 65 72 74 69 66 69 63 61 74 65 20 73 75 62 6a certificate subj
5c90: 65 63 74 2e 20 46 69 65 6c 64 73 20 69 6e 63 6c ect. Fields incl
5ca0: 75 64 65 3a 20 43 6f 6d 6d 6f 6e 0d 0a 4e 61 6d ude: Common..Nam
5cb0: 65 20 28 43 4e 29 2c 20 4f 72 67 61 6e 69 7a 61 e (CN), Organiza
5cc0: 74 69 6f 6e 20 28 4f 29 2c 20 4c 6f 63 61 6c 69 tion (O), Locali
5cd0: 74 79 20 6f 72 20 43 69 74 79 20 28 4c 29 2c 20 ty or City (L),
5ce0: 53 74 61 74 65 20 6f 72 20 50 72 6f 76 69 6e 63 State or Provinc
5cf0: 65 20 28 53 29 2c 20 61 6e 64 0d 0a 43 6f 75 6e e (S), and..Coun
5d00: 74 72 79 20 4e 61 6d 65 20 28 43 29 2e 3c 2f 70 try Name (C).</p
5d10: 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ></dd>..<dt><b c
5d20: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
5d30: 69 73 73 75 65 72 55 6e 69 71 75 65 49 44 3c 2f issuerUniqueID</
5d40: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
5d50: 22 3e 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 ">string</i></dt
5d60: 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 69 73 >..<dd><p>The is
5d70: 73 75 65 72 20 75 6e 69 71 75 65 20 69 64 2e 0d suer unique id..
5d80: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5d90: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
5da0: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 8.</p></dd>..<dt
5db0: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
5dc0: 62 6c 65 22 3e 73 75 62 6a 65 63 74 55 6e 69 71 ble">subjectUniq
5dd0: 75 65 49 44 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 ueID</b> <i clas
5de0: 73 3d 22 61 72 67 22 3e 73 74 72 69 6e 67 3c 2f s="arg">string</
5df0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
5e00: 54 68 65 20 73 75 62 6a 65 63 74 20 75 6e 69 71 The subject uniq
5e10: 75 65 20 69 64 2e 0d 0a 54 68 69 73 20 76 61 6c ue id...This val
5e20: 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 ue is new for Tc
5e30: 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 lTLS 1.8.</p></d
5e40: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
5e50: 3d 22 76 61 72 69 61 62 6c 65 22 3e 6e 75 6d 5f ="variable">num_
5e60: 65 78 74 65 6e 73 69 6f 6e 73 3c 2f 62 3e 20 3c extensions</b> <
5e70: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 6e 3c i class="arg">n<
5e80: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
5e90: 3e 4e 75 6d 62 65 72 20 6f 66 20 63 65 72 74 69 >Number of certi
5ea0: 66 69 63 61 74 65 20 65 78 74 65 6e 73 69 6f 6e ficate extension
5eb0: 73 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 s...This value i
5ec0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
5ed0: 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 1.8.</p></dd>..
5ee0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 <dt><b class="va
5ef0: 72 69 61 62 6c 65 22 3e 65 78 74 65 6e 73 69 6f riable">extensio
5f00: 6e 73 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d ns</b> <i class=
5f10: 22 61 72 67 22 3e 6c 69 73 74 3c 2f 69 3e 3c 2f "arg">list</i></
5f20: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 4c 69 73 74 dt>..<dd><p>List
5f30: 20 6f 66 20 63 65 72 74 69 66 69 63 61 74 65 20 of certificate
5f40: 65 78 74 65 6e 73 69 6f 6e 20 6e 61 6d 65 73 2e extension names.
5f50: 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
5f60: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
5f70: 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 .8.</p></dd>..<d
5f80: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 t><b class="vari
5f90: 61 62 6c 65 22 3e 61 75 74 68 6f 72 69 74 79 4b able">authorityK
5fa0: 65 79 49 64 65 6e 74 69 66 69 65 72 3c 2f 62 3e eyIdentifier</b>
5fb0: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
5fc0: 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d string</i></dt>.
5fd0: 0a 3c 64 64 3e 3c 70 3e 41 75 74 68 6f 72 69 74 .<dd><p>Authorit
5fe0: 79 20 4b 65 79 20 49 64 65 6e 74 69 66 69 65 72 y Key Identifier
5ff0: 20 28 41 4b 49 29 20 6f 66 20 74 68 65 20 49 73 (AKI) of the Is
6000: 73 75 69 6e 67 20 43 41 20 63 65 72 74 69 66 69 suing CA certifi
6010: 63 61 74 65 20 74 68 61 74 20 73 69 67 6e 65 64 cate that signed
6020: 20 74 68 65 0d 0a 53 53 4c 20 63 65 72 74 69 66 the..SSL certif
6030: 69 63 61 74 65 20 61 73 20 61 20 68 65 78 20 73 icate as a hex s
6040: 74 72 69 6e 67 2e 20 54 68 69 73 20 76 61 6c 75 tring. This valu
6050: 65 20 6d 61 74 63 68 65 73 20 74 68 65 20 53 4b e matches the SK
6060: 49 20 76 61 6c 75 65 20 6f 66 20 74 68 65 0d 0a I value of the..
6070: 49 6e 74 65 72 6d 65 64 69 61 74 65 20 43 41 20 Intermediate CA
6080: 63 65 72 74 69 66 69 63 61 74 65 2e 0d 0a 54 68 certificate...Th
6090: 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 is value is new
60a0: 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c for TclTLS 1.8.<
60b0: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
60c0: 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 class="variable
60d0: 22 3e 73 75 62 6a 65 63 74 4b 65 79 49 64 65 6e ">subjectKeyIden
60e0: 74 69 66 69 65 72 3c 2f 62 3e 20 3c 69 20 63 6c tifier</b> <i cl
60f0: 61 73 73 3d 22 61 72 67 22 3e 73 74 72 69 6e 67 ass="arg">string
6100: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
6110: 70 3e 53 75 62 6a 65 63 74 20 4b 65 79 20 49 64 p>Subject Key Id
6120: 65 6e 74 69 66 69 65 72 20 28 53 4b 49 29 20 68 entifier (SKI) h
6130: 61 73 68 20 6f 66 20 74 68 65 20 70 75 62 6c 69 ash of the publi
6140: 63 20 6b 65 79 20 69 6e 73 69 64 65 20 74 68 65 c key inside the
6150: 20 63 65 72 74 69 66 69 63 61 74 65 20 61 73 20 certificate as
6160: 61 0d 0a 68 65 78 20 73 74 72 69 6e 67 2e 20 55 a..hex string. U
6170: 73 65 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 sed to identify
6180: 63 65 72 74 69 66 69 63 61 74 65 73 20 74 68 61 certificates tha
6190: 74 20 63 6f 6e 74 61 69 6e 20 61 20 70 61 72 74 t contain a part
61a0: 69 63 75 6c 61 72 20 70 75 62 6c 69 63 20 6b 65 icular public ke
61b0: 79 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 69 y...This value i
61c0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
61d0: 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 1.8.</p></dd>..
61e0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 <dt><b class="va
61f0: 72 69 61 62 6c 65 22 3e 73 75 62 6a 65 63 74 41 riable">subjectA
6200: 6c 74 4e 61 6d 65 3c 2f 62 3e 20 3c 69 20 63 6c ltName</b> <i cl
6210: 61 73 73 3d 22 61 72 67 22 3e 6c 69 73 74 3c 2f ass="arg">list</
6220: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
6230: 4c 69 73 74 20 6f 66 20 61 6c 6c 20 6f 66 20 74 List of all of t
6240: 68 65 20 53 75 62 6a 65 63 74 20 41 6c 74 65 72 he Subject Alter
6250: 6e 61 74 69 76 65 20 4e 61 6d 65 73 20 28 53 41 native Names (SA
6260: 4e 29 20 69 6e 63 6c 75 64 69 6e 67 20 64 6f 6d N) including dom
6270: 61 69 6e 20 6e 61 6d 65 73 2c 20 73 75 62 0d 0a ain names, sub..
6280: 64 6f 6d 61 69 6e 73 2c 20 61 6e 64 20 49 50 20 domains, and IP
6290: 61 64 64 72 65 73 73 65 73 20 74 68 61 74 20 61 addresses that a
62a0: 72 65 20 73 65 63 75 72 65 64 20 62 79 20 74 68 re secured by th
62b0: 65 20 63 65 72 74 69 66 69 63 61 74 65 2e 0d 0a e certificate...
62c0: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
62d0: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 w for TclTLS 1.8
62e0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
62f0: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
6300: 6c 65 22 3e 6f 63 73 70 3c 2f 62 3e 20 3c 69 20 le">ocsp</b> <i
6310: 63 6c 61 73 73 3d 22 61 72 67 22 3e 6c 69 73 74 class="arg">list
6320: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
6330: 70 3e 4c 69 73 74 20 6f 66 20 61 6c 6c 20 4f 6e p>List of all On
6340: 6c 69 6e 65 20 43 65 72 74 69 66 69 63 61 74 65 line Certificate
6350: 20 53 74 61 74 75 73 20 50 72 6f 74 6f 63 6f 6c Status Protocol
6360: 20 28 4f 43 53 50 29 20 55 52 4c 73 20 74 68 61 (OCSP) URLs tha
6370: 74 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f t can be used to
6380: 0d 0a 63 68 65 63 6b 20 74 68 65 20 76 61 6c 69 ..check the vali
6390: 64 69 74 79 20 6f 66 20 74 68 69 73 20 63 65 72 dity of this cer
63a0: 74 69 66 69 63 61 74 65 2e 0d 0a 54 68 69 73 20 tificate...This
63b0: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
63c0: 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e TclTLS 1.8.</p>
63d0: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
63e0: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 63 ass="variable">c
63f0: 65 72 74 69 66 69 63 61 74 65 3c 2f 62 3e 20 3c ertificate</b> <
6400: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 65 i class="arg">ce
6410: 72 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 rt</i></dt>..<dd
6420: 3e 3c 70 3e 54 68 65 20 50 45 4d 20 65 6e 63 6f ><p>The PEM enco
6430: 64 65 64 20 63 65 72 74 69 66 69 63 61 74 65 2e ded certificate.
6440: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
6450: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
6460: 65 22 3e 73 69 67 6e 61 74 75 72 65 41 6c 67 6f e">signatureAlgo
6470: 72 69 74 68 6d 3c 2f 62 3e 20 3c 69 20 63 6c 61 rithm</b> <i cla
6480: 73 73 3d 22 61 72 67 22 3e 61 6c 67 6f 72 69 74 ss="arg">algorit
6490: 68 6d 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 hm</i></dt>..<dd
64a0: 3e 3c 70 3e 43 69 70 68 65 72 20 61 6c 67 6f 72 ><p>Cipher algor
64b0: 69 74 68 6d 20 75 73 65 64 20 66 6f 72 20 74 68 ithm used for th
64c0: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 73 69 e certificate si
64d0: 67 6e 61 74 75 72 65 2e 0d 0a 54 68 69 73 20 76 gnature...This v
64e0: 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 alue is new for
64f0: 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c TclTLS 1.8.</p><
6500: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
6510: 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 73 69 ss="variable">si
6520: 67 6e 61 74 75 72 65 56 61 6c 75 65 3c 2f 62 3e gnatureValue</b>
6530: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
6540: 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d string</i></dt>.
6550: 0a 3c 64 64 3e 3c 70 3e 43 65 72 74 69 66 69 63 .<dd><p>Certific
6560: 61 74 65 20 73 69 67 6e 61 74 75 72 65 20 61 73 ate signature as
6570: 20 61 20 68 65 78 20 73 74 72 69 6e 67 2e 0d 0a a hex string...
6580: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
6590: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 w for TclTLS 1.8
65a0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
65b0: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
65c0: 6c 65 22 3e 73 69 67 6e 61 74 75 72 65 44 69 67 le">signatureDig
65d0: 65 73 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 est</b> <i class
65e0: 3d 22 61 72 67 22 3e 76 65 72 73 69 6f 6e 3c 2f ="arg">version</
65f0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
6600: 43 65 72 74 69 66 69 63 61 74 65 20 73 69 67 6e Certificate sign
6610: 69 6e 67 20 64 69 67 65 73 74 20 61 73 20 61 20 ing digest as a
6620: 68 65 78 20 73 74 72 69 6e 67 2e 0d 0a 54 68 69 hex string...Thi
6630: 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 s value is new f
6640: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f or TclTLS 1.8.</
6650: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
6660: 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 class="variable"
6670: 3e 70 75 62 6c 69 63 4b 65 79 41 6c 67 6f 72 69 >publicKeyAlgori
6680: 74 68 6d 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 thm</b> <i class
6690: 3d 22 61 72 67 22 3e 61 6c 67 6f 72 69 74 68 6d ="arg">algorithm
66a0: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
66b0: 70 3e 43 65 72 74 69 66 69 63 61 74 65 20 73 69 p>Certificate si
66c0: 67 6e 61 74 75 72 65 20 70 75 62 6c 69 63 20 6b gnature public k
66d0: 65 79 20 61 6c 67 6f 72 69 74 68 6d 2e 0d 0a 54 ey algorithm...T
66e0: 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 his value is new
66f0: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e for TclTLS 1.8.
6700: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
6710: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
6720: 65 22 3e 70 75 62 6c 69 63 4b 65 79 3c 2f 62 3e e">publicKey</b>
6730: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
6740: 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d string</i></dt>.
6750: 0a 3c 64 64 3e 3c 70 3e 43 65 72 74 69 66 69 63 .<dd><p>Certific
6760: 61 74 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 ate signature pu
6770: 62 6c 69 63 20 6b 65 79 20 61 73 20 61 20 68 65 blic key as a he
6780: 78 20 73 74 72 69 6e 67 2e 0d 0a 54 68 69 73 20 x string...This
6790: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
67a0: 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e TclTLS 1.8.</p>
67b0: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
67c0: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 62 ass="variable">b
67d0: 69 74 73 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 its</b> <i class
67e0: 3d 22 61 72 67 22 3e 6e 3c 2f 69 3e 3c 2f 64 74 ="arg">n</i></dt
67f0: 3e 0d 0a 3c 64 64 3e 3c 70 3e 4e 75 6d 62 65 72 >..<dd><p>Number
6800: 20 6f 66 20 62 69 74 73 20 75 73 65 64 20 66 6f of bits used fo
6810: 72 20 63 65 72 74 69 66 69 63 61 74 65 20 73 69 r certificate si
6820: 67 6e 61 74 75 72 65 20 6b 65 79 2e 0d 0a 54 68 gnature key...Th
6830: 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 is value is new
6840: 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c for TclTLS 1.8.<
6850: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
6860: 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 class="variable
6870: 22 3e 73 65 6c 66 5f 73 69 67 6e 65 64 3c 2f 62 ">self_signed</b
6880: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
6890: 3e 62 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 64 74 >boolean</i></dt
68a0: 3e 0d 0a 3c 64 64 3e 3c 70 3e 57 68 65 74 68 65 >..<dd><p>Whethe
68b0: 72 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 r the certificat
68c0: 65 20 73 69 67 6e 61 74 75 72 65 20 69 73 20 73 e signature is s
68d0: 65 6c 66 20 73 69 67 6e 65 64 2e 0d 0a 54 68 69 elf signed...Thi
68e0: 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 s value is new f
68f0: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f or TclTLS 1.8.</
6900: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
6910: 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 class="variable"
6920: 3e 73 68 61 31 5f 68 61 73 68 3c 2f 62 3e 20 3c >sha1_hash</b> <
6930: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 68 61 i class="arg">ha
6940: 73 68 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 sh</i></dt>..<dd
6950: 3e 3c 70 3e 54 68 65 20 53 48 41 31 20 68 61 73 ><p>The SHA1 has
6960: 68 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 h of the certifi
6970: 63 61 74 65 20 61 73 20 61 20 68 65 78 20 73 74 cate as a hex st
6980: 72 69 6e 67 2e 0d 0a 54 68 69 73 20 76 61 6c 75 ring...This valu
6990: 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c e is new for Tcl
69a0: 54 4c 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 TLS 1.8.</p></dd
69b0: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
69c0: 22 76 61 72 69 61 62 6c 65 22 3e 73 68 61 32 35 "variable">sha25
69d0: 36 5f 68 61 73 68 3c 2f 62 3e 20 3c 69 20 63 6c 6_hash</b> <i cl
69e0: 61 73 73 3d 22 61 72 67 22 3e 68 61 73 68 3c 2f ass="arg">hash</
69f0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
6a00: 54 68 65 20 53 48 41 32 35 36 20 68 61 73 68 20 The SHA256 hash
6a10: 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 63 61 of the certifica
6a20: 74 65 20 61 73 20 61 20 68 65 78 20 73 74 72 69 te as a hex stri
6a30: 6e 67 2e 0d 0a 54 68 69 73 20 76 61 6c 75 65 20 ng...This value
6a40: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
6a50: 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d S 1.8.</p></dd>.
6a60: 0a 3c 2f 64 6c 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 .</dl></dd>..<dt
6a70: 3e 3c 61 20 6e 61 6d 65 3d 22 31 31 22 3e 3c 62 ><a name="11"><b
6a80: 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 class="cmd">tls
6a90: 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 62 3e ::connection</b>
6aa0: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
6ab0: 63 68 61 6e 6e 65 6c 3c 2f 69 3e 3c 2f 61 3e 3c channel</i></a><
6ac0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 52 65 74 /dt>..<dd><p>Ret
6ad0: 75 72 6e 73 20 74 68 65 20 63 75 72 72 65 6e 74 urns the current
6ae0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 74 61 74 connection stat
6af0: 75 73 20 6f 66 20 61 6e 20 53 53 4c 20 63 68 61 us of an SSL cha
6b00: 6e 6e 65 6c 2e 20 54 68 65 20 72 65 73 75 6c 74 nnel. The result
6b10: 20 69 73 20 61 20 6c 69 73 74 0d 0a 6f 66 20 6b is a list..of k
6b20: 65 79 2d 76 61 6c 75 65 20 70 61 69 72 73 20 64 ey-value pairs d
6b30: 65 73 63 72 69 62 69 6e 67 20 74 68 65 20 63 6f escribing the co
6b40: 6e 6e 65 63 74 69 6f 6e 2e 0d 0a 54 68 69 73 20 nnection...This
6b50: 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 65 77 20 66 command is new f
6b60: 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 20 52 or TclTLS 1.8. R
6b70: 65 74 75 72 6e 65 64 20 76 61 6c 75 65 73 20 69 eturned values i
6b80: 6e 63 6c 75 64 65 3a 3c 2f 70 3e 0d 0a 3c 70 3e nclude:</p>..<p>
6b90: 53 53 4c 20 53 74 61 74 75 73 3c 2f 70 3e 0d 0a SSL Status</p>..
6ba0: 3c 64 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f <dl class="docto
6bb0: 6f 6c 73 5f 64 65 66 69 6e 69 74 69 6f 6e 73 22 ols_definitions"
6bc0: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
6bd0: 22 76 61 72 69 61 62 6c 65 22 3e 73 74 61 74 65 "variable">state
6be0: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
6bf0: 72 67 22 3e 73 74 61 74 65 3c 2f 69 3e 3c 2f 64 rg">state</i></d
6c00: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 74 61 74 65 t>..<dd><p>State
6c10: 20 6f 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 of the connecti
6c20: 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 on.</p></dd>..<d
6c30: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 t><b class="vari
6c40: 61 62 6c 65 22 3e 73 65 72 76 65 72 6e 61 6d 65 able">servername
6c50: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
6c60: 72 67 22 3e 6e 61 6d 65 3c 2f 69 3e 3c 2f 64 74 rg">name</i></dt
6c70: 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 6e 61 >..<dd><p>The na
6c80: 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 6e 65 63 me of the connec
6c90: 74 65 64 20 74 6f 20 73 65 72 76 65 72 2e 3c 2f ted to server.</
6ca0: 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 p></dd>..<dt><b
6cb0: 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 class="variable"
6cc0: 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 62 3e 20 3c 69 >protocol</b> <i
6cd0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 76 65 72 class="arg">ver
6ce0: 73 69 6f 6e 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c sion</i></dt>..<
6cf0: 64 64 3e 3c 70 3e 54 68 65 20 70 72 6f 74 6f 63 dd><p>The protoc
6d00: 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 ol version used
6d10: 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 for the connecti
6d20: 6f 6e 3a 20 53 53 4c 32 2c 20 53 53 4c 33 2c 20 on: SSL2, SSL3,
6d30: 54 4c 53 31 2c 20 54 4c 53 31 2e 31 2c 20 54 4c TLS1, TLS1.1, TL
6d40: 53 31 2e 32 2c 20 54 4c 53 31 2e 33 2c 20 6f 72 S1.2, TLS1.3, or
6d50: 20 75 6e 6b 6e 6f 77 6e 2e 3c 2f 70 3e 3c 2f 64 unknown.</p></d
6d60: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
6d70: 3d 22 76 61 72 69 61 62 6c 65 22 3e 72 65 6e 65 ="variable">rene
6d80: 67 6f 74 69 61 74 69 6f 6e 5f 61 6c 6c 6f 77 65 gotiation_allowe
6d90: 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 d</b> <i class="
6da0: 61 72 67 22 3e 62 6f 6f 6c 65 61 6e 3c 2f 69 3e arg">boolean</i>
6db0: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 57 68 </dt>..<dd><p>Wh
6dc0: 65 74 68 65 72 20 70 72 6f 74 6f 63 6f 6c 20 72 ether protocol r
6dd0: 65 6e 65 67 6f 74 69 61 74 69 6f 6e 20 69 73 20 enegotiation is
6de0: 73 75 70 70 6f 72 74 65 64 20 6f 72 20 6e 6f 74 supported or not
6df0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
6e00: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
6e10: 6c 65 22 3e 73 65 63 75 72 69 74 79 5f 6c 65 76 le">security_lev
6e20: 65 6c 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d el</b> <i class=
6e30: 22 61 72 67 22 3e 6c 65 76 65 6c 3c 2f 69 3e 3c "arg">level</i><
6e40: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 /dt>..<dd><p>The
6e50: 20 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 security level
6e60: 75 73 65 64 20 66 6f 72 20 73 65 6c 65 63 74 69 used for selecti
6e70: 6f 6e 20 6f 66 20 63 69 70 68 65 72 73 2c 20 6b on of ciphers, k
6e80: 65 79 20 73 69 7a 65 2c 20 65 74 63 2e 3c 2f 70 ey size, etc.</p
6e90: 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ></dd>..<dt><b c
6ea0: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
6eb0: 73 65 73 73 69 6f 6e 5f 72 65 75 73 65 64 3c 2f session_reused</
6ec0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
6ed0: 22 3e 62 6f 6f 6c 65 61 6e 3c 2f 69 3e 3c 2f 64 ">boolean</i></d
6ee0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 57 68 65 74 68 t>..<dd><p>Wheth
6ef0: 65 72 20 74 68 65 20 73 65 73 73 69 6f 6e 20 68 er the session h
6f00: 61 73 20 62 65 65 6e 20 72 65 75 73 65 64 20 6f as been reused o
6f10: 72 20 6e 6f 74 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d r not.</p></dd>.
6f20: 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 .<dt><b class="v
6f30: 61 72 69 61 62 6c 65 22 3e 69 73 5f 73 65 72 76 ariable">is_serv
6f40: 65 72 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d er</b> <i class=
6f50: 22 61 72 67 22 3e 62 6f 6f 6c 65 61 6e 3c 2f 69 "arg">boolean</i
6f60: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 57 ></dt>..<dd><p>W
6f70: 68 65 74 68 65 72 20 74 68 65 20 63 6f 6e 6e 65 hether the conne
6f80: 63 74 69 6f 6e 20 69 73 20 63 6f 6e 66 69 67 75 ction is configu
6f90: 72 65 64 20 61 73 20 61 20 73 65 72 76 65 72 20 red as a server
6fa0: 28 31 29 20 6f 72 20 63 6c 69 65 6e 74 20 28 30 (1) or client (0
6fb0: 29 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 ).</p></dd>..<dt
6fc0: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
6fd0: 62 6c 65 22 3e 63 6f 6d 70 72 65 73 73 69 6f 6e ble">compression
6fe0: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
6ff0: 72 67 22 3e 6d 6f 64 65 3c 2f 69 3e 3c 2f 64 74 rg">mode</i></dt
7000: 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 6f 6d 70 72 65 >..<dd><p>Compre
7010: 73 73 69 6f 6e 20 6d 65 74 68 6f 64 2e 3c 2f 70 ssion method.</p
7020: 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ></dd>..<dt><b c
7030: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
7040: 65 78 70 61 6e 73 69 6f 6e 3c 2f 62 3e 20 3c 69 expansion</b> <i
7050: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 6d 6f 64 class="arg">mod
7060: 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e e</i></dt>..<dd>
7070: 3c 70 3e 45 78 70 61 6e 73 69 6f 6e 20 6d 65 74 <p>Expansion met
7080: 68 6f 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c hod.</p></dd>..<
7090: 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 dt><b class="var
70a0: 69 61 62 6c 65 22 3e 63 61 4c 69 73 74 3c 2f 62 iable">caList</b
70b0: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
70c0: 3e 6c 69 73 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >list</i></dt>..
70d0: 3c 64 64 3e 3c 70 3e 4c 69 73 74 20 6f 66 20 43 <dd><p>List of C
70e0: 65 72 74 69 66 69 63 61 74 65 20 41 75 74 68 6f ertificate Autho
70f0: 72 69 74 69 65 73 20 28 43 41 29 20 66 6f 72 20 rities (CA) for
7100: 58 2e 35 30 39 20 63 65 72 74 69 66 69 63 61 74 X.509 certificat
7110: 65 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 e.</p></dd>..</d
7120: 6c 3e 0d 0a 3c 70 3e 43 69 70 68 65 72 20 49 6e l>..<p>Cipher In
7130: 66 6f 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 73 fo</p>..<dl clas
7140: 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 66 69 s="doctools_defi
7150: 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e 3c nitions">..<dt><
7160: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
7170: 65 22 3e 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 e">cipher</b> <i
7180: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 69 70 class="arg">cip
7190: 68 65 72 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 her</i></dt>..<d
71a0: 64 3e 3c 70 3e 54 68 65 20 63 75 72 72 65 6e 74 d><p>The current
71b0: 20 63 69 70 68 65 72 20 69 6e 20 75 73 65 20 66 cipher in use f
71c0: 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f or the connectio
71d0: 6e 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 n.</p></dd>..<dt
71e0: 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 ><b class="varia
71f0: 62 6c 65 22 3e 73 74 61 6e 64 61 72 64 5f 6e 61 ble">standard_na
7200: 6d 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d me</b> <i class=
7210: 22 61 72 67 22 3e 6e 61 6d 65 3c 2f 69 3e 3c 2f "arg">name</i></
7220: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 dt>..<dd><p>The
7230: 73 74 61 6e 64 61 72 64 20 52 46 43 20 6e 61 6d standard RFC nam
7240: 65 20 6f 66 20 63 69 70 68 65 72 2e 3c 2f 70 3e e of cipher.</p>
7250: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
7260: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 61 ass="variable">a
7270: 6c 67 6f 72 69 74 68 6d 5f 62 69 74 73 3c 2f 62 lgorithm_bits</b
7280: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
7290: 3e 6e 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 >n</i></dt>..<dd
72a0: 3e 3c 70 3e 54 68 65 20 6e 75 6d 62 65 72 20 6f ><p>The number o
72b0: 66 20 70 72 6f 63 65 73 73 65 64 20 62 69 74 73 f processed bits
72c0: 20 75 73 65 64 20 66 6f 72 20 63 69 70 68 65 72 used for cipher
72d0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
72e0: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
72f0: 6c 65 22 3e 73 65 63 72 65 74 5f 62 69 74 73 3c le">secret_bits<
7300: 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 /b> <i class="ar
7310: 67 22 3e 6e 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c g">n</i></dt>..<
7320: 64 64 3e 3c 70 3e 54 68 65 20 6e 75 6d 62 65 72 dd><p>The number
7330: 20 6f 66 20 73 65 63 72 65 74 20 62 69 74 73 20 of secret bits
7340: 75 73 65 64 20 66 6f 72 20 63 69 70 68 65 72 2e used for cipher.
7350: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
7360: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
7370: 65 22 3e 6d 69 6e 5f 76 65 72 73 69 6f 6e 3c 2f e">min_version</
7380: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
7390: 22 3e 76 65 72 73 69 6f 6e 3c 2f 69 3e 3c 2f 64 ">version</i></d
73a0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 6d t>..<dd><p>The m
73b0: 69 6e 69 6d 75 6d 20 70 72 6f 74 6f 63 6f 6c 20 inimum protocol
73c0: 76 65 72 73 69 6f 6e 20 66 6f 72 20 63 69 70 68 version for ciph
73d0: 65 72 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 er.</p></dd>..<d
73e0: 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 t><b class="vari
73f0: 61 62 6c 65 22 3e 63 69 70 68 65 72 5f 69 73 5f able">cipher_is_
7400: 61 65 61 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 aead</b> <i clas
7410: 73 3d 22 61 72 67 22 3e 62 6f 6f 6c 65 61 6e 3c s="arg">boolean<
7420: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
7430: 3e 57 68 65 74 68 65 72 20 74 68 65 20 63 69 70 >Whether the cip
7440: 68 65 72 20 69 73 20 41 75 74 68 65 6e 74 69 63 her is Authentic
7450: 61 74 65 64 20 45 6e 63 72 79 70 74 69 6f 6e 20 ated Encryption
7460: 77 69 74 68 20 41 73 73 6f 63 69 61 74 65 64 20 with Associated
7470: 44 61 74 61 20 28 41 45 41 44 29 2e 3c 2f 70 3e Data (AEAD).</p>
7480: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
7490: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 63 ass="variable">c
74a0: 69 70 68 65 72 5f 69 64 3c 2f 62 3e 20 3c 69 20 ipher_id</b> <i
74b0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 69 64 3c 2f class="arg">id</
74c0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
74d0: 54 68 65 20 4f 70 65 6e 53 53 4c 20 63 69 70 68 The OpenSSL ciph
74e0: 65 72 20 69 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d er id.</p></dd>.
74f0: 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 .<dt><b class="v
7500: 61 72 69 61 62 6c 65 22 3e 64 65 73 63 72 69 70 ariable">descrip
7510: 74 69 6f 6e 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 tion</b> <i clas
7520: 73 3d 22 61 72 67 22 3e 73 74 72 69 6e 67 3c 2f s="arg">string</
7530: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
7540: 41 20 74 65 78 74 20 64 65 73 63 72 69 70 74 69 A text descripti
7550: 6f 6e 20 6f 66 20 74 68 65 20 63 69 70 68 65 72 on of the cipher
7560: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
7570: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
7580: 6c 65 22 3e 68 61 6e 64 73 68 61 6b 65 5f 64 69 le">handshake_di
7590: 67 65 73 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 gest</b> <i clas
75a0: 73 3d 22 61 72 67 22 3e 62 6f 6f 6c 65 61 6e 3c s="arg">boolean<
75b0: 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /i></dt>..<dd><p
75c0: 3e 44 69 67 65 73 74 20 75 73 65 64 20 64 75 72 >Digest used dur
75d0: 69 6e 67 20 68 61 6e 64 73 68 61 6b 65 2e 3c 2f ing handshake.</
75e0: 70 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 0d 0a p></dd>..</dl>..
75f0: 3c 70 3e 53 65 73 73 69 6f 6e 20 49 6e 66 6f 3c <p>Session Info<
7600: 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 73 73 3d 22 /p>..<dl class="
7610: 64 6f 63 74 6f 6f 6c 73 5f 64 65 66 69 6e 69 74 doctools_definit
7620: 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ions">..<dt><b c
7630: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
7640: 61 6c 70 6e 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 alpn</b> <i clas
7650: 73 3d 22 61 72 67 22 3e 70 72 6f 74 6f 63 6f 6c s="arg">protocol
7660: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
7670: 70 3e 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 73 p>The protocol s
7680: 65 6c 65 63 74 65 64 20 61 66 74 65 72 20 41 70 elected after Ap
7690: 70 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 20 plication-Layer
76a0: 50 72 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 61 Protocol Negotia
76b0: 74 69 6f 6e 20 28 41 4c 50 4e 29 2e 3c 2f 70 3e tion (ALPN).</p>
76c0: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c </dd>..<dt><b cl
76d0: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 72 ass="variable">r
76e0: 65 73 75 6d 61 62 6c 65 3c 2f 62 3e 20 3c 69 20 esumable</b> <i
76f0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 62 6f 6f 6c class="arg">bool
7700: 65 61 6e 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ean</i></dt>..<d
7710: 64 3e 3c 70 3e 57 68 65 74 68 65 72 20 74 68 65 d><p>Whether the
7720: 20 73 65 73 73 69 6f 6e 20 63 61 6e 20 62 65 20 session can be
7730: 72 65 73 75 6d 65 64 20 6f 72 20 6e 6f 74 2e 3c resumed or not.<
7740: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 /p></dd>..<dt><b
7750: 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 class="variable
7760: 22 3e 73 74 61 72 74 5f 74 69 6d 65 3c 2f 62 3e ">start_time</b>
7770: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
7780: 73 65 63 6f 6e 64 73 3c 2f 69 3e 3c 2f 64 74 3e seconds</i></dt>
7790: 0d 0a 3c 64 64 3e 3c 70 3e 54 69 6d 65 20 73 69 ..<dd><p>Time si
77a0: 6e 63 65 20 73 65 73 73 69 6f 6e 20 73 74 61 72 nce session star
77b0: 74 65 64 20 69 6e 20 73 65 63 6f 6e 64 73 20 73 ted in seconds s
77c0: 69 6e 63 65 20 65 70 6f 63 68 2e 3c 2f 70 3e 3c ince epoch.</p><
77d0: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
77e0: 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 74 69 ss="variable">ti
77f0: 6d 65 6f 75 74 3c 2f 62 3e 20 3c 69 20 63 6c 61 meout</b> <i cla
7800: 73 73 3d 22 61 72 67 22 3e 73 65 63 6f 6e 64 73 ss="arg">seconds
7810: 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c </i></dt>..<dd><
7820: 70 3e 4d 61 78 20 64 75 72 61 74 69 6f 6e 20 6f p>Max duration o
7830: 66 20 73 65 73 73 69 6f 6e 20 69 6e 20 73 65 63 f session in sec
7840: 6f 6e 64 73 20 62 65 66 6f 72 65 20 74 69 6d 65 onds before time
7850: 2d 6f 75 74 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a -out.</p></dd>..
7860: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 <dt><b class="va
7870: 72 69 61 62 6c 65 22 3e 6c 69 66 65 74 69 6d 65 riable">lifetime
7880: 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 </b> <i class="a
7890: 72 67 22 3e 73 65 63 6f 6e 64 73 3c 2f 69 3e 3c rg">seconds</i><
78a0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 65 73 /dt>..<dd><p>Ses
78b0: 73 69 6f 6e 20 74 69 63 6b 65 74 20 6c 69 66 65 sion ticket life
78c0: 74 69 6d 65 20 68 69 6e 74 20 69 6e 20 73 65 63 time hint in sec
78d0: 6f 6e 64 73 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a onds.</p></dd>..
78e0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 76 61 <dt><b class="va
78f0: 72 69 61 62 6c 65 22 3e 73 65 73 73 69 6f 6e 5f riable">session_
7900: 69 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d id</b> <i class=
7910: 22 61 72 67 22 3e 62 69 6e 61 72 79 5f 73 74 72 "arg">binary_str
7920: 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ing</i></dt>..<d
7930: 64 3e 3c 70 3e 55 6e 69 71 75 65 20 73 65 73 73 d><p>Unique sess
7940: 69 6f 6e 20 69 64 20 66 6f 72 20 75 73 65 20 69 ion id for use i
7950: 6e 20 72 65 73 75 6d 69 6e 67 20 74 68 65 20 73 n resuming the s
7960: 65 73 73 69 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 3e ession.</p></dd>
7970: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
7980: 76 61 72 69 61 62 6c 65 22 3e 73 65 73 73 69 6f variable">sessio
7990: 6e 5f 74 69 63 6b 65 74 3c 2f 62 3e 20 3c 69 20 n_ticket</b> <i
79a0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 62 69 6e 61 class="arg">bina
79b0: 72 79 5f 73 74 72 69 6e 67 3c 2f 69 3e 3c 2f 64 ry_string</i></d
79c0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 55 6e 69 71 75 t>..<dd><p>Uniqu
79d0: 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 e session ticket
79e0: 20 66 6f 72 20 75 73 65 20 69 6e 20 72 65 73 75 for use in resu
79f0: 6d 69 6e 67 20 74 68 65 20 73 65 73 73 69 6f 6e ming the session
7a00: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
7a10: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
7a20: 6c 65 22 3e 74 69 63 6b 65 74 5f 61 70 70 5f 64 le">ticket_app_d
7a30: 61 74 61 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ata</b> <i class
7a40: 3d 22 61 72 67 22 3e 62 69 6e 61 72 79 5f 73 74 ="arg">binary_st
7a50: 72 69 6e 67 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c ring</i></dt>..<
7a60: 64 64 3e 3c 70 3e 55 6e 69 71 75 65 20 73 65 73 dd><p>Unique ses
7a70: 73 69 6f 6e 20 74 69 63 6b 65 74 20 61 70 70 6c sion ticket appl
7a80: 69 63 61 74 69 6f 6e 20 64 61 74 61 2e 3c 2f 70 ication data.</p
7a90: 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 ></dd>..<dt><b c
7aa0: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
7ab0: 6d 61 73 74 65 72 5f 6b 65 79 3c 2f 62 3e 20 3c master_key</b> <
7ac0: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 62 69 i class="arg">bi
7ad0: 6e 61 72 79 5f 73 74 72 69 6e 67 3c 2f 69 3e 3c nary_string</i><
7ae0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 55 6e 69 /dt>..<dd><p>Uni
7af0: 71 75 65 20 73 65 73 73 69 6f 6e 20 6d 61 73 74 que session mast
7b00: 65 72 20 6b 65 79 2e 3c 2f 70 3e 3c 2f 64 64 3e er key.</p></dd>
7b10: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
7b20: 76 61 72 69 61 62 6c 65 22 3e 73 65 73 73 69 6f variable">sessio
7b30: 6e 5f 63 61 63 68 65 5f 6d 6f 64 65 3c 2f 62 3e n_cache_mode</b>
7b40: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
7b50: 6d 6f 64 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c mode</i></dt>..<
7b60: 64 64 3e 3c 70 3e 53 65 72 76 65 72 20 63 61 63 dd><p>Server cac
7b70: 68 65 20 6d 6f 64 65 20 28 63 6c 69 65 6e 74 2c he mode (client,
7b80: 20 73 65 72 76 65 72 2c 20 6f 72 20 62 6f 74 68 server, or both
7b90: 29 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 ).</p></dd>..</d
7ba0: 6c 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 61 20 l></dd>..<dt><a
7bb0: 6e 61 6d 65 3d 22 31 32 22 3e 3c 62 20 63 6c 61 name="12"><b cla
7bc0: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 63 69 ss="cmd">tls::ci
7bd0: 70 68 65 72 73 3c 2f 62 3e 20 3c 73 70 61 6e 20 phers</b> <span
7be0: 63 6c 61 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 class="opt">?<i
7bf0: 63 6c 61 73 73 3d 22 61 72 67 22 3e 70 72 6f 74 class="arg">prot
7c00: 6f 63 6f 6c 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e ocol</i>?</span>
7c10: 20 3c 73 70 61 6e 20 63 6c 61 73 73 3d 22 6f 70 <span class="op
7c20: 74 22 3e 3f 3c 69 20 63 6c 61 73 73 3d 22 61 72 t">?<i class="ar
7c30: 67 22 3e 76 65 72 62 6f 73 65 3c 2f 69 3e 3f 3c g">verbose</i>?<
7c40: 2f 73 70 61 6e 3e 20 3c 73 70 61 6e 20 63 6c 61 /span> <span cla
7c50: 73 73 3d 22 6f 70 74 22 3e 3f 3c 69 20 63 6c 61 ss="opt">?<i cla
7c60: 73 73 3d 22 61 72 67 22 3e 73 75 70 70 6f 72 74 ss="arg">support
7c70: 65 64 3c 2f 69 3e 3f 3c 2f 73 70 61 6e 3e 3c 2f ed</i>?</span></
7c80: 61 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e a></dt>..<dd><p>
7c90: 57 69 74 68 6f 75 74 20 61 6e 79 20 6f 70 74 69 Without any opti
7ca0: 6f 6e 73 2c 20 69 74 20 72 65 74 75 72 6e 73 20 ons, it returns
7cb0: 61 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 73 79 a list of all sy
7cc0: 6d 6d 65 74 72 69 63 20 63 69 70 68 65 72 73 20 mmetric ciphers
7cd0: 66 6f 72 20 75 73 65 20 77 69 74 68 20 74 68 65 for use with the
7ce0: 0d 0a 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 ..<i class="arg"
7cf0: 3e 2d 63 69 70 68 65 72 3c 2f 69 3e 20 6f 70 74 >-cipher</i> opt
7d00: 69 6f 6e 2e 20 57 69 74 68 20 3c 69 20 63 6c 61 ion. With <i cla
7d10: 73 73 3d 22 61 72 67 22 3e 70 72 6f 74 6f 63 6f ss="arg">protoco
7d20: 6c 3c 2f 69 3e 2c 20 6f 6e 6c 79 20 74 68 65 20 l</i>, only the
7d30: 63 69 70 68 65 72 73 20 73 75 70 70 6f 72 74 65 ciphers supporte
7d40: 64 20 66 6f 72 20 74 68 61 74 0d 0a 70 72 6f 74 d for that..prot
7d50: 6f 63 6f 6c 20 61 72 65 20 72 65 74 75 72 6e 65 ocol are returne
7d60: 64 2e 20 53 65 65 20 74 68 65 20 3c 62 20 63 6c d. See the <b cl
7d70: 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 70 ass="cmd">tls::p
7d80: 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 20 63 6f 6d rotocols</b> com
7d90: 6d 61 6e 64 20 66 6f 72 20 74 68 65 20 73 75 70 mand for the sup
7da0: 70 6f 72 74 65 64 0d 0a 70 72 6f 74 6f 63 6f 6c ported..protocol
7db0: 73 2e 20 49 66 20 3c 69 20 63 6c 61 73 73 3d 22 s. If <i class="
7dc0: 61 72 67 22 3e 76 65 72 62 6f 73 65 3c 2f 69 3e arg">verbose</i>
7dd0: 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 is specified as
7de0: 20 74 72 75 65 20 74 68 65 6e 20 61 20 76 65 72 true then a ver
7df0: 62 6f 73 65 2c 20 68 75 6d 61 6e 20 72 65 61 64 bose, human read
7e00: 61 62 6c 65 0d 0a 6c 69 73 74 20 69 73 20 72 65 able..list is re
7e10: 74 75 72 6e 65 64 20 77 69 74 68 20 61 64 64 69 turned with addi
7e20: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
7e30: 6f 6e 20 6f 6e 20 74 68 65 20 63 69 70 68 65 72 on on the cipher
7e40: 2e 20 49 66 20 3c 69 20 63 6c 61 73 73 3d 22 61 . If <i class="a
7e50: 72 67 22 3e 73 75 70 70 6f 72 74 65 64 3c 2f 69 rg">supported</i
7e60: 3e 0d 0a 69 73 20 73 70 65 63 69 66 69 65 64 20 >..is specified
7e70: 61 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e as true, then on
7e80: 6c 79 20 74 68 65 20 63 69 70 68 65 72 73 20 73 ly the ciphers s
7e90: 75 70 70 6f 72 74 65 64 20 66 6f 72 20 70 72 6f upported for pro
7ea0: 74 6f 63 6f 6c 20 77 69 6c 6c 20 62 65 20 6c 69 tocol will be li
7eb0: 73 74 65 64 2e 0d 0a 54 68 65 20 3c 69 20 63 6c sted...The <i cl
7ec0: 61 73 73 3d 22 61 72 67 22 3e 73 75 70 70 6f 72 ass="arg">suppor
7ed0: 74 65 64 3c 2f 69 3e 20 61 72 67 20 69 73 20 6e ted</i> arg is n
7ee0: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e ew for TclTLS 1.
7ef0: 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 8.</p></dd>..<dt
7f00: 3e 3c 61 20 6e 61 6d 65 3d 22 31 33 22 3e 3c 62 ><a name="13"><b
7f10: 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 class="cmd">tls
7f20: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c ::protocols</b><
7f30: 2f 61 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 /a></dt>..<dd><p
7f40: 3e 52 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 >Returns a list
7f50: 6f 66 20 74 68 65 20 73 75 70 70 6f 72 74 65 64 of the supported
7f60: 20 53 53 4c 2f 54 4c 53 20 70 72 6f 74 6f 63 6f SSL/TLS protoco
7f70: 6c 73 2e 20 56 61 6c 69 64 20 76 61 6c 75 65 73 ls. Valid values
7f80: 20 61 72 65 3a 0d 0a 3c 62 20 63 6c 61 73 73 3d are:..<b class=
7f90: 22 63 6f 6e 73 74 22 3e 73 73 6c 32 3c 2f 62 3e "const">ssl2</b>
7fa0: 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 , <b class="cons
7fb0: 74 22 3e 73 73 6c 33 3c 2f 62 3e 2c 20 3c 62 20 t">ssl3</b>, <b
7fc0: 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 6c class="const">tl
7fd0: 73 31 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 s1</b>, <b class
7fe0: 3d 22 63 6f 6e 73 74 22 3e 74 6c 73 31 2e 31 3c ="const">tls1.1<
7ff0: 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 /b>, <b class="c
8000: 6f 6e 73 74 22 3e 74 6c 73 31 2e 32 3c 2f 62 3e onst">tls1.2</b>
8010: 2c 20 61 6e 64 0d 0a 3c 62 20 63 6c 61 73 73 3d , and..<b class=
8020: 22 63 6f 6e 73 74 22 3e 74 6c 73 31 2e 33 3c 2f "const">tls1.3</
8030: 62 3e 2e 20 45 78 61 63 74 20 6c 69 73 74 20 64 b>. Exact list d
8040: 65 70 65 6e 64 73 20 6f 6e 20 4f 70 65 6e 53 53 epends on OpenSS
8050: 4c 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 63 6f L version and co
8060: 6d 70 69 6c 65 20 74 69 6d 65 20 66 6c 61 67 73 mpile time flags
8070: 2e 0d 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 ...This command
8080: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
8090: 53 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d S 1.8.</p></dd>.
80a0: 0a 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 31 34 .<dt><a name="14
80b0: 22 3e 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 "><b class="cmd"
80c0: 3e 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 62 >tls::version</b
80d0: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e ></a></dt>..<dd>
80e0: 3c 70 3e 52 65 74 75 72 6e 73 20 74 68 65 20 4f <p>Returns the O
80f0: 70 65 6e 53 53 4c 20 76 65 72 73 69 6f 6e 20 73 penSSL version s
8100: 74 72 69 6e 67 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d tring.</p></dd>.
8110: 0a 3c 2f 64 6c 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a .</dl>..</div>..
8120: 3c 64 69 76 20 69 64 3d 22 73 65 63 74 69 6f 6e <div id="section
8130: 34 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 4" class="doctoo
8140: 6c 73 5f 73 65 63 74 69 6f 6e 22 3e 3c 68 32 3e ls_section"><h2>
8150: 3c 61 20 6e 61 6d 65 3d 22 73 65 63 74 69 6f 6e <a name="section
8160: 34 22 3e 43 65 72 74 69 66 69 63 61 74 65 20 56 4">Certificate V
8170: 61 6c 69 64 61 74 69 6f 6e 3c 2f 61 3e 3c 2f 68 alidation</a></h
8180: 32 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 73 75 62 2>..<div id="sub
8190: 73 65 63 74 69 6f 6e 31 22 20 63 6c 61 73 73 3d section1" class=
81a0: 22 64 6f 63 74 6f 6f 6c 73 5f 73 75 62 73 65 63 "doctools_subsec
81b0: 74 69 6f 6e 22 3e 3c 68 33 3e 3c 61 20 6e 61 6d tion"><h3><a nam
81c0: 65 3d 22 73 75 62 73 65 63 74 69 6f 6e 31 22 3e e="subsection1">
81d0: 50 4b 49 20 61 6e 64 20 43 65 72 74 69 66 69 63 PKI and Certific
81e0: 61 74 65 73 3c 2f 61 3e 3c 2f 68 33 3e 0d 0a 3c ates</a></h3>..<
81f0: 70 3e 55 73 69 6e 67 20 74 68 65 20 50 75 62 6c p>Using the Publ
8200: 69 63 20 4b 65 79 20 49 6e 66 72 61 73 74 72 75 ic Key Infrastru
8210: 63 74 75 72 65 20 28 50 4b 49 29 2c 20 65 61 63 cture (PKI), eac
8220: 68 20 75 73 65 72 20 63 72 65 61 74 65 73 20 61 h user creates a
8230: 20 70 72 69 76 61 74 65 20 6b 65 79 20 74 68 61 private key tha
8240: 74 0d 0a 6f 6e 6c 79 20 74 68 65 79 20 6b 6e 6f t..only they kno
8250: 77 20 61 62 6f 75 74 20 61 6e 64 20 61 20 70 75 w about and a pu
8260: 62 6c 69 63 20 6b 65 79 20 74 68 65 79 20 63 61 blic key they ca
8270: 6e 20 65 78 63 68 61 6e 67 65 20 77 69 74 68 20 n exchange with
8280: 6f 74 68 65 72 73 20 66 6f 72 20 75 73 65 20 69 others for use i
8290: 6e 0d 0a 65 6e 63 72 79 70 74 69 6e 67 20 61 6e n..encrypting an
82a0: 64 20 64 65 63 72 79 70 74 69 6e 67 20 64 61 74 d decrypting dat
82b0: 61 2e 20 54 68 65 20 70 72 6f 63 65 73 73 20 69 a. The process i
82c0: 73 20 74 68 65 20 73 65 6e 64 65 72 20 65 6e 63 s the sender enc
82d0: 72 79 70 74 73 20 74 68 65 69 72 20 64 61 74 61 rypts their data
82e0: 0d 0a 75 73 69 6e 67 20 74 68 65 69 72 20 70 72 ..using their pr
82f0: 69 76 61 74 65 20 6b 65 79 20 61 6e 64 20 74 68 ivate key and th
8300: 65 20 72 65 63 65 69 76 65 72 27 73 20 70 75 62 e receiver's pub
8310: 6c 69 63 20 6b 65 79 2e 20 54 68 65 20 64 61 74 lic key. The dat
8320: 61 20 69 73 20 74 68 65 6e 20 73 65 6e 74 0d 0a a is then sent..
8330: 74 6f 20 74 68 65 20 72 65 63 65 69 76 65 72 2e to the receiver.
8340: 20 49 6e 20 61 20 73 69 6d 69 6c 61 72 20 6d 61 In a similar ma
8350: 6e 6e 65 72 2c 20 74 68 65 20 72 65 63 65 69 76 nner, the receiv
8360: 65 72 20 75 73 65 73 20 74 68 65 69 72 20 70 72 er uses their pr
8370: 69 76 61 74 65 20 6b 65 79 20 61 6e 64 0d 0a 74 ivate key and..t
8380: 68 65 20 73 65 6e 64 65 72 27 73 20 70 75 62 6c he sender's publ
8390: 69 63 20 6b 65 79 20 74 6f 20 64 65 63 72 79 70 ic key to decryp
83a0: 74 20 74 68 65 20 64 61 74 61 2e 20 54 68 69 73 t the data. This
83b0: 20 70 72 6f 76 69 64 65 73 20 64 61 74 61 20 69 provides data i
83c0: 6e 74 65 67 72 69 74 79 2c 20 74 6f 0d 0a 65 6e ntegrity, to..en
83d0: 73 75 72 65 20 74 68 65 20 64 61 74 61 20 63 61 sure the data ca
83e0: 6e 27 74 20 62 65 20 76 69 65 77 65 64 20 6f 72 n't be viewed or
83f0: 20 61 6c 74 65 72 65 64 20 64 75 72 69 6e 67 20 altered during
8400: 74 72 61 6e 73 70 6f 72 74 2e 20 53 65 65 20 74 transport. See t
8410: 68 65 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 he..<b class="op
8420: 74 69 6f 6e 22 3e 2d 6b 65 79 3c 2f 62 3e 20 61 tion">-key</b> a
8430: 6e 64 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 nd <b class="opt
8440: 69 6f 6e 22 3e 2d 6b 65 79 66 69 6c 65 3c 2f 62 ion">-keyfile</b
8450: 3e 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 68 6f > options for ho
8460: 77 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 w to specify the
8470: 20 70 72 69 76 61 74 65 20 6b 65 79 2e 0d 0a 41 private key...A
8480: 6c 73 6f 20 73 65 65 20 74 68 65 20 3c 62 20 63 lso see the <b c
8490: 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 70 lass="option">-p
84a0: 61 73 73 77 6f 72 64 3c 2f 62 3e 20 6f 70 74 69 assword</b> opti
84b0: 6f 6e 20 66 6f 72 20 68 6f 77 20 74 6f 20 70 72 on for how to pr
84c0: 6f 76 69 64 65 20 74 68 65 20 70 61 73 73 77 6f ovide the passwo
84d0: 72 64 2e 3c 2f 70 3e 0d 0a 3c 70 3e 49 6e 20 6f rd.</p>..<p>In o
84e0: 72 64 65 72 20 74 6f 20 70 72 6f 76 69 64 65 20 rder to provide
84f0: 61 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 2c 20 authentication,
8500: 69 2e 65 2e 20 65 6e 73 75 72 69 6e 67 20 73 6f i.e. ensuring so
8510: 6d 65 6f 6e 65 20 69 73 20 77 68 6f 20 74 68 65 meone is who the
8520: 79 20 73 61 79 20 74 68 65 79 0d 0a 61 72 65 2c y say they..are,
8530: 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 79 20 the public key
8540: 61 6e 64 20 75 73 65 72 20 69 64 65 6e 74 69 66 and user identif
8550: 69 63 61 74 69 6f 6e 20 69 6e 66 6f 20 69 73 20 ication info is
8560: 73 74 6f 72 65 64 20 69 6e 20 61 20 58 2e 35 30 stored in a X.50
8570: 39 0d 0a 63 65 72 74 69 66 69 63 61 74 65 20 61 9..certificate a
8580: 6e 64 20 74 68 61 74 20 63 65 72 74 69 66 69 63 nd that certific
8590: 61 74 65 20 69 73 20 61 75 74 68 65 6e 74 69 63 ate is authentic
85a0: 61 74 65 64 20 28 69 2e 65 2e 20 73 69 67 6e 65 ated (i.e. signe
85b0: 64 29 20 62 79 20 61 20 43 65 72 74 69 66 69 63 d) by a Certific
85c0: 61 74 65 0d 0a 41 75 74 68 6f 72 69 74 79 20 28 ate..Authority (
85d0: 43 41 29 2e 20 55 73 65 72 73 20 63 61 6e 20 74 CA). Users can t
85e0: 68 65 6e 20 65 78 63 68 61 6e 67 65 20 74 68 65 hen exchange the
85f0: 73 65 20 63 65 72 74 69 66 69 63 61 74 65 73 20 se certificates
8600: 64 75 72 69 6e 67 20 74 68 65 20 54 4c 53 0d 0a during the TLS..
8610: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 initialization p
8620: 72 6f 63 65 73 73 20 61 6e 64 20 63 68 65 63 6b rocess and check
8630: 20 74 68 65 6d 20 61 67 61 69 6e 73 74 20 74 68 them against th
8640: 65 20 72 6f 6f 74 20 43 41 20 63 65 72 74 69 66 e root CA certif
8650: 69 63 61 74 65 73 20 74 6f 20 65 6e 73 75 72 65 icates to ensure
8660: 0d 0a 74 68 65 79 20 61 72 65 20 76 61 6c 69 64 ..they are valid
8670: 2e 20 54 68 69 73 20 69 73 20 68 61 6e 64 6c 65 . This is handle
8680: 64 20 62 79 20 4f 70 65 6e 53 53 4c 20 76 69 61 d by OpenSSL via
8690: 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f the <b class="o
86a0: 70 74 69 6f 6e 22 3e 2d 72 65 71 75 65 73 74 3c ption">-request<
86b0: 2f 62 3e 20 61 6e 64 0d 0a 3c 62 20 63 6c 61 73 /b> and..<b clas
86c0: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 72 65 71 75 s="option">-requ
86d0: 69 72 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 73 2e ire</b> options.
86e0: 20 53 65 65 20 74 68 65 20 3c 62 20 63 6c 61 73 See the <b clas
86f0: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 64 69 s="option">-cadi
8700: 72 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d r</b>, <b class=
8710: 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 64 69 72 3c "option">-cadir<
8720: 2f 62 3e 2c 20 61 6e 64 0d 0a 3c 62 20 63 6c 61 /b>, and..<b cla
8730: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 73 ss="option">-cas
8740: 74 6f 72 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 73 tore</b> options
8750: 20 66 6f 72 20 68 6f 77 20 74 6f 20 73 70 65 63 for how to spec
8760: 69 66 79 20 77 68 65 72 65 20 74 6f 20 66 69 6e ify where to fin
8770: 64 20 74 68 65 20 43 41 20 63 65 72 74 69 66 69 d the CA certifi
8780: 63 61 74 65 73 2e 0d 0a 4f 70 74 69 6f 6e 61 6c cates...Optional
8790: 6c 79 2c 20 69 6e 20 61 20 66 75 74 75 72 65 20 ly, in a future
87a0: 72 65 6c 65 61 73 65 2c 20 74 68 65 79 20 63 61 release, they ca
87b0: 6e 20 61 6c 73 6f 20 62 65 20 63 68 65 63 6b 65 n also be checke
87c0: 64 20 61 67 61 69 6e 73 74 20 74 68 65 20 43 65 d against the Ce
87d0: 72 74 69 66 69 63 61 74 65 0d 0a 52 65 76 6f 63 rtificate..Revoc
87e0: 61 74 69 6f 6e 20 4c 69 73 74 20 28 43 52 4c 29 ation List (CRL)
87f0: 20 6f 66 20 72 65 76 6f 6b 65 64 20 63 65 72 74 of revoked cert
8800: 69 66 69 63 61 74 65 73 2e 20 43 65 72 74 69 66 ificates. Certif
8810: 69 63 61 74 65 73 20 63 61 6e 20 61 6c 73 6f 20 icates can also
8820: 62 65 0d 0a 73 65 6c 66 2d 73 69 67 6e 65 64 2c be..self-signed,
8830: 20 62 75 74 20 74 68 65 79 20 61 72 65 20 62 79 but they are by
8840: 20 64 65 66 61 75 6c 74 20 6e 6f 74 20 74 72 75 default not tru
8850: 73 74 65 64 20 75 6e 6c 65 73 73 20 79 6f 75 20 sted unless you
8860: 61 64 64 20 74 68 65 6d 20 74 6f 20 79 6f 75 72 add them to your
8870: 0d 0a 63 65 72 74 69 66 69 63 61 74 65 20 73 74 ..certificate st
8880: 6f 72 65 2e 3c 2f 70 3e 0d 0a 3c 70 3e 54 79 70 ore.</p>..<p>Typ
8890: 69 63 61 6c 6c 79 20 77 68 65 6e 20 76 69 73 69 ically when visi
88a0: 74 69 6e 67 20 77 65 62 20 73 69 74 65 73 2c 20 ting web sites,
88b0: 6f 6e 6c 79 20 74 68 65 20 63 6c 69 65 6e 74 20 only the client
88c0: 6e 65 65 64 73 20 74 6f 20 63 68 65 63 6b 20 74 needs to check t
88d0: 68 65 20 73 65 72 76 65 72 27 73 0d 0a 63 65 72 he server's..cer
88e0: 74 69 66 69 63 61 74 65 20 74 6f 20 65 6e 73 75 tificate to ensu
88f0: 72 65 20 69 74 20 69 73 20 76 61 6c 69 64 2e 20 re it is valid.
8900: 54 68 65 20 73 65 72 76 65 72 20 64 6f 65 73 6e The server doesn
8910: 27 74 20 6e 65 65 64 20 74 6f 20 63 68 65 63 6b 't need to check
8920: 20 74 68 65 20 63 6c 69 65 6e 74 0d 0a 63 65 72 the client..cer
8930: 74 69 66 69 63 61 74 65 20 75 6e 6c 65 73 73 20 tificate unless
8940: 79 6f 75 20 6e 65 65 64 20 74 6f 20 61 75 74 68 you need to auth
8950: 65 6e 74 69 63 61 74 65 20 77 69 74 68 20 74 68 enticate with th
8960: 65 6d 20 74 6f 20 6c 6f 67 69 6e 2c 20 65 74 63 em to login, etc
8970: 2e 20 53 65 65 20 74 68 65 0d 0a 3c 62 20 63 6c . See the..<b cl
8980: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 65 ass="option">-ce
8990: 72 74 3c 2f 62 3e 20 61 6e 64 20 3c 62 20 63 6c rt</b> and <b cl
89a0: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 65 ass="option">-ce
89b0: 72 74 66 69 6c 65 3c 2f 62 3e 20 6f 70 74 69 6f rtfile</b> optio
89c0: 6e 73 20 69 66 20 79 6f 75 20 6e 65 65 64 20 74 ns if you need t
89d0: 6f 20 70 72 6f 76 69 64 65 20 61 20 63 65 72 74 o provide a cert
89e0: 69 66 69 63 61 74 65 2e 3c 2f 70 3e 0d 0a 3c 2f ificate.</p>..</
89f0: 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 73 div>..<div id="s
8a00: 75 62 73 65 63 74 69 6f 6e 32 22 20 63 6c 61 73 ubsection2" clas
8a10: 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 75 62 73 s="doctools_subs
8a20: 65 63 74 69 6f 6e 22 3e 3c 68 33 3e 3c 61 20 6e ection"><h3><a n
8a30: 61 6d 65 3d 22 73 75 62 73 65 63 74 69 6f 6e 32 ame="subsection2
8a40: 22 3e 53 75 6d 6d 61 72 79 20 6f 66 20 63 6f 6d ">Summary of com
8a50: 6d 61 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e mand line option
8a60: 73 3c 2f 61 3e 3c 2f 68 33 3e 0d 0a 3c 70 3e 54 s</a></h3>..<p>T
8a70: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 he following opt
8a80: 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 66 6f ions are used fo
8a90: 72 20 70 65 65 72 20 63 65 72 74 69 66 69 63 61 r peer certifica
8aa0: 74 65 20 76 61 6c 69 64 61 74 69 6f 6e 3a 3c 2f te validation:</
8ab0: 70 3e 0d 0a 3c 64 6c 20 63 6c 61 73 73 3d 22 64 p>..<dl class="d
8ac0: 6f 63 74 6f 6f 6c 73 5f 6f 70 74 69 6f 6e 73 22 octools_options"
8ad0: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
8ae0: 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 64 69 72 3c "option">-cadir<
8af0: 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 /b> <i class="ar
8b00: 67 22 3e 64 69 72 65 63 74 6f 72 79 3c 2f 69 3e g">directory</i>
8b10: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 </dt>..<dd><p>Sp
8b20: 65 63 69 66 69 65 73 20 74 68 65 20 64 69 72 65 ecifies the dire
8b30: 63 74 6f 72 79 20 77 68 65 72 65 20 74 68 65 20 ctory where the
8b40: 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 68 Certificate Auth
8b50: 6f 72 69 74 79 20 28 43 41 29 20 63 65 72 74 69 ority (CA) certi
8b60: 66 69 63 61 74 65 73 20 61 72 65 0d 0a 73 74 6f ficates are..sto
8b70: 72 65 64 2e 20 54 68 65 20 64 65 66 61 75 6c 74 red. The default
8b80: 20 69 73 20 70 6c 61 74 66 6f 72 6d 20 73 70 65 is platform spe
8b90: 63 69 66 69 63 2c 20 62 75 74 20 69 73 20 75 73 cific, but is us
8ba0: 75 61 6c 6c 79 20 26 71 75 6f 74 3b 3c 62 20 63 ually "<b c
8bb0: 6c 61 73 73 3d 22 66 69 6c 65 22 3e 2f 65 74 63 lass="file">/etc
8bc0: 2f 73 73 6c 2f 63 65 72 74 73 3c 2f 62 3e 26 71 /ssl/certs</b>&q
8bd0: 75 6f 74 3b 20 6f 6e 0d 0a 4c 69 6e 75 78 2f 55 uot; on..Linux/U
8be0: 6e 69 78 20 73 79 73 74 65 6d 73 2e 20 54 68 65 nix systems. The
8bf0: 20 64 65 66 61 75 6c 74 20 6c 6f 63 61 74 69 6f default locatio
8c00: 6e 20 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 n can be overrid
8c10: 64 65 6e 20 62 79 20 74 68 65 0d 0a 3c 62 20 63 den by the..<b c
8c20: 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e lass="variable">
8c30: 53 53 4c 5f 43 45 52 54 5f 44 49 52 3c 2f 62 3e SSL_CERT_DIR</b>
8c40: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 environment var
8c50: 69 61 62 6c 65 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d iable.</p></dd>.
8c60: 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f .<dt><b class="o
8c70: 70 74 69 6f 6e 22 3e 2d 63 61 66 69 6c 65 3c 2f ption">-cafile</
8c80: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
8c90: 22 3e 66 69 6c 65 6e 61 6d 65 3c 2f 69 3e 3c 2f ">filename</i></
8ca0: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 63 dt>..<dd><p>Spec
8cb0: 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 20 77 ifies the file w
8cc0: 69 74 68 20 74 68 65 20 43 65 72 74 69 66 69 63 ith the Certific
8cd0: 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 28 43 ate Authority (C
8ce0: 41 29 20 63 65 72 74 69 66 69 63 61 74 65 73 20 A) certificates
8cf0: 74 6f 20 75 73 65 20 69 6e 0d 0a 3c 62 20 63 6c to use in..<b cl
8d00: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 50 45 4d 3c ass="const">PEM<
8d10: 2f 62 3e 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e /b> file format.
8d20: 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 The default is
8d30: 26 71 75 6f 74 3b 3c 62 20 63 6c 61 73 73 3d 22 "<b class="
8d40: 66 69 6c 65 22 3e 63 65 72 74 2e 70 65 6d 3c 2f file">cert.pem</
8d50: 62 3e 26 71 75 6f 74 3b 2c 20 69 6e 20 74 68 65 b>", in the
8d60: 20 4f 70 65 6e 53 53 4c 0d 0a 64 69 72 65 63 74 OpenSSL..direct
8d70: 6f 72 79 2e 20 4f 6e 20 4c 69 6e 75 78 2f 55 6e ory. On Linux/Un
8d80: 69 78 20 73 79 73 74 65 6d 73 2c 20 74 68 69 73 ix systems, this
8d90: 20 69 73 20 75 73 75 61 6c 6c 79 20 26 71 75 6f is usually &quo
8da0: 74 3b 3c 62 20 63 6c 61 73 73 3d 22 66 69 6c 65 t;<b class="file
8db0: 22 3e 2f 65 74 63 2f 73 73 6c 2f 63 61 2d 62 75 ">/etc/ssl/ca-bu
8dc0: 6e 64 6c 65 2e 70 65 6d 3c 2f 62 3e 26 71 75 6f ndle.pem</b>&quo
8dd0: 74 3b 2e 0d 0a 54 68 65 20 64 65 66 61 75 6c 74 t;...The default
8de0: 20 66 69 6c 65 20 63 61 6e 20 62 65 20 6f 76 65 file can be ove
8df0: 72 72 69 64 64 65 6e 20 62 79 20 74 68 65 20 3c rridden by the <
8e00: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
8e10: 65 22 3e 53 53 4c 5f 43 45 52 54 5f 46 49 4c 45 e">SSL_CERT_FILE
8e20: 3c 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 </b> environment
8e30: 0d 0a 76 61 72 69 61 62 6c 65 2e 3c 2f 70 3e 3c ..variable.</p><
8e40: 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 /dd>..<dt><b cla
8e50: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 73 ss="option">-cas
8e60: 74 6f 72 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 tore</b> <i clas
8e70: 73 3d 22 61 72 67 22 3e 55 52 49 3c 2f 69 3e 3c s="arg">URI</i><
8e80: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 70 65 /dt>..<dd><p>Spe
8e90: 63 69 66 69 65 73 20 74 68 65 20 55 6e 69 66 6f cifies the Unifo
8ea0: 72 6d 20 52 65 73 6f 75 72 63 65 20 49 64 65 6e rm Resource Iden
8eb0: 74 69 66 69 65 72 20 28 55 52 49 29 20 66 6f 72 tifier (URI) for
8ec0: 20 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 the Certificate
8ed0: 20 41 75 74 68 6f 72 69 74 79 0d 0a 28 43 41 29 Authority..(CA)
8ee0: 20 73 74 6f 72 65 2c 20 77 68 69 63 68 20 6d 61 store, which ma
8ef0: 79 20 62 65 20 61 20 73 69 6e 67 6c 65 20 63 6f y be a single co
8f00: 6e 74 61 69 6e 65 72 20 6f 72 20 61 20 63 61 74 ntainer or a cat
8f10: 61 6c 6f 67 20 6f 66 20 63 6f 6e 74 61 69 6e 65 alog of containe
8f20: 72 73 2e 0d 0a 53 74 61 72 74 69 6e 67 20 77 69 rs...Starting wi
8f30: 74 68 20 4f 70 65 6e 53 53 4c 20 33 2e 32 20 6f th OpenSSL 3.2 o
8f40: 6e 20 4d 53 20 57 69 6e 64 6f 77 73 2c 20 73 65 n MS Windows, se
8f50: 74 20 74 6f 20 26 71 75 6f 74 3b 3c 62 20 63 6c t to "<b cl
8f60: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 6f 72 67 2e ass="const">org.
8f70: 6f 70 65 6e 73 73 6c 2e 77 69 6e 73 74 6f 72 65 openssl.winstore
8f80: 3a 2f 2f 3c 2f 62 3e 26 71 75 6f 74 3b 0d 0a 74 ://</b>"..t
8f90: 6f 20 75 73 65 20 74 68 65 20 62 75 69 6c 74 2d o use the built-
8fa0: 69 6e 20 4d 53 20 57 69 6e 64 6f 77 73 20 43 65 in MS Windows Ce
8fb0: 72 74 69 66 69 63 61 74 65 20 53 74 6f 72 65 2e rtificate Store.
8fc0: 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c Starting in Tcl
8fd0: 54 4c 53 20 32 2e 30 2c 20 74 68 69 73 0d 0a 69 TLS 2.0, this..i
8fe0: 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 66 s the default if
8ff0: 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f <b class="optio
9000: 6e 22 3e 2d 63 61 64 69 72 3c 2f 62 3e 2c 20 3c n">-cadir</b>, <
9010: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
9020: 3e 2d 63 61 64 69 72 3c 2f 62 3e 2c 20 61 6e 64 >-cadir</b>, and
9030: 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f <b class="optio
9040: 6e 22 3e 2d 63 61 73 74 6f 72 65 3c 2f 62 3e 20 n">-castore</b>
9050: 61 72 65 0d 0a 6e 6f 74 20 73 70 65 63 69 66 69 are..not specifi
9060: 65 64 2e 20 54 68 69 73 20 73 74 6f 72 65 20 6f ed. This store o
9070: 6e 6c 79 20 73 75 70 70 6f 72 74 73 20 72 6f 6f nly supports roo
9080: 74 20 63 65 72 74 69 66 69 63 61 74 65 20 73 74 t certificate st
9090: 6f 72 65 73 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a ores.</p></dd>..
90a0: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 <dt><b class="op
90b0: 74 69 6f 6e 22 3e 2d 72 65 71 75 65 73 74 3c 2f tion">-request</
90c0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
90d0: 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d ">bool</i></dt>.
90e0: 0a 3c 64 64 3e 3c 70 3e 52 65 71 75 65 73 74 20 .<dd><p>Request
90f0: 61 20 63 65 72 74 69 66 69 63 61 74 65 20 66 72 a certificate fr
9100: 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 69 om the peer duri
9110: 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 73 ng the SSL hands
9120: 68 61 6b 65 2e 20 54 68 69 73 20 69 73 20 6e 65 hake. This is ne
9130: 65 64 65 64 0d 0a 74 6f 20 64 6f 20 43 65 72 74 eded..to do Cert
9140: 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 ificate Validati
9150: 6f 6e 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 on. Starting in
9160: 54 63 6c 54 4c 53 20 31 2e 38 2c 20 74 68 65 20 TclTLS 1.8, the
9170: 64 65 66 61 75 6c 74 20 69 73 0d 0a 3c 62 20 63 default is..<b c
9180: 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 72 75 lass="const">tru
9190: 65 3c 2f 62 3e 20 66 6f 72 20 63 6c 69 65 6e 74 e</b> for client
91a0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 53 74 connections. St
91b0: 61 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 arting in TclTLS
91c0: 20 32 2e 30 2c 20 69 66 20 73 65 74 20 74 6f 0d 2.0, if set to.
91d0: 0a 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 .<b class="const
91e0: 22 3e 66 61 6c 73 65 3c 2f 62 3e 20 61 6e 64 20 ">false</b> and
91f0: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
9200: 22 3e 2d 72 65 71 75 69 72 65 3c 2f 62 3e 20 69 ">-require</b> i
9210: 73 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 s <b class="cons
9220: 74 22 3e 74 72 75 65 3c 2f 62 3e 2c 20 74 68 65 t">true</b>, the
9230: 6e 20 74 68 69 73 20 77 69 6c 6c 20 62 65 0d 0a n this will be..
9240: 6f 76 65 72 72 69 64 64 65 6e 20 74 6f 20 3c 62 overridden to <b
9250: 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 class="const">t
9260: 72 75 65 3c 2f 62 3e 2e 20 49 6e 20 61 64 64 69 rue</b>. In addi
9270: 74 69 6f 6e 2c 20 74 68 65 20 63 6c 69 65 6e 74 tion, the client
9280: 20 63 61 6e 20 6d 61 6e 75 61 6c 6c 79 20 69 6e can manually in
9290: 73 70 65 63 74 20 61 6e 64 0d 0a 61 63 63 65 70 spect and..accep
92a0: 74 20 6f 72 20 72 65 6a 65 63 74 20 65 61 63 68 t or reject each
92b0: 20 63 65 72 74 69 66 69 63 61 74 65 20 75 73 69 certificate usi
92c0: 6e 67 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d ng the <b class=
92d0: 22 6f 70 74 69 6f 6e 22 3e 2d 76 61 6c 69 64 61 "option">-valida
92e0: 74 65 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 6f 70 tecommand</b> op
92f0: 74 69 6f 6e 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a tion.</p></dd>..
9300: 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 6f 70 <dt><b class="op
9310: 74 69 6f 6e 22 3e 2d 72 65 71 75 69 72 65 3c 2f tion">-require</
9320: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
9330: 22 3e 62 6f 6f 6c 3c 2f 69 3e 3c 2f 64 74 3e 0d ">bool</i></dt>.
9340: 0a 3c 64 64 3e 3c 70 3e 52 65 71 75 69 72 65 20 .<dd><p>Require
9350: 61 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 a valid certific
9360: 61 74 65 20 66 72 6f 6d 20 74 68 65 20 70 65 65 ate from the pee
9370: 72 20 64 75 72 69 6e 67 20 74 68 65 20 53 53 4c r during the SSL
9380: 20 68 61 6e 64 73 68 61 6b 65 2e 20 49 66 20 74 handshake. If t
9390: 68 69 73 20 69 73 0d 0a 73 65 74 20 74 6f 20 74 his is..set to t
93a0: 72 75 65 2c 20 74 68 65 6e 20 3c 62 20 63 6c 61 rue, then <b cla
93b0: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 72 65 71 ss="option">-req
93c0: 75 65 73 74 3c 2f 62 3e 20 6d 75 73 74 20 61 6c uest</b> must al
93d0: 73 6f 20 62 65 20 73 65 74 20 74 6f 20 74 72 75 so be set to tru
93e0: 65 20 61 6e 64 20 61 20 65 69 74 68 65 72 0d 0a e and a either..
93f0: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
9400: 22 3e 2d 63 61 64 69 72 3c 2f 62 3e 2c 20 3c 62 ">-cadir</b>, <b
9410: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
9420: 2d 63 61 66 69 6c 65 3c 2f 62 3e 2c 20 3c 62 20 -cafile</b>, <b
9430: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
9440: 63 61 73 74 6f 72 65 3c 2f 62 3e 2c 20 6f 72 20 castore</b>, or
9450: 61 20 70 6c 61 74 66 6f 72 6d 20 64 65 66 61 75 a platform defau
9460: 6c 74 0d 0a 6d 75 73 74 20 62 65 20 70 72 6f 76 lt..must be prov
9470: 69 64 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f ided in order to
9480: 20 76 61 6c 69 64 61 74 65 20 61 67 61 69 6e 73 validate agains
9490: 74 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 t. The default i
94a0: 6e 20 54 63 6c 54 4c 53 20 31 2e 38 20 61 6e 64 n TclTLS 1.8 and
94b0: 0d 0a 65 61 72 6c 69 65 72 20 76 65 72 73 69 6f ..earlier versio
94c0: 6e 73 20 69 73 20 3c 62 20 63 6c 61 73 73 3d 22 ns is <b class="
94d0: 63 6f 6e 73 74 22 3e 66 61 6c 73 65 3c 2f 62 3e const">false</b>
94e0: 20 73 69 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 70 since not all p
94f0: 6c 61 74 66 6f 72 6d 73 20 68 61 76 65 20 63 65 latforms have ce
9500: 72 74 69 66 69 63 61 74 65 73 20 74 6f 0d 0a 76 rtificates to..v
9510: 61 6c 69 64 61 74 65 20 61 67 61 69 6e 73 74 20 alidate against
9520: 69 6e 20 61 20 66 6f 72 6d 20 63 6f 6d 70 61 74 in a form compat
9530: 69 62 6c 65 20 77 69 74 68 20 4f 70 65 6e 53 53 ible with OpenSS
9540: 4c 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 L. Starting in T
9550: 63 6c 54 4c 53 20 32 2e 30 2c 0d 0a 74 68 65 20 clTLS 2.0,..the
9560: 64 65 66 61 75 6c 74 20 69 73 20 3c 62 20 63 6c default is <b cl
9570: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 74 72 75 65 ass="const">true
9580: 3c 2f 62 3e 20 66 6f 72 20 63 6c 69 65 6e 74 20 </b> for client
9590: 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 3c 2f 70 3e connections.</p>
95a0: 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 0d 0a 3c 2f </dd>..</dl>..</
95b0: 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 73 div>..<div id="s
95c0: 75 62 73 65 63 74 69 6f 6e 33 22 20 63 6c 61 73 ubsection3" clas
95d0: 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 75 62 73 s="doctools_subs
95e0: 65 63 74 69 6f 6e 22 3e 3c 68 33 3e 3c 61 20 6e ection"><h3><a n
95f0: 61 6d 65 3d 22 73 75 62 73 65 63 74 69 6f 6e 33 ame="subsection3
9600: 22 3e 57 68 65 6e 20 61 72 65 20 63 6f 6d 6d 61 ">When are comma
9610: 6e 64 20 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 20 nd line options
9620: 6e 65 65 64 65 64 3f 3c 2f 61 3e 3c 2f 68 33 3e needed?</a></h3>
9630: 0d 0a 3c 70 3e 49 6e 20 54 63 6c 54 4c 53 20 31 ..<p>In TclTLS 1
9640: 2e 38 20 61 6e 64 20 65 61 72 6c 69 65 72 20 76 .8 and earlier v
9650: 65 72 73 69 6f 6e 73 2c 20 63 65 72 74 69 66 69 ersions, certifi
9660: 63 61 74 65 20 76 61 6c 69 64 61 74 69 6f 6e 20 cate validation
9670: 69 73 0d 0a 3c 65 6d 3e 4e 4f 54 3c 2f 65 6d 3e is..<em>NOT</em>
9680: 20 65 6e 61 62 6c 65 64 20 62 79 20 64 65 66 61 enabled by defa
9690: 75 6c 74 2e 20 54 68 69 73 20 6c 69 6d 69 74 61 ult. This limita
96a0: 74 69 6f 6e 20 69 73 20 64 75 65 20 74 6f 20 74 tion is due to t
96b0: 68 65 20 6c 61 63 6b 20 6f 66 20 61 20 63 6f 6d he lack of a com
96c0: 6d 6f 6e 0d 0a 63 72 6f 73 73 20 70 6c 61 74 66 mon..cross platf
96d0: 6f 72 6d 20 64 61 74 61 62 61 73 65 20 6f 66 20 orm database of
96e0: 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 68 Certificate Auth
96f0: 6f 72 69 74 79 20 28 43 41 29 20 70 72 6f 76 69 ority (CA) provi
9700: 64 65 64 20 63 65 72 74 69 66 69 63 61 74 65 73 ded certificates
9710: 20 74 6f 0d 0a 76 61 6c 69 64 61 74 65 20 61 67 to..validate ag
9720: 61 69 6e 73 74 2e 20 4d 61 6e 79 20 4c 69 6e 75 ainst. Many Linu
9730: 78 20 73 79 73 74 65 6d 73 20 6e 61 74 69 76 65 x systems native
9740: 6c 79 20 73 75 70 70 6f 72 74 20 4f 70 65 6e 53 ly support OpenS
9750: 53 4c 20 61 6e 64 20 74 68 75 73 20 68 61 76 65 SL and thus have
9760: 0d 0a 74 68 65 73 65 20 63 65 72 74 69 66 69 63 ..these certific
9770: 61 74 65 73 20 69 6e 73 74 61 6c 6c 65 64 20 61 ates installed a
9780: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 4f 53 s part of the OS
9790: 2c 20 62 75 74 20 4d 61 63 4f 53 20 61 6e 64 20 , but MacOS and
97a0: 4d 53 20 57 69 6e 64 6f 77 73 20 64 6f 20 6e 6f MS Windows do no
97b0: 74 2e 0d 0a 53 74 61 72 69 6e 67 20 69 6e 20 54 t...Staring in T
97c0: 63 6c 54 4c 53 20 32 2e 30 2c 20 74 68 65 20 64 clTLS 2.0, the d
97d0: 65 66 61 75 6c 74 20 66 6f 72 20 63 6c 69 65 6e efault for clien
97e0: 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 68 61 t connections ha
97f0: 73 20 62 65 65 6e 20 63 68 61 6e 67 65 64 20 74 s been changed t
9800: 6f 0d 0a 72 65 71 75 69 72 65 20 63 65 72 74 69 o..require certi
9810: 66 69 63 61 74 65 20 76 61 6c 69 64 61 74 69 6f ficate validatio
9820: 6e 20 62 79 20 64 65 66 61 75 6c 74 2e 20 49 6e n by default. In
9830: 20 6f 72 64 65 72 20 74 6f 20 75 73 65 20 74 68 order to use th
9840: 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 e <b class="opti
9850: 6f 6e 22 3e 2d 72 65 71 75 69 72 65 3c 2f 62 3e on">-require</b>
9860: 0d 0a 6f 70 74 69 6f 6e 2c 20 6f 6e 65 20 6f 66 ..option, one of
9870: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d the following m
9880: 75 73 74 20 62 65 20 74 72 75 65 3a 3c 2f 70 3e ust be true:</p>
9890: 0d 0a 3c 75 6c 20 63 6c 61 73 73 3d 22 64 6f 63 ..<ul class="doc
98a0: 74 6f 6f 6c 73 5f 69 74 65 6d 69 7a 65 64 22 3e tools_itemized">
98b0: 0d 0a 3c 6c 69 3e 3c 70 3e 4f 6e 20 4c 69 6e 75 ..<li><p>On Linu
98c0: 78 20 61 6e 64 20 55 6e 69 78 20 73 79 73 74 65 x and Unix syste
98d0: 6d 73 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 ms with OpenSSL
98e0: 61 6c 72 65 61 64 79 20 69 6e 73 74 61 6c 6c 65 already installe
98f0: 64 20 6f 72 20 69 66 20 74 68 65 20 43 41 0d 0a d or if the CA..
9900: 63 65 72 74 69 66 69 63 61 74 65 73 20 61 72 65 certificates are
9910: 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 50 45 available in PE
9920: 4d 20 66 6f 72 6d 61 74 2c 20 61 6e 64 20 69 66 M format, and if
9930: 20 74 68 65 79 20 61 72 65 20 73 74 6f 72 65 64 they are stored
9940: 20 69 6e 20 74 68 65 0d 0a 73 74 61 6e 64 61 72 in the..standar
9950: 64 20 6c 6f 63 61 74 69 6f 6e 73 2c 20 6f 72 20 d locations, or
9960: 69 66 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d if the <b class=
9970: 22 76 61 72 69 61 62 6c 65 22 3e 53 53 4c 5f 43 "variable">SSL_C
9980: 45 52 54 5f 44 49 52 3c 2f 62 3e 20 6f 72 20 3c ERT_DIR</b> or <
9990: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
99a0: 65 22 3e 53 53 4c 5f 43 45 52 54 5f 46 49 4c 45 e">SSL_CERT_FILE
99b0: 3c 2f 62 3e 0d 0a 65 6e 76 69 72 6f 6e 6d 65 6e </b>..environmen
99c0: 74 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 t variables are
99d0: 73 65 74 2c 20 74 68 65 6e 20 3c 62 20 63 6c 61 set, then <b cla
99e0: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 64 ss="option">-cad
99f0: 69 72 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 ir</b>, <b class
9a00: 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 64 69 72 ="option">-cadir
9a10: 3c 2f 62 3e 2c 0d 0a 61 6e 64 20 3c 62 20 63 6c </b>,..and <b cl
9a20: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 ass="option">-ca
9a30: 73 74 6f 72 65 3c 2f 62 3e 20 61 72 65 6e 27 74 store</b> aren't
9a40: 20 6e 65 65 64 65 64 2e 3c 2f 70 3e 3c 2f 6c 69 needed.</p></li
9a50: 3e 0d 0a 3c 6c 69 3e 3c 70 3e 49 66 20 4f 70 65 >..<li><p>If Ope
9a60: 6e 53 53 4c 20 69 73 20 6e 6f 74 20 69 6e 73 74 nSSL is not inst
9a70: 61 6c 6c 65 64 20 69 6e 20 74 68 65 20 64 65 66 alled in the def
9a80: 61 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 2c 20 6f ault location, o
9a90: 72 20 77 68 65 6e 20 75 73 69 6e 67 20 4d 61 63 r when using Mac
9aa0: 20 4f 53 0d 0a 6f 72 20 4d 53 20 57 69 6e 64 6f OS..or MS Windo
9ab0: 77 73 20 61 6e 64 20 4f 70 65 6e 53 53 4c 20 69 ws and OpenSSL i
9ac0: 73 20 69 6e 73 74 61 6c 6c 65 64 2c 20 74 68 65 s installed, the
9ad0: 20 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 <b class="varia
9ae0: 62 6c 65 22 3e 53 53 4c 5f 43 45 52 54 5f 44 49 ble">SSL_CERT_DI
9af0: 52 3c 2f 62 3e 20 61 6e 64 2f 6f 72 0d 0a 3c 62 R</b> and/or..<b
9b00: 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c 65 class="variable
9b10: 22 3e 53 53 4c 5f 43 45 52 54 5f 46 49 4c 45 3c ">SSL_CERT_FILE<
9b20: 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 /b> environment
9b30: 76 61 72 69 61 62 6c 65 73 20 6f 72 20 74 68 65 variables or the
9b40: 20 6f 6e 65 20 6f 66 20 74 68 65 20 3c 62 20 63 one of the <b c
9b50: 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 lass="option">-c
9b60: 61 64 69 72 3c 2f 62 3e 2c 0d 0a 3c 62 20 63 6c adir</b>,..<b cl
9b70: 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 61 ass="option">-ca
9b80: 64 69 72 3c 2f 62 3e 2c 20 6f 72 20 3c 62 20 63 dir</b>, or <b c
9b90: 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 lass="option">-c
9ba0: 61 73 74 6f 72 65 3c 2f 62 3e 20 6f 70 74 69 6f astore</b> optio
9bb0: 6e 73 20 6d 75 73 74 20 62 65 20 64 65 66 69 6e ns must be defin
9bc0: 65 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0d 0a 3c 6c ed.</p></li>..<l
9bd0: 69 3e 3c 70 3e 4f 6e 20 4d 53 20 57 69 6e 64 6f i><p>On MS Windo
9be0: 77 73 2c 20 73 74 61 72 74 69 6e 67 20 69 6e 20 ws, starting in
9bf0: 4f 70 65 6e 53 53 4c 20 33 2e 32 2c 20 69 74 20 OpenSSL 3.2, it
9c00: 69 73 20 6e 6f 77 20 70 6f 73 73 69 62 6c 65 20 is now possible
9c10: 74 6f 20 61 63 63 65 73 73 20 74 68 65 0d 0a 62 to access the..b
9c20: 75 69 6c 74 2d 69 6e 20 57 69 6e 64 6f 77 73 20 uilt-in Windows
9c30: 43 65 72 74 69 66 69 63 61 74 65 20 53 74 6f 72 Certificate Stor
9c40: 65 20 66 72 6f 6d 20 4f 70 65 6e 53 53 4c 2e 20 e from OpenSSL.
9c50: 54 68 69 73 20 63 61 6e 20 62 65 20 75 74 69 6c This can be util
9c60: 69 7a 65 64 20 62 79 0d 0a 73 65 74 74 69 6e 67 ized by..setting
9c70: 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f the <b class="o
9c80: 70 74 69 6f 6e 22 3e 2d 63 61 73 74 6f 72 65 3c ption">-castore<
9c90: 2f 62 3e 20 6f 70 74 69 6f 6e 20 74 6f 20 26 71 /b> option to &q
9ca0: 75 6f 74 3b 3c 62 20 63 6c 61 73 73 3d 22 63 6f uot;<b class="co
9cb0: 6e 73 74 22 3e 6f 72 67 2e 6f 70 65 6e 73 73 6c nst">org.openssl
9cc0: 2e 77 69 6e 73 74 6f 72 65 3a 2f 2f 3c 2f 62 3e .winstore://</b>
9cd0: 26 71 75 6f 74 3b 2e 0d 0a 49 6e 20 54 63 6c 54 "...In TclT
9ce0: 4c 53 20 32 2e 30 2c 20 74 68 69 73 20 69 73 20 LS 2.0, this is
9cf0: 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 the default valu
9d00: 65 20 69 66 20 3c 62 20 63 6c 61 73 73 3d 22 6f e if <b class="o
9d10: 70 74 69 6f 6e 22 3e 2d 63 61 64 69 72 3c 2f 62 ption">-cadir</b
9d20: 3e 2c 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 >,..<b class="op
9d30: 74 69 6f 6e 22 3e 2d 63 61 64 69 72 3c 2f 62 3e tion">-cadir</b>
9d40: 2c 20 61 6e 64 20 3c 62 20 63 6c 61 73 73 3d 22 , and <b class="
9d50: 6f 70 74 69 6f 6e 22 3e 2d 63 61 73 74 6f 72 65 option">-castore
9d60: 3c 2f 62 3e 20 61 72 65 20 6e 6f 74 20 73 70 65 </b> are not spe
9d70: 63 69 66 69 65 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e cified.</p></li>
9d80: 0d 0a 3c 6c 69 3e 3c 70 3e 49 66 20 4f 70 65 6e ..<li><p>If Open
9d90: 53 53 4c 20 69 73 20 6e 6f 74 20 69 6e 73 74 61 SSL is not insta
9da0: 6c 6c 65 64 20 6f 72 20 74 68 65 20 43 41 20 63 lled or the CA c
9db0: 65 72 74 69 66 69 63 61 74 65 73 20 61 72 65 20 ertificates are
9dc0: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 69 6e not available in
9dd0: 20 50 45 4d 0d 0a 66 6f 72 6d 61 74 2c 20 74 68 PEM..format, th
9de0: 65 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 e CA certificate
9df0: 73 20 6d 75 73 74 20 62 65 20 64 6f 77 6e 6c 6f s must be downlo
9e00: 61 64 65 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c aded and install
9e10: 65 64 20 77 69 74 68 20 74 68 65 20 75 73 65 72 ed with the user
9e20: 0d 0a 73 6f 66 74 77 61 72 65 2e 20 54 68 65 20 ..software. The
9e30: 43 55 52 4c 20 74 65 61 6d 20 6d 61 6b 65 73 20 CURL team makes
9e40: 74 68 65 6d 20 61 76 61 69 6c 61 62 6c 65 20 61 them available a
9e50: 74 0d 0a 3c 61 20 68 72 65 66 3d 22 68 74 74 70 t..<a href="http
9e60: 73 3a 2f 2f 63 75 72 6c 2e 73 65 2f 64 6f 63 73 s://curl.se/docs
9e70: 2f 63 61 65 78 74 72 61 63 74 2e 68 74 6d 6c 22 /caextract.html"
9e80: 3e 43 41 20 63 65 72 74 69 66 69 63 61 74 65 73 >CA certificates
9e90: 20 65 78 74 72 61 63 74 65 64 0d 0a 66 72 6f 6d extracted..from
9ea0: 20 4d 6f 7a 69 6c 6c 61 3c 2f 61 3e 20 69 6e 20 Mozilla</a> in
9eb0: 74 68 65 20 26 71 75 6f 74 3b 3c 62 20 63 6c 61 the "<b cla
9ec0: 73 73 3d 22 66 69 6c 65 22 3e 63 61 63 65 72 74 ss="file">cacert
9ed0: 2e 70 65 6d 3c 2f 62 3e 26 71 75 6f 74 3b 20 66 .pem</b>" f
9ee0: 69 6c 65 2e 20 59 6f 75 20 6d 75 73 74 20 74 68 ile. You must th
9ef0: 65 6e 20 65 69 74 68 65 72 20 73 65 74 20 74 68 en either set th
9f00: 65 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 e..<b class="var
9f10: 69 61 62 6c 65 22 3e 53 53 4c 5f 43 45 52 54 5f iable">SSL_CERT_
9f20: 44 49 52 3c 2f 62 3e 20 61 6e 64 2f 6f 72 20 3c DIR</b> and/or <
9f30: 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 6c b class="variabl
9f40: 65 22 3e 53 53 4c 5f 43 45 52 54 5f 46 49 4c 45 e">SSL_CERT_FILE
9f50: 3c 2f 62 3e 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 </b> environment
9f60: 20 76 61 72 69 61 62 6c 65 73 20 6f 72 20 74 68 variables or th
9f70: 65 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 e..<b class="opt
9f80: 69 6f 6e 22 3e 2d 63 61 64 69 72 3c 2f 62 3e 20 ion">-cadir</b>
9f90: 6f 72 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 or <b class="opt
9fa0: 69 6f 6e 22 3e 2d 63 61 66 69 6c 65 3c 2f 62 3e ion">-cafile</b>
9fb0: 20 6f 70 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 options to the
9fc0: 43 41 20 63 65 72 74 20 66 69 6c 65 27 73 20 69 CA cert file's i
9fd0: 6e 73 74 61 6c 6c 0d 0a 6c 6f 63 61 74 69 6f 6e nstall..location
9fe0: 2e 20 49 74 20 69 73 20 79 6f 75 72 20 72 65 73 . It is your res
9ff0: 70 6f 6e 73 69 62 69 6c 69 74 79 20 74 6f 20 6b ponsibility to k
a000: 65 65 70 20 74 68 69 73 20 66 69 6c 65 20 75 70 eep this file up
a010: 20 74 6f 20 64 61 74 65 2e 3c 2f 70 3e 3c 2f 6c to date.</p></l
a020: 69 3e 0d 0a 3c 2f 75 6c 3e 0d 0a 3c 2f 64 69 76 i>..</ul>..</div
a030: 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 >..</div>..<div
a040: 69 64 3d 22 73 65 63 74 69 6f 6e 35 22 20 63 6c id="section5" cl
a050: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 ass="doctools_se
a060: 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 ction"><h2><a na
a070: 6d 65 3d 22 73 65 63 74 69 6f 6e 35 22 3e 43 61 me="section5">Ca
a080: 6c 6c 62 61 63 6b 20 4f 70 74 69 6f 6e 73 3c 2f llback Options</
a090: 61 3e 3c 2f 68 32 3e 0d 0a 3c 70 3e 41 73 20 70 a></h2>..<p>As p
a0a0: 72 65 76 69 6f 75 73 6c 79 20 64 65 73 63 72 69 reviously descri
a0b0: 62 65 64 2c 20 65 61 63 68 20 63 68 61 6e 6e 65 bed, each channe
a0c0: 6c 20 63 61 6e 20 62 65 20 67 69 76 65 6e 20 74 l can be given t
a0d0: 68 65 69 72 20 6f 77 6e 20 63 61 6c 6c 62 61 63 heir own callbac
a0e0: 6b 73 0d 0a 74 6f 20 68 61 6e 64 6c 65 20 69 6e ks..to handle in
a0f0: 74 65 72 6d 65 64 69 61 74 65 20 70 72 6f 63 65 termediate proce
a100: 73 73 69 6e 67 20 62 79 20 74 68 65 20 4f 70 65 ssing by the Ope
a110: 6e 53 53 4c 20 6c 69 62 72 61 72 79 2c 20 75 73 nSSL library, us
a120: 69 6e 67 20 74 68 65 0d 0a 3c 62 20 63 6c 61 73 ing the..<b clas
a130: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 6f 6d 6d s="option">-comm
a140: 61 6e 64 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 and</b>, <b clas
a150: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 70 61 73 73 s="option">-pass
a160: 77 6f 72 64 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 word</b>, and <b
a170: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
a180: 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e -validate_comman
a190: 64 3c 2f 62 3e 20 6f 70 74 69 6f 6e 73 0d 0a 70 d</b> options..p
a1a0: 61 73 73 65 64 20 74 6f 20 65 69 74 68 65 72 20 assed to either
a1b0: 6f 66 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 of <b class="cmd
a1c0: 22 3e 74 6c 73 3a 3a 73 6f 63 6b 65 74 3c 2f 62 ">tls::socket</b
a1d0: 3e 20 6f 72 20 3c 62 20 63 6c 61 73 73 3d 22 63 > or <b class="c
a1e0: 6d 64 22 3e 74 6c 73 3a 3a 69 6d 70 6f 72 74 3c md">tls::import<
a1f0: 2f 62 3e 2e 0d 0a 55 6e 6c 69 6b 65 20 70 72 65 /b>...Unlike pre
a200: 76 69 6f 75 73 20 76 65 72 73 69 6f 6e 73 20 6f vious versions o
a210: 66 20 54 63 6c 54 4c 53 2c 20 6f 6e 6c 79 20 69 f TclTLS, only i
a220: 66 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 67 f the callback g
a230: 65 6e 65 72 61 74 65 73 20 61 6e 20 65 72 72 6f enerates an erro
a240: 72 2c 0d 0a 77 69 6c 6c 20 74 68 65 20 3c 62 20 r,..will the <b
a250: 63 6c 61 73 73 3d 22 73 79 73 63 6d 64 22 3e 62 class="syscmd">b
a260: 67 65 72 72 6f 72 3c 2f 62 3e 20 63 6f 6d 6d 61 gerror</b> comma
a270: 6e 64 20 62 65 20 69 6e 76 6f 6b 65 64 20 77 69 nd be invoked wi
a280: 74 68 20 74 68 65 20 65 72 72 6f 72 20 69 6e 66 th the error inf
a290: 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0d 0a 3c ormation.</p>..<
a2a0: 64 69 76 20 69 64 3d 22 73 75 62 73 65 63 74 69 div id="subsecti
a2b0: 6f 6e 34 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 on4" class="doct
a2c0: 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 6f 6e 22 ools_subsection"
a2d0: 3e 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 73 75 ><h3><a name="su
a2e0: 62 73 65 63 74 69 6f 6e 34 22 3e 56 61 6c 75 65 bsection4">Value
a2f0: 73 20 66 6f 72 20 43 6f 6d 6d 61 6e 64 20 43 61 s for Command Ca
a300: 6c 6c 62 61 63 6b 3c 2f 61 3e 3c 2f 68 33 3e 0d llback</a></h3>.
a310: 0a 3c 70 3e 54 68 65 20 63 61 6c 6c 62 61 63 6b .<p>The callback
a320: 20 66 6f 72 20 74 68 65 20 3c 62 20 63 6c 61 73 for the <b clas
a330: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 63 6f 6d 6d s="option">-comm
a340: 61 6e 64 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 69 and</b> option i
a350: 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 73 65 76 s invoked at sev
a360: 65 72 61 6c 20 70 6f 69 6e 74 73 20 64 75 72 69 eral points duri
a370: 6e 67 20 74 68 65 0d 0a 4f 70 65 6e 53 53 4c 20 ng the..OpenSSL
a380: 68 61 6e 64 73 68 61 6b 65 20 61 6e 64 20 64 75 handshake and du
a390: 72 69 6e 67 20 72 6f 75 74 69 6e 65 20 6f 70 65 ring routine ope
a3a0: 72 61 74 69 6f 6e 73 2e 20 53 65 65 20 62 65 6c rations. See bel
a3b0: 6f 77 20 66 6f 72 20 74 68 65 20 70 6f 73 73 69 ow for the possi
a3c0: 62 6c 65 0d 0a 61 72 67 75 6d 65 6e 74 73 20 70 ble..arguments p
a3d0: 61 73 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c assed to the cal
a3e0: 6c 62 61 63 6b 20 73 63 72 69 70 74 2e 20 56 61 lback script. Va
a3f0: 6c 75 65 73 20 72 65 74 75 72 6e 65 64 20 66 72 lues returned fr
a400: 6f 6d 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 om the callback
a410: 61 72 65 0d 0a 69 67 6e 6f 72 65 64 2e 3c 2f 70 are..ignored.</p
a420: 3e 0d 0a 3c 64 6c 20 63 6c 61 73 73 3d 22 64 6f >..<dl class="do
a430: 63 74 6f 6f 6c 73 5f 6f 70 74 69 6f 6e 73 22 3e ctools_options">
a440: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
a450: 6f 70 74 69 6f 6e 22 3e 65 72 72 6f 72 3c 2f 62 option">error</b
a460: 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 > <i class="arg"
a470: 3e 63 68 61 6e 6e 65 6c 49 64 20 6d 65 73 73 61 >channelId messa
a480: 67 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 ge</i></dt>..<dd
a490: 3e 3c 70 3e 54 68 69 73 20 66 6f 72 6d 20 6f 66 ><p>This form of
a4a0: 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 callback is inv
a4b0: 6f 6b 65 64 20 77 68 65 6e 65 76 65 72 20 61 6e oked whenever an
a4c0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 error occurs du
a4d0: 72 69 6e 67 20 74 68 65 20 69 6e 69 74 69 61 6c ring the initial
a4e0: 0d 0a 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 68 61 ..connection, ha
a4f0: 6e 64 73 68 61 6b 65 2c 20 6f 72 20 49 2f 4f 20 ndshake, or I/O
a500: 6f 70 65 72 61 74 69 6f 6e 73 2e 20 54 68 65 20 operations. The
a510: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 6d <i class="arg">m
a520: 65 73 73 61 67 65 3c 2f 69 3e 20 61 72 67 75 6d essage</i> argum
a530: 65 6e 74 20 63 61 6e 20 62 65 0d 0a 66 72 6f 6d ent can be..from
a540: 20 74 68 65 20 54 63 6c 5f 45 72 72 6e 6f 4d 73 the Tcl_ErrnoMs
a550: 67 2c 20 4f 70 65 6e 53 53 4c 20 66 75 6e 63 74 g, OpenSSL funct
a560: 69 6f 6e 20 3c 62 20 63 6c 61 73 73 3d 22 66 75 ion <b class="fu
a570: 6e 63 74 69 6f 6e 22 3e 45 52 52 5f 72 65 61 73 nction">ERR_reas
a580: 6f 6e 5f 65 72 72 6f 72 5f 73 74 72 69 6e 67 28 on_error_string(
a590: 29 3c 2f 62 3e 2c 0d 0a 6f 72 20 61 20 63 75 73 )</b>,..or a cus
a5a0: 74 6f 6d 20 6d 65 73 73 61 67 65 2e 20 54 68 69 tom message. Thi
a5b0: 73 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 6e 65 s callback is ne
a5c0: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 w for TclTLS 1.8
a5d0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
a5e0: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
a5f0: 22 3e 69 6e 66 6f 3c 2f 62 3e 20 3c 69 20 63 6c ">info</b> <i cl
a600: 61 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 ass="arg">channe
a610: 6c 49 64 20 6d 61 6a 6f 72 20 6d 69 6e 6f 72 20 lId major minor
a620: 6d 65 73 73 61 67 65 20 74 79 70 65 3c 2f 69 3e message type</i>
a630: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 </dt>..<dd><p>Th
a640: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
a650: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
a660: 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 y the OpenSSL fu
a670: 6e 63 74 69 6f 6e 0d 0a 3c 62 20 63 6c 61 73 73 nction..<b class
a680: 3d 22 66 75 6e 63 74 69 6f 6e 22 3e 53 53 4c 5f ="function">SSL_
a690: 73 65 74 5f 69 6e 66 6f 5f 63 61 6c 6c 62 61 63 set_info_callbac
a6a0: 6b 28 29 3c 2f 62 3e 20 64 75 72 69 6e 67 20 74 k()</b> during t
a6b0: 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 6e 65 he initial conne
a6c0: 63 74 69 6f 6e 20 61 6e 64 20 68 61 6e 64 73 68 ction and handsh
a6d0: 61 6b 65 0d 0a 6f 70 65 72 61 74 69 6f 6e 73 2e ake..operations.
a6e0: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 The arguments a
a6f0: 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 re:</p>..<dl cla
a700: 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 66 ss="doctools_def
a710: 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e initions">..<dt>
a720: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 6d <i class="arg">m
a730: 61 6a 6f 72 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c ajor</i></dt>..<
a740: 64 64 3e 3c 70 3e 4d 61 6a 6f 72 20 63 61 74 65 dd><p>Major cate
a750: 67 6f 72 79 20 66 6f 72 20 65 72 72 6f 72 2e 20 gory for error.
a760: 56 61 6c 69 64 20 65 6e 75 6d 73 20 61 72 65 3a Valid enums are:
a770: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
a780: 22 3e 68 61 6e 64 73 68 61 6b 65 3c 2f 62 3e 2c ">handshake</b>,
a790: 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 <b class="const
a7a0: 22 3e 61 6c 65 72 74 3c 2f 62 3e 2c 0d 0a 3c 62 ">alert</b>,..<b
a7b0: 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 63 class="const">c
a7c0: 6f 6e 6e 65 63 74 3c 2f 62 3e 2c 20 3c 62 20 63 onnect</b>, <b c
a7d0: 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 61 63 63 lass="const">acc
a7e0: 65 70 74 3c 2f 62 3e 2e 3c 2f 70 3e 3c 2f 64 64 ept</b>.</p></dd
a7f0: 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 3d >..<dt><i class=
a800: 22 61 72 67 22 3e 6d 69 6e 6f 72 3c 2f 69 3e 3c "arg">minor</i><
a810: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 4d 69 6e /dt>..<dd><p>Min
a820: 6f 72 20 63 61 74 65 67 6f 72 79 20 66 6f 72 20 or category for
a830: 65 72 72 6f 72 2e 20 56 61 6c 69 64 20 65 6e 75 error. Valid enu
a840: 6d 73 20 61 72 65 3a 20 3c 62 20 63 6c 61 73 73 ms are: <b class
a850: 3d 22 63 6f 6e 73 74 22 3e 73 74 61 72 74 3c 2f ="const">start</
a860: 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f b>, <b class="co
a870: 6e 73 74 22 3e 64 6f 6e 65 3c 2f 62 3e 2c 20 3c nst">done</b>, <
a880: 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e b class="const">
a890: 72 65 61 64 3c 2f 62 3e 2c 0d 0a 3c 62 20 63 6c read</b>,..<b cl
a8a0: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 77 72 69 74 ass="const">writ
a8b0: 65 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d e</b>, <b class=
a8c0: 22 63 6f 6e 73 74 22 3e 6c 6f 6f 70 3c 2f 62 3e "const">loop</b>
a8d0: 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 6f 6e 73 , <b class="cons
a8e0: 74 22 3e 65 78 69 74 3c 2f 62 3e 2e 3c 2f 70 3e t">exit</b>.</p>
a8f0: 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c </dd>..<dt><i cl
a900: 61 73 73 3d 22 61 72 67 22 3e 6d 65 73 73 61 67 ass="arg">messag
a910: 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e e</i></dt>..<dd>
a920: 3c 70 3e 44 65 73 63 72 69 70 74 69 76 65 20 6d <p>Descriptive m
a930: 65 73 73 61 67 65 20 73 74 72 69 6e 67 20 77 68 essage string wh
a940: 69 63 68 20 6d 61 79 20 62 65 20 67 65 6e 65 72 ich may be gener
a950: 61 74 65 64 20 65 69 74 68 65 72 20 62 79 0d 0a ated either by..
a960: 3c 62 20 63 6c 61 73 73 3d 22 66 75 6e 63 74 69 <b class="functi
a970: 6f 6e 22 3e 53 53 4c 5f 73 74 61 74 65 5f 73 74 on">SSL_state_st
a980: 72 69 6e 67 5f 6c 6f 6e 67 28 29 3c 2f 62 3e 20 ring_long()</b>
a990: 6f 72 20 3c 62 20 63 6c 61 73 73 3d 22 66 75 6e or <b class="fun
a9a0: 63 74 69 6f 6e 22 3e 53 53 4c 5f 61 6c 65 72 74 ction">SSL_alert
a9b0: 5f 64 65 73 63 5f 73 74 72 69 6e 67 5f 6c 6f 6e _desc_string_lon
a9c0: 67 28 29 3c 2f 62 3e 2c 0d 0a 64 65 70 65 6e 64 g()</b>,..depend
a9d0: 69 6e 67 20 6f 6e 20 74 68 65 20 63 6f 6e 74 65 ing on the conte
a9e0: 78 74 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 xt.</p></dd>..<d
a9f0: 74 3e 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 t><i class="arg"
aa00: 3e 74 79 70 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >type</i></dt>..
aa10: 3c 64 64 3e 3c 70 3e 46 6f 72 20 61 6c 65 72 74 <dd><p>For alert
aa20: 73 2c 20 74 68 65 20 70 6f 73 73 69 62 6c 65 20 s, the possible
aa30: 76 61 6c 75 65 73 20 61 72 65 3a 20 3c 62 20 63 values are: <b c
aa40: 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 77 61 72 lass="const">war
aa50: 6e 69 6e 67 3c 2f 62 3e 2c 0d 0a 3c 62 20 63 6c ning</b>,..<b cl
aa60: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 66 61 74 61 ass="const">fata
aa70: 6c 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 20 63 6c l</b>, and <b cl
aa80: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 75 6e 6b 6e ass="const">unkn
aa90: 6f 77 6e 3c 2f 62 3e 2e 20 46 6f 72 20 6f 74 68 own</b>. For oth
aaa0: 65 72 73 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 ers, <b class="c
aab0: 6f 6e 73 74 22 3e 69 6e 66 6f 3c 2f 62 3e 20 69 onst">info</b> i
aac0: 73 20 75 73 65 64 2e 0d 0a 54 68 69 73 20 61 72 s used...This ar
aad0: 67 75 6d 65 6e 74 20 69 73 20 6e 65 77 20 66 6f gument is new fo
aae0: 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e 3c 2f 70 r TclTLS 1.8.</p
aaf0: 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 3c 2f 64 ></dd>..</dl></d
ab00: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
ab10: 3d 22 6f 70 74 69 6f 6e 22 3e 6d 65 73 73 61 67 ="option">messag
ab20: 65 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 e</b> <i class="
ab30: 61 72 67 22 3e 63 68 61 6e 6e 65 6c 49 64 20 64 arg">channelId d
ab40: 69 72 65 63 74 69 6f 6e 20 76 65 72 73 69 6f 6e irection version
ab50: 20 63 6f 6e 74 65 6e 74 5f 74 79 70 65 20 6d 65 content_type me
ab60: 73 73 61 67 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a ssage</i></dt>..
ab70: 3c 64 64 3e 3c 70 3e 54 68 69 73 20 66 6f 72 6d <dd><p>This form
ab80: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
ab90: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f invoked by the O
aba0: 70 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0d penSSL function.
abb0: 0a 3c 62 20 63 6c 61 73 73 3d 22 66 75 6e 63 74 .<b class="funct
abc0: 69 6f 6e 22 3e 53 53 4c 5f 73 65 74 5f 6d 73 67 ion">SSL_set_msg
abd0: 5f 63 61 6c 6c 62 61 63 6b 28 29 3c 2f 62 3e 20 _callback()</b>
abe0: 77 68 65 6e 65 76 65 72 20 61 20 6d 65 73 73 61 whenever a messa
abf0: 67 65 20 69 73 20 73 65 6e 74 20 6f 72 20 72 65 ge is sent or re
ac00: 63 65 69 76 65 64 20 64 75 72 69 6e 67 20 74 68 ceived during th
ac10: 65 0d 0a 69 6e 69 74 69 61 6c 20 63 6f 6e 6e 65 e..initial conne
ac20: 63 74 69 6f 6e 2c 20 68 61 6e 64 73 68 61 6b 65 ction, handshake
ac30: 2c 20 6f 72 20 49 2f 4f 20 6f 70 65 72 61 74 69 , or I/O operati
ac40: 6f 6e 73 2e 20 49 74 20 69 73 20 6f 6e 6c 79 20 ons. It is only
ac50: 61 76 61 69 6c 61 62 6c 65 20 77 68 65 6e 0d 0a available when..
ac60: 4f 70 65 6e 53 53 4c 20 69 73 20 63 6f 6d 70 6c OpenSSL is compl
ac70: 69 65 64 20 77 69 74 68 20 74 68 65 20 3c 62 20 ied with the <b
ac80: 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 65 6e class="const">en
ac90: 61 62 6c 65 2d 73 73 6c 2d 74 72 61 63 65 3c 2f able-ssl-trace</
aca0: 62 3e 20 6f 70 74 69 6f 6e 2e 20 54 68 69 73 20 b> option. This
acb0: 63 61 6c 6c 62 61 63 6b 20 69 73 0d 0a 6e 65 77 callback is..new
acc0: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 2e 38 2e for TclTLS 1.8.
acd0: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 The arguments a
ace0: 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 re:</p>..<dl cla
acf0: 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 66 ss="doctools_def
ad00: 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e initions">..<dt>
ad10: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 64 <i class="arg">d
ad20: 69 72 65 63 74 69 6f 6e 3c 2f 69 3e 3c 2f 64 74 irection</i></dt
ad30: 3e 0d 0a 3c 64 64 3e 3c 70 3e 44 69 72 65 63 74 >..<dd><p>Direct
ad40: 69 6f 6e 20 69 73 20 65 69 74 68 65 72 20 3c 62 ion is either <b
ad50: 20 63 6c 61 73 73 3d 22 63 6f 6e 73 74 22 3e 53 class="const">S
ad60: 65 6e 74 3c 2f 62 3e 20 6f 72 20 3c 62 20 63 6c ent</b> or <b cl
ad70: 61 73 73 3d 22 63 6f 6e 73 74 22 3e 52 65 63 65 ass="const">Rece
ad80: 69 76 65 64 3c 2f 62 3e 2e 3c 2f 70 3e 3c 2f 64 ived</b>.</p></d
ad90: 64 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 d>..<dt><i class
ada0: 3d 22 61 72 67 22 3e 76 65 72 73 69 6f 6e 3c 2f ="arg">version</
adb0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
adc0: 56 65 72 73 69 6f 6e 20 69 73 20 74 68 65 20 70 Version is the p
add0: 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 2e rotocol version.
ade0: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
adf0: 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 6f i class="arg">co
ae00: 6e 74 65 6e 74 5f 74 79 70 65 3c 2f 69 3e 3c 2f ntent_type</i></
ae10: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 6f 6e 74 dt>..<dd><p>Cont
ae20: 65 6e 74 20 74 79 70 65 20 69 73 20 74 68 65 20 ent type is the
ae30: 6d 65 73 73 61 67 65 20 63 6f 6e 74 65 6e 74 20 message content
ae40: 74 79 70 65 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a type.</p></dd>..
ae50: 3c 64 74 3e 3c 69 20 63 6c 61 73 73 3d 22 61 72 <dt><i class="ar
ae60: 67 22 3e 6d 65 73 73 61 67 65 3c 2f 69 3e 3c 2f g">message</i></
ae70: 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 4d 65 73 73 dt>..<dd><p>Mess
ae80: 61 67 65 20 69 73 20 6d 6f 72 65 20 69 6e 66 6f age is more info
ae90: 20 66 72 6f 6d 20 74 68 65 20 3c 62 20 63 6c 61 from the <b cla
aea0: 73 73 3d 22 63 6f 6e 73 74 22 3e 53 53 4c 5f 74 ss="const">SSL_t
aeb0: 72 61 63 65 3c 2f 62 3e 20 41 50 49 2e 3c 2f 70 race</b> API.</p
aec0: 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 3c 2f 64 ></dd>..</dl></d
aed0: 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 d>..<dt><b class
aee0: 3d 22 6f 70 74 69 6f 6e 22 3e 73 65 73 73 69 6f ="option">sessio
aef0: 6e 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 n</b> <i class="
af00: 61 72 67 22 3e 63 68 61 6e 6e 65 6c 49 64 20 73 arg">channelId s
af10: 65 73 73 69 6f 6e 5f 69 64 20 73 65 73 73 69 6f ession_id sessio
af20: 6e 5f 74 69 63 6b 65 74 20 6c 69 66 65 74 69 6d n_ticket lifetim
af30: 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e e</i></dt>..<dd>
af40: 3c 70 3e 54 68 69 73 20 66 6f 72 6d 20 6f 66 20 <p>This form of
af50: 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f callback is invo
af60: 6b 65 64 20 62 79 20 74 68 65 20 4f 70 65 6e 53 ked by the OpenS
af70: 53 4c 20 66 75 6e 63 74 69 6f 6e 0d 0a 3c 62 20 SL function..<b
af80: 63 6c 61 73 73 3d 22 66 75 6e 63 74 69 6f 6e 22 class="function"
af90: 3e 53 53 4c 5f 43 54 58 5f 73 65 73 73 5f 73 65 >SSL_CTX_sess_se
afa0: 74 5f 6e 65 77 5f 63 62 28 29 3c 2f 62 3e 20 77 t_new_cb()</b> w
afb0: 68 65 6e 65 76 65 72 20 61 20 6e 65 77 20 73 65 henever a new se
afc0: 73 73 69 6f 6e 20 69 64 20 69 73 20 73 65 6e 74 ssion id is sent
afd0: 20 62 79 20 74 68 65 0d 0a 73 65 72 76 65 72 20 by the..server
afe0: 64 75 72 69 6e 67 20 74 68 65 20 69 6e 69 74 69 during the initi
aff0: 61 6c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 6e al connection an
b000: 64 20 68 61 6e 64 73 68 61 6b 65 20 61 6e 64 20 d handshake and
b010: 61 6c 73 6f 20 64 75 72 69 6e 67 20 74 68 65 20 also during the
b020: 73 65 73 73 69 6f 6e 0d 0a 69 66 20 74 68 65 20 session..if the
b030: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
b040: 22 3e 2d 70 6f 73 74 5f 68 61 6e 64 73 68 61 6b ">-post_handshak
b050: 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 69 73 20 e</b> option is
b060: 73 65 74 20 74 6f 20 74 72 75 65 2e 20 54 68 69 set to true. Thi
b070: 73 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 6e 65 s callback is ne
b080: 77 20 66 6f 72 0d 0a 54 63 6c 54 4c 53 20 31 2e w for..TclTLS 1.
b090: 38 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 8. The arguments
b0a0: 20 61 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 are:</p>..<dl c
b0b0: 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 lass="doctools_d
b0c0: 65 66 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 efinitions">..<d
b0d0: 74 3e 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 t><i class="arg"
b0e0: 3e 73 65 73 73 69 6f 6e 5f 69 64 3c 2f 69 3e 3c >session_id</i><
b0f0: 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 53 65 73 /dt>..<dd><p>Ses
b100: 73 69 6f 6e 20 49 64 20 69 73 20 74 68 65 20 63 sion Id is the c
b110: 75 72 72 65 6e 74 20 73 65 73 73 69 6f 6e 20 69 urrent session i
b120: 64 65 6e 74 69 66 69 65 72 3c 2f 70 3e 3c 2f 64 dentifier</p></d
b130: 64 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 d>..<dt><i class
b140: 3d 22 61 72 67 22 3e 73 65 73 73 69 6f 6e 5f 74 ="arg">session_t
b150: 69 63 6b 65 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a icket</i></dt>..
b160: 3c 64 64 3e 3c 70 3e 54 69 63 6b 65 74 20 69 73 <dd><p>Ticket is
b170: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 74 69 63 the session tic
b180: 6b 65 74 20 69 6e 66 6f 3c 2f 70 3e 3c 2f 64 64 ket info</p></dd
b190: 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 3d >..<dt><i class=
b1a0: 22 61 72 67 22 3e 6c 69 66 65 74 69 6d 65 3c 2f "arg">lifetime</
b1b0: 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e i></dt>..<dd><p>
b1c0: 4c 69 66 65 74 69 6d 65 20 69 73 20 74 68 65 20 Lifetime is the
b1d0: 74 69 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 20 ticket lifetime
b1e0: 69 6e 20 73 65 63 6f 6e 64 73 2e 3c 2f 70 3e 3c in seconds.</p><
b1f0: 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 3c 2f 64 64 3e /dd>..</dl></dd>
b200: 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d 22 ..<dt><b class="
b210: 6f 70 74 69 6f 6e 22 3e 76 65 72 69 66 79 3c 2f option">verify</
b220: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
b230: 22 3e 63 68 61 6e 6e 65 6c 49 64 20 64 65 70 74 ">channelId dept
b240: 68 20 63 65 72 74 20 73 74 61 74 75 73 20 65 72 h cert status er
b250: 72 6f 72 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ror</i></dt>..<d
b260: 64 3e 3c 70 3e 54 68 69 73 20 63 61 6c 6c 62 61 d><p>This callba
b270: 63 6b 20 77 61 73 20 6d 6f 76 65 64 20 74 6f 20 ck was moved to
b280: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
b290: 22 3e 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 ">-validatecomma
b2a0: 6e 64 3c 2f 62 3e 20 69 6e 20 54 63 6c 54 4c 53 nd</b> in TclTLS
b2b0: 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 1.8.</p></dd>..
b2c0: 3c 2f 64 6c 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c </dl>..</div>..<
b2d0: 64 69 76 20 69 64 3d 22 73 75 62 73 65 63 74 69 div id="subsecti
b2e0: 6f 6e 35 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 on5" class="doct
b2f0: 6f 6f 6c 73 5f 73 75 62 73 65 63 74 69 6f 6e 22 ools_subsection"
b300: 3e 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 73 75 ><h3><a name="su
b310: 62 73 65 63 74 69 6f 6e 35 22 3e 56 61 6c 75 65 bsection5">Value
b320: 73 20 66 6f 72 20 50 61 73 73 77 6f 72 64 20 43 s for Password C
b330: 61 6c 6c 62 61 63 6b 3c 2f 61 3e 3c 2f 68 33 3e allback</a></h3>
b340: 0d 0a 3c 70 3e 54 68 65 20 63 61 6c 6c 62 61 63 ..<p>The callbac
b350: 6b 20 66 6f 72 20 74 68 65 20 3c 62 20 63 6c 61 k for the <b cla
b360: 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 70 61 73 ss="option">-pas
b370: 73 77 6f 72 64 3c 2f 62 3e 20 6f 70 74 69 6f 6e sword</b> option
b380: 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 54 is invoked by T
b390: 63 6c 54 4c 53 20 77 68 65 6e 65 76 65 72 20 4f clTLS whenever O
b3a0: 70 65 6e 53 53 4c 20 6e 65 65 64 73 0d 0a 74 6f penSSL needs..to
b3b0: 20 6f 62 74 61 69 6e 20 61 20 70 61 73 73 77 6f obtain a passwo
b3c0: 72 64 2e 20 53 65 65 20 62 65 6c 6f 77 20 66 6f rd. See below fo
b3d0: 72 20 74 68 65 20 70 6f 73 73 69 62 6c 65 20 61 r the possible a
b3e0: 72 67 75 6d 65 6e 74 73 20 70 61 73 73 65 64 20 rguments passed
b3f0: 74 6f 20 74 68 65 0d 0a 63 61 6c 6c 62 61 63 6b to the..callback
b400: 20 73 63 72 69 70 74 2e 20 54 68 65 20 75 73 65 script. The use
b410: 72 20 70 72 6f 76 69 64 65 64 20 70 61 73 73 77 r provided passw
b420: 6f 72 64 20 69 73 20 65 78 70 65 63 74 65 64 20 ord is expected
b430: 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 to be returned b
b440: 79 20 74 68 65 0d 0a 63 61 6c 6c 62 61 63 6b 2e y the..callback.
b450: 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 73 73 3d </p>..<dl class=
b460: 22 64 6f 63 74 6f 6f 6c 73 5f 6f 70 74 69 6f 6e "doctools_option
b470: 73 22 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 s">..<dt><b clas
b480: 73 3d 22 6f 70 74 69 6f 6e 22 3e 70 61 73 73 77 s="option">passw
b490: 6f 72 64 3c 2f 62 3e 20 3c 69 20 63 6c 61 73 73 ord</b> <i class
b4a0: 3d 22 61 72 67 22 3e 72 77 66 6c 61 67 20 73 69 ="arg">rwflag si
b4b0: 7a 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 ze</i></dt>..<dd
b4c0: 3e 3c 70 3e 49 6e 76 6f 6b 65 64 20 77 68 65 6e ><p>Invoked when
b4d0: 20 6c 6f 61 64 69 6e 67 20 6f 72 20 73 74 6f 72 loading or stor
b4e0: 69 6e 67 20 61 6e 20 65 6e 63 72 79 70 74 65 64 ing an encrypted
b4f0: 20 50 45 4d 20 63 65 72 74 69 66 69 63 61 74 65 PEM certificate
b500: 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 . The arguments
b510: 61 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c are:</p>..<dl cl
b520: 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 ass="doctools_de
b530: 66 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 finitions">..<dt
b540: 3e 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e ><i class="arg">
b550: 72 77 66 6c 61 67 3c 2f 69 3e 3c 2f 64 74 3e 0d rwflag</i></dt>.
b560: 0a 3c 64 64 3e 3c 70 3e 54 68 65 20 72 65 61 64 .<dd><p>The read
b570: 2f 77 72 69 74 65 20 66 6c 61 67 20 69 73 20 30 /write flag is 0
b580: 20 66 6f 72 20 72 65 61 64 69 6e 67 2f 64 65 63 for reading/dec
b590: 72 79 70 74 69 6f 6e 20 6f 72 20 31 20 66 6f 72 ryption or 1 for
b5a0: 20 77 72 69 74 69 6e 67 2f 65 6e 63 72 79 70 74 writing/encrypt
b5b0: 69 6f 6e 2e 0d 0a 54 68 65 20 6c 61 74 74 65 72 ion...The latter
b5c0: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 can be used to
b5d0: 64 65 74 65 72 6d 69 6e 65 20 77 68 65 6e 20 74 determine when t
b5e0: 6f 20 70 72 6f 6d 70 74 20 74 68 65 20 75 73 65 o prompt the use
b5f0: 72 20 74 6f 20 63 6f 6e 66 69 72 6d 2e 0d 0a 54 r to confirm...T
b600: 68 69 73 20 61 72 67 75 6d 65 6e 74 20 69 73 20 his argument is
b610: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
b620: 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 .8.</p></dd>..<d
b630: 74 3e 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 t><i class="arg"
b640: 3e 73 69 7a 65 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a >size</i></dt>..
b650: 3c 64 64 3e 3c 70 3e 54 68 65 20 73 69 7a 65 20 <dd><p>The size
b660: 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6c is the maximum l
b670: 65 6e 67 74 68 20 6f 66 20 74 68 65 20 70 61 73 ength of the pas
b680: 73 77 6f 72 64 20 69 6e 20 62 79 74 65 73 2e 0d sword in bytes..
b690: 0a 54 68 69 73 20 61 72 67 75 6d 65 6e 74 20 69 .This argument i
b6a0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
b6b0: 20 31 2e 38 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 1.8.</p></dd>..
b6c0: 3c 2f 64 6c 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c </dl></dd>..</dl
b6d0: 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 >..</div>..<div
b6e0: 69 64 3d 22 73 75 62 73 65 63 74 69 6f 6e 36 22 id="subsection6"
b6f0: 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 class="doctools
b700: 5f 73 75 62 73 65 63 74 69 6f 6e 22 3e 3c 68 33 _subsection"><h3
b710: 3e 3c 61 20 6e 61 6d 65 3d 22 73 75 62 73 65 63 ><a name="subsec
b720: 74 69 6f 6e 36 22 3e 56 61 6c 75 65 73 20 66 6f tion6">Values fo
b730: 72 20 56 61 6c 69 64 61 74 65 20 43 6f 6d 6d 61 r Validate Comma
b740: 6e 64 20 43 61 6c 6c 62 61 63 6b 3c 2f 61 3e 3c nd Callback</a><
b750: 2f 68 33 3e 0d 0a 3c 70 3e 54 68 65 20 63 61 6c /h3>..<p>The cal
b760: 6c 62 61 63 6b 20 66 6f 72 20 74 68 65 20 3c 62 lback for the <b
b770: 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e class="option">
b780: 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 6e 64 -validatecommand
b790: 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 69 73 20 69 </b> option is i
b7a0: 6e 76 6f 6b 65 64 20 64 75 72 69 6e 67 20 74 68 nvoked during th
b7b0: 65 20 68 61 6e 64 73 68 61 6b 65 0d 0a 70 72 6f e handshake..pro
b7c0: 63 65 73 73 20 69 6e 20 6f 72 64 65 72 20 66 6f cess in order fo
b7d0: 72 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f r the applicatio
b7e0: 6e 20 74 6f 20 76 61 6c 69 64 61 74 65 20 74 68 n to validate th
b7f0: 65 20 70 72 6f 76 69 64 65 64 20 76 61 6c 75 65 e provided value
b800: 28 73 29 2e 20 53 65 65 0d 0a 62 65 6c 6f 77 20 (s). See..below
b810: 66 6f 72 20 74 68 65 20 70 6f 73 73 69 62 6c 65 for the possible
b820: 20 61 72 67 75 6d 65 6e 74 73 20 70 61 73 73 65 arguments passe
b830: 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 62 61 63 d to the callbac
b840: 6b 20 73 63 72 69 70 74 2e 20 49 66 20 6e 6f 74 k script. If not
b850: 0d 0a 73 70 65 63 69 66 69 65 64 2c 20 4f 70 65 ..specified, Ope
b860: 6e 53 53 4c 20 77 69 6c 6c 20 61 63 63 65 70 74 nSSL will accept
b870: 20 61 6c 6c 20 76 61 6c 69 64 20 63 65 72 74 69 all valid certi
b880: 66 69 63 61 74 65 73 20 61 6e 64 20 65 78 74 65 ficates and exte
b890: 6e 73 69 6f 6e 73 2e 20 54 6f 20 72 65 6a 65 63 nsions. To rejec
b8a0: 74 0d 0a 74 68 65 20 76 61 6c 75 65 20 61 6e 64 t..the value and
b8b0: 20 61 62 6f 72 74 20 74 68 65 20 63 6f 6e 6e 65 abort the conne
b8c0: 63 74 69 6f 6e 2c 20 74 68 65 20 63 61 6c 6c 62 ction, the callb
b8d0: 61 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 ack should retur
b8e0: 6e 20 30 2e 20 54 6f 20 61 63 63 65 70 74 20 74 n 0. To accept t
b8f0: 68 65 0d 0a 76 61 6c 75 65 20 61 6e 64 20 63 6f he..value and co
b900: 6e 74 69 6e 75 65 20 74 68 65 20 63 6f 6e 6e 65 ntinue the conne
b910: 63 74 69 6f 6e 2c 20 69 74 20 73 68 6f 75 6c 64 ction, it should
b920: 20 72 65 74 75 72 6e 20 31 2e 20 54 6f 20 72 65 return 1. To re
b930: 6a 65 63 74 20 74 68 65 20 76 61 6c 75 65 2c 20 ject the value,
b940: 62 75 74 0d 0a 63 6f 6e 74 69 6e 75 65 20 74 68 but..continue th
b950: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 74 e connection, it
b960: 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 32 should return 2
b970: 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 . This callback
b980: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
b990: 53 20 31 2e 38 2e 3c 2f 70 3e 0d 0a 3c 64 6c 20 S 1.8.</p>..<dl
b9a0: 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f class="doctools_
b9b0: 6f 70 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e 3c options">..<dt><
b9c0: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
b9d0: 3e 61 6c 70 6e 3c 2f 62 3e 20 3c 69 20 63 6c 61 >alpn</b> <i cla
b9e0: 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e 65 6c ss="arg">channel
b9f0: 49 64 20 70 72 6f 74 6f 63 6f 6c 20 6d 61 74 63 Id protocol matc
ba00: 68 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e h</i></dt>..<dd>
ba10: 3c 70 3e 46 6f 72 20 73 65 72 76 65 72 73 2c 20 <p>For servers,
ba20: 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c this form of cal
ba30: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
ba40: 20 77 68 65 6e 20 74 68 65 20 63 6c 69 65 6e 74 when the client
ba50: 20 41 4c 50 4e 20 65 78 74 65 6e 73 69 6f 6e 20 ALPN extension
ba60: 69 73 0d 0a 72 65 63 65 69 76 65 64 2e 20 49 66 is..received. If
ba70: 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e <i class="arg">
ba80: 6d 61 74 63 68 3c 2f 69 3e 20 69 73 20 74 72 75 match</i> is tru
ba90: 65 2c 20 74 68 65 6e 20 3c 69 20 63 6c 61 73 73 e, then <i class
baa0: 3d 22 61 72 67 22 3e 70 72 6f 74 6f 63 6f 6c 3c ="arg">protocol<
bab0: 2f 69 3e 20 69 73 20 74 68 65 20 66 69 72 73 74 /i> is the first
bac0: 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 ..<b class="opti
bad0: 6f 6e 22 3e 2d 61 6c 70 6e 3c 2f 62 3e 20 70 72 on">-alpn</b> pr
bae0: 6f 74 6f 63 6f 6c 20 6f 70 74 69 6f 6e 20 69 6e otocol option in
baf0: 20 63 6f 6d 6d 6f 6e 20 74 6f 20 62 6f 74 68 20 common to both
bb00: 74 68 65 20 63 6c 69 65 6e 74 20 61 6e 64 20 73 the client and s
bb10: 65 72 76 65 72 2e 0d 0a 49 66 20 6e 6f 74 2c 20 erver...If not,
bb20: 74 68 65 20 66 69 72 73 74 20 63 6c 69 65 6e 74 the first client
bb30: 20 73 70 65 63 69 66 69 65 64 20 70 72 6f 74 6f specified proto
bb40: 63 6f 6c 20 69 73 20 75 73 65 64 2e 20 54 68 69 col is used. Thi
bb50: 73 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 63 61 s callback is ca
bb60: 6c 6c 65 64 0d 0a 61 66 74 65 72 20 74 68 65 20 lled..after the
bb70: 48 65 6c 6c 6f 20 61 6e 64 20 53 4e 49 20 63 61 Hello and SNI ca
bb80: 6c 6c 62 61 63 6b 73 2e 3c 2f 70 3e 3c 2f 64 64 llbacks.</p></dd
bb90: 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 73 3d >..<dt><b class=
bba0: 22 6f 70 74 69 6f 6e 22 3e 68 65 6c 6c 6f 3c 2f "option">hello</
bbb0: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
bbc0: 22 3e 63 68 61 6e 6e 65 6c 49 64 20 73 65 72 76 ">channelId serv
bbd0: 65 72 6e 61 6d 65 20 73 65 73 73 69 6f 6e 5f 69 ername session_i
bbe0: 64 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e d</i></dt>..<dd>
bbf0: 3c 70 3e 46 6f 72 20 73 65 72 76 65 72 73 2c 20 <p>For servers,
bc00: 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c this form of cal
bc10: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
bc20: 20 64 75 72 69 6e 67 20 63 6c 69 65 6e 74 20 68 during client h
bc30: 65 6c 6c 6f 20 6d 65 73 73 61 67 65 0d 0a 70 72 ello message..pr
bc40: 6f 63 65 73 73 69 6e 67 2e 20 54 68 65 20 70 75 ocessing. The pu
bc50: 72 70 6f 73 65 20 69 73 20 73 6f 20 74 68 65 20 rpose is so the
bc60: 73 65 72 76 65 72 20 63 61 6e 20 73 65 6c 65 63 server can selec
bc70: 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 t the appropriat
bc80: 65 20 63 65 72 74 69 66 69 63 61 74 65 0d 0a 74 e certificate..t
bc90: 6f 20 70 72 65 73 65 6e 74 20 74 6f 20 74 68 65 o present to the
bca0: 20 63 6c 69 65 6e 74 2c 20 61 6e 64 20 74 6f 20 client, and to
bcb0: 6d 61 6b 65 20 6f 74 68 65 72 20 63 6f 6e 66 69 make other confi
bcc0: 67 75 72 61 74 69 6f 6e 20 61 64 6a 75 73 74 6d guration adjustm
bcd0: 65 6e 74 73 20 72 65 6c 65 76 61 6e 74 0d 0a 74 ents relevant..t
bce0: 6f 20 74 68 61 74 20 73 65 72 76 65 72 20 6e 61 o that server na
bcf0: 6d 65 20 61 6e 64 20 69 74 73 20 63 6f 6e 66 69 me and its confi
bd00: 67 75 72 61 74 69 6f 6e 2e 20 49 74 20 69 73 20 guration. It is
bd10: 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 74 68 called before th
bd20: 65 20 53 4e 49 20 61 6e 64 20 41 4c 50 4e 0d 0a e SNI and ALPN..
bd30: 63 61 6c 6c 62 61 63 6b 73 2e 3c 2f 70 3e 3c 2f callbacks.</p></
bd40: 64 64 3e 0d 0a 3c 64 74 3e 3c 62 20 63 6c 61 73 dd>..<dt><b clas
bd50: 73 3d 22 6f 70 74 69 6f 6e 22 3e 73 6e 69 3c 2f s="option">sni</
bd60: 62 3e 20 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 b> <i class="arg
bd70: 22 3e 63 68 61 6e 6e 65 6c 49 64 20 73 65 72 76 ">channelId serv
bd80: 65 72 6e 61 6d 65 3c 2f 69 3e 3c 2f 64 74 3e 0d ername</i></dt>.
bd90: 0a 3c 64 64 3e 3c 70 3e 46 6f 72 20 73 65 72 76 .<dd><p>For serv
bda0: 65 72 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f ers, this form o
bdb0: 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e f callback is in
bdc0: 76 6f 6b 65 64 20 77 68 65 6e 20 74 68 65 20 53 voked when the S
bdd0: 65 72 76 65 72 20 4e 61 6d 65 20 49 6e 64 69 63 erver Name Indic
bde0: 61 74 69 6f 6e 0d 0a 28 53 4e 49 29 20 65 78 74 ation..(SNI) ext
bdf0: 65 6e 73 69 6f 6e 20 69 73 20 72 65 63 65 69 76 ension is receiv
be00: 65 64 2e 20 54 68 65 20 3c 69 20 63 6c 61 73 73 ed. The <i class
be10: 3d 22 61 72 67 22 3e 73 65 72 76 65 72 6e 61 6d ="arg">servernam
be20: 65 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 20 69 e</i> argument i
be30: 73 20 74 68 65 20 63 6c 69 65 6e 74 0d 0a 70 72 s the client..pr
be40: 6f 76 69 64 65 64 20 73 65 72 76 65 72 20 6e 61 ovided server na
be50: 6d 65 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 me specified in
be60: 74 68 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 the <b class="op
be70: 74 69 6f 6e 22 3e 2d 73 65 72 76 65 72 6e 61 6d tion">-servernam
be80: 65 3c 2f 62 3e 20 6f 70 74 69 6f 6e 2e 20 54 68 e</b> option. Th
be90: 65 0d 0a 70 75 72 70 6f 73 65 20 69 73 20 73 6f e..purpose is so
bea0: 20 77 68 65 6e 20 61 20 73 65 72 76 65 72 20 73 when a server s
beb0: 75 70 70 6f 72 74 73 20 6d 75 6c 74 69 70 6c 65 upports multiple
bec0: 20 6e 61 6d 65 73 2c 20 74 68 65 20 72 69 67 68 names, the righ
bed0: 74 20 63 65 72 74 69 66 69 63 61 74 65 0d 0a 63 t certificate..c
bee0: 61 6e 20 62 65 20 75 73 65 64 2e 20 49 74 20 69 an be used. It i
bef0: 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 20 74 s called after t
bf00: 68 65 20 48 65 6c 6c 6f 20 63 61 6c 6c 62 61 63 he Hello callbac
bf10: 6b 20 62 75 74 20 62 65 66 6f 72 65 20 74 68 65 k but before the
bf20: 20 41 4c 50 4e 0d 0a 63 61 6c 6c 62 61 63 6b 2e ALPN..callback.
bf30: 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c </p></dd>..<dt><
bf40: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
bf50: 3e 76 65 72 69 66 79 3c 2f 62 3e 20 3c 69 20 63 >verify</b> <i c
bf60: 6c 61 73 73 3d 22 61 72 67 22 3e 63 68 61 6e 6e lass="arg">chann
bf70: 65 6c 49 64 20 64 65 70 74 68 20 63 65 72 74 20 elId depth cert
bf80: 73 74 61 74 75 73 20 65 72 72 6f 72 3c 2f 69 3e status error</i>
bf90: 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 54 68 </dt>..<dd><p>Th
bfa0: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
bfb0: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
bfc0: 79 20 4f 70 65 6e 53 53 4c 20 77 68 65 6e 20 61 y OpenSSL when a
bfd0: 20 6e 65 77 20 63 65 72 74 69 66 69 63 61 74 65 new certificate
bfe0: 20 69 73 20 72 65 63 65 69 76 65 64 0d 0a 66 72 is received..fr
bff0: 6f 6d 20 74 68 65 20 70 65 65 72 2e 20 49 74 20 om the peer. It
c000: 61 6c 6c 6f 77 73 20 74 68 65 20 63 6c 69 65 6e allows the clien
c010: 74 20 74 6f 20 63 68 65 63 6b 20 74 68 65 20 63 t to check the c
c020: 65 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 ertificate verif
c030: 69 63 61 74 69 6f 6e 0d 0a 72 65 73 75 6c 74 73 ication..results
c040: 20 61 6e 64 20 63 68 6f 6f 73 65 20 77 68 65 74 and choose whet
c050: 68 65 72 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 her to continue
c060: 6f 72 20 6e 6f 74 2e 20 49 74 20 69 73 20 63 61 or not. It is ca
c070: 6c 6c 65 64 20 66 6f 72 20 65 61 63 68 0d 0a 63 lled for each..c
c080: 65 72 74 69 66 69 63 61 74 65 20 69 6e 20 74 68 ertificate in th
c090: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 63 68 e certificate ch
c0a0: 61 69 6e 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 ain. This callba
c0b0: 63 6b 20 77 61 73 20 6d 6f 76 65 64 20 66 72 6f ck was moved fro
c0c0: 6d 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 m..<b class="opt
c0d0: 69 6f 6e 22 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 ion">-command</b
c0e0: 3e 20 69 6e 20 54 63 6c 54 4c 53 20 31 2e 38 2e > in TclTLS 1.8.
c0f0: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 The arguments a
c100: 72 65 3a 3c 2f 70 3e 0d 0a 3c 64 6c 20 63 6c 61 re:</p>..<dl cla
c110: 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 64 65 66 ss="doctools_def
c120: 69 6e 69 74 69 6f 6e 73 22 3e 0d 0a 3c 64 74 3e initions">..<dt>
c130: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 64 <i class="arg">d
c140: 65 70 74 68 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c epth</i></dt>..<
c150: 64 64 3e 3c 70 3e 54 68 65 20 64 65 70 74 68 20 dd><p>The depth
c160: 69 73 20 74 68 65 20 69 6e 74 65 67 65 72 20 64 is the integer d
c170: 65 70 74 68 20 6f 66 20 74 68 65 20 63 65 72 74 epth of the cert
c180: 69 66 69 63 61 74 65 20 69 6e 20 74 68 65 20 63 ificate in the c
c190: 65 72 74 69 66 69 63 61 74 65 20 63 68 61 69 6e ertificate chain
c1a0: 2c 0d 0a 77 68 65 72 65 20 30 20 69 73 20 74 68 ,..where 0 is th
c1b0: 65 20 70 65 65 72 20 63 65 72 74 69 66 69 63 61 e peer certifica
c1c0: 74 65 20 61 6e 64 20 68 69 67 68 65 72 20 76 61 te and higher va
c1d0: 6c 75 65 73 20 67 6f 69 6e 67 20 75 70 20 74 6f lues going up to
c1e0: 20 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 the Certificate
c1f0: 0d 0a 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 ..Authority (CA)
c200: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
c210: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 63 <i class="arg">c
c220: 65 72 74 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c 64 ert</i></dt>..<d
c230: 64 3e 3c 70 3e 54 68 65 20 63 65 72 74 20 61 72 d><p>The cert ar
c240: 67 75 6d 65 6e 74 20 69 73 20 61 20 6c 69 73 74 gument is a list
c250: 20 6f 66 20 6b 65 79 2d 76 61 6c 75 65 20 70 61 of key-value pa
c260: 69 72 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 74 irs similar to t
c270: 68 6f 73 65 20 72 65 74 75 72 6e 65 64 20 62 79 hose returned by
c280: 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 ..<b class="cmd"
c290: 3e 74 6c 73 3a 3a 73 74 61 74 75 73 3c 2f 62 3e >tls::status</b>
c2a0: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
c2b0: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 73 <i class="arg">s
c2c0: 74 61 74 75 73 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a tatus</i></dt>..
c2d0: 3c 64 64 3e 3c 70 3e 54 68 65 20 73 74 61 74 75 <dd><p>The statu
c2e0: 73 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 s argument is th
c2f0: 65 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 69 64 69 e boolean validi
c300: 74 79 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e ty of the curren
c310: 74 20 63 65 72 74 69 66 69 63 61 74 65 20 77 68 t certificate wh
c320: 65 72 65 20 30 0d 0a 69 73 20 69 6e 76 61 6c 69 ere 0..is invali
c330: 64 20 61 6e 64 20 31 20 69 73 20 76 61 6c 69 64 d and 1 is valid
c340: 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e .</p></dd>..<dt>
c350: 3c 69 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 65 <i class="arg">e
c360: 72 72 6f 72 3c 2f 69 3e 3c 2f 64 74 3e 0d 0a 3c rror</i></dt>..<
c370: 64 64 3e 3c 70 3e 54 68 65 20 65 72 72 6f 72 20 dd><p>The error
c380: 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 argument is the
c390: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 69 error message, i
c3a0: 66 20 61 6e 79 2c 20 67 65 6e 65 72 61 74 65 64 f any, generated
c3b0: 20 62 79 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 66 by..<b class="f
c3c0: 75 6e 63 74 69 6f 6e 22 3e 58 35 30 39 5f 53 54 unction">X509_ST
c3d0: 4f 52 45 5f 43 54 58 5f 67 65 74 5f 65 72 72 6f ORE_CTX_get_erro
c3e0: 72 28 29 3c 2f 62 3e 2e 3c 2f 70 3e 3c 2f 64 64 r()</b>.</p></dd
c3f0: 3e 0d 0a 3c 2f 64 6c 3e 3c 2f 64 64 3e 0d 0a 3c >..</dl></dd>..<
c400: 2f 64 6c 3e 0d 0a 3c 70 3e 52 65 66 65 72 65 6e /dl>..<p>Referen
c410: 63 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ce implementatio
c420: 6e 73 20 6f 66 20 74 68 65 73 65 20 63 61 6c 6c ns of these call
c430: 62 61 63 6b 73 20 61 72 65 20 70 72 6f 76 69 64 backs are provid
c440: 65 64 20 69 6e 20 26 71 75 6f 74 3b 3c 62 20 63 ed in "<b c
c450: 6c 61 73 73 3d 22 66 69 6c 65 22 3e 74 6c 73 2e lass="file">tls.
c460: 74 63 6c 3c 2f 62 3e 26 71 75 6f 74 3b 0d 0a 61 tcl</b>"..a
c470: 73 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 s <b class="cmd"
c480: 3e 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 3c 2f >tls::callback</
c490: 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d b>, <b class="cm
c4a0: 64 22 3e 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 d">tls::password
c4b0: 3c 2f 62 3e 2c 20 61 6e 64 20 3c 62 20 63 6c 61 </b>, and <b cla
c4c0: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 76 61 ss="cmd">tls::va
c4d0: 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 3c 2f lidate_command</
c4e0: 62 3e 0d 0a 72 65 73 70 65 63 74 69 76 65 6c 79 b>..respectively
c4f0: 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 73 . Note that thes
c500: 65 20 61 72 65 20 6f 6e 6c 79 20 3c 65 6d 3e 73 e are only <em>s
c510: 61 6d 70 6c 65 3c 2f 65 6d 3e 20 69 6d 70 6c 65 ample</em> imple
c520: 6d 65 6e 74 61 74 69 6f 6e 73 2e 20 49 6e 20 61 mentations. In a
c530: 20 6d 6f 72 65 0d 0a 72 65 61 6c 69 73 74 69 63 more..realistic
c540: 20 64 65 70 6c 6f 79 6d 65 6e 74 20 79 6f 75 20 deployment you
c550: 77 6f 75 6c 64 20 73 70 65 63 69 66 79 20 79 6f would specify yo
c560: 75 72 20 6f 77 6e 20 63 61 6c 6c 62 61 63 6b 20 ur own callback
c570: 73 63 72 69 70 74 73 20 6f 6e 20 65 61 63 68 20 scripts on each
c580: 54 4c 53 0d 0a 63 68 61 6e 6e 65 6c 20 75 73 69 TLS..channel usi
c590: 6e 67 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d ng the <b class=
c5a0: 22 6f 70 74 69 6f 6e 22 3e 2d 63 6f 6d 6d 61 6e "option">-comman
c5b0: 64 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d d</b>, <b class=
c5c0: 22 6f 70 74 69 6f 6e 22 3e 2d 70 61 73 73 77 6f "option">-passwo
c5d0: 72 64 3c 2f 62 3e 2c 20 61 6e 64 0d 0a 3c 62 20 rd</b>, and..<b
c5e0: 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d class="option">-
c5f0: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
c600: 3c 2f 62 3e 20 6f 70 74 69 6f 6e 73 2e 3c 2f 70 </b> options.</p
c610: 3e 0d 0a 3c 70 3e 54 68 65 20 64 65 66 61 75 6c >..<p>The defaul
c620: 74 20 62 65 68 61 76 69 6f 72 20 77 68 65 6e 20 t behavior when
c630: 74 68 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 the <b class="op
c640: 74 69 6f 6e 22 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f tion">-command</
c650: 62 3e 20 61 6e 64 20 3c 62 20 63 6c 61 73 73 3d b> and <b class=
c660: 22 6f 70 74 69 6f 6e 22 3e 2d 76 61 6c 69 64 61 "option">-valida
c670: 74 65 5f 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 0d 0a te_command</b>..
c680: 6f 70 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 options are not
c690: 73 70 65 63 69 66 69 65 64 2c 20 69 73 20 66 6f specified, is fo
c6a0: 72 20 54 63 6c 54 4c 53 20 74 6f 20 70 72 6f 63 r TclTLS to proc
c6b0: 65 73 73 20 74 68 65 20 61 73 73 6f 63 69 61 74 ess the associat
c6c0: 65 64 20 6c 69 62 72 61 72 79 0d 0a 63 61 6c 6c ed library..call
c6d0: 62 61 63 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79 backs internally
c6e0: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 62 65 . The default be
c6f0: 68 61 76 69 6f 72 20 77 68 65 6e 20 74 68 65 20 havior when the
c700: 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e <b class="option
c710: 22 3e 2d 70 61 73 73 77 6f 72 64 3c 2f 62 3e 20 ">-password</b>
c720: 6f 70 74 69 6f 6e 0d 0a 69 73 20 6e 6f 74 20 73 option..is not s
c730: 70 65 63 69 66 69 65 64 20 69 73 20 66 6f 72 20 pecified is for
c740: 54 63 6c 54 4c 53 20 74 6f 20 70 72 6f 63 65 73 TclTLS to proces
c750: 73 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 s the associated
c760: 20 6c 69 62 72 61 72 79 20 63 61 6c 6c 62 61 63 library callbac
c770: 6b 73 20 62 79 0d 0a 61 74 74 65 6d 70 74 69 6e ks by..attemptin
c780: 67 20 74 6f 20 63 61 6c 6c 20 3c 62 20 63 6c 61 g to call <b cla
c790: 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 70 61 ss="cmd">tls::pa
c7a0: 73 73 77 6f 72 64 3c 2f 62 3e 2e 20 54 68 65 20 ssword</b>. The
c7b0: 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 difference betwe
c7c0: 65 6e 20 74 68 65 73 65 20 74 77 6f 0d 0a 62 65 en these two..be
c7d0: 68 61 76 69 6f 72 73 20 69 73 20 61 20 63 6f 6e haviors is a con
c7e0: 73 65 71 75 65 6e 63 65 20 6f 66 20 6d 61 69 6e sequence of main
c7f0: 74 61 69 6e 69 6e 67 20 63 6f 6d 70 61 74 69 62 taining compatib
c800: 69 6c 69 74 79 20 77 69 74 68 20 65 61 72 6c 69 ility with earli
c810: 65 72 0d 0a 69 6d 70 6c 65 6d 65 6e 74 61 74 69 er..implementati
c820: 6f 6e 73 2e 3c 2f 70 3e 0d 0a 3c 70 3e 3c 65 6d ons.</p>..<p><em
c830: 3e 54 68 65 20 75 73 65 20 6f 66 20 74 68 65 20 >The use of the
c840: 72 65 66 65 72 65 6e 63 65 20 63 61 6c 6c 62 61 reference callba
c850: 63 6b 73 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d cks <b class="cm
c860: 64 22 3e 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b d">tls::callback
c870: 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 73 3d 22 </b>, <b class="
c880: 63 6d 64 22 3e 74 6c 73 3a 3a 70 61 73 73 77 6f cmd">tls::passwo
c890: 72 64 3c 2f 62 3e 2c 0d 0a 61 6e 64 20 3c 62 20 rd</b>,..and <b
c8a0: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
c8b0: 3a 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e :validate_comman
c8c0: 64 3c 2f 62 3e 20 69 73 20 6e 6f 74 20 72 65 63 d</b> is not rec
c8d0: 6f 6d 6d 65 6e 64 65 64 2e 20 54 68 65 79 20 6d ommended. They m
c8e0: 61 79 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 ay be removed fr
c8f0: 6f 6d 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 om future releas
c900: 65 73 2e 3c 2f 65 6d 3e 3c 2f 70 3e 0d 0a 3c 2f es.</em></p>..</
c910: 64 69 76 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 div>..</div>..<d
c920: 69 76 20 69 64 3d 22 73 65 63 74 69 6f 6e 36 22 iv id="section6"
c930: 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 class="doctools
c940: 5f 73 65 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c 61 _section"><h2><a
c950: 20 6e 61 6d 65 3d 22 73 65 63 74 69 6f 6e 36 22 name="section6"
c960: 3e 44 65 62 75 67 3c 2f 61 3e 3c 2f 68 32 3e 0d >Debug</a></h2>.
c970: 0a 3c 70 3e 46 6f 72 20 6d 6f 73 74 20 64 65 62 .<p>For most deb
c980: 75 67 67 69 6e 67 20 6e 65 65 64 73 2c 20 74 68 ugging needs, th
c990: 65 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 e <b class="opti
c9a0: 6f 6e 22 3e 2d 63 61 6c 6c 62 61 63 6b 3c 2f 62 on">-callback</b
c9b0: 3e 20 6f 70 74 69 6f 6e 20 63 61 6e 20 62 65 20 > option can be
c9c0: 75 73 65 64 20 74 6f 20 70 72 6f 76 69 64 65 0d used to provide.
c9d0: 0a 73 75 66 66 69 63 69 65 6e 74 20 69 6e 73 69 .sufficient insi
c9e0: 67 68 74 20 61 6e 64 20 69 6e 66 6f 72 6d 61 74 ght and informat
c9f0: 69 6f 6e 20 6f 6e 20 74 68 65 20 54 4c 53 20 68 ion on the TLS h
ca00: 61 6e 64 73 68 61 6b 65 20 61 6e 64 20 70 72 6f andshake and pro
ca10: 67 72 65 73 73 2e 20 49 66 0d 0a 66 75 72 74 68 gress. If..furth
ca20: 65 72 20 74 72 6f 75 62 6c 65 73 68 6f 6f 74 69 er troubleshooti
ca30: 6e 67 20 69 6e 73 69 67 68 74 20 69 73 20 6e 65 ng insight is ne
ca40: 65 64 65 64 2c 20 74 68 65 20 63 6f 6d 70 69 6c eded, the compil
ca50: 65 20 74 69 6d 65 20 6f 70 74 69 6f 6e 0d 0a 3c e time option..<
ca60: 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f 6e 22 b class="option"
ca70: 3e 2d 2d 65 6e 61 62 6c 65 2d 64 65 62 75 67 3c >--enable-debug<
ca80: 2f 62 3e 20 63 61 6e 20 62 65 20 75 73 65 64 20 /b> can be used
ca90: 74 6f 20 67 65 74 20 64 65 74 61 69 6c 65 64 20 to get detailed
caa0: 65 78 65 63 75 74 69 6f 6e 20 66 6c 6f 77 20 73 execution flow s
cab0: 74 61 74 75 73 2e 3c 2f 70 3e 0d 0a 3c 70 3e 54 tatus.</p>..<p>T
cac0: 4c 53 20 6b 65 79 20 6c 6f 67 67 69 6e 67 20 63 LS key logging c
cad0: 61 6e 20 62 65 20 65 6e 61 62 6c 65 64 20 62 79 an be enabled by
cae0: 20 73 65 74 74 69 6e 67 20 74 68 65 20 65 6e 76 setting the env
caf0: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c ironment variabl
cb00: 65 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 e..<b class="var
cb10: 69 61 62 6c 65 22 3e 53 53 4c 4b 45 59 4c 4f 47 iable">SSLKEYLOG
cb20: 46 49 4c 45 3c 2f 62 3e 20 74 6f 20 74 68 65 20 FILE</b> to the
cb30: 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c 65 name of the file
cb40: 20 74 6f 20 6c 6f 67 20 74 6f 2e 20 54 68 65 6e to log to. Then
cb50: 20 77 68 65 6e 65 76 65 72 20 54 4c 53 20 6b 65 whenever TLS ke
cb60: 79 0d 0a 6d 61 74 65 72 69 61 6c 20 69 73 20 67 y..material is g
cb70: 65 6e 65 72 61 74 65 64 20 6f 72 20 72 65 63 65 enerated or rece
cb80: 69 76 65 64 20 69 74 20 77 69 6c 6c 20 62 65 20 ived it will be
cb90: 6c 6f 67 67 65 64 20 74 6f 20 74 68 65 20 66 69 logged to the fi
cba0: 6c 65 2e 20 54 68 69 73 20 69 73 20 75 73 65 66 le. This is usef
cbb0: 75 6c 0d 0a 66 6f 72 20 6c 6f 67 67 69 6e 67 20 ul..for logging
cbc0: 6b 65 79 20 64 61 74 61 20 66 6f 72 20 6e 65 74 key data for net
cbd0: 77 6f 72 6b 20 6c 6f 67 67 69 6e 67 20 74 6f 6f work logging too
cbe0: 6c 73 20 74 6f 20 75 73 65 20 74 6f 20 64 65 63 ls to use to dec
cbf0: 72 79 70 74 20 74 68 65 20 64 61 74 61 2e 3c 2f rypt the data.</
cc00: 70 3e 0d 0a 3c 70 3e 54 68 65 20 3c 62 20 63 6c p>..<p>The <b cl
cc10: 61 73 73 3d 22 76 61 72 69 61 62 6c 65 22 3e 74 ass="variable">t
cc20: 6c 73 3a 3a 64 65 62 75 67 3c 2f 62 3e 20 76 61 ls::debug</b> va
cc30: 72 69 61 62 6c 65 20 70 72 6f 76 69 64 65 73 20 riable provides
cc40: 73 6f 6d 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 some additional
cc50: 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 20 74 68 65 control over the
cc60: 0d 0a 64 65 62 75 67 20 6c 6f 67 67 69 6e 67 20 ..debug logging
cc70: 69 6e 20 74 68 65 20 3c 62 20 63 6c 61 73 73 3d in the <b class=
cc80: 22 63 6d 64 22 3e 74 6c 73 3a 3a 63 61 6c 6c 62 "cmd">tls::callb
cc90: 61 63 6b 3c 2f 62 3e 2c 20 3c 62 20 63 6c 61 73 ack</b>, <b clas
cca0: 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a 70 61 73 s="cmd">tls::pas
ccb0: 73 77 6f 72 64 3c 2f 62 3e 2c 20 61 6e 64 0d 0a sword</b>, and..
ccc0: 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 <b class="cmd">t
ccd0: 6c 73 3a 3a 76 61 6c 69 64 61 74 65 5f 63 6f 6d ls::validate_com
cce0: 6d 61 6e 64 3c 2f 62 3e 20 64 65 66 61 75 6c 74 mand</b> default
ccf0: 20 68 61 6e 64 6c 65 72 73 20 69 6e 20 26 71 75 handlers in &qu
cd00: 6f 74 3b 3c 62 20 63 6c 61 73 73 3d 22 66 69 6c ot;<b class="fil
cd10: 65 22 3e 74 6c 73 2e 74 63 6c 3c 2f 62 3e 26 71 e">tls.tcl</b>&q
cd20: 75 6f 74 3b 2e 0d 0a 54 68 65 20 64 65 66 61 75 uot;...The defau
cd30: 6c 74 20 76 61 6c 75 65 20 69 73 20 30 20 77 69 lt value is 0 wi
cd40: 74 68 20 68 69 67 68 65 72 20 76 61 6c 75 65 73 th higher values
cd50: 20 70 72 6f 64 75 63 69 6e 67 20 6d 6f 72 65 20 producing more
cd60: 64 69 61 67 6e 6f 73 74 69 63 20 6f 75 74 70 75 diagnostic outpu
cd70: 74 2c 0d 0a 61 6e 64 20 77 69 6c 6c 20 61 6c 73 t,..and will als
cd80: 6f 20 66 6f 72 63 65 20 74 68 65 20 76 65 72 69 o force the veri
cd90: 66 79 20 6d 65 74 68 6f 64 20 69 6e 20 3c 62 20 fy method in <b
cda0: 63 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a class="cmd">tls:
cdb0: 3a 63 61 6c 6c 62 61 63 6b 3c 2f 62 3e 20 74 6f :callback</b> to
cdc0: 20 61 63 63 65 70 74 20 74 68 65 0d 0a 63 65 72 accept the..cer
cdd0: 74 69 66 69 63 61 74 65 2c 20 65 76 65 6e 20 69 tificate, even i
cde0: 66 20 69 74 20 69 73 20 69 6e 76 61 6c 69 64 20 f it is invalid
cdf0: 77 68 65 6e 20 74 68 65 20 3c 62 20 63 6c 61 73 when the <b clas
ce00: 73 3d 22 6f 70 74 69 6f 6e 22 3e 2d 76 61 6c 69 s="option">-vali
ce10: 64 61 74 65 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 0d datecommand</b>.
ce20: 0a 6f 70 74 69 6f 6e 20 69 73 20 73 65 74 20 74 .option is set t
ce30: 6f 20 3c 62 20 63 6c 61 73 73 3d 22 63 6d 64 22 o <b class="cmd"
ce40: 3e 74 6c 73 3a 3a 76 61 6c 69 64 61 74 65 5f 63 >tls::validate_c
ce50: 6f 6d 6d 61 6e 64 3c 2f 62 3e 2e 3c 2f 70 3e 0d ommand</b>.</p>.
ce60: 0a 3c 70 3e 3c 65 6d 3e 54 68 65 20 75 73 65 20 .<p><em>The use
ce70: 6f 66 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 of the variable
ce80: 3c 62 20 63 6c 61 73 73 3d 22 76 61 72 69 61 62 <b class="variab
ce90: 6c 65 22 3e 74 6c 73 3a 3a 64 65 62 75 67 3c 2f le">tls::debug</
cea0: 62 3e 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d b> is not recomm
ceb0: 65 6e 64 65 64 2e 0d 0a 49 74 20 6d 61 79 20 62 ended...It may b
cec0: 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 66 e removed from f
ced0: 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 2e 3c uture releases.<
cee0: 2f 65 6d 3e 3c 2f 70 3e 0d 0a 3c 2f 64 69 76 3e /em></p>..</div>
cef0: 0d 0a 3c 64 69 76 20 69 64 3d 22 73 65 63 74 69 ..<div id="secti
cf00: 6f 6e 37 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 on7" class="doct
cf10: 6f 6f 6c 73 5f 73 65 63 74 69 6f 6e 22 3e 3c 68 ools_section"><h
cf20: 32 3e 3c 61 20 6e 61 6d 65 3d 22 73 65 63 74 69 2><a name="secti
cf30: 6f 6e 37 22 3e 45 78 61 6d 70 6c 65 73 3c 2f 61 on7">Examples</a
cf40: 3e 3c 2f 68 32 3e 0d 0a 3c 70 3e 54 68 65 20 66 ></h2>..<p>The f
cf50: 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 65 78 61 ollowing are exa
cf60: 6d 70 6c 65 20 73 63 72 69 70 74 73 20 74 6f 20 mple scripts to
cf70: 64 6f 77 6e 6c 6f 61 64 20 61 20 77 65 62 70 61 download a webpa
cf80: 67 65 20 61 6e 64 20 66 69 6c 65 20 75 73 69 6e ge and file usin
cf90: 67 20 74 68 65 0d 0a 68 74 74 70 20 70 61 63 6b g the..http pack
cfa0: 61 67 65 2e 20 53 65 65 20 3c 73 70 61 6e 20 63 age. See <span c
cfb0: 6c 61 73 73 3d 22 73 65 63 74 72 65 66 22 3e 3c lass="sectref"><
cfc0: 61 20 68 72 65 66 3d 22 23 73 65 63 74 69 6f 6e a href="#section
cfd0: 34 22 3e 43 65 72 74 69 66 69 63 61 74 65 20 56 4">Certificate V
cfe0: 61 6c 69 64 61 74 69 6f 6e 3c 2f 61 3e 3c 2f 73 alidation</a></s
cff0: 70 61 6e 3e 20 66 6f 72 20 77 68 65 6e 20 74 68 pan> for when th
d000: 65 0d 0a 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 e..<b class="opt
d010: 69 6f 6e 22 3e 2d 63 61 64 69 72 3c 2f 62 3e 2c ion">-cadir</b>,
d020: 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 74 69 6f <b class="optio
d030: 6e 22 3e 2d 63 61 66 69 6c 65 3c 2f 62 3e 2c 20 n">-cafile</b>,
d040: 61 6e 64 20 3c 62 20 63 6c 61 73 73 3d 22 6f 70 and <b class="op
d050: 74 69 6f 6e 22 3e 2d 63 61 73 74 6f 72 65 3c 2f tion">-castore</
d060: 62 3e 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 61 b> options are a
d070: 6c 73 6f 0d 0a 6e 65 65 64 65 64 2e 20 53 65 65 lso..needed. See
d080: 20 74 68 65 20 26 71 75 6f 74 3b 3c 62 20 63 6c the "<b cl
d090: 61 73 73 3d 22 66 69 6c 65 22 3e 64 65 6d 6f 73 ass="file">demos
d0a0: 3c 2f 62 3e 26 71 75 6f 74 3b 20 64 69 72 65 63 </b>" direc
d0b0: 74 6f 72 79 20 66 6f 72 20 6d 6f 72 65 20 65 78 tory for more ex
d0c0: 61 6d 70 6c 65 20 73 63 72 69 70 74 73 2e 3c 2f ample scripts.</
d0d0: 70 3e 0d 0a 3c 70 3e 45 78 61 6d 70 6c 65 20 23 p>..<p>Example #
d0e0: 31 3a 20 44 6f 77 6e 6c 6f 61 64 20 61 20 77 65 1: Download a we
d0f0: 62 20 70 61 67 65 3c 2f 70 3e 0d 0a 3c 70 72 65 b page</p>..<pre
d100: 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 class="doctools
d110: 5f 65 78 61 6d 70 6c 65 22 3e 0d 0a 70 61 63 6b _example">..pack
d120: 61 67 65 20 72 65 71 75 69 72 65 20 68 74 74 70 age require http
d130: 0d 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 ..package requir
d140: 65 20 74 6c 73 0d 0a 73 65 74 20 75 72 6c 20 26 e tls..set url &
d150: 71 75 6f 74 3b 68 74 74 70 73 3a 2f 2f 77 77 77 quot;https://www
d160: 2e 74 63 6c 2e 74 6b 2f 26 71 75 6f 74 3b 0d 0a .tcl.tk/"..
d170: 68 74 74 70 3a 3a 72 65 67 69 73 74 65 72 20 68 http::register h
d180: 74 74 70 73 20 34 34 33 20 5b 6c 69 73 74 20 3a ttps 443 [list :
d190: 3a 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 :tls::socket -au
d1a0: 74 6f 73 65 72 76 65 72 6e 61 6d 65 20 31 20 2d toservername 1 -
d1b0: 72 65 71 75 69 72 65 20 31 5d 0d 0a 23 20 47 65 require 1]..# Ge
d1c0: 74 20 55 52 4c 0d 0a 73 65 74 20 74 6f 6b 65 6e t URL..set token
d1d0: 20 5b 68 74 74 70 3a 3a 67 65 74 75 72 6c 20 24 [http::geturl $
d1e0: 75 72 6c 5d 0d 0a 23 20 43 68 65 63 6b 20 66 6f url]..# Check fo
d1f0: 72 20 65 72 72 6f 72 0d 0a 69 66 20 7b 5b 68 74 r error..if {[ht
d200: 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f 6b 65 tp::status $toke
d210: 6e 5d 20 6e 65 20 26 71 75 6f 74 3b 6f 6b 26 71 n] ne "ok&q
d220: 75 6f 74 3b 7d 20 7b 0d 0a 20 20 20 20 70 75 74 uot;} {.. put
d230: 73 20 5b 66 6f 72 6d 61 74 20 26 71 75 6f 74 3b s [format "
d240: 45 72 72 6f 72 20 25 73 26 71 75 6f 74 3b 20 5b Error %s" [
d250: 68 74 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f http::status $to
d260: 6b 65 6e 5d 5d 0d 0a 7d 0d 0a 23 20 53 61 76 65 ken]]..}..# Save
d270: 20 77 65 62 20 70 61 67 65 20 74 6f 20 66 69 6c web page to fil
d280: 65 0d 0a 73 65 74 20 63 68 20 5b 6f 70 65 6e 20 e..set ch [open
d290: 65 78 61 6d 70 6c 65 2e 68 74 6d 6c 20 77 62 5d example.html wb]
d2a0: 0d 0a 70 75 74 73 20 24 63 68 20 5b 68 74 74 70 ..puts $ch [http
d2b0: 3a 3a 64 61 74 61 20 24 74 6f 6b 65 6e 5d 0d 0a ::data $token]..
d2c0: 63 6c 6f 73 65 20 24 63 68 0d 0a 23 20 43 6c 65 close $ch..# Cle
d2d0: 61 6e 75 70 0d 0a 3a 3a 68 74 74 70 3a 3a 63 6c anup..::http::cl
d2e0: 65 61 6e 75 70 20 24 74 6f 6b 65 6e 0d 0a 3c 2f eanup $token..</
d2f0: 70 72 65 3e 0d 0a 3c 70 3e 45 78 61 6d 70 6c 65 pre>..<p>Example
d300: 20 23 32 3a 20 44 6f 77 6e 6c 6f 61 64 20 61 20 #2: Download a
d310: 66 69 6c 65 3c 2f 70 3e 0d 0a 3c 70 72 65 20 63 file</p>..<pre c
d320: 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 65 lass="doctools_e
d330: 78 61 6d 70 6c 65 22 3e 0d 0a 70 61 63 6b 61 67 xample">..packag
d340: 65 20 72 65 71 75 69 72 65 20 68 74 74 70 0d 0a e require http..
d350: 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 package require
d360: 74 6c 73 0d 0a 73 65 74 20 75 72 6c 20 26 71 75 tls..set url &qu
d370: 6f 74 3b 68 74 74 70 73 3a 2f 2f 77 69 6b 69 2e ot;https://wiki.
d380: 74 63 6c 2d 6c 61 6e 67 2e 6f 72 67 2f 73 69 74 tcl-lang.org/sit
d390: 65 6d 61 70 2e 78 6d 6c 26 71 75 6f 74 3b 0d 0a emap.xml"..
d3a0: 68 74 74 70 3a 3a 72 65 67 69 73 74 65 72 20 68 http::register h
d3b0: 74 74 70 73 20 34 34 33 20 5b 6c 69 73 74 20 3a ttps 443 [list :
d3c0: 3a 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 :tls::socket -au
d3d0: 74 6f 73 65 72 76 65 72 6e 61 6d 65 20 31 20 2d toservername 1 -
d3e0: 72 65 71 75 69 72 65 20 31 5d 0d 0a 23 20 4f 70 require 1]..# Op
d3f0: 65 6e 20 6f 75 74 70 75 74 20 66 69 6c 65 0d 0a en output file..
d400: 73 65 74 20 66 69 6c 65 6e 61 6d 65 20 5b 66 69 set filename [fi
d410: 6c 65 20 74 61 69 6c 20 24 75 72 6c 5d 0d 0a 73 le tail $url]..s
d420: 65 74 20 63 68 20 5b 6f 70 65 6e 20 24 66 69 6c et ch [open $fil
d430: 65 6e 61 6d 65 20 77 62 5d 0d 0a 23 20 47 65 74 ename wb]..# Get
d440: 20 66 69 6c 65 0d 0a 73 65 74 20 74 6f 6b 65 6e file..set token
d450: 20 5b 3a 3a 68 74 74 70 3a 3a 67 65 74 75 72 6c [::http::geturl
d460: 20 24 75 72 6c 20 2d 62 6c 6f 63 6b 73 69 7a 65 $url -blocksize
d470: 20 36 35 35 33 36 20 2d 63 68 61 6e 6e 65 6c 20 65536 -channel
d480: 24 63 68 5d 0d 0a 23 20 43 68 65 63 6b 20 66 6f $ch]..# Check fo
d490: 72 20 65 72 72 6f 72 0d 0a 69 66 20 7b 5b 68 74 r error..if {[ht
d4a0: 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f 6b 65 tp::status $toke
d4b0: 6e 5d 20 6e 65 20 26 71 75 6f 74 3b 6f 6b 26 71 n] ne "ok&q
d4c0: 75 6f 74 3b 7d 20 7b 0d 0a 20 20 20 20 70 75 74 uot;} {.. put
d4d0: 73 20 5b 66 6f 72 6d 61 74 20 26 71 75 6f 74 3b s [format "
d4e0: 45 72 72 6f 72 20 25 73 26 71 75 6f 74 3b 20 5b Error %s" [
d4f0: 68 74 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f http::status $to
d500: 6b 65 6e 5d 5d 0d 0a 7d 0d 0a 23 20 43 6c 65 61 ken]]..}..# Clea
d510: 6e 75 70 0d 0a 63 6c 6f 73 65 20 24 63 68 0d 0a nup..close $ch..
d520: 3a 3a 68 74 74 70 3a 3a 63 6c 65 61 6e 75 70 20 ::http::cleanup
d530: 24 74 6f 6b 65 6e 0d 0a 3c 2f 70 72 65 3e 0d 0a $token..</pre>..
d540: 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d </div>..<div id=
d550: 22 73 65 63 74 69 6f 6e 38 22 20 63 6c 61 73 73 "section8" class
d560: 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 ="doctools_secti
d570: 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 3d on"><h2><a name=
d580: 22 73 65 63 74 69 6f 6e 38 22 3e 53 70 65 63 69 "section8">Speci
d590: 61 6c 20 43 6f 6e 73 69 64 65 72 61 74 69 6f 6e al Consideration
d5a0: 73 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a 3c 70 3e 54 s</a></h2>..<p>T
d5b0: 68 65 20 63 61 70 61 62 69 6c 69 74 69 65 73 20 he capabilities
d5c0: 6f 66 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 of this package
d5d0: 63 61 6e 20 76 61 72 79 20 65 6e 6f 72 6d 6f 75 can vary enormou
d5e0: 73 6c 79 20 62 61 73 65 64 20 75 70 6f 6e 20 68 sly based upon h
d5f0: 6f 77 20 74 68 65 0d 0a 6c 69 6e 6b 65 64 20 74 ow the..linked t
d600: 6f 20 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 o OpenSSL librar
d610: 79 20 77 61 73 20 63 6f 6e 66 69 67 75 72 65 64 y was configured
d620: 20 61 6e 64 20 62 75 69 6c 74 2e 20 4e 65 77 20 and built. New
d630: 76 65 72 73 69 6f 6e 73 20 6d 61 79 20 6f 62 73 versions may obs
d640: 6f 6c 65 74 65 0d 0a 6f 6c 64 65 72 20 70 72 6f olete..older pro
d650: 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 73 2c 20 tocol versions,
d660: 61 64 64 20 6f 72 20 72 65 6d 6f 76 65 20 63 69 add or remove ci
d670: 70 68 65 72 73 2c 20 63 68 61 6e 67 65 20 64 65 phers, change de
d680: 66 61 75 6c 74 20 76 61 6c 75 65 73 2c 20 65 74 fault values, et
d690: 63 2e 0d 0a 55 73 65 20 74 68 65 20 3c 62 20 63 c...Use the <b c
d6a0: 6c 61 73 73 3d 22 63 6d 64 22 3e 74 6c 73 3a 3a lass="cmd">tls::
d6b0: 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 20 63 6f protocols</b> co
d6c0: 6d 6d 61 6e 64 20 74 6f 20 6f 62 74 61 69 6e 20 mmand to obtain
d6d0: 74 68 65 20 73 75 70 70 6f 72 74 65 64 0d 0a 70 the supported..p
d6e0: 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 73 rotocol versions
d6f0: 2e 3c 2f 70 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c .</p>..</div>..<
d700: 64 69 76 20 69 64 3d 22 73 65 63 74 69 6f 6e 39 div id="section9
d710: 22 20 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c " class="doctool
d720: 73 5f 73 65 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c s_section"><h2><
d730: 61 20 6e 61 6d 65 3d 22 73 65 63 74 69 6f 6e 39 a name="section9
d740: 22 3e 45 72 72 6f 72 20 4d 65 73 73 61 67 65 73 ">Error Messages
d750: 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a 3c 70 3e 53 6f </a></h2>..<p>So
d760: 6d 65 20 4f 70 73 6e 53 53 6c 20 65 72 72 6f 72 me OpsnSSl error
d770: 20 6d 65 73 73 61 67 65 73 20 68 61 76 65 20 63 messages have c
d780: 72 79 70 74 69 63 20 6d 65 61 6e 69 6e 67 73 2e ryptic meanings.
d790: 20 54 68 69 73 20 69 73 20 61 20 6c 69 73 74 20 This is a list
d7a0: 6f 66 20 6d 65 73 73 61 67 65 73 0d 0a 61 6c 6f of messages..alo
d7b0: 6e 67 20 77 69 74 68 20 74 68 65 69 72 20 74 72 ng with their tr
d7c0: 75 65 20 6d 65 61 6e 69 6e 67 2e 3c 2f 70 3e 0d ue meaning.</p>.
d7d0: 0a 3c 64 6c 20 63 6c 61 73 73 3d 22 64 6f 63 74 .<dl class="doct
d7e0: 6f 6f 6c 73 5f 64 65 66 69 6e 69 74 69 6f 6e 73 ools_definitions
d7f0: 22 3e 0d 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 ">..<dt><i class
d800: 3d 22 61 72 67 22 3e 70 61 63 6b 65 74 20 6c 65 ="arg">packet le
d810: 6e 67 74 68 20 74 6f 6f 20 6c 6f 6e 67 3c 2f 69 ngth too long</i
d820: 3e 3c 2f 64 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 ></dt>..<dd><p>C
d830: 6c 69 65 6e 74 20 68 61 73 20 74 72 69 65 64 20 lient has tried
d840: 74 6f 20 63 6f 6e 6e 65 63 74 20 74 6f 20 61 20 to connect to a
d850: 48 54 54 50 20 73 65 72 76 65 72 20 6f 6e 20 74 HTTP server on t
d860: 68 65 20 70 6c 61 69 6e 2d 74 65 78 74 20 70 6f he plain-text po
d870: 72 74 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 rt instead of th
d880: 65 20 53 53 4c 2f 54 4c 53 20 70 6f 72 74 2e 3c e SSL/TLS port.<
d890: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 64 74 3e 3c 69 /p></dd>..<dt><i
d8a0: 20 63 6c 61 73 73 3d 22 61 72 67 22 3e 75 6e 65 class="arg">une
d8b0: 78 70 65 63 74 65 64 20 65 6f 66 20 77 68 69 6c xpected eof whil
d8c0: 65 20 72 65 61 64 69 6e 67 3c 2f 69 3e 3c 2f 64 e reading</i></d
d8d0: 74 3e 0d 0a 3c 64 64 3e 3c 70 3e 50 65 65 72 20 t>..<dd><p>Peer
d8e0: 68 61 73 20 63 6c 6f 73 65 64 20 74 68 65 20 63 has closed the c
d8f0: 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 6f 75 onnection withou
d900: 74 20 73 65 6e 64 69 6e 67 20 74 68 65 20 26 71 t sending the &q
d910: 75 6f 74 3b 63 6c 6f 73 65 20 6e 6f 74 69 66 79 uot;close notify
d920: 26 71 75 6f 74 3b 20 73 68 75 74 64 6f 77 6e 20 " shutdown
d930: 61 6c 65 72 74 2e 3c 2f 70 3e 3c 2f 64 64 3e 0d alert.</p></dd>.
d940: 0a 3c 64 74 3e 3c 69 20 63 6c 61 73 73 3d 22 61 .<dt><i class="a
d950: 72 67 22 3e 77 72 6f 6e 67 20 76 65 72 73 69 6f rg">wrong versio
d960: 6e 20 6e 75 6d 62 65 72 3c 2f 69 3e 3c 2f 64 74 n number</i></dt
d970: 3e 0d 0a 3c 64 64 3e 3c 70 3e 43 6c 69 65 6e 74 >..<dd><p>Client
d980: 20 68 61 73 20 74 72 69 65 64 20 74 6f 20 63 6f has tried to co
d990: 6e 6e 65 63 74 20 74 6f 20 61 20 6e 6f 6e 2d 48 nnect to a non-H
d9a0: 54 54 50 20 73 65 72 76 65 72 20 6f 6e 20 61 20 TTP server on a
d9b0: 6e 6f 6e 2d 54 4c 53 20 28 69 2e 65 2e 20 70 6c non-TLS (i.e. pl
d9c0: 61 69 6e 20 74 65 78 74 29 20 70 6f 72 74 2e 3c ain text) port.<
d9d0: 2f 70 3e 3c 2f 64 64 3e 0d 0a 3c 2f 64 6c 3e 0d /p></dd>..</dl>.
d9e0: 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 .</div>..<div id
d9f0: 3d 22 73 65 65 2d 61 6c 73 6f 22 20 63 6c 61 73 ="see-also" clas
da00: 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 s="doctools_sect
da10: 69 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 ion"><h2><a name
da20: 3d 22 73 65 65 2d 61 6c 73 6f 22 3e 53 65 65 20 ="see-also">See
da30: 41 6c 73 6f 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a 3c Also</a></h2>..<
da40: 70 3e 3c 61 20 68 72 65 66 3d 22 68 74 74 70 73 p><a href="https
da50: 3a 2f 2f 77 77 77 2e 6f 70 65 6e 73 73 6c 2e 6f ://www.openssl.o
da60: 72 67 2f 22 3e 4f 70 65 6e 53 53 4c 3c 2f 61 3e rg/">OpenSSL</a>
da70: 2c 20 68 74 74 70 2c 20 73 6f 63 6b 65 74 3c 2f , http, socket</
da80: 70 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 76 p>..</div>..<div
da90: 20 69 64 3d 22 6b 65 79 77 6f 72 64 73 22 20 63 id="keywords" c
daa0: 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 lass="doctools_s
dab0: 65 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e ection"><h2><a n
dac0: 61 6d 65 3d 22 6b 65 79 77 6f 72 64 73 22 3e 4b ame="keywords">K
dad0: 65 79 77 6f 72 64 73 3c 2f 61 3e 3c 2f 68 32 3e eywords</a></h2>
dae0: 0d 0a 3c 70 3e 49 2f 4f 2c 20 49 50 20 41 64 64 ..<p>I/O, IP Add
daf0: 72 65 73 73 2c 20 4f 70 65 6e 53 53 4c 2c 20 53 ress, OpenSSL, S
db00: 53 4c 2c 20 54 43 50 2c 20 54 4c 53 2c 20 54 63 SL, TCP, TLS, Tc
db10: 6c 54 4c 53 2c 20 61 73 79 6e 63 68 72 6f 6e 6f lTLS, asynchrono
db20: 75 73 20 49 2f 4f 2c 20 62 69 6e 64 2c 20 63 65 us I/O, bind, ce
db30: 72 74 69 66 69 63 61 74 65 2c 20 63 68 61 6e 6e rtificate, chann
db40: 65 6c 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 el, connection,
db50: 64 6f 6d 61 69 6e 20 6e 61 6d 65 2c 20 68 6f 73 domain name, hos
db60: 74 2c 20 68 74 74 70 73 2c 20 6e 65 74 77 6f 72 t, https, networ
db70: 6b 2c 20 6e 65 74 77 6f 72 6b 20 61 64 64 72 65 k, network addre
db80: 73 73 2c 20 73 6f 63 6b 65 74 2c 20 74 6c 73 3c ss, socket, tls<
db90: 2f 70 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 3c 64 69 /p>..</div>..<di
dba0: 76 20 69 64 3d 22 63 61 74 65 67 6f 72 79 22 20 v id="category"
dbb0: 63 6c 61 73 73 3d 22 64 6f 63 74 6f 6f 6c 73 5f class="doctools_
dbc0: 73 65 63 74 69 6f 6e 22 3e 3c 68 32 3e 3c 61 20 section"><h2><a
dbd0: 6e 61 6d 65 3d 22 63 61 74 65 67 6f 72 79 22 3e name="category">
dbe0: 43 61 74 65 67 6f 72 79 3c 2f 61 3e 3c 2f 68 32 Category</a></h2
dbf0: 3e 0d 0a 3c 70 3e 74 6c 73 3c 2f 70 3e 0d 0a 3c >..<p>tls</p>..<
dc00: 2f 64 69 76 3e 0d 0a 3c 64 69 76 20 69 64 3d 22 /div>..<div id="
dc10: 63 6f 70 79 72 69 67 68 74 22 20 63 6c 61 73 73 copyright" class
dc20: 3d 22 64 6f 63 74 6f 6f 6c 73 5f 73 65 63 74 69 ="doctools_secti
dc30: 6f 6e 22 3e 3c 68 32 3e 3c 61 20 6e 61 6d 65 3d on"><h2><a name=
dc40: 22 63 6f 70 79 72 69 67 68 74 22 3e 43 6f 70 79 "copyright">Copy
dc50: 72 69 67 68 74 3c 2f 61 3e 3c 2f 68 32 3e 0d 0a right</a></h2>..
dc60: 3c 70 3e 43 6f 70 79 72 69 67 68 74 20 26 63 6f <p>Copyright &co
dc70: 70 79 3b 20 31 39 39 39 20 4d 61 74 74 20 4e 65 py; 1999 Matt Ne
dc80: 77 6d 61 6e 3c 62 72 3e 0d 0a 43 6f 70 79 72 69 wman<br>..Copyri
dc90: 67 68 74 20 26 63 6f 70 79 3b 20 32 30 30 34 20 ght © 2004
dca0: 53 74 61 72 66 69 73 68 20 53 79 73 74 65 6d 73 Starfish Systems
dcb0: 3c 62 72 3e 0d 0a 43 6f 70 79 72 69 67 68 74 20 <br>..Copyright
dcc0: 26 63 6f 70 79 3b 20 32 30 32 34 20 42 72 69 61 © 2024 Bria
dcd0: 6e 20 4f 27 48 61 67 61 6e 3c 2f 70 3e 0d 0a 3c n O'Hagan</p>..<
dce0: 2f 64 69 76 3e 0d 0a 3c 2f 64 69 76 3e 0d 0a 0a /div>..</div>...
dcf0: 5a 20 62 36 37 39 34 61 66 66 33 33 64 38 31 37 Z b6794aff33d817
dd00: 32 36 65 30 38 64 39 35 61 33 66 62 36 62 31 65 26e08d95a3fb6b1e
dd10: 30 37 0a 07.