0000: 27 5c 22 0a 27 5c 22 20 47 65 6e 65 72 61 74 65 '\".'\" Generate
0010: 64 20 66 72 6f 6d 20 66 69 6c 65 20 27 74 6c 73 d from file 'tls
0020: 5c 26 2e 6d 61 6e 27 20 62 79 20 74 63 6c 6c 69 \&.man' by tclli
0030: 62 2f 64 6f 63 74 6f 6f 6c 73 20 77 69 74 68 20 b/doctools with
0040: 66 6f 72 6d 61 74 20 27 6e 72 6f 66 66 27 0a 27 format 'nroff'.'
0050: 5c 22 20 43 6f 70 79 72 69 67 68 74 20 28 63 29 \" Copyright (c)
0060: 20 31 39 39 39 20 4d 61 74 74 20 4e 65 77 6d 61 1999 Matt Newma
0070: 6e 0a 27 5c 22 20 43 6f 70 79 72 69 67 68 74 20 n.'\" Copyright
0080: 28 63 29 20 32 30 30 34 20 53 74 61 72 66 69 73 (c) 2004 Starfis
0090: 68 20 53 79 73 74 65 6d 73 0a 27 5c 22 20 43 6f h Systems.'\" Co
00a0: 70 79 72 69 67 68 74 20 28 63 29 20 32 30 32 34 pyright (c) 2024
00b0: 20 42 72 69 61 6e 20 4f 27 48 61 67 61 6e 0a 27 Brian O'Hagan.'
00c0: 5c 22 0a 2e 54 48 20 22 74 6c 73 22 20 6e 20 32 \"..TH "tls" n 2
00d0: 5c 26 2e 30 5c 26 2e 31 20 74 6c 73 20 22 54 63 \&.0\&.1 tls "Tc
00e0: 6c 20 54 4c 53 20 65 78 74 65 6e 73 69 6f 6e 22 l TLS extension"
00f0: 0a 2e 5c 22 20 54 68 65 20 2d 2a 2d 20 6e 72 6f ..\" The -*- nro
0100: 66 66 20 2d 2a 2d 20 64 65 66 69 6e 69 74 69 6f ff -*- definitio
0110: 6e 73 20 62 65 6c 6f 77 20 61 72 65 20 66 6f 72 ns below are for
0120: 20 73 75 70 70 6c 65 6d 65 6e 74 61 6c 20 6d 61 supplemental ma
0130: 63 72 6f 73 20 75 73 65 64 0a 2e 5c 22 20 69 6e cros used..\" in
0140: 20 54 63 6c 2f 54 6b 20 6d 61 6e 75 61 6c 20 65 Tcl/Tk manual e
0150: 6e 74 72 69 65 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 ntries...\"..\"
0160: 2e 41 50 20 74 79 70 65 20 6e 61 6d 65 20 69 6e .AP type name in
0170: 2f 6f 75 74 20 3f 69 6e 64 65 6e 74 3f 0a 2e 5c /out ?indent?..\
0180: 22 09 53 74 61 72 74 20 70 61 72 61 67 72 61 70 ".Start paragrap
0190: 68 20 64 65 73 63 72 69 62 69 6e 67 20 61 6e 20 h describing an
01a0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 61 20 6c 69 argument to a li
01b0: 62 72 61 72 79 20 70 72 6f 63 65 64 75 72 65 2e brary procedure.
01c0: 0a 2e 5c 22 09 74 79 70 65 20 69 73 20 74 79 70 ..\".type is typ
01d0: 65 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 28 69 e of argument (i
01e0: 6e 74 2c 20 65 74 63 2e 29 2c 20 69 6e 2f 6f 75 nt, etc.), in/ou
01f0: 74 20 69 73 20 65 69 74 68 65 72 20 22 69 6e 22 t is either "in"
0200: 2c 20 22 6f 75 74 22 2c 0a 2e 5c 22 09 6f 72 20 , "out",..\".or
0210: 22 69 6e 2f 6f 75 74 22 20 74 6f 20 64 65 73 63 "in/out" to desc
0220: 72 69 62 65 20 77 68 65 74 68 65 72 20 70 72 6f ribe whether pro
0230: 63 65 64 75 72 65 20 72 65 61 64 73 20 6f 72 20 cedure reads or
0240: 6d 6f 64 69 66 69 65 73 20 61 72 67 2c 0a 2e 5c modifies arg,..\
0250: 22 09 61 6e 64 20 69 6e 64 65 6e 74 20 69 73 20 ".and indent is
0260: 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 65 equivalent to se
0270: 63 6f 6e 64 20 61 72 67 20 6f 66 20 2e 49 50 20 cond arg of .IP
0280: 28 73 68 6f 75 6c 64 6e 27 74 20 65 76 65 72 20 (shouldn't ever
0290: 62 65 0a 2e 5c 22 09 6e 65 65 64 65 64 3b 20 20 be..\".needed;
02a0: 75 73 65 20 2e 41 53 20 62 65 6c 6f 77 20 69 6e use .AS below in
02b0: 73 74 65 61 64 29 0a 2e 5c 22 0a 2e 5c 22 20 2e stead)..\"..\" .
02c0: 41 53 20 3f 74 79 70 65 3f 20 3f 6e 61 6d 65 3f AS ?type? ?name?
02d0: 0a 2e 5c 22 09 47 69 76 65 20 6d 61 78 69 6d 75 ..\".Give maximu
02e0: 6d 20 73 69 7a 65 73 20 6f 66 20 61 72 67 75 6d m sizes of argum
02f0: 65 6e 74 73 20 66 6f 72 20 73 65 74 74 69 6e 67 ents for setting
0300: 20 74 61 62 20 73 74 6f 70 73 2e 20 20 54 79 70 tab stops. Typ
0310: 65 20 61 6e 64 0a 2e 5c 22 09 6e 61 6d 65 20 61 e and..\".name a
0320: 72 65 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 6c re examples of l
0330: 61 72 67 65 73 74 20 70 6f 73 73 69 62 6c 65 20 argest possible
0340: 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 77 arguments that w
0350: 69 6c 6c 20 62 65 20 70 61 73 73 65 64 0a 2e 5c ill be passed..\
0360: 22 09 74 6f 20 2e 41 50 20 6c 61 74 65 72 2e 20 ".to .AP later.
0370: 20 49 66 20 61 72 67 73 20 61 72 65 20 6f 6d 69 If args are omi
0380: 74 74 65 64 2c 20 64 65 66 61 75 6c 74 20 74 61 tted, default ta
0390: 62 20 73 74 6f 70 73 20 61 72 65 20 75 73 65 64 b stops are used
03a0: 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 53 0a 2e 5c ...\"..\" .BS..\
03b0: 22 09 53 74 61 72 74 20 62 6f 78 20 65 6e 63 6c ".Start box encl
03c0: 6f 73 75 72 65 2e 20 20 46 72 6f 6d 20 68 65 72 osure. From her
03d0: 65 20 75 6e 74 69 6c 20 6e 65 78 74 20 2e 42 45 e until next .BE
03e0: 2c 20 65 76 65 72 79 74 68 69 6e 67 20 77 69 6c , everything wil
03f0: 6c 20 62 65 0a 2e 5c 22 09 65 6e 63 6c 6f 73 65 l be..\".enclose
0400: 64 20 69 6e 20 6f 6e 65 20 6c 61 72 67 65 20 62 d in one large b
0410: 6f 78 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 45 0a ox...\"..\" .BE.
0420: 2e 5c 22 09 45 6e 64 20 6f 66 20 62 6f 78 20 65 .\".End of box e
0430: 6e 63 6c 6f 73 75 72 65 2e 0a 2e 5c 22 0a 2e 5c nclosure...\"..\
0440: 22 20 2e 43 53 0a 2e 5c 22 09 42 65 67 69 6e 20 " .CS..\".Begin
0450: 63 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c code excerpt...\
0460: 22 0a 2e 5c 22 20 2e 43 45 0a 2e 5c 22 09 45 6e "..\" .CE..\".En
0470: 64 20 63 6f 64 65 20 65 78 63 65 72 70 74 2e 0a d code excerpt..
0480: 2e 5c 22 0a 2e 5c 22 20 2e 56 53 20 3f 76 65 72 .\"..\" .VS ?ver
0490: 73 69 6f 6e 3f 20 3f 62 72 3f 0a 2e 5c 22 09 42 sion? ?br?..\".B
04a0: 65 67 69 6e 20 76 65 72 74 69 63 61 6c 20 73 69 egin vertical si
04b0: 64 65 62 61 72 2c 20 66 6f 72 20 75 73 65 20 69 debar, for use i
04c0: 6e 20 6d 61 72 6b 69 6e 67 20 6e 65 77 6c 79 2d n marking newly-
04d0: 63 68 61 6e 67 65 64 20 70 61 72 74 73 0a 2e 5c changed parts..\
04e0: 22 09 6f 66 20 6d 61 6e 20 70 61 67 65 73 2e 20 ".of man pages.
04f0: 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d The first argum
0500: 65 6e 74 20 69 73 20 69 67 6e 6f 72 65 64 20 61 ent is ignored a
0510: 6e 64 20 75 73 65 64 20 66 6f 72 20 72 65 63 6f nd used for reco
0520: 72 64 69 6e 67 0a 2e 5c 22 09 74 68 65 20 76 65 rding..\".the ve
0530: 72 73 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 2e rsion when the .
0540: 56 53 20 77 61 73 20 61 64 64 65 64 2c 20 73 6f VS was added, so
0550: 20 74 68 61 74 20 74 68 65 20 73 69 64 65 62 61 that the sideba
0560: 72 73 20 63 61 6e 20 62 65 0a 2e 5c 22 09 66 6f rs can be..\".fo
0570: 75 6e 64 20 61 6e 64 20 72 65 6d 6f 76 65 64 20 und and removed
0580: 77 68 65 6e 20 74 68 65 79 20 72 65 61 63 68 20 when they reach
0590: 61 20 63 65 72 74 61 69 6e 20 61 67 65 2e 20 20 a certain age.
05a0: 49 66 20 61 6e 6f 74 68 65 72 20 61 72 67 75 6d If another argum
05b0: 65 6e 74 0a 2e 5c 22 09 69 73 20 70 72 65 73 65 ent..\".is prese
05c0: 6e 74 2c 20 74 68 65 6e 20 61 20 6c 69 6e 65 20 nt, then a line
05d0: 62 72 65 61 6b 20 69 73 20 66 6f 72 63 65 64 20 break is forced
05e0: 62 65 66 6f 72 65 20 73 74 61 72 74 69 6e 67 20 before starting
05f0: 74 68 65 20 73 69 64 65 62 61 72 2e 0a 2e 5c 22 the sidebar...\"
0600: 0a 2e 5c 22 20 2e 56 45 0a 2e 5c 22 09 45 6e 64 ..\" .VE..\".End
0610: 20 6f 66 20 76 65 72 74 69 63 61 6c 20 73 69 64 of vertical sid
0620: 65 62 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 ebar...\"..\" .D
0630: 53 0a 2e 5c 22 09 42 65 67 69 6e 20 61 6e 20 69 S..\".Begin an i
0640: 6e 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 ndented unfilled
0650: 20 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c display...\"..\
0660: 22 20 2e 44 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 " .DE..\".End of
0670: 20 69 6e 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c indented unfill
0680: 65 64 20 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a ed display...\".
0690: 2e 5c 22 20 2e 53 4f 20 3f 6d 61 6e 70 61 67 65 .\" .SO ?manpage
06a0: 3f 0a 2e 5c 22 09 53 74 61 72 74 20 6f 66 20 6c ?..\".Start of l
06b0: 69 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 ist of standard
06c0: 6f 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b options for a Tk
06d0: 20 77 69 64 67 65 74 2e 20 54 68 65 20 6d 61 6e widget. The man
06e0: 70 61 67 65 0a 2e 5c 22 09 61 72 67 75 6d 65 6e page..\".argumen
06f0: 74 20 64 65 66 69 6e 65 73 20 77 68 65 72 65 20 t defines where
0700: 74 6f 20 6c 6f 6f 6b 20 75 70 20 74 68 65 20 73 to look up the s
0710: 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 3b tandard options;
0720: 20 69 66 0a 2e 5c 22 09 6f 6d 69 74 74 65 64 2c if..\".omitted,
0730: 20 64 65 66 61 75 6c 74 73 20 74 6f 20 22 6f 70 defaults to "op
0740: 74 69 6f 6e 73 22 2e 20 54 68 65 20 6f 70 74 69 tions". The opti
0750: 6f 6e 73 20 66 6f 6c 6c 6f 77 20 6f 6e 20 73 75 ons follow on su
0760: 63 63 65 73 73 69 76 65 0a 2e 5c 22 09 6c 69 6e ccessive..\".lin
0770: 65 73 2c 20 69 6e 20 74 68 72 65 65 20 63 6f 6c es, in three col
0780: 75 6d 6e 73 20 73 65 70 61 72 61 74 65 64 20 62 umns separated b
0790: 79 20 74 61 62 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 y tabs...\"..\"
07a0: 2e 53 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 6c .SE..\".End of l
07b0: 69 73 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 ist of standard
07c0: 6f 70 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b options for a Tk
07d0: 20 77 69 64 67 65 74 2e 0a 2e 5c 22 0a 2e 5c 22 widget...\"..\"
07e0: 20 2e 4f 50 20 63 6d 64 4e 61 6d 65 20 64 62 4e .OP cmdName dbN
07f0: 61 6d 65 20 64 62 43 6c 61 73 73 0a 2e 5c 22 09 ame dbClass..\".
0800: 53 74 61 72 74 20 6f 66 20 64 65 73 63 72 69 70 Start of descrip
0810: 74 69 6f 6e 20 6f 66 20 61 20 73 70 65 63 69 66 tion of a specif
0820: 69 63 20 6f 70 74 69 6f 6e 2e 20 20 63 6d 64 4e ic option. cmdN
0830: 61 6d 65 20 67 69 76 65 73 20 74 68 65 0a 2e 5c ame gives the..\
0840: 22 09 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65 20 ".option's name
0850: 61 73 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 as specified in
0860: 74 68 65 20 63 6c 61 73 73 20 63 6f 6d 6d 61 6e the class comman
0870: 64 2c 20 64 62 4e 61 6d 65 20 67 69 76 65 73 0a d, dbName gives.
0880: 2e 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 .\".the option's
0890: 20 6e 61 6d 65 20 69 6e 20 74 68 65 20 6f 70 74 name in the opt
08a0: 69 6f 6e 20 64 61 74 61 62 61 73 65 2c 20 61 6e ion database, an
08b0: 64 20 64 62 43 6c 61 73 73 20 67 69 76 65 73 0a d dbClass gives.
08c0: 2e 5c 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 .\".the option's
08d0: 20 63 6c 61 73 73 20 69 6e 20 74 68 65 20 6f 70 class in the op
08e0: 74 69 6f 6e 20 64 61 74 61 62 61 73 65 2e 0a 2e tion database...
08f0: 5c 22 0a 2e 5c 22 20 2e 55 4c 20 61 72 67 31 20 \"..\" .UL arg1
0900: 61 72 67 32 0a 2e 5c 22 09 50 72 69 6e 74 20 61 arg2..\".Print a
0910: 72 67 31 20 75 6e 64 65 72 6c 69 6e 65 64 2c 20 rg1 underlined,
0920: 74 68 65 6e 20 70 72 69 6e 74 20 61 72 67 32 20 then print arg2
0930: 6e 6f 72 6d 61 6c 6c 79 2e 0a 2e 5c 22 0a 2e 5c normally...\"..\
0940: 22 20 2e 51 57 20 61 72 67 31 20 3f 61 72 67 32 " .QW arg1 ?arg2
0950: 3f 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 31 ?..\".Print arg1
0960: 20 69 6e 20 71 75 6f 74 65 73 2c 20 74 68 65 6e in quotes, then
0970: 20 61 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 20 28 arg2 normally (
0980: 66 6f 72 20 74 72 61 69 6c 69 6e 67 20 70 75 6e for trailing pun
0990: 63 74 75 61 74 69 6f 6e 29 2e 0a 2e 5c 22 0a 2e ctuation)...\"..
09a0: 5c 22 20 2e 50 51 20 61 72 67 31 20 3f 61 72 67 \" .PQ arg1 ?arg
09b0: 32 3f 0a 2e 5c 22 09 50 72 69 6e 74 20 61 6e 20 2?..\".Print an
09c0: 6f 70 65 6e 20 70 61 72 65 6e 74 68 65 73 69 73 open parenthesis
09d0: 2c 20 61 72 67 31 20 69 6e 20 71 75 6f 74 65 73 , arg1 in quotes
09e0: 2c 20 74 68 65 6e 20 61 72 67 32 20 6e 6f 72 6d , then arg2 norm
09f0: 61 6c 6c 79 0a 2e 5c 22 09 28 66 6f 72 20 74 72 ally..\".(for tr
0a00: 61 69 6c 69 6e 67 20 70 75 6e 63 74 75 61 74 69 ailing punctuati
0a10: 6f 6e 29 20 61 6e 64 20 74 68 65 6e 20 61 20 63 on) and then a c
0a20: 6c 6f 73 69 6e 67 20 70 61 72 65 6e 74 68 65 73 losing parenthes
0a30: 69 73 2e 0a 2e 5c 22 0a 2e 5c 22 09 23 20 53 65 is...\"..\".# Se
0a40: 74 20 75 70 20 74 72 61 70 73 20 61 6e 64 20 6f t up traps and o
0a50: 74 68 65 72 20 6d 69 73 63 65 6c 6c 61 6e 65 6f ther miscellaneo
0a60: 75 73 20 73 74 75 66 66 20 66 6f 72 20 54 63 6c us stuff for Tcl
0a70: 2f 54 6b 20 6d 61 6e 20 70 61 67 65 73 2e 0a 2e /Tk man pages...
0a80: 69 66 20 74 20 2e 77 68 20 2d 31 2e 33 69 20 5e if t .wh -1.3i ^
0a90: 42 0a 2e 6e 72 20 5e 6c 20 5c 6e 28 2e 6c 0a 2e B..nr ^l \n(.l..
0aa0: 61 64 20 62 0a 2e 5c 22 09 23 20 53 74 61 72 74 ad b..\".# Start
0ab0: 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 64 65 73 an argument des
0ac0: 63 72 69 70 74 69 6f 6e 0a 2e 64 65 20 41 50 0a cription..de AP.
0ad0: 2e 69 65 20 21 22 5c 5c 24 34 22 22 20 2e 54 50 .ie !"\\$4"" .TP
0ae0: 20 5c 5c 24 34 0a 2e 65 6c 20 5c 7b 5c 0a 2e 20 \\$4..el \{\..
0af0: 20 20 69 65 20 21 22 5c 5c 24 32 22 22 20 2e 54 ie !"\\$2"" .T
0b00: 50 20 5c 5c 6e 28 29 43 75 0a 2e 20 20 20 65 6c P \\n()Cu.. el
0b10: 20 20 20 20 20 20 20 20 20 20 2e 54 50 20 31 35 .TP 15
0b20: 0a 2e 5c 7d 0a 2e 74 61 20 5c 5c 6e 28 29 41 75 ..\}..ta \\n()Au
0b30: 20 5c 5c 6e 28 29 42 75 0a 2e 69 65 20 21 22 5c \\n()Bu..ie !"\
0b40: 5c 24 33 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 \$3"" \{\.\&\\$1
0b50: 20 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 20 28 5c \\fI\\$2\\fP (\
0b60: 5c 24 33 29 0a 2e 5c 22 2e 62 0a 2e 5c 7d 0a 2e \$3)..\".b..\}..
0b70: 65 6c 20 5c 7b 5c 0a 2e 62 72 0a 2e 69 65 20 21 el \{\..br..ie !
0b80: 22 5c 5c 24 32 22 22 20 5c 7b 5c 0a 5c 26 5c 5c "\\$2"" \{\.\&\\
0b90: 24 31 09 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 0a $1.\\fI\\$2\\fP.
0ba0: 2e 5c 7d 0a 2e 65 6c 20 5c 7b 5c 0a 5c 26 5c 5c .\}..el \{\.\&\\
0bb0: 66 49 5c 5c 24 31 5c 5c 66 50 0a 2e 5c 7d 0a 2e fI\\$1\\fP..\}..
0bc0: 5c 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 64 65 66 69 \}.....\".# defi
0bd0: 6e 65 20 74 61 62 62 69 6e 67 20 76 61 6c 75 65 ne tabbing value
0be0: 73 20 66 6f 72 20 2e 41 50 0a 2e 64 65 20 41 53 s for .AP..de AS
0bf0: 0a 2e 6e 72 20 29 41 20 31 30 6e 0a 2e 69 66 20 ..nr )A 10n..if
0c00: 21 22 5c 5c 24 31 22 22 20 2e 6e 72 20 29 41 20 !"\\$1"" .nr )A
0c10: 5c 5c 77 27 5c 5c 24 31 27 75 2b 33 6e 0a 2e 6e \\w'\\$1'u+3n..n
0c20: 72 20 29 42 20 5c 5c 6e 28 29 41 75 2b 31 35 6e r )B \\n()Au+15n
0c30: 0a 2e 5c 22 0a 2e 69 66 20 21 22 5c 5c 24 32 22 ..\"..if !"\\$2"
0c40: 22 20 2e 6e 72 20 29 42 20 5c 5c 77 27 5c 5c 24 " .nr )B \\w'\\$
0c50: 32 27 75 2b 5c 5c 6e 28 29 41 75 2b 33 6e 0a 2e 2'u+\\n()Au+3n..
0c60: 6e 72 20 29 43 20 5c 5c 6e 28 29 42 75 2b 5c 5c nr )C \\n()Bu+\\
0c70: 77 27 28 69 6e 2f 6f 75 74 29 27 75 2b 32 6e 0a w'(in/out)'u+2n.
0c80: 2e 2e 0a 2e 41 53 20 54 63 6c 5f 49 6e 74 65 72 ....AS Tcl_Inter
0c90: 70 20 54 63 6c 5f 43 72 65 61 74 65 49 6e 74 65 p Tcl_CreateInte
0ca0: 72 70 20 69 6e 2f 6f 75 74 0a 2e 5c 22 09 23 20 rp in/out..\".#
0cb0: 42 53 20 2d 20 73 74 61 72 74 20 62 6f 78 65 64 BS - start boxed
0cc0: 20 74 65 78 74 0a 2e 5c 22 09 23 20 5e 79 20 3d text..\".# ^y =
0cd0: 20 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 starting y loca
0ce0: 74 69 6f 6e 0a 2e 5c 22 09 23 20 5e 62 20 3d 20 tion..\".# ^b =
0cf0: 31 0a 2e 64 65 20 42 53 0a 2e 62 72 0a 2e 6d 6b 1..de BS..br..mk
0d00: 20 5e 79 0a 2e 6e 72 20 5e 62 20 31 75 0a 2e 69 ^y..nr ^b 1u..i
0d10: 66 20 6e 20 2e 6e 66 0a 2e 69 66 20 6e 20 2e 74 f n .nf..if n .t
0d20: 69 20 30 0a 2e 69 66 20 6e 20 5c 6c 27 5c 5c 6e i 0..if n \l'\\n
0d30: 28 2e 6c 75 5c 28 75 6c 27 0a 2e 69 66 20 6e 20 (.lu\(ul'..if n
0d40: 2e 66 69 0a 2e 2e 0a 2e 5c 22 09 23 20 42 45 20 .fi.....\".# BE
0d50: 2d 20 65 6e 64 20 62 6f 78 65 64 20 74 65 78 74 - end boxed text
0d60: 20 28 64 72 61 77 20 62 6f 78 20 6e 6f 77 29 0a (draw box now).
0d70: 2e 64 65 20 42 45 0a 2e 6e 66 0a 2e 74 69 20 30 .de BE..nf..ti 0
0d80: 0a 2e 6d 6b 20 5e 74 0a 2e 69 65 20 6e 20 5c 6c ..mk ^t..ie n \l
0d90: 27 5c 5c 6e 28 5e 6c 75 5c 28 75 6c 27 0a 2e 65 '\\n(^lu\(ul'..e
0da0: 6c 20 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 66 l \{\..\".Draw f
0db0: 6f 75 72 2d 73 69 64 65 64 20 62 6f 78 20 6e 6f our-sided box no
0dc0: 72 6d 61 6c 6c 79 2c 20 62 75 74 20 64 6f 6e 27 rmally, but don'
0dd0: 74 20 64 72 61 77 20 74 6f 70 20 6f 66 0a 2e 5c t draw top of..\
0de0: 22 09 62 6f 78 20 69 66 20 74 68 65 20 62 6f 78 ".box if the box
0df0: 20 73 74 61 72 74 65 64 20 6f 6e 20 61 6e 20 65 started on an e
0e00: 61 72 6c 69 65 72 20 70 61 67 65 2e 0a 2e 69 65 arlier page...ie
0e10: 20 21 5c 5c 6e 28 5e 62 2d 31 20 5c 7b 5c 0a 5c !\\n(^b-1 \{\.\
0e20: 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 h'-1.5n'\L'|\\n(
0e30: 5e 79 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28 5e 6c ^yu-1v'\l'\\n(^l
0e40: 75 2b 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c 6e 28 u+3n\(ul'\L'\\n(
0e50: 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c ^tu+1v-\\n(^yu'\
0e60: 6c 27 7c 30 75 2d 31 2e 35 6e 5c 28 75 6c 27 0a l'|0u-1.5n\(ul'.
0e70: 2e 5c 7d 0a 2e 65 6c 20 5c 7d 5c 0a 5c 68 27 2d .\}..el \}\.\h'-
0e80: 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 1.5n'\L'|\\n(^yu
0e90: 2d 31 76 27 5c 68 27 5c 5c 6e 28 5e 6c 75 2b 33 -1v'\h'\\n(^lu+3
0ea0: 6e 27 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d n'\L'\\n(^tu+1v-
0eb0: 5c 5c 6e 28 5e 79 75 27 5c 6c 27 7c 30 75 2d 31 \\n(^yu'\l'|0u-1
0ec0: 2e 35 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e 5c 7d .5n\(ul'..\}..\}
0ed0: 0a 2e 66 69 0a 2e 62 72 0a 2e 6e 72 20 5e 62 20 ..fi..br..nr ^b
0ee0: 30 0a 2e 2e 0a 2e 5c 22 09 23 20 56 53 20 2d 20 0.....\".# VS -
0ef0: 73 74 61 72 74 20 76 65 72 74 69 63 61 6c 20 73 start vertical s
0f00: 69 64 65 62 61 72 0a 2e 5c 22 09 23 20 5e 59 20 idebar..\".# ^Y
0f10: 3d 20 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 = starting y loc
0f20: 61 74 69 6f 6e 0a 2e 5c 22 09 23 20 5e 76 20 3d ation..\".# ^v =
0f30: 20 31 20 28 66 6f 72 20 74 72 6f 66 66 3b 20 20 1 (for troff;
0f40: 66 6f 72 20 6e 72 6f 66 66 20 74 68 69 73 20 64 for nroff this d
0f50: 6f 65 73 6e 27 74 20 6d 61 74 74 65 72 29 0a 2e oesn't matter)..
0f60: 64 65 20 56 53 0a 2e 69 66 20 21 22 5c 5c 24 32 de VS..if !"\\$2
0f70: 22 22 20 2e 62 72 0a 2e 6d 6b 20 5e 59 0a 2e 69 "" .br..mk ^Y..i
0f80: 65 20 6e 20 27 6d 63 20 5c 73 31 32 5c 28 62 72 e n 'mc \s12\(br
0f90: 5c 73 30 0a 2e 65 6c 20 2e 6e 72 20 5e 76 20 31 \s0..el .nr ^v 1
0fa0: 75 0a 2e 2e 0a 2e 5c 22 09 23 20 56 45 20 2d 20 u.....\".# VE -
0fb0: 65 6e 64 20 6f 66 20 76 65 72 74 69 63 61 6c 20 end of vertical
0fc0: 73 69 64 65 62 61 72 0a 2e 64 65 20 56 45 0a 2e sidebar..de VE..
0fd0: 69 65 20 6e 20 27 6d 63 0a 2e 65 6c 20 5c 7b 5c ie n 'mc..el \{\
0fe0: 0a 2e 65 76 20 32 0a 2e 6e 66 0a 2e 74 69 20 30 ..ev 2..nf..ti 0
0ff0: 0a 2e 6d 6b 20 5e 74 0a 5c 68 27 7c 5c 5c 6e 28 ..mk ^t.\h'|\\n(
1000: 5e 6c 75 2b 33 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e ^lu+3n'\L'|\\n(^
1010: 59 75 2d 31 76 5c 28 62 76 27 5c 76 27 5c 5c 6e Yu-1v\(bv'\v'\\n
1020: 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59 75 27 (^tu+1v-\\n(^Yu'
1030: 5c 68 27 2d 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 \h'-|\\n(^lu+3n'
1040: 0a 2e 73 70 20 2d 31 0a 2e 66 69 0a 2e 65 76 0a ..sp -1..fi..ev.
1050: 2e 5c 7d 0a 2e 6e 72 20 5e 76 20 30 0a 2e 2e 0a .\}..nr ^v 0....
1060: 2e 5c 22 09 23 20 53 70 65 63 69 61 6c 20 6d 61 .\".# Special ma
1070: 63 72 6f 20 74 6f 20 68 61 6e 64 6c 65 20 70 61 cro to handle pa
1080: 67 65 20 62 6f 74 74 6f 6d 3a 20 20 66 69 6e 69 ge bottom: fini
1090: 73 68 20 6f 66 66 20 63 75 72 72 65 6e 74 0a 2e sh off current..
10a0: 5c 22 09 23 20 62 6f 78 2f 73 69 64 65 62 61 72 \".# box/sidebar
10b0: 20 69 66 20 69 6e 20 62 6f 78 2f 73 69 64 65 62 if in box/sideb
10c0: 61 72 20 6d 6f 64 65 2c 20 74 68 65 6e 20 69 6e ar mode, then in
10d0: 76 6f 6b 65 64 20 73 74 61 6e 64 61 72 64 0a 2e voked standard..
10e0: 5c 22 09 23 20 70 61 67 65 20 62 6f 74 74 6f 6d \".# page bottom
10f0: 20 6d 61 63 72 6f 2e 0a 2e 64 65 20 5e 42 0a 2e macro...de ^B..
1100: 65 76 20 32 0a 27 74 69 20 30 0a 27 6e 66 0a 2e ev 2.'ti 0.'nf..
1110: 6d 6b 20 5e 74 0a 2e 69 66 20 5c 5c 6e 28 5e 62 mk ^t..if \\n(^b
1120: 20 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 74 68 \{\..\".Draw th
1130: 72 65 65 2d 73 69 64 65 64 20 62 6f 78 20 69 66 ree-sided box if
1140: 20 74 68 69 73 20 69 73 20 74 68 65 20 62 6f 78 this is the box
1150: 27 73 20 66 69 72 73 74 20 70 61 67 65 2c 0a 2e 's first page,..
1160: 5c 22 09 64 72 61 77 20 74 77 6f 20 73 69 64 65 \".draw two side
1170: 73 20 62 75 74 20 6e 6f 20 74 6f 70 20 6f 74 68 s but no top oth
1180: 65 72 77 69 73 65 2e 0a 2e 69 65 20 21 5c 5c 6e erwise...ie !\\n
1190: 28 5e 62 2d 31 20 5c 68 27 2d 31 2e 35 6e 27 5c (^b-1 \h'-1.5n'\
11a0: 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 6c L'|\\n(^yu-1v'\l
11b0: 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 5c 28 75 6c 27 '\\n(^lu+3n\(ul'
11c0: 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c \L'\\n(^tu+1v-\\
11d0: 6e 28 5e 79 75 27 5c 68 27 7c 30 75 27 5c 63 0a n(^yu'\h'|0u'\c.
11e0: 2e 65 6c 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 .el \h'-1.5n'\L'
11f0: 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 68 27 5c |\\n(^yu-1v'\h'\
1200: 5c 6e 28 5e 6c 75 2b 33 6e 27 5c 4c 27 5c 5c 6e \n(^lu+3n'\L'\\n
1210: 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 (^tu+1v-\\n(^yu'
1220: 5c 68 27 7c 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 69 \h'|0u'\c..\}..i
1230: 66 20 5c 5c 6e 28 5e 76 20 5c 7b 5c 0a 2e 6e 72 f \\n(^v \{\..nr
1240: 20 5e 78 20 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c ^x \\n(^tu+1v-\
1250: 5c 6e 28 5e 59 75 0a 5c 6b 78 5c 68 27 2d 5c 5c \n(^Yu.\kx\h'-\\
1260: 6e 78 75 27 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b nxu'\h'|\\n(^lu+
1270: 33 6e 27 5c 6b 79 5c 4c 27 2d 5c 5c 6e 28 5e 78 3n'\ky\L'-\\n(^x
1280: 75 27 5c 76 27 5c 5c 6e 28 5e 78 75 27 5c 68 27 u'\v'\\n(^xu'\h'
1290: 7c 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 62 70 0a 27 |0u'\c..\}..bp.'
12a0: 66 69 0a 2e 65 76 0a 2e 69 66 20 5c 5c 6e 28 5e fi..ev..if \\n(^
12b0: 62 20 5c 7b 5c 0a 2e 6d 6b 20 5e 79 0a 2e 6e 72 b \{\..mk ^y..nr
12c0: 20 5e 62 20 32 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c ^b 2..\}..if \\
12d0: 6e 28 5e 76 20 5c 7b 5c 0a 2e 6d 6b 20 5e 59 0a n(^v \{\..mk ^Y.
12e0: 2e 5c 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 44 53 20 .\}.....\".# DS
12f0: 2d 20 62 65 67 69 6e 20 64 69 73 70 6c 61 79 0a - begin display.
1300: 2e 64 65 20 44 53 0a 2e 52 53 0a 2e 6e 66 0a 2e .de DS..RS..nf..
1310: 73 70 0a 2e 2e 0a 2e 5c 22 09 23 20 44 45 20 2d sp.....\".# DE -
1320: 20 65 6e 64 20 64 69 73 70 6c 61 79 0a 2e 64 65 end display..de
1330: 20 44 45 0a 2e 66 69 0a 2e 52 45 0a 2e 73 70 0a DE..fi..RE..sp.
1340: 2e 2e 0a 2e 5c 22 09 23 20 53 4f 20 2d 20 73 74 ....\".# SO - st
1350: 61 72 74 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 art of list of s
1360: 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a tandard options.
1370: 2e 64 65 20 53 4f 0a 27 69 65 20 27 5c 5c 24 31 .de SO.'ie '\\$1
1380: 27 27 20 2e 64 73 20 53 6f 20 5c 5c 66 42 6f 70 '' .ds So \\fBop
1390: 74 69 6f 6e 73 5c 5c 66 52 0a 27 65 6c 20 2e 64 tions\\fR.'el .d
13a0: 73 20 53 6f 20 5c 5c 66 42 5c 5c 24 31 5c 5c 66 s So \\fB\\$1\\f
13b0: 52 0a 2e 53 48 20 22 53 54 41 4e 44 41 52 44 20 R..SH "STANDARD
13c0: 4f 50 54 49 4f 4e 53 22 0a 2e 4c 50 0a 2e 6e 66 OPTIONS"..LP..nf
13d0: 0a 2e 74 61 20 35 2e 35 63 20 31 31 63 0a 2e 66 ..ta 5.5c 11c..f
13e0: 74 20 42 0a 2e 2e 0a 2e 5c 22 09 23 20 53 45 20 t B.....\".# SE
13f0: 2d 20 65 6e 64 20 6f 66 20 6c 69 73 74 20 6f 66 - end of list of
1400: 20 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e standard option
1410: 73 0a 2e 64 65 20 53 45 0a 2e 66 69 0a 2e 66 74 s..de SE..fi..ft
1420: 20 52 0a 2e 4c 50 0a 53 65 65 20 74 68 65 20 5c R..LP.See the \
1430: 5c 2a 28 53 6f 20 6d 61 6e 75 61 6c 20 65 6e 74 \*(So manual ent
1440: 72 79 20 66 6f 72 20 64 65 74 61 69 6c 73 20 6f ry for details o
1450: 6e 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6f n the standard o
1460: 70 74 69 6f 6e 73 2e 0a 2e 2e 0a 2e 5c 22 09 23 ptions......\".#
1470: 20 4f 50 20 2d 20 73 74 61 72 74 20 6f 66 20 66 OP - start of f
1480: 75 6c 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 ull description
1490: 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 6f 70 74 for a single opt
14a0: 69 6f 6e 0a 2e 64 65 20 4f 50 0a 2e 4c 50 0a 2e ion..de OP..LP..
14b0: 6e 66 0a 2e 74 61 20 34 63 0a 43 6f 6d 6d 61 6e nf..ta 4c.Comman
14c0: 64 2d 4c 69 6e 65 20 4e 61 6d 65 3a 09 5c 5c 66 d-Line Name:.\\f
14d0: 42 5c 5c 24 31 5c 5c 66 52 0a 44 61 74 61 62 61 B\\$1\\fR.Databa
14e0: 73 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 se Name:.\\fB\\$
14f0: 32 5c 5c 66 52 0a 44 61 74 61 62 61 73 65 20 43 2\\fR.Database C
1500: 6c 61 73 73 3a 09 5c 5c 66 42 5c 5c 24 33 5c 5c lass:.\\fB\\$3\\
1510: 66 52 0a 2e 66 69 0a 2e 49 50 0a 2e 2e 0a 2e 5c fR..fi..IP.....\
1520: 22 09 23 20 43 53 20 2d 20 62 65 67 69 6e 20 63 ".# CS - begin c
1530: 6f 64 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20 ode excerpt..de
1540: 43 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 74 61 20 2e CS..RS..nf..ta .
1550: 32 35 69 20 2e 35 69 20 2e 37 35 69 20 31 69 0a 25i .5i .75i 1i.
1560: 2e 2e 0a 2e 5c 22 09 23 20 43 45 20 2d 20 65 6e ....\".# CE - en
1570: 64 20 63 6f 64 65 20 65 78 63 65 72 70 74 0a 2e d code excerpt..
1580: 64 65 20 43 45 0a 2e 66 69 0a 2e 52 45 0a 2e 2e de CE..fi..RE...
1590: 0a 2e 5c 22 09 23 20 55 4c 20 2d 20 75 6e 64 65 ..\".# UL - unde
15a0: 72 6c 69 6e 65 20 77 6f 72 64 0a 2e 64 65 20 55 rline word..de U
15b0: 4c 0a 5c 5c 24 31 5c 6c 27 7c 30 5c 28 75 6c 27 L.\\$1\l'|0\(ul'
15c0: 5c 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 51 57 \\$2.....\".# QW
15d0: 20 2d 20 61 70 70 6c 79 20 71 75 6f 74 61 74 69 - apply quotati
15e0: 6f 6e 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 on marks to word
15f0: 0a 2e 64 65 20 51 57 0a 2e 69 65 20 27 5c 5c 2a ..de QW..ie '\\*
1600: 28 6c 71 27 22 27 20 60 60 5c 5c 24 31 27 27 5c (lq'"' ``\\$1''\
1610: 5c 24 32 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61 \$2..\"" fix ema
1620: 63 73 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a cs highlighting.
1630: 2e 65 6c 20 5c 5c 2a 28 6c 71 5c 5c 24 31 5c 5c .el \\*(lq\\$1\\
1640: 2a 28 72 71 5c 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 *(rq\\$2.....\".
1650: 23 20 50 51 20 2d 20 61 70 70 6c 79 20 70 61 72 # PQ - apply par
1660: 65 6e 73 20 61 6e 64 20 71 75 6f 74 61 74 69 6f ens and quotatio
1670: 6e 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a n marks to word.
1680: 2e 64 65 20 50 51 0a 2e 69 65 20 27 5c 5c 2a 28 .de PQ..ie '\\*(
1690: 6c 71 27 22 27 20 28 60 60 5c 5c 24 31 27 27 5c lq'"' (``\\$1''\
16a0: 5c 24 32 29 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 \$2)\\$3..\"" fi
16b0: 78 20 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 x emacs highligh
16c0: 74 69 6e 67 0a 2e 65 6c 20 28 5c 5c 2a 28 6c 71 ting..el (\\*(lq
16d0: 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c 24 32 29 5c \\$1\\*(rq\\$2)\
16e0: 5c 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 51 52 20 \$3.....\".# QR
16f0: 2d 20 71 75 6f 74 65 64 20 72 61 6e 67 65 0a 2e - quoted range..
1700: 64 65 20 51 52 0a 2e 69 65 20 27 5c 5c 2a 28 6c de QR..ie '\\*(l
1710: 71 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c 2d q'"' ``\\$1''\\-
1720: 60 60 5c 5c 24 32 27 27 5c 5c 24 33 0a 2e 5c 22 ``\\$2''\\$3..\"
1730: 22 20 66 69 78 20 65 6d 61 63 73 20 68 69 67 68 " fix emacs high
1740: 6c 69 67 68 74 69 6e 67 0a 2e 65 6c 20 5c 5c 2a lighting..el \\*
1750: 28 6c 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c 2d (lq\\$1\\*(rq\\-
1760: 5c 5c 2a 28 6c 71 5c 5c 24 32 5c 5c 2a 28 72 71 \\*(lq\\$2\\*(rq
1770: 5c 5c 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 4d 54 \\$3.....\".# MT
1780: 20 2d 20 22 65 6d 70 74 79 22 20 73 74 72 69 6e - "empty" strin
1790: 67 0a 2e 64 65 20 4d 54 0a 2e 51 57 20 22 22 0a g..de MT..QW "".
17a0: 2e 2e 0a 2e 42 53 0a 2e 53 48 20 4e 41 4d 45 0a ....BS..SH NAME.
17b0: 74 6c 73 20 5c 2d 20 62 69 6e 64 69 6e 67 20 74 tls \- binding t
17c0: 6f 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 6c 69 o the OpenSSL li
17d0: 62 72 61 72 79 20 66 6f 72 20 65 6e 63 72 79 70 brary for encryp
17e0: 74 65 64 20 73 6f 63 6b 65 74 20 61 6e 64 20 49 ted socket and I
17f0: 2f 4f 20 63 68 61 6e 6e 65 6c 20 63 6f 6d 6d 75 /O channel commu
1800: 6e 69 63 61 74 69 6f 6e 73 0a 2e 53 48 20 53 59 nications..SH SY
1810: 4e 4f 50 53 49 53 0a 70 61 63 6b 61 67 65 20 72 NOPSIS.package r
1820: 65 71 75 69 72 65 20 5c 66 42 54 63 6c 20 38 5c equire \fBTcl 8\
1830: 26 2e 35 2d 5c 66 52 0a 2e 73 70 0a 70 61 63 6b &.5-\fR..sp.pack
1840: 61 67 65 20 72 65 71 75 69 72 65 20 5c 66 42 74 age require \fBt
1850: 6c 73 20 32 5c 26 2e 30 5c 26 2e 31 5c 66 52 0a ls 2\&.0\&.1\fR.
1860: 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 69 6e 69 74 .sp.\fBtls::init
1870: 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c \fR ?\fI-option\
1880: 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 5c 66 52 fR? ?\fIvalue\fR
1890: 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 76 61 ? ?\fI-option va
18a0: 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 lue \&.\&.\&.\fR
18b0: 3f 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 73 6f ?..sp.\fBtls::so
18c0: 63 6b 65 74 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 cket\fR ?\fI-opt
18d0: 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 ion\fR? ?\fIvalu
18e0: 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f e\fR? ?\fI-optio
18f0: 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 n value \&.\&.\&
1900: 2e 5c 66 52 3f 20 5c 66 49 68 6f 73 74 5c 66 52 .\fR? \fIhost\fR
1910: 20 5c 66 49 70 6f 72 74 5c 66 52 0a 2e 73 70 0a \fIport\fR..sp.
1920: 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 \fBtls::socket\f
1930: 52 20 5c 66 42 2d 73 65 72 76 65 72 5c 66 52 20 R \fB-server\fR
1940: 5c 66 49 63 6f 6d 6d 61 6e 64 5c 66 52 20 3f 5c \fIcommand\fR ?\
1950: 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c fI-option\fR? ?\
1960: 66 49 76 61 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 fIvalue\fR? ?\fI
1970: 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 5c 26 -option value \&
1980: 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 20 5c 66 49 70 .\&.\&.\fR? \fIp
1990: 6f 72 74 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 6c ort\fR..sp.\fBtl
19a0: 73 3a 3a 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 s::import\fR \fI
19b0: 63 68 61 6e 6e 65 6c 5c 66 52 20 3f 5c 66 49 2d channel\fR ?\fI-
19c0: 6f 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 option\fR? ?\fIv
19d0: 61 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 alue\fR? ?\fI-op
19e0: 74 69 6f 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 tion value \&.\&
19f0: 2e 5c 26 2e 5c 66 52 3f 0a 2e 73 70 0a 5c 66 42 .\&.\fR?..sp.\fB
1a00: 74 6c 73 3a 3a 73 74 61 72 74 74 6c 73 5c 66 52 tls::starttls\fR
1a10: 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 20 3f \fIchannel\fR ?
1a20: 5c 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 3f 20 3f \fI-option\fR? ?
1a30: 5c 66 49 76 61 6c 75 65 5c 66 52 3f 20 3f 5c 66 \fIvalue\fR? ?\f
1a40: 49 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 5c I-option value \
1a50: 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 2e 73 70 &.\&.\&.\fR?..sp
1a60: 0a 5c 66 42 74 6c 73 3a 3a 68 61 6e 64 73 68 61 .\fBtls::handsha
1a70: 6b 65 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c ke\fR \fIchannel
1a80: 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a \fR..sp.\fBtls::
1a90: 73 68 75 74 64 6f 77 6e 5c 66 52 20 5c 66 49 63 shutdown\fR \fIc
1aa0: 68 61 6e 6e 65 6c 5c 66 52 0a 2e 73 70 0a 5c 66 hannel\fR..sp.\f
1ab0: 42 74 6c 73 3a 3a 75 6e 69 6d 70 6f 72 74 5c 66 Btls::unimport\f
1ac0: 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a R \fIchannel\fR.
1ad0: 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 75 6e 73 74 .sp.\fBtls::unst
1ae0: 61 63 6b 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 ack\fR \fIchanne
1af0: 6c 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a l\fR..sp.\fBtls:
1b00: 3a 73 74 61 74 75 73 5c 66 52 20 3f 5c 66 42 2d :status\fR ?\fB-
1b10: 6c 6f 63 61 6c 5c 66 52 3f 20 5c 66 49 63 68 61 local\fR? \fIcha
1b20: 6e 6e 65 6c 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 nnel\fR..sp.\fBt
1b30: 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f 6e 5c 66 ls::connection\f
1b40: 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a R \fIchannel\fR.
1b50: 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 63 69 70 68 .sp.\fBtls::ciph
1b60: 65 72 73 5c 66 52 20 3f 5c 66 49 70 72 6f 74 6f ers\fR ?\fIproto
1b70: 63 6f 6c 5c 66 52 3f 20 3f 5c 66 49 76 65 72 62 col\fR? ?\fIverb
1b80: 6f 73 65 5c 66 52 3f 20 3f 5c 66 49 73 75 70 70 ose\fR? ?\fIsupp
1b90: 6f 72 74 65 64 5c 66 52 3f 0a 2e 73 70 0a 5c 66 orted\fR?..sp.\f
1ba0: 42 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c Btls::protocols\
1bb0: 66 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 76 fR..sp.\fBtls::v
1bc0: 65 72 73 69 6f 6e 5c 66 52 0a 2e 73 70 0a 2e 42 ersion\fR..sp..B
1bd0: 45 0a 2e 53 48 20 44 45 53 43 52 49 50 54 49 4f E..SH DESCRIPTIO
1be0: 4e 0a 54 68 69 73 20 65 78 74 65 6e 73 69 6f 6e N.This extension
1bf0: 20 70 72 6f 76 69 64 65 73 20 54 43 4c 20 73 63 provides TCL sc
1c00: 72 69 70 74 20 61 63 63 65 73 73 20 74 6f 20 53 ript access to S
1c10: 65 63 75 72 65 20 53 6f 63 6b 65 74 20 4c 61 79 ecure Socket Lay
1c20: 65 72 20 28 53 53 4c 29 0a 63 6f 6d 6d 75 6e 69 er (SSL).communi
1c30: 63 61 74 69 6f 6e 73 20 75 73 69 6e 67 20 74 68 cations using th
1c40: 65 20 54 72 61 6e 73 70 6f 72 74 20 4c 61 79 65 e Transport Laye
1c50: 72 20 53 65 63 75 72 69 74 79 20 28 54 4c 53 29 r Security (TLS)
1c60: 20 70 72 6f 74 6f 63 6f 6c 5c 26 2e 20 49 74 20 protocol\&. It
1c70: 70 72 6f 76 69 64 65 73 20 61 0a 67 65 6e 65 72 provides a.gener
1c80: 69 63 20 62 69 6e 64 69 6e 67 20 74 6f 20 5c 66 ic binding to \f
1c90: 49 4f 70 65 6e 53 53 4c 5c 66 52 20 5b 68 74 74 IOpenSSL\fR [htt
1ca0: 70 73 3a 2f 2f 77 77 77 5c 26 2e 6f 70 65 6e 73 ps://www\&.opens
1cb0: 73 6c 5c 26 2e 6f 72 67 2f 5d 2c 20 75 74 69 6c sl\&.org/], util
1cc0: 69 7a 69 6e 67 20 74 68 65 0a 5c 66 42 54 63 6c izing the.\fBTcl
1cd0: 5f 53 74 61 63 6b 43 68 61 6e 6e 65 6c 5c 66 52 _StackChannel\fR
1ce0: 20 41 50 49 20 69 6e 20 54 43 4c 20 38 5c 26 2e API in TCL 8\&.
1cf0: 34 20 6f 72 20 6c 61 74 65 72 5c 26 2e 20 54 68 4 or later\&. Th
1d00: 65 73 65 20 73 6f 63 6b 65 74 73 20 62 65 68 61 ese sockets beha
1d10: 76 65 20 65 78 61 63 74 6c 79 0a 74 68 65 20 73 ve exactly.the s
1d20: 61 6d 65 20 61 73 20 63 68 61 6e 6e 65 6c 73 20 ame as channels
1d30: 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 created using th
1d40: 65 20 62 75 69 6c 74 2d 69 6e 20 5c 66 42 73 6f e built-in \fBso
1d50: 63 6b 65 74 5c 66 52 20 63 6f 6d 6d 61 6e 64 2c cket\fR command,
1d60: 20 62 75 74 0a 70 72 6f 76 69 64 65 20 61 64 64 but.provide add
1d70: 69 74 69 6f 6e 61 6c 20 6f 70 74 69 6f 6e 73 20 itional options
1d80: 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 for controlling
1d90: 74 68 65 20 53 53 4c 2f 54 4c 53 20 73 65 73 73 the SSL/TLS sess
1da0: 69 6f 6e 5c 26 2e 0a 2e 53 48 20 43 4f 4d 50 41 ion\&...SH COMPA
1db0: 54 49 42 49 4c 49 54 59 0a 54 68 69 73 20 65 78 TIBILITY.This ex
1dc0: 74 65 6e 73 69 6f 6e 20 69 73 20 63 6f 6d 70 61 tension is compa
1dd0: 74 69 62 6c 65 20 77 69 74 68 20 4f 70 65 6e 53 tible with OpenS
1de0: 53 4c 20 31 5c 26 2e 31 5c 26 2e 31 20 6f 72 20 SL 1\&.1\&.1 or
1df0: 6c 61 74 65 72 20 69 6e 63 6c 75 64 69 6e 67 20 later including
1e00: 74 68 65 20 33 5c 26 2e 78 20 61 6e 64 20 34 5c the 3\&.x and 4\
1e10: 26 2e 30 0a 72 65 6c 65 61 73 65 73 5c 26 2e 20 &.0.releases\&.
1e20: 49 74 20 72 65 71 75 69 72 65 73 20 54 63 6c 20 It requires Tcl
1e30: 76 65 72 73 69 6f 6e 20 38 5c 26 2e 35 20 6f 72 version 8\&.5 or
1e40: 20 6c 61 74 65 72 20 61 6e 64 20 77 69 6c 6c 20 later and will
1e50: 77 6f 72 6b 20 77 69 74 68 20 54 63 6c 20 39 5c work with Tcl 9\
1e60: 26 2e 30 5c 26 2e 0a 2e 53 48 20 43 4f 4d 4d 41 &.0\&...SH COMMA
1e70: 4e 44 53 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e NDS.The followin
1e80: 67 20 61 72 65 20 74 68 65 20 63 6f 6d 6d 61 6e g are the comman
1e90: 64 73 20 70 72 6f 76 69 64 65 64 20 62 79 20 74 ds provided by t
1ea0: 68 65 20 54 63 4c 54 4c 53 20 70 61 63 6b 61 67 he TcLTLS packag
1eb0: 65 5c 26 2e 20 53 65 65 0a 5c 66 42 45 78 61 6d e\&. See.\fBExam
1ec0: 70 6c 65 73 5c 66 52 20 66 6f 72 20 65 78 61 6d ples\fR for exam
1ed0: 70 6c 65 20 75 73 61 67 65 20 61 6e 64 20 74 68 ple usage and th
1ee0: 65 20 22 5c 66 49 64 65 6d 6f 73 5c 66 52 22 20 e "\fIdemos\fR"
1ef0: 64 69 72 65 63 74 6f 72 79 20 66 6f 72 0a 6d 6f directory for.mo
1f00: 72 65 20 65 78 61 6d 70 6c 65 20 75 73 61 67 65 re example usage
1f10: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a \&...TP.\fBtls::
1f20: 69 6e 69 74 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 init\fR ?\fI-opt
1f30: 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 ion\fR? ?\fIvalu
1f40: 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f e\fR? ?\fI-optio
1f50: 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 n value \&.\&.\&
1f60: 2e 5c 66 52 3f 0a 4f 70 74 69 6f 6e 61 6c 20 66 .\fR?.Optional f
1f70: 75 6e 63 74 69 6f 6e 20 74 6f 20 73 65 74 20 74 unction to set t
1f80: 68 65 20 64 65 66 61 75 6c 74 20 6f 70 74 69 6f he default optio
1f90: 6e 73 20 75 73 65 64 20 62 79 20 5c 66 42 74 6c ns used by \fBtl
1fa0: 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 5c 26 2e 20 s::socket\fR\&.
1fb0: 49 66 20 79 6f 75 0a 63 61 6c 6c 20 5c 66 42 74 If you.call \fBt
1fc0: 6c 73 3a 3a 69 6d 70 6f 72 74 5c 66 52 20 64 69 ls::import\fR di
1fd0: 72 65 63 74 6c 79 2c 20 74 68 65 20 76 61 6c 75 rectly, the valu
1fe0: 65 73 20 73 65 74 20 62 79 20 74 68 69 73 20 63 es set by this c
1ff0: 6f 6d 6d 61 6e 64 20 68 61 76 65 20 6e 6f 20 65 ommand have no e
2000: 66 66 65 63 74 5c 26 2e 0a 54 68 69 73 20 63 6f ffect\&..This co
2010: 6d 6d 61 6e 64 20 73 75 70 70 6f 72 74 73 20 61 mmand supports a
2020: 6c 6c 20 6f 66 20 74 68 65 20 73 61 6d 65 20 6f ll of the same o
2030: 70 74 69 6f 6e 73 20 61 73 20 74 68 65 20 5c 66 ptions as the \f
2040: 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 20 Btls::socket\fR
2050: 63 6f 6d 6d 61 6e 64 2c 0a 74 68 6f 75 67 68 20 command,.though
2060: 79 6f 75 20 73 68 6f 75 6c 64 20 6c 69 6d 69 74 you should limit
2070: 20 79 6f 75 72 20 6f 70 74 69 6f 6e 73 20 74 6f your options to
2080: 20 6f 6e 6c 79 20 74 68 65 20 54 4c 53 20 72 65 only the TLS re
2090: 6c 61 74 65 64 20 6f 6e 65 73 5c 26 2e 0a 2e 54 lated ones\&...T
20a0: 50 0a 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 P.\fBtls::socket
20b0: 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c \fR ?\fI-option\
20c0: 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 5c 66 52 fR? ?\fIvalue\fR
20d0: 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 76 61 ? ?\fI-option va
20e0: 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 lue \&.\&.\&.\fR
20f0: 3f 20 5c 66 49 68 6f 73 74 5c 66 52 20 5c 66 49 ? \fIhost\fR \fI
2100: 70 6f 72 74 5c 66 52 0a 54 68 69 73 20 69 73 20 port\fR.This is
2110: 61 20 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f a helper functio
2120: 6e 20 74 68 61 74 20 75 74 69 6c 69 7a 65 73 20 n that utilizes
2130: 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 63 the underlying c
2140: 6f 6d 6d 61 6e 64 73 20 5c 66 42 73 6f 63 6b 65 ommands \fBsocke
2150: 74 5c 66 52 0a 61 6e 64 20 5c 66 42 74 6c 73 3a t\fR.and \fBtls:
2160: 3a 69 6d 70 6f 72 74 5c 66 52 20 74 6f 20 63 72 :import\fR to cr
2170: 65 61 74 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 eate the connect
2180: 69 6f 6e 5c 26 2e 20 49 74 20 62 65 68 61 76 65 ion\&. It behave
2190: 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 s the same as th
21a0: 65 0a 6e 61 74 69 76 65 20 54 43 4c 20 5c 66 42 e.native TCL \fB
21b0: 73 6f 63 6b 65 74 5c 66 52 20 63 6f 6d 6d 61 6e socket\fR comman
21c0: 64 2c 20 62 75 74 20 61 6c 73 6f 20 73 75 70 70 d, but also supp
21d0: 6f 72 74 73 20 74 68 65 20 5c 66 42 74 6c 73 3a orts the \fBtls:
21e0: 3a 69 6d 70 6f 72 74 5c 66 52 0a 63 6f 6d 6d 61 :import\fR.comma
21f0: 6e 64 20 6f 70 74 69 6f 6e 73 20 77 69 74 68 20 nd options with
2200: 6f 6e 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f one additional o
2210: 70 74 69 6f 6e 5c 26 2e 20 49 74 20 72 65 74 75 ption\&. It retu
2220: 72 6e 73 20 74 68 65 20 63 68 61 6e 6e 65 6c 20 rns the channel
2230: 68 61 6e 64 6c 65 20 69 64 0a 66 6f 72 20 74 68 handle id.for th
2240: 65 20 6e 65 77 20 73 6f 63 6b 65 74 5c 26 2e 20 e new socket\&.
2250: 41 64 64 69 74 69 6f 6e 61 6c 20 6f 70 74 69 6f Additional optio
2260: 6e 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a ns are:..RS..TP.
2270: 5c 66 42 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 \fB-autoserverna
2280: 6d 65 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 me\fR \fIbool\fR
2290: 0a 49 66 20 5c 66 42 74 72 75 65 5c 66 52 2c 20 .If \fBtrue\fR,
22a0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 73 65 automatically se
22b0: 74 20 74 68 65 20 5c 66 42 2d 73 65 72 76 65 72 t the \fB-server
22c0: 6e 61 6d 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 name\fR argument
22d0: 20 74 6f 20 74 68 65 0a 5c 66 49 68 6f 73 74 5c to the.\fIhost\
22e0: 66 52 20 61 72 67 75 6d 65 6e 74 5c 26 2e 20 50 fR argument\&. P
22f0: 72 69 6f 72 20 74 6f 20 54 63 6c 54 4c 53 20 32 rior to TclTLS 2
2300: 5c 26 2e 30 2c 20 74 68 65 20 64 65 66 61 75 6c \&.0, the defaul
2310: 74 20 69 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 t is \fBfalse\fR
2320: 5c 26 2e 0a 53 74 61 72 74 69 6e 67 20 69 6e 20 \&..Starting in
2330: 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 74 68 TclTLS 2\&.0, th
2340: 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c 66 42 e default is \fB
2350: 74 72 75 65 5c 66 52 20 75 6e 6c 65 73 73 20 5c true\fR unless \
2360: 66 42 2d 73 65 72 76 65 72 6e 61 6d 65 5c 66 52 fB-servername\fR
2370: 0a 69 73 20 61 6c 73 6f 20 73 70 65 63 69 66 69 .is also specifi
2380: 65 64 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c 66 ed\&...RE..TP.\f
2390: 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 20 Btls::socket\fR
23a0: 5c 66 42 2d 73 65 72 76 65 72 5c 66 52 20 5c 66 \fB-server\fR \f
23b0: 49 63 6f 6d 6d 61 6e 64 5c 66 52 20 3f 5c 66 49 Icommand\fR ?\fI
23c0: 2d 6f 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 -option\fR? ?\fI
23d0: 76 61 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f value\fR? ?\fI-o
23e0: 70 74 69 6f 6e 20 76 61 6c 75 65 20 5c 26 2e 5c ption value \&.\
23f0: 26 2e 5c 26 2e 5c 66 52 3f 20 5c 66 49 70 6f 72 &.\&.\fR? \fIpor
2400: 74 5c 66 52 0a 53 61 6d 65 20 61 73 20 70 72 65 t\fR.Same as pre
2410: 76 69 6f 75 73 20 63 6f 6d 6d 61 6e 64 2c 20 62 vious command, b
2420: 75 74 20 69 6e 73 74 65 61 64 20 63 72 65 61 74 ut instead creat
2430: 65 73 20 61 20 73 65 72 76 65 72 20 73 6f 63 6b es a server sock
2440: 65 74 20 66 6f 72 20 63 6c 69 65 6e 74 73 20 74 et for clients t
2450: 6f 0a 63 6f 6e 6e 65 63 74 20 74 6f 20 6a 75 73 o.connect to jus
2460: 74 20 6c 69 6b 65 20 74 68 65 20 54 63 6c 20 5c t like the Tcl \
2470: 66 42 73 6f 63 6b 65 74 20 2d 73 65 72 76 65 72 fBsocket -server
2480: 5c 66 52 20 63 6f 6d 6d 61 6e 64 5c 26 2e 20 49 \fR command\&. I
2490: 74 20 72 65 74 75 72 6e 73 20 74 68 65 0a 63 68 t returns the.ch
24a0: 61 6e 6e 65 6c 20 68 61 6e 64 6c 65 20 69 64 20 annel handle id
24b0: 66 6f 72 20 74 68 65 20 6e 65 77 20 73 6f 63 6b for the new sock
24c0: 65 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 et\&...TP.\fBtls
24d0: 3a 3a 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 63 ::import\fR \fIc
24e0: 68 61 6e 6e 65 6c 5c 66 52 20 3f 5c 66 49 2d 6f hannel\fR ?\fI-o
24f0: 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 ption\fR? ?\fIva
2500: 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 lue\fR? ?\fI-opt
2510: 69 6f 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e ion value \&.\&.
2520: 5c 26 2e 5c 66 52 3f 0a 2e 54 50 0a 5c 66 42 74 \&.\fR?..TP.\fBt
2530: 6c 73 3a 3a 73 74 61 72 74 74 6c 73 5c 66 52 20 ls::starttls\fR
2540: 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 20 3f 5c \fIchannel\fR ?\
2550: 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c fI-option\fR? ?\
2560: 66 49 76 61 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 fIvalue\fR? ?\fI
2570: 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 5c 26 -option value \&
2580: 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 53 74 61 72 .\&.\&.\fR?.Star
2590: 74 20 54 4c 53 20 65 6e 63 72 79 70 74 69 6f 6e t TLS encryption
25a0: 20 6f 6e 20 54 43 4c 20 63 68 61 6e 6e 65 6c 20 on TCL channel
25b0: 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 20 76 69 \fIchannel\fR vi
25c0: 61 20 61 20 73 74 61 63 6b 65 64 20 63 68 61 6e a a stacked chan
25d0: 6e 65 6c 5c 26 2e 20 49 74 0a 6e 65 65 64 20 6e nel\&. It.need n
25e0: 6f 74 20 62 65 20 61 20 73 6f 63 6b 65 74 2c 20 ot be a socket,
25f0: 62 75 74 20 6d 75 73 74 20 70 72 6f 76 69 64 65 but must provide
2600: 20 62 69 2d 64 69 72 65 63 74 69 6f 6e 61 6c 20 bi-directional
2610: 66 6c 6f 77 5c 26 2e 20 41 6c 73 6f 20 73 65 74 flow\&. Also set
2620: 73 20 73 65 73 73 69 6f 6e 0a 70 61 72 61 6d 65 s session.parame
2630: 74 65 72 73 20 66 6f 72 20 53 53 4c 20 68 61 6e ters for SSL han
2640: 64 73 68 61 6b 65 5c 26 2e 20 56 61 6c 69 64 20 dshake\&. Valid
2650: 6f 70 74 69 6f 6e 73 20 61 72 65 3a 0a 2e 52 53 options are:..RS
2660: 0a 2e 54 50 0a 5c 66 42 2d 61 6c 70 6e 5c 66 52 ..TP.\fB-alpn\fR
2670: 20 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 \fIlist\fR.List
2680: 20 6f 66 20 70 72 6f 74 6f 63 6f 6c 73 20 74 6f of protocols to
2690: 20 6f 66 66 65 72 20 64 75 72 69 6e 67 20 41 70 offer during Ap
26a0: 70 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 20 plication-Layer
26b0: 50 72 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 61 Protocol Negotia
26c0: 74 69 6f 6e 0a 28 41 4c 50 4e 29 5c 26 2e 20 46 tion.(ALPN)\&. F
26d0: 6f 72 20 65 78 61 6d 70 6c 65 3a 20 5c 66 42 68 or example: \fBh
26e0: 32 5c 66 52 20 61 6e 64 20 5c 66 42 68 74 74 70 2\fR and \fBhttp
26f0: 2f 31 5c 26 2e 31 5c 66 52 2c 20 62 75 74 20 6e /1\&.1\fR, but n
2700: 6f 74 20 5c 66 42 68 33 5c 66 52 20 6f 72 0a 5c ot \fBh3\fR or.\
2710: 66 42 71 75 69 63 5c 66 52 5c 26 2e 20 54 68 69 fBquic\fR\&. Thi
2720: 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 s option is new
2730: 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 for TclTLS 1\&.8
2740: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 61 64 69 \&...TP.\fB-cadi
2750: 72 5c 66 52 20 5c 66 49 64 69 72 65 63 74 6f 72 r\fR \fIdirector
2760: 79 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 74 y\fR.Specifies t
2770: 68 65 20 64 69 72 65 63 74 6f 72 79 20 77 68 65 he directory whe
2780: 72 65 20 74 68 65 20 43 65 72 74 69 66 69 63 61 re the Certifica
2790: 74 65 20 41 75 74 68 6f 72 69 74 79 20 28 43 41 te Authority (CA
27a0: 29 20 63 65 72 74 69 66 69 63 61 74 65 73 20 61 ) certificates a
27b0: 72 65 0a 73 74 6f 72 65 64 5c 26 2e 20 54 68 65 re.stored\&. The
27c0: 20 64 65 66 61 75 6c 74 20 69 73 20 70 6c 61 74 default is plat
27d0: 66 6f 72 6d 20 73 70 65 63 69 66 69 63 20 61 6e form specific an
27e0: 64 20 63 61 6e 20 62 65 20 73 65 74 20 61 74 20 d can be set at
27f0: 63 6f 6d 70 69 6c 65 20 74 69 6d 65 5c 26 2e 20 compile time\&.
2800: 54 68 65 0a 64 65 66 61 75 6c 74 20 6c 6f 63 61 The.default loca
2810: 74 69 6f 6e 20 63 61 6e 20 62 65 20 6f 76 65 72 tion can be over
2820: 72 69 64 64 65 6e 20 62 79 20 74 68 65 20 5c 66 ridden by the \f
2830: 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 5c 66 52 BSSL_CERT_DIR\fR
2840: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 76 61 72 environment.var
2850: 69 61 62 6c 65 5c 26 2e 20 53 65 65 20 5c 66 42 iable\&. See \fB
2860: 43 65 72 74 69 66 69 63 61 74 65 20 56 61 6c 69 Certificate Vali
2870: 64 61 74 69 6f 6e 5c 66 52 20 66 6f 72 20 6d 6f dation\fR for mo
2880: 72 65 20 64 65 74 61 69 6c 73 5c 26 2e 0a 2e 54 re details\&...T
2890: 50 0a 5c 66 42 2d 63 61 66 69 6c 65 5c 66 52 20 P.\fB-cafile\fR
28a0: 5c 66 49 66 69 6c 65 6e 61 6d 65 5c 66 52 0a 53 \fIfilename\fR.S
28b0: 70 65 63 69 66 69 65 73 20 74 68 65 20 66 69 6c pecifies the fil
28c0: 65 20 77 69 74 68 20 74 68 65 20 43 65 72 74 69 e with the Certi
28d0: 66 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 ficate Authority
28e0: 20 28 43 41 29 20 63 65 72 74 69 66 69 63 61 74 (CA) certificat
28f0: 65 73 20 74 6f 20 75 73 65 20 69 6e 0a 5c 66 42 es to use in.\fB
2900: 50 45 4d 5c 66 52 20 66 69 6c 65 20 66 6f 72 6d PEM\fR file form
2910: 61 74 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c at\&. The defaul
2920: 74 20 69 73 20 22 5c 66 49 63 65 72 74 5c 26 2e t is "\fIcert\&.
2930: 70 65 6d 5c 66 52 22 2c 20 69 6e 20 74 68 65 20 pem\fR", in the
2940: 4f 70 65 6e 53 53 4c 0a 64 69 72 65 63 74 6f 72 OpenSSL.director
2950: 79 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 y\&. The default
2960: 20 66 69 6c 65 20 63 61 6e 20 62 65 20 6f 76 65 file can be ove
2970: 72 72 69 64 64 65 6e 20 62 79 20 74 68 65 20 5c rridden by the \
2980: 66 42 53 53 4c 5f 43 45 52 54 5f 46 49 4c 45 5c fBSSL_CERT_FILE\
2990: 66 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 0a 76 fR environment.v
29a0: 61 72 69 61 62 6c 65 5c 26 2e 20 53 65 65 20 5c ariable\&. See \
29b0: 66 42 43 65 72 74 69 66 69 63 61 74 65 20 56 61 fBCertificate Va
29c0: 6c 69 64 61 74 69 6f 6e 5c 66 52 20 66 6f 72 20 lidation\fR for
29d0: 6d 6f 72 65 20 64 65 74 61 69 6c 73 5c 26 2e 0a more details\&..
29e0: 2e 54 50 0a 5c 66 42 2d 63 61 73 74 6f 72 65 5c .TP.\fB-castore\
29f0: 66 52 20 5c 66 49 55 52 49 5c 66 52 0a 53 70 65 fR \fIURI\fR.Spe
2a00: 63 69 66 69 65 73 20 74 68 65 20 55 6e 69 66 6f cifies the Unifo
2a10: 72 6d 20 52 65 73 6f 75 72 63 65 20 49 64 65 6e rm Resource Iden
2a20: 74 69 66 69 65 72 20 28 55 52 49 29 20 66 6f 72 tifier (URI) for
2a30: 20 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 the Certificate
2a40: 20 41 75 74 68 6f 72 69 74 79 0a 28 43 41 29 20 Authority.(CA)
2a50: 73 74 6f 72 65 2c 20 77 68 69 63 68 20 6d 61 79 store, which may
2a60: 20 62 65 20 61 20 73 69 6e 67 6c 65 20 63 6f 6e be a single con
2a70: 74 61 69 6e 65 72 20 6f 72 20 61 20 63 61 74 61 tainer or a cata
2a80: 6c 6f 67 20 6f 66 20 63 6f 6e 74 61 69 6e 65 72 log of container
2a90: 73 5c 26 2e 0a 53 74 61 72 74 69 6e 67 20 77 69 s\&..Starting wi
2aa0: 74 68 20 4f 70 65 6e 53 53 4c 20 33 5c 26 2e 32 th OpenSSL 3\&.2
2ab0: 20 6f 6e 20 4d 53 20 57 69 6e 64 6f 77 73 2c 20 on MS Windows,
2ac0: 73 65 74 20 74 6f 20 22 5c 66 42 6f 72 67 5c 26 set to "\fBorg\&
2ad0: 2e 6f 70 65 6e 73 73 6c 5c 26 2e 77 69 6e 73 74 .openssl\&.winst
2ae0: 6f 72 65 3a 2f 2f 5c 66 52 22 0a 74 6f 20 75 73 ore://\fR".to us
2af0: 65 20 74 68 65 20 62 75 69 6c 74 2d 69 6e 20 4d e the built-in M
2b00: 53 20 57 69 6e 64 6f 77 73 20 43 65 72 74 69 66 S Windows Certif
2b10: 69 63 61 74 65 20 53 74 6f 72 65 5c 26 2e 0a 53 icate Store\&..S
2b20: 65 65 20 5c 66 42 43 65 72 74 69 66 69 63 61 74 ee \fBCertificat
2b30: 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c 66 52 20 e Validation\fR
2b40: 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 for more details
2b50: 5c 26 2e 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 \&..This option
2b60: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
2b70: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
2b80: 66 42 2d 63 65 72 74 66 69 6c 65 5c 66 52 20 5c fB-certfile\fR \
2b90: 66 49 66 69 6c 65 6e 61 6d 65 5c 66 52 0a 53 70 fIfilename\fR.Sp
2ba0: 65 63 69 66 69 65 73 20 74 68 65 20 6e 61 6d 65 ecifies the name
2bb0: 20 6f 66 20 74 68 65 20 66 69 6c 65 20 77 69 74 of the file wit
2bc0: 68 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 h the certificat
2bd0: 65 20 74 6f 20 75 73 65 20 69 6e 20 50 45 4d 20 e to use in PEM
2be0: 66 6f 72 6d 61 74 0a 61 73 20 74 68 65 20 6c 6f format.as the lo
2bf0: 63 61 6c 20 28 63 6c 69 65 6e 74 20 6f 72 20 73 cal (client or s
2c00: 65 72 76 65 72 29 20 63 65 72 74 69 66 69 63 61 erver) certifica
2c10: 74 65 5c 26 2e 20 49 74 20 61 6c 73 6f 20 63 6f te\&. It also co
2c20: 6e 74 61 69 6e 73 20 74 68 65 20 70 75 62 6c 69 ntains the publi
2c30: 63 20 6b 65 79 5c 26 2e 0a 2e 54 50 0a 5c 66 42 c key\&...TP.\fB
2c40: 2d 63 65 72 74 5c 66 52 20 5c 66 49 73 74 72 69 -cert\fR \fIstri
2c50: 6e 67 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 ng\fR.Specifies
2c60: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
2c70: 74 6f 20 75 73 65 20 61 73 20 61 20 44 45 52 20 to use as a DER
2c80: 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20 28 encoded string (
2c90: 58 5c 26 2e 35 30 39 20 44 45 52 29 5c 26 2e 0a X\&.509 DER)\&..
2ca0: 2e 54 50 0a 5c 66 42 2d 63 69 70 68 65 72 5c 66 .TP.\fB-cipher\f
2cb0: 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 53 R \fIstring\fR.S
2cc0: 70 65 63 69 66 69 65 73 20 74 68 65 20 6c 69 73 pecifies the lis
2cd0: 74 20 6f 66 20 63 69 70 68 65 72 73 20 74 6f 20 t of ciphers to
2ce0: 75 73 65 20 66 6f 72 20 54 4c 53 20 31 5c 26 2e use for TLS 1\&.
2cf0: 32 20 61 6e 64 20 65 61 72 6c 69 65 72 20 63 6f 2 and earlier co
2d00: 6e 6e 65 63 74 69 6f 6e 73 5c 26 2e 0a 53 74 72 nnections\&..Str
2d10: 69 6e 67 20 69 73 20 61 20 63 6f 6c 6f 6e 20 22 ing is a colon "
2d20: 5c 66 42 3a 5c 66 52 22 20 73 65 70 61 72 61 74 \fB:\fR" separat
2d30: 65 64 20 6c 69 73 74 20 6f 66 20 63 69 70 68 65 ed list of ciphe
2d40: 72 73 5c 26 2e 0a 43 69 70 68 65 72 73 20 63 61 rs\&..Ciphers ca
2d50: 6e 20 62 65 20 63 6f 6d 62 69 6e 65 64 20 75 73 n be combined us
2d60: 69 6e 67 20 74 68 65 20 22 5c 66 42 2b 5c 66 52 ing the "\fB+\fR
2d70: 22 20 63 68 61 72 61 63 74 65 72 5c 26 2e 0a 50 " character\&..P
2d80: 72 65 66 69 78 65 73 20 63 61 6e 20 62 65 20 75 refixes can be u
2d90: 73 65 64 20 74 6f 20 70 65 72 6d 61 6e 65 6e 74 sed to permanent
2da0: 6c 79 20 72 65 6d 6f 76 65 20 22 5c 66 42 21 5c ly remove "\fB!\
2db0: 66 52 22 2c 20 64 65 6c 65 74 65 20 22 5c 66 42 fR", delete "\fB
2dc0: 2d 5c 66 52 22 2c 20 6f 72 0a 6d 6f 76 65 20 74 -\fR", or.move t
2dd0: 6f 20 74 68 65 20 65 6e 64 20 22 5c 66 42 2b 5c o the end "\fB+\
2de0: 66 52 22 20 61 20 73 70 65 63 69 66 69 65 64 20 fR" a specified
2df0: 63 69 70 68 65 72 5c 26 2e 0a 4b 65 79 77 6f 72 cipher\&..Keywor
2e00: 64 73 20 5c 66 42 40 53 54 52 45 4e 47 54 48 5c ds \fB@STRENGTH\
2e10: 66 52 20 28 73 6f 72 74 20 62 79 20 61 6c 67 6f fR (sort by algo
2e20: 72 69 74 68 6d 20 6b 65 79 20 6c 65 6e 67 74 68 rithm key length
2e30: 29 2c 0a 5c 66 42 40 53 45 43 4c 45 56 45 4c 3d ),.\fB@SECLEVEL=
2e40: 5c 66 52 5c 66 49 6e 5c 66 52 20 28 73 65 74 20 \fR\fIn\fR (set
2e50: 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 74 security level t
2e60: 6f 20 6e 29 2c 20 61 6e 64 0a 5c 66 42 44 45 46 o n), and.\fBDEF
2e70: 41 55 4c 54 5c 66 52 20 28 75 73 65 20 64 65 66 AULT\fR (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 5c 26 2e 0a 53 65 65 20 74 68 cified\&..See th
2ec0: 65 20 5c 66 49 4f 70 65 6e 53 53 4c 5c 66 52 20 e \fIOpenSSL\fR
2ed0: 5b 68 74 74 70 73 3a 2f 2f 64 6f 63 73 5c 26 2e [https://docs\&.
2ee0: 6f 70 65 6e 73 73 6c 5c 26 2e 6f 72 67 2f 6d 61 openssl\&.org/ma
2ef0: 73 74 65 72 2f 6d 61 6e 31 2f 6f 70 65 6e 73 73 ster/man1/openss
2f00: 6c 2d 63 69 70 68 65 72 73 2f 23 6f 70 74 69 6f l-ciphers/#optio
2f10: 6e 73 5d 0a 64 6f 63 75 6d 65 6e 74 61 74 69 6f ns].documentatio
2f20: 6e 20 66 6f 72 20 74 68 65 20 66 75 6c 6c 20 6c n for the full l
2f30: 69 73 74 20 6f 66 20 76 61 6c 69 64 20 76 61 6c ist of valid val
2f40: 75 65 73 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 ues\&...TP.\fB-c
2f50: 69 70 68 65 72 73 75 69 74 65 73 5c 66 52 20 5c iphersuites\fR \
2f60: 66 49 73 74 72 69 6e 67 5c 66 52 0a 53 70 65 63 fIstring\fR.Spec
2f70: 69 66 69 65 73 20 74 68 65 20 6c 69 73 74 20 6f ifies the list o
2f80: 66 20 63 69 70 68 65 72 20 73 75 69 74 65 73 20 f cipher suites
2f90: 74 6f 20 75 73 65 20 66 6f 72 20 54 4c 53 20 31 to use for TLS 1
2fa0: 5c 26 2e 33 20 61 73 20 61 20 63 6f 6c 6f 6e 0a \&.3 as a colon.
2fb0: 22 5c 66 42 3a 5c 66 52 22 20 73 65 70 61 72 61 "\fB:\fR" separa
2fc0: 74 65 64 20 6c 69 73 74 20 6f 66 20 63 69 70 68 ted list of ciph
2fd0: 65 72 20 73 75 69 74 65 20 6e 61 6d 65 73 5c 26 er suite names\&
2fe0: 2e 20 53 65 65 20 74 68 65 0a 5c 66 49 4f 70 65 . See the.\fIOpe
2ff0: 6e 53 53 4c 5c 66 52 20 5b 68 74 74 70 73 3a 2f nSSL\fR [https:/
3000: 2f 64 6f 63 73 5c 26 2e 6f 70 65 6e 73 73 6c 5c /docs\&.openssl\
3010: 26 2e 6f 72 67 2f 6d 61 73 74 65 72 2f 6d 61 6e &.org/master/man
3020: 31 2f 6f 70 65 6e 73 73 6c 2d 63 69 70 68 65 72 1/openssl-cipher
3030: 73 2f 23 6f 70 74 69 6f 6e 73 5d 0a 64 6f 63 75 s/#options].docu
3040: 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 74 68 mentation for th
3050: 65 20 66 75 6c 6c 20 6c 69 73 74 20 6f 66 20 76 e full list of v
3060: 61 6c 69 64 20 76 61 6c 75 65 73 5c 26 2e 0a 54 alid values\&..T
3070: 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 his option is ne
3080: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
3090: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 6f .8\&...TP.\fB-co
30a0: 6d 6d 61 6e 64 5c 66 52 20 5c 66 49 63 61 6c 6c mmand\fR \fIcall
30b0: 62 61 63 6b 5c 66 52 0a 53 70 65 63 69 66 69 65 back\fR.Specifie
30c0: 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 63 s the callback c
30d0: 6f 6d 6d 61 6e 64 20 74 6f 20 62 65 20 69 6e 76 ommand to be inv
30e0: 6f 6b 65 64 20 61 74 20 73 65 76 65 72 61 6c 20 oked at several
30f0: 70 6f 69 6e 74 73 20 64 75 72 69 6e 67 20 74 68 points during th
3100: 65 0a 68 61 6e 64 73 68 61 6b 65 20 74 6f 20 70 e.handshake to p
3110: 61 73 73 20 65 72 72 6f 72 73 2c 20 74 72 61 63 ass errors, trac
3120: 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c ing information,
3130: 20 61 6e 64 20 70 72 6f 74 6f 63 6f 6c 20 6d 65 and protocol me
3140: 73 73 61 67 65 73 5c 26 2e 0a 53 65 65 20 5c 66 ssages\&..See \f
3150: 42 43 61 6c 6c 62 61 63 6b 20 4f 70 74 69 6f 6e BCallback Option
3160: 73 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 69 6e s\fR for more in
3170: 66 6f 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 64 68 fo\&...TP.\fB-dh
3180: 70 61 72 61 6d 73 5c 66 52 20 5c 66 49 66 69 6c params\fR \fIfil
3190: 65 6e 61 6d 65 5c 66 52 0a 53 70 65 63 69 66 69 ename\fR.Specifi
31a0: 65 73 20 74 68 65 20 44 69 66 66 69 65 2d 48 65 es the Diffie-He
31b0: 6c 6c 6d 61 6e 20 28 44 48 29 20 70 61 72 61 6d llman (DH) param
31c0: 65 74 65 72 73 20 66 69 6c 65 5c 26 2e 0a 2e 54 eters file\&...T
31d0: 50 0a 5c 66 42 2d 6b 65 79 66 69 6c 65 5c 66 52 P.\fB-keyfile\fR
31e0: 20 5c 66 49 66 69 6c 65 6e 61 6d 65 5c 66 52 0a \fIfilename\fR.
31f0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 70 72 Specifies the pr
3200: 69 76 61 74 65 20 6b 65 79 20 66 69 6c 65 5c 26 ivate key file\&
3210: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 . The default is
3220: 20 74 6f 20 75 73 65 20 74 68 65 20 66 69 6c 65 to use the file
3230: 0a 73 70 65 63 69 66 69 65 64 20 62 79 20 74 68 .specified by th
3240: 65 20 5c 66 42 2d 63 65 72 74 66 69 6c 65 5c 66 e \fB-certfile\f
3250: 52 20 6f 70 74 69 6f 6e 5c 26 2e 0a 2e 54 50 0a R option\&...TP.
3260: 5c 66 42 2d 6b 65 79 5c 66 52 20 5c 66 49 73 74 \fB-key\fR \fIst
3270: 72 69 6e 67 5c 66 52 0a 53 70 65 63 69 66 69 65 ring\fR.Specifie
3280: 73 20 74 68 65 20 70 72 69 76 61 74 65 20 6b 65 s the private ke
3290: 79 20 74 6f 20 75 73 65 20 61 73 20 61 20 44 45 y to use as a DE
32a0: 52 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 R encoded string
32b0: 20 28 50 4b 43 53 23 31 20 44 45 52 29 5c 26 2e (PKCS#1 DER)\&.
32c0: 0a 2e 54 50 0a 5c 66 42 2d 6d 6f 64 65 6c 5c 66 ..TP.\fB-model\f
32d0: 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a R \fIchannel\fR.
32e0: 46 6f 72 63 65 20 74 68 69 73 20 63 68 61 6e 6e Force this chann
32f0: 65 6c 20 74 6f 20 73 68 61 72 65 20 74 68 65 20 el to share the
3300: 73 61 6d 65 20 5c 66 49 53 53 4c 5f 43 54 58 5c same \fISSL_CTX\
3310: 66 52 20 73 74 72 75 63 74 75 72 65 20 61 73 20 fR structure as
3320: 74 68 65 0a 73 70 65 63 69 66 69 65 64 20 5c 66 the.specified \f
3330: 49 63 68 61 6e 6e 65 6c 5c 66 52 2c 20 61 6e 64 Ichannel\fR, and
3340: 20 74 68 65 72 65 66 6f 72 65 20 73 68 61 72 65 therefore share
3350: 20 63 6f 6e 66 69 67 2c 20 63 61 6c 6c 62 61 63 config, callbac
3360: 6b 73 2c 20 65 74 63 5c 26 2e 0a 2e 54 50 0a 5c ks, etc\&...TP.\
3370: 66 42 2d 70 61 73 73 77 6f 72 64 5c 66 52 20 5c fB-password\fR \
3380: 66 49 63 61 6c 6c 62 61 63 6b 5c 66 52 0a 53 70 fIcallback\fR.Sp
3390: 65 63 69 66 69 65 73 20 74 68 65 20 63 61 6c 6c ecifies the call
33a0: 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 back command to
33b0: 69 6e 76 6f 6b 65 20 77 68 65 6e 20 4f 70 65 6e invoke when Open
33c0: 53 53 4c 20 6e 65 65 64 73 20 74 6f 20 6f 62 74 SSL needs to obt
33d0: 61 69 6e 20 61 0a 70 61 73 73 77 6f 72 64 5c 26 ain a.password\&
33e0: 2e 20 54 68 69 73 20 69 73 20 74 79 70 69 63 61 . This is typica
33f0: 6c 6c 79 20 75 73 65 64 20 74 6f 20 75 6e 6c 6f lly used to unlo
3400: 63 6b 20 74 68 65 20 70 72 69 76 61 74 65 20 6b ck the private k
3410: 65 79 20 6f 66 20 61 20 63 65 72 74 69 66 69 63 ey of a certific
3420: 61 74 65 5c 26 2e 0a 54 68 65 20 63 61 6c 6c 62 ate\&..The callb
3430: 61 63 6b 20 73 68 6f 75 6c 64 20 72 65 74 75 72 ack should retur
3440: 6e 20 61 20 70 61 73 73 77 6f 72 64 20 73 74 72 n a password str
3450: 69 6e 67 5c 26 2e 20 54 68 69 73 20 6f 70 74 69 ing\&. This opti
3460: 6f 6e 20 68 61 73 20 63 68 61 6e 67 65 64 20 66 on has changed f
3470: 6f 72 0a 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c or.TclTLS 1\&.8\
3480: 26 2e 20 53 65 65 20 5c 66 42 43 61 6c 6c 62 61 &. See \fBCallba
3490: 63 6b 20 4f 70 74 69 6f 6e 73 5c 66 52 20 66 6f ck Options\fR fo
34a0: 72 20 6d 6f 72 65 20 69 6e 66 6f 5c 26 2e 0a 2e r more info\&...
34b0: 54 50 0a 5c 66 42 2d 70 6f 73 74 5f 68 61 6e 64 TP.\fB-post_hand
34c0: 73 68 61 6b 65 5c 66 52 20 5c 66 49 62 6f 6f 6c shake\fR \fIbool
34d0: 5c 66 52 0a 41 6c 6c 6f 77 20 70 6f 73 74 2d 68 \fR.Allow post-h
34e0: 61 6e 64 73 68 61 6b 65 20 73 65 73 73 69 6f 6e andshake session
34f0: 20 74 69 63 6b 65 74 20 75 70 64 61 74 65 73 5c ticket updates\
3500: 26 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 &. This option i
3510: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
3520: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
3530: 42 2d 72 65 71 75 65 73 74 5c 66 52 20 5c 66 49 B-request\fR \fI
3540: 62 6f 6f 6c 5c 66 52 0a 52 65 71 75 65 73 74 20 bool\fR.Request
3550: 61 20 63 65 72 74 69 66 69 63 61 74 65 20 66 72 a certificate fr
3560: 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 69 om the peer duri
3570: 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 73 ng the SSL hands
3580: 68 61 6b 65 5c 26 2e 20 54 68 69 73 20 69 73 20 hake\&. This is
3590: 6e 65 65 64 65 64 0a 74 6f 20 64 6f 20 43 65 72 needed.to do Cer
35a0: 74 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 tificate Validat
35b0: 69 6f 6e 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 ion\&. Starting
35c0: 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 2c in TclTLS 1\&.8,
35d0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 0a the default is.
35e0: 5c 66 42 74 72 75 65 5c 66 52 20 66 6f 72 20 63 \fBtrue\fR for c
35f0: 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e lient connection
3600: 73 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 69 6e s\&. Starting in
3610: 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 69 TclTLS 2\&.0, i
3620: 66 20 73 65 74 20 74 6f 0a 5c 66 42 66 61 6c 73 f set to.\fBfals
3630: 65 5c 66 52 20 61 6e 64 20 5c 66 42 2d 72 65 71 e\fR and \fB-req
3640: 75 69 72 65 5c 66 52 20 69 73 20 5c 66 42 74 72 uire\fR is \fBtr
3650: 75 65 5c 66 52 2c 20 74 68 65 6e 20 74 68 69 73 ue\fR, then this
3660: 20 77 69 6c 6c 20 62 65 0a 6f 76 65 72 72 69 64 will be.overrid
3670: 64 65 6e 20 74 6f 20 5c 66 42 74 72 75 65 5c 66 den to \fBtrue\f
3680: 52 5c 26 2e 0a 53 65 65 20 5c 66 42 43 65 72 74 R\&..See \fBCert
3690: 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 ificate Validati
36a0: 6f 6e 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 64 on\fR for more d
36b0: 65 74 61 69 6c 73 5c 26 2e 0a 2e 54 50 0a 5c 66 etails\&...TP.\f
36c0: 42 2d 72 65 71 75 69 72 65 5c 66 52 20 5c 66 49 B-require\fR \fI
36d0: 62 6f 6f 6c 5c 66 52 0a 52 65 71 75 69 72 65 20 bool\fR.Require
36e0: 61 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 a valid certific
36f0: 61 74 65 20 66 72 6f 6d 20 74 68 65 20 70 65 65 ate from the pee
3700: 72 20 64 75 72 69 6e 67 20 74 68 65 20 53 53 4c r during the SSL
3710: 20 68 61 6e 64 73 68 61 6b 65 5c 26 2e 20 49 66 handshake\&. If
3720: 20 74 68 69 73 20 69 73 0a 73 65 74 20 74 6f 20 this is.set to
3730: 74 72 75 65 2c 20 74 68 65 6e 20 5c 66 42 2d 72 true, then \fB-r
3740: 65 71 75 65 73 74 5c 66 52 20 6d 75 73 74 20 61 equest\fR must a
3750: 6c 73 6f 20 62 65 20 73 65 74 20 74 6f 20 74 72 lso be set to tr
3760: 75 65 20 61 6e 64 20 61 20 65 69 74 68 65 72 0a ue and a either.
3770: 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 5c 66 \fB-cadir\fR, \f
3780: 42 2d 63 61 66 69 6c 65 5c 66 52 2c 20 5c 66 42 B-cafile\fR, \fB
3790: 2d 63 61 73 74 6f 72 65 5c 66 52 2c 20 6f 72 20 -castore\fR, or
37a0: 61 20 70 6c 61 74 66 6f 72 6d 20 64 65 66 61 75 a platform defau
37b0: 6c 74 0a 6d 75 73 74 20 62 65 20 70 72 6f 76 69 lt.must be provi
37c0: 64 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ded in order to
37d0: 76 61 6c 69 64 61 74 65 20 61 67 61 69 6e 73 74 validate against
37e0: 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 \&. The default
37f0: 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 20 in TclTLS 1\&.8
3800: 61 6e 64 0a 65 61 72 6c 69 65 72 20 76 65 72 73 and.earlier vers
3810: 69 6f 6e 73 20 69 73 20 5c 66 42 66 61 6c 73 65 ions is \fBfalse
3820: 5c 66 52 20 73 69 6e 63 65 20 6e 6f 74 20 61 6c \fR since not al
3830: 6c 20 70 6c 61 74 66 6f 72 6d 73 20 68 61 76 65 l platforms have
3840: 20 63 65 72 74 69 66 69 63 61 74 65 73 20 74 6f certificates to
3850: 0a 76 61 6c 69 64 61 74 65 20 61 67 61 69 6e 73 .validate agains
3860: 74 20 69 6e 20 61 20 66 6f 72 6d 20 63 6f 6d 70 t in a form comp
3870: 61 74 69 62 6c 65 20 77 69 74 68 20 4f 70 65 6e atible with Open
3880: 53 53 4c 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 SSL\&. Starting
3890: 69 6e 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c in TclTLS 2\&.0,
38a0: 0a 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 .the default is
38b0: 5c 66 42 74 72 75 65 5c 66 52 20 66 6f 72 20 63 \fBtrue\fR for c
38c0: 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 6f 6e lient connection
38d0: 73 5c 26 2e 0a 53 65 65 20 5c 66 42 43 65 72 74 s\&..See \fBCert
38e0: 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 ificate Validati
38f0: 6f 6e 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 64 on\fR for more d
3900: 65 74 61 69 6c 73 5c 26 2e 0a 2e 54 50 0a 5c 66 etails\&...TP.\f
3910: 42 2d 73 65 63 75 72 69 74 79 5f 6c 65 76 65 6c B-security_level
3920: 5c 66 52 20 5c 66 49 69 6e 74 65 67 65 72 5c 66 \fR \fIinteger\f
3930: 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 R.Specifies the
3940: 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 28 security level (
3950: 76 61 6c 75 65 20 66 72 6f 6d 20 30 20 74 6f 20 value from 0 to
3960: 35 29 5c 26 2e 20 54 68 65 20 73 65 63 75 72 69 5)\&. The securi
3970: 74 79 20 6c 65 76 65 6c 20 61 66 66 65 63 74 73 ty level affects
3980: 0a 74 68 65 20 61 6c 6c 6f 77 65 64 20 63 69 70 .the allowed cip
3990: 68 65 72 20 73 75 69 74 65 20 65 6e 63 72 79 70 her suite encryp
39a0: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 73 2c tion algorithms,
39b0: 20 73 75 70 70 6f 72 74 65 64 20 45 43 43 20 63 supported ECC c
39c0: 75 72 76 65 73 2c 0a 73 75 70 70 6f 72 74 65 64 urves,.supported
39d0: 20 73 69 67 6e 61 74 75 72 65 20 61 6c 67 6f 72 signature algor
39e0: 69 74 68 6d 73 2c 20 44 48 20 70 61 72 61 6d 65 ithms, DH parame
39f0: 74 65 72 20 73 69 7a 65 73 2c 20 63 65 72 74 69 ter sizes, certi
3a00: 66 69 63 61 74 65 20 6b 65 79 20 73 69 7a 65 73 ficate key sizes
3a10: 0a 61 6e 64 20 73 69 67 6e 61 74 75 72 65 20 61 .and signature a
3a20: 6c 67 6f 72 69 74 68 6d 73 5c 26 2e 20 54 68 65 lgorithms\&. The
3a30: 20 64 65 66 61 75 6c 74 20 69 73 20 31 20 70 72 default is 1 pr
3a40: 69 6f 72 20 74 6f 20 4f 70 65 6e 53 53 4c 20 33 ior to OpenSSL 3
3a50: 5c 26 2e 32 20 61 6e 64 20 32 0a 74 68 65 72 65 \&.2 and 2.there
3a60: 61 66 74 65 72 5c 26 2e 20 4c 65 76 65 6c 20 33 after\&. Level 3
3a70: 20 61 6e 64 20 68 69 67 68 65 72 20 64 69 73 61 and higher disa
3a80: 62 6c 65 20 73 75 70 70 6f 72 74 20 66 6f 72 20 ble support for
3a90: 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 73 20 session tickets
3aa0: 61 6e 64 0a 6f 6e 6c 79 20 61 63 63 65 70 74 20 and.only accept
3ab0: 63 69 70 68 65 72 20 73 75 69 74 65 73 20 74 68 cipher suites th
3ac0: 61 74 20 70 72 6f 76 69 64 65 20 66 6f 72 77 61 at provide forwa
3ad0: 72 64 20 73 65 63 72 65 63 79 5c 26 2e 0a 54 68 rd secrecy\&..Th
3ae0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 is option is new
3af0: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
3b00: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 73 65 72 8\&...TP.\fB-ser
3b10: 76 65 72 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 ver\fR \fIbool\f
3b20: 52 0a 53 70 65 63 69 66 69 65 73 20 77 68 65 74 R.Specifies whet
3b30: 68 65 72 20 74 6f 20 61 63 74 20 61 73 20 61 20 her to act as a
3b40: 73 65 72 76 65 72 20 61 6e 64 20 72 65 73 70 6f server and respo
3b50: 6e 64 20 77 69 74 68 20 61 20 73 65 72 76 65 72 nd with a server
3b60: 20 68 61 6e 64 73 68 61 6b 65 20 77 68 65 6e 20 handshake when
3b70: 61 0a 63 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 74 a.client connect
3b80: 73 20 61 6e 64 20 70 72 6f 76 69 64 65 73 20 61 s and provides a
3b90: 20 63 6c 69 65 6e 74 20 68 61 6e 64 73 68 61 6b client handshak
3ba0: 65 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 e\&. The default
3bb0: 20 69 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 5c is \fBfalse\fR\
3bc0: 26 2e 0a 2e 54 50 0a 5c 66 42 2d 73 65 72 76 65 &...TP.\fB-serve
3bd0: 72 6e 61 6d 65 5c 66 52 20 5c 66 49 68 6f 73 74 rname\fR \fIhost
3be0: 6e 61 6d 65 5c 66 52 0a 53 70 65 63 69 66 79 20 name\fR.Specify
3bf0: 74 68 65 20 70 65 65 72 27 73 20 68 6f 73 74 6e the peer's hostn
3c00: 61 6d 65 5c 26 2e 20 54 68 69 73 20 69 73 20 75 ame\&. This is u
3c10: 73 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 54 sed to set the T
3c20: 4c 53 20 53 65 72 76 65 72 20 4e 61 6d 65 20 49 LS Server Name I
3c30: 6e 64 69 63 61 74 69 6f 6e 0a 28 53 4e 49 29 20 ndication.(SNI)
3c40: 65 78 74 65 6e 73 69 6f 6e 5c 26 2e 20 53 65 74 extension\&. Set
3c50: 20 74 68 69 73 20 74 6f 20 74 68 65 20 65 78 70 this to the exp
3c60: 65 63 74 65 64 20 73 65 72 76 65 72 6e 61 6d 65 ected servername
3c70: 20 69 6e 20 74 68 65 20 73 65 72 76 65 72 27 73 in the server's
3c80: 20 63 65 72 74 69 66 69 63 61 74 65 0a 6f 72 20 certificate.or
3c90: 6f 6e 65 20 6f 66 20 74 68 65 20 53 75 62 6a 65 one of the Subje
3ca0: 63 74 20 41 6c 74 65 72 6e 61 74 65 20 4e 61 6d ct Alternate Nam
3cb0: 65 73 20 28 53 41 4e 29 5c 26 2e 20 53 74 61 72 es (SAN)\&. Star
3cc0: 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 32 ting in TclTLS 2
3cd0: 5c 26 2e 30 2c 20 74 68 69 73 20 77 69 6c 6c 0a \&.0, this will.
3ce0: 64 65 66 61 75 6c 74 20 74 6f 20 74 68 65 20 68 default to the h
3cf0: 6f 73 74 20 66 72 6f 6d 20 74 68 65 20 5c 66 42 ost from the \fB
3d00: 74 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 20 63 tls::socket\fR c
3d10: 6f 6d 6d 61 6e 64 5c 26 2e 0a 2e 54 50 0a 5c 66 ommand\&...TP.\f
3d20: 42 2d 73 65 73 73 69 6f 6e 5f 69 64 5c 66 52 20 B-session_id\fR
3d30: 5c 66 49 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 \fIbinary_string
3d40: 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 \fR.Specifies th
3d50: 65 20 73 65 73 73 69 6f 6e 20 69 64 20 74 6f 20 e session id to
3d60: 72 65 73 75 6d 65 20 61 20 73 65 73 73 69 6f 6e resume a session
3d70: 5c 26 2e 20 4e 6f 74 20 73 75 70 70 6f 72 74 65 \&. Not supporte
3d80: 64 20 79 65 74 5c 26 2e 0a 54 68 69 73 20 6f 70 d yet\&..This op
3d90: 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 tion is new for
3da0: 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a TclTLS 1\&.8\&..
3db0: 2e 54 50 0a 5c 66 42 2d 73 73 6c 32 5c 66 52 20 .TP.\fB-ssl2\fR
3dc0: 5c 66 49 62 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c \fIbool\fR.Enabl
3dd0: 65 20 75 73 65 20 6f 66 20 53 53 4c 20 76 32 5c e use of SSL v2\
3de0: 26 2e 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 &.The default is
3df0: 20 5c 66 42 66 61 6c 73 65 5c 66 52 5c 26 2e 0a \fBfalse\fR\&..
3e00: 4f 70 65 6e 53 53 4c 20 31 5c 26 2e 31 2b 20 6e OpenSSL 1\&.1+ n
3e10: 6f 20 6c 6f 6e 67 65 72 20 73 75 70 70 6f 72 74 o longer support
3e20: 73 20 53 53 4c 20 76 32 2c 20 73 6f 20 74 68 69 s SSL v2, so thi
3e30: 73 20 6d 61 79 20 6e 6f 74 20 68 61 76 65 20 61 s may not have a
3e40: 6e 79 20 65 66 66 65 63 74 5c 26 2e 0a 53 65 65 ny effect\&..See
3e50: 20 74 68 65 20 5c 66 42 74 6c 73 3a 3a 70 72 6f the \fBtls::pro
3e60: 74 6f 63 6f 6c 73 5c 66 52 20 63 6f 6d 6d 61 6e tocols\fR comman
3e70: 64 20 66 6f 72 20 73 75 70 70 6f 72 74 65 64 20 d for supported
3e80: 70 72 6f 74 6f 63 6f 6c 73 5c 26 2e 0a 2e 54 50 protocols\&...TP
3e90: 0a 5c 66 42 2d 73 73 6c 33 5c 66 52 20 5c 66 49 .\fB-ssl3\fR \fI
3ea0: 62 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c 65 20 75 bool\fR.Enable u
3eb0: 73 65 20 6f 66 20 53 53 4c 20 76 33 5c 26 2e 20 se of SSL v3\&.
3ec0: 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c The default is \
3ed0: 66 42 66 61 6c 73 65 5c 66 52 5c 26 2e 20 53 74 fBfalse\fR\&. St
3ee0: 61 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 arting in TclTLS
3ef0: 20 31 5c 26 2e 38 2c 0a 75 73 65 20 6f 66 20 53 1\&.8,.use of S
3f00: 53 4c 20 76 33 20 69 66 20 6f 6e 6c 79 20 61 76 SL v3 if only av
3f10: 61 69 6c 61 62 6c 65 20 76 69 61 20 61 20 63 6f ailable via a co
3f20: 6d 70 69 6c 65 20 74 69 6d 65 20 6f 70 74 69 6f mpile time optio
3f30: 6e 5c 26 2e 0a 4f 70 65 6e 53 53 4c 20 34 5c 26 n\&..OpenSSL 4\&
3f40: 2e 30 2b 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 .0+ no longer su
3f50: 70 70 6f 72 74 73 20 53 53 4c 20 76 33 2c 20 73 pports SSL v3, s
3f60: 6f 20 74 68 69 73 20 6d 61 79 20 6e 6f 74 20 68 o this may not h
3f70: 61 76 65 20 61 6e 79 20 65 66 66 65 63 74 5c 26 ave any effect\&
3f80: 2e 0a 53 65 65 20 74 68 65 20 5c 66 42 74 6c 73 ..See the \fBtls
3f90: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 20 63 ::protocols\fR c
3fa0: 6f 6d 6d 61 6e 64 20 66 6f 72 20 73 75 70 70 6f ommand for suppo
3fb0: 72 74 65 64 20 70 72 6f 74 6f 63 6f 6c 73 5c 26 rted protocols\&
3fc0: 2e 0a 2e 54 50 0a 5c 66 42 2d 74 6c 73 31 5c 66 ...TP.\fB-tls1\f
3fd0: 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 0a 45 6e 61 R \fIbool\fR.Ena
3fe0: 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 76 ble use of TLS v
3ff0: 31 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 1\&. Starting in
4000: 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 74 TclTLS 2\&.0, t
4010: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c 66 he default is \f
4020: 42 66 61 6c 73 65 5c 66 52 5c 26 2e 0a 4e 6f 74 Bfalse\fR\&..Not
4030: 65 3a 20 54 4c 53 20 31 5c 26 2e 30 20 6e 65 65 e: TLS 1\&.0 nee
4040: 64 73 20 53 48 41 31 20 74 6f 20 6f 70 65 72 61 ds SHA1 to opera
4050: 74 65 2c 20 77 68 69 63 68 20 69 73 20 6f 6e 6c te, which is onl
4060: 79 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 73 y available in s
4070: 65 63 75 72 69 74 79 20 6c 65 76 65 6c 0a 30 20 ecurity level.0
4080: 66 6f 72 20 4f 70 65 6e 20 53 53 4c 20 33 5c 26 for Open SSL 3\&
4090: 2e 30 2b 5c 26 2e 20 53 65 65 20 74 68 65 20 5c .0+\&. See the \
40a0: 66 42 2d 73 65 63 75 72 69 74 79 5f 6c 65 76 65 fB-security_leve
40b0: 6c 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e 0a 2e l\fR option\&...
40c0: 54 50 0a 5c 66 42 2d 74 6c 73 31 5c 26 2e 31 5c TP.\fB-tls1\&.1\
40d0: 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 0a 45 6e fR \fIbool\fR.En
40e0: 61 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 20 able use of TLS
40f0: 76 31 5c 26 2e 31 5c 26 2e 20 53 74 61 72 74 69 v1\&.1\&. Starti
4100: 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 32 5c 26 ng in TclTLS 2\&
4110: 2e 30 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 .0, the default
4120: 69 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 5c 26 is \fBfalse\fR\&
4130: 2e 0a 4e 6f 74 65 3a 20 54 4c 53 20 31 5c 26 2e ..Note: TLS 1\&.
4140: 31 20 6e 65 65 64 73 20 53 48 41 31 20 74 6f 20 1 needs SHA1 to
4150: 6f 70 65 72 61 74 65 2c 20 77 68 69 63 68 20 69 operate, which i
4160: 73 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 s only available
4170: 20 69 6e 20 73 65 63 75 72 69 74 79 20 6c 65 76 in security lev
4180: 65 6c 0a 30 20 66 6f 72 20 4f 70 65 6e 20 53 53 el.0 for Open SS
4190: 4c 20 33 5c 26 2e 30 2b 5c 26 2e 20 53 65 65 20 L 3\&.0+\&. See
41a0: 74 68 65 20 5c 66 42 2d 73 65 63 75 72 69 74 79 the \fB-security
41b0: 5f 6c 65 76 65 6c 5c 66 52 20 6f 70 74 69 6f 6e _level\fR option
41c0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 74 6c 73 31 \&...TP.\fB-tls1
41d0: 5c 26 2e 32 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c \&.2\fR \fIbool\
41e0: 66 52 0a 45 6e 61 62 6c 65 20 75 73 65 20 6f 66 fR.Enable use of
41f0: 20 54 4c 53 20 76 31 5c 26 2e 32 5c 26 2e 20 54 TLS v1\&.2\&. T
4200: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c 66 he default is \f
4210: 42 74 72 75 65 5c 66 52 5c 26 2e 0a 2e 54 50 0a Btrue\fR\&...TP.
4220: 5c 66 42 2d 74 6c 73 31 5c 26 2e 33 5c 66 52 20 \fB-tls1\&.3\fR
4230: 5c 66 49 62 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c \fIbool\fR.Enabl
4240: 65 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 5c e use of TLS v1\
4250: 26 2e 33 5c 26 2e 20 54 68 65 20 64 65 66 61 75 &.3\&. The defau
4260: 6c 74 20 69 73 20 5c 66 42 74 72 75 65 5c 66 52 lt is \fBtrue\fR
4270: 5c 26 2e 20 54 68 69 73 20 69 73 20 6f 6e 6c 79 \&. This is only
4280: 20 61 76 61 69 6c 61 62 6c 65 0a 73 74 61 72 74 available.start
4290: 69 6e 67 20 77 69 74 68 20 4f 70 65 6e 53 53 4c ing with OpenSSL
42a0: 20 31 5c 26 2e 31 5c 26 2e 31 20 61 6e 64 20 54 1\&.1\&.1 and T
42b0: 63 6c 54 4c 53 20 31 5c 26 2e 37 5c 26 2e 0a 2e clTLS 1\&.7\&...
42c0: 54 50 0a 5c 66 42 2d 76 61 6c 69 64 61 74 65 63 TP.\fB-validatec
42d0: 6f 6d 6d 61 6e 64 5c 66 52 20 5c 66 49 63 61 6c ommand\fR \fIcal
42e0: 6c 62 61 63 6b 5c 66 52 0a 53 70 65 63 69 66 69 lback\fR.Specifi
42f0: 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 es the callback
4300: 63 6f 6d 6d 61 6e 64 20 74 6f 20 69 6e 76 6f 6b command to invok
4310: 65 20 74 6f 20 76 61 6c 69 64 61 74 65 20 74 68 e to validate th
4320: 65 20 70 65 65 72 20 63 65 72 74 69 66 69 63 61 e peer certifica
4330: 74 65 73 0a 61 6e 64 20 6f 74 68 65 72 20 63 6f tes.and other co
4340: 6e 66 69 67 20 69 6e 66 6f 20 64 75 72 69 6e 67 nfig info during
4350: 20 74 68 65 20 70 72 6f 74 6f 63 6f 6c 20 6e 65 the protocol ne
4360: 67 6f 74 69 61 74 69 6f 6e 20 70 68 61 73 65 5c gotiation phase\
4370: 26 2e 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 &. This can be u
4380: 73 65 64 0a 62 79 20 54 43 4c 20 73 63 72 69 70 sed.by TCL scrip
4390: 74 73 20 74 6f 20 70 65 72 66 6f 72 6d 20 74 68 ts to perform th
43a0: 65 69 72 20 6f 77 6e 20 43 65 72 74 69 66 69 63 eir own Certific
43b0: 61 74 65 20 56 61 6c 69 64 61 74 69 6f 6e 20 74 ate Validation t
43c0: 6f 20 73 75 70 70 6c 65 6d 65 6e 74 20 74 68 65 o supplement the
43d0: 0a 64 65 66 61 75 6c 74 20 76 61 6c 69 64 61 74 .default validat
43e0: 69 6f 6e 20 70 72 6f 76 69 64 65 64 20 62 79 20 ion provided by
43f0: 4f 70 65 6e 53 53 4c 5c 26 2e 20 54 68 65 20 73 OpenSSL\&. The s
4400: 63 72 69 70 74 20 6d 75 73 74 20 72 65 74 75 72 cript must retur
4410: 6e 20 61 20 62 6f 6f 6c 65 61 6e 20 74 72 75 65 n a boolean true
4420: 0a 74 6f 20 63 6f 6e 74 69 6e 75 65 20 74 68 65 .to continue the
4430: 20 6e 65 67 6f 74 69 61 74 69 6f 6e 5c 26 2e 20 negotiation\&.
4440: 53 65 65 20 5c 66 42 43 61 6c 6c 62 61 63 6b 20 See \fBCallback
4450: 4f 70 74 69 6f 6e 73 5c 66 52 20 66 6f 72 20 6d Options\fR for m
4460: 6f 72 65 20 69 6e 66 6f 5c 26 2e 0a 54 68 69 73 ore info\&..This
4470: 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 option is new f
4480: 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c or TclTLS 1\&.8\
4490: 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 74 6c &...RE..TP.\fBtl
44a0: 73 3a 3a 68 61 6e 64 73 68 61 6b 65 5c 66 52 20 s::handshake\fR
44b0: 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a 46 6f \fIchannel\fR.Fo
44c0: 72 63 65 73 20 74 68 65 20 54 4c 53 20 6e 65 67 rces the TLS neg
44d0: 6f 74 69 61 74 69 6f 6e 20 68 61 6e 64 73 68 61 otiation handsha
44e0: 6b 65 20 74 6f 20 74 61 6b 65 20 70 6c 61 63 65 ke to take place
44f0: 20 69 6d 6d 65 64 69 61 74 65 6c 79 2c 20 61 6e immediately, an
4500: 64 20 72 65 74 75 72 6e 73 20 30 0a 69 66 20 68 d returns 0.if h
4510: 61 6e 64 73 68 61 6b 65 20 69 73 20 73 74 69 6c andshake is stil
4520: 6c 20 69 6e 20 70 72 6f 67 72 65 73 73 20 28 6e l in progress (n
4530: 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 29 2c 20 6f 72 on-blocking), or
4540: 20 31 20 69 66 20 74 68 65 20 68 61 6e 64 73 68 1 if the handsh
4550: 61 6b 65 20 77 61 73 0a 73 75 63 63 65 73 73 66 ake was.successf
4560: 75 6c 5c 26 2e 20 49 66 20 74 68 65 20 68 61 6e ul\&. If the han
4570: 64 73 68 61 6b 65 20 66 61 69 6c 65 64 2c 20 61 dshake failed, a
4580: 6e 20 65 72 72 6f 72 20 77 69 6c 6c 20 62 65 20 n error will be
4590: 72 65 74 75 72 6e 65 64 5c 26 2e 0a 2e 54 50 0a returned\&...TP.
45a0: 5c 66 42 74 6c 73 3a 3a 73 68 75 74 64 6f 77 6e \fBtls::shutdown
45b0: 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 \fR \fIchannel\f
45c0: 52 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a 75 6e R..TP.\fBtls::un
45d0: 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 63 68 61 import\fR \fIcha
45e0: 6e 6e 65 6c 5c 66 52 0a 2e 54 50 0a 5c 66 42 74 nnel\fR..TP.\fBt
45f0: 6c 73 3a 3a 75 6e 73 74 61 63 6b 5c 66 52 20 5c ls::unstack\fR \
4600: 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a 54 68 69 fIchannel\fR.Thi
4610: 73 20 74 65 72 6d 69 6e 61 74 65 73 20 74 68 65 s terminates the
4620: 20 53 53 4c 2f 54 4c 53 20 73 65 73 73 69 6f 6e SSL/TLS session
4630: 20 62 79 20 73 65 6e 64 69 6e 67 20 74 68 65 20 by sending the
4640: 22 63 6c 6f 73 65 5f 6e 6f 74 69 66 79 22 20 6d "close_notify" m
4650: 65 73 73 61 67 65 20 61 6e 64 0a 72 65 6d 6f 76 essage and.remov
4660: 65 73 20 74 68 65 20 74 6f 70 20 6c 65 76 65 6c es the top level
4670: 20 73 74 61 63 6b 65 64 20 63 68 61 6e 6e 65 6c stacked channel
4680: 20 66 72 6f 6d 20 5c 66 49 63 68 61 6e 6e 65 6c from \fIchannel
4690: 5c 66 52 2c 20 62 75 74 20 69 74 20 64 6f 65 73 \fR, but it does
46a0: 20 6e 6f 74 20 63 6c 6f 73 65 0a 74 68 65 20 73 not close.the s
46b0: 6f 63 6b 65 74 5c 26 2e 20 49 74 20 69 73 20 74 ocket\&. It is t
46c0: 68 65 20 63 6f 6d 70 6c 69 6d 65 6e 74 20 74 6f he compliment to
46d0: 20 5c 66 42 74 6c 73 3a 3a 69 6d 70 6f 72 74 5c \fBtls::import\
46e0: 66 52 20 62 79 20 65 6e 64 69 6e 67 20 65 6e 63 fR by ending enc
46f0: 72 79 70 74 69 6f 6e 20 6f 66 0a 61 20 54 43 4c ryption of.a TCL
4700: 20 63 68 61 6e 6e 65 6c 5c 26 2e 20 41 6e 20 65 channel\&. An e
4710: 72 72 6f 72 20 69 73 20 74 68 72 6f 77 6e 20 69 rror is thrown i
4720: 66 20 54 4c 53 20 69 73 20 6e 6f 74 20 74 68 65 f TLS is not the
4730: 20 74 6f 70 20 73 74 61 63 6b 65 64 20 63 68 61 top stacked cha
4740: 6e 6e 65 6c 20 74 79 70 65 5c 26 2e 0a 2e 54 50 nnel type\&...TP
4750: 0a 5c 66 42 74 6c 73 3a 3a 73 74 61 74 75 73 5c .\fBtls::status\
4760: 66 52 20 3f 5c 66 42 2d 6c 6f 63 61 6c 5c 66 52 fR ?\fB-local\fR
4770: 3f 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a ? \fIchannel\fR.
4780: 52 65 74 75 72 6e 73 20 74 68 65 20 63 75 72 72 Returns the curr
4790: 65 6e 74 20 73 74 61 74 75 73 20 6f 66 20 61 6e ent status of an
47a0: 20 53 53 4c 20 63 68 61 6e 6e 65 6c 5c 26 2e 20 SSL channel\&.
47b0: 54 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 20 The result is a
47c0: 6c 69 73 74 20 6f 66 20 6b 65 79 2d 76 61 6c 75 list of key-valu
47d0: 65 0a 70 61 69 72 73 20 64 65 73 63 72 69 62 69 e.pairs describi
47e0: 6e 67 20 74 68 65 20 53 53 4c 2c 20 63 65 72 74 ng the SSL, cert
47f0: 69 66 69 63 61 74 65 2c 20 61 6e 64 20 63 65 72 ificate, and cer
4800: 74 69 66 69 63 61 74 65 20 76 65 72 69 66 69 63 tificate verific
4810: 61 74 69 6f 6e 20 73 74 61 74 75 73 5c 26 2e 20 ation status\&.
4820: 49 66 0a 74 68 65 20 53 53 4c 20 68 61 6e 64 73 If.the SSL hands
4830: 68 61 6b 65 20 68 61 73 20 6e 6f 74 20 79 65 74 hake has not yet
4840: 20 63 6f 6d 70 6c 65 74 65 64 2c 20 61 6e 20 65 completed, an e
4850: 6d 70 74 79 20 6c 69 73 74 20 69 73 20 72 65 74 mpty list is ret
4860: 75 72 6e 65 64 5c 26 2e 20 49 66 20 74 68 65 0a urned\&. If the.
4870: 5c 66 42 2d 6c 6f 63 61 6c 5c 66 52 20 6f 70 74 \fB-local\fR opt
4880: 69 6f 6e 20 69 73 20 73 70 65 63 69 66 69 65 64 ion is specified
4890: 2c 20 74 68 65 6e 20 74 68 65 20 6c 6f 63 61 6c , then the local
48a0: 20 63 65 72 74 69 66 69 63 61 74 65 20 69 73 20 certificate is
48b0: 75 73 65 64 5c 26 2e 0a 52 65 74 75 72 6e 65 64 used\&..Returned
48c0: 20 76 61 6c 75 65 73 20 69 6e 63 6c 75 64 65 3a values include:
48d0: 0a 2e 73 70 0a 53 53 4c 20 53 74 61 74 75 73 0a ..sp.SSL Status.
48e0: 2e 52 53 0a 2e 54 50 0a 5c 66 42 61 6c 70 6e 5c .RS..TP.\fBalpn\
48f0: 66 52 20 5c 66 49 70 72 6f 74 6f 63 6f 6c 5c 66 fR \fIprotocol\f
4900: 52 0a 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 73 R.The protocol s
4910: 65 6c 65 63 74 65 64 20 61 66 74 65 72 20 41 70 elected after Ap
4920: 70 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 20 plication-Layer
4930: 50 72 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 61 Protocol Negotia
4940: 74 69 6f 6e 20 28 41 4c 50 4e 29 5c 26 2e 0a 54 tion (ALPN)\&..T
4950: 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 his value is new
4960: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
4970: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 69 70 68 8\&...TP.\fBciph
4980: 65 72 5c 66 52 20 5c 66 49 63 69 70 68 65 72 5c er\fR \fIcipher\
4990: 66 52 0a 54 68 65 20 63 75 72 72 65 6e 74 20 63 fR.The current c
49a0: 69 70 68 65 72 20 69 6e 20 75 73 65 20 66 6f 72 ipher in use for
49b0: 20 74 68 65 20 73 65 73 73 69 6f 6e 5c 26 2e 0a the session\&..
49c0: 2e 54 50 0a 5c 66 42 70 65 65 72 6e 61 6d 65 5c .TP.\fBpeername\
49d0: 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68 fR \fIname\fR.Th
49e0: 65 20 70 65 65 72 6e 61 6d 65 20 66 72 6f 6d 20 e peername from
49f0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 5c the certificate\
4a00: 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 &..This value is
4a10: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
4a20: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
4a30: 70 72 6f 74 6f 63 6f 6c 5c 66 52 20 5c 66 49 76 protocol\fR \fIv
4a40: 65 72 73 69 6f 6e 5c 66 52 0a 54 68 65 20 70 72 ersion\fR.The pr
4a50: 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 75 otocol version u
4a60: 73 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e sed for the conn
4a70: 65 63 74 69 6f 6e 3a 20 53 53 4c 32 2c 20 53 53 ection: SSL2, SS
4a80: 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 31 5c 26 L3, TLS1, TLS1\&
4a90: 2e 31 2c 20 54 4c 53 31 5c 26 2e 32 2c 0a 54 4c .1, TLS1\&.2,.TL
4aa0: 53 31 5c 26 2e 33 2c 20 6f 72 20 75 6e 6b 6e 6f S1\&.3, or unkno
4ab0: 77 6e 5c 26 2e 20 54 68 69 73 20 76 61 6c 75 65 wn\&. This value
4ac0: 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 is new for TclT
4ad0: 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a LS 1\&.8\&...TP.
4ae0: 5c 66 42 73 62 69 74 73 5c 66 52 20 5c 66 49 6e \fBsbits\fR \fIn
4af0: 5c 66 52 0a 54 68 65 20 6e 75 6d 62 65 72 20 6f \fR.The number o
4b00: 66 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 f bits used for
4b10: 74 68 65 20 73 65 73 73 69 6f 6e 20 6b 65 79 5c the session key\
4b20: 26 2e 0a 2e 54 50 0a 5c 66 42 73 69 67 6e 61 74 &...TP.\fBsignat
4b30: 75 72 65 48 61 73 68 41 6c 67 6f 72 69 74 68 6d ureHashAlgorithm
4b40: 5c 66 52 20 5c 66 49 61 6c 67 6f 72 69 74 68 6d \fR \fIalgorithm
4b50: 5c 66 52 0a 54 68 65 20 73 69 67 6e 61 74 75 72 \fR.The signatur
4b60: 65 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d e hash algorithm
4b70: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
4b80: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
4b90: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
4ba0: 42 73 69 67 6e 61 74 75 72 65 54 79 70 65 5c 66 BsignatureType\f
4bb0: 52 20 5c 66 49 74 79 70 65 5c 66 52 0a 54 68 65 R \fItype\fR.The
4bc0: 20 73 69 67 6e 61 74 75 72 65 20 74 79 70 65 20 signature type
4bd0: 76 61 6c 75 65 5c 26 2e 0a 54 68 69 73 20 76 61 value\&..This va
4be0: 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 lue is new for T
4bf0: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
4c00: 54 50 0a 5c 66 42 76 65 72 69 66 79 44 65 70 74 TP.\fBverifyDept
4c10: 68 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 4d 61 78 h\fR \fIn\fR.Max
4c20: 69 6d 75 6d 20 64 65 70 74 68 20 66 6f 72 20 74 imum depth for t
4c30: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 63 he certificate c
4c40: 68 61 69 6e 20 76 65 72 69 66 69 63 61 74 69 6f hain verificatio
4c50: 6e 5c 26 2e 20 44 65 66 61 75 6c 74 20 69 73 20 n\&. Default is
4c60: 2d 31 2c 20 74 6f 20 63 68 65 63 6b 20 61 6c 6c -1, to check all
4c70: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
4c80: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
4c90: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
4ca0: 42 76 65 72 69 66 79 4d 6f 64 65 5c 66 52 20 5c BverifyMode\fR \
4cb0: 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 6f fIlist\fR.List o
4cc0: 66 20 63 65 72 74 69 66 69 63 61 74 65 20 76 65 f certificate ve
4cd0: 72 69 66 69 63 61 74 69 6f 6e 20 6d 6f 64 65 73 rification modes
4ce0: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
4cf0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
4d00: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
4d10: 42 76 65 72 69 66 79 52 65 73 75 6c 74 5c 66 52 BverifyResult\fR
4d20: 20 5c 66 49 72 65 73 75 6c 74 5c 66 52 0a 43 65 \fIresult\fR.Ce
4d30: 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 69 rtificate verifi
4d40: 63 61 74 69 6f 6e 20 72 65 73 75 6c 74 5c 26 2e cation result\&.
4d50: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
4d60: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
4d70: 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 61 &.8\&...TP.\fBca
4d80: 5f 6e 61 6d 65 73 5c 66 52 20 5c 66 49 6c 69 73 _names\fR \fIlis
4d90: 74 5c 66 52 0a 4c 69 73 74 20 6f 66 20 74 68 65 t\fR.List of the
4da0: 20 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 Certificate Aut
4db0: 68 6f 72 69 74 69 65 73 20 75 73 65 64 20 74 6f horities used to
4dc0: 20 63 72 65 61 74 65 20 74 68 65 20 63 65 72 74 create the cert
4dd0: 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 20 ificate\&..This
4de0: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
4df0: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
4e00: 0a 2e 52 45 0a 2e 49 50 0a 43 65 72 74 69 66 69 ..RE..IP.Certifi
4e10: 63 61 74 65 20 53 74 61 74 75 73 0a 2e 52 53 0a cate Status..RS.
4e20: 2e 54 50 0a 5c 66 42 61 6c 6c 5c 66 52 20 5c 66 .TP.\fBall\fR \f
4e30: 49 73 74 72 69 6e 67 5c 66 52 0a 44 75 6d 70 20 Istring\fR.Dump
4e40: 6f 66 20 61 6c 6c 20 63 65 72 74 69 66 69 63 61 of all certifica
4e50: 74 65 20 69 6e 66 6f 5c 26 2e 0a 54 68 69 73 20 te info\&..This
4e60: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
4e70: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
4e80: 0a 2e 54 50 0a 5c 66 42 76 65 72 73 69 6f 6e 5c ..TP.\fBversion\
4e90: 66 52 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a 54 fR \fIvalue\fR.T
4ea0: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 76 he certificate v
4eb0: 65 72 73 69 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 ersion\&...TP.\f
4ec0: 42 73 65 72 69 61 6c 4e 75 6d 62 65 72 5c 66 52 BserialNumber\fR
4ed0: 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 54 68 \fIstring\fR.Th
4ee0: 65 20 73 65 72 69 61 6c 20 6e 75 6d 62 65 72 20 e serial number
4ef0: 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 63 61 of the certifica
4f00: 74 65 20 61 73 20 61 20 68 65 78 20 73 74 72 69 te as a hex stri
4f10: 6e 67 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 ng\&..This value
4f20: 20 77 61 73 20 63 68 61 6e 67 65 64 20 66 72 6f was changed fro
4f30: 6d 20 73 65 72 69 61 6c 20 69 6e 20 54 63 6c 54 m serial in TclT
4f40: 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a LS 1\&.8\&...TP.
4f50: 5c 66 42 73 69 67 6e 61 74 75 72 65 5c 66 52 20 \fBsignature\fR
4f60: 5c 66 49 61 6c 67 6f 72 69 74 68 6d 5c 66 52 0a \fIalgorithm\fR.
4f70: 43 69 70 68 65 72 20 61 6c 67 6f 72 69 74 68 6d Cipher algorithm
4f80: 20 75 73 65 64 20 66 6f 72 20 63 65 72 74 69 66 used for certif
4f90: 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 5c icate signature\
4fa0: 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 &..This value is
4fb0: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
4fc0: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
4fd0: 69 73 73 75 65 72 5c 66 52 20 5c 66 49 73 74 72 issuer\fR \fIstr
4fe0: 69 6e 67 5c 66 52 0a 54 68 65 20 64 69 73 74 69 ing\fR.The disti
4ff0: 6e 67 75 69 73 68 65 64 20 6e 61 6d 65 20 28 44 nguished name (D
5000: 4e 29 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 N) of the certif
5010: 69 63 61 74 65 20 69 73 73 75 65 72 5c 26 2e 0a icate issuer\&..
5020: 2e 54 50 0a 5c 66 42 6e 6f 74 42 65 66 6f 72 65 .TP.\fBnotBefore
5030: 5c 66 52 20 5c 66 49 64 61 74 65 5c 66 52 0a 54 \fR \fIdate\fR.T
5040: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 64 61 74 he beginning dat
5050: 65 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 e of the certifi
5060: 63 61 74 65 20 76 61 6c 69 64 69 74 79 5c 26 2e cate validity\&.
5070: 0a 2e 54 50 0a 5c 66 42 6e 6f 74 41 66 74 65 72 ..TP.\fBnotAfter
5080: 5c 66 52 20 5c 66 49 64 61 74 65 5c 66 52 0a 54 \fR \fIdate\fR.T
5090: 68 65 20 65 78 70 69 72 61 74 69 6f 6e 20 64 61 he expiration da
50a0: 74 65 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 te of the certif
50b0: 69 63 61 74 65 20 76 61 6c 69 64 69 74 79 5c 26 icate validity\&
50c0: 2e 0a 2e 54 50 0a 5c 66 42 73 75 62 6a 65 63 74 ...TP.\fBsubject
50d0: 5c 66 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 \fR \fIstring\fR
50e0: 0a 54 68 65 20 64 69 73 74 69 6e 67 75 69 73 68 .The distinguish
50f0: 65 64 20 6e 61 6d 65 20 28 44 4e 29 20 6f 66 20 ed name (DN) of
5100: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
5110: 73 75 62 6a 65 63 74 5c 26 2e 20 46 69 65 6c 64 subject\&. Field
5120: 73 20 69 6e 63 6c 75 64 65 3a 20 43 6f 6d 6d 6f s include: Commo
5130: 6e 0a 4e 61 6d 65 20 28 43 4e 29 2c 20 4f 72 67 n.Name (CN), Org
5140: 61 6e 69 7a 61 74 69 6f 6e 20 28 4f 29 2c 20 4c anization (O), L
5150: 6f 63 61 6c 69 74 79 20 6f 72 20 43 69 74 79 20 ocality or City
5160: 28 4c 29 2c 20 53 74 61 74 65 20 6f 72 20 50 72 (L), State or Pr
5170: 6f 76 69 6e 63 65 20 28 53 29 2c 20 61 6e 64 0a ovince (S), and.
5180: 43 6f 75 6e 74 72 79 20 4e 61 6d 65 20 28 43 29 Country Name (C)
5190: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 69 73 73 75 65 \&...TP.\fBissue
51a0: 72 55 6e 69 71 75 65 49 44 5c 66 52 20 5c 66 49 rUniqueID\fR \fI
51b0: 73 74 72 69 6e 67 5c 66 52 0a 54 68 65 20 69 73 string\fR.The is
51c0: 73 75 65 72 20 75 6e 69 71 75 65 20 69 64 5c 26 suer unique id\&
51d0: 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
51e0: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
51f0: 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 \&.8\&...TP.\fBs
5200: 75 62 6a 65 63 74 55 6e 69 71 75 65 49 44 5c 66 ubjectUniqueID\f
5210: 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 54 R \fIstring\fR.T
5220: 68 65 20 73 75 62 6a 65 63 74 20 75 6e 69 71 75 he subject uniqu
5230: 65 20 69 64 5c 26 2e 0a 54 68 69 73 20 76 61 6c e id\&..This val
5240: 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 ue is new for Tc
5250: 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 lTLS 1\&.8\&...T
5260: 50 0a 5c 66 42 6e 75 6d 5f 65 78 74 65 6e 73 69 P.\fBnum_extensi
5270: 6f 6e 73 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 4e ons\fR \fIn\fR.N
5280: 75 6d 62 65 72 20 6f 66 20 63 65 72 74 69 66 69 umber of certifi
5290: 63 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 73 5c cate extensions\
52a0: 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 &..This value is
52b0: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
52c0: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
52d0: 65 78 74 65 6e 73 69 6f 6e 73 5c 66 52 20 5c 66 extensions\fR \f
52e0: 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 6f 66 Ilist\fR.List of
52f0: 20 63 65 72 74 69 66 69 63 61 74 65 20 65 78 74 certificate ext
5300: 65 6e 73 69 6f 6e 20 6e 61 6d 65 73 5c 26 2e 0a ension names\&..
5310: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
5320: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
5330: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 61 75 74 .8\&...TP.\fBaut
5340: 68 6f 72 69 74 79 4b 65 79 49 64 65 6e 74 69 66 horityKeyIdentif
5350: 69 65 72 5c 66 52 20 5c 66 49 73 74 72 69 6e 67 ier\fR \fIstring
5360: 5c 66 52 0a 41 75 74 68 6f 72 69 74 79 20 4b 65 \fR.Authority Ke
5370: 79 20 49 64 65 6e 74 69 66 69 65 72 20 28 41 4b y Identifier (AK
5380: 49 29 20 6f 66 20 74 68 65 20 49 73 73 75 69 6e I) of the Issuin
5390: 67 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 g CA certificate
53a0: 20 74 68 61 74 20 73 69 67 6e 65 64 20 74 68 65 that signed the
53b0: 0a 53 53 4c 20 63 65 72 74 69 66 69 63 61 74 65 .SSL certificate
53c0: 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 as a hex string
53d0: 5c 26 2e 20 54 68 69 73 20 76 61 6c 75 65 20 6d \&. This value m
53e0: 61 74 63 68 65 73 20 74 68 65 20 53 4b 49 20 76 atches the SKI v
53f0: 61 6c 75 65 20 6f 66 20 74 68 65 0a 49 6e 74 65 alue of the.Inte
5400: 72 6d 65 64 69 61 74 65 20 43 41 20 63 65 72 74 rmediate CA cert
5410: 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 20 ificate\&..This
5420: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
5430: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
5440: 0a 2e 54 50 0a 5c 66 42 73 75 62 6a 65 63 74 4b ..TP.\fBsubjectK
5450: 65 79 49 64 65 6e 74 69 66 69 65 72 5c 66 52 20 eyIdentifier\fR
5460: 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 53 75 62 \fIstring\fR.Sub
5470: 6a 65 63 74 20 4b 65 79 20 49 64 65 6e 74 69 66 ject Key Identif
5480: 69 65 72 20 28 53 4b 49 29 20 68 61 73 68 20 6f ier (SKI) hash o
5490: 66 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 79 f the public key
54a0: 20 69 6e 73 69 64 65 20 74 68 65 20 63 65 72 74 inside the cert
54b0: 69 66 69 63 61 74 65 20 61 73 20 61 0a 68 65 78 ificate as a.hex
54c0: 20 73 74 72 69 6e 67 5c 26 2e 20 55 73 65 64 20 string\&. Used
54d0: 74 6f 20 69 64 65 6e 74 69 66 79 20 63 65 72 74 to identify cert
54e0: 69 66 69 63 61 74 65 73 20 74 68 61 74 20 63 6f ificates that co
54f0: 6e 74 61 69 6e 20 61 20 70 61 72 74 69 63 75 6c ntain a particul
5500: 61 72 20 70 75 62 6c 69 63 20 6b 65 79 5c 26 2e ar public key\&.
5510: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5520: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
5530: 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 75 &.8\&...TP.\fBsu
5540: 62 6a 65 63 74 41 6c 74 4e 61 6d 65 5c 66 52 20 bjectAltName\fR
5550: 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 \fIlist\fR.List
5560: 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 20 53 75 of all of the Su
5570: 62 6a 65 63 74 20 41 6c 74 65 72 6e 61 74 69 76 bject Alternativ
5580: 65 20 4e 61 6d 65 73 20 28 53 41 4e 29 20 69 6e e Names (SAN) in
5590: 63 6c 75 64 69 6e 67 20 64 6f 6d 61 69 6e 20 6e cluding domain n
55a0: 61 6d 65 73 2c 20 73 75 62 0a 64 6f 6d 61 69 6e ames, sub.domain
55b0: 73 2c 20 61 6e 64 20 49 50 20 61 64 64 72 65 73 s, and IP addres
55c0: 73 65 73 20 74 68 61 74 20 61 72 65 20 73 65 63 ses that are sec
55d0: 75 72 65 64 20 62 79 20 74 68 65 20 63 65 72 74 ured by the cert
55e0: 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 20 ificate\&..This
55f0: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
5600: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
5610: 0a 2e 54 50 0a 5c 66 42 6f 63 73 70 5c 66 52 20 ..TP.\fBocsp\fR
5620: 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 \fIlist\fR.List
5630: 6f 66 20 61 6c 6c 20 4f 6e 6c 69 6e 65 20 43 65 of all Online Ce
5640: 72 74 69 66 69 63 61 74 65 20 53 74 61 74 75 73 rtificate Status
5650: 20 50 72 6f 74 6f 63 6f 6c 20 28 4f 43 53 50 29 Protocol (OCSP)
5660: 20 55 52 4c 73 20 74 68 61 74 20 63 61 6e 20 62 URLs that can b
5670: 65 20 75 73 65 64 20 74 6f 0a 63 68 65 63 6b 20 e used to.check
5680: 74 68 65 20 76 61 6c 69 64 69 74 79 20 6f 66 20 the validity of
5690: 74 68 69 73 20 63 65 72 74 69 66 69 63 61 74 65 this certificate
56a0: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
56b0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
56c0: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
56d0: 42 63 65 72 74 69 66 69 63 61 74 65 5c 66 52 20 Bcertificate\fR
56e0: 5c 66 49 63 65 72 74 5c 66 52 0a 54 68 65 20 50 \fIcert\fR.The P
56f0: 45 4d 20 65 6e 63 6f 64 65 64 20 63 65 72 74 69 EM encoded certi
5700: 66 69 63 61 74 65 5c 26 2e 0a 2e 54 50 0a 5c 66 ficate\&...TP.\f
5710: 42 73 69 67 6e 61 74 75 72 65 41 6c 67 6f 72 69 BsignatureAlgori
5720: 74 68 6d 5c 66 52 20 5c 66 49 61 6c 67 6f 72 69 thm\fR \fIalgori
5730: 74 68 6d 5c 66 52 0a 43 69 70 68 65 72 20 61 6c thm\fR.Cipher al
5740: 67 6f 72 69 74 68 6d 20 75 73 65 64 20 66 6f 72 gorithm used for
5750: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
5760: 20 73 69 67 6e 61 74 75 72 65 5c 26 2e 0a 54 68 signature\&..Th
5770: 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 is value is new
5780: 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 for TclTLS 1\&.8
5790: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 69 67 6e 61 \&...TP.\fBsigna
57a0: 74 75 72 65 56 61 6c 75 65 5c 66 52 20 5c 66 49 tureValue\fR \fI
57b0: 73 74 72 69 6e 67 5c 66 52 0a 43 65 72 74 69 66 string\fR.Certif
57c0: 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 20 icate signature
57d0: 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 5c as a hex string\
57e0: 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 &..This value is
57f0: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
5800: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
5810: 73 69 67 6e 61 74 75 72 65 44 69 67 65 73 74 5c signatureDigest\
5820: 66 52 20 5c 66 49 76 65 72 73 69 6f 6e 5c 66 52 fR \fIversion\fR
5830: 0a 43 65 72 74 69 66 69 63 61 74 65 20 73 69 67 .Certificate sig
5840: 6e 69 6e 67 20 64 69 67 65 73 74 20 61 73 20 61 ning digest as a
5850: 20 68 65 78 20 73 74 72 69 6e 67 5c 26 2e 0a 54 hex string\&..T
5860: 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 his value is new
5870: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
5880: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 75 62 6c 8\&...TP.\fBpubl
5890: 69 63 4b 65 79 41 6c 67 6f 72 69 74 68 6d 5c 66 icKeyAlgorithm\f
58a0: 52 20 5c 66 49 61 6c 67 6f 72 69 74 68 6d 5c 66 R \fIalgorithm\f
58b0: 52 0a 43 65 72 74 69 66 69 63 61 74 65 20 73 69 R.Certificate si
58c0: 67 6e 61 74 75 72 65 20 70 75 62 6c 69 63 20 6b gnature public k
58d0: 65 79 20 61 6c 67 6f 72 69 74 68 6d 5c 26 2e 0a ey algorithm\&..
58e0: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
58f0: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
5900: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 75 62 .8\&...TP.\fBpub
5910: 6c 69 63 4b 65 79 5c 66 52 20 5c 66 49 73 74 72 licKey\fR \fIstr
5920: 69 6e 67 5c 66 52 0a 43 65 72 74 69 66 69 63 61 ing\fR.Certifica
5930: 74 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 62 te signature pub
5940: 6c 69 63 20 6b 65 79 20 61 73 20 61 20 68 65 78 lic key as a hex
5950: 20 73 74 72 69 6e 67 5c 26 2e 0a 54 68 69 73 20 string\&..This
5960: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
5970: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
5980: 0a 2e 54 50 0a 5c 66 42 62 69 74 73 5c 66 52 20 ..TP.\fBbits\fR
5990: 5c 66 49 6e 5c 66 52 0a 4e 75 6d 62 65 72 20 6f \fIn\fR.Number o
59a0: 66 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 f bits used for
59b0: 63 65 72 74 69 66 69 63 61 74 65 20 73 69 67 6e certificate sign
59c0: 61 74 75 72 65 20 6b 65 79 5c 26 2e 0a 54 68 69 ature key\&..Thi
59d0: 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 s value is new f
59e0: 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c or TclTLS 1\&.8\
59f0: 26 2e 0a 2e 54 50 0a 5c 66 42 73 65 6c 66 5f 73 &...TP.\fBself_s
5a00: 69 67 6e 65 64 5c 66 52 20 5c 66 49 62 6f 6f 6c igned\fR \fIbool
5a10: 65 61 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 74 ean\fR.Whether t
5a20: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 73 he certificate s
5a30: 69 67 6e 61 74 75 72 65 20 69 73 20 73 65 6c 66 ignature is self
5a40: 20 73 69 67 6e 65 64 5c 26 2e 0a 54 68 69 73 20 signed\&..This
5a50: 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 value is new for
5a60: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
5a70: 0a 2e 54 50 0a 5c 66 42 73 68 61 31 5f 68 61 73 ..TP.\fBsha1_has
5a80: 68 5c 66 52 20 5c 66 49 68 61 73 68 5c 66 52 0a h\fR \fIhash\fR.
5a90: 54 68 65 20 53 48 41 31 20 68 61 73 68 20 6f 66 The SHA1 hash of
5aa0: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
5ab0: 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 as a hex string
5ac0: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
5ad0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
5ae0: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
5af0: 42 73 68 61 32 35 36 5f 68 61 73 68 5c 66 52 20 Bsha256_hash\fR
5b00: 5c 66 49 68 61 73 68 5c 66 52 0a 54 68 65 20 53 \fIhash\fR.The S
5b10: 48 41 32 35 36 20 68 61 73 68 20 6f 66 20 74 68 HA256 hash of th
5b20: 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 73 e certificate as
5b30: 20 61 20 68 65 78 20 73 74 72 69 6e 67 5c 26 2e a hex string\&.
5b40: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5b50: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
5b60: 26 2e 38 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c &.8\&...RE..TP.\
5b70: 66 42 74 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 6f fBtls::connectio
5b80: 6e 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c n\fR \fIchannel\
5b90: 66 52 0a 52 65 74 75 72 6e 73 20 74 68 65 20 63 fR.Returns the c
5ba0: 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63 74 69 6f urrent connectio
5bb0: 6e 20 73 74 61 74 75 73 20 6f 66 20 61 6e 20 53 n status of an S
5bc0: 53 4c 20 63 68 61 6e 6e 65 6c 5c 26 2e 20 54 68 SL channel\&. Th
5bd0: 65 20 72 65 73 75 6c 74 20 69 73 20 61 20 6c 69 e result is a li
5be0: 73 74 0a 6f 66 20 6b 65 79 2d 76 61 6c 75 65 20 st.of key-value
5bf0: 70 61 69 72 73 20 64 65 73 63 72 69 62 69 6e 67 pairs describing
5c00: 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 5c the connection\
5c10: 26 2e 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 &..This command
5c20: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
5c30: 53 20 31 5c 26 2e 38 5c 26 2e 20 52 65 74 75 72 S 1\&.8\&. Retur
5c40: 6e 65 64 20 76 61 6c 75 65 73 20 69 6e 63 6c 75 ned values inclu
5c50: 64 65 3a 0a 2e 73 70 0a 53 53 4c 20 53 74 61 74 de:..sp.SSL Stat
5c60: 75 73 0a 2e 52 53 0a 2e 54 50 0a 5c 66 42 73 74 us..RS..TP.\fBst
5c70: 61 74 65 5c 66 52 20 5c 66 49 73 74 61 74 65 5c ate\fR \fIstate\
5c80: 66 52 0a 53 74 61 74 65 20 6f 66 20 74 68 65 20 fR.State of the
5c90: 63 6f 6e 6e 65 63 74 69 6f 6e 5c 26 2e 0a 2e 54 connection\&...T
5ca0: 50 0a 5c 66 42 73 65 72 76 65 72 6e 61 6d 65 5c P.\fBservername\
5cb0: 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68 fR \fIname\fR.Th
5cc0: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f e name of the co
5cd0: 6e 6e 65 63 74 65 64 20 74 6f 20 73 65 72 76 65 nnected to serve
5ce0: 72 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 72 6f 74 r\&...TP.\fBprot
5cf0: 6f 63 6f 6c 5c 66 52 20 5c 66 49 76 65 72 73 69 ocol\fR \fIversi
5d00: 6f 6e 5c 66 52 0a 54 68 65 20 70 72 6f 74 6f 63 on\fR.The protoc
5d10: 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 20 ol version used
5d20: 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 for the connecti
5d30: 6f 6e 3a 20 53 53 4c 32 2c 20 53 53 4c 33 2c 20 on: SSL2, SSL3,
5d40: 54 4c 53 31 2c 20 54 4c 53 31 5c 26 2e 31 2c 20 TLS1, TLS1\&.1,
5d50: 54 4c 53 31 5c 26 2e 32 2c 20 54 4c 53 31 5c 26 TLS1\&.2, TLS1\&
5d60: 2e 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 5c 26 .3, or unknown\&
5d70: 2e 0a 2e 54 50 0a 5c 66 42 72 65 6e 65 67 6f 74 ...TP.\fBrenegot
5d80: 69 61 74 69 6f 6e 5f 61 6c 6c 6f 77 65 64 5c 66 iation_allowed\f
5d90: 52 20 5c 66 49 62 6f 6f 6c 65 61 6e 5c 66 52 0a R \fIboolean\fR.
5da0: 57 68 65 74 68 65 72 20 70 72 6f 74 6f 63 6f 6c Whether protocol
5db0: 20 72 65 6e 65 67 6f 74 69 61 74 69 6f 6e 20 69 renegotiation i
5dc0: 73 20 73 75 70 70 6f 72 74 65 64 20 6f 72 20 6e s supported or n
5dd0: 6f 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 65 63 ot\&...TP.\fBsec
5de0: 75 72 69 74 79 5f 6c 65 76 65 6c 5c 66 52 20 5c urity_level\fR \
5df0: 66 49 6c 65 76 65 6c 5c 66 52 0a 54 68 65 20 73 fIlevel\fR.The s
5e00: 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 75 73 ecurity level us
5e10: 65 64 20 66 6f 72 20 73 65 6c 65 63 74 69 6f 6e ed for selection
5e20: 20 6f 66 20 63 69 70 68 65 72 73 2c 20 6b 65 79 of ciphers, key
5e30: 20 73 69 7a 65 2c 20 65 74 63 5c 26 2e 0a 2e 54 size, etc\&...T
5e40: 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f 72 65 75 P.\fBsession_reu
5e50: 73 65 64 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 61 sed\fR \fIboolea
5e60: 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 74 68 65 n\fR.Whether the
5e70: 20 73 65 73 73 69 6f 6e 20 68 61 73 20 62 65 65 session has bee
5e80: 6e 20 72 65 75 73 65 64 20 6f 72 20 6e 6f 74 5c n reused or not\
5e90: 26 2e 0a 2e 54 50 0a 5c 66 42 69 73 5f 73 65 72 &...TP.\fBis_ser
5ea0: 76 65 72 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 61 ver\fR \fIboolea
5eb0: 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 74 68 65 n\fR.Whether the
5ec0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63 connection is c
5ed0: 6f 6e 66 69 67 75 72 65 64 20 61 73 20 61 20 73 onfigured as a s
5ee0: 65 72 76 65 72 20 28 31 29 20 6f 72 20 63 6c 69 erver (1) or cli
5ef0: 65 6e 74 20 28 30 29 5c 26 2e 0a 2e 54 50 0a 5c ent (0)\&...TP.\
5f00: 66 42 63 6f 6d 70 72 65 73 73 69 6f 6e 5c 66 52 fBcompression\fR
5f10: 20 5c 66 49 6d 6f 64 65 5c 66 52 0a 43 6f 6d 70 \fImode\fR.Comp
5f20: 72 65 73 73 69 6f 6e 20 6d 65 74 68 6f 64 5c 26 ression method\&
5f30: 2e 0a 2e 54 50 0a 5c 66 42 65 78 70 61 6e 73 69 ...TP.\fBexpansi
5f40: 6f 6e 5c 66 52 20 5c 66 49 6d 6f 64 65 5c 66 52 on\fR \fImode\fR
5f50: 0a 45 78 70 61 6e 73 69 6f 6e 20 6d 65 74 68 6f .Expansion metho
5f60: 64 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 61 4c 69 d\&...TP.\fBcaLi
5f70: 73 74 5c 66 52 20 5c 66 49 6c 69 73 74 5c 66 52 st\fR \fIlist\fR
5f80: 0a 4c 69 73 74 20 6f 66 20 43 65 72 74 69 66 69 .List of Certifi
5f90: 63 61 74 65 20 41 75 74 68 6f 72 69 74 69 65 73 cate Authorities
5fa0: 20 28 43 41 29 20 66 6f 72 20 58 5c 26 2e 35 30 (CA) for X\&.50
5fb0: 39 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 2e 9 certificate\&.
5fc0: 0a 2e 52 45 0a 2e 49 50 0a 43 69 70 68 65 72 20 ..RE..IP.Cipher
5fd0: 49 6e 66 6f 0a 2e 52 53 0a 2e 54 50 0a 5c 66 42 Info..RS..TP.\fB
5fe0: 63 69 70 68 65 72 5c 66 52 20 5c 66 49 63 69 70 cipher\fR \fIcip
5ff0: 68 65 72 5c 66 52 0a 54 68 65 20 63 75 72 72 65 her\fR.The curre
6000: 6e 74 20 63 69 70 68 65 72 20 69 6e 20 75 73 65 nt cipher in use
6010: 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 for the connect
6020: 69 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 74 ion\&...TP.\fBst
6030: 61 6e 64 61 72 64 5f 6e 61 6d 65 5c 66 52 20 5c andard_name\fR \
6040: 66 49 6e 61 6d 65 5c 66 52 0a 54 68 65 20 73 74 fIname\fR.The st
6050: 61 6e 64 61 72 64 20 52 46 43 20 6e 61 6d 65 20 andard RFC name
6060: 6f 66 20 63 69 70 68 65 72 5c 26 2e 0a 2e 54 50 of cipher\&...TP
6070: 0a 5c 66 42 61 6c 67 6f 72 69 74 68 6d 5f 62 69 .\fBalgorithm_bi
6080: 74 73 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 54 68 ts\fR \fIn\fR.Th
6090: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 72 6f 63 e number of proc
60a0: 65 73 73 65 64 20 62 69 74 73 20 75 73 65 64 20 essed bits used
60b0: 66 6f 72 20 63 69 70 68 65 72 5c 26 2e 0a 2e 54 for cipher\&...T
60c0: 50 0a 5c 66 42 73 65 63 72 65 74 5f 62 69 74 73 P.\fBsecret_bits
60d0: 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 54 68 65 20 \fR \fIn\fR.The
60e0: 6e 75 6d 62 65 72 20 6f 66 20 73 65 63 72 65 74 number of secret
60f0: 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 63 bits used for c
6100: 69 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 42 ipher\&...TP.\fB
6110: 6d 69 6e 5f 76 65 72 73 69 6f 6e 5c 66 52 20 5c min_version\fR \
6120: 66 49 76 65 72 73 69 6f 6e 5c 66 52 0a 54 68 65 fIversion\fR.The
6130: 20 6d 69 6e 69 6d 75 6d 20 70 72 6f 74 6f 63 6f minimum protoco
6140: 6c 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 63 69 l version for ci
6150: 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 pher\&...TP.\fBc
6160: 69 70 68 65 72 5f 69 73 5f 61 65 61 64 5c 66 52 ipher_is_aead\fR
6170: 20 5c 66 49 62 6f 6f 6c 65 61 6e 5c 66 52 0a 57 \fIboolean\fR.W
6180: 68 65 74 68 65 72 20 74 68 65 20 63 69 70 68 65 hether the ciphe
6190: 72 20 69 73 20 41 75 74 68 65 6e 74 69 63 61 74 r is Authenticat
61a0: 65 64 20 45 6e 63 72 79 70 74 69 6f 6e 20 77 69 ed Encryption wi
61b0: 74 68 20 41 73 73 6f 63 69 61 74 65 64 20 44 61 th Associated Da
61c0: 74 61 20 28 41 45 41 44 29 5c 26 2e 0a 2e 54 50 ta (AEAD)\&...TP
61d0: 0a 5c 66 42 63 69 70 68 65 72 5f 69 64 5c 66 52 .\fBcipher_id\fR
61e0: 20 5c 66 49 69 64 5c 66 52 0a 54 68 65 20 4f 70 \fIid\fR.The Op
61f0: 65 6e 53 53 4c 20 63 69 70 68 65 72 20 69 64 5c enSSL cipher id\
6200: 26 2e 0a 2e 54 50 0a 5c 66 42 64 65 73 63 72 69 &...TP.\fBdescri
6210: 70 74 69 6f 6e 5c 66 52 20 5c 66 49 73 74 72 69 ption\fR \fIstri
6220: 6e 67 5c 66 52 0a 41 20 74 65 78 74 20 64 65 73 ng\fR.A text des
6230: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20 cription of the
6240: 63 69 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 cipher\&...TP.\f
6250: 42 68 61 6e 64 73 68 61 6b 65 5f 64 69 67 65 73 Bhandshake_diges
6260: 74 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 61 6e 5c t\fR \fIboolean\
6270: 66 52 0a 44 69 67 65 73 74 20 75 73 65 64 20 64 fR.Digest used d
6280: 75 72 69 6e 67 20 68 61 6e 64 73 68 61 6b 65 5c uring handshake\
6290: 26 2e 0a 2e 52 45 0a 2e 49 50 0a 53 65 73 73 69 &...RE..IP.Sessi
62a0: 6f 6e 20 49 6e 66 6f 0a 2e 52 53 0a 2e 54 50 0a on Info..RS..TP.
62b0: 5c 66 42 61 6c 70 6e 5c 66 52 20 5c 66 49 70 72 \fBalpn\fR \fIpr
62c0: 6f 74 6f 63 6f 6c 5c 66 52 0a 54 68 65 20 70 72 otocol\fR.The pr
62d0: 6f 74 6f 63 6f 6c 20 73 65 6c 65 63 74 65 64 20 otocol selected
62e0: 61 66 74 65 72 20 41 70 70 6c 69 63 61 74 69 6f after Applicatio
62f0: 6e 2d 4c 61 79 65 72 20 50 72 6f 74 6f 63 6f 6c n-Layer Protocol
6300: 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 28 41 4c Negotiation (AL
6310: 50 4e 29 5c 26 2e 0a 2e 54 50 0a 5c 66 42 72 65 PN)\&...TP.\fBre
6320: 73 75 6d 61 62 6c 65 5c 66 52 20 5c 66 49 62 6f sumable\fR \fIbo
6330: 6f 6c 65 61 6e 5c 66 52 0a 57 68 65 74 68 65 72 olean\fR.Whether
6340: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 63 61 6e the session can
6350: 20 62 65 20 72 65 73 75 6d 65 64 20 6f 72 20 6e be resumed or n
6360: 6f 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 74 61 ot\&...TP.\fBsta
6370: 72 74 5f 74 69 6d 65 5c 66 52 20 5c 66 49 73 65 rt_time\fR \fIse
6380: 63 6f 6e 64 73 5c 66 52 0a 54 69 6d 65 20 73 69 conds\fR.Time si
6390: 6e 63 65 20 73 65 73 73 69 6f 6e 20 73 74 61 72 nce session star
63a0: 74 65 64 20 69 6e 20 73 65 63 6f 6e 64 73 20 73 ted in seconds s
63b0: 69 6e 63 65 20 65 70 6f 63 68 5c 26 2e 0a 2e 54 ince epoch\&...T
63c0: 50 0a 5c 66 42 74 69 6d 65 6f 75 74 5c 66 52 20 P.\fBtimeout\fR
63d0: 5c 66 49 73 65 63 6f 6e 64 73 5c 66 52 0a 4d 61 \fIseconds\fR.Ma
63e0: 78 20 64 75 72 61 74 69 6f 6e 20 6f 66 20 73 65 x duration of se
63f0: 73 73 69 6f 6e 20 69 6e 20 73 65 63 6f 6e 64 73 ssion in seconds
6400: 20 62 65 66 6f 72 65 20 74 69 6d 65 2d 6f 75 74 before time-out
6410: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 6c 69 66 65 74 \&...TP.\fBlifet
6420: 69 6d 65 5c 66 52 20 5c 66 49 73 65 63 6f 6e 64 ime\fR \fIsecond
6430: 73 5c 66 52 0a 53 65 73 73 69 6f 6e 20 74 69 63 s\fR.Session tic
6440: 6b 65 74 20 6c 69 66 65 74 69 6d 65 20 68 69 6e ket lifetime hin
6450: 74 20 69 6e 20 73 65 63 6f 6e 64 73 5c 26 2e 0a t in seconds\&..
6460: 2e 54 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f 69 .TP.\fBsession_i
6470: 64 5c 66 52 20 5c 66 49 62 69 6e 61 72 79 5f 73 d\fR \fIbinary_s
6480: 74 72 69 6e 67 5c 66 52 0a 55 6e 69 71 75 65 20 tring\fR.Unique
6490: 73 65 73 73 69 6f 6e 20 69 64 20 66 6f 72 20 75 session id for u
64a0: 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 20 74 se in resuming t
64b0: 68 65 20 73 65 73 73 69 6f 6e 5c 26 2e 0a 2e 54 he session\&...T
64c0: 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f 74 69 63 P.\fBsession_tic
64d0: 6b 65 74 5c 66 52 20 5c 66 49 62 69 6e 61 72 79 ket\fR \fIbinary
64e0: 5f 73 74 72 69 6e 67 5c 66 52 0a 55 6e 69 71 75 _string\fR.Uniqu
64f0: 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 e session ticket
6500: 20 66 6f 72 20 75 73 65 20 69 6e 20 72 65 73 75 for use in resu
6510: 6d 69 6e 67 20 74 68 65 20 73 65 73 73 69 6f 6e ming the session
6520: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 69 63 6b 65 \&...TP.\fBticke
6530: 74 5f 61 70 70 5f 64 61 74 61 5c 66 52 20 5c 66 t_app_data\fR \f
6540: 49 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 5c 66 Ibinary_string\f
6550: 52 0a 55 6e 69 71 75 65 20 73 65 73 73 69 6f 6e R.Unique session
6560: 20 74 69 63 6b 65 74 20 61 70 70 6c 69 63 61 74 ticket applicat
6570: 69 6f 6e 20 64 61 74 61 5c 26 2e 0a 2e 54 50 0a ion data\&...TP.
6580: 5c 66 42 6d 61 73 74 65 72 5f 6b 65 79 5c 66 52 \fBmaster_key\fR
6590: 20 5c 66 49 62 69 6e 61 72 79 5f 73 74 72 69 6e \fIbinary_strin
65a0: 67 5c 66 52 0a 55 6e 69 71 75 65 20 73 65 73 73 g\fR.Unique sess
65b0: 69 6f 6e 20 6d 61 73 74 65 72 20 6b 65 79 5c 26 ion master key\&
65c0: 2e 0a 2e 54 50 0a 5c 66 42 73 65 73 73 69 6f 6e ...TP.\fBsession
65d0: 5f 63 61 63 68 65 5f 6d 6f 64 65 5c 66 52 20 5c _cache_mode\fR \
65e0: 66 49 6d 6f 64 65 5c 66 52 0a 53 65 72 76 65 72 fImode\fR.Server
65f0: 20 63 61 63 68 65 20 6d 6f 64 65 20 28 63 6c 69 cache mode (cli
6600: 65 6e 74 2c 20 73 65 72 76 65 72 2c 20 6f 72 20 ent, server, or
6610: 62 6f 74 68 29 5c 26 2e 0a 2e 52 45 0a 2e 54 50 both)\&...RE..TP
6620: 0a 5c 66 42 74 6c 73 3a 3a 63 69 70 68 65 72 73 .\fBtls::ciphers
6630: 5c 66 52 20 3f 5c 66 49 70 72 6f 74 6f 63 6f 6c \fR ?\fIprotocol
6640: 5c 66 52 3f 20 3f 5c 66 49 76 65 72 62 6f 73 65 \fR? ?\fIverbose
6650: 5c 66 52 3f 20 3f 5c 66 49 73 75 70 70 6f 72 74 \fR? ?\fIsupport
6660: 65 64 5c 66 52 3f 0a 57 69 74 68 6f 75 74 20 61 ed\fR?.Without a
6670: 6e 79 20 6f 70 74 69 6f 6e 73 2c 20 69 74 20 72 ny options, it r
6680: 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 eturns a list of
6690: 20 61 6c 6c 20 73 79 6d 6d 65 74 72 69 63 20 63 all symmetric c
66a0: 69 70 68 65 72 73 20 66 6f 72 20 75 73 65 20 77 iphers for use w
66b0: 69 74 68 20 74 68 65 0a 5c 66 49 2d 63 69 70 68 ith the.\fI-ciph
66c0: 65 72 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e 20 er\fR option\&.
66d0: 57 69 74 68 20 5c 66 49 70 72 6f 74 6f 63 6f 6c With \fIprotocol
66e0: 5c 66 52 2c 20 6f 6e 6c 79 20 74 68 65 20 63 69 \fR, only the ci
66f0: 70 68 65 72 73 20 73 75 70 70 6f 72 74 65 64 20 phers supported
6700: 66 6f 72 20 74 68 61 74 0a 70 72 6f 74 6f 63 6f for that.protoco
6710: 6c 20 61 72 65 20 72 65 74 75 72 6e 65 64 5c 26 l are returned\&
6720: 2e 20 53 65 65 20 74 68 65 20 5c 66 42 74 6c 73 . See the \fBtls
6730: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 20 63 ::protocols\fR c
6740: 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 65 20 73 ommand for the s
6750: 75 70 70 6f 72 74 65 64 0a 70 72 6f 74 6f 63 6f upported.protoco
6760: 6c 73 5c 26 2e 20 49 66 20 5c 66 49 76 65 72 62 ls\&. If \fIverb
6770: 6f 73 65 5c 66 52 20 69 73 20 73 70 65 63 69 66 ose\fR is specif
6780: 69 65 64 20 61 73 20 74 72 75 65 20 74 68 65 6e ied as true then
6790: 20 61 20 76 65 72 62 6f 73 65 2c 20 68 75 6d 61 a verbose, huma
67a0: 6e 20 72 65 61 64 61 62 6c 65 0a 6c 69 73 74 20 n readable.list
67b0: 69 73 20 72 65 74 75 72 6e 65 64 20 77 69 74 68 is returned with
67c0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f additional info
67d0: 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 63 rmation on the c
67e0: 69 70 68 65 72 5c 26 2e 20 49 66 20 5c 66 49 73 ipher\&. If \fIs
67f0: 75 70 70 6f 72 74 65 64 5c 66 52 0a 69 73 20 73 upported\fR.is s
6800: 70 65 63 69 66 69 65 64 20 61 73 20 74 72 75 65 pecified as true
6810: 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 20 , then only the
6820: 63 69 70 68 65 72 73 20 73 75 70 70 6f 72 74 65 ciphers supporte
6830: 64 20 66 6f 72 20 70 72 6f 74 6f 63 6f 6c 20 77 d for protocol w
6840: 69 6c 6c 20 62 65 20 6c 69 73 74 65 64 5c 26 2e ill be listed\&.
6850: 0a 54 68 65 20 5c 66 49 73 75 70 70 6f 72 74 65 .The \fIsupporte
6860: 64 5c 66 52 20 61 72 67 20 69 73 20 6e 65 77 20 d\fR arg is new
6870: 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 for TclTLS 1\&.8
6880: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a \&...TP.\fBtls::
6890: 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 0a 52 65 74 protocols\fR.Ret
68a0: 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 74 urns a list of t
68b0: 68 65 20 73 75 70 70 6f 72 74 65 64 20 53 53 4c he supported SSL
68c0: 2f 54 4c 53 20 70 72 6f 74 6f 63 6f 6c 73 5c 26 /TLS protocols\&
68d0: 2e 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 61 . Valid values a
68e0: 72 65 3a 0a 5c 66 42 73 73 6c 32 5c 66 52 2c 20 re:.\fBssl2\fR,
68f0: 5c 66 42 73 73 6c 33 5c 66 52 2c 20 5c 66 42 74 \fBssl3\fR, \fBt
6900: 6c 73 31 5c 66 52 2c 20 5c 66 42 74 6c 73 31 5c ls1\fR, \fBtls1\
6910: 26 2e 31 5c 66 52 2c 20 5c 66 42 74 6c 73 31 5c &.1\fR, \fBtls1\
6920: 26 2e 32 5c 66 52 2c 20 61 6e 64 0a 5c 66 42 74 &.2\fR, and.\fBt
6930: 6c 73 31 5c 26 2e 33 5c 66 52 5c 26 2e 20 45 78 ls1\&.3\fR\&. Ex
6940: 61 63 74 20 6c 69 73 74 20 64 65 70 65 6e 64 73 act list depends
6950: 20 6f 6e 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 on OpenSSL vers
6960: 69 6f 6e 20 61 6e 64 20 63 6f 6d 70 69 6c 65 20 ion and compile
6970: 74 69 6d 65 20 66 6c 61 67 73 5c 26 2e 0a 54 68 time flags\&..Th
6980: 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e 65 is command is ne
6990: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
69a0: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 .8\&...TP.\fBtls
69b0: 3a 3a 76 65 72 73 69 6f 6e 5c 66 52 0a 52 65 74 ::version\fR.Ret
69c0: 75 72 6e 73 20 74 68 65 20 4f 70 65 6e 53 53 4c urns the OpenSSL
69d0: 20 76 65 72 73 69 6f 6e 20 73 74 72 69 6e 67 5c version string\
69e0: 26 2e 0a 2e 50 50 0a 2e 53 48 20 22 43 45 52 54 &...PP..SH "CERT
69f0: 49 46 49 43 41 54 45 20 56 41 4c 49 44 41 54 49 IFICATE VALIDATI
6a00: 4f 4e 22 0a 2e 53 53 20 22 50 4b 49 20 41 4e 44 ON"..SS "PKI AND
6a10: 20 43 45 52 54 49 46 49 43 41 54 45 53 22 0a 55 CERTIFICATES".U
6a20: 73 69 6e 67 20 74 68 65 20 50 75 62 6c 69 63 20 sing the Public
6a30: 4b 65 79 20 49 6e 66 72 61 73 74 72 75 63 74 75 Key Infrastructu
6a40: 72 65 20 28 50 4b 49 29 2c 20 65 61 63 68 20 75 re (PKI), each u
6a50: 73 65 72 20 63 72 65 61 74 65 73 20 61 20 70 72 ser creates a pr
6a60: 69 76 61 74 65 20 6b 65 79 20 74 68 61 74 0a 6f ivate key that.o
6a70: 6e 6c 79 20 74 68 65 79 20 6b 6e 6f 77 20 61 62 nly they know ab
6a80: 6f 75 74 20 61 6e 64 20 61 20 70 75 62 6c 69 63 out and a public
6a90: 20 6b 65 79 20 74 68 65 79 20 63 61 6e 20 65 78 key they can ex
6aa0: 63 68 61 6e 67 65 20 77 69 74 68 20 6f 74 68 65 change with othe
6ab0: 72 73 20 66 6f 72 20 75 73 65 20 69 6e 0a 65 6e rs for use in.en
6ac0: 63 72 79 70 74 69 6e 67 20 61 6e 64 20 64 65 63 crypting and dec
6ad0: 72 79 70 74 69 6e 67 20 64 61 74 61 5c 26 2e 20 rypting data\&.
6ae0: 54 68 65 20 70 72 6f 63 65 73 73 20 69 73 20 74 The process is t
6af0: 68 65 20 73 65 6e 64 65 72 20 65 6e 63 72 79 70 he sender encryp
6b00: 74 73 20 74 68 65 69 72 20 64 61 74 61 0a 75 73 ts their data.us
6b10: 69 6e 67 20 74 68 65 69 72 20 70 72 69 76 61 74 ing their privat
6b20: 65 20 6b 65 79 20 61 6e 64 20 74 68 65 20 72 65 e key and the re
6b30: 63 65 69 76 65 72 27 73 20 70 75 62 6c 69 63 20 ceiver's public
6b40: 6b 65 79 5c 26 2e 20 54 68 65 20 64 61 74 61 20 key\&. The data
6b50: 69 73 20 74 68 65 6e 20 73 65 6e 74 0a 74 6f 20 is then sent.to
6b60: 74 68 65 20 72 65 63 65 69 76 65 72 5c 26 2e 20 the receiver\&.
6b70: 49 6e 20 61 20 73 69 6d 69 6c 61 72 20 6d 61 6e In a similar man
6b80: 6e 65 72 2c 20 74 68 65 20 72 65 63 65 69 76 65 ner, the receive
6b90: 72 20 75 73 65 73 20 74 68 65 69 72 20 70 72 69 r uses their pri
6ba0: 76 61 74 65 20 6b 65 79 20 61 6e 64 0a 74 68 65 vate key and.the
6bb0: 20 73 65 6e 64 65 72 27 73 20 70 75 62 6c 69 63 sender's public
6bc0: 20 6b 65 79 20 74 6f 20 64 65 63 72 79 70 74 20 key to decrypt
6bd0: 74 68 65 20 64 61 74 61 5c 26 2e 20 54 68 69 73 the data\&. This
6be0: 20 70 72 6f 76 69 64 65 73 20 64 61 74 61 20 69 provides data i
6bf0: 6e 74 65 67 72 69 74 79 2c 20 74 6f 0a 65 6e 73 ntegrity, to.ens
6c00: 75 72 65 20 74 68 65 20 64 61 74 61 20 63 61 6e ure the data can
6c10: 27 74 20 62 65 20 76 69 65 77 65 64 20 6f 72 20 't be viewed or
6c20: 61 6c 74 65 72 65 64 20 64 75 72 69 6e 67 20 74 altered during t
6c30: 72 61 6e 73 70 6f 72 74 5c 26 2e 20 53 65 65 20 ransport\&. See
6c40: 74 68 65 0a 5c 66 42 2d 6b 65 79 5c 66 52 20 61 the.\fB-key\fR a
6c50: 6e 64 20 5c 66 42 2d 6b 65 79 66 69 6c 65 5c 66 nd \fB-keyfile\f
6c60: 52 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 68 6f R options for ho
6c70: 77 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 w to specify the
6c80: 20 70 72 69 76 61 74 65 20 6b 65 79 5c 26 2e 0a private key\&..
6c90: 41 6c 73 6f 20 73 65 65 20 74 68 65 20 5c 66 42 Also see the \fB
6ca0: 2d 70 61 73 73 77 6f 72 64 5c 66 52 20 6f 70 74 -password\fR opt
6cb0: 69 6f 6e 20 66 6f 72 20 68 6f 77 20 74 6f 20 70 ion for how to p
6cc0: 72 6f 76 69 64 65 20 74 68 65 20 70 61 73 73 77 rovide the passw
6cd0: 6f 72 64 5c 26 2e 0a 2e 50 50 0a 49 6e 20 6f 72 ord\&...PP.In or
6ce0: 64 65 72 20 74 6f 20 70 72 6f 76 69 64 65 20 61 der to provide a
6cf0: 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 2c 20 69 uthentication, i
6d00: 5c 26 2e 65 5c 26 2e 20 65 6e 73 75 72 69 6e 67 \&.e\&. ensuring
6d10: 20 73 6f 6d 65 6f 6e 65 20 69 73 20 77 68 6f 20 someone is who
6d20: 74 68 65 79 20 73 61 79 20 74 68 65 79 0a 61 72 they say they.ar
6d30: 65 2c 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 e, the public ke
6d40: 79 20 61 6e 64 20 75 73 65 72 20 69 64 65 6e 74 y and user ident
6d50: 69 66 69 63 61 74 69 6f 6e 20 69 6e 66 6f 20 69 ification info i
6d60: 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 58 5c s stored in a X\
6d70: 26 2e 35 30 39 0a 63 65 72 74 69 66 69 63 61 74 &.509.certificat
6d80: 65 20 61 6e 64 20 74 68 61 74 20 63 65 72 74 69 e and that certi
6d90: 66 69 63 61 74 65 20 69 73 20 61 75 74 68 65 6e ficate is authen
6da0: 74 69 63 61 74 65 64 20 28 69 5c 26 2e 65 5c 26 ticated (i\&.e\&
6db0: 2e 20 73 69 67 6e 65 64 29 20 62 79 20 61 20 43 . signed) by a C
6dc0: 65 72 74 69 66 69 63 61 74 65 0a 41 75 74 68 6f ertificate.Autho
6dd0: 72 69 74 79 20 28 43 41 29 5c 26 2e 20 55 73 65 rity (CA)\&. Use
6de0: 72 73 20 63 61 6e 20 74 68 65 6e 20 65 78 63 68 rs can then exch
6df0: 61 6e 67 65 20 74 68 65 73 65 20 63 65 72 74 69 ange these certi
6e00: 66 69 63 61 74 65 73 20 64 75 72 69 6e 67 20 74 ficates during t
6e10: 68 65 20 54 4c 53 0a 69 6e 69 74 69 61 6c 69 7a he TLS.initializ
6e20: 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 61 6e ation process an
6e30: 64 20 63 68 65 63 6b 20 74 68 65 6d 20 61 67 61 d check them aga
6e40: 69 6e 73 74 20 74 68 65 20 72 6f 6f 74 20 43 41 inst the root CA
6e50: 20 63 65 72 74 69 66 69 63 61 74 65 73 20 74 6f certificates to
6e60: 20 65 6e 73 75 72 65 0a 74 68 65 79 20 61 72 65 ensure.they are
6e70: 20 76 61 6c 69 64 5c 26 2e 20 54 68 69 73 20 69 valid\&. This i
6e80: 73 20 68 61 6e 64 6c 65 64 20 62 79 20 4f 70 65 s handled by Ope
6e90: 6e 53 53 4c 20 76 69 61 20 74 68 65 20 5c 66 42 nSSL via the \fB
6ea0: 2d 72 65 71 75 65 73 74 5c 66 52 20 61 6e 64 0a -request\fR and.
6eb0: 5c 66 42 2d 72 65 71 75 69 72 65 5c 66 52 20 6f \fB-require\fR o
6ec0: 70 74 69 6f 6e 73 5c 26 2e 20 53 65 65 20 74 68 ptions\&. See th
6ed0: 65 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 e \fB-cadir\fR,
6ee0: 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 61 6e \fB-cadir\fR, an
6ef0: 64 0a 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 52 d.\fB-castore\fR
6f00: 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 68 6f 77 options for how
6f10: 20 74 6f 20 73 70 65 63 69 66 79 20 77 68 65 72 to specify wher
6f20: 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 43 41 e to find the CA
6f30: 20 63 65 72 74 69 66 69 63 61 74 65 73 5c 26 2e certificates\&.
6f40: 0a 4f 70 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e 20 .Optionally, in
6f50: 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 a future release
6f60: 2c 20 74 68 65 79 20 63 61 6e 20 61 6c 73 6f 20 , they can also
6f70: 62 65 20 63 68 65 63 6b 65 64 20 61 67 61 69 6e be checked again
6f80: 73 74 20 74 68 65 20 43 65 72 74 69 66 69 63 61 st the Certifica
6f90: 74 65 0a 52 65 76 6f 63 61 74 69 6f 6e 20 4c 69 te.Revocation Li
6fa0: 73 74 20 28 43 52 4c 29 20 6f 66 20 72 65 76 6f st (CRL) of revo
6fb0: 6b 65 64 20 63 65 72 74 69 66 69 63 61 74 65 73 ked certificates
6fc0: 5c 26 2e 20 43 65 72 74 69 66 69 63 61 74 65 73 \&. Certificates
6fd0: 20 63 61 6e 20 61 6c 73 6f 20 62 65 0a 73 65 6c can also be.sel
6fe0: 66 2d 73 69 67 6e 65 64 2c 20 62 75 74 20 74 68 f-signed, but th
6ff0: 65 79 20 61 72 65 20 62 79 20 64 65 66 61 75 6c ey are by defaul
7000: 74 20 6e 6f 74 20 74 72 75 73 74 65 64 20 75 6e t not trusted un
7010: 6c 65 73 73 20 79 6f 75 20 61 64 64 20 74 68 65 less you add the
7020: 6d 20 74 6f 20 79 6f 75 72 0a 63 65 72 74 69 66 m to your.certif
7030: 69 63 61 74 65 20 73 74 6f 72 65 5c 26 2e 0a 2e icate store\&...
7040: 50 50 0a 54 79 70 69 63 61 6c 6c 79 20 77 68 65 PP.Typically whe
7050: 6e 20 76 69 73 69 74 69 6e 67 20 77 65 62 20 73 n visiting web s
7060: 69 74 65 73 2c 20 6f 6e 6c 79 20 74 68 65 20 63 ites, only the c
7070: 6c 69 65 6e 74 20 6e 65 65 64 73 20 74 6f 20 63 lient needs to c
7080: 68 65 63 6b 20 74 68 65 20 73 65 72 76 65 72 27 heck the server'
7090: 73 0a 63 65 72 74 69 66 69 63 61 74 65 20 74 6f s.certificate to
70a0: 20 65 6e 73 75 72 65 20 69 74 20 69 73 20 76 61 ensure it is va
70b0: 6c 69 64 5c 26 2e 20 54 68 65 20 73 65 72 76 65 lid\&. The serve
70c0: 72 20 64 6f 65 73 6e 27 74 20 6e 65 65 64 20 74 r doesn't need t
70d0: 6f 20 63 68 65 63 6b 20 74 68 65 20 63 6c 69 65 o check the clie
70e0: 6e 74 0a 63 65 72 74 69 66 69 63 61 74 65 20 75 nt.certificate u
70f0: 6e 6c 65 73 73 20 79 6f 75 20 6e 65 65 64 20 74 nless you need t
7100: 6f 20 61 75 74 68 65 6e 74 69 63 61 74 65 20 77 o authenticate w
7110: 69 74 68 20 74 68 65 6d 20 74 6f 20 6c 6f 67 69 ith them to logi
7120: 6e 2c 20 65 74 63 5c 26 2e 20 53 65 65 20 74 68 n, etc\&. See th
7130: 65 0a 5c 66 42 2d 63 65 72 74 5c 66 52 20 61 6e e.\fB-cert\fR an
7140: 64 20 5c 66 42 2d 63 65 72 74 66 69 6c 65 5c 66 d \fB-certfile\f
7150: 52 20 6f 70 74 69 6f 6e 73 20 69 66 20 79 6f 75 R options if you
7160: 20 6e 65 65 64 20 74 6f 20 70 72 6f 76 69 64 65 need to provide
7170: 20 61 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 a certificate\&
7180: 2e 0a 2e 53 53 20 22 53 55 4d 4d 41 52 59 20 4f ...SS "SUMMARY O
7190: 46 20 43 4f 4d 4d 41 4e 44 20 4c 49 4e 45 20 4f F COMMAND LINE O
71a0: 50 54 49 4f 4e 53 22 0a 54 68 65 20 66 6f 6c 6c PTIONS".The foll
71b0: 6f 77 69 6e 67 20 6f 70 74 69 6f 6e 73 20 61 72 owing options ar
71c0: 65 20 75 73 65 64 20 66 6f 72 20 70 65 65 72 20 e used for peer
71d0: 63 65 72 74 69 66 69 63 61 74 65 20 76 61 6c 69 certificate vali
71e0: 64 61 74 69 6f 6e 3a 0a 2e 54 50 0a 5c 66 42 2d dation:..TP.\fB-
71f0: 63 61 64 69 72 5c 66 52 20 5c 66 49 64 69 72 65 cadir\fR \fIdire
7200: 63 74 6f 72 79 5c 66 52 0a 53 70 65 63 69 66 69 ctory\fR.Specifi
7210: 65 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 es the directory
7220: 20 77 68 65 72 65 20 74 68 65 20 43 65 72 74 69 where the Certi
7230: 66 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 ficate Authority
7240: 20 28 43 41 29 20 63 65 72 74 69 66 69 63 61 74 (CA) certificat
7250: 65 73 20 61 72 65 0a 73 74 6f 72 65 64 5c 26 2e es are.stored\&.
7260: 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 The default is
7270: 70 6c 61 74 66 6f 72 6d 20 73 70 65 63 69 66 69 platform specifi
7280: 63 2c 20 62 75 74 20 69 73 20 75 73 75 61 6c 6c c, but is usuall
7290: 79 20 22 5c 66 49 2f 65 74 63 2f 73 73 6c 2f 63 y "\fI/etc/ssl/c
72a0: 65 72 74 73 5c 66 52 22 20 6f 6e 0a 4c 69 6e 75 erts\fR" on.Linu
72b0: 78 2f 55 6e 69 78 20 73 79 73 74 65 6d 73 5c 26 x/Unix systems\&
72c0: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 6c 6f . The default lo
72d0: 63 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 6f 76 cation can be ov
72e0: 65 72 72 69 64 64 65 6e 20 62 79 20 74 68 65 0a erridden by the.
72f0: 5c 66 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 5c \fBSSL_CERT_DIR\
7300: 66 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 fR environment v
7310: 61 72 69 61 62 6c 65 5c 26 2e 0a 2e 54 50 0a 5c ariable\&...TP.\
7320: 66 42 2d 63 61 66 69 6c 65 5c 66 52 20 5c 66 49 fB-cafile\fR \fI
7330: 66 69 6c 65 6e 61 6d 65 5c 66 52 0a 53 70 65 63 filename\fR.Spec
7340: 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 20 77 ifies the file w
7350: 69 74 68 20 74 68 65 20 43 65 72 74 69 66 69 63 ith the Certific
7360: 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 28 43 ate Authority (C
7370: 41 29 20 63 65 72 74 69 66 69 63 61 74 65 73 20 A) certificates
7380: 74 6f 20 75 73 65 20 69 6e 0a 5c 66 42 50 45 4d to use in.\fBPEM
7390: 5c 66 52 20 66 69 6c 65 20 66 6f 72 6d 61 74 5c \fR file format\
73a0: 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 &. The default i
73b0: 73 20 22 5c 66 49 63 65 72 74 5c 26 2e 70 65 6d s "\fIcert\&.pem
73c0: 5c 66 52 22 2c 20 69 6e 20 74 68 65 20 4f 70 65 \fR", in the Ope
73d0: 6e 53 53 4c 0a 64 69 72 65 63 74 6f 72 79 5c 26 nSSL.directory\&
73e0: 2e 20 4f 6e 20 4c 69 6e 75 78 2f 55 6e 69 78 20 . On Linux/Unix
73f0: 73 79 73 74 65 6d 73 2c 20 74 68 69 73 20 69 73 systems, this is
7400: 20 75 73 75 61 6c 6c 79 20 22 5c 66 49 2f 65 74 usually "\fI/et
7410: 63 2f 73 73 6c 2f 63 61 2d 62 75 6e 64 6c 65 5c c/ssl/ca-bundle\
7420: 26 2e 70 65 6d 5c 66 52 22 5c 26 2e 0a 54 68 65 &.pem\fR"\&..The
7430: 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 63 61 default file ca
7440: 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e 20 n be overridden
7450: 62 79 20 74 68 65 20 5c 66 42 53 53 4c 5f 43 45 by the \fBSSL_CE
7460: 52 54 5f 46 49 4c 45 5c 66 52 20 65 6e 76 69 72 RT_FILE\fR envir
7470: 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 62 6c 65 5c onment.variable\
7480: 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 61 73 74 6f &...TP.\fB-casto
7490: 72 65 5c 66 52 20 5c 66 49 55 52 49 5c 66 52 0a re\fR \fIURI\fR.
74a0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 55 6e Specifies the Un
74b0: 69 66 6f 72 6d 20 52 65 73 6f 75 72 63 65 20 49 iform Resource I
74c0: 64 65 6e 74 69 66 69 65 72 20 28 55 52 49 29 20 dentifier (URI)
74d0: 66 6f 72 20 74 68 65 20 43 65 72 74 69 66 69 63 for the Certific
74e0: 61 74 65 20 41 75 74 68 6f 72 69 74 79 0a 28 43 ate Authority.(C
74f0: 41 29 20 73 74 6f 72 65 2c 20 77 68 69 63 68 20 A) store, which
7500: 6d 61 79 20 62 65 20 61 20 73 69 6e 67 6c 65 20 may be a single
7510: 63 6f 6e 74 61 69 6e 65 72 20 6f 72 20 61 20 63 container or a c
7520: 61 74 61 6c 6f 67 20 6f 66 20 63 6f 6e 74 61 69 atalog of contai
7530: 6e 65 72 73 5c 26 2e 0a 53 74 61 72 74 69 6e 67 ners\&..Starting
7540: 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 33 5c with OpenSSL 3\
7550: 26 2e 32 20 6f 6e 20 4d 53 20 57 69 6e 64 6f 77 &.2 on MS Window
7560: 73 2c 20 73 65 74 20 74 6f 20 22 5c 66 42 6f 72 s, set to "\fBor
7570: 67 5c 26 2e 6f 70 65 6e 73 73 6c 5c 26 2e 77 69 g\&.openssl\&.wi
7580: 6e 73 74 6f 72 65 3a 2f 2f 5c 66 52 22 0a 74 6f nstore://\fR".to
7590: 20 75 73 65 20 74 68 65 20 62 75 69 6c 74 2d 69 use the built-i
75a0: 6e 20 4d 53 20 57 69 6e 64 6f 77 73 20 43 65 72 n MS Windows Cer
75b0: 74 69 66 69 63 61 74 65 20 53 74 6f 72 65 5c 26 tificate Store\&
75c0: 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 . Starting in Tc
75d0: 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 74 68 69 73 lTLS 2\&.0, this
75e0: 0a 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 .is the default
75f0: 69 66 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c if \fB-cadir\fR,
7600: 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 61 \fB-cadir\fR, a
7610: 6e 64 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 nd \fB-castore\f
7620: 52 20 61 72 65 0a 6e 6f 74 20 73 70 65 63 69 66 R are.not specif
7630: 69 65 64 5c 26 2e 20 54 68 69 73 20 73 74 6f 72 ied\&. This stor
7640: 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 73 20 e only supports
7650: 72 6f 6f 74 20 63 65 72 74 69 66 69 63 61 74 65 root certificate
7660: 20 73 74 6f 72 65 73 5c 26 2e 0a 2e 54 50 0a 5c stores\&...TP.\
7670: 66 42 2d 72 65 71 75 65 73 74 5c 66 52 20 5c 66 fB-request\fR \f
7680: 49 62 6f 6f 6c 5c 66 52 0a 52 65 71 75 65 73 74 Ibool\fR.Request
7690: 20 61 20 63 65 72 74 69 66 69 63 61 74 65 20 66 a certificate f
76a0: 72 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 rom the peer dur
76b0: 69 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 ing the SSL hand
76c0: 73 68 61 6b 65 5c 26 2e 20 54 68 69 73 20 69 73 shake\&. This is
76d0: 20 6e 65 65 64 65 64 0a 74 6f 20 64 6f 20 43 65 needed.to do Ce
76e0: 72 74 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 rtificate Valida
76f0: 74 69 6f 6e 5c 26 2e 20 53 74 61 72 74 69 6e 67 tion\&. Starting
7700: 20 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 in TclTLS 1\&.8
7710: 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 , the default is
7720: 0a 5c 66 42 74 72 75 65 5c 66 52 20 66 6f 72 20 .\fBtrue\fR for
7730: 63 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 6f client connectio
7740: 6e 73 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 69 ns\&. Starting i
7750: 6e 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 n TclTLS 2\&.0,
7760: 69 66 20 73 65 74 20 74 6f 0a 5c 66 42 66 61 6c if set to.\fBfal
7770: 73 65 5c 66 52 20 61 6e 64 20 5c 66 42 2d 72 65 se\fR and \fB-re
7780: 71 75 69 72 65 5c 66 52 20 69 73 20 5c 66 42 74 quire\fR is \fBt
7790: 72 75 65 5c 66 52 2c 20 74 68 65 6e 20 74 68 69 rue\fR, then thi
77a0: 73 20 77 69 6c 6c 20 62 65 0a 6f 76 65 72 72 69 s will be.overri
77b0: 64 64 65 6e 20 74 6f 20 5c 66 42 74 72 75 65 5c dden to \fBtrue\
77c0: 66 52 5c 26 2e 20 49 6e 20 61 64 64 69 74 69 6f fR\&. In additio
77d0: 6e 2c 20 74 68 65 20 63 6c 69 65 6e 74 20 63 61 n, the client ca
77e0: 6e 20 6d 61 6e 75 61 6c 6c 79 20 69 6e 73 70 65 n manually inspe
77f0: 63 74 20 61 6e 64 0a 61 63 63 65 70 74 20 6f 72 ct and.accept or
7800: 20 72 65 6a 65 63 74 20 65 61 63 68 20 63 65 72 reject each cer
7810: 74 69 66 69 63 61 74 65 20 75 73 69 6e 67 20 74 tificate using t
7820: 68 65 20 5c 66 42 2d 76 61 6c 69 64 61 74 65 63 he \fB-validatec
7830: 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e ommand\fR option
7840: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 72 65 71 75 \&...TP.\fB-requ
7850: 69 72 65 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 ire\fR \fIbool\f
7860: 52 0a 52 65 71 75 69 72 65 20 61 20 76 61 6c 69 R.Require a vali
7870: 64 20 63 65 72 74 69 66 69 63 61 74 65 20 66 72 d certificate fr
7880: 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 69 om the peer duri
7890: 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 73 ng the SSL hands
78a0: 68 61 6b 65 5c 26 2e 20 49 66 20 74 68 69 73 20 hake\&. If this
78b0: 69 73 0a 73 65 74 20 74 6f 20 74 72 75 65 2c 20 is.set to true,
78c0: 74 68 65 6e 20 5c 66 42 2d 72 65 71 75 65 73 74 then \fB-request
78d0: 5c 66 52 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 \fR must also be
78e0: 20 73 65 74 20 74 6f 20 74 72 75 65 20 61 6e 64 set to true and
78f0: 20 61 20 65 69 74 68 65 72 0a 5c 66 42 2d 63 61 a either.\fB-ca
7900: 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 61 66 69 dir\fR, \fB-cafi
7910: 6c 65 5c 66 52 2c 20 5c 66 42 2d 63 61 73 74 6f le\fR, \fB-casto
7920: 72 65 5c 66 52 2c 20 6f 72 20 61 20 70 6c 61 74 re\fR, or a plat
7930: 66 6f 72 6d 20 64 65 66 61 75 6c 74 0a 6d 75 73 form default.mus
7940: 74 20 62 65 20 70 72 6f 76 69 64 65 64 20 69 6e t be provided in
7950: 20 6f 72 64 65 72 20 74 6f 20 76 61 6c 69 64 61 order to valida
7960: 74 65 20 61 67 61 69 6e 73 74 5c 26 2e 20 54 68 te against\&. Th
7970: 65 20 64 65 66 61 75 6c 74 20 69 6e 20 54 63 6c e default in Tcl
7980: 54 4c 53 20 31 5c 26 2e 38 20 61 6e 64 0a 65 61 TLS 1\&.8 and.ea
7990: 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 69 rlier versions i
79a0: 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 20 73 69 s \fBfalse\fR si
79b0: 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 70 6c 61 74 nce not all plat
79c0: 66 6f 72 6d 73 20 68 61 76 65 20 63 65 72 74 69 forms have certi
79d0: 66 69 63 61 74 65 73 20 74 6f 0a 76 61 6c 69 64 ficates to.valid
79e0: 61 74 65 20 61 67 61 69 6e 73 74 20 69 6e 20 61 ate against in a
79f0: 20 66 6f 72 6d 20 63 6f 6d 70 61 74 69 62 6c 65 form compatible
7a00: 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 5c 26 2e with OpenSSL\&.
7a10: 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c Starting in Tcl
7a20: 54 4c 53 20 32 5c 26 2e 30 2c 0a 74 68 65 20 64 TLS 2\&.0,.the d
7a30: 65 66 61 75 6c 74 20 69 73 20 5c 66 42 74 72 75 efault is \fBtru
7a40: 65 5c 66 52 20 66 6f 72 20 63 6c 69 65 6e 74 20 e\fR for client
7a50: 63 6f 6e 6e 65 63 74 69 6f 6e 73 5c 26 2e 0a 2e connections\&...
7a60: 50 50 0a 2e 53 53 20 22 57 48 45 4e 20 41 52 45 PP..SS "WHEN ARE
7a70: 20 43 4f 4d 4d 41 4e 44 20 4c 49 4e 45 20 4f 50 COMMAND LINE OP
7a80: 54 49 4f 4e 53 20 4e 45 45 44 45 44 3f 22 0a 49 TIONS NEEDED?".I
7a90: 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 20 61 n TclTLS 1\&.8 a
7aa0: 6e 64 20 65 61 72 6c 69 65 72 20 76 65 72 73 69 nd earlier versi
7ab0: 6f 6e 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 ons, certificate
7ac0: 20 76 61 6c 69 64 61 74 69 6f 6e 20 69 73 0a 5c validation is.\
7ad0: 66 49 4e 4f 54 5c 66 52 20 65 6e 61 62 6c 65 64 fINOT\fR enabled
7ae0: 20 62 79 20 64 65 66 61 75 6c 74 5c 26 2e 20 54 by default\&. T
7af0: 68 69 73 20 6c 69 6d 69 74 61 74 69 6f 6e 20 69 his limitation i
7b00: 73 20 64 75 65 20 74 6f 20 74 68 65 20 6c 61 63 s due to the lac
7b10: 6b 20 6f 66 20 61 20 63 6f 6d 6d 6f 6e 0a 63 72 k of a common.cr
7b20: 6f 73 73 20 70 6c 61 74 66 6f 72 6d 20 64 61 74 oss platform dat
7b30: 61 62 61 73 65 20 6f 66 20 43 65 72 74 69 66 69 abase of Certifi
7b40: 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 28 cate Authority (
7b50: 43 41 29 20 70 72 6f 76 69 64 65 64 20 63 65 72 CA) provided cer
7b60: 74 69 66 69 63 61 74 65 73 20 74 6f 0a 76 61 6c tificates to.val
7b70: 69 64 61 74 65 20 61 67 61 69 6e 73 74 5c 26 2e idate against\&.
7b80: 20 4d 61 6e 79 20 4c 69 6e 75 78 20 73 79 73 74 Many Linux syst
7b90: 65 6d 73 20 6e 61 74 69 76 65 6c 79 20 73 75 70 ems natively sup
7ba0: 70 6f 72 74 20 4f 70 65 6e 53 53 4c 20 61 6e 64 port OpenSSL and
7bb0: 20 74 68 75 73 20 68 61 76 65 0a 74 68 65 73 65 thus have.these
7bc0: 20 63 65 72 74 69 66 69 63 61 74 65 73 20 69 6e certificates in
7bd0: 73 74 61 6c 6c 65 64 20 61 73 20 70 61 72 74 20 stalled as part
7be0: 6f 66 20 74 68 65 20 4f 53 2c 20 62 75 74 20 4d of the OS, but M
7bf0: 61 63 4f 53 20 61 6e 64 20 4d 53 20 57 69 6e 64 acOS and MS Wind
7c00: 6f 77 73 20 64 6f 20 6e 6f 74 5c 26 2e 0a 53 74 ows do not\&..St
7c10: 61 72 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 aring in TclTLS
7c20: 32 5c 26 2e 30 2c 20 74 68 65 20 64 65 66 61 75 2\&.0, the defau
7c30: 6c 74 20 66 6f 72 20 63 6c 69 65 6e 74 20 63 6f lt for client co
7c40: 6e 6e 65 63 74 69 6f 6e 73 20 68 61 73 20 62 65 nnections has be
7c50: 65 6e 20 63 68 61 6e 67 65 64 20 74 6f 0a 72 65 en changed to.re
7c60: 71 75 69 72 65 20 63 65 72 74 69 66 69 63 61 74 quire certificat
7c70: 65 20 76 61 6c 69 64 61 74 69 6f 6e 20 62 79 20 e validation by
7c80: 64 65 66 61 75 6c 74 5c 26 2e 20 49 6e 20 6f 72 default\&. In or
7c90: 64 65 72 20 74 6f 20 75 73 65 20 74 68 65 20 5c der to use the \
7ca0: 66 42 2d 72 65 71 75 69 72 65 5c 66 52 0a 6f 70 fB-require\fR.op
7cb0: 74 69 6f 6e 2c 20 6f 6e 65 20 6f 66 20 74 68 65 tion, one of the
7cc0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 75 73 74 20 following must
7cd0: 62 65 20 74 72 75 65 3a 0a 2e 49 50 20 5c 28 62 be true:..IP \(b
7ce0: 75 0a 4f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 55 u.On Linux and U
7cf0: 6e 69 78 20 73 79 73 74 65 6d 73 20 77 69 74 68 nix systems with
7d00: 20 4f 70 65 6e 53 53 4c 20 61 6c 72 65 61 64 79 OpenSSL already
7d10: 20 69 6e 73 74 61 6c 6c 65 64 20 6f 72 20 69 66 installed or if
7d20: 20 74 68 65 20 43 41 0a 63 65 72 74 69 66 69 63 the CA.certific
7d30: 61 74 65 73 20 61 72 65 20 61 76 61 69 6c 61 62 ates are availab
7d40: 6c 65 20 69 6e 20 50 45 4d 20 66 6f 72 6d 61 74 le in PEM format
7d50: 2c 20 61 6e 64 20 69 66 20 74 68 65 79 20 61 72 , and if they ar
7d60: 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a e stored in the.
7d70: 73 74 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 6f standard locatio
7d80: 6e 73 2c 20 6f 72 20 69 66 20 74 68 65 20 5c 66 ns, or if the \f
7d90: 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 5c 66 52 BSSL_CERT_DIR\fR
7da0: 20 6f 72 20 5c 66 42 53 53 4c 5f 43 45 52 54 5f or \fBSSL_CERT_
7db0: 46 49 4c 45 5c 66 52 0a 65 6e 76 69 72 6f 6e 6d FILE\fR.environm
7dc0: 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 61 72 ent variables ar
7dd0: 65 20 73 65 74 2c 20 74 68 65 6e 20 5c 66 42 2d e set, then \fB-
7de0: 63 61 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 61 cadir\fR, \fB-ca
7df0: 64 69 72 5c 66 52 2c 0a 61 6e 64 20 5c 66 42 2d dir\fR,.and \fB-
7e00: 63 61 73 74 6f 72 65 5c 66 52 20 61 72 65 6e 27 castore\fR aren'
7e10: 74 20 6e 65 65 64 65 64 5c 26 2e 0a 2e 49 50 20 t needed\&...IP
7e20: 5c 28 62 75 0a 49 66 20 4f 70 65 6e 53 53 4c 20 \(bu.If OpenSSL
7e30: 69 73 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65 64 is not installed
7e40: 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 20 in the default
7e50: 6c 6f 63 61 74 69 6f 6e 2c 20 6f 72 20 77 68 65 location, or whe
7e60: 6e 20 75 73 69 6e 67 20 4d 61 63 20 4f 53 0a 6f n using Mac OS.o
7e70: 72 20 4d 53 20 57 69 6e 64 6f 77 73 20 61 6e 64 r MS Windows and
7e80: 20 4f 70 65 6e 53 53 4c 20 69 73 20 69 6e 73 74 OpenSSL is inst
7e90: 61 6c 6c 65 64 2c 20 74 68 65 20 5c 66 42 53 53 alled, the \fBSS
7ea0: 4c 5f 43 45 52 54 5f 44 49 52 5c 66 52 20 61 6e L_CERT_DIR\fR an
7eb0: 64 2f 6f 72 0a 5c 66 42 53 53 4c 5f 43 45 52 54 d/or.\fBSSL_CERT
7ec0: 5f 46 49 4c 45 5c 66 52 20 65 6e 76 69 72 6f 6e _FILE\fR environ
7ed0: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 6f ment variables o
7ee0: 72 20 74 68 65 20 6f 6e 65 20 6f 66 20 74 68 65 r the one of the
7ef0: 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 0a 5c \fB-cadir\fR,.\
7f00: 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 6f 72 20 fB-cadir\fR, or
7f10: 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 6f \fB-castore\fR o
7f20: 70 74 69 6f 6e 73 20 6d 75 73 74 20 62 65 20 64 ptions must be d
7f30: 65 66 69 6e 65 64 5c 26 2e 0a 2e 49 50 20 5c 28 efined\&...IP \(
7f40: 62 75 0a 4f 6e 20 4d 53 20 57 69 6e 64 6f 77 73 bu.On MS Windows
7f50: 2c 20 73 74 61 72 74 69 6e 67 20 69 6e 20 4f 70 , starting in Op
7f60: 65 6e 53 53 4c 20 33 5c 26 2e 32 2c 20 69 74 20 enSSL 3\&.2, it
7f70: 69 73 20 6e 6f 77 20 70 6f 73 73 69 62 6c 65 20 is now possible
7f80: 74 6f 20 61 63 63 65 73 73 20 74 68 65 0a 62 75 to access the.bu
7f90: 69 6c 74 2d 69 6e 20 57 69 6e 64 6f 77 73 20 43 ilt-in Windows C
7fa0: 65 72 74 69 66 69 63 61 74 65 20 53 74 6f 72 65 ertificate Store
7fb0: 20 66 72 6f 6d 20 4f 70 65 6e 53 53 4c 5c 26 2e from OpenSSL\&.
7fc0: 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 74 69 This can be uti
7fd0: 6c 69 7a 65 64 20 62 79 0a 73 65 74 74 69 6e 67 lized by.setting
7fe0: 20 74 68 65 20 5c 66 42 2d 63 61 73 74 6f 72 65 the \fB-castore
7ff0: 5c 66 52 20 6f 70 74 69 6f 6e 20 74 6f 20 22 5c \fR option to "\
8000: 66 42 6f 72 67 5c 26 2e 6f 70 65 6e 73 73 6c 5c fBorg\&.openssl\
8010: 26 2e 77 69 6e 73 74 6f 72 65 3a 2f 2f 5c 66 52 &.winstore://\fR
8020: 22 5c 26 2e 0a 49 6e 20 54 63 6c 54 4c 53 20 32 "\&..In TclTLS 2
8030: 5c 26 2e 30 2c 20 74 68 69 73 20 69 73 20 74 68 \&.0, this is th
8040: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 e default value
8050: 69 66 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c if \fB-cadir\fR,
8060: 0a 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 61 .\fB-cadir\fR, a
8070: 6e 64 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 nd \fB-castore\f
8080: 52 20 61 72 65 20 6e 6f 74 20 73 70 65 63 69 66 R are not specif
8090: 69 65 64 5c 26 2e 0a 2e 49 50 20 5c 28 62 75 0a ied\&...IP \(bu.
80a0: 49 66 20 4f 70 65 6e 53 53 4c 20 69 73 20 6e 6f If OpenSSL is no
80b0: 74 20 69 6e 73 74 61 6c 6c 65 64 20 6f 72 20 74 t installed or t
80c0: 68 65 20 43 41 20 63 65 72 74 69 66 69 63 61 74 he CA certificat
80d0: 65 73 20 61 72 65 20 6e 6f 74 20 61 76 61 69 6c es are not avail
80e0: 61 62 6c 65 20 69 6e 20 50 45 4d 0a 66 6f 72 6d able in PEM.form
80f0: 61 74 2c 20 74 68 65 20 43 41 20 63 65 72 74 69 at, the CA certi
8100: 66 69 63 61 74 65 73 20 6d 75 73 74 20 62 65 20 ficates must be
8110: 64 6f 77 6e 6c 6f 61 64 65 64 20 61 6e 64 20 69 downloaded and i
8120: 6e 73 74 61 6c 6c 65 64 20 77 69 74 68 20 74 68 nstalled with th
8130: 65 20 75 73 65 72 0a 73 6f 66 74 77 61 72 65 5c e user.software\
8140: 26 2e 20 54 68 65 20 43 55 52 4c 20 74 65 61 6d &. The CURL team
8150: 20 6d 61 6b 65 73 20 74 68 65 6d 20 61 76 61 69 makes them avai
8160: 6c 61 62 6c 65 20 61 74 0a 5c 66 49 43 41 20 63 lable at.\fICA c
8170: 65 72 74 69 66 69 63 61 74 65 73 20 65 78 74 72 ertificates extr
8180: 61 63 74 65 64 0a 66 72 6f 6d 20 4d 6f 7a 69 6c acted.from Mozil
8190: 6c 61 5c 66 52 20 5b 68 74 74 70 73 3a 2f 2f 63 la\fR [https://c
81a0: 75 72 6c 5c 26 2e 73 65 2f 64 6f 63 73 2f 63 61 url\&.se/docs/ca
81b0: 65 78 74 72 61 63 74 5c 26 2e 68 74 6d 6c 5d 20 extract\&.html]
81c0: 69 6e 20 74 68 65 20 22 5c 66 49 63 61 63 65 72 in the "\fIcacer
81d0: 74 5c 26 2e 70 65 6d 5c 66 52 22 20 66 69 6c 65 t\&.pem\fR" file
81e0: 5c 26 2e 20 59 6f 75 20 6d 75 73 74 20 74 68 65 \&. You must the
81f0: 6e 20 65 69 74 68 65 72 20 73 65 74 20 74 68 65 n either set the
8200: 0a 5c 66 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 .\fBSSL_CERT_DIR
8210: 5c 66 52 20 61 6e 64 2f 6f 72 20 5c 66 42 53 53 \fR and/or \fBSS
8220: 4c 5f 43 45 52 54 5f 46 49 4c 45 5c 66 52 20 65 L_CERT_FILE\fR e
8230: 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 nvironment varia
8240: 62 6c 65 73 20 6f 72 20 74 68 65 0a 5c 66 42 2d bles or the.\fB-
8250: 63 61 64 69 72 5c 66 52 20 6f 72 20 5c 66 42 2d cadir\fR or \fB-
8260: 63 61 66 69 6c 65 5c 66 52 20 6f 70 74 69 6f 6e cafile\fR option
8270: 73 20 74 6f 20 74 68 65 20 43 41 20 63 65 72 74 s to the CA cert
8280: 20 66 69 6c 65 27 73 20 69 6e 73 74 61 6c 6c 0a file's install.
8290: 6c 6f 63 61 74 69 6f 6e 5c 26 2e 20 49 74 20 69 location\&. It i
82a0: 73 20 79 6f 75 72 20 72 65 73 70 6f 6e 73 69 62 s your responsib
82b0: 69 6c 69 74 79 20 74 6f 20 6b 65 65 70 20 74 68 ility to keep th
82c0: 69 73 20 66 69 6c 65 20 75 70 20 74 6f 20 64 61 is file up to da
82d0: 74 65 5c 26 2e 0a 2e 50 50 0a 2e 53 48 20 22 43 te\&...PP..SH "C
82e0: 41 4c 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 ALLBACK OPTIONS"
82f0: 0a 41 73 20 70 72 65 76 69 6f 75 73 6c 79 20 64 .As previously d
8300: 65 73 63 72 69 62 65 64 2c 20 65 61 63 68 20 63 escribed, each c
8310: 68 61 6e 6e 65 6c 20 63 61 6e 20 62 65 20 67 69 hannel can be gi
8320: 76 65 6e 20 74 68 65 69 72 20 6f 77 6e 20 63 61 ven their own ca
8330: 6c 6c 62 61 63 6b 73 0a 74 6f 20 68 61 6e 64 6c llbacks.to handl
8340: 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 70 e intermediate p
8350: 72 6f 63 65 73 73 69 6e 67 20 62 79 20 74 68 65 rocessing by the
8360: 20 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 OpenSSL library
8370: 2c 20 75 73 69 6e 67 20 74 68 65 0a 5c 66 42 2d , using the.\fB-
8380: 63 6f 6d 6d 61 6e 64 5c 66 52 2c 20 5c 66 42 2d command\fR, \fB-
8390: 70 61 73 73 77 6f 72 64 5c 66 52 2c 20 61 6e 64 password\fR, and
83a0: 20 5c 66 42 2d 76 61 6c 69 64 61 74 65 5f 63 6f \fB-validate_co
83b0: 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 73 mmand\fR options
83c0: 0a 70 61 73 73 65 64 20 74 6f 20 65 69 74 68 65 .passed to eithe
83d0: 72 20 6f 66 20 5c 66 42 74 6c 73 3a 3a 73 6f 63 r of \fBtls::soc
83e0: 6b 65 74 5c 66 52 20 6f 72 20 5c 66 42 74 6c 73 ket\fR or \fBtls
83f0: 3a 3a 69 6d 70 6f 72 74 5c 66 52 5c 26 2e 0a 55 ::import\fR\&..U
8400: 6e 6c 69 6b 65 20 70 72 65 76 69 6f 75 73 20 76 nlike previous v
8410: 65 72 73 69 6f 6e 73 20 6f 66 20 54 63 6c 54 4c ersions of TclTL
8420: 53 2c 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 63 S, only if the c
8430: 61 6c 6c 62 61 63 6b 20 67 65 6e 65 72 61 74 65 allback generate
8440: 73 20 61 6e 20 65 72 72 6f 72 2c 0a 77 69 6c 6c s an error,.will
8450: 20 74 68 65 20 5c 66 42 62 67 65 72 72 6f 72 5c the \fBbgerror\
8460: 66 52 20 63 6f 6d 6d 61 6e 64 20 62 65 20 69 6e fR command be in
8470: 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20 65 voked with the e
8480: 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e rror information
8490: 5c 26 2e 0a 2e 53 53 20 22 56 41 4c 55 45 53 20 \&...SS "VALUES
84a0: 46 4f 52 20 43 4f 4d 4d 41 4e 44 20 43 41 4c 4c FOR COMMAND CALL
84b0: 42 41 43 4b 22 0a 54 68 65 20 63 61 6c 6c 62 61 BACK".The callba
84c0: 63 6b 20 66 6f 72 20 74 68 65 20 5c 66 42 2d 63 ck for the \fB-c
84d0: 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e ommand\fR option
84e0: 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 73 is invoked at s
84f0: 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 20 64 75 everal points du
8500: 72 69 6e 67 20 74 68 65 0a 4f 70 65 6e 53 53 4c ring the.OpenSSL
8510: 20 68 61 6e 64 73 68 61 6b 65 20 61 6e 64 20 64 handshake and d
8520: 75 72 69 6e 67 20 72 6f 75 74 69 6e 65 20 6f 70 uring routine op
8530: 65 72 61 74 69 6f 6e 73 5c 26 2e 20 53 65 65 20 erations\&. See
8540: 62 65 6c 6f 77 20 66 6f 72 20 74 68 65 20 70 6f below for the po
8550: 73 73 69 62 6c 65 0a 61 72 67 75 6d 65 6e 74 73 ssible.arguments
8560: 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 63 passed to the c
8570: 61 6c 6c 62 61 63 6b 20 73 63 72 69 70 74 5c 26 allback script\&
8580: 2e 20 56 61 6c 75 65 73 20 72 65 74 75 72 6e 65 . Values returne
8590: 64 20 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 62 d from the callb
85a0: 61 63 6b 20 61 72 65 0a 69 67 6e 6f 72 65 64 5c ack are.ignored\
85b0: 26 2e 0a 2e 54 50 0a 5c 66 42 65 72 72 6f 72 5c &...TP.\fBerror\
85c0: 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 49 64 20 fR \fIchannelId
85d0: 6d 65 73 73 61 67 65 5c 66 52 0a 54 68 69 73 20 message\fR.This
85e0: 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 6b form of callback
85f0: 20 69 73 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e is invoked when
8600: 65 76 65 72 20 61 6e 20 65 72 72 6f 72 20 6f 63 ever an error oc
8610: 63 75 72 73 20 64 75 72 69 6e 67 20 74 68 65 20 curs during the
8620: 69 6e 69 74 69 61 6c 0a 63 6f 6e 6e 65 63 74 69 initial.connecti
8630: 6f 6e 2c 20 68 61 6e 64 73 68 61 6b 65 2c 20 6f on, handshake, o
8640: 72 20 49 2f 4f 20 6f 70 65 72 61 74 69 6f 6e 73 r I/O operations
8650: 5c 26 2e 20 54 68 65 20 5c 66 49 6d 65 73 73 61 \&. The \fImessa
8660: 67 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 20 63 ge\fR argument c
8670: 61 6e 20 62 65 0a 66 72 6f 6d 20 74 68 65 20 54 an be.from the T
8680: 63 6c 5f 45 72 72 6e 6f 4d 73 67 2c 20 4f 70 65 cl_ErrnoMsg, Ope
8690: 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 20 5c 66 nSSL function \f
86a0: 42 45 52 52 5f 72 65 61 73 6f 6e 5f 65 72 72 6f BERR_reason_erro
86b0: 72 5f 73 74 72 69 6e 67 28 29 5c 66 52 2c 0a 6f r_string()\fR,.o
86c0: 72 20 61 20 63 75 73 74 6f 6d 20 6d 65 73 73 61 r a custom messa
86d0: 67 65 5c 26 2e 20 54 68 69 73 20 63 61 6c 6c 62 ge\&. This callb
86e0: 61 63 6b 20 69 73 20 6e 65 77 20 66 6f 72 20 54 ack is new for T
86f0: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
8700: 54 50 0a 5c 66 42 69 6e 66 6f 5c 66 52 20 5c 66 TP.\fBinfo\fR \f
8710: 49 63 68 61 6e 6e 65 6c 49 64 20 6d 61 6a 6f 72 IchannelId major
8720: 20 6d 69 6e 6f 72 20 6d 65 73 73 61 67 65 20 74 minor message t
8730: 79 70 65 5c 66 52 0a 54 68 69 73 20 66 6f 72 6d ype\fR.This form
8740: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
8750: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f invoked by the O
8760: 70 65 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a penSSL function.
8770: 5c 66 42 53 53 4c 5f 73 65 74 5f 69 6e 66 6f 5f \fBSSL_set_info_
8780: 63 61 6c 6c 62 61 63 6b 28 29 5c 66 52 20 64 75 callback()\fR du
8790: 72 69 6e 67 20 74 68 65 20 69 6e 69 74 69 61 6c ring the initial
87a0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 6e 64 20 connection and
87b0: 68 61 6e 64 73 68 61 6b 65 0a 6f 70 65 72 61 74 handshake.operat
87c0: 69 6f 6e 73 5c 26 2e 20 54 68 65 20 61 72 67 75 ions\&. The argu
87d0: 6d 65 6e 74 73 20 61 72 65 3a 0a 2e 52 53 0a 2e ments are:..RS..
87e0: 54 50 0a 5c 66 49 6d 61 6a 6f 72 5c 66 52 0a 4d TP.\fImajor\fR.M
87f0: 61 6a 6f 72 20 63 61 74 65 67 6f 72 79 20 66 6f ajor category fo
8800: 72 20 65 72 72 6f 72 5c 26 2e 20 56 61 6c 69 64 r error\&. Valid
8810: 20 65 6e 75 6d 73 20 61 72 65 3a 20 5c 66 42 68 enums are: \fBh
8820: 61 6e 64 73 68 61 6b 65 5c 66 52 2c 20 5c 66 42 andshake\fR, \fB
8830: 61 6c 65 72 74 5c 66 52 2c 0a 5c 66 42 63 6f 6e alert\fR,.\fBcon
8840: 6e 65 63 74 5c 66 52 2c 20 5c 66 42 61 63 63 65 nect\fR, \fBacce
8850: 70 74 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 49 pt\fR\&...TP.\fI
8860: 6d 69 6e 6f 72 5c 66 52 0a 4d 69 6e 6f 72 20 63 minor\fR.Minor c
8870: 61 74 65 67 6f 72 79 20 66 6f 72 20 65 72 72 6f ategory for erro
8880: 72 5c 26 2e 20 56 61 6c 69 64 20 65 6e 75 6d 73 r\&. Valid enums
8890: 20 61 72 65 3a 20 5c 66 42 73 74 61 72 74 5c 66 are: \fBstart\f
88a0: 52 2c 20 5c 66 42 64 6f 6e 65 5c 66 52 2c 20 5c R, \fBdone\fR, \
88b0: 66 42 72 65 61 64 5c 66 52 2c 0a 5c 66 42 77 72 fBread\fR,.\fBwr
88c0: 69 74 65 5c 66 52 2c 20 5c 66 42 6c 6f 6f 70 5c ite\fR, \fBloop\
88d0: 66 52 2c 20 5c 66 42 65 78 69 74 5c 66 52 5c 26 fR, \fBexit\fR\&
88e0: 2e 0a 2e 54 50 0a 5c 66 49 6d 65 73 73 61 67 65 ...TP.\fImessage
88f0: 5c 66 52 0a 44 65 73 63 72 69 70 74 69 76 65 20 \fR.Descriptive
8900: 6d 65 73 73 61 67 65 20 73 74 72 69 6e 67 20 77 message string w
8910: 68 69 63 68 20 6d 61 79 20 62 65 20 67 65 6e 65 hich may be gene
8920: 72 61 74 65 64 20 65 69 74 68 65 72 20 62 79 0a rated either by.
8930: 5c 66 42 53 53 4c 5f 73 74 61 74 65 5f 73 74 72 \fBSSL_state_str
8940: 69 6e 67 5f 6c 6f 6e 67 28 29 5c 66 52 20 6f 72 ing_long()\fR or
8950: 20 5c 66 42 53 53 4c 5f 61 6c 65 72 74 5f 64 65 \fBSSL_alert_de
8960: 73 63 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 28 29 sc_string_long()
8970: 5c 66 52 2c 0a 64 65 70 65 6e 64 69 6e 67 20 6f \fR,.depending o
8980: 6e 20 74 68 65 20 63 6f 6e 74 65 78 74 5c 26 2e n the context\&.
8990: 0a 2e 54 50 0a 5c 66 49 74 79 70 65 5c 66 52 0a ..TP.\fItype\fR.
89a0: 46 6f 72 20 61 6c 65 72 74 73 2c 20 74 68 65 20 For alerts, the
89b0: 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 possible values
89c0: 61 72 65 3a 20 5c 66 42 77 61 72 6e 69 6e 67 5c are: \fBwarning\
89d0: 66 52 2c 0a 5c 66 42 66 61 74 61 6c 5c 66 52 2c fR,.\fBfatal\fR,
89e0: 20 61 6e 64 20 5c 66 42 75 6e 6b 6e 6f 77 6e 5c and \fBunknown\
89f0: 66 52 5c 26 2e 20 46 6f 72 20 6f 74 68 65 72 73 fR\&. For others
8a00: 2c 20 5c 66 42 69 6e 66 6f 5c 66 52 20 69 73 20 , \fBinfo\fR is
8a10: 75 73 65 64 5c 26 2e 0a 54 68 69 73 20 61 72 67 used\&..This arg
8a20: 75 6d 65 6e 74 20 69 73 20 6e 65 77 20 66 6f 72 ument is new for
8a30: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
8a40: 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 6d 65 73 73 ..RE..TP.\fBmess
8a50: 61 67 65 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 age\fR \fIchanne
8a60: 6c 49 64 20 64 69 72 65 63 74 69 6f 6e 20 76 65 lId direction ve
8a70: 72 73 69 6f 6e 20 63 6f 6e 74 65 6e 74 5f 74 79 rsion content_ty
8a80: 70 65 20 6d 65 73 73 61 67 65 5c 66 52 0a 54 68 pe message\fR.Th
8a90: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
8aa0: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
8ab0: 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 y the OpenSSL fu
8ac0: 6e 63 74 69 6f 6e 0a 5c 66 42 53 53 4c 5f 73 65 nction.\fBSSL_se
8ad0: 74 5f 6d 73 67 5f 63 61 6c 6c 62 61 63 6b 28 29 t_msg_callback()
8ae0: 5c 66 52 20 77 68 65 6e 65 76 65 72 20 61 20 6d \fR whenever a m
8af0: 65 73 73 61 67 65 20 69 73 20 73 65 6e 74 20 6f essage is sent o
8b00: 72 20 72 65 63 65 69 76 65 64 20 64 75 72 69 6e r received durin
8b10: 67 20 74 68 65 0a 69 6e 69 74 69 61 6c 20 63 6f g the.initial co
8b20: 6e 6e 65 63 74 69 6f 6e 2c 20 68 61 6e 64 73 68 nnection, handsh
8b30: 61 6b 65 2c 20 6f 72 20 49 2f 4f 20 6f 70 65 72 ake, or I/O oper
8b40: 61 74 69 6f 6e 73 5c 26 2e 20 49 74 20 69 73 20 ations\&. It is
8b50: 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77 only available w
8b60: 68 65 6e 0a 4f 70 65 6e 53 53 4c 20 69 73 20 63 hen.OpenSSL is c
8b70: 6f 6d 70 6c 69 65 64 20 77 69 74 68 20 74 68 65 omplied with the
8b80: 20 5c 66 42 65 6e 61 62 6c 65 2d 73 73 6c 2d 74 \fBenable-ssl-t
8b90: 72 61 63 65 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 race\fR option\&
8ba0: 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 . This callback
8bb0: 69 73 0a 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is.new for TclTL
8bc0: 53 20 31 5c 26 2e 38 5c 26 2e 20 54 68 65 20 61 S 1\&.8\&. The a
8bd0: 72 67 75 6d 65 6e 74 73 20 61 72 65 3a 0a 2e 52 rguments are:..R
8be0: 53 0a 2e 54 50 0a 5c 66 49 64 69 72 65 63 74 69 S..TP.\fIdirecti
8bf0: 6f 6e 5c 66 52 0a 44 69 72 65 63 74 69 6f 6e 20 on\fR.Direction
8c00: 69 73 20 65 69 74 68 65 72 20 5c 66 42 53 65 6e is either \fBSen
8c10: 74 5c 66 52 20 6f 72 20 5c 66 42 52 65 63 65 69 t\fR or \fBRecei
8c20: 76 65 64 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 ved\fR\&...TP.\f
8c30: 49 76 65 72 73 69 6f 6e 5c 66 52 0a 56 65 72 73 Iversion\fR.Vers
8c40: 69 6f 6e 20 69 73 20 74 68 65 20 70 72 6f 74 6f ion is the proto
8c50: 63 6f 6c 20 76 65 72 73 69 6f 6e 5c 26 2e 0a 2e col version\&...
8c60: 54 50 0a 5c 66 49 63 6f 6e 74 65 6e 74 5f 74 79 TP.\fIcontent_ty
8c70: 70 65 5c 66 52 0a 43 6f 6e 74 65 6e 74 20 74 79 pe\fR.Content ty
8c80: 70 65 20 69 73 20 74 68 65 20 6d 65 73 73 61 67 pe is the messag
8c90: 65 20 63 6f 6e 74 65 6e 74 20 74 79 70 65 5c 26 e content type\&
8ca0: 2e 0a 2e 54 50 0a 5c 66 49 6d 65 73 73 61 67 65 ...TP.\fImessage
8cb0: 5c 66 52 0a 4d 65 73 73 61 67 65 20 69 73 20 6d \fR.Message is m
8cc0: 6f 72 65 20 69 6e 66 6f 20 66 72 6f 6d 20 74 68 ore info from th
8cd0: 65 20 5c 66 42 53 53 4c 5f 74 72 61 63 65 5c 66 e \fBSSL_trace\f
8ce0: 52 20 41 50 49 5c 26 2e 0a 2e 52 45 0a 2e 54 50 R API\&...RE..TP
8cf0: 0a 5c 66 42 73 65 73 73 69 6f 6e 5c 66 52 20 5c .\fBsession\fR \
8d00: 66 49 63 68 61 6e 6e 65 6c 49 64 20 73 65 73 73 fIchannelId sess
8d10: 69 6f 6e 5f 69 64 20 73 65 73 73 69 6f 6e 5f 74 ion_id session_t
8d20: 69 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 5c 66 icket lifetime\f
8d30: 52 0a 54 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 R.This form of c
8d40: 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b allback is invok
8d50: 65 64 20 62 79 20 74 68 65 20 4f 70 65 6e 53 53 ed by the OpenSS
8d60: 4c 20 66 75 6e 63 74 69 6f 6e 0a 5c 66 42 53 53 L function.\fBSS
8d70: 4c 5f 43 54 58 5f 73 65 73 73 5f 73 65 74 5f 6e L_CTX_sess_set_n
8d80: 65 77 5f 63 62 28 29 5c 66 52 20 77 68 65 6e 65 ew_cb()\fR whene
8d90: 76 65 72 20 61 20 6e 65 77 20 73 65 73 73 69 6f ver a new sessio
8da0: 6e 20 69 64 20 69 73 20 73 65 6e 74 20 62 79 20 n id is sent by
8db0: 74 68 65 0a 73 65 72 76 65 72 20 64 75 72 69 6e the.server durin
8dc0: 67 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f g the initial co
8dd0: 6e 6e 65 63 74 69 6f 6e 20 61 6e 64 20 68 61 6e nnection and han
8de0: 64 73 68 61 6b 65 20 61 6e 64 20 61 6c 73 6f 20 dshake and also
8df0: 64 75 72 69 6e 67 20 74 68 65 20 73 65 73 73 69 during the sessi
8e00: 6f 6e 0a 69 66 20 74 68 65 20 5c 66 42 2d 70 6f on.if the \fB-po
8e10: 73 74 5f 68 61 6e 64 73 68 61 6b 65 5c 66 52 20 st_handshake\fR
8e20: 6f 70 74 69 6f 6e 20 69 73 20 73 65 74 20 74 6f option is set to
8e30: 20 74 72 75 65 5c 26 2e 20 54 68 69 73 20 63 61 true\&. This ca
8e40: 6c 6c 62 61 63 6b 20 69 73 20 6e 65 77 20 66 6f llback is new fo
8e50: 72 0a 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r.TclTLS 1\&.8\&
8e60: 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 . The arguments
8e70: 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c 66 49 are:..RS..TP.\fI
8e80: 73 65 73 73 69 6f 6e 5f 69 64 5c 66 52 0a 53 65 session_id\fR.Se
8e90: 73 73 69 6f 6e 20 49 64 20 69 73 20 74 68 65 20 ssion Id is the
8ea0: 63 75 72 72 65 6e 74 20 73 65 73 73 69 6f 6e 20 current session
8eb0: 69 64 65 6e 74 69 66 69 65 72 0a 2e 54 50 0a 5c identifier..TP.\
8ec0: 66 49 73 65 73 73 69 6f 6e 5f 74 69 63 6b 65 74 fIsession_ticket
8ed0: 5c 66 52 0a 54 69 63 6b 65 74 20 69 73 20 74 68 \fR.Ticket is th
8ee0: 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 e session ticket
8ef0: 20 69 6e 66 6f 0a 2e 54 50 0a 5c 66 49 6c 69 66 info..TP.\fIlif
8f00: 65 74 69 6d 65 5c 66 52 0a 4c 69 66 65 74 69 6d etime\fR.Lifetim
8f10: 65 20 69 73 20 74 68 65 20 74 69 63 6b 65 74 20 e is the ticket
8f20: 6c 69 66 65 74 69 6d 65 20 69 6e 20 73 65 63 6f lifetime in seco
8f30: 6e 64 73 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c nds\&...RE..TP.\
8f40: 66 42 76 65 72 69 66 79 5c 66 52 20 5c 66 49 63 fBverify\fR \fIc
8f50: 68 61 6e 6e 65 6c 49 64 20 64 65 70 74 68 20 63 hannelId depth c
8f60: 65 72 74 20 73 74 61 74 75 73 20 65 72 72 6f 72 ert status error
8f70: 5c 66 52 0a 54 68 69 73 20 63 61 6c 6c 62 61 63 \fR.This callbac
8f80: 6b 20 77 61 73 20 6d 6f 76 65 64 20 74 6f 20 5c k was moved to \
8f90: 66 42 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 fB-validatecomma
8fa0: 6e 64 5c 66 52 20 69 6e 20 54 63 6c 54 4c 53 20 nd\fR in TclTLS
8fb0: 31 5c 26 2e 38 5c 26 2e 0a 2e 50 50 0a 2e 53 53 1\&.8\&...PP..SS
8fc0: 20 22 56 41 4c 55 45 53 20 46 4f 52 20 50 41 53 "VALUES FOR PAS
8fd0: 53 57 4f 52 44 20 43 41 4c 4c 42 41 43 4b 22 0a SWORD CALLBACK".
8fe0: 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 The callback for
8ff0: 20 74 68 65 20 5c 66 42 2d 70 61 73 73 77 6f 72 the \fB-passwor
9000: 64 5c 66 52 20 6f 70 74 69 6f 6e 20 69 73 20 69 d\fR option is i
9010: 6e 76 6f 6b 65 64 20 62 79 20 54 63 6c 54 4c 53 nvoked by TclTLS
9020: 20 77 68 65 6e 65 76 65 72 20 4f 70 65 6e 53 53 whenever OpenSS
9030: 4c 20 6e 65 65 64 73 0a 74 6f 20 6f 62 74 61 69 L needs.to obtai
9040: 6e 20 61 20 70 61 73 73 77 6f 72 64 5c 26 2e 20 n a password\&.
9050: 53 65 65 20 62 65 6c 6f 77 20 66 6f 72 20 74 68 See below for th
9060: 65 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d e possible argum
9070: 65 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 ents passed to t
9080: 68 65 0a 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 he.callback scri
9090: 70 74 5c 26 2e 20 54 68 65 20 75 73 65 72 20 70 pt\&. The user p
90a0: 72 6f 76 69 64 65 64 20 70 61 73 73 77 6f 72 64 rovided password
90b0: 20 69 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 is expected to
90c0: 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 be returned by t
90d0: 68 65 0a 63 61 6c 6c 62 61 63 6b 5c 26 2e 0a 2e he.callback\&...
90e0: 54 50 0a 5c 66 42 70 61 73 73 77 6f 72 64 5c 66 TP.\fBpassword\f
90f0: 52 20 5c 66 49 72 77 66 6c 61 67 20 73 69 7a 65 R \fIrwflag size
9100: 5c 66 52 0a 49 6e 76 6f 6b 65 64 20 77 68 65 6e \fR.Invoked when
9110: 20 6c 6f 61 64 69 6e 67 20 6f 72 20 73 74 6f 72 loading or stor
9120: 69 6e 67 20 61 6e 20 65 6e 63 72 79 70 74 65 64 ing an encrypted
9130: 20 50 45 4d 20 63 65 72 74 69 66 69 63 61 74 65 PEM certificate
9140: 5c 26 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 \&. The argument
9150: 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c s are:..RS..TP.\
9160: 66 49 72 77 66 6c 61 67 5c 66 52 0a 54 68 65 20 fIrwflag\fR.The
9170: 72 65 61 64 2f 77 72 69 74 65 20 66 6c 61 67 20 read/write flag
9180: 69 73 20 30 20 66 6f 72 20 72 65 61 64 69 6e 67 is 0 for reading
9190: 2f 64 65 63 72 79 70 74 69 6f 6e 20 6f 72 20 31 /decryption or 1
91a0: 20 66 6f 72 20 77 72 69 74 69 6e 67 2f 65 6e 63 for writing/enc
91b0: 72 79 70 74 69 6f 6e 5c 26 2e 0a 54 68 65 20 6c ryption\&..The l
91c0: 61 74 74 65 72 20 63 61 6e 20 62 65 20 75 73 65 atter can be use
91d0: 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 d to determine w
91e0: 68 65 6e 20 74 6f 20 70 72 6f 6d 70 74 20 74 68 hen to prompt th
91f0: 65 20 75 73 65 72 20 74 6f 20 63 6f 6e 66 69 72 e user to confir
9200: 6d 5c 26 2e 0a 54 68 69 73 20 61 72 67 75 6d 65 m\&..This argume
9210: 6e 74 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 nt is new for Tc
9220: 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 lTLS 1\&.8\&...T
9230: 50 0a 5c 66 49 73 69 7a 65 5c 66 52 0a 54 68 65 P.\fIsize\fR.The
9240: 20 73 69 7a 65 20 69 73 20 74 68 65 20 6d 61 78 size is the max
9250: 69 6d 75 6d 20 6c 65 6e 67 74 68 20 6f 66 20 74 imum length of t
9260: 68 65 20 70 61 73 73 77 6f 72 64 20 69 6e 20 62 he password in b
9270: 79 74 65 73 5c 26 2e 0a 54 68 69 73 20 61 72 67 ytes\&..This arg
9280: 75 6d 65 6e 74 20 69 73 20 6e 65 77 20 66 6f 72 ument is new for
9290: 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e TclTLS 1\&.8\&.
92a0: 0a 2e 52 45 0a 2e 50 50 0a 2e 53 53 20 22 56 41 ..RE..PP..SS "VA
92b0: 4c 55 45 53 20 46 4f 52 20 56 41 4c 49 44 41 54 LUES FOR VALIDAT
92c0: 45 20 43 4f 4d 4d 41 4e 44 20 43 41 4c 4c 42 41 E COMMAND CALLBA
92d0: 43 4b 22 0a 54 68 65 20 63 61 6c 6c 62 61 63 6b CK".The callback
92e0: 20 66 6f 72 20 74 68 65 20 5c 66 42 2d 76 61 6c for the \fB-val
92f0: 69 64 61 74 65 63 6f 6d 6d 61 6e 64 5c 66 52 20 idatecommand\fR
9300: 6f 70 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 option is invoke
9310: 64 20 64 75 72 69 6e 67 20 74 68 65 20 68 61 6e d during the han
9320: 64 73 68 61 6b 65 0a 70 72 6f 63 65 73 73 20 69 dshake.process i
9330: 6e 20 6f 72 64 65 72 20 66 6f 72 20 74 68 65 20 n order for the
9340: 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 6f 20 76 application to v
9350: 61 6c 69 64 61 74 65 20 74 68 65 20 70 72 6f 76 alidate the prov
9360: 69 64 65 64 20 76 61 6c 75 65 28 73 29 5c 26 2e ided value(s)\&.
9370: 20 53 65 65 0a 62 65 6c 6f 77 20 66 6f 72 20 74 See.below for t
9380: 68 65 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 he possible argu
9390: 6d 65 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 ments passed to
93a0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 63 72 the callback scr
93b0: 69 70 74 5c 26 2e 20 49 66 20 6e 6f 74 0a 73 70 ipt\&. If not.sp
93c0: 65 63 69 66 69 65 64 2c 20 4f 70 65 6e 53 53 4c ecified, OpenSSL
93d0: 20 77 69 6c 6c 20 61 63 63 65 70 74 20 61 6c 6c will accept all
93e0: 20 76 61 6c 69 64 20 63 65 72 74 69 66 69 63 61 valid certifica
93f0: 74 65 73 20 61 6e 64 20 65 78 74 65 6e 73 69 6f tes and extensio
9400: 6e 73 5c 26 2e 20 54 6f 20 72 65 6a 65 63 74 0a ns\&. To reject.
9410: 74 68 65 20 76 61 6c 75 65 20 61 6e 64 20 61 62 the value and ab
9420: 6f 72 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 ort the connecti
9430: 6f 6e 2c 20 74 68 65 20 63 61 6c 6c 62 61 63 6b on, the callback
9440: 20 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 30 should return 0
9450: 5c 26 2e 20 54 6f 20 61 63 63 65 70 74 20 74 68 \&. To accept th
9460: 65 0a 76 61 6c 75 65 20 61 6e 64 20 63 6f 6e 74 e.value and cont
9470: 69 6e 75 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 inue the connect
9480: 69 6f 6e 2c 20 69 74 20 73 68 6f 75 6c 64 20 72 ion, it should r
9490: 65 74 75 72 6e 20 31 5c 26 2e 20 54 6f 20 72 65 eturn 1\&. To re
94a0: 6a 65 63 74 20 74 68 65 20 76 61 6c 75 65 2c 20 ject the value,
94b0: 62 75 74 0a 63 6f 6e 74 69 6e 75 65 20 74 68 65 but.continue the
94c0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 74 20 connection, it
94d0: 73 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 32 5c should return 2\
94e0: 26 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 63 6b &. This callback
94f0: 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 is new for TclT
9500: 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a LS 1\&.8\&...TP.
9510: 5c 66 42 61 6c 70 6e 5c 66 52 20 5c 66 49 63 68 \fBalpn\fR \fIch
9520: 61 6e 6e 65 6c 49 64 20 70 72 6f 74 6f 63 6f 6c annelId protocol
9530: 20 6d 61 74 63 68 5c 66 52 0a 46 6f 72 20 73 65 match\fR.For se
9540: 72 76 65 72 73 2c 20 74 68 69 73 20 66 6f 72 6d rvers, this form
9550: 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 of callback is
9560: 69 6e 76 6f 6b 65 64 20 77 68 65 6e 20 74 68 65 invoked when the
9570: 20 63 6c 69 65 6e 74 20 41 4c 50 4e 20 65 78 74 client ALPN ext
9580: 65 6e 73 69 6f 6e 20 69 73 0a 72 65 63 65 69 76 ension is.receiv
9590: 65 64 5c 26 2e 20 49 66 20 5c 66 49 6d 61 74 63 ed\&. If \fImatc
95a0: 68 5c 66 52 20 69 73 20 74 72 75 65 2c 20 74 68 h\fR is true, th
95b0: 65 6e 20 5c 66 49 70 72 6f 74 6f 63 6f 6c 5c 66 en \fIprotocol\f
95c0: 52 20 69 73 20 74 68 65 20 66 69 72 73 74 0a 5c R is the first.\
95d0: 66 42 2d 61 6c 70 6e 5c 66 52 20 70 72 6f 74 6f fB-alpn\fR proto
95e0: 63 6f 6c 20 6f 70 74 69 6f 6e 20 69 6e 20 63 6f col option in co
95f0: 6d 6d 6f 6e 20 74 6f 20 62 6f 74 68 20 74 68 65 mmon to both the
9600: 20 63 6c 69 65 6e 74 20 61 6e 64 20 73 65 72 76 client and serv
9610: 65 72 5c 26 2e 0a 49 66 20 6e 6f 74 2c 20 74 68 er\&..If not, th
9620: 65 20 66 69 72 73 74 20 63 6c 69 65 6e 74 20 73 e first client s
9630: 70 65 63 69 66 69 65 64 20 70 72 6f 74 6f 63 6f pecified protoco
9640: 6c 20 69 73 20 75 73 65 64 5c 26 2e 20 54 68 69 l is used\&. Thi
9650: 73 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 63 61 s callback is ca
9660: 6c 6c 65 64 0a 61 66 74 65 72 20 74 68 65 20 48 lled.after the H
9670: 65 6c 6c 6f 20 61 6e 64 20 53 4e 49 20 63 61 6c ello and SNI cal
9680: 6c 62 61 63 6b 73 5c 26 2e 0a 2e 54 50 0a 5c 66 lbacks\&...TP.\f
9690: 42 68 65 6c 6c 6f 5c 66 52 20 5c 66 49 63 68 61 Bhello\fR \fIcha
96a0: 6e 6e 65 6c 49 64 20 73 65 72 76 65 72 6e 61 6d nnelId servernam
96b0: 65 20 73 65 73 73 69 6f 6e 5f 69 64 5c 66 52 0a e session_id\fR.
96c0: 46 6f 72 20 73 65 72 76 65 72 73 2c 20 74 68 69 For servers, thi
96d0: 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 s form of callba
96e0: 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 64 75 ck is invoked du
96f0: 72 69 6e 67 20 63 6c 69 65 6e 74 20 68 65 6c 6c ring client hell
9700: 6f 20 6d 65 73 73 61 67 65 0a 70 72 6f 63 65 73 o message.proces
9710: 73 69 6e 67 5c 26 2e 20 54 68 65 20 70 75 72 70 sing\&. The purp
9720: 6f 73 65 20 69 73 20 73 6f 20 74 68 65 20 73 65 ose is so the se
9730: 72 76 65 72 20 63 61 6e 20 73 65 6c 65 63 74 20 rver can select
9740: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 the appropriate
9750: 63 65 72 74 69 66 69 63 61 74 65 0a 74 6f 20 70 certificate.to p
9760: 72 65 73 65 6e 74 20 74 6f 20 74 68 65 20 63 6c resent to the cl
9770: 69 65 6e 74 2c 20 61 6e 64 20 74 6f 20 6d 61 6b ient, and to mak
9780: 65 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 75 72 e other configur
9790: 61 74 69 6f 6e 20 61 64 6a 75 73 74 6d 65 6e 74 ation adjustment
97a0: 73 20 72 65 6c 65 76 61 6e 74 0a 74 6f 20 74 68 s relevant.to th
97b0: 61 74 20 73 65 72 76 65 72 20 6e 61 6d 65 20 61 at server name a
97c0: 6e 64 20 69 74 73 20 63 6f 6e 66 69 67 75 72 61 nd its configura
97d0: 74 69 6f 6e 5c 26 2e 20 49 74 20 69 73 20 63 61 tion\&. It is ca
97e0: 6c 6c 65 64 20 62 65 66 6f 72 65 20 74 68 65 20 lled before the
97f0: 53 4e 49 20 61 6e 64 20 41 4c 50 4e 0a 63 61 6c SNI and ALPN.cal
9800: 6c 62 61 63 6b 73 5c 26 2e 0a 2e 54 50 0a 5c 66 lbacks\&...TP.\f
9810: 42 73 6e 69 5c 66 52 20 5c 66 49 63 68 61 6e 6e Bsni\fR \fIchann
9820: 65 6c 49 64 20 73 65 72 76 65 72 6e 61 6d 65 5c elId servername\
9830: 66 52 0a 46 6f 72 20 73 65 72 76 65 72 73 2c 20 fR.For servers,
9840: 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c this form of cal
9850: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
9860: 20 77 68 65 6e 20 74 68 65 20 53 65 72 76 65 72 when the Server
9870: 20 4e 61 6d 65 20 49 6e 64 69 63 61 74 69 6f 6e Name Indication
9880: 0a 28 53 4e 49 29 20 65 78 74 65 6e 73 69 6f 6e .(SNI) extension
9890: 20 69 73 20 72 65 63 65 69 76 65 64 5c 26 2e 20 is received\&.
98a0: 54 68 65 20 5c 66 49 73 65 72 76 65 72 6e 61 6d The \fIservernam
98b0: 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 20 69 73 e\fR argument is
98c0: 20 74 68 65 20 63 6c 69 65 6e 74 0a 70 72 6f 76 the client.prov
98d0: 69 64 65 64 20 73 65 72 76 65 72 20 6e 61 6d 65 ided server name
98e0: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 specified in th
98f0: 65 20 5c 66 42 2d 73 65 72 76 65 72 6e 61 6d 65 e \fB-servername
9900: 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e 20 54 68 \fR option\&. Th
9910: 65 0a 70 75 72 70 6f 73 65 20 69 73 20 73 6f 20 e.purpose is so
9920: 77 68 65 6e 20 61 20 73 65 72 76 65 72 20 73 75 when a server su
9930: 70 70 6f 72 74 73 20 6d 75 6c 74 69 70 6c 65 20 pports multiple
9940: 6e 61 6d 65 73 2c 20 74 68 65 20 72 69 67 68 74 names, the right
9950: 20 63 65 72 74 69 66 69 63 61 74 65 0a 63 61 6e certificate.can
9960: 20 62 65 20 75 73 65 64 5c 26 2e 20 49 74 20 69 be used\&. It i
9970: 73 20 63 61 6c 6c 65 64 20 61 66 74 65 72 20 74 s called after t
9980: 68 65 20 48 65 6c 6c 6f 20 63 61 6c 6c 62 61 63 he Hello callbac
9990: 6b 20 62 75 74 20 62 65 66 6f 72 65 20 74 68 65 k but before the
99a0: 20 41 4c 50 4e 0a 63 61 6c 6c 62 61 63 6b 5c 26 ALPN.callback\&
99b0: 2e 0a 2e 54 50 0a 5c 66 42 76 65 72 69 66 79 5c ...TP.\fBverify\
99c0: 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 49 64 20 fR \fIchannelId
99d0: 64 65 70 74 68 20 63 65 72 74 20 73 74 61 74 75 depth cert statu
99e0: 73 20 65 72 72 6f 72 5c 66 52 0a 54 68 69 73 20 s error\fR.This
99f0: 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 6b form of callback
9a00: 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 4f is invoked by O
9a10: 70 65 6e 53 53 4c 20 77 68 65 6e 20 61 20 6e 65 penSSL when a ne
9a20: 77 20 63 65 72 74 69 66 69 63 61 74 65 20 69 73 w certificate is
9a30: 20 72 65 63 65 69 76 65 64 0a 66 72 6f 6d 20 74 received.from t
9a40: 68 65 20 70 65 65 72 5c 26 2e 20 49 74 20 61 6c he peer\&. It al
9a50: 6c 6f 77 73 20 74 68 65 20 63 6c 69 65 6e 74 20 lows the client
9a60: 74 6f 20 63 68 65 63 6b 20 74 68 65 20 63 65 72 to check the cer
9a70: 74 69 66 69 63 61 74 65 20 76 65 72 69 66 69 63 tificate verific
9a80: 61 74 69 6f 6e 0a 72 65 73 75 6c 74 73 20 61 6e ation.results an
9a90: 64 20 63 68 6f 6f 73 65 20 77 68 65 74 68 65 72 d choose whether
9aa0: 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 6f 72 20 to continue or
9ab0: 6e 6f 74 5c 26 2e 20 49 74 20 69 73 20 63 61 6c not\&. It is cal
9ac0: 6c 65 64 20 66 6f 72 20 65 61 63 68 0a 63 65 72 led for each.cer
9ad0: 74 69 66 69 63 61 74 65 20 69 6e 20 74 68 65 20 tificate in the
9ae0: 63 65 72 74 69 66 69 63 61 74 65 20 63 68 61 69 certificate chai
9af0: 6e 5c 26 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 n\&. This callba
9b00: 63 6b 20 77 61 73 20 6d 6f 76 65 64 20 66 72 6f ck was moved fro
9b10: 6d 0a 5c 66 42 2d 63 6f 6d 6d 61 6e 64 5c 66 52 m.\fB-command\fR
9b20: 20 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 in TclTLS 1\&.8
9b30: 5c 26 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 \&. The argument
9b40: 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c s are:..RS..TP.\
9b50: 66 49 64 65 70 74 68 5c 66 52 0a 54 68 65 20 64 fIdepth\fR.The d
9b60: 65 70 74 68 20 69 73 20 74 68 65 20 69 6e 74 65 epth is the inte
9b70: 67 65 72 20 64 65 70 74 68 20 6f 66 20 74 68 65 ger depth of the
9b80: 20 63 65 72 74 69 66 69 63 61 74 65 20 69 6e 20 certificate in
9b90: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
9ba0: 63 68 61 69 6e 2c 0a 77 68 65 72 65 20 30 20 69 chain,.where 0 i
9bb0: 73 20 74 68 65 20 70 65 65 72 20 63 65 72 74 69 s the peer certi
9bc0: 66 69 63 61 74 65 20 61 6e 64 20 68 69 67 68 65 ficate and highe
9bd0: 72 20 76 61 6c 75 65 73 20 67 6f 69 6e 67 20 75 r values going u
9be0: 70 20 74 6f 20 74 68 65 20 43 65 72 74 69 66 69 p to the Certifi
9bf0: 63 61 74 65 0a 41 75 74 68 6f 72 69 74 79 20 28 cate.Authority (
9c00: 43 41 29 5c 26 2e 0a 2e 54 50 0a 5c 66 49 63 65 CA)\&...TP.\fIce
9c10: 72 74 5c 66 52 0a 54 68 65 20 63 65 72 74 20 61 rt\fR.The cert a
9c20: 72 67 75 6d 65 6e 74 20 69 73 20 61 20 6c 69 73 rgument is a lis
9c30: 74 20 6f 66 20 6b 65 79 2d 76 61 6c 75 65 20 70 t of key-value p
9c40: 61 69 72 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 airs similar to
9c50: 74 68 6f 73 65 20 72 65 74 75 72 6e 65 64 20 62 those returned b
9c60: 79 0a 5c 66 42 74 6c 73 3a 3a 73 74 61 74 75 73 y.\fBtls::status
9c70: 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 49 73 74 \fR\&...TP.\fIst
9c80: 61 74 75 73 5c 66 52 0a 54 68 65 20 73 74 61 74 atus\fR.The stat
9c90: 75 73 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 us argument is t
9ca0: 68 65 20 62 6f 6f 6c 65 61 6e 20 76 61 6c 69 64 he boolean valid
9cb0: 69 74 79 20 6f 66 20 74 68 65 20 63 75 72 72 65 ity of the curre
9cc0: 6e 74 20 63 65 72 74 69 66 69 63 61 74 65 20 77 nt certificate w
9cd0: 68 65 72 65 20 30 0a 69 73 20 69 6e 76 61 6c 69 here 0.is invali
9ce0: 64 20 61 6e 64 20 31 20 69 73 20 76 61 6c 69 64 d and 1 is valid
9cf0: 5c 26 2e 0a 2e 54 50 0a 5c 66 49 65 72 72 6f 72 \&...TP.\fIerror
9d00: 5c 66 52 0a 54 68 65 20 65 72 72 6f 72 20 61 72 \fR.The error ar
9d10: 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 65 72 gument is the er
9d20: 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 69 66 20 ror message, if
9d30: 61 6e 79 2c 20 67 65 6e 65 72 61 74 65 64 20 62 any, generated b
9d40: 79 0a 5c 66 42 58 35 30 39 5f 53 54 4f 52 45 5f y.\fBX509_STORE_
9d50: 43 54 58 5f 67 65 74 5f 65 72 72 6f 72 28 29 5c CTX_get_error()\
9d60: 66 52 5c 26 2e 0a 2e 52 45 0a 2e 50 50 0a 52 65 fR\&...RE..PP.Re
9d70: 66 65 72 65 6e 63 65 20 69 6d 70 6c 65 6d 65 6e ference implemen
9d80: 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 73 65 tations of these
9d90: 20 63 61 6c 6c 62 61 63 6b 73 20 61 72 65 20 70 callbacks are p
9da0: 72 6f 76 69 64 65 64 20 69 6e 20 22 5c 66 49 74 rovided in "\fIt
9db0: 6c 73 5c 26 2e 74 63 6c 5c 66 52 22 0a 61 73 20 ls\&.tcl\fR".as
9dc0: 5c 66 42 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b \fBtls::callback
9dd0: 5c 66 52 2c 20 5c 66 42 74 6c 73 3a 3a 70 61 73 \fR, \fBtls::pas
9de0: 73 77 6f 72 64 5c 66 52 2c 20 61 6e 64 20 5c 66 sword\fR, and \f
9df0: 42 74 6c 73 3a 3a 76 61 6c 69 64 61 74 65 5f 63 Btls::validate_c
9e00: 6f 6d 6d 61 6e 64 5c 66 52 0a 72 65 73 70 65 63 ommand\fR.respec
9e10: 74 69 76 65 6c 79 5c 26 2e 20 4e 6f 74 65 20 74 tively\&. Note t
9e20: 68 61 74 20 74 68 65 73 65 20 61 72 65 20 6f 6e hat these are on
9e30: 6c 79 20 5c 66 49 73 61 6d 70 6c 65 5c 66 52 20 ly \fIsample\fR
9e40: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 5c implementations\
9e50: 26 2e 20 49 6e 20 61 20 6d 6f 72 65 0a 72 65 61 &. In a more.rea
9e60: 6c 69 73 74 69 63 20 64 65 70 6c 6f 79 6d 65 6e listic deploymen
9e70: 74 20 79 6f 75 20 77 6f 75 6c 64 20 73 70 65 63 t you would spec
9e80: 69 66 79 20 79 6f 75 72 20 6f 77 6e 20 63 61 6c ify your own cal
9e90: 6c 62 61 63 6b 20 73 63 72 69 70 74 73 20 6f 6e lback scripts on
9ea0: 20 65 61 63 68 20 54 4c 53 0a 63 68 61 6e 6e 65 each TLS.channe
9eb0: 6c 20 75 73 69 6e 67 20 74 68 65 20 5c 66 42 2d l using the \fB-
9ec0: 63 6f 6d 6d 61 6e 64 5c 66 52 2c 20 5c 66 42 2d command\fR, \fB-
9ed0: 70 61 73 73 77 6f 72 64 5c 66 52 2c 20 61 6e 64 password\fR, and
9ee0: 0a 5c 66 42 2d 76 61 6c 69 64 61 74 65 5f 63 6f .\fB-validate_co
9ef0: 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 73 mmand\fR options
9f00: 5c 26 2e 0a 2e 50 50 0a 54 68 65 20 64 65 66 61 \&...PP.The defa
9f10: 75 6c 74 20 62 65 68 61 76 69 6f 72 20 77 68 65 ult behavior whe
9f20: 6e 20 74 68 65 20 5c 66 42 2d 63 6f 6d 6d 61 6e n the \fB-comman
9f30: 64 5c 66 52 20 61 6e 64 20 5c 66 42 2d 76 61 6c d\fR and \fB-val
9f40: 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 idate_command\fR
9f50: 0a 6f 70 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 .options are not
9f60: 20 73 70 65 63 69 66 69 65 64 2c 20 69 73 20 66 specified, is f
9f70: 6f 72 20 54 63 6c 54 4c 53 20 74 6f 20 70 72 6f or TclTLS to pro
9f80: 63 65 73 73 20 74 68 65 20 61 73 73 6f 63 69 61 cess the associa
9f90: 74 65 64 20 6c 69 62 72 61 72 79 0a 63 61 6c 6c ted library.call
9fa0: 62 61 63 6b 73 20 69 6e 74 65 72 6e 61 6c 6c 79 backs internally
9fb0: 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 \&. The default
9fc0: 62 65 68 61 76 69 6f 72 20 77 68 65 6e 20 74 68 behavior when th
9fd0: 65 20 5c 66 42 2d 70 61 73 73 77 6f 72 64 5c 66 e \fB-password\f
9fe0: 52 20 6f 70 74 69 6f 6e 0a 69 73 20 6e 6f 74 20 R option.is not
9ff0: 73 70 65 63 69 66 69 65 64 20 69 73 20 66 6f 72 specified is for
a000: 20 54 63 6c 54 4c 53 20 74 6f 20 70 72 6f 63 65 TclTLS to proce
a010: 73 73 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 ss the associate
a020: 64 20 6c 69 62 72 61 72 79 20 63 61 6c 6c 62 61 d library callba
a030: 63 6b 73 20 62 79 0a 61 74 74 65 6d 70 74 69 6e cks by.attemptin
a040: 67 20 74 6f 20 63 61 6c 6c 20 5c 66 42 74 6c 73 g to call \fBtls
a050: 3a 3a 70 61 73 73 77 6f 72 64 5c 66 52 5c 26 2e ::password\fR\&.
a060: 20 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 The difference
a070: 62 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 between these tw
a080: 6f 0a 62 65 68 61 76 69 6f 72 73 20 69 73 20 61 o.behaviors is a
a090: 20 63 6f 6e 73 65 71 75 65 6e 63 65 20 6f 66 20 consequence of
a0a0: 6d 61 69 6e 74 61 69 6e 69 6e 67 20 63 6f 6d 70 maintaining comp
a0b0: 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 65 atibility with e
a0c0: 61 72 6c 69 65 72 0a 69 6d 70 6c 65 6d 65 6e 74 arlier.implement
a0d0: 61 74 69 6f 6e 73 5c 26 2e 0a 2e 50 50 0a 5c 66 ations\&...PP.\f
a0e0: 49 54 68 65 20 75 73 65 20 6f 66 20 74 68 65 20 IThe use of the
a0f0: 72 65 66 65 72 65 6e 63 65 20 63 61 6c 6c 62 61 reference callba
a100: 63 6b 73 20 5c 66 42 74 6c 73 3a 3a 63 61 6c 6c cks \fBtls::call
a110: 62 61 63 6b 5c 66 52 2c 20 5c 66 42 74 6c 73 3a back\fR, \fBtls:
a120: 3a 70 61 73 73 77 6f 72 64 5c 66 52 2c 0a 61 6e :password\fR,.an
a130: 64 20 5c 66 42 74 6c 73 3a 3a 76 61 6c 69 64 61 d \fBtls::valida
a140: 74 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 20 69 73 te_command\fR is
a150: 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e 64 65 64 not recommended
a160: 5c 26 2e 20 54 68 65 79 20 6d 61 79 20 62 65 20 \&. They may be
a170: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 66 75 74 removed from fut
a180: 75 72 65 20 72 65 6c 65 61 73 65 73 5c 26 2e 5c ure releases\&.\
a190: 66 52 0a 2e 53 48 20 44 45 42 55 47 0a 46 6f 72 fR..SH DEBUG.For
a1a0: 20 6d 6f 73 74 20 64 65 62 75 67 67 69 6e 67 20 most debugging
a1b0: 6e 65 65 64 73 2c 20 74 68 65 20 5c 66 42 2d 63 needs, the \fB-c
a1c0: 61 6c 6c 62 61 63 6b 5c 66 52 20 6f 70 74 69 6f allback\fR optio
a1d0: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f n can be used to
a1e0: 20 70 72 6f 76 69 64 65 0a 73 75 66 66 69 63 69 provide.suffici
a1f0: 65 6e 74 20 69 6e 73 69 67 68 74 20 61 6e 64 20 ent insight and
a200: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 information on t
a210: 68 65 20 54 4c 53 20 68 61 6e 64 73 68 61 6b 65 he TLS handshake
a220: 20 61 6e 64 20 70 72 6f 67 72 65 73 73 5c 26 2e and progress\&.
a230: 20 49 66 0a 66 75 72 74 68 65 72 20 74 72 6f 75 If.further trou
a240: 62 6c 65 73 68 6f 6f 74 69 6e 67 20 69 6e 73 69 bleshooting insi
a250: 67 68 74 20 69 73 20 6e 65 65 64 65 64 2c 20 74 ght is needed, t
a260: 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 20 he compile time
a270: 6f 70 74 69 6f 6e 0a 5c 66 42 2d 2d 65 6e 61 62 option.\fB--enab
a280: 6c 65 2d 64 65 62 75 67 5c 66 52 20 63 61 6e 20 le-debug\fR can
a290: 62 65 20 75 73 65 64 20 74 6f 20 67 65 74 20 64 be used to get d
a2a0: 65 74 61 69 6c 65 64 20 65 78 65 63 75 74 69 6f etailed executio
a2b0: 6e 20 66 6c 6f 77 20 73 74 61 74 75 73 5c 26 2e n flow status\&.
a2c0: 0a 2e 50 50 0a 54 4c 53 20 6b 65 79 20 6c 6f 67 ..PP.TLS key log
a2d0: 67 69 6e 67 20 63 61 6e 20 62 65 20 65 6e 61 62 ging can be enab
a2e0: 6c 65 64 20 62 79 20 73 65 74 74 69 6e 67 20 74 led by setting t
a2f0: 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 he environment v
a300: 61 72 69 61 62 6c 65 0a 5c 66 42 53 53 4c 4b 45 ariable.\fBSSLKE
a310: 59 4c 4f 47 46 49 4c 45 5c 66 52 20 74 6f 20 74 YLOGFILE\fR to t
a320: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 he name of the f
a330: 69 6c 65 20 74 6f 20 6c 6f 67 20 74 6f 5c 26 2e ile to log to\&.
a340: 20 54 68 65 6e 20 77 68 65 6e 65 76 65 72 20 54 Then whenever T
a350: 4c 53 20 6b 65 79 0a 6d 61 74 65 72 69 61 6c 20 LS key.material
a360: 69 73 20 67 65 6e 65 72 61 74 65 64 20 6f 72 20 is generated or
a370: 72 65 63 65 69 76 65 64 20 69 74 20 77 69 6c 6c received it will
a380: 20 62 65 20 6c 6f 67 67 65 64 20 74 6f 20 74 68 be logged to th
a390: 65 20 66 69 6c 65 5c 26 2e 20 54 68 69 73 20 69 e file\&. This i
a3a0: 73 20 75 73 65 66 75 6c 0a 66 6f 72 20 6c 6f 67 s useful.for log
a3b0: 67 69 6e 67 20 6b 65 79 20 64 61 74 61 20 66 6f ging key data fo
a3c0: 72 20 6e 65 74 77 6f 72 6b 20 6c 6f 67 67 69 6e r network loggin
a3d0: 67 20 74 6f 6f 6c 73 20 74 6f 20 75 73 65 20 74 g tools to use t
a3e0: 6f 20 64 65 63 72 79 70 74 20 74 68 65 20 64 61 o decrypt the da
a3f0: 74 61 5c 26 2e 0a 2e 50 50 0a 54 68 65 20 5c 66 ta\&...PP.The \f
a400: 42 74 6c 73 3a 3a 64 65 62 75 67 5c 66 52 20 76 Btls::debug\fR v
a410: 61 72 69 61 62 6c 65 20 70 72 6f 76 69 64 65 73 ariable provides
a420: 20 73 6f 6d 65 20 61 64 64 69 74 69 6f 6e 61 6c some additional
a430: 20 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 20 74 68 control over th
a440: 65 0a 64 65 62 75 67 20 6c 6f 67 67 69 6e 67 20 e.debug logging
a450: 69 6e 20 74 68 65 20 5c 66 42 74 6c 73 3a 3a 63 in the \fBtls::c
a460: 61 6c 6c 62 61 63 6b 5c 66 52 2c 20 5c 66 42 74 allback\fR, \fBt
a470: 6c 73 3a 3a 70 61 73 73 77 6f 72 64 5c 66 52 2c ls::password\fR,
a480: 20 61 6e 64 0a 5c 66 42 74 6c 73 3a 3a 76 61 6c and.\fBtls::val
a490: 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 idate_command\fR
a4a0: 20 64 65 66 61 75 6c 74 20 68 61 6e 64 6c 65 72 default handler
a4b0: 73 20 69 6e 20 22 5c 66 49 74 6c 73 5c 26 2e 74 s in "\fItls\&.t
a4c0: 63 6c 5c 66 52 22 5c 26 2e 0a 54 68 65 20 64 65 cl\fR"\&..The de
a4d0: 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 30 fault value is 0
a4e0: 20 77 69 74 68 20 68 69 67 68 65 72 20 76 61 6c with higher val
a4f0: 75 65 73 20 70 72 6f 64 75 63 69 6e 67 20 6d 6f ues producing mo
a500: 72 65 20 64 69 61 67 6e 6f 73 74 69 63 20 6f 75 re diagnostic ou
a510: 74 70 75 74 2c 0a 61 6e 64 20 77 69 6c 6c 20 61 tput,.and will a
a520: 6c 73 6f 20 66 6f 72 63 65 20 74 68 65 20 76 65 lso force the ve
a530: 72 69 66 79 20 6d 65 74 68 6f 64 20 69 6e 20 5c rify method in \
a540: 66 42 74 6c 73 3a 3a 63 61 6c 6c 62 61 63 6b 5c fBtls::callback\
a550: 66 52 20 74 6f 20 61 63 63 65 70 74 20 74 68 65 fR to accept the
a560: 0a 63 65 72 74 69 66 69 63 61 74 65 2c 20 65 76 .certificate, ev
a570: 65 6e 20 69 66 20 69 74 20 69 73 20 69 6e 76 61 en if it is inva
a580: 6c 69 64 20 77 68 65 6e 20 74 68 65 20 5c 66 42 lid when the \fB
a590: 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 6e 64 -validatecommand
a5a0: 5c 66 52 0a 6f 70 74 69 6f 6e 20 69 73 20 73 65 \fR.option is se
a5b0: 74 20 74 6f 20 5c 66 42 74 6c 73 3a 3a 76 61 6c t to \fBtls::val
a5c0: 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 idate_command\fR
a5d0: 5c 26 2e 0a 2e 50 50 0a 5c 66 49 54 68 65 20 75 \&...PP.\fIThe u
a5e0: 73 65 20 6f 66 20 74 68 65 20 76 61 72 69 61 62 se of the variab
a5f0: 6c 65 20 5c 66 42 74 6c 73 3a 3a 64 65 62 75 67 le \fBtls::debug
a600: 5c 66 52 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d \fR is not recom
a610: 6d 65 6e 64 65 64 5c 26 2e 0a 49 74 20 6d 61 79 mended\&..It may
a620: 20 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d be removed from
a630: 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 future releases
a640: 5c 26 2e 5c 66 52 0a 2e 53 48 20 45 58 41 4d 50 \&.\fR..SH EXAMP
a650: 4c 45 53 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e LES.The followin
a660: 67 20 61 72 65 20 65 78 61 6d 70 6c 65 20 73 63 g are example sc
a670: 72 69 70 74 73 20 74 6f 20 64 6f 77 6e 6c 6f 61 ripts to downloa
a680: 64 20 61 20 77 65 62 70 61 67 65 20 61 6e 64 20 d a webpage and
a690: 66 69 6c 65 20 75 73 69 6e 67 20 74 68 65 0a 68 file using the.h
a6a0: 74 74 70 20 70 61 63 6b 61 67 65 5c 26 2e 20 53 ttp package\&. S
a6b0: 65 65 20 5c 66 42 43 65 72 74 69 66 69 63 61 74 ee \fBCertificat
a6c0: 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c 66 52 20 e Validation\fR
a6d0: 66 6f 72 20 77 68 65 6e 20 74 68 65 0a 5c 66 42 for when the.\fB
a6e0: 2d 63 61 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 -cadir\fR, \fB-c
a6f0: 61 66 69 6c 65 5c 66 52 2c 20 61 6e 64 20 5c 66 afile\fR, and \f
a700: 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 6f 70 74 B-castore\fR opt
a710: 69 6f 6e 73 20 61 72 65 20 61 6c 73 6f 0a 6e 65 ions are also.ne
a720: 65 64 65 64 5c 26 2e 20 53 65 65 20 74 68 65 20 eded\&. See the
a730: 22 5c 66 49 64 65 6d 6f 73 5c 66 52 22 20 64 69 "\fIdemos\fR" di
a740: 72 65 63 74 6f 72 79 20 66 6f 72 20 6d 6f 72 65 rectory for more
a750: 20 65 78 61 6d 70 6c 65 20 73 63 72 69 70 74 73 example scripts
a760: 5c 26 2e 0a 2e 50 50 0a 45 78 61 6d 70 6c 65 20 \&...PP.Example
a770: 23 31 3a 20 44 6f 77 6e 6c 6f 61 64 20 61 20 77 #1: Download a w
a780: 65 62 20 70 61 67 65 0a 2e 43 53 0a 0a 0a 0a 70 eb page..CS....p
a790: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 68 ackage require h
a7a0: 74 74 70 0a 70 61 63 6b 61 67 65 20 72 65 71 75 ttp.package requ
a7b0: 69 72 65 20 74 6c 73 0a 0a 73 65 74 20 75 72 6c ire tls..set url
a7c0: 20 22 68 74 74 70 73 3a 2f 2f 77 77 77 5c 26 2e "https://www\&.
a7d0: 74 63 6c 5c 26 2e 74 6b 2f 22 0a 68 74 74 70 3a tcl\&.tk/".http:
a7e0: 3a 72 65 67 69 73 74 65 72 20 68 74 74 70 73 20 :register https
a7f0: 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 6c 73 3a 443 [list ::tls:
a800: 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f 73 65 72 :socket -autoser
a810: 76 65 72 6e 61 6d 65 20 31 20 2d 72 65 71 75 69 vername 1 -requi
a820: 72 65 20 31 5d 0a 0a 23 20 47 65 74 20 55 52 4c re 1]..# Get URL
a830: 0a 73 65 74 20 74 6f 6b 65 6e 20 5b 68 74 74 70 .set token [http
a840: 3a 3a 67 65 74 75 72 6c 20 24 75 72 6c 5d 0a 0a ::geturl $url]..
a850: 23 20 43 68 65 63 6b 20 66 6f 72 20 65 72 72 6f # Check for erro
a860: 72 0a 69 66 20 7b 5b 68 74 74 70 3a 3a 73 74 61 r.if {[http::sta
a870: 74 75 73 20 24 74 6f 6b 65 6e 5d 20 6e 65 20 22 tus $token] ne "
a880: 6f 6b 22 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 ok"} {. puts
a890: 5b 66 6f 72 6d 61 74 20 22 45 72 72 6f 72 20 25 [format "Error %
a8a0: 73 22 20 5b 68 74 74 70 3a 3a 73 74 61 74 75 73 s" [http::status
a8b0: 20 24 74 6f 6b 65 6e 5d 5d 0a 7d 0a 0a 23 20 53 $token]].}..# S
a8c0: 61 76 65 20 77 65 62 20 70 61 67 65 20 74 6f 20 ave web page to
a8d0: 66 69 6c 65 0a 73 65 74 20 63 68 20 5b 6f 70 65 file.set ch [ope
a8e0: 6e 20 65 78 61 6d 70 6c 65 5c 26 2e 68 74 6d 6c n example\&.html
a8f0: 20 77 62 5d 0a 70 75 74 73 20 24 63 68 20 5b 68 wb].puts $ch [h
a900: 74 74 70 3a 3a 64 61 74 61 20 24 74 6f 6b 65 6e ttp::data $token
a910: 5d 0a 63 6c 6f 73 65 20 24 63 68 0a 0a 23 20 43 ].close $ch..# C
a920: 6c 65 61 6e 75 70 0a 3a 3a 68 74 74 70 3a 3a 63 leanup.::http::c
a930: 6c 65 61 6e 75 70 20 24 74 6f 6b 65 6e 0a 0a 2e leanup $token...
a940: 43 45 0a 45 78 61 6d 70 6c 65 20 23 32 3a 20 44 CE.Example #2: D
a950: 6f 77 6e 6c 6f 61 64 20 61 20 66 69 6c 65 0a 2e ownload a file..
a960: 43 53 0a 0a 0a 0a 70 61 63 6b 61 67 65 20 72 65 CS....package re
a970: 71 75 69 72 65 20 68 74 74 70 0a 70 61 63 6b 61 quire http.packa
a980: 67 65 20 72 65 71 75 69 72 65 20 74 6c 73 0a 0a ge require tls..
a990: 73 65 74 20 75 72 6c 20 22 68 74 74 70 73 3a 2f set url "https:/
a9a0: 2f 77 69 6b 69 5c 26 2e 74 63 6c 2d 6c 61 6e 67 /wiki\&.tcl-lang
a9b0: 5c 26 2e 6f 72 67 2f 73 69 74 65 6d 61 70 5c 26 \&.org/sitemap\&
a9c0: 2e 78 6d 6c 22 0a 68 74 74 70 3a 3a 72 65 67 69 .xml".http::regi
a9d0: 73 74 65 72 20 68 74 74 70 73 20 34 34 33 20 5b ster https 443 [
a9e0: 6c 69 73 74 20 3a 3a 74 6c 73 3a 3a 73 6f 63 6b list ::tls::sock
a9f0: 65 74 20 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 et -autoserverna
aa00: 6d 65 20 31 20 2d 72 65 71 75 69 72 65 20 31 5d me 1 -require 1]
aa10: 0a 0a 23 20 4f 70 65 6e 20 6f 75 74 70 75 74 20 ..# Open output
aa20: 66 69 6c 65 0a 73 65 74 20 66 69 6c 65 6e 61 6d file.set filenam
aa30: 65 20 5b 66 69 6c 65 20 74 61 69 6c 20 24 75 72 e [file tail $ur
aa40: 6c 5d 0a 73 65 74 20 63 68 20 5b 6f 70 65 6e 20 l].set ch [open
aa50: 24 66 69 6c 65 6e 61 6d 65 20 77 62 5d 0a 0a 23 $filename wb]..#
aa60: 20 47 65 74 20 66 69 6c 65 0a 73 65 74 20 74 6f Get file.set to
aa70: 6b 65 6e 20 5b 3a 3a 68 74 74 70 3a 3a 67 65 74 ken [::http::get
aa80: 75 72 6c 20 24 75 72 6c 20 2d 62 6c 6f 63 6b 73 url $url -blocks
aa90: 69 7a 65 20 36 35 35 33 36 20 2d 63 68 61 6e 6e ize 65536 -chann
aaa0: 65 6c 20 24 63 68 5d 0a 0a 23 20 43 68 65 63 6b el $ch]..# Check
aab0: 20 66 6f 72 20 65 72 72 6f 72 0a 69 66 20 7b 5b for error.if {[
aac0: 68 74 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f http::status $to
aad0: 6b 65 6e 5d 20 6e 65 20 22 6f 6b 22 7d 20 7b 0a ken] ne "ok"} {.
aae0: 20 20 20 20 70 75 74 73 20 5b 66 6f 72 6d 61 74 puts [format
aaf0: 20 22 45 72 72 6f 72 20 25 73 22 20 5b 68 74 74 "Error %s" [htt
ab00: 70 3a 3a 73 74 61 74 75 73 20 24 74 6f 6b 65 6e p::status $token
ab10: 5d 5d 0a 7d 0a 0a 23 20 43 6c 65 61 6e 75 70 0a ]].}..# Cleanup.
ab20: 63 6c 6f 73 65 20 24 63 68 0a 3a 3a 68 74 74 70 close $ch.::http
ab30: 3a 3a 63 6c 65 61 6e 75 70 20 24 74 6f 6b 65 6e ::cleanup $token
ab40: 0a 0a 2e 43 45 0a 2e 53 48 20 22 53 50 45 43 49 ...CE..SH "SPECI
ab50: 41 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e AL CONSIDERATION
ab60: 53 22 0a 54 68 65 20 63 61 70 61 62 69 6c 69 74 S".The capabilit
ab70: 69 65 73 20 6f 66 20 74 68 69 73 20 70 61 63 6b ies of this pack
ab80: 61 67 65 20 63 61 6e 20 76 61 72 79 20 65 6e 6f age can vary eno
ab90: 72 6d 6f 75 73 6c 79 20 62 61 73 65 64 20 75 70 rmously based up
aba0: 6f 6e 20 68 6f 77 20 74 68 65 0a 6c 69 6e 6b 65 on how the.linke
abb0: 64 20 74 6f 20 4f 70 65 6e 53 53 4c 20 6c 69 62 d to OpenSSL lib
abc0: 72 61 72 79 20 77 61 73 20 63 6f 6e 66 69 67 75 rary was configu
abd0: 72 65 64 20 61 6e 64 20 62 75 69 6c 74 5c 26 2e red and built\&.
abe0: 20 4e 65 77 20 76 65 72 73 69 6f 6e 73 20 6d 61 New versions ma
abf0: 79 20 6f 62 73 6f 6c 65 74 65 0a 6f 6c 64 65 72 y obsolete.older
ac00: 20 70 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f protocol versio
ac10: 6e 73 2c 20 61 64 64 20 6f 72 20 72 65 6d 6f 76 ns, add or remov
ac20: 65 20 63 69 70 68 65 72 73 2c 20 63 68 61 6e 67 e ciphers, chang
ac30: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 e default values
ac40: 2c 20 65 74 63 5c 26 2e 0a 55 73 65 20 74 68 65 , etc\&..Use the
ac50: 20 5c 66 42 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f \fBtls::protoco
ac60: 6c 73 5c 66 52 20 63 6f 6d 6d 61 6e 64 20 74 6f ls\fR command to
ac70: 20 6f 62 74 61 69 6e 20 74 68 65 20 73 75 70 70 obtain the supp
ac80: 6f 72 74 65 64 0a 70 72 6f 74 6f 63 6f 6c 20 76 orted.protocol v
ac90: 65 72 73 69 6f 6e 73 5c 26 2e 0a 2e 53 48 20 22 ersions\&...SH "
aca0: 45 52 52 4f 52 20 4d 45 53 53 41 47 45 53 22 0a ERROR MESSAGES".
acb0: 53 6f 6d 65 20 4f 70 73 6e 53 53 6c 20 65 72 72 Some OpsnSSl err
acc0: 6f 72 20 6d 65 73 73 61 67 65 73 20 68 61 76 65 or messages have
acd0: 20 63 72 79 70 74 69 63 20 6d 65 61 6e 69 6e 67 cryptic meaning
ace0: 73 5c 26 2e 20 54 68 69 73 20 69 73 20 61 20 6c s\&. This is a l
acf0: 69 73 74 20 6f 66 20 6d 65 73 73 61 67 65 73 0a ist of messages.
ad00: 61 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 69 72 along with their
ad10: 20 74 72 75 65 20 6d 65 61 6e 69 6e 67 5c 26 2e true meaning\&.
ad20: 0a 2e 54 50 0a 5c 66 49 68 61 6e 64 73 68 61 6b ..TP.\fIhandshak
ad30: 65 20 66 61 69 6c 65 64 3a 20 63 65 72 74 69 66 e failed: certif
ad40: 69 63 61 74 65 20 76 65 72 69 66 79 20 66 61 69 icate verify fai
ad50: 6c 65 64 20 64 75 65 20 74 6f 20 22 75 6e 61 62 led due to "unab
ad60: 6c 65 20 74 6f 20 67 65 74 20 6c 6f 63 61 6c 20 le to get local
ad70: 69 73 73 75 65 72 20 63 65 72 74 69 66 69 63 61 issuer certifica
ad80: 74 65 22 5c 66 52 0a 54 68 65 20 63 65 72 74 69 te"\fR.The certi
ad90: 66 69 63 61 74 65 73 20 69 6e 20 74 68 65 20 43 ficates in the C
ada0: 41 20 66 69 6c 65 20 6f 72 20 63 65 72 74 69 66 A file or certif
adb0: 69 63 61 74 65 20 73 74 6f 72 65 20 65 69 74 68 icate store eith
adc0: 65 72 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 6f er do not have o
add0: 6e 65 20 6f 72 0a 6d 6f 72 65 20 69 73 73 75 65 ne or.more issue
ade0: 72 73 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 rs of the certif
adf0: 69 63 61 74 65 73 20 79 6f 75 20 61 72 65 20 76 icates you are v
ae00: 61 6c 69 64 61 74 69 6e 67 20 6f 72 20 74 68 65 alidating or the
ae10: 79 20 68 61 76 65 20 65 78 70 69 72 65 64 5c 26 y have expired\&
ae20: 2e 0a 55 73 75 61 6c 6c 79 20 74 68 69 73 20 6d ..Usually this m
ae30: 65 61 6e 73 20 79 6f 75 20 6e 65 65 64 20 61 6e eans you need an
ae40: 20 75 70 64 61 74 65 64 20 43 41 63 65 72 74 20 updated CAcert
ae50: 66 69 6c 65 5c 26 2e 0a 2e 54 50 0a 5c 66 49 70 file\&...TP.\fIp
ae60: 61 63 6b 65 74 20 6c 65 6e 67 74 68 20 74 6f 6f acket length too
ae70: 20 6c 6f 6e 67 5c 66 52 0a 43 6c 69 65 6e 74 20 long\fR.Client
ae80: 68 61 73 20 74 72 69 65 64 20 74 6f 20 63 6f 6e has tried to con
ae90: 6e 65 63 74 20 74 6f 20 61 20 48 54 54 50 20 73 nect to a HTTP s
aea0: 65 72 76 65 72 20 6f 6e 20 74 68 65 20 70 6c 61 erver on the pla
aeb0: 69 6e 2d 74 65 78 74 20 70 6f 72 74 20 69 6e 73 in-text port ins
aec0: 74 65 61 64 20 6f 66 0a 74 68 65 20 53 53 4c 2f tead of.the SSL/
aed0: 54 4c 53 20 70 6f 72 74 5c 26 2e 0a 2e 54 50 0a TLS port\&...TP.
aee0: 5c 66 49 75 6e 65 78 70 65 63 74 65 64 20 65 6f \fIunexpected eo
aef0: 66 20 77 68 69 6c 65 20 72 65 61 64 69 6e 67 5c f while reading\
af00: 66 52 0a 54 68 65 20 70 65 65 72 20 68 61 73 20 fR.The peer has
af10: 63 6c 6f 73 65 64 20 74 68 65 20 63 6f 6e 6e 65 closed the conne
af20: 63 74 69 6f 6e 20 77 69 74 68 6f 75 74 20 73 65 ction without se
af30: 6e 64 69 6e 67 20 74 68 65 20 22 63 6c 6f 73 65 nding the "close
af40: 20 6e 6f 74 69 66 79 22 20 73 68 75 74 64 6f 77 notify" shutdow
af50: 6e 0a 61 6c 65 72 74 5c 26 2e 20 53 6f 6d 65 20 n.alert\&. Some
af60: 73 65 72 76 65 72 73 20 77 69 6c 6c 20 74 65 72 servers will ter
af70: 6d 69 6e 61 74 65 20 74 68 65 20 63 6f 6e 6e 65 minate the conne
af80: 63 74 69 6f 6e 20 61 66 74 65 72 20 74 68 65 20 ction after the
af90: 66 69 6c 65 20 6f 72 20 77 65 62 70 61 67 65 20 file or webpage
afa0: 68 61 73 0a 62 65 65 6e 20 73 65 6e 74 20 77 69 has.been sent wi
afb0: 74 68 6f 75 74 20 73 65 6e 64 69 6e 67 20 74 68 thout sending th
afc0: 65 20 22 63 6c 6f 73 65 20 6e 6f 74 69 66 79 22 e "close notify"
afd0: 20 6d 65 73 73 61 67 65 5c 26 2e 20 49 6e 20 74 message\&. In t
afe0: 68 69 73 20 63 61 73 65 2c 20 69 74 20 73 68 6f his case, it sho
aff0: 75 6c 64 0a 6e 6f 74 20 72 65 73 75 6c 74 20 69 uld.not result i
b000: 6e 20 61 20 6c 6f 73 73 20 6f 66 20 64 61 74 61 n a loss of data
b010: 5c 26 2e 0a 2e 54 50 0a 5c 66 49 77 72 6f 6e 67 \&...TP.\fIwrong
b020: 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 5c version number\
b030: 66 52 0a 43 6c 69 65 6e 74 20 68 61 73 20 74 72 fR.Client has tr
b040: 69 65 64 20 74 6f 20 63 6f 6e 6e 65 63 74 20 74 ied to connect t
b050: 6f 20 61 20 6e 6f 6e 2d 48 54 54 50 20 73 65 72 o a non-HTTP ser
b060: 76 65 72 20 6f 6e 20 61 20 6e 6f 6e 2d 54 4c 53 ver on a non-TLS
b070: 20 28 69 5c 26 2e 65 5c 26 2e 20 70 6c 61 69 6e (i\&.e\&. plain
b080: 20 74 65 78 74 29 20 70 6f 72 74 5c 26 2e 0a 2e text) port\&...
b090: 50 50 0a 2e 53 48 20 22 53 45 45 20 41 4c 53 4f PP..SH "SEE ALSO
b0a0: 22 0a 5c 66 49 4f 70 65 6e 53 53 4c 5c 66 52 20 ".\fIOpenSSL\fR
b0b0: 5b 68 74 74 70 73 3a 2f 2f 77 77 77 5c 26 2e 6f [https://www\&.o
b0c0: 70 65 6e 73 73 6c 5c 26 2e 6f 72 67 2f 5d 2c 20 penssl\&.org/],
b0d0: 68 74 74 70 2c 20 73 6f 63 6b 65 74 0a 2e 53 48 http, socket..SH
b0e0: 20 4b 45 59 57 4f 52 44 53 0a 49 2f 4f 2c 20 49 KEYWORDS.I/O, I
b0f0: 50 20 41 64 64 72 65 73 73 2c 20 4f 70 65 6e 53 P Address, OpenS
b100: 53 4c 2c 20 53 53 4c 2c 20 54 43 50 2c 20 54 4c SL, SSL, TCP, TL
b110: 53 2c 20 54 63 6c 54 4c 53 2c 20 61 73 79 6e 63 S, TclTLS, async
b120: 68 72 6f 6e 6f 75 73 20 49 2f 4f 2c 20 62 69 6e hronous I/O, bin
b130: 64 2c 20 63 65 72 74 69 66 69 63 61 74 65 2c 20 d, certificate,
b140: 63 68 61 6e 6e 65 6c 2c 20 63 6f 6e 6e 65 63 74 channel, connect
b150: 69 6f 6e 2c 20 64 6f 6d 61 69 6e 20 6e 61 6d 65 ion, domain name
b160: 2c 20 68 6f 73 74 2c 20 68 74 74 70 73 2c 20 6e , host, https, n
b170: 65 74 77 6f 72 6b 2c 20 6e 65 74 77 6f 72 6b 20 etwork, network
b180: 61 64 64 72 65 73 73 2c 20 73 6f 63 6b 65 74 2c address, socket,
b190: 20 74 6c 73 0a 2e 53 48 20 43 41 54 45 47 4f 52 tls..SH CATEGOR
b1a0: 59 0a 74 6c 73 0a 2e 53 48 20 43 4f 50 59 52 49 Y.tls..SH COPYRI
b1b0: 47 48 54 0a 2e 6e 66 0a 43 6f 70 79 72 69 67 68 GHT..nf.Copyrigh
b1c0: 74 20 28 63 29 20 31 39 39 39 20 4d 61 74 74 20 t (c) 1999 Matt
b1d0: 4e 65 77 6d 61 6e 0a 43 6f 70 79 72 69 67 68 74 Newman.Copyright
b1e0: 20 28 63 29 20 32 30 30 34 20 53 74 61 72 66 69 (c) 2004 Starfi
b1f0: 73 68 20 53 79 73 74 65 6d 73 0a 43 6f 70 79 72 sh Systems.Copyr
b200: 69 67 68 74 20 28 63 29 20 32 30 32 34 20 42 72 ight (c) 2024 Br
b210: 69 61 6e 20 4f 27 48 61 67 61 6e 0a 0a 2e 66 69 ian O'Hagan...fi
b220: 0a .