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 62 31 20 74 6c 73 20 22 54 63 6c 20 \&.0b1 tls "Tcl
00e0: 54 4c 53 20 65 78 74 65 6e 73 69 6f 6e 22 0a 2e TLS extension"..
00f0: 5c 22 20 54 68 65 20 2d 2a 2d 20 6e 72 6f 66 66 \" The -*- nroff
0100: 20 2d 2a 2d 20 64 65 66 69 6e 69 74 69 6f 6e 73 -*- definitions
0110: 20 62 65 6c 6f 77 20 61 72 65 20 66 6f 72 20 73 below are for s
0120: 75 70 70 6c 65 6d 65 6e 74 61 6c 20 6d 61 63 72 upplemental macr
0130: 6f 73 20 75 73 65 64 0a 2e 5c 22 20 69 6e 20 54 os used..\" in T
0140: 63 6c 2f 54 6b 20 6d 61 6e 75 61 6c 20 65 6e 74 cl/Tk manual ent
0150: 72 69 65 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 ries...\"..\" .A
0160: 50 20 74 79 70 65 20 6e 61 6d 65 20 69 6e 2f 6f P type name in/o
0170: 75 74 20 3f 69 6e 64 65 6e 74 3f 0a 2e 5c 22 09 ut ?indent?..\".
0180: 53 74 61 72 74 20 70 61 72 61 67 72 61 70 68 20 Start paragraph
0190: 64 65 73 63 72 69 62 69 6e 67 20 61 6e 20 61 72 describing an ar
01a0: 67 75 6d 65 6e 74 20 74 6f 20 61 20 6c 69 62 72 gument to a libr
01b0: 61 72 79 20 70 72 6f 63 65 64 75 72 65 2e 0a 2e ary procedure...
01c0: 5c 22 09 74 79 70 65 20 69 73 20 74 79 70 65 20 \".type is type
01d0: 6f 66 20 61 72 67 75 6d 65 6e 74 20 28 69 6e 74 of argument (int
01e0: 2c 20 65 74 63 2e 29 2c 20 69 6e 2f 6f 75 74 20 , etc.), in/out
01f0: 69 73 20 65 69 74 68 65 72 20 22 69 6e 22 2c 20 is either "in",
0200: 22 6f 75 74 22 2c 0a 2e 5c 22 09 6f 72 20 22 69 "out",..\".or "i
0210: 6e 2f 6f 75 74 22 20 74 6f 20 64 65 73 63 72 69 n/out" to descri
0220: 62 65 20 77 68 65 74 68 65 72 20 70 72 6f 63 65 be whether proce
0230: 64 75 72 65 20 72 65 61 64 73 20 6f 72 20 6d 6f dure reads or mo
0240: 64 69 66 69 65 73 20 61 72 67 2c 0a 2e 5c 22 09 difies arg,..\".
0250: 61 6e 64 20 69 6e 64 65 6e 74 20 69 73 20 65 71 and indent is eq
0260: 75 69 76 61 6c 65 6e 74 20 74 6f 20 73 65 63 6f uivalent to seco
0270: 6e 64 20 61 72 67 20 6f 66 20 2e 49 50 20 28 73 nd arg of .IP (s
0280: 68 6f 75 6c 64 6e 27 74 20 65 76 65 72 20 62 65 houldn't ever be
0290: 0a 2e 5c 22 09 6e 65 65 64 65 64 3b 20 20 75 73 ..\".needed; us
02a0: 65 20 2e 41 53 20 62 65 6c 6f 77 20 69 6e 73 74 e .AS below inst
02b0: 65 61 64 29 0a 2e 5c 22 0a 2e 5c 22 20 2e 41 53 ead)..\"..\" .AS
02c0: 20 3f 74 79 70 65 3f 20 3f 6e 61 6d 65 3f 0a 2e ?type? ?name?..
02d0: 5c 22 09 47 69 76 65 20 6d 61 78 69 6d 75 6d 20 \".Give maximum
02e0: 73 69 7a 65 73 20 6f 66 20 61 72 67 75 6d 65 6e sizes of argumen
02f0: 74 73 20 66 6f 72 20 73 65 74 74 69 6e 67 20 74 ts for setting t
0300: 61 62 20 73 74 6f 70 73 2e 20 20 54 79 70 65 20 ab stops. Type
0310: 61 6e 64 0a 2e 5c 22 09 6e 61 6d 65 20 61 72 65 and..\".name are
0320: 20 65 78 61 6d 70 6c 65 73 20 6f 66 20 6c 61 72 examples of lar
0330: 67 65 73 74 20 70 6f 73 73 69 62 6c 65 20 61 72 gest possible ar
0340: 67 75 6d 65 6e 74 73 20 74 68 61 74 20 77 69 6c guments that wil
0350: 6c 20 62 65 20 70 61 73 73 65 64 0a 2e 5c 22 09 l be passed..\".
0360: 74 6f 20 2e 41 50 20 6c 61 74 65 72 2e 20 20 49 to .AP later. I
0370: 66 20 61 72 67 73 20 61 72 65 20 6f 6d 69 74 74 f args are omitt
0380: 65 64 2c 20 64 65 66 61 75 6c 74 20 74 61 62 20 ed, default tab
0390: 73 74 6f 70 73 20 61 72 65 20 75 73 65 64 2e 0a stops are used..
03a0: 2e 5c 22 0a 2e 5c 22 20 2e 42 53 0a 2e 5c 22 09 .\"..\" .BS..\".
03b0: 53 74 61 72 74 20 62 6f 78 20 65 6e 63 6c 6f 73 Start box enclos
03c0: 75 72 65 2e 20 20 46 72 6f 6d 20 68 65 72 65 20 ure. From here
03d0: 75 6e 74 69 6c 20 6e 65 78 74 20 2e 42 45 2c 20 until next .BE,
03e0: 65 76 65 72 79 74 68 69 6e 67 20 77 69 6c 6c 20 everything will
03f0: 62 65 0a 2e 5c 22 09 65 6e 63 6c 6f 73 65 64 20 be..\".enclosed
0400: 69 6e 20 6f 6e 65 20 6c 61 72 67 65 20 62 6f 78 in one large box
0410: 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 42 45 0a 2e 5c ...\"..\" .BE..\
0420: 22 09 45 6e 64 20 6f 66 20 62 6f 78 20 65 6e 63 ".End of box enc
0430: 6c 6f 73 75 72 65 2e 0a 2e 5c 22 0a 2e 5c 22 20 losure...\"..\"
0440: 2e 43 53 0a 2e 5c 22 09 42 65 67 69 6e 20 63 6f .CS..\".Begin co
0450: 64 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c 22 0a de excerpt...\".
0460: 2e 5c 22 20 2e 43 45 0a 2e 5c 22 09 45 6e 64 20 .\" .CE..\".End
0470: 63 6f 64 65 20 65 78 63 65 72 70 74 2e 0a 2e 5c code excerpt...\
0480: 22 0a 2e 5c 22 20 2e 56 53 20 3f 76 65 72 73 69 "..\" .VS ?versi
0490: 6f 6e 3f 20 3f 62 72 3f 0a 2e 5c 22 09 42 65 67 on? ?br?..\".Beg
04a0: 69 6e 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 in vertical side
04b0: 62 61 72 2c 20 66 6f 72 20 75 73 65 20 69 6e 20 bar, for use in
04c0: 6d 61 72 6b 69 6e 67 20 6e 65 77 6c 79 2d 63 68 marking newly-ch
04d0: 61 6e 67 65 64 20 70 61 72 74 73 0a 2e 5c 22 09 anged parts..\".
04e0: 6f 66 20 6d 61 6e 20 70 61 67 65 73 2e 20 20 54 of man pages. T
04f0: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
0500: 74 20 69 73 20 69 67 6e 6f 72 65 64 20 61 6e 64 t is ignored and
0510: 20 75 73 65 64 20 66 6f 72 20 72 65 63 6f 72 64 used for record
0520: 69 6e 67 0a 2e 5c 22 09 74 68 65 20 76 65 72 73 ing..\".the vers
0530: 69 6f 6e 20 77 68 65 6e 20 74 68 65 20 2e 56 53 ion when the .VS
0540: 20 77 61 73 20 61 64 64 65 64 2c 20 73 6f 20 74 was added, so t
0550: 68 61 74 20 74 68 65 20 73 69 64 65 62 61 72 73 hat the sidebars
0560: 20 63 61 6e 20 62 65 0a 2e 5c 22 09 66 6f 75 6e can be..\".foun
0570: 64 20 61 6e 64 20 72 65 6d 6f 76 65 64 20 77 68 d and removed wh
0580: 65 6e 20 74 68 65 79 20 72 65 61 63 68 20 61 20 en they reach a
0590: 63 65 72 74 61 69 6e 20 61 67 65 2e 20 20 49 66 certain age. If
05a0: 20 61 6e 6f 74 68 65 72 20 61 72 67 75 6d 65 6e another argumen
05b0: 74 0a 2e 5c 22 09 69 73 20 70 72 65 73 65 6e 74 t..\".is present
05c0: 2c 20 74 68 65 6e 20 61 20 6c 69 6e 65 20 62 72 , then a line br
05d0: 65 61 6b 20 69 73 20 66 6f 72 63 65 64 20 62 65 eak is forced be
05e0: 66 6f 72 65 20 73 74 61 72 74 69 6e 67 20 74 68 fore starting th
05f0: 65 20 73 69 64 65 62 61 72 2e 0a 2e 5c 22 0a 2e e sidebar...\"..
0600: 5c 22 20 2e 56 45 0a 2e 5c 22 09 45 6e 64 20 6f \" .VE..\".End o
0610: 66 20 76 65 72 74 69 63 61 6c 20 73 69 64 65 62 f vertical sideb
0620: 61 72 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 44 53 0a ar...\"..\" .DS.
0630: 2e 5c 22 09 42 65 67 69 6e 20 61 6e 20 69 6e 64 .\".Begin an ind
0640: 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 20 64 ented unfilled d
0650: 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 isplay...\"..\"
0660: 2e 44 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 69 .DE..\".End of i
0670: 6e 64 65 6e 74 65 64 20 75 6e 66 69 6c 6c 65 64 ndented unfilled
0680: 20 64 69 73 70 6c 61 79 2e 0a 2e 5c 22 0a 2e 5c display...\"..\
0690: 22 20 2e 53 4f 20 3f 6d 61 6e 70 61 67 65 3f 0a " .SO ?manpage?.
06a0: 2e 5c 22 09 53 74 61 72 74 20 6f 66 20 6c 69 73 .\".Start of lis
06b0: 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f 70 t of standard op
06c0: 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 77 tions for a Tk w
06d0: 69 64 67 65 74 2e 20 54 68 65 20 6d 61 6e 70 61 idget. The manpa
06e0: 67 65 0a 2e 5c 22 09 61 72 67 75 6d 65 6e 74 20 ge..\".argument
06f0: 64 65 66 69 6e 65 73 20 77 68 65 72 65 20 74 6f defines where to
0700: 20 6c 6f 6f 6b 20 75 70 20 74 68 65 20 73 74 61 look up the sta
0710: 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 3b 20 69 ndard options; i
0720: 66 0a 2e 5c 22 09 6f 6d 69 74 74 65 64 2c 20 64 f..\".omitted, d
0730: 65 66 61 75 6c 74 73 20 74 6f 20 22 6f 70 74 69 efaults to "opti
0740: 6f 6e 73 22 2e 20 54 68 65 20 6f 70 74 69 6f 6e ons". The option
0750: 73 20 66 6f 6c 6c 6f 77 20 6f 6e 20 73 75 63 63 s follow on succ
0760: 65 73 73 69 76 65 0a 2e 5c 22 09 6c 69 6e 65 73 essive..\".lines
0770: 2c 20 69 6e 20 74 68 72 65 65 20 63 6f 6c 75 6d , in three colum
0780: 6e 73 20 73 65 70 61 72 61 74 65 64 20 62 79 20 ns separated by
0790: 74 61 62 73 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e 53 tabs...\"..\" .S
07a0: 45 0a 2e 5c 22 09 45 6e 64 20 6f 66 20 6c 69 73 E..\".End of lis
07b0: 74 20 6f 66 20 73 74 61 6e 64 61 72 64 20 6f 70 t of standard op
07c0: 74 69 6f 6e 73 20 66 6f 72 20 61 20 54 6b 20 77 tions for a Tk w
07d0: 69 64 67 65 74 2e 0a 2e 5c 22 0a 2e 5c 22 20 2e idget...\"..\" .
07e0: 4f 50 20 63 6d 64 4e 61 6d 65 20 64 62 4e 61 6d OP cmdName dbNam
07f0: 65 20 64 62 43 6c 61 73 73 0a 2e 5c 22 09 53 74 e dbClass..\".St
0800: 61 72 74 20 6f 66 20 64 65 73 63 72 69 70 74 69 art of descripti
0810: 6f 6e 20 6f 66 20 61 20 73 70 65 63 69 66 69 63 on of a specific
0820: 20 6f 70 74 69 6f 6e 2e 20 20 63 6d 64 4e 61 6d option. cmdNam
0830: 65 20 67 69 76 65 73 20 74 68 65 0a 2e 5c 22 09 e gives the..\".
0840: 6f 70 74 69 6f 6e 27 73 20 6e 61 6d 65 20 61 73 option's name as
0850: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 74 68 specified in th
0860: 65 20 63 6c 61 73 73 20 63 6f 6d 6d 61 6e 64 2c e class command,
0870: 20 64 62 4e 61 6d 65 20 67 69 76 65 73 0a 2e 5c dbName gives..\
0880: 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 6e ".the option's n
0890: 61 6d 65 20 69 6e 20 74 68 65 20 6f 70 74 69 6f ame in the optio
08a0: 6e 20 64 61 74 61 62 61 73 65 2c 20 61 6e 64 20 n database, and
08b0: 64 62 43 6c 61 73 73 20 67 69 76 65 73 0a 2e 5c dbClass gives..\
08c0: 22 09 74 68 65 20 6f 70 74 69 6f 6e 27 73 20 63 ".the option's c
08d0: 6c 61 73 73 20 69 6e 20 74 68 65 20 6f 70 74 69 lass in the opti
08e0: 6f 6e 20 64 61 74 61 62 61 73 65 2e 0a 2e 5c 22 on database...\"
08f0: 0a 2e 5c 22 20 2e 55 4c 20 61 72 67 31 20 61 72 ..\" .UL arg1 ar
0900: 67 32 0a 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 g2..\".Print arg
0910: 31 20 75 6e 64 65 72 6c 69 6e 65 64 2c 20 74 68 1 underlined, th
0920: 65 6e 20 70 72 69 6e 74 20 61 72 67 32 20 6e 6f en print arg2 no
0930: 72 6d 61 6c 6c 79 2e 0a 2e 5c 22 0a 2e 5c 22 20 rmally...\"..\"
0940: 2e 51 57 20 61 72 67 31 20 3f 61 72 67 32 3f 0a .QW arg1 ?arg2?.
0950: 2e 5c 22 09 50 72 69 6e 74 20 61 72 67 31 20 69 .\".Print arg1 i
0960: 6e 20 71 75 6f 74 65 73 2c 20 74 68 65 6e 20 61 n quotes, then a
0970: 72 67 32 20 6e 6f 72 6d 61 6c 6c 79 20 28 66 6f rg2 normally (fo
0980: 72 20 74 72 61 69 6c 69 6e 67 20 70 75 6e 63 74 r trailing punct
0990: 75 61 74 69 6f 6e 29 2e 0a 2e 5c 22 0a 2e 5c 22 uation)...\"..\"
09a0: 20 2e 50 51 20 61 72 67 31 20 3f 61 72 67 32 3f .PQ arg1 ?arg2?
09b0: 0a 2e 5c 22 09 50 72 69 6e 74 20 61 6e 20 6f 70 ..\".Print an op
09c0: 65 6e 20 70 61 72 65 6e 74 68 65 73 69 73 2c 20 en parenthesis,
09d0: 61 72 67 31 20 69 6e 20 71 75 6f 74 65 73 2c 20 arg1 in quotes,
09e0: 74 68 65 6e 20 61 72 67 32 20 6e 6f 72 6d 61 6c then arg2 normal
09f0: 6c 79 0a 2e 5c 22 09 28 66 6f 72 20 74 72 61 69 ly..\".(for trai
0a00: 6c 69 6e 67 20 70 75 6e 63 74 75 61 74 69 6f 6e ling punctuation
0a10: 29 20 61 6e 64 20 74 68 65 6e 20 61 20 63 6c 6f ) and then a clo
0a20: 73 69 6e 67 20 70 61 72 65 6e 74 68 65 73 69 73 sing parenthesis
0a30: 2e 0a 2e 5c 22 0a 2e 5c 22 09 23 20 53 65 74 20 ...\"..\".# Set
0a40: 75 70 20 74 72 61 70 73 20 61 6e 64 20 6f 74 68 up traps and oth
0a50: 65 72 20 6d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 er miscellaneous
0a60: 20 73 74 75 66 66 20 66 6f 72 20 54 63 6c 2f 54 stuff for Tcl/T
0a70: 6b 20 6d 61 6e 20 70 61 67 65 73 2e 0a 2e 69 66 k man pages...if
0a80: 20 74 20 2e 77 68 20 2d 31 2e 33 69 20 5e 42 0a t .wh -1.3i ^B.
0a90: 2e 6e 72 20 5e 6c 20 5c 6e 28 2e 6c 0a 2e 61 64 .nr ^l \n(.l..ad
0aa0: 20 62 0a 2e 5c 22 09 23 20 53 74 61 72 74 20 61 b..\".# Start a
0ab0: 6e 20 61 72 67 75 6d 65 6e 74 20 64 65 73 63 72 n argument descr
0ac0: 69 70 74 69 6f 6e 0a 2e 64 65 20 41 50 0a 2e 69 iption..de AP..i
0ad0: 65 20 21 22 5c 5c 24 34 22 22 20 2e 54 50 20 5c e !"\\$4"" .TP \
0ae0: 5c 24 34 0a 2e 65 6c 20 5c 7b 5c 0a 2e 20 20 20 \$4..el \{\..
0af0: 69 65 20 21 22 5c 5c 24 32 22 22 20 2e 54 50 20 ie !"\\$2"" .TP
0b00: 5c 5c 6e 28 29 43 75 0a 2e 20 20 20 65 6c 20 20 \\n()Cu.. el
0b10: 20 20 20 20 20 20 20 20 2e 54 50 20 31 35 0a 2e .TP 15..
0b20: 5c 7d 0a 2e 74 61 20 5c 5c 6e 28 29 41 75 20 5c \}..ta \\n()Au \
0b30: 5c 6e 28 29 42 75 0a 2e 69 65 20 21 22 5c 5c 24 \n()Bu..ie !"\\$
0b40: 33 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 20 5c 3"" \{\.\&\\$1 \
0b50: 5c 66 49 5c 5c 24 32 5c 5c 66 50 20 28 5c 5c 24 \fI\\$2\\fP (\\$
0b60: 33 29 0a 2e 5c 22 2e 62 0a 2e 5c 7d 0a 2e 65 6c 3)..\".b..\}..el
0b70: 20 5c 7b 5c 0a 2e 62 72 0a 2e 69 65 20 21 22 5c \{\..br..ie !"\
0b80: 5c 24 32 22 22 20 5c 7b 5c 0a 5c 26 5c 5c 24 31 \$2"" \{\.\&\\$1
0b90: 09 5c 5c 66 49 5c 5c 24 32 5c 5c 66 50 0a 2e 5c .\\fI\\$2\\fP..\
0ba0: 7d 0a 2e 65 6c 20 5c 7b 5c 0a 5c 26 5c 5c 66 49 }..el \{\.\&\\fI
0bb0: 5c 5c 24 31 5c 5c 66 50 0a 2e 5c 7d 0a 2e 5c 7d \\$1\\fP..\}..\}
0bc0: 0a 2e 2e 0a 2e 5c 22 09 23 20 64 65 66 69 6e 65 .....\".# define
0bd0: 20 74 61 62 62 69 6e 67 20 76 61 6c 75 65 73 20 tabbing values
0be0: 66 6f 72 20 2e 41 50 0a 2e 64 65 20 41 53 0a 2e for .AP..de AS..
0bf0: 6e 72 20 29 41 20 31 30 6e 0a 2e 69 66 20 21 22 nr )A 10n..if !"
0c00: 5c 5c 24 31 22 22 20 2e 6e 72 20 29 41 20 5c 5c \\$1"" .nr )A \\
0c10: 77 27 5c 5c 24 31 27 75 2b 33 6e 0a 2e 6e 72 20 w'\\$1'u+3n..nr
0c20: 29 42 20 5c 5c 6e 28 29 41 75 2b 31 35 6e 0a 2e )B \\n()Au+15n..
0c30: 5c 22 0a 2e 69 66 20 21 22 5c 5c 24 32 22 22 20 \"..if !"\\$2""
0c40: 2e 6e 72 20 29 42 20 5c 5c 77 27 5c 5c 24 32 27 .nr )B \\w'\\$2'
0c50: 75 2b 5c 5c 6e 28 29 41 75 2b 33 6e 0a 2e 6e 72 u+\\n()Au+3n..nr
0c60: 20 29 43 20 5c 5c 6e 28 29 42 75 2b 5c 5c 77 27 )C \\n()Bu+\\w'
0c70: 28 69 6e 2f 6f 75 74 29 27 75 2b 32 6e 0a 2e 2e (in/out)'u+2n...
0c80: 0a 2e 41 53 20 54 63 6c 5f 49 6e 74 65 72 70 20 ..AS Tcl_Interp
0c90: 54 63 6c 5f 43 72 65 61 74 65 49 6e 74 65 72 70 Tcl_CreateInterp
0ca0: 20 69 6e 2f 6f 75 74 0a 2e 5c 22 09 23 20 42 53 in/out..\".# BS
0cb0: 20 2d 20 73 74 61 72 74 20 62 6f 78 65 64 20 74 - start boxed t
0cc0: 65 78 74 0a 2e 5c 22 09 23 20 5e 79 20 3d 20 73 ext..\".# ^y = s
0cd0: 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 74 69 tarting y locati
0ce0: 6f 6e 0a 2e 5c 22 09 23 20 5e 62 20 3d 20 31 0a on..\".# ^b = 1.
0cf0: 2e 64 65 20 42 53 0a 2e 62 72 0a 2e 6d 6b 20 5e .de BS..br..mk ^
0d00: 79 0a 2e 6e 72 20 5e 62 20 31 75 0a 2e 69 66 20 y..nr ^b 1u..if
0d10: 6e 20 2e 6e 66 0a 2e 69 66 20 6e 20 2e 74 69 20 n .nf..if n .ti
0d20: 30 0a 2e 69 66 20 6e 20 5c 6c 27 5c 5c 6e 28 2e 0..if n \l'\\n(.
0d30: 6c 75 5c 28 75 6c 27 0a 2e 69 66 20 6e 20 2e 66 lu\(ul'..if n .f
0d40: 69 0a 2e 2e 0a 2e 5c 22 09 23 20 42 45 20 2d 20 i.....\".# BE -
0d50: 65 6e 64 20 62 6f 78 65 64 20 74 65 78 74 20 28 end boxed text (
0d60: 64 72 61 77 20 62 6f 78 20 6e 6f 77 29 0a 2e 64 draw box now)..d
0d70: 65 20 42 45 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e e BE..nf..ti 0..
0d80: 6d 6b 20 5e 74 0a 2e 69 65 20 6e 20 5c 6c 27 5c mk ^t..ie n \l'\
0d90: 5c 6e 28 5e 6c 75 5c 28 75 6c 27 0a 2e 65 6c 20 \n(^lu\(ul'..el
0da0: 5c 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 66 6f 75 \{\..\".Draw fou
0db0: 72 2d 73 69 64 65 64 20 62 6f 78 20 6e 6f 72 6d r-sided box norm
0dc0: 61 6c 6c 79 2c 20 62 75 74 20 64 6f 6e 27 74 20 ally, but don't
0dd0: 64 72 61 77 20 74 6f 70 20 6f 66 0a 2e 5c 22 09 draw top of..\".
0de0: 62 6f 78 20 69 66 20 74 68 65 20 62 6f 78 20 73 box if the box s
0df0: 74 61 72 74 65 64 20 6f 6e 20 61 6e 20 65 61 72 tarted on an ear
0e00: 6c 69 65 72 20 70 61 67 65 2e 0a 2e 69 65 20 21 lier page...ie !
0e10: 5c 5c 6e 28 5e 62 2d 31 20 5c 7b 5c 0a 5c 68 27 \\n(^b-1 \{\.\h'
0e20: 2d 31 2e 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 -1.5n'\L'|\\n(^y
0e30: 75 2d 31 76 27 5c 6c 27 5c 5c 6e 28 5e 6c 75 2b u-1v'\l'\\n(^lu+
0e40: 33 6e 5c 28 75 6c 27 5c 4c 27 5c 5c 6e 28 5e 74 3n\(ul'\L'\\n(^t
0e50: 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c 6c 27 u+1v-\\n(^yu'\l'
0e60: 7c 30 75 2d 31 2e 35 6e 5c 28 75 6c 27 0a 2e 5c |0u-1.5n\(ul'..\
0e70: 7d 0a 2e 65 6c 20 5c 7d 5c 0a 5c 68 27 2d 31 2e }..el \}\.\h'-1.
0e80: 35 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 79 75 2d 31 5n'\L'|\\n(^yu-1
0e90: 76 27 5c 68 27 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 v'\h'\\n(^lu+3n'
0ea0: 5c 4c 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c \L'\\n(^tu+1v-\\
0eb0: 6e 28 5e 79 75 27 5c 6c 27 7c 30 75 2d 31 2e 35 n(^yu'\l'|0u-1.5
0ec0: 6e 5c 28 75 6c 27 0a 2e 5c 7d 0a 2e 5c 7d 0a 2e n\(ul'..\}..\}..
0ed0: 66 69 0a 2e 62 72 0a 2e 6e 72 20 5e 62 20 30 0a fi..br..nr ^b 0.
0ee0: 2e 2e 0a 2e 5c 22 09 23 20 56 53 20 2d 20 73 74 ....\".# VS - st
0ef0: 61 72 74 20 76 65 72 74 69 63 61 6c 20 73 69 64 art vertical sid
0f00: 65 62 61 72 0a 2e 5c 22 09 23 20 5e 59 20 3d 20 ebar..\".# ^Y =
0f10: 73 74 61 72 74 69 6e 67 20 79 20 6c 6f 63 61 74 starting y locat
0f20: 69 6f 6e 0a 2e 5c 22 09 23 20 5e 76 20 3d 20 31 ion..\".# ^v = 1
0f30: 20 28 66 6f 72 20 74 72 6f 66 66 3b 20 20 66 6f (for troff; fo
0f40: 72 20 6e 72 6f 66 66 20 74 68 69 73 20 64 6f 65 r nroff this doe
0f50: 73 6e 27 74 20 6d 61 74 74 65 72 29 0a 2e 64 65 sn't matter)..de
0f60: 20 56 53 0a 2e 69 66 20 21 22 5c 5c 24 32 22 22 VS..if !"\\$2""
0f70: 20 2e 62 72 0a 2e 6d 6b 20 5e 59 0a 2e 69 65 20 .br..mk ^Y..ie
0f80: 6e 20 27 6d 63 20 5c 73 31 32 5c 28 62 72 5c 73 n 'mc \s12\(br\s
0f90: 30 0a 2e 65 6c 20 2e 6e 72 20 5e 76 20 31 75 0a 0..el .nr ^v 1u.
0fa0: 2e 2e 0a 2e 5c 22 09 23 20 56 45 20 2d 20 65 6e ....\".# VE - en
0fb0: 64 20 6f 66 20 76 65 72 74 69 63 61 6c 20 73 69 d of vertical si
0fc0: 64 65 62 61 72 0a 2e 64 65 20 56 45 0a 2e 69 65 debar..de VE..ie
0fd0: 20 6e 20 27 6d 63 0a 2e 65 6c 20 5c 7b 5c 0a 2e n 'mc..el \{\..
0fe0: 65 76 20 32 0a 2e 6e 66 0a 2e 74 69 20 30 0a 2e ev 2..nf..ti 0..
0ff0: 6d 6b 20 5e 74 0a 5c 68 27 7c 5c 5c 6e 28 5e 6c mk ^t.\h'|\\n(^l
1000: 75 2b 33 6e 27 5c 4c 27 7c 5c 5c 6e 28 5e 59 75 u+3n'\L'|\\n(^Yu
1010: 2d 31 76 5c 28 62 76 27 5c 76 27 5c 5c 6e 28 5e -1v\(bv'\v'\\n(^
1020: 74 75 2b 31 76 2d 5c 5c 6e 28 5e 59 75 27 5c 68 tu+1v-\\n(^Yu'\h
1030: 27 2d 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e 27 0a 2e '-|\\n(^lu+3n'..
1040: 73 70 20 2d 31 0a 2e 66 69 0a 2e 65 76 0a 2e 5c sp -1..fi..ev..\
1050: 7d 0a 2e 6e 72 20 5e 76 20 30 0a 2e 2e 0a 2e 5c }..nr ^v 0.....\
1060: 22 09 23 20 53 70 65 63 69 61 6c 20 6d 61 63 72 ".# Special macr
1070: 6f 20 74 6f 20 68 61 6e 64 6c 65 20 70 61 67 65 o to handle page
1080: 20 62 6f 74 74 6f 6d 3a 20 20 66 69 6e 69 73 68 bottom: finish
1090: 20 6f 66 66 20 63 75 72 72 65 6e 74 0a 2e 5c 22 off current..\"
10a0: 09 23 20 62 6f 78 2f 73 69 64 65 62 61 72 20 69 .# box/sidebar i
10b0: 66 20 69 6e 20 62 6f 78 2f 73 69 64 65 62 61 72 f in box/sidebar
10c0: 20 6d 6f 64 65 2c 20 74 68 65 6e 20 69 6e 76 6f mode, then invo
10d0: 6b 65 64 20 73 74 61 6e 64 61 72 64 0a 2e 5c 22 ked standard..\"
10e0: 09 23 20 70 61 67 65 20 62 6f 74 74 6f 6d 20 6d .# page bottom m
10f0: 61 63 72 6f 2e 0a 2e 64 65 20 5e 42 0a 2e 65 76 acro...de ^B..ev
1100: 20 32 0a 27 74 69 20 30 0a 27 6e 66 0a 2e 6d 6b 2.'ti 0.'nf..mk
1110: 20 5e 74 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 5c ^t..if \\n(^b \
1120: 7b 5c 0a 2e 5c 22 09 44 72 61 77 20 74 68 72 65 {\..\".Draw thre
1130: 65 2d 73 69 64 65 64 20 62 6f 78 20 69 66 20 74 e-sided box if t
1140: 68 69 73 20 69 73 20 74 68 65 20 62 6f 78 27 73 his is the box's
1150: 20 66 69 72 73 74 20 70 61 67 65 2c 0a 2e 5c 22 first page,..\"
1160: 09 64 72 61 77 20 74 77 6f 20 73 69 64 65 73 20 .draw two sides
1170: 62 75 74 20 6e 6f 20 74 6f 70 20 6f 74 68 65 72 but no top other
1180: 77 69 73 65 2e 0a 2e 69 65 20 21 5c 5c 6e 28 5e wise...ie !\\n(^
1190: 62 2d 31 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 b-1 \h'-1.5n'\L'
11a0: 7c 5c 5c 6e 28 5e 79 75 2d 31 76 27 5c 6c 27 5c |\\n(^yu-1v'\l'\
11b0: 5c 6e 28 5e 6c 75 2b 33 6e 5c 28 75 6c 27 5c 4c \n(^lu+3n\(ul'\L
11c0: 27 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e 28 '\\n(^tu+1v-\\n(
11d0: 5e 79 75 27 5c 68 27 7c 30 75 27 5c 63 0a 2e 65 ^yu'\h'|0u'\c..e
11e0: 6c 20 5c 68 27 2d 31 2e 35 6e 27 5c 4c 27 7c 5c l \h'-1.5n'\L'|\
11f0: 5c 6e 28 5e 79 75 2d 31 76 27 5c 68 27 5c 5c 6e \n(^yu-1v'\h'\\n
1200: 28 5e 6c 75 2b 33 6e 27 5c 4c 27 5c 5c 6e 28 5e (^lu+3n'\L'\\n(^
1210: 74 75 2b 31 76 2d 5c 5c 6e 28 5e 79 75 27 5c 68 tu+1v-\\n(^yu'\h
1220: 27 7c 30 75 27 5c 63 0a 2e 5c 7d 0a 2e 69 66 20 '|0u'\c..\}..if
1230: 5c 5c 6e 28 5e 76 20 5c 7b 5c 0a 2e 6e 72 20 5e \\n(^v \{\..nr ^
1240: 78 20 5c 5c 6e 28 5e 74 75 2b 31 76 2d 5c 5c 6e x \\n(^tu+1v-\\n
1250: 28 5e 59 75 0a 5c 6b 78 5c 68 27 2d 5c 5c 6e 78 (^Yu.\kx\h'-\\nx
1260: 75 27 5c 68 27 7c 5c 5c 6e 28 5e 6c 75 2b 33 6e u'\h'|\\n(^lu+3n
1270: 27 5c 6b 79 5c 4c 27 2d 5c 5c 6e 28 5e 78 75 27 '\ky\L'-\\n(^xu'
1280: 5c 76 27 5c 5c 6e 28 5e 78 75 27 5c 68 27 7c 30 \v'\\n(^xu'\h'|0
1290: 75 27 5c 63 0a 2e 5c 7d 0a 2e 62 70 0a 27 66 69 u'\c..\}..bp.'fi
12a0: 0a 2e 65 76 0a 2e 69 66 20 5c 5c 6e 28 5e 62 20 ..ev..if \\n(^b
12b0: 5c 7b 5c 0a 2e 6d 6b 20 5e 79 0a 2e 6e 72 20 5e \{\..mk ^y..nr ^
12c0: 62 20 32 0a 2e 5c 7d 0a 2e 69 66 20 5c 5c 6e 28 b 2..\}..if \\n(
12d0: 5e 76 20 5c 7b 5c 0a 2e 6d 6b 20 5e 59 0a 2e 5c ^v \{\..mk ^Y..\
12e0: 7d 0a 2e 2e 0a 2e 5c 22 09 23 20 44 53 20 2d 20 }.....\".# DS -
12f0: 62 65 67 69 6e 20 64 69 73 70 6c 61 79 0a 2e 64 begin display..d
1300: 65 20 44 53 0a 2e 52 53 0a 2e 6e 66 0a 2e 73 70 e DS..RS..nf..sp
1310: 0a 2e 2e 0a 2e 5c 22 09 23 20 44 45 20 2d 20 65 .....\".# DE - e
1320: 6e 64 20 64 69 73 70 6c 61 79 0a 2e 64 65 20 44 nd display..de D
1330: 45 0a 2e 66 69 0a 2e 52 45 0a 2e 73 70 0a 2e 2e E..fi..RE..sp...
1340: 0a 2e 5c 22 09 23 20 53 4f 20 2d 20 73 74 61 72 ..\".# SO - star
1350: 74 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 74 61 t of list of sta
1360: 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a 2e 64 ndard options..d
1370: 65 20 53 4f 0a 27 69 65 20 27 5c 5c 24 31 27 27 e SO.'ie '\\$1''
1380: 20 2e 64 73 20 53 6f 20 5c 5c 66 42 6f 70 74 69 .ds So \\fBopti
1390: 6f 6e 73 5c 5c 66 52 0a 27 65 6c 20 2e 64 73 20 ons\\fR.'el .ds
13a0: 53 6f 20 5c 5c 66 42 5c 5c 24 31 5c 5c 66 52 0a So \\fB\\$1\\fR.
13b0: 2e 53 48 20 22 53 54 41 4e 44 41 52 44 20 4f 50 .SH "STANDARD OP
13c0: 54 49 4f 4e 53 22 0a 2e 4c 50 0a 2e 6e 66 0a 2e TIONS"..LP..nf..
13d0: 74 61 20 35 2e 35 63 20 31 31 63 0a 2e 66 74 20 ta 5.5c 11c..ft
13e0: 42 0a 2e 2e 0a 2e 5c 22 09 23 20 53 45 20 2d 20 B.....\".# SE -
13f0: 65 6e 64 20 6f 66 20 6c 69 73 74 20 6f 66 20 73 end of list of s
1400: 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 73 0a tandard options.
1410: 2e 64 65 20 53 45 0a 2e 66 69 0a 2e 66 74 20 52 .de SE..fi..ft R
1420: 0a 2e 4c 50 0a 53 65 65 20 74 68 65 20 5c 5c 2a ..LP.See the \\*
1430: 28 53 6f 20 6d 61 6e 75 61 6c 20 65 6e 74 72 79 (So manual entry
1440: 20 66 6f 72 20 64 65 74 61 69 6c 73 20 6f 6e 20 for details on
1450: 74 68 65 20 73 74 61 6e 64 61 72 64 20 6f 70 74 the standard opt
1460: 69 6f 6e 73 2e 0a 2e 2e 0a 2e 5c 22 09 23 20 4f ions......\".# O
1470: 50 20 2d 20 73 74 61 72 74 20 6f 66 20 66 75 6c P - start of ful
1480: 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 66 6f l description fo
1490: 72 20 61 20 73 69 6e 67 6c 65 20 6f 70 74 69 6f r a single optio
14a0: 6e 0a 2e 64 65 20 4f 50 0a 2e 4c 50 0a 2e 6e 66 n..de OP..LP..nf
14b0: 0a 2e 74 61 20 34 63 0a 43 6f 6d 6d 61 6e 64 2d ..ta 4c.Command-
14c0: 4c 69 6e 65 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c Line Name:.\\fB\
14d0: 5c 24 31 5c 5c 66 52 0a 44 61 74 61 62 61 73 65 \$1\\fR.Database
14e0: 20 4e 61 6d 65 3a 09 5c 5c 66 42 5c 5c 24 32 5c Name:.\\fB\\$2\
14f0: 5c 66 52 0a 44 61 74 61 62 61 73 65 20 43 6c 61 \fR.Database Cla
1500: 73 73 3a 09 5c 5c 66 42 5c 5c 24 33 5c 5c 66 52 ss:.\\fB\\$3\\fR
1510: 0a 2e 66 69 0a 2e 49 50 0a 2e 2e 0a 2e 5c 22 09 ..fi..IP.....\".
1520: 23 20 43 53 20 2d 20 62 65 67 69 6e 20 63 6f 64 # CS - begin cod
1530: 65 20 65 78 63 65 72 70 74 0a 2e 64 65 20 43 53 e excerpt..de CS
1540: 0a 2e 52 53 0a 2e 6e 66 0a 2e 74 61 20 2e 32 35 ..RS..nf..ta .25
1550: 69 20 2e 35 69 20 2e 37 35 69 20 31 69 0a 2e 2e i .5i .75i 1i...
1560: 0a 2e 5c 22 09 23 20 43 45 20 2d 20 65 6e 64 20 ..\".# CE - end
1570: 63 6f 64 65 20 65 78 63 65 72 70 74 0a 2e 64 65 code excerpt..de
1580: 20 43 45 0a 2e 66 69 0a 2e 52 45 0a 2e 2e 0a 2e CE..fi..RE.....
1590: 5c 22 09 23 20 55 4c 20 2d 20 75 6e 64 65 72 6c \".# UL - underl
15a0: 69 6e 65 20 77 6f 72 64 0a 2e 64 65 20 55 4c 0a ine word..de UL.
15b0: 5c 5c 24 31 5c 6c 27 7c 30 5c 28 75 6c 27 5c 5c \\$1\l'|0\(ul'\\
15c0: 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 51 57 20 2d $2.....\".# QW -
15d0: 20 61 70 70 6c 79 20 71 75 6f 74 61 74 69 6f 6e apply quotation
15e0: 20 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a 2e marks to word..
15f0: 64 65 20 51 57 0a 2e 69 65 20 27 5c 5c 2a 28 6c de QW..ie '\\*(l
1600: 71 27 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c 24 q'"' ``\\$1''\\$
1610: 32 0a 2e 5c 22 22 20 66 69 78 20 65 6d 61 63 73 2..\"" fix emacs
1620: 20 68 69 67 68 6c 69 67 68 74 69 6e 67 0a 2e 65 highlighting..e
1630: 6c 20 5c 5c 2a 28 6c 71 5c 5c 24 31 5c 5c 2a 28 l \\*(lq\\$1\\*(
1640: 72 71 5c 5c 24 32 0a 2e 2e 0a 2e 5c 22 09 23 20 rq\\$2.....\".#
1650: 50 51 20 2d 20 61 70 70 6c 79 20 70 61 72 65 6e PQ - apply paren
1660: 73 20 61 6e 64 20 71 75 6f 74 61 74 69 6f 6e 20 s and quotation
1670: 6d 61 72 6b 73 20 74 6f 20 77 6f 72 64 0a 2e 64 marks to word..d
1680: 65 20 50 51 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 e PQ..ie '\\*(lq
1690: 27 22 27 20 28 60 60 5c 5c 24 31 27 27 5c 5c 24 '"' (``\\$1''\\$
16a0: 32 29 5c 5c 24 33 0a 2e 5c 22 22 20 66 69 78 20 2)\\$3..\"" fix
16b0: 65 6d 61 63 73 20 68 69 67 68 6c 69 67 68 74 69 emacs highlighti
16c0: 6e 67 0a 2e 65 6c 20 28 5c 5c 2a 28 6c 71 5c 5c ng..el (\\*(lq\\
16d0: 24 31 5c 5c 2a 28 72 71 5c 5c 24 32 29 5c 5c 24 $1\\*(rq\\$2)\\$
16e0: 33 0a 2e 2e 0a 2e 5c 22 09 23 20 51 52 20 2d 20 3.....\".# QR -
16f0: 71 75 6f 74 65 64 20 72 61 6e 67 65 0a 2e 64 65 quoted range..de
1700: 20 51 52 0a 2e 69 65 20 27 5c 5c 2a 28 6c 71 27 QR..ie '\\*(lq'
1710: 22 27 20 60 60 5c 5c 24 31 27 27 5c 5c 2d 60 60 "' ``\\$1''\\-``
1720: 5c 5c 24 32 27 27 5c 5c 24 33 0a 2e 5c 22 22 20 \\$2''\\$3..\""
1730: 66 69 78 20 65 6d 61 63 73 20 68 69 67 68 6c 69 fix emacs highli
1740: 67 68 74 69 6e 67 0a 2e 65 6c 20 5c 5c 2a 28 6c ghting..el \\*(l
1750: 71 5c 5c 24 31 5c 5c 2a 28 72 71 5c 5c 2d 5c 5c q\\$1\\*(rq\\-\\
1760: 2a 28 6c 71 5c 5c 24 32 5c 5c 2a 28 72 71 5c 5c *(lq\\$2\\*(rq\\
1770: 24 33 0a 2e 2e 0a 2e 5c 22 09 23 20 4d 54 20 2d $3.....\".# MT -
1780: 20 22 65 6d 70 74 79 22 20 73 74 72 69 6e 67 0a "empty" string.
1790: 2e 64 65 20 4d 54 0a 2e 51 57 20 22 22 0a 2e 2e .de MT..QW ""...
17a0: 0a 2e 42 53 0a 2e 53 48 20 4e 41 4d 45 0a 74 6c ..BS..SH NAME.tl
17b0: 73 20 5c 2d 20 62 69 6e 64 69 6e 67 20 74 6f 20 s \- binding to
17c0: 74 68 65 20 4f 70 65 6e 53 53 4c 20 6c 69 62 72 the OpenSSL libr
17d0: 61 72 79 20 66 6f 72 20 65 6e 63 72 79 70 74 65 ary for encrypte
17e0: 64 20 73 6f 63 6b 65 74 20 61 6e 64 20 49 2f 4f d socket and I/O
17f0: 20 63 68 61 6e 6e 65 6c 20 63 6f 6d 6d 75 6e 69 channel communi
1800: 63 61 74 69 6f 6e 73 0a 2e 53 48 20 53 59 4e 4f cations..SH SYNO
1810: 50 53 49 53 0a 70 61 63 6b 61 67 65 20 72 65 71 PSIS.package req
1820: 75 69 72 65 20 5c 66 42 54 63 6c 20 38 5c 26 2e uire \fBTcl 8\&.
1830: 35 2d 5c 66 52 0a 2e 73 70 0a 70 61 63 6b 61 67 5-\fR..sp.packag
1840: 65 20 72 65 71 75 69 72 65 20 5c 66 42 74 6c 73 e require \fBtls
1850: 20 32 5c 26 2e 30 62 31 5c 66 52 0a 2e 73 70 0a 2\&.0b1\fR..sp.
1860: 5c 66 42 74 6c 73 3a 3a 69 6e 69 74 5c 66 52 20 \fBtls::init\fR
1870: 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 3f 20 ?\fI-option\fR?
1880: 3f 5c 66 49 76 61 6c 75 65 5c 66 52 3f 20 3f 5c ?\fIvalue\fR? ?\
1890: 66 49 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 65 20 fI-option value
18a0: 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 0a 2e 73 \&.\&.\&.\fR?..s
18b0: 70 0a 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 p.\fBtls::socket
18c0: 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c \fR ?\fI-option\
18d0: 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 5c 66 52 fR? ?\fIvalue\fR
18e0: 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 76 61 ? ?\fI-option va
18f0: 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 lue \&.\&.\&.\fR
1900: 3f 20 5c 66 49 68 6f 73 74 5c 66 52 20 5c 66 49 ? \fIhost\fR \fI
1910: 70 6f 72 74 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 port\fR..sp.\fBt
1920: 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 20 5c 66 ls::socket\fR \f
1930: 42 2d 73 65 72 76 65 72 5c 66 52 20 5c 66 49 63 B-server\fR \fIc
1940: 6f 6d 6d 61 6e 64 5c 66 52 20 3f 5c 66 49 2d 6f ommand\fR ?\fI-o
1950: 70 74 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 ption\fR? ?\fIva
1960: 6c 75 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 lue\fR? ?\fI-opt
1970: 69 6f 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e ion value \&.\&.
1980: 5c 26 2e 5c 66 52 3f 20 5c 66 49 70 6f 72 74 5c \&.\fR? \fIport\
1990: 66 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 69 fR..sp.\fBtls::i
19a0: 6d 70 6f 72 74 5c 66 52 20 5c 66 49 63 68 61 6e mport\fR \fIchan
19b0: 6e 65 6c 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 69 nel\fR ?\fI-opti
19c0: 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 on\fR? ?\fIvalue
19d0: 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e \fR? ?\fI-option
19e0: 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 2e value \&.\&.\&.
19f0: 5c 66 52 3f 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a \fR?..sp.\fBtls:
1a00: 3a 75 6e 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 :unimport\fR \fI
1a10: 63 68 61 6e 6e 65 6c 5c 66 52 0a 2e 73 70 0a 5c channel\fR..sp.\
1a20: 66 42 74 6c 73 3a 3a 68 61 6e 64 73 68 61 6b 65 fBtls::handshake
1a30: 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 \fR \fIchannel\f
1a40: 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 73 74 R..sp.\fBtls::st
1a50: 61 74 75 73 5c 66 52 20 3f 5c 66 42 2d 6c 6f 63 atus\fR ?\fB-loc
1a60: 61 6c 5c 66 52 3f 20 5c 66 49 63 68 61 6e 6e 65 al\fR? \fIchanne
1a70: 6c 5c 66 52 0a 2e 73 70 0a 5c 66 42 74 6c 73 3a l\fR..sp.\fBtls:
1a80: 3a 63 6f 6e 6e 65 63 74 69 6f 6e 5c 66 52 20 5c :connection\fR \
1a90: 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a 2e 73 70 fIchannel\fR..sp
1aa0: 0a 5c 66 42 74 6c 73 3a 3a 63 69 70 68 65 72 73 .\fBtls::ciphers
1ab0: 5c 66 52 20 3f 5c 66 49 70 72 6f 74 6f 63 6f 6c \fR ?\fIprotocol
1ac0: 5c 66 52 3f 20 3f 5c 66 49 76 65 72 62 6f 73 65 \fR? ?\fIverbose
1ad0: 5c 66 52 3f 20 3f 5c 66 49 73 75 70 70 6f 72 74 \fR? ?\fIsupport
1ae0: 65 64 5c 66 52 3f 0a 2e 73 70 0a 5c 66 42 74 6c ed\fR?..sp.\fBtl
1af0: 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 0a s::protocols\fR.
1b00: 2e 73 70 0a 5c 66 42 74 6c 73 3a 3a 76 65 72 73 .sp.\fBtls::vers
1b10: 69 6f 6e 5c 66 52 0a 2e 73 70 0a 2e 42 45 0a 2e ion\fR..sp..BE..
1b20: 53 48 20 44 45 53 43 52 49 50 54 49 4f 4e 0a 54 SH DESCRIPTION.T
1b30: 68 69 73 20 65 78 74 65 6e 73 69 6f 6e 20 70 72 his extension pr
1b40: 6f 76 69 64 65 73 20 54 43 4c 20 73 63 72 69 70 ovides TCL scrip
1b50: 74 20 61 63 63 65 73 73 20 74 6f 20 73 65 63 75 t access to secu
1b60: 72 65 20 73 6f 63 6b 65 74 20 63 6f 6d 6d 75 6e re socket commun
1b70: 69 63 61 74 69 6f 6e 73 0a 75 73 69 6e 67 20 74 ications.using t
1b80: 68 65 20 54 72 61 6e 73 70 6f 72 74 20 4c 61 79 he Transport Lay
1b90: 65 72 20 53 65 63 75 72 69 74 79 20 28 54 4c 53 er Security (TLS
1ba0: 29 20 70 72 6f 74 6f 63 6f 6c 5c 26 2e 20 49 74 ) protocol\&. It
1bb0: 20 70 72 6f 76 69 64 65 73 20 61 20 67 65 6e 65 provides a gene
1bc0: 72 69 63 0a 62 69 6e 64 69 6e 67 20 74 6f 20 5c ric.binding to \
1bd0: 66 49 4f 70 65 6e 53 53 4c 5c 66 52 20 5b 68 74 fIOpenSSL\fR [ht
1be0: 74 70 73 3a 2f 2f 77 77 77 5c 26 2e 6f 70 65 6e tps://www\&.open
1bf0: 73 73 6c 5c 26 2e 6f 72 67 2f 5d 2c 20 75 74 69 ssl\&.org/], uti
1c00: 6c 69 7a 69 6e 67 20 74 68 65 0a 5c 66 42 54 63 lizing the.\fBTc
1c10: 6c 5f 53 74 61 63 6b 43 68 61 6e 6e 65 6c 5c 66 l_StackChannel\f
1c20: 52 20 41 50 49 20 69 6e 20 54 43 4c 20 38 5c 26 R API in TCL 8\&
1c30: 2e 34 20 6f 72 20 6c 61 74 65 72 5c 26 2e 0a 54 .4 or later\&..T
1c40: 68 65 73 65 20 73 6f 63 6b 65 74 73 20 62 65 68 hese sockets beh
1c50: 61 76 65 20 65 78 61 63 74 6c 79 20 74 68 65 20 ave exactly the
1c60: 73 61 6d 65 20 61 73 20 63 68 61 6e 6e 65 6c 73 same as channels
1c70: 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 74 created using t
1c80: 68 65 20 62 75 69 6c 74 2d 69 6e 0a 5c 66 42 73 he built-in.\fBs
1c90: 6f 63 6b 65 74 5c 66 52 20 63 6f 6d 6d 61 6e 64 ocket\fR command
1ca0: 2c 20 62 75 74 20 70 72 6f 76 69 64 65 20 61 64 , but provide ad
1cb0: 64 69 74 69 6f 6e 61 6c 20 6f 70 74 69 6f 6e 73 ditional options
1cc0: 20 66 6f 72 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 for controlling
1cd0: 0a 74 68 65 20 53 53 4c 2f 54 4c 53 20 73 65 73 .the SSL/TLS ses
1ce0: 73 69 6f 6e 5c 26 2e 0a 2e 53 48 20 43 4f 4d 50 sion\&...SH COMP
1cf0: 41 54 49 42 49 4c 49 54 59 0a 54 68 69 73 20 65 ATIBILITY.This e
1d00: 78 74 65 6e 73 69 6f 6e 20 69 73 20 63 6f 6d 70 xtension is comp
1d10: 61 74 69 62 6c 65 20 77 69 74 68 20 4f 70 65 6e atible with Open
1d20: 53 53 4c 20 31 5c 26 2e 31 5c 26 2e 31 20 6f 72 SSL 1\&.1\&.1 or
1d30: 20 6c 61 74 65 72 5c 26 2e 20 49 74 20 72 65 71 later\&. It req
1d40: 75 69 72 65 73 20 54 63 6c 0a 76 65 72 73 69 6f uires Tcl.versio
1d50: 6e 20 38 5c 26 2e 35 20 6f 72 20 6c 61 74 65 72 n 8\&.5 or later
1d60: 20 61 6e 64 20 77 69 6c 6c 20 77 6f 72 6b 20 77 and will work w
1d70: 69 74 68 20 54 63 6c 20 39 5c 26 2e 30 5c 26 2e ith Tcl 9\&.0\&.
1d80: 0a 2e 53 48 20 43 4f 4d 4d 41 4e 44 53 0a 54 68 ..SH COMMANDS.Th
1d90: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
1da0: 74 68 65 20 63 6f 6d 6d 61 6e 64 73 20 70 72 6f the commands pro
1db0: 76 69 64 65 64 20 62 79 20 74 68 65 20 54 63 4c vided by the TcL
1dc0: 54 4c 53 20 70 61 63 6b 61 67 65 5c 26 2e 20 53 TLS package\&. S
1dd0: 65 65 20 74 68 65 0a 5c 66 42 45 78 61 6d 70 6c ee the.\fBExampl
1de0: 65 73 5c 66 52 20 66 6f 72 20 65 78 61 6d 70 6c es\fR for exampl
1df0: 65 20 75 73 61 67 65 20 61 6e 64 20 74 68 65 20 e usage and the
1e00: 22 5c 66 49 64 65 6d 6f 73 5c 66 52 22 20 64 69 "\fIdemos\fR" di
1e10: 72 65 63 74 6f 72 79 20 66 6f 72 0a 6d 6f 72 65 rectory for.more
1e20: 20 65 78 61 6d 70 6c 65 20 75 73 61 67 65 5c 26 example usage\&
1e30: 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a 69 6e ...TP.\fBtls::in
1e40: 69 74 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 69 6f it\fR ?\fI-optio
1e50: 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 65 5c n\fR? ?\fIvalue\
1e60: 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 fR? ?\fI-option
1e70: 76 61 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c value \&.\&.\&.\
1e80: 66 52 3f 0a 4f 70 74 69 6f 6e 61 6c 20 66 75 6e fR?.Optional fun
1e90: 63 74 69 6f 6e 20 74 6f 20 73 65 74 20 74 68 65 ction to set the
1ea0: 20 64 65 66 61 75 6c 74 20 6f 70 74 69 6f 6e 73 default options
1eb0: 20 75 73 65 64 20 62 79 20 5c 66 42 74 6c 73 3a used by \fBtls:
1ec0: 3a 73 6f 63 6b 65 74 5c 66 52 5c 26 2e 20 49 66 :socket\fR\&. If
1ed0: 20 79 6f 75 0a 63 61 6c 6c 20 5c 66 42 74 6c 73 you.call \fBtls
1ee0: 3a 3a 69 6d 70 6f 72 74 5c 66 52 20 64 69 72 65 ::import\fR dire
1ef0: 63 74 6c 79 2c 20 74 68 65 20 76 61 6c 75 65 73 ctly, the values
1f00: 20 73 65 74 20 62 79 20 74 68 69 73 20 63 6f 6d set by this com
1f10: 6d 61 6e 64 20 68 61 76 65 20 6e 6f 20 65 66 66 mand have no eff
1f20: 65 63 74 5c 26 2e 0a 54 68 69 73 20 63 6f 6d 6d ect\&..This comm
1f30: 61 6e 64 20 73 75 70 70 6f 72 74 73 20 61 6c 6c and supports all
1f40: 20 6f 66 20 74 68 65 20 73 61 6d 65 20 6f 70 74 of the same opt
1f50: 69 6f 6e 73 20 61 73 20 74 68 65 20 5c 66 42 74 ions as the \fBt
1f60: 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 52 20 63 6f ls::socket\fR co
1f70: 6d 6d 61 6e 64 2c 0a 74 68 6f 75 67 68 20 79 6f mmand,.though yo
1f80: 75 20 73 68 6f 75 6c 64 20 6c 69 6d 69 74 20 79 u should limit y
1f90: 6f 75 72 20 6f 70 74 69 6f 6e 73 20 74 6f 20 6f our options to o
1fa0: 6e 6c 79 20 74 68 65 20 54 4c 53 20 72 65 6c 61 nly the TLS rela
1fb0: 74 65 64 20 6f 6e 65 73 5c 26 2e 0a 2e 54 50 0a ted ones\&...TP.
1fc0: 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b 65 74 5c 66 \fBtls::socket\f
1fd0: 52 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 R ?\fI-option\fR
1fe0: 3f 20 3f 5c 66 49 76 61 6c 75 65 5c 66 52 3f 20 ? ?\fIvalue\fR?
1ff0: 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 ?\fI-option valu
2000: 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 20 e \&.\&.\&.\fR?
2010: 5c 66 49 68 6f 73 74 5c 66 52 20 5c 66 49 70 6f \fIhost\fR \fIpo
2020: 72 74 5c 66 52 0a 54 68 69 73 20 69 73 20 61 20 rt\fR.This is a
2030: 68 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 helper function
2040: 74 68 61 74 20 75 74 69 6c 69 7a 65 73 20 74 68 that utilizes th
2050: 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 63 6f 6d e underlying com
2060: 6d 61 6e 64 73 20 5c 66 42 73 6f 63 6b 65 74 5c mands \fBsocket\
2070: 66 52 0a 61 6e 64 20 5c 66 42 74 6c 73 3a 3a 69 fR.and \fBtls::i
2080: 6d 70 6f 72 74 5c 66 52 20 74 6f 20 63 72 65 61 mport\fR to crea
2090: 74 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f te the connectio
20a0: 6e 5c 26 2e 20 49 74 20 62 65 68 61 76 65 73 20 n\&. It behaves
20b0: 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 0a the same as the.
20c0: 6e 61 74 69 76 65 20 54 43 4c 20 5c 66 42 73 6f native TCL \fBso
20d0: 63 6b 65 74 5c 66 52 20 63 6f 6d 6d 61 6e 64 2c cket\fR command,
20e0: 20 62 75 74 20 61 6c 73 6f 20 73 75 70 70 6f 72 but also suppor
20f0: 74 73 20 74 68 65 20 5c 66 42 74 6c 73 3a 3a 69 ts the \fBtls::i
2100: 6d 70 6f 72 74 5c 66 52 0a 63 6f 6d 6d 61 6e 64 mport\fR.command
2110: 20 6f 70 74 69 6f 6e 73 20 77 69 74 68 20 6f 6e options with on
2120: 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 6f 70 74 e additional opt
2130: 69 6f 6e 5c 26 2e 20 49 74 20 72 65 74 75 72 6e ion\&. It return
2140: 73 20 74 68 65 20 63 68 61 6e 6e 65 6c 20 68 61 s the channel ha
2150: 6e 64 6c 65 20 69 64 0a 66 6f 72 20 74 68 65 20 ndle id.for the
2160: 6e 65 77 20 73 6f 63 6b 65 74 5c 26 2e 0a 2e 52 new socket\&...R
2170: 53 0a 2e 54 50 0a 5c 66 42 2d 61 75 74 6f 73 65 S..TP.\fB-autose
2180: 72 76 65 72 6e 61 6d 65 5c 66 52 20 5c 66 49 62 rvername\fR \fIb
2190: 6f 6f 6c 5c 66 52 0a 49 66 20 5c 66 42 74 72 75 ool\fR.If \fBtru
21a0: 65 5c 66 52 2c 20 61 75 74 6f 6d 61 74 69 63 61 e\fR, automatica
21b0: 6c 6c 79 20 73 65 74 20 74 68 65 20 5c 66 42 2d lly set the \fB-
21c0: 73 65 72 76 65 72 6e 61 6d 65 5c 66 52 20 61 72 servername\fR ar
21d0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 0a 5c 66 gument to the.\f
21e0: 49 68 6f 73 74 5c 66 52 20 61 72 67 75 6d 65 6e Ihost\fR argumen
21f0: 74 5c 26 2e 20 50 72 69 6f 72 20 74 6f 20 54 63 t\&. Prior to Tc
2200: 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 74 68 65 20 lTLS 2\&.0, the
2210: 64 65 66 61 75 6c 74 20 69 73 20 5c 66 42 66 61 default is \fBfa
2220: 6c 73 65 5c 66 52 5c 26 2e 0a 53 74 61 72 74 69 lse\fR\&..Starti
2230: 6e 67 20 69 6e 20 54 63 6c 54 4c 53 20 32 5c 26 ng in TclTLS 2\&
2240: 2e 30 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 .0, the default
2250: 69 73 20 5c 66 42 74 72 75 65 5c 66 52 20 75 6e is \fBtrue\fR un
2260: 6c 65 73 73 20 5c 66 42 2d 73 65 72 76 65 72 6e less \fB-servern
2270: 61 6d 65 5c 66 52 0a 69 73 20 61 6c 73 6f 20 73 ame\fR.is also s
2280: 70 65 63 69 66 69 65 64 5c 26 2e 0a 2e 52 45 0a pecified\&...RE.
2290: 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b .TP.\fBtls::sock
22a0: 65 74 5c 66 52 20 5c 66 42 2d 73 65 72 76 65 72 et\fR \fB-server
22b0: 5c 66 52 20 5c 66 49 63 6f 6d 6d 61 6e 64 5c 66 \fR \fIcommand\f
22c0: 52 20 3f 5c 66 49 2d 6f 70 74 69 6f 6e 5c 66 52 R ?\fI-option\fR
22d0: 3f 20 3f 5c 66 49 76 61 6c 75 65 5c 66 52 3f 20 ? ?\fIvalue\fR?
22e0: 3f 5c 66 49 2d 6f 70 74 69 6f 6e 20 76 61 6c 75 ?\fI-option valu
22f0: 65 20 5c 26 2e 5c 26 2e 5c 26 2e 5c 66 52 3f 20 e \&.\&.\&.\fR?
2300: 5c 66 49 70 6f 72 74 5c 66 52 0a 53 61 6d 65 20 \fIport\fR.Same
2310: 61 73 20 70 72 65 76 69 6f 75 73 2c 20 62 75 74 as previous, but
2320: 20 69 6e 73 74 65 61 64 20 63 72 65 61 74 65 73 instead creates
2330: 20 61 20 73 65 72 76 65 72 20 73 6f 63 6b 65 74 a server socket
2340: 20 66 6f 72 20 63 6c 69 65 6e 74 73 20 74 6f 20 for clients to
2350: 63 6f 6e 6e 65 63 74 20 74 6f 0a 6a 75 73 74 20 connect to.just
2360: 6c 69 6b 65 20 74 68 65 20 54 63 6c 20 5c 66 42 like the Tcl \fB
2370: 73 6f 63 6b 65 74 20 2d 73 65 72 76 65 72 5c 66 socket -server\f
2380: 52 20 63 6f 6d 6d 61 6e 64 5c 26 2e 20 49 74 20 R command\&. It
2390: 72 65 74 75 72 6e 73 20 74 68 65 20 63 68 61 6e returns the chan
23a0: 6e 65 6c 0a 68 61 6e 64 6c 65 20 69 64 20 66 6f nel.handle id fo
23b0: 72 20 74 68 65 20 6e 65 77 20 73 6f 63 6b 65 74 r the new socket
23c0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a \&...TP.\fBtls::
23d0: 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 63 68 61 import\fR \fIcha
23e0: 6e 6e 65 6c 5c 66 52 20 3f 5c 66 49 2d 6f 70 74 nnel\fR ?\fI-opt
23f0: 69 6f 6e 5c 66 52 3f 20 3f 5c 66 49 76 61 6c 75 ion\fR? ?\fIvalu
2400: 65 5c 66 52 3f 20 3f 5c 66 49 2d 6f 70 74 69 6f e\fR? ?\fI-optio
2410: 6e 20 76 61 6c 75 65 20 5c 26 2e 5c 26 2e 5c 26 n value \&.\&.\&
2420: 2e 5c 66 52 3f 0a 53 74 61 72 74 20 54 4c 53 20 .\fR?.Start TLS
2430: 65 6e 63 72 79 70 74 69 6f 6e 20 6f 6e 20 54 43 encryption on TC
2440: 4c 20 63 68 61 6e 6e 65 6c 20 5c 66 49 63 68 61 L channel \fIcha
2450: 6e 6e 65 6c 5c 66 52 20 76 69 61 20 61 20 73 74 nnel\fR via a st
2460: 61 63 6b 65 64 20 63 68 61 6e 6e 65 6c 5c 26 2e acked channel\&.
2470: 20 49 74 0a 6e 65 65 64 20 6e 6f 74 20 62 65 20 It.need not be
2480: 61 20 73 6f 63 6b 65 74 2c 20 62 75 74 20 6d 75 a socket, but mu
2490: 73 74 20 70 72 6f 76 69 64 65 20 62 69 2d 64 69 st provide bi-di
24a0: 72 65 63 74 69 6f 6e 61 6c 20 66 6c 6f 77 5c 26 rectional flow\&
24b0: 2e 20 41 6c 73 6f 20 73 65 74 73 20 73 65 73 73 . Also sets sess
24c0: 69 6f 6e 0a 70 61 72 61 6d 65 74 65 72 73 20 66 ion.parameters f
24d0: 6f 72 20 53 53 4c 20 68 61 6e 64 73 68 61 6b 65 or SSL handshake
24e0: 5c 26 2e 20 56 61 6c 69 64 20 6f 70 74 69 6f 6e \&. Valid option
24f0: 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c s are:..RS..TP.\
2500: 66 42 2d 61 6c 70 6e 5c 66 52 20 5c 66 49 6c 69 fB-alpn\fR \fIli
2510: 73 74 5c 66 52 0a 4c 69 73 74 20 6f 66 20 70 72 st\fR.List of pr
2520: 6f 74 6f 63 6f 6c 73 20 74 6f 20 6f 66 66 65 72 otocols to offer
2530: 20 64 75 72 69 6e 67 20 41 70 70 6c 69 63 61 74 during Applicat
2540: 69 6f 6e 2d 4c 61 79 65 72 20 50 72 6f 74 6f 63 ion-Layer Protoc
2550: 6f 6c 20 4e 65 67 6f 74 69 61 74 69 6f 6e 0a 28 ol Negotiation.(
2560: 41 4c 50 4e 29 5c 26 2e 20 46 6f 72 20 65 78 61 ALPN)\&. For exa
2570: 6d 70 6c 65 3a 20 5c 66 42 68 32 5c 66 52 20 61 mple: \fBh2\fR a
2580: 6e 64 20 5c 66 42 68 74 74 70 2f 31 5c 26 2e 31 nd \fBhttp/1\&.1
2590: 5c 66 52 2c 20 62 75 74 20 6e 6f 74 20 5c 66 42 \fR, but not \fB
25a0: 68 33 5c 66 52 20 6f 72 0a 5c 66 42 71 75 69 63 h3\fR or.\fBquic
25b0: 5c 66 52 5c 26 2e 20 54 68 69 73 20 6f 70 74 69 \fR\&. This opti
25c0: 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 on is new for Tc
25d0: 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 lTLS 1\&.8\&...T
25e0: 50 0a 5c 66 42 2d 63 61 64 69 72 5c 66 52 20 5c P.\fB-cadir\fR \
25f0: 66 49 64 69 72 65 63 74 6f 72 79 5c 66 52 0a 53 fIdirectory\fR.S
2600: 70 65 63 69 66 69 65 73 20 74 68 65 20 64 69 72 pecifies the dir
2610: 65 63 74 6f 72 79 20 77 68 65 72 65 20 74 68 65 ectory where the
2620: 20 43 65 72 74 69 66 69 63 61 74 65 20 41 75 74 Certificate Aut
2630: 68 6f 72 69 74 79 20 28 43 41 29 20 63 65 72 74 hority (CA) cert
2640: 69 66 69 63 61 74 65 73 20 61 72 65 0a 73 74 6f ificates are.sto
2650: 72 65 64 5c 26 2e 20 54 68 65 20 64 65 66 61 75 red\&. The defau
2660: 6c 74 20 69 73 20 70 6c 61 74 66 6f 72 6d 20 73 lt is platform s
2670: 70 65 63 69 66 69 63 20 61 6e 64 20 63 61 6e 20 pecific and can
2680: 62 65 20 73 65 74 20 61 74 20 63 6f 6d 70 69 6c be set at compil
2690: 65 20 74 69 6d 65 5c 26 2e 20 54 68 65 0a 64 65 e time\&. The.de
26a0: 66 61 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 20 63 fault location c
26b0: 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e an be overridden
26c0: 20 62 79 20 74 68 65 20 5c 66 42 53 53 4c 5f 43 by the \fBSSL_C
26d0: 45 52 54 5f 44 49 52 5c 66 52 20 65 6e 76 69 72 ERT_DIR\fR envir
26e0: 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 62 6c 65 5c onment.variable\
26f0: 26 2e 20 53 65 65 20 5c 66 42 43 65 72 74 69 66 &. See \fBCertif
2700: 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 6f 6e icate Validation
2710: 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 \fR for more det
2720: 61 69 6c 73 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d ails\&...TP.\fB-
2730: 63 61 66 69 6c 65 5c 66 52 20 5c 66 49 66 69 6c cafile\fR \fIfil
2740: 65 6e 61 6d 65 5c 66 52 0a 53 70 65 63 69 66 69 ename\fR.Specifi
2750: 65 73 20 74 68 65 20 66 69 6c 65 20 77 69 74 68 es the file with
2760: 20 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 the Certificate
2770: 20 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 20 Authority (CA)
2780: 63 65 72 74 69 66 69 63 61 74 65 73 20 74 6f 20 certificates to
2790: 75 73 65 20 69 6e 0a 5c 66 42 50 45 4d 5c 66 52 use in.\fBPEM\fR
27a0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 5c 26 2e 20 file format\&.
27b0: 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 22 The default is "
27c0: 5c 66 49 63 65 72 74 5c 26 2e 70 65 6d 5c 66 52 \fIcert\&.pem\fR
27d0: 22 2c 20 69 6e 20 74 68 65 20 4f 70 65 6e 53 53 ", in the OpenSS
27e0: 4c 0a 64 69 72 65 63 74 6f 72 79 5c 26 2e 20 54 L.directory\&. T
27f0: 68 65 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 he default file
2800: 63 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 can be overridde
2810: 6e 20 62 79 20 74 68 65 20 5c 66 42 53 53 4c 5f n by the \fBSSL_
2820: 43 45 52 54 5f 46 49 4c 45 5c 66 52 20 65 6e 76 CERT_FILE\fR env
2830: 69 72 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 62 6c ironment.variabl
2840: 65 5c 26 2e 20 53 65 65 20 5c 66 42 43 65 72 74 e\&. See \fBCert
2850: 69 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 ificate Validati
2860: 6f 6e 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 64 on\fR for more d
2870: 65 74 61 69 6c 73 5c 26 2e 0a 2e 54 50 0a 5c 66 etails\&...TP.\f
2880: 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 5c 66 49 B-castore\fR \fI
2890: 55 52 49 5c 66 52 0a 53 70 65 63 69 66 69 65 73 URI\fR.Specifies
28a0: 20 74 68 65 20 55 6e 69 66 6f 72 6d 20 52 65 73 the Uniform Res
28b0: 6f 75 72 63 65 20 49 64 65 6e 74 69 66 69 65 72 ource Identifier
28c0: 20 28 55 52 49 29 20 66 6f 72 20 74 68 65 20 43 (URI) for the C
28d0: 65 72 74 69 66 69 63 61 74 65 20 41 75 74 68 6f ertificate Autho
28e0: 72 69 74 79 0a 28 43 41 29 20 73 74 6f 72 65 2c rity.(CA) store,
28f0: 20 77 68 69 63 68 20 6d 61 79 20 62 65 20 61 20 which may be a
2900: 73 69 6e 67 6c 65 20 63 6f 6e 74 61 69 6e 65 72 single container
2910: 20 6f 72 20 61 20 63 61 74 61 6c 6f 67 20 6f 66 or a catalog of
2920: 20 63 6f 6e 74 61 69 6e 65 72 73 5c 26 2e 0a 53 containers\&..S
2930: 74 61 72 74 69 6e 67 20 77 69 74 68 20 4f 70 65 tarting with Ope
2940: 6e 53 53 4c 20 33 5c 26 2e 32 20 6f 6e 20 4d 53 nSSL 3\&.2 on MS
2950: 20 57 69 6e 64 6f 77 73 2c 20 73 65 74 20 74 6f Windows, set to
2960: 20 22 5c 66 42 6f 72 67 5c 26 2e 6f 70 65 6e 73 "\fBorg\&.opens
2970: 73 6c 5c 26 2e 77 69 6e 73 74 6f 72 65 3a 2f 2f sl\&.winstore://
2980: 5c 66 52 22 0a 74 6f 20 75 73 65 20 74 68 65 20 \fR".to use the
2990: 62 75 69 6c 74 2d 69 6e 20 4d 53 20 57 69 6e 64 built-in MS Wind
29a0: 6f 77 73 20 43 65 72 74 69 66 69 63 61 74 65 20 ows Certificate
29b0: 53 74 6f 72 65 5c 26 2e 0a 53 65 65 20 5c 66 42 Store\&..See \fB
29c0: 43 65 72 74 69 66 69 63 61 74 65 20 56 61 6c 69 Certificate Vali
29d0: 64 61 74 69 6f 6e 5c 66 52 20 66 6f 72 20 6d 6f dation\fR for mo
29e0: 72 65 20 64 65 74 61 69 6c 73 5c 26 2e 0a 54 68 re details\&..Th
29f0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 is option is new
2a00: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
2a10: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 65 72 8\&...TP.\fB-cer
2a20: 74 66 69 6c 65 5c 66 52 20 5c 66 49 66 69 6c 65 tfile\fR \fIfile
2a30: 6e 61 6d 65 5c 66 52 0a 53 70 65 63 69 66 69 65 name\fR.Specifie
2a40: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th
2a50: 65 20 66 69 6c 65 20 77 69 74 68 20 74 68 65 20 e file with the
2a60: 63 65 72 74 69 66 69 63 61 74 65 20 74 6f 20 75 certificate to u
2a70: 73 65 20 69 6e 20 50 45 4d 20 66 6f 72 6d 61 74 se in PEM format
2a80: 0a 61 73 20 74 68 65 20 6c 6f 63 61 6c 20 28 63 .as the local (c
2a90: 6c 69 65 6e 74 20 6f 72 20 73 65 72 76 65 72 29 lient or server)
2aa0: 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 2e 20 certificate\&.
2ab0: 49 74 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 It also contains
2ac0: 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 79 5c the public key\
2ad0: 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 65 72 74 5c &...TP.\fB-cert\
2ae0: 66 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a fR \fIstring\fR.
2af0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 63 65 Specifies the ce
2b00: 72 74 69 66 69 63 61 74 65 20 74 6f 20 75 73 65 rtificate to use
2b10: 20 61 73 20 61 20 44 45 52 20 65 6e 63 6f 64 65 as a DER encode
2b20: 64 20 73 74 72 69 6e 67 20 28 58 5c 26 2e 35 30 d string (X\&.50
2b30: 39 20 44 45 52 29 5c 26 2e 0a 2e 54 50 0a 5c 66 9 DER)\&...TP.\f
2b40: 42 2d 63 69 70 68 65 72 5c 66 52 20 5c 66 49 73 B-cipher\fR \fIs
2b50: 74 72 69 6e 67 5c 66 52 0a 53 70 65 63 69 66 69 tring\fR.Specifi
2b60: 65 73 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63 es the list of c
2b70: 69 70 68 65 72 73 20 74 6f 20 75 73 65 20 66 6f iphers to use fo
2b80: 72 20 54 4c 53 20 31 5c 26 2e 32 20 61 6e 64 20 r TLS 1\&.2 and
2b90: 65 61 72 6c 69 65 72 20 63 6f 6e 6e 65 63 74 69 earlier connecti
2ba0: 6f 6e 73 5c 26 2e 0a 53 74 72 69 6e 67 20 69 73 ons\&..String is
2bb0: 20 61 20 63 6f 6c 6f 6e 20 22 5c 66 42 3a 5c 66 a colon "\fB:\f
2bc0: 52 22 20 73 65 70 61 72 61 74 65 64 20 6c 69 73 R" separated lis
2bd0: 74 20 6f 66 20 63 69 70 68 65 72 73 5c 26 2e 0a t of ciphers\&..
2be0: 43 69 70 68 65 72 73 20 63 61 6e 20 62 65 20 63 Ciphers can be c
2bf0: 6f 6d 62 69 6e 65 64 20 75 73 69 6e 67 20 74 68 ombined using th
2c00: 65 20 22 5c 66 42 2b 5c 66 52 22 20 63 68 61 72 e "\fB+\fR" char
2c10: 61 63 74 65 72 5c 26 2e 0a 50 72 65 66 69 78 65 acter\&..Prefixe
2c20: 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f s can be used to
2c30: 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 72 65 6d permanently rem
2c40: 6f 76 65 20 22 5c 66 42 21 5c 66 52 22 2c 20 64 ove "\fB!\fR", d
2c50: 65 6c 65 74 65 20 22 5c 66 42 2d 5c 66 52 22 2c elete "\fB-\fR",
2c60: 20 6f 72 0a 6d 6f 76 65 20 74 6f 20 74 68 65 20 or.move to the
2c70: 65 6e 64 20 22 5c 66 42 2b 5c 66 52 22 20 61 20 end "\fB+\fR" a
2c80: 73 70 65 63 69 66 69 65 64 20 63 69 70 68 65 72 specified cipher
2c90: 5c 26 2e 0a 4b 65 79 77 6f 72 64 73 20 5c 66 42 \&..Keywords \fB
2ca0: 40 53 54 52 45 4e 47 54 48 5c 66 52 20 28 73 6f @STRENGTH\fR (so
2cb0: 72 74 20 62 79 20 61 6c 67 6f 72 69 74 68 6d 20 rt by algorithm
2cc0: 6b 65 79 20 6c 65 6e 67 74 68 29 2c 0a 5c 66 42 key length),.\fB
2cd0: 40 53 45 43 4c 45 56 45 4c 3d 5c 66 52 5c 66 49 @SECLEVEL=\fR\fI
2ce0: 6e 5c 66 52 20 28 73 65 74 20 73 65 63 75 72 69 n\fR (set securi
2cf0: 74 79 20 6c 65 76 65 6c 20 74 6f 20 6e 29 2c 20 ty level to n),
2d00: 61 6e 64 0a 5c 66 42 44 45 46 41 55 4c 54 5c 66 and.\fBDEFAULT\f
2d10: 52 20 28 75 73 65 20 64 65 66 61 75 6c 74 20 63 R (use default c
2d20: 69 70 68 65 72 20 6c 69 73 74 2c 20 61 74 20 73 ipher list, at s
2d30: 74 61 72 74 20 6f 6e 6c 79 29 20 63 61 6e 20 61 tart only) can a
2d40: 6c 73 6f 20 62 65 20 73 70 65 63 69 66 69 65 64 lso be specified
2d50: 5c 26 2e 0a 53 65 65 20 74 68 65 20 5c 66 49 4f \&..See the \fIO
2d60: 70 65 6e 53 53 4c 5c 66 52 20 5b 68 74 74 70 73 penSSL\fR [https
2d70: 3a 2f 2f 64 6f 63 73 5c 26 2e 6f 70 65 6e 73 73 ://docs\&.openss
2d80: 6c 5c 26 2e 6f 72 67 2f 6d 61 73 74 65 72 2f 6d l\&.org/master/m
2d90: 61 6e 31 2f 6f 70 65 6e 73 73 6c 2d 63 69 70 68 an1/openssl-ciph
2da0: 65 72 73 2f 23 6f 70 74 69 6f 6e 73 5d 0a 64 6f ers/#options].do
2db0: 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 cumentation for
2dc0: 74 68 65 20 66 75 6c 6c 20 6c 69 73 74 20 6f 66 the full list of
2dd0: 20 76 61 6c 69 64 20 76 61 6c 75 65 73 5c 26 2e valid values\&.
2de0: 0a 2e 54 50 0a 5c 66 42 2d 63 69 70 68 65 72 73 ..TP.\fB-ciphers
2df0: 75 69 74 65 73 5c 66 52 20 5c 66 49 73 74 72 69 uites\fR \fIstri
2e00: 6e 67 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 ng\fR.Specifies
2e10: 74 68 65 20 6c 69 73 74 20 6f 66 20 63 69 70 68 the list of ciph
2e20: 65 72 20 73 75 69 74 65 73 20 74 6f 20 75 73 65 er suites to use
2e30: 20 66 6f 72 20 54 4c 53 20 31 5c 26 2e 33 20 61 for TLS 1\&.3 a
2e40: 73 20 61 20 63 6f 6c 6f 6e 0a 22 5c 66 42 3a 5c s a colon."\fB:\
2e50: 66 52 22 20 73 65 70 61 72 61 74 65 64 20 6c 69 fR" separated li
2e60: 73 74 20 6f 66 20 63 69 70 68 65 72 20 73 75 69 st of cipher sui
2e70: 74 65 20 6e 61 6d 65 73 5c 26 2e 20 53 65 65 20 te names\&. See
2e80: 74 68 65 0a 5c 66 49 4f 70 65 6e 53 53 4c 5c 66 the.\fIOpenSSL\f
2e90: 52 20 5b 68 74 74 70 73 3a 2f 2f 64 6f 63 73 5c R [https://docs\
2ea0: 26 2e 6f 70 65 6e 73 73 6c 5c 26 2e 6f 72 67 2f &.openssl\&.org/
2eb0: 6d 61 73 74 65 72 2f 6d 61 6e 31 2f 6f 70 65 6e master/man1/open
2ec0: 73 73 6c 2d 63 69 70 68 65 72 73 2f 23 6f 70 74 ssl-ciphers/#opt
2ed0: 69 6f 6e 73 5d 0a 64 6f 63 75 6d 65 6e 74 61 74 ions].documentat
2ee0: 69 6f 6e 20 66 6f 72 20 74 68 65 20 66 75 6c 6c ion for the full
2ef0: 20 6c 69 73 74 20 6f 66 20 76 61 6c 69 64 20 76 list of valid v
2f00: 61 6c 75 65 73 5c 26 2e 0a 54 68 69 73 20 6f 70 alues\&..This op
2f10: 74 69 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 tion is new for
2f20: 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a TclTLS 1\&.8\&..
2f30: 2e 54 50 0a 5c 66 42 2d 63 6f 6d 6d 61 6e 64 5c .TP.\fB-command\
2f40: 66 52 20 5c 66 49 63 61 6c 6c 62 61 63 6b 5c 66 fR \fIcallback\f
2f50: 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 R.Specifies the
2f60: 63 61 6c 6c 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 callback command
2f70: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 61 to be invoked a
2f80: 74 20 73 65 76 65 72 61 6c 20 70 6f 69 6e 74 73 t several points
2f90: 20 64 75 72 69 6e 67 20 74 68 65 0a 68 61 6e 64 during the.hand
2fa0: 73 68 61 6b 65 20 74 6f 20 70 61 73 73 20 65 72 shake to pass er
2fb0: 72 6f 72 73 2c 20 74 72 61 63 69 6e 67 20 69 6e rors, tracing in
2fc0: 66 6f 72 6d 61 74 69 6f 6e 2c 20 61 6e 64 20 70 formation, and p
2fd0: 72 6f 74 6f 63 6f 6c 20 6d 65 73 73 61 67 65 73 rotocol messages
2fe0: 5c 26 2e 0a 53 65 65 20 5c 66 42 43 61 6c 6c 62 \&..See \fBCallb
2ff0: 61 63 6b 20 4f 70 74 69 6f 6e 73 5c 66 52 20 66 ack Options\fR f
3000: 6f 72 20 6d 6f 72 65 20 69 6e 66 6f 5c 26 2e 0a or more info\&..
3010: 2e 54 50 0a 5c 66 42 2d 64 68 70 61 72 61 6d 73 .TP.\fB-dhparams
3020: 5c 66 52 20 5c 66 49 66 69 6c 65 6e 61 6d 65 5c \fR \fIfilename\
3030: 66 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 fR.Specifies the
3040: 20 44 69 66 66 69 65 2d 48 65 6c 6c 6d 61 6e 20 Diffie-Hellman
3050: 28 44 48 29 20 70 61 72 61 6d 65 74 65 72 73 20 (DH) parameters
3060: 66 69 6c 65 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d file\&...TP.\fB-
3070: 6b 65 79 66 69 6c 65 5c 66 52 20 5c 66 49 66 69 keyfile\fR \fIfi
3080: 6c 65 6e 61 6d 65 5c 66 52 0a 53 70 65 63 69 66 lename\fR.Specif
3090: 69 65 73 20 74 68 65 20 70 72 69 76 61 74 65 20 ies the private
30a0: 6b 65 79 20 66 69 6c 65 5c 26 2e 20 54 68 65 20 key file\&. The
30b0: 64 65 66 61 75 6c 74 20 69 73 20 74 6f 20 75 73 default is to us
30c0: 65 20 74 68 65 20 66 69 6c 65 0a 73 70 65 63 69 e the file.speci
30d0: 66 69 65 64 20 62 79 20 74 68 65 20 5c 66 42 2d fied by the \fB-
30e0: 63 65 72 74 66 69 6c 65 5c 66 52 20 6f 70 74 69 certfile\fR opti
30f0: 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 6b 65 on\&...TP.\fB-ke
3100: 79 5c 66 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 y\fR \fIstring\f
3110: 52 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 R.Specifies the
3120: 70 72 69 76 61 74 65 20 6b 65 79 20 74 6f 20 75 private key to u
3130: 73 65 20 61 73 20 61 20 44 45 52 20 65 6e 63 6f se as a DER enco
3140: 64 65 64 20 73 74 72 69 6e 67 20 28 50 4b 43 53 ded string (PKCS
3150: 23 31 20 44 45 52 29 5c 26 2e 0a 2e 54 50 0a 5c #1 DER)\&...TP.\
3160: 66 42 2d 6d 6f 64 65 6c 5c 66 52 20 5c 66 49 63 fB-model\fR \fIc
3170: 68 61 6e 6e 65 6c 5c 66 52 0a 46 6f 72 63 65 20 hannel\fR.Force
3180: 74 68 69 73 20 63 68 61 6e 6e 65 6c 20 74 6f 20 this channel to
3190: 73 68 61 72 65 20 74 68 65 20 73 61 6d 65 20 5c share the same \
31a0: 66 49 53 53 4c 5f 43 54 58 5c 66 52 20 73 74 72 fISSL_CTX\fR str
31b0: 75 63 74 75 72 65 20 61 73 20 74 68 65 0a 73 70 ucture as the.sp
31c0: 65 63 69 66 69 65 64 20 5c 66 49 63 68 61 6e 6e ecified \fIchann
31d0: 65 6c 5c 66 52 2c 20 61 6e 64 20 74 68 65 72 65 el\fR, and there
31e0: 66 6f 72 65 20 73 68 61 72 65 20 63 6f 6e 66 69 fore share confi
31f0: 67 2c 20 63 61 6c 6c 62 61 63 6b 73 2c 20 65 74 g, callbacks, et
3200: 63 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 70 61 73 c\&...TP.\fB-pas
3210: 73 77 6f 72 64 5c 66 52 20 5c 66 49 63 61 6c 6c sword\fR \fIcall
3220: 62 61 63 6b 5c 66 52 0a 53 70 65 63 69 66 69 65 back\fR.Specifie
3230: 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 63 s the callback c
3240: 6f 6d 6d 61 6e 64 20 74 6f 20 69 6e 76 6f 6b 65 ommand to invoke
3250: 20 77 68 65 6e 20 4f 70 65 6e 53 53 4c 20 6e 65 when OpenSSL ne
3260: 65 64 73 20 74 6f 20 6f 62 74 61 69 6e 20 61 0a eds to obtain a.
3270: 70 61 73 73 77 6f 72 64 5c 26 2e 20 54 68 69 73 password\&. This
3280: 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 75 73 is typically us
3290: 65 64 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 65 ed to unlock the
32a0: 20 70 72 69 76 61 74 65 20 6b 65 79 20 6f 66 20 private key of
32b0: 61 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 2e a certificate\&.
32c0: 0a 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 68 .The callback sh
32d0: 6f 75 6c 64 20 72 65 74 75 72 6e 20 61 20 70 61 ould return a pa
32e0: 73 73 77 6f 72 64 20 73 74 72 69 6e 67 5c 26 2e ssword string\&.
32f0: 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 68 61 73 This option has
3300: 20 63 68 61 6e 67 65 64 20 66 6f 72 0a 54 63 6c changed for.Tcl
3310: 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 20 53 65 65 TLS 1\&.8\&. See
3320: 20 5c 66 42 43 61 6c 6c 62 61 63 6b 20 4f 70 74 \fBCallback Opt
3330: 69 6f 6e 73 5c 66 52 20 66 6f 72 20 6d 6f 72 65 ions\fR for more
3340: 20 69 6e 66 6f 5c 26 2e 0a 2e 54 50 0a 5c 66 42 info\&...TP.\fB
3350: 2d 70 6f 73 74 5f 68 61 6e 64 73 68 61 6b 65 5c -post_handshake\
3360: 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 0a 41 6c fR \fIbool\fR.Al
3370: 6c 6f 77 20 70 6f 73 74 2d 68 61 6e 64 73 68 61 low post-handsha
3380: 6b 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 ke session ticke
3390: 74 20 75 70 64 61 74 65 73 5c 26 2e 20 54 68 69 t updates\&. Thi
33a0: 73 20 6f 70 74 69 6f 6e 20 69 73 20 6e 65 77 20 s option is new
33b0: 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 for TclTLS 1\&.8
33c0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 72 65 71 75 \&...TP.\fB-requ
33d0: 65 73 74 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 est\fR \fIbool\f
33e0: 52 0a 52 65 71 75 65 73 74 20 61 20 63 65 72 74 R.Request a cert
33f0: 69 66 69 63 61 74 65 20 66 72 6f 6d 20 74 68 65 ificate from the
3400: 20 70 65 65 72 20 64 75 72 69 6e 67 20 74 68 65 peer during the
3410: 20 53 53 4c 20 68 61 6e 64 73 68 61 6b 65 5c 26 SSL handshake\&
3420: 2e 20 54 68 69 73 20 69 73 20 6e 65 65 64 65 64 . This is needed
3430: 0a 74 6f 20 64 6f 20 43 65 72 74 69 66 69 63 61 .to do Certifica
3440: 74 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c 26 2e te Validation\&.
3450: 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c Starting in Tcl
3460: 54 4c 53 20 31 5c 26 2e 38 2c 20 74 68 65 20 64 TLS 1\&.8, the d
3470: 65 66 61 75 6c 74 20 69 73 0a 5c 66 42 74 72 75 efault is.\fBtru
3480: 65 5c 66 52 20 66 6f 72 20 63 6c 69 65 6e 74 20 e\fR for client
3490: 63 6f 6e 6e 65 63 74 69 6f 6e 73 5c 26 2e 20 53 connections\&. S
34a0: 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c 54 4c tarting in TclTL
34b0: 53 20 32 5c 26 2e 30 2c 20 69 66 20 73 65 74 20 S 2\&.0, if set
34c0: 74 6f 0a 5c 66 42 66 61 6c 73 65 5c 66 52 20 61 to.\fBfalse\fR a
34d0: 6e 64 20 5c 66 42 2d 72 65 71 75 69 72 65 5c 66 nd \fB-require\f
34e0: 52 20 69 73 20 5c 66 42 74 72 75 65 5c 66 52 2c R is \fBtrue\fR,
34f0: 20 74 68 65 6e 20 74 68 69 73 20 77 69 6c 6c 20 then this will
3500: 62 65 0a 6f 76 65 72 72 69 64 64 65 6e 20 74 6f be.overridden to
3510: 20 5c 66 42 74 72 75 65 5c 66 52 5c 26 2e 20 53 \fBtrue\fR\&. S
3520: 65 65 20 5c 66 42 43 65 72 74 69 66 69 63 61 74 ee \fBCertificat
3530: 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c 66 52 20 e Validation\fR
3540: 66 6f 72 0a 6d 6f 72 65 20 64 65 74 61 69 6c 73 for.more details
3550: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 72 65 71 75 \&...TP.\fB-requ
3560: 69 72 65 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 ire\fR \fIbool\f
3570: 52 0a 52 65 71 75 69 72 65 20 61 20 76 61 6c 69 R.Require a vali
3580: 64 20 63 65 72 74 69 66 69 63 61 74 65 20 66 72 d certificate fr
3590: 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 69 om the peer duri
35a0: 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 73 ng the SSL hands
35b0: 68 61 6b 65 5c 26 2e 20 49 66 20 74 68 69 73 20 hake\&. If this
35c0: 69 73 0a 73 65 74 20 74 6f 20 74 72 75 65 2c 20 is.set to true,
35d0: 74 68 65 6e 20 5c 66 42 2d 72 65 71 75 65 73 74 then \fB-request
35e0: 5c 66 52 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 \fR must also be
35f0: 20 73 65 74 20 74 6f 20 74 72 75 65 20 61 6e 64 set to true and
3600: 20 61 20 65 69 74 68 65 72 0a 5c 66 42 2d 63 61 a either.\fB-ca
3610: 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 61 66 69 dir\fR, \fB-cafi
3620: 6c 65 5c 66 52 2c 20 5c 66 42 2d 63 61 73 74 6f le\fR, \fB-casto
3630: 72 65 5c 66 52 2c 20 6f 72 20 61 20 70 6c 61 74 re\fR, or a plat
3640: 66 6f 72 6d 20 64 65 66 61 75 6c 74 0a 6d 75 73 form default.mus
3650: 74 20 62 65 20 70 72 6f 76 69 64 65 64 20 69 6e t be provided in
3660: 20 6f 72 64 65 72 20 74 6f 20 76 61 6c 69 64 61 order to valida
3670: 74 65 20 61 67 61 69 6e 73 74 5c 26 2e 20 54 68 te against\&. Th
3680: 65 20 64 65 66 61 75 6c 74 20 69 6e 20 54 63 6c e default in Tcl
3690: 54 4c 53 20 31 5c 26 2e 38 20 61 6e 64 0a 65 61 TLS 1\&.8 and.ea
36a0: 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 69 rlier versions i
36b0: 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 20 73 69 s \fBfalse\fR si
36c0: 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 70 6c 61 74 nce not all plat
36d0: 66 6f 72 6d 73 20 68 61 76 65 20 63 65 72 74 69 forms have certi
36e0: 66 69 63 61 74 65 73 20 74 6f 0a 76 61 6c 69 64 ficates to.valid
36f0: 61 74 65 20 61 67 61 69 6e 73 74 20 69 6e 20 61 ate against in a
3700: 20 66 6f 72 6d 20 63 6f 6d 70 61 74 69 62 6c 65 form compatible
3710: 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 5c 26 2e with OpenSSL\&.
3720: 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c Starting in Tcl
3730: 54 4c 53 20 32 5c 26 2e 30 2c 0a 74 68 65 20 64 TLS 2\&.0,.the d
3740: 65 66 61 75 6c 74 20 69 73 20 5c 66 42 74 72 75 efault is \fBtru
3750: 65 5c 66 52 20 66 6f 72 20 63 6c 69 65 6e 74 20 e\fR for client
3760: 63 6f 6e 6e 65 63 74 69 6f 6e 73 5c 26 2e 0a 53 connections\&..S
3770: 65 65 20 5c 66 42 43 65 72 74 69 66 69 63 61 74 ee \fBCertificat
3780: 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c 66 52 20 e Validation\fR
3790: 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 for more details
37a0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 73 65 63 75 \&...TP.\fB-secu
37b0: 72 69 74 79 5f 6c 65 76 65 6c 5c 66 52 20 5c 66 rity_level\fR \f
37c0: 49 69 6e 74 65 67 65 72 5c 66 52 0a 53 70 65 63 Iinteger\fR.Spec
37d0: 69 66 69 65 73 20 74 68 65 20 73 65 63 75 72 69 ifies the securi
37e0: 74 79 20 6c 65 76 65 6c 20 28 76 61 6c 75 65 20 ty level (value
37f0: 66 72 6f 6d 20 30 20 74 6f 20 35 29 5c 26 2e 20 from 0 to 5)\&.
3800: 54 68 65 20 73 65 63 75 72 69 74 79 20 6c 65 76 The security lev
3810: 65 6c 20 61 66 66 65 63 74 73 0a 74 68 65 20 61 el affects.the a
3820: 6c 6c 6f 77 65 64 20 63 69 70 68 65 72 20 73 75 llowed cipher su
3830: 69 74 65 20 65 6e 63 72 79 70 74 69 6f 6e 20 61 ite encryption a
3840: 6c 67 6f 72 69 74 68 6d 73 2c 20 73 75 70 70 6f lgorithms, suppo
3850: 72 74 65 64 20 45 43 43 20 63 75 72 76 65 73 2c rted ECC curves,
3860: 0a 73 75 70 70 6f 72 74 65 64 20 73 69 67 6e 61 .supported signa
3870: 74 75 72 65 20 61 6c 67 6f 72 69 74 68 6d 73 2c ture algorithms,
3880: 20 44 48 20 70 61 72 61 6d 65 74 65 72 20 73 69 DH parameter si
3890: 7a 65 73 2c 20 63 65 72 74 69 66 69 63 61 74 65 zes, certificate
38a0: 20 6b 65 79 20 73 69 7a 65 73 0a 61 6e 64 20 73 key sizes.and s
38b0: 69 67 6e 61 74 75 72 65 20 61 6c 67 6f 72 69 74 ignature algorit
38c0: 68 6d 73 5c 26 2e 20 54 68 65 20 64 65 66 61 75 hms\&. The defau
38d0: 6c 74 20 69 73 20 31 20 70 72 69 6f 72 20 74 6f lt is 1 prior to
38e0: 20 4f 70 65 6e 53 53 4c 20 33 5c 26 2e 32 20 61 OpenSSL 3\&.2 a
38f0: 6e 64 20 32 0a 74 68 65 72 65 61 66 74 65 72 5c nd 2.thereafter\
3900: 26 2e 20 4c 65 76 65 6c 20 33 20 61 6e 64 20 68 &. Level 3 and h
3910: 69 67 68 65 72 20 64 69 73 61 62 6c 65 20 73 75 igher disable su
3920: 70 70 6f 72 74 20 66 6f 72 20 73 65 73 73 69 6f pport for sessio
3930: 6e 20 74 69 63 6b 65 74 73 20 61 6e 64 0a 6f 6e n tickets and.on
3940: 6c 79 20 61 63 63 65 70 74 20 63 69 70 68 65 72 ly accept cipher
3950: 20 73 75 69 74 65 73 20 74 68 61 74 20 70 72 6f suites that pro
3960: 76 69 64 65 20 66 6f 72 77 61 72 64 20 73 65 63 vide forward sec
3970: 72 65 63 79 5c 26 2e 0a 54 68 69 73 20 6f 70 74 recy\&..This opt
3980: 69 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 54 ion is new for T
3990: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
39a0: 54 50 0a 5c 66 42 2d 73 65 72 76 65 72 5c 66 52 TP.\fB-server\fR
39b0: 20 5c 66 49 62 6f 6f 6c 5c 66 52 0a 53 70 65 63 \fIbool\fR.Spec
39c0: 69 66 69 65 73 20 77 68 65 74 68 65 72 20 74 6f ifies whether to
39d0: 20 61 63 74 20 61 73 20 61 20 73 65 72 76 65 72 act as a server
39e0: 20 61 6e 64 20 72 65 73 70 6f 6e 64 20 77 69 74 and respond wit
39f0: 68 20 61 20 73 65 72 76 65 72 20 68 61 6e 64 73 h a server hands
3a00: 68 61 6b 65 20 77 68 65 6e 20 61 0a 63 6c 69 65 hake when a.clie
3a10: 6e 74 20 63 6f 6e 6e 65 63 74 73 20 61 6e 64 20 nt connects and
3a20: 70 72 6f 76 69 64 65 73 20 61 20 63 6c 69 65 6e provides a clien
3a30: 74 20 68 61 6e 64 73 68 61 6b 65 5c 26 2e 20 54 t handshake\&. T
3a40: 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c 66 he default is \f
3a50: 42 66 61 6c 73 65 5c 66 52 5c 26 2e 0a 2e 54 50 Bfalse\fR\&...TP
3a60: 0a 5c 66 42 2d 73 65 72 76 65 72 6e 61 6d 65 5c .\fB-servername\
3a70: 66 52 20 5c 66 49 68 6f 73 74 6e 61 6d 65 5c 66 fR \fIhostname\f
3a80: 52 0a 53 70 65 63 69 66 79 20 74 68 65 20 70 65 R.Specify the pe
3a90: 65 72 27 73 20 68 6f 73 74 6e 61 6d 65 5c 26 2e er's hostname\&.
3aa0: 20 54 68 69 73 20 69 73 20 75 73 65 64 20 74 6f This is used to
3ab0: 20 73 65 74 20 74 68 65 20 54 4c 53 20 53 65 72 set the TLS Ser
3ac0: 76 65 72 20 4e 61 6d 65 20 49 6e 64 69 63 61 74 ver Name Indicat
3ad0: 69 6f 6e 0a 28 53 4e 49 29 20 65 78 74 65 6e 73 ion.(SNI) extens
3ae0: 69 6f 6e 5c 26 2e 20 53 65 74 20 74 68 69 73 20 ion\&. Set this
3af0: 74 6f 20 74 68 65 20 65 78 70 65 63 74 65 64 20 to the expected
3b00: 73 65 72 76 65 72 6e 61 6d 65 20 69 6e 20 74 68 servername in th
3b10: 65 20 73 65 72 76 65 72 27 73 20 63 65 72 74 69 e server's certi
3b20: 66 69 63 61 74 65 0a 6f 72 20 6f 6e 65 20 6f 66 ficate.or one of
3b30: 20 74 68 65 20 53 75 62 6a 65 63 74 20 41 6c 74 the Subject Alt
3b40: 65 72 6e 61 74 65 20 4e 61 6d 65 73 20 28 53 41 ernate Names (SA
3b50: 4e 29 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 69 N)\&. Starting i
3b60: 6e 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 n TclTLS 2\&.0,
3b70: 74 68 69 73 20 77 69 6c 6c 0a 64 65 66 61 75 6c this will.defaul
3b80: 74 20 74 6f 20 74 68 65 20 68 6f 73 74 20 66 6f t to the host fo
3b90: 72 20 74 68 65 20 5c 66 42 74 6c 73 3a 3a 73 6f r the \fBtls::so
3ba0: 63 6b 65 74 5c 66 52 20 63 6f 6d 6d 61 6e 64 5c cket\fR command\
3bb0: 26 2e 0a 2e 54 50 0a 5c 66 42 2d 73 65 73 73 69 &...TP.\fB-sessi
3bc0: 6f 6e 5f 69 64 5c 66 52 20 5c 66 49 62 69 6e 61 on_id\fR \fIbina
3bd0: 72 79 5f 73 74 72 69 6e 67 5c 66 52 0a 53 70 65 ry_string\fR.Spe
3be0: 63 69 66 69 65 73 20 74 68 65 20 73 65 73 73 69 cifies the sessi
3bf0: 6f 6e 20 69 64 20 74 6f 20 72 65 73 75 6d 65 20 on id to resume
3c00: 61 20 73 65 73 73 69 6f 6e 5c 26 2e 20 4e 6f 74 a session\&. Not
3c10: 20 73 75 70 70 6f 72 74 65 64 20 79 65 74 5c 26 supported yet\&
3c20: 2e 0a 54 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 ..This option is
3c30: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
3c40: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
3c50: 2d 73 73 6c 32 5c 66 52 20 5c 66 49 62 6f 6f 6c -ssl2\fR \fIbool
3c60: 5c 66 52 0a 45 6e 61 62 6c 65 20 75 73 65 20 6f \fR.Enable use o
3c70: 66 20 53 53 4c 20 76 32 5c 26 2e 54 68 65 20 64 f SSL v2\&.The d
3c80: 65 66 61 75 6c 74 20 69 73 20 5c 66 42 66 61 6c efault is \fBfal
3c90: 73 65 5c 66 52 5c 26 2e 0a 4f 70 65 6e 53 53 4c se\fR\&..OpenSSL
3ca0: 20 31 5c 26 2e 31 2b 20 6e 6f 20 6c 6f 6e 67 65 1\&.1+ no longe
3cb0: 72 20 73 75 70 70 6f 72 74 73 20 53 53 4c 20 76 r supports SSL v
3cc0: 32 2c 20 73 6f 20 74 68 69 73 20 6d 61 79 20 6e 2, so this may n
3cd0: 6f 74 20 68 61 76 65 20 61 6e 79 20 65 66 66 65 ot have any effe
3ce0: 63 74 5c 26 2e 0a 53 65 65 20 74 68 65 20 5c 66 ct\&..See the \f
3cf0: 42 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c Btls::protocols\
3d00: 66 52 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 73 fR command for s
3d10: 75 70 70 6f 72 74 65 64 20 70 72 6f 74 6f 63 6f upported protoco
3d20: 6c 73 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 73 73 ls\&...TP.\fB-ss
3d30: 6c 33 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 l3\fR \fIbool\fR
3d40: 0a 45 6e 61 62 6c 65 20 75 73 65 20 6f 66 20 53 .Enable use of S
3d50: 53 4c 20 76 33 5c 26 2e 20 54 68 65 20 64 65 66 SL v3\&. The def
3d60: 61 75 6c 74 20 69 73 20 5c 66 42 66 61 6c 73 65 ault is \fBfalse
3d70: 5c 66 52 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 \fR\&. Starting
3d80: 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 2c in TclTLS 1\&.8,
3d90: 0a 75 73 65 20 6f 66 20 53 53 4c 20 76 33 20 69 .use of SSL v3 i
3da0: 66 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62 6c 65 f only available
3db0: 20 76 69 61 20 61 20 63 6f 6d 70 69 6c 65 20 74 via a compile t
3dc0: 69 6d 65 20 6f 70 74 69 6f 6e 5c 26 2e 0a 53 65 ime option\&..Se
3dd0: 65 20 74 68 65 20 5c 66 42 74 6c 73 3a 3a 70 72 e the \fBtls::pr
3de0: 6f 74 6f 63 6f 6c 73 5c 66 52 20 63 6f 6d 6d 61 otocols\fR comma
3df0: 6e 64 20 66 6f 72 20 73 75 70 70 6f 72 74 65 64 nd for supported
3e00: 20 70 72 6f 74 6f 63 6f 6c 73 5c 26 2e 0a 2e 54 protocols\&...T
3e10: 50 0a 5c 66 42 2d 74 6c 73 31 5c 66 52 20 5c 66 P.\fB-tls1\fR \f
3e20: 49 62 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c 65 20 Ibool\fR.Enable
3e30: 75 73 65 20 6f 66 20 54 4c 53 20 76 31 5c 26 2e use of TLS v1\&.
3e40: 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 6c Starting in Tcl
3e50: 54 4c 53 20 32 5c 26 2e 30 2c 20 74 68 65 20 64 TLS 2\&.0, the d
3e60: 65 66 61 75 6c 74 20 69 73 20 5c 66 42 66 61 6c efault is \fBfal
3e70: 73 65 5c 66 52 5c 26 2e 0a 4e 6f 74 65 3a 20 54 se\fR\&..Note: T
3e80: 4c 53 20 31 5c 26 2e 30 20 6e 65 65 64 73 20 53 LS 1\&.0 needs S
3e90: 48 41 31 20 74 6f 20 6f 70 65 72 61 74 65 2c 20 HA1 to operate,
3ea0: 77 68 69 63 68 20 69 73 20 6f 6e 6c 79 20 61 76 which is only av
3eb0: 61 69 6c 61 62 6c 65 20 69 6e 20 73 65 63 75 72 ailable in secur
3ec0: 69 74 79 20 6c 65 76 65 6c 0a 30 20 66 6f 72 20 ity level.0 for
3ed0: 4f 70 65 6e 20 53 53 4c 20 33 5c 26 2e 30 2b 5c Open SSL 3\&.0+\
3ee0: 26 2e 20 53 65 65 20 74 68 65 20 5c 66 42 2d 73 &. See the \fB-s
3ef0: 65 63 75 72 69 74 79 5f 6c 65 76 65 6c 5c 66 52 ecurity_level\fR
3f00: 20 6f 70 74 69 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c option\&...TP.\
3f10: 66 42 2d 74 6c 73 31 5c 26 2e 31 5c 66 52 20 5c fB-tls1\&.1\fR \
3f20: 66 49 62 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c 65 fIbool\fR.Enable
3f30: 20 75 73 65 20 6f 66 20 54 4c 53 20 76 31 5c 26 use of TLS v1\&
3f40: 2e 31 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 69 .1\&. Starting i
3f50: 6e 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 n TclTLS 2\&.0,
3f60: 74 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 5c the default is \
3f70: 66 42 66 61 6c 73 65 5c 66 52 5c 26 2e 0a 4e 6f fBfalse\fR\&..No
3f80: 74 65 3a 20 54 4c 53 20 31 5c 26 2e 31 20 6e 65 te: TLS 1\&.1 ne
3f90: 65 64 73 20 53 48 41 31 20 74 6f 20 6f 70 65 72 eds SHA1 to oper
3fa0: 61 74 65 2c 20 77 68 69 63 68 20 69 73 20 6f 6e ate, which is on
3fb0: 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 69 6e 20 ly available in
3fc0: 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 0a 30 security level.0
3fd0: 20 66 6f 72 20 4f 70 65 6e 20 53 53 4c 20 33 5c for Open SSL 3\
3fe0: 26 2e 30 2b 5c 26 2e 20 53 65 65 20 74 68 65 20 &.0+\&. See the
3ff0: 5c 66 42 2d 73 65 63 75 72 69 74 79 5f 6c 65 76 \fB-security_lev
4000: 65 6c 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e 0a el\fR option\&..
4010: 2e 54 50 0a 5c 66 42 2d 74 6c 73 31 5c 26 2e 32 .TP.\fB-tls1\&.2
4020: 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c 66 52 0a 45 \fR \fIbool\fR.E
4030: 6e 61 62 6c 65 20 75 73 65 20 6f 66 20 54 4c 53 nable use of TLS
4040: 20 76 31 5c 26 2e 32 5c 26 2e 20 54 68 65 20 64 v1\&.2\&. The d
4050: 65 66 61 75 6c 74 20 69 73 20 5c 66 42 74 72 75 efault is \fBtru
4060: 65 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d e\fR\&...TP.\fB-
4070: 74 6c 73 31 5c 26 2e 33 5c 66 52 20 5c 66 49 62 tls1\&.3\fR \fIb
4080: 6f 6f 6c 5c 66 52 0a 45 6e 61 62 6c 65 20 75 73 ool\fR.Enable us
4090: 65 20 6f 66 20 54 4c 53 20 76 31 5c 26 2e 33 5c e of TLS v1\&.3\
40a0: 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 &. The default i
40b0: 73 20 5c 66 42 74 72 75 65 5c 66 52 5c 26 2e 20 s \fBtrue\fR\&.
40c0: 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 61 76 61 This is only ava
40d0: 69 6c 61 62 6c 65 0a 73 74 61 72 74 69 6e 67 20 ilable.starting
40e0: 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 31 5c 26 with OpenSSL 1\&
40f0: 2e 31 5c 26 2e 31 20 61 6e 64 20 54 63 6c 54 4c .1\&.1 and TclTL
4100: 53 20 31 5c 26 2e 37 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.7\&...TP.\
4110: 66 42 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 fB-validatecomma
4120: 6e 64 5c 66 52 20 5c 66 49 63 61 6c 6c 62 61 63 nd\fR \fIcallbac
4130: 6b 5c 66 52 0a 53 70 65 63 69 66 69 65 73 20 74 k\fR.Specifies t
4140: 68 65 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6d 6d he callback comm
4150: 61 6e 64 20 74 6f 20 69 6e 76 6f 6b 65 20 74 6f and to invoke to
4160: 20 76 61 6c 69 64 61 74 65 20 74 68 65 20 70 65 validate the pe
4170: 65 72 20 63 65 72 74 69 66 69 63 61 74 65 73 0a er certificates.
4180: 61 6e 64 20 6f 74 68 65 72 20 63 6f 6e 66 69 67 and other config
4190: 20 69 6e 66 6f 20 64 75 72 69 6e 67 20 74 68 65 info during the
41a0: 20 70 72 6f 74 6f 63 6f 6c 20 6e 65 67 6f 74 69 protocol negoti
41b0: 61 74 69 6f 6e 20 70 68 61 73 65 5c 26 2e 20 54 ation phase\&. T
41c0: 68 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 0a his can be used.
41d0: 62 79 20 54 43 4c 20 73 63 72 69 70 74 73 20 74 by TCL scripts t
41e0: 6f 20 70 65 72 66 6f 72 6d 20 74 68 65 69 72 20 o perform their
41f0: 6f 77 6e 20 43 65 72 74 69 66 69 63 61 74 65 20 own Certificate
4200: 56 61 6c 69 64 61 74 69 6f 6e 20 74 6f 20 73 75 Validation to su
4210: 70 70 6c 65 6d 65 6e 74 20 74 68 65 0a 64 65 66 pplement the.def
4220: 61 75 6c 74 20 76 61 6c 69 64 61 74 69 6f 6e 20 ault validation
4230: 70 72 6f 76 69 64 65 64 20 62 79 20 4f 70 65 6e provided by Open
4240: 53 53 4c 5c 26 2e 20 54 68 65 20 73 63 72 69 70 SSL\&. The scrip
4250: 74 20 6d 75 73 74 20 72 65 74 75 72 6e 20 61 20 t must return a
4260: 62 6f 6f 6c 65 61 6e 20 74 72 75 65 0a 74 6f 20 boolean true.to
4270: 63 6f 6e 74 69 6e 75 65 20 74 68 65 20 6e 65 67 continue the neg
4280: 6f 74 69 61 74 69 6f 6e 5c 26 2e 20 53 65 65 20 otiation\&. See
4290: 5c 66 42 43 61 6c 6c 62 61 63 6b 20 4f 70 74 69 \fBCallback Opti
42a0: 6f 6e 73 5c 66 52 20 66 6f 72 20 6d 6f 72 65 20 ons\fR for more
42b0: 69 6e 66 6f 5c 26 2e 0a 54 68 69 73 20 6f 70 74 info\&..This opt
42c0: 69 6f 6e 20 69 73 20 6e 65 77 20 66 6f 72 20 54 ion is new for T
42d0: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
42e0: 52 45 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 3a 75 RE..TP.\fBtls::u
42f0: 6e 69 6d 70 6f 72 74 5c 66 52 20 5c 66 49 63 68 nimport\fR \fIch
4300: 61 6e 6e 65 6c 5c 66 52 0a 43 6f 6d 70 6c 69 6d annel\fR.Complim
4310: 65 6e 74 20 74 6f 20 5c 66 42 74 6c 73 3a 3a 69 ent to \fBtls::i
4320: 6d 70 6f 72 74 5c 66 52 5c 26 2e 20 55 73 65 64 mport\fR\&. Used
4330: 20 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 74 to remove the t
4340: 6f 70 20 6c 65 76 65 6c 20 73 74 61 63 6b 65 64 op level stacked
4350: 20 63 68 61 6e 6e 65 6c 0a 66 72 6f 6d 20 5c 66 channel.from \f
4360: 49 63 68 61 6e 6e 65 6c 5c 66 52 5c 26 2e 20 54 Ichannel\fR\&. T
4370: 68 69 73 20 75 6e 73 74 61 63 6b 73 20 74 68 65 his unstacks the
4380: 20 65 6e 63 72 79 70 74 69 6f 6e 20 6f 66 20 61 encryption of a
4390: 20 72 65 67 75 6c 61 72 20 54 43 4c 20 63 68 61 regular TCL cha
43a0: 6e 6e 65 6c 5c 26 2e 20 41 6e 0a 65 72 72 6f 72 nnel\&. An.error
43b0: 20 69 73 20 74 68 72 6f 77 6e 20 69 66 20 54 4c is thrown if TL
43c0: 53 20 69 73 20 6e 6f 74 20 74 68 65 20 74 6f 70 S is not the top
43d0: 20 73 74 61 63 6b 65 64 20 63 68 61 6e 6e 65 6c stacked channel
43e0: 20 74 79 70 65 5c 26 2e 0a 2e 54 50 0a 5c 66 42 type\&...TP.\fB
43f0: 74 6c 73 3a 3a 68 61 6e 64 73 68 61 6b 65 5c 66 tls::handshake\f
4400: 52 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 0a R \fIchannel\fR.
4410: 46 6f 72 63 65 73 20 74 68 65 20 54 4c 53 20 6e Forces the TLS n
4420: 65 67 6f 74 69 61 74 69 6f 6e 20 68 61 6e 64 73 egotiation hands
4430: 68 61 6b 65 20 74 6f 20 74 61 6b 65 20 70 6c 61 hake to take pla
4440: 63 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 2c 20 ce immediately,
4450: 61 6e 64 20 72 65 74 75 72 6e 73 20 30 0a 69 66 and returns 0.if
4460: 20 68 61 6e 64 73 68 61 6b 65 20 69 73 20 73 74 handshake is st
4470: 69 6c 6c 20 69 6e 20 70 72 6f 67 72 65 73 73 20 ill in progress
4480: 28 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 29 2c 20 (non-blocking),
4490: 6f 72 20 31 20 69 66 20 74 68 65 20 68 61 6e 64 or 1 if the hand
44a0: 73 68 61 6b 65 20 77 61 73 0a 73 75 63 63 65 73 shake was.succes
44b0: 73 66 75 6c 5c 26 2e 20 49 66 20 74 68 65 20 68 sful\&. If the h
44c0: 61 6e 64 73 68 61 6b 65 20 66 61 69 6c 65 64 2c andshake failed,
44d0: 20 61 6e 20 65 72 72 6f 72 20 77 69 6c 6c 20 62 an error will b
44e0: 65 20 72 65 74 75 72 6e 65 64 5c 26 2e 0a 2e 54 e returned\&...T
44f0: 50 0a 5c 66 42 74 6c 73 3a 3a 73 74 61 74 75 73 P.\fBtls::status
4500: 5c 66 52 20 3f 5c 66 42 2d 6c 6f 63 61 6c 5c 66 \fR ?\fB-local\f
4510: 52 3f 20 5c 66 49 63 68 61 6e 6e 65 6c 5c 66 52 R? \fIchannel\fR
4520: 0a 52 65 74 75 72 6e 73 20 74 68 65 20 63 75 72 .Returns the cur
4530: 72 65 6e 74 20 73 74 61 74 75 73 20 6f 66 20 61 rent status of a
4540: 6e 20 53 53 4c 20 63 68 61 6e 6e 65 6c 5c 26 2e n SSL channel\&.
4550: 20 54 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 The result is a
4560: 20 6c 69 73 74 20 6f 66 20 6b 65 79 2d 76 61 6c list of key-val
4570: 75 65 0a 70 61 69 72 73 20 64 65 73 63 72 69 62 ue.pairs describ
4580: 69 6e 67 20 74 68 65 20 53 53 4c 2c 20 63 65 72 ing the SSL, cer
4590: 74 69 66 69 63 61 74 65 2c 20 61 6e 64 20 63 65 tificate, and ce
45a0: 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 69 rtificate verifi
45b0: 63 61 74 69 6f 6e 20 73 74 61 74 75 73 5c 26 2e cation status\&.
45c0: 20 49 66 0a 74 68 65 20 53 53 4c 20 68 61 6e 64 If.the SSL hand
45d0: 73 68 61 6b 65 20 68 61 73 20 6e 6f 74 20 79 65 shake has not ye
45e0: 74 20 63 6f 6d 70 6c 65 74 65 64 2c 20 61 6e 20 t completed, an
45f0: 65 6d 70 74 79 20 6c 69 73 74 20 69 73 20 72 65 empty list is re
4600: 74 75 72 6e 65 64 5c 26 2e 20 49 66 20 74 68 65 turned\&. If the
4610: 0a 5c 66 42 2d 6c 6f 63 61 6c 5c 66 52 20 6f 70 .\fB-local\fR op
4620: 74 69 6f 6e 20 69 73 20 73 70 65 63 69 66 69 65 tion is specifie
4630: 64 2c 20 74 68 65 6e 20 74 68 65 20 6c 6f 63 61 d, then the loca
4640: 6c 20 63 65 72 74 69 66 69 63 61 74 65 20 69 73 l certificate is
4650: 20 75 73 65 64 5c 26 2e 20 52 65 74 75 72 6e 65 used\&. Returne
4660: 64 0a 76 61 6c 75 65 73 20 69 6e 63 6c 75 64 65 d.values include
4670: 3a 0a 2e 73 70 0a 53 53 4c 20 53 74 61 74 75 73 :..sp.SSL Status
4680: 0a 2e 52 53 0a 2e 54 50 0a 5c 66 42 61 6c 70 6e ..RS..TP.\fBalpn
4690: 5c 66 52 20 5c 66 49 70 72 6f 74 6f 63 6f 6c 5c \fR \fIprotocol\
46a0: 66 52 0a 54 68 65 20 70 72 6f 74 6f 63 6f 6c 20 fR.The protocol
46b0: 73 65 6c 65 63 74 65 64 20 61 66 74 65 72 20 41 selected after A
46c0: 70 70 6c 69 63 61 74 69 6f 6e 2d 4c 61 79 65 72 pplication-Layer
46d0: 20 50 72 6f 74 6f 63 6f 6c 20 4e 65 67 6f 74 69 Protocol Negoti
46e0: 61 74 69 6f 6e 20 28 41 4c 50 4e 29 5c 26 2e 0a ation (ALPN)\&..
46f0: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
4700: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
4710: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 69 70 .8\&...TP.\fBcip
4720: 68 65 72 5c 66 52 20 5c 66 49 63 69 70 68 65 72 her\fR \fIcipher
4730: 5c 66 52 0a 54 68 65 20 63 75 72 72 65 6e 74 20 \fR.The current
4740: 63 69 70 68 65 72 20 69 6e 20 75 73 65 20 66 6f cipher in use fo
4750: 72 20 74 68 65 20 73 65 73 73 69 6f 6e 5c 26 2e r the session\&.
4760: 0a 2e 54 50 0a 5c 66 42 70 65 65 72 6e 61 6d 65 ..TP.\fBpeername
4770: 5c 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 \fR \fIname\fR.T
4780: 68 65 20 70 65 65 72 6e 61 6d 65 20 66 72 6f 6d he peername from
4790: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
47a0: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
47b0: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
47c0: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
47d0: 42 70 72 6f 74 6f 63 6f 6c 5c 66 52 20 5c 66 49 Bprotocol\fR \fI
47e0: 76 65 72 73 69 6f 6e 5c 66 52 0a 54 68 65 20 70 version\fR.The p
47f0: 72 6f 74 6f 63 6f 6c 20 76 65 72 73 69 6f 6e 20 rotocol version
4800: 75 73 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6e used for the con
4810: 6e 65 63 74 69 6f 6e 3a 20 53 53 4c 32 2c 20 53 nection: SSL2, S
4820: 53 4c 33 2c 20 54 4c 53 31 2c 20 54 4c 53 31 5c SL3, TLS1, TLS1\
4830: 26 2e 31 2c 20 54 4c 53 31 5c 26 2e 32 2c 0a 54 &.1, TLS1\&.2,.T
4840: 4c 53 31 5c 26 2e 33 2c 20 6f 72 20 75 6e 6b 6e LS1\&.3, or unkn
4850: 6f 77 6e 5c 26 2e 20 54 68 69 73 20 76 61 6c 75 own\&. This valu
4860: 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c e is new for Tcl
4870: 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 TLS 1\&.8\&...TP
4880: 0a 5c 66 42 73 62 69 74 73 5c 66 52 20 5c 66 49 .\fBsbits\fR \fI
4890: 6e 5c 66 52 0a 54 68 65 20 6e 75 6d 62 65 72 20 n\fR.The number
48a0: 6f 66 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 of bits used for
48b0: 20 74 68 65 20 73 65 73 73 69 6f 6e 20 6b 65 79 the session key
48c0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 69 67 6e 61 \&...TP.\fBsigna
48d0: 74 75 72 65 48 61 73 68 41 6c 67 6f 72 69 74 68 tureHashAlgorith
48e0: 6d 5c 66 52 20 5c 66 49 61 6c 67 6f 72 69 74 68 m\fR \fIalgorith
48f0: 6d 5c 66 52 0a 54 68 65 20 73 69 67 6e 61 74 75 m\fR.The signatu
4900: 72 65 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 re hash algorith
4910: 6d 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 m\&..This value
4920: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
4930: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
4940: 66 42 73 69 67 6e 61 74 75 72 65 54 79 70 65 5c fBsignatureType\
4950: 66 52 20 5c 66 49 74 79 70 65 5c 66 52 0a 54 68 fR \fItype\fR.Th
4960: 65 20 73 69 67 6e 61 74 75 72 65 20 74 79 70 65 e signature type
4970: 20 76 61 6c 75 65 5c 26 2e 0a 54 68 69 73 20 76 value\&..This v
4980: 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 alue is new for
4990: 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a TclTLS 1\&.8\&..
49a0: 2e 54 50 0a 5c 66 42 76 65 72 69 66 79 44 65 70 .TP.\fBverifyDep
49b0: 74 68 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 4d 61 th\fR \fIn\fR.Ma
49c0: 78 69 6d 75 6d 20 64 65 70 74 68 20 66 6f 72 20 ximum depth for
49d0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
49e0: 63 68 61 69 6e 20 76 65 72 69 66 69 63 61 74 69 chain verificati
49f0: 6f 6e 5c 26 2e 20 44 65 66 61 75 6c 74 20 69 73 on\&. Default is
4a00: 20 2d 31 2c 20 74 6f 20 63 68 65 63 6b 20 61 6c -1, to check al
4a10: 6c 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 l\&..This value
4a20: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
4a30: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
4a40: 66 42 76 65 72 69 66 79 4d 6f 64 65 5c 66 52 20 fBverifyMode\fR
4a50: 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 \fIlist\fR.List
4a60: 6f 66 20 63 65 72 74 69 66 69 63 61 74 65 20 76 of certificate v
4a70: 65 72 69 66 69 63 61 74 69 6f 6e 20 6d 6f 64 65 erification mode
4a80: 73 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 s\&..This value
4a90: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
4aa0: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
4ab0: 66 42 76 65 72 69 66 79 52 65 73 75 6c 74 5c 66 fBverifyResult\f
4ac0: 52 20 5c 66 49 72 65 73 75 6c 74 5c 66 52 0a 43 R \fIresult\fR.C
4ad0: 65 72 74 69 66 69 63 61 74 65 20 76 65 72 69 66 ertificate verif
4ae0: 69 63 61 74 69 6f 6e 20 72 65 73 75 6c 74 5c 26 ication result\&
4af0: 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
4b00: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
4b10: 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 \&.8\&...TP.\fBc
4b20: 61 5f 6e 61 6d 65 73 5c 66 52 20 5c 66 49 6c 69 a_names\fR \fIli
4b30: 73 74 5c 66 52 0a 4c 69 73 74 20 6f 66 20 74 68 st\fR.List of th
4b40: 65 20 43 65 72 74 69 66 69 63 61 74 65 20 41 75 e Certificate Au
4b50: 74 68 6f 72 69 74 69 65 73 20 75 73 65 64 20 74 thorities used t
4b60: 6f 20 63 72 65 61 74 65 20 74 68 65 20 63 65 72 o create the cer
4b70: 74 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 tificate\&..This
4b80: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
4b90: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
4ba0: 2e 0a 2e 52 45 0a 2e 49 50 0a 43 65 72 74 69 66 ...RE..IP.Certif
4bb0: 69 63 61 74 65 20 53 74 61 74 75 73 0a 2e 52 53 icate Status..RS
4bc0: 0a 2e 54 50 0a 5c 66 42 61 6c 6c 5c 66 52 20 5c ..TP.\fBall\fR \
4bd0: 66 49 73 74 72 69 6e 67 5c 66 52 0a 44 75 6d 70 fIstring\fR.Dump
4be0: 20 6f 66 20 61 6c 6c 20 63 65 72 74 69 66 69 63 of all certific
4bf0: 61 74 65 20 69 6e 66 6f 5c 26 2e 0a 54 68 69 73 ate info\&..This
4c00: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
4c10: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
4c20: 2e 0a 2e 54 50 0a 5c 66 42 76 65 72 73 69 6f 6e ...TP.\fBversion
4c30: 5c 66 52 20 5c 66 49 76 61 6c 75 65 5c 66 52 0a \fR \fIvalue\fR.
4c40: 54 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 The certificate
4c50: 76 65 72 73 69 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c version\&...TP.\
4c60: 66 42 73 65 72 69 61 6c 4e 75 6d 62 65 72 5c 66 fBserialNumber\f
4c70: 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 54 R \fIstring\fR.T
4c80: 68 65 20 73 65 72 69 61 6c 20 6e 75 6d 62 65 72 he serial number
4c90: 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 69 63 of the certific
4ca0: 61 74 65 20 61 73 20 61 20 68 65 78 20 73 74 72 ate as a hex str
4cb0: 69 6e 67 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 ing\&..This valu
4cc0: 65 20 77 61 73 20 63 68 61 6e 67 65 64 20 66 72 e was changed fr
4cd0: 6f 6d 20 73 65 72 69 61 6c 20 69 6e 20 54 63 6c om serial in Tcl
4ce0: 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 TLS 1\&.8\&...TP
4cf0: 0a 5c 66 42 73 69 67 6e 61 74 75 72 65 5c 66 52 .\fBsignature\fR
4d00: 20 5c 66 49 61 6c 67 6f 72 69 74 68 6d 5c 66 52 \fIalgorithm\fR
4d10: 0a 43 69 70 68 65 72 20 61 6c 67 6f 72 69 74 68 .Cipher algorith
4d20: 6d 20 75 73 65 64 20 66 6f 72 20 63 65 72 74 69 m used for certi
4d30: 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 ficate signature
4d40: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
4d50: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
4d60: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
4d70: 42 69 73 73 75 65 72 5c 66 52 20 5c 66 49 73 74 Bissuer\fR \fIst
4d80: 72 69 6e 67 5c 66 52 0a 54 68 65 20 64 69 73 74 ring\fR.The dist
4d90: 69 6e 67 75 69 73 68 65 64 20 6e 61 6d 65 20 28 inguished name (
4da0: 44 4e 29 20 6f 66 20 74 68 65 20 63 65 72 74 69 DN) of the certi
4db0: 66 69 63 61 74 65 20 69 73 73 75 65 72 5c 26 2e ficate issuer\&.
4dc0: 0a 2e 54 50 0a 5c 66 42 6e 6f 74 42 65 66 6f 72 ..TP.\fBnotBefor
4dd0: 65 5c 66 52 20 5c 66 49 64 61 74 65 5c 66 52 0a e\fR \fIdate\fR.
4de0: 54 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 64 61 The beginning da
4df0: 74 65 20 6f 66 20 74 68 65 20 63 65 72 74 69 66 te of the certif
4e00: 69 63 61 74 65 20 76 61 6c 69 64 69 74 79 5c 26 icate validity\&
4e10: 2e 0a 2e 54 50 0a 5c 66 42 6e 6f 74 41 66 74 65 ...TP.\fBnotAfte
4e20: 72 5c 66 52 20 5c 66 49 64 61 74 65 5c 66 52 0a r\fR \fIdate\fR.
4e30: 54 68 65 20 65 78 70 69 72 61 74 69 6f 6e 20 64 The expiration d
4e40: 61 74 65 20 6f 66 20 74 68 65 20 63 65 72 74 69 ate of the certi
4e50: 66 69 63 61 74 65 20 76 61 6c 69 64 69 74 79 5c ficate validity\
4e60: 26 2e 0a 2e 54 50 0a 5c 66 42 73 75 62 6a 65 63 &...TP.\fBsubjec
4e70: 74 5c 66 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 t\fR \fIstring\f
4e80: 52 0a 54 68 65 20 64 69 73 74 69 6e 67 75 69 73 R.The distinguis
4e90: 68 65 64 20 6e 61 6d 65 20 28 44 4e 29 20 6f 66 hed name (DN) of
4ea0: 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 the certificate
4eb0: 20 73 75 62 6a 65 63 74 5c 26 2e 20 46 69 65 6c subject\&. Fiel
4ec0: 64 73 20 69 6e 63 6c 75 64 65 3a 20 43 6f 6d 6d ds include: Comm
4ed0: 6f 6e 0a 4e 61 6d 65 20 28 43 4e 29 2c 20 4f 72 on.Name (CN), Or
4ee0: 67 61 6e 69 7a 61 74 69 6f 6e 20 28 4f 29 2c 20 ganization (O),
4ef0: 4c 6f 63 61 6c 69 74 79 20 6f 72 20 43 69 74 79 Locality or City
4f00: 20 28 4c 29 2c 20 53 74 61 74 65 20 6f 72 20 50 (L), State or P
4f10: 72 6f 76 69 6e 63 65 20 28 53 29 2c 20 61 6e 64 rovince (S), and
4f20: 0a 43 6f 75 6e 74 72 79 20 4e 61 6d 65 20 28 43 .Country Name (C
4f30: 29 5c 26 2e 0a 2e 54 50 0a 5c 66 42 69 73 73 75 )\&...TP.\fBissu
4f40: 65 72 55 6e 69 71 75 65 49 44 5c 66 52 20 5c 66 erUniqueID\fR \f
4f50: 49 73 74 72 69 6e 67 5c 66 52 0a 54 68 65 20 69 Istring\fR.The i
4f60: 73 73 75 65 72 20 75 6e 69 71 75 65 20 69 64 5c ssuer unique id\
4f70: 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 &..This value is
4f80: 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 new for TclTLS
4f90: 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 1\&.8\&...TP.\fB
4fa0: 73 75 62 6a 65 63 74 55 6e 69 71 75 65 49 44 5c subjectUniqueID\
4fb0: 66 52 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a fR \fIstring\fR.
4fc0: 54 68 65 20 73 75 62 6a 65 63 74 20 75 6e 69 71 The subject uniq
4fd0: 75 65 20 69 64 5c 26 2e 0a 54 68 69 73 20 76 61 ue id\&..This va
4fe0: 6c 75 65 20 69 73 20 6e 65 77 20 66 6f 72 20 54 lue is new for T
4ff0: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
5000: 54 50 0a 5c 66 42 6e 75 6d 5f 65 78 74 65 6e 73 TP.\fBnum_extens
5010: 69 6f 6e 73 5c 66 52 20 5c 66 49 6e 5c 66 52 0a ions\fR \fIn\fR.
5020: 4e 75 6d 62 65 72 20 6f 66 20 63 65 72 74 69 66 Number of certif
5030: 69 63 61 74 65 20 65 78 74 65 6e 73 69 6f 6e 73 icate extensions
5040: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
5050: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
5060: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
5070: 42 65 78 74 65 6e 73 69 6f 6e 73 5c 66 52 20 5c Bextensions\fR \
5080: 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 20 6f fIlist\fR.List o
5090: 66 20 63 65 72 74 69 66 69 63 61 74 65 20 65 78 f certificate ex
50a0: 74 65 6e 73 69 6f 6e 20 6e 61 6d 65 73 5c 26 2e tension names\&.
50b0: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
50c0: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
50d0: 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 61 75 &.8\&...TP.\fBau
50e0: 74 68 6f 72 69 74 79 4b 65 79 49 64 65 6e 74 69 thorityKeyIdenti
50f0: 66 69 65 72 5c 66 52 20 5c 66 49 73 74 72 69 6e fier\fR \fIstrin
5100: 67 5c 66 52 0a 41 75 74 68 6f 72 69 74 79 20 4b g\fR.Authority K
5110: 65 79 20 49 64 65 6e 74 69 66 69 65 72 20 28 41 ey Identifier (A
5120: 4b 49 29 20 6f 66 20 74 68 65 20 49 73 73 75 69 KI) of the Issui
5130: 6e 67 20 43 41 20 63 65 72 74 69 66 69 63 61 74 ng CA certificat
5140: 65 20 74 68 61 74 20 73 69 67 6e 65 64 20 74 68 e that signed th
5150: 65 0a 53 53 4c 20 63 65 72 74 69 66 69 63 61 74 e.SSL certificat
5160: 65 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e e as a hex strin
5170: 67 5c 26 2e 20 54 68 69 73 20 76 61 6c 75 65 20 g\&. This value
5180: 6d 61 74 63 68 65 73 20 74 68 65 20 53 4b 49 20 matches the SKI
5190: 76 61 6c 75 65 20 6f 66 20 74 68 65 0a 49 6e 74 value of the.Int
51a0: 65 72 6d 65 64 69 61 74 65 20 43 41 20 63 65 72 ermediate CA cer
51b0: 74 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 tificate\&..This
51c0: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
51d0: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
51e0: 2e 0a 2e 54 50 0a 5c 66 42 73 75 62 6a 65 63 74 ...TP.\fBsubject
51f0: 4b 65 79 49 64 65 6e 74 69 66 69 65 72 5c 66 52 KeyIdentifier\fR
5200: 20 5c 66 49 73 74 72 69 6e 67 5c 66 52 0a 53 75 \fIstring\fR.Su
5210: 62 6a 65 63 74 20 4b 65 79 20 49 64 65 6e 74 69 bject Key Identi
5220: 66 69 65 72 20 28 53 4b 49 29 20 68 61 73 68 20 fier (SKI) hash
5230: 6f 66 20 74 68 65 20 70 75 62 6c 69 63 20 6b 65 of the public ke
5240: 79 20 69 6e 73 69 64 65 20 74 68 65 20 63 65 72 y inside the cer
5250: 74 69 66 69 63 61 74 65 20 61 73 20 61 0a 68 65 tificate as a.he
5260: 78 20 73 74 72 69 6e 67 5c 26 2e 20 55 73 65 64 x string\&. Used
5270: 20 74 6f 20 69 64 65 6e 74 69 66 79 20 63 65 72 to identify cer
5280: 74 69 66 69 63 61 74 65 73 20 74 68 61 74 20 63 tificates that c
5290: 6f 6e 74 61 69 6e 20 61 20 70 61 72 74 69 63 75 ontain a particu
52a0: 6c 61 72 20 70 75 62 6c 69 63 20 6b 65 79 5c 26 lar public key\&
52b0: 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
52c0: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
52d0: 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 \&.8\&...TP.\fBs
52e0: 75 62 6a 65 63 74 41 6c 74 4e 61 6d 65 5c 66 52 ubjectAltName\fR
52f0: 20 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 \fIlist\fR.List
5300: 20 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 20 53 of all of the S
5310: 75 62 6a 65 63 74 20 41 6c 74 65 72 6e 61 74 69 ubject Alternati
5320: 76 65 20 4e 61 6d 65 73 20 28 53 41 4e 29 20 69 ve Names (SAN) i
5330: 6e 63 6c 75 64 69 6e 67 20 64 6f 6d 61 69 6e 20 ncluding domain
5340: 6e 61 6d 65 73 2c 20 73 75 62 0a 64 6f 6d 61 69 names, sub.domai
5350: 6e 73 2c 20 61 6e 64 20 49 50 20 61 64 64 72 65 ns, and IP addre
5360: 73 73 65 73 20 74 68 61 74 20 61 72 65 20 73 65 sses that are se
5370: 63 75 72 65 64 20 62 79 20 74 68 65 20 63 65 72 cured by the cer
5380: 74 69 66 69 63 61 74 65 5c 26 2e 0a 54 68 69 73 tificate\&..This
5390: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
53a0: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
53b0: 2e 0a 2e 54 50 0a 5c 66 42 6f 63 73 70 5c 66 52 ...TP.\fBocsp\fR
53c0: 20 5c 66 49 6c 69 73 74 5c 66 52 0a 4c 69 73 74 \fIlist\fR.List
53d0: 20 6f 66 20 61 6c 6c 20 4f 6e 6c 69 6e 65 20 43 of all Online C
53e0: 65 72 74 69 66 69 63 61 74 65 20 53 74 61 74 75 ertificate Statu
53f0: 73 20 50 72 6f 74 6f 63 6f 6c 20 28 4f 43 53 50 s Protocol (OCSP
5400: 29 20 55 52 4c 73 20 74 68 61 74 20 63 61 6e 20 ) URLs that can
5410: 62 65 20 75 73 65 64 20 74 6f 0a 63 68 65 63 6b be used to.check
5420: 20 74 68 65 20 76 61 6c 69 64 69 74 79 20 6f 66 the validity of
5430: 20 74 68 69 73 20 63 65 72 74 69 66 69 63 61 74 this certificat
5440: 65 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 e\&..This value
5450: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
5460: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
5470: 66 42 63 65 72 74 69 66 69 63 61 74 65 5c 66 52 fBcertificate\fR
5480: 20 5c 66 49 63 65 72 74 5c 66 52 0a 54 68 65 20 \fIcert\fR.The
5490: 50 45 4d 20 65 6e 63 6f 64 65 64 20 63 65 72 74 PEM encoded cert
54a0: 69 66 69 63 61 74 65 5c 26 2e 0a 2e 54 50 0a 5c ificate\&...TP.\
54b0: 66 42 73 69 67 6e 61 74 75 72 65 41 6c 67 6f 72 fBsignatureAlgor
54c0: 69 74 68 6d 5c 66 52 20 5c 66 49 61 6c 67 6f 72 ithm\fR \fIalgor
54d0: 69 74 68 6d 5c 66 52 0a 43 69 70 68 65 72 20 61 ithm\fR.Cipher a
54e0: 6c 67 6f 72 69 74 68 6d 20 75 73 65 64 20 66 6f lgorithm used fo
54f0: 72 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 r the certificat
5500: 65 20 73 69 67 6e 61 74 75 72 65 5c 26 2e 0a 54 e signature\&..T
5510: 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 77 his value is new
5520: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
5530: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 69 67 6e 8\&...TP.\fBsign
5540: 61 74 75 72 65 56 61 6c 75 65 5c 66 52 20 5c 66 atureValue\fR \f
5550: 49 73 74 72 69 6e 67 5c 66 52 0a 43 65 72 74 69 Istring\fR.Certi
5560: 66 69 63 61 74 65 20 73 69 67 6e 61 74 75 72 65 ficate signature
5570: 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 as a hex string
5580: 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 \&..This value i
5590: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
55a0: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
55b0: 42 73 69 67 6e 61 74 75 72 65 44 69 67 65 73 74 BsignatureDigest
55c0: 5c 66 52 20 5c 66 49 76 65 72 73 69 6f 6e 5c 66 \fR \fIversion\f
55d0: 52 0a 43 65 72 74 69 66 69 63 61 74 65 20 73 69 R.Certificate si
55e0: 67 6e 69 6e 67 20 64 69 67 65 73 74 20 61 73 20 gning digest as
55f0: 61 20 68 65 78 20 73 74 72 69 6e 67 5c 26 2e 0a a hex string\&..
5600: 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e 65 This value is ne
5610: 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 w for TclTLS 1\&
5620: 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 75 62 .8\&...TP.\fBpub
5630: 6c 69 63 4b 65 79 41 6c 67 6f 72 69 74 68 6d 5c licKeyAlgorithm\
5640: 66 52 20 5c 66 49 61 6c 67 6f 72 69 74 68 6d 5c fR \fIalgorithm\
5650: 66 52 0a 43 65 72 74 69 66 69 63 61 74 65 20 73 fR.Certificate s
5660: 69 67 6e 61 74 75 72 65 20 70 75 62 6c 69 63 20 ignature public
5670: 6b 65 79 20 61 6c 67 6f 72 69 74 68 6d 5c 26 2e key algorithm\&.
5680: 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 6e .This value is n
5690: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
56a0: 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 75 &.8\&...TP.\fBpu
56b0: 62 6c 69 63 4b 65 79 5c 66 52 20 5c 66 49 73 74 blicKey\fR \fIst
56c0: 72 69 6e 67 5c 66 52 0a 43 65 72 74 69 66 69 63 ring\fR.Certific
56d0: 61 74 65 20 73 69 67 6e 61 74 75 72 65 20 70 75 ate signature pu
56e0: 62 6c 69 63 20 6b 65 79 20 61 73 20 61 20 68 65 blic key as a he
56f0: 78 20 73 74 72 69 6e 67 5c 26 2e 0a 54 68 69 73 x string\&..This
5700: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
5710: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
5720: 2e 0a 2e 54 50 0a 5c 66 42 62 69 74 73 5c 66 52 ...TP.\fBbits\fR
5730: 20 5c 66 49 6e 5c 66 52 0a 4e 75 6d 62 65 72 20 \fIn\fR.Number
5740: 6f 66 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 of bits used for
5750: 20 63 65 72 74 69 66 69 63 61 74 65 20 73 69 67 certificate sig
5760: 6e 61 74 75 72 65 20 6b 65 79 5c 26 2e 0a 54 68 nature key\&..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 65 6c 66 5f \&...TP.\fBself_
57a0: 73 69 67 6e 65 64 5c 66 52 20 5c 66 49 62 6f 6f signed\fR \fIboo
57b0: 6c 65 61 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 lean\fR.Whether
57c0: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
57d0: 73 69 67 6e 61 74 75 72 65 20 69 73 20 73 65 6c signature is sel
57e0: 66 20 73 69 67 6e 65 64 5c 26 2e 0a 54 68 69 73 f signed\&..This
57f0: 20 76 61 6c 75 65 20 69 73 20 6e 65 77 20 66 6f value is new fo
5800: 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 r TclTLS 1\&.8\&
5810: 2e 0a 2e 54 50 0a 5c 66 42 73 68 61 31 5f 68 61 ...TP.\fBsha1_ha
5820: 73 68 5c 66 52 20 5c 66 49 68 61 73 68 5c 66 52 sh\fR \fIhash\fR
5830: 0a 54 68 65 20 53 48 41 31 20 68 61 73 68 20 6f .The SHA1 hash o
5840: 66 20 74 68 65 20 63 65 72 74 69 66 69 63 61 74 f the certificat
5850: 65 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e e as a hex strin
5860: 67 5c 26 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 g\&..This value
5870: 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c is new for TclTL
5880: 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c S 1\&.8\&...TP.\
5890: 66 42 73 68 61 32 35 36 5f 68 61 73 68 5c 66 52 fBsha256_hash\fR
58a0: 20 5c 66 49 68 61 73 68 5c 66 52 0a 54 68 65 20 \fIhash\fR.The
58b0: 53 48 41 32 35 36 20 68 61 73 68 20 6f 66 20 74 SHA256 hash of t
58c0: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 61 he certificate a
58d0: 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 5c 26 s a hex string\&
58e0: 2e 0a 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 ..This value is
58f0: 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 new for TclTLS 1
5900: 5c 26 2e 38 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a \&.8\&...RE..TP.
5910: 5c 66 42 74 6c 73 3a 3a 63 6f 6e 6e 65 63 74 69 \fBtls::connecti
5920: 6f 6e 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c on\fR \fIchannel
5930: 5c 66 52 0a 52 65 74 75 72 6e 73 20 74 68 65 20 \fR.Returns the
5940: 63 75 72 72 65 6e 74 20 63 6f 6e 6e 65 63 74 69 current connecti
5950: 6f 6e 20 73 74 61 74 75 73 20 6f 66 20 61 6e 20 on status of an
5960: 53 53 4c 20 63 68 61 6e 6e 65 6c 5c 26 2e 20 54 SSL channel\&. T
5970: 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 20 6c he result is a l
5980: 69 73 74 0a 6f 66 20 6b 65 79 2d 76 61 6c 75 65 ist.of key-value
5990: 20 70 61 69 72 73 20 64 65 73 63 72 69 62 69 6e pairs describin
59a0: 67 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e g the connection
59b0: 5c 26 2e 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 \&..This command
59c0: 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 is new for TclT
59d0: 4c 53 20 31 5c 26 2e 38 5c 26 2e 20 52 65 74 75 LS 1\&.8\&. Retu
59e0: 72 6e 65 64 20 76 61 6c 75 65 73 20 69 6e 63 6c rned values incl
59f0: 75 64 65 3a 0a 2e 73 70 0a 53 53 4c 20 53 74 61 ude:..sp.SSL Sta
5a00: 74 75 73 0a 2e 52 53 0a 2e 54 50 0a 5c 66 42 73 tus..RS..TP.\fBs
5a10: 74 61 74 65 5c 66 52 20 5c 66 49 73 74 61 74 65 tate\fR \fIstate
5a20: 5c 66 52 0a 53 74 61 74 65 20 6f 66 20 74 68 65 \fR.State of the
5a30: 20 63 6f 6e 6e 65 63 74 69 6f 6e 5c 26 2e 0a 2e connection\&...
5a40: 54 50 0a 5c 66 42 73 65 72 76 65 72 6e 61 6d 65 TP.\fBservername
5a50: 5c 66 52 20 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 \fR \fIname\fR.T
5a60: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 he name of the c
5a70: 6f 6e 6e 65 63 74 65 64 20 74 6f 20 73 65 72 76 onnected to serv
5a80: 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 42 70 72 6f er\&...TP.\fBpro
5a90: 74 6f 63 6f 6c 5c 66 52 20 5c 66 49 76 65 72 73 tocol\fR \fIvers
5aa0: 69 6f 6e 5c 66 52 0a 54 68 65 20 70 72 6f 74 6f ion\fR.The proto
5ab0: 63 6f 6c 20 76 65 72 73 69 6f 6e 20 75 73 65 64 col version used
5ac0: 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 74 for the connect
5ad0: 69 6f 6e 3a 20 53 53 4c 32 2c 20 53 53 4c 33 2c ion: SSL2, SSL3,
5ae0: 20 54 4c 53 31 2c 20 54 4c 53 31 5c 26 2e 31 2c TLS1, TLS1\&.1,
5af0: 20 54 4c 53 31 5c 26 2e 32 2c 20 54 4c 53 31 5c TLS1\&.2, TLS1\
5b00: 26 2e 33 2c 20 6f 72 20 75 6e 6b 6e 6f 77 6e 5c &.3, or unknown\
5b10: 26 2e 0a 2e 54 50 0a 5c 66 42 72 65 6e 65 67 6f &...TP.\fBrenego
5b20: 74 69 61 74 69 6f 6e 5f 61 6c 6c 6f 77 65 64 5c tiation_allowed\
5b30: 66 52 20 5c 66 49 62 6f 6f 6c 65 61 6e 5c 66 52 fR \fIboolean\fR
5b40: 0a 57 68 65 74 68 65 72 20 70 72 6f 74 6f 63 6f .Whether protoco
5b50: 6c 20 72 65 6e 65 67 6f 74 69 61 74 69 6f 6e 20 l renegotiation
5b60: 69 73 20 73 75 70 70 6f 72 74 65 64 20 6f 72 20 is supported or
5b70: 6e 6f 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 65 not\&...TP.\fBse
5b80: 63 75 72 69 74 79 5f 6c 65 76 65 6c 5c 66 52 20 curity_level\fR
5b90: 5c 66 49 6c 65 76 65 6c 5c 66 52 0a 54 68 65 20 \fIlevel\fR.The
5ba0: 73 65 63 75 72 69 74 79 20 6c 65 76 65 6c 20 75 security level u
5bb0: 73 65 64 20 66 6f 72 20 73 65 6c 65 63 74 69 6f sed for selectio
5bc0: 6e 20 6f 66 20 63 69 70 68 65 72 73 2c 20 6b 65 n of ciphers, ke
5bd0: 79 20 73 69 7a 65 2c 20 65 74 63 5c 26 2e 0a 2e y size, etc\&...
5be0: 54 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f 72 65 TP.\fBsession_re
5bf0: 75 73 65 64 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 used\fR \fIboole
5c00: 61 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 74 68 an\fR.Whether th
5c10: 65 20 73 65 73 73 69 6f 6e 20 68 61 73 20 62 65 e session has be
5c20: 65 6e 20 72 65 75 73 65 64 20 6f 72 20 6e 6f 74 en reused or not
5c30: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 69 73 5f 73 65 \&...TP.\fBis_se
5c40: 72 76 65 72 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 rver\fR \fIboole
5c50: 61 6e 5c 66 52 0a 57 68 65 74 68 65 72 20 74 68 an\fR.Whether th
5c60: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 e connection is
5c70: 63 6f 6e 66 69 67 75 72 65 64 20 61 73 20 61 20 configured as a
5c80: 73 65 72 76 65 72 20 28 31 29 20 6f 72 20 63 6c server (1) or cl
5c90: 69 65 6e 74 20 28 30 29 5c 26 2e 0a 2e 54 50 0a ient (0)\&...TP.
5ca0: 5c 66 42 63 6f 6d 70 72 65 73 73 69 6f 6e 5c 66 \fBcompression\f
5cb0: 52 20 5c 66 49 6d 6f 64 65 5c 66 52 0a 43 6f 6d R \fImode\fR.Com
5cc0: 70 72 65 73 73 69 6f 6e 20 6d 65 74 68 6f 64 5c pression method\
5cd0: 26 2e 0a 2e 54 50 0a 5c 66 42 65 78 70 61 6e 73 &...TP.\fBexpans
5ce0: 69 6f 6e 5c 66 52 20 5c 66 49 6d 6f 64 65 5c 66 ion\fR \fImode\f
5cf0: 52 0a 45 78 70 61 6e 73 69 6f 6e 20 6d 65 74 68 R.Expansion meth
5d00: 6f 64 5c 26 2e 0a 2e 54 50 0a 5c 66 42 63 61 4c od\&...TP.\fBcaL
5d10: 69 73 74 5c 66 52 20 5c 66 49 6c 69 73 74 5c 66 ist\fR \fIlist\f
5d20: 52 0a 4c 69 73 74 20 6f 66 20 43 65 72 74 69 66 R.List of Certif
5d30: 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 69 65 icate Authoritie
5d40: 73 20 28 43 41 29 20 66 6f 72 20 58 5c 26 2e 35 s (CA) for X\&.5
5d50: 30 39 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 09 certificate\&
5d60: 2e 0a 2e 52 45 0a 2e 49 50 0a 43 69 70 68 65 72 ...RE..IP.Cipher
5d70: 20 49 6e 66 6f 0a 2e 52 53 0a 2e 54 50 0a 5c 66 Info..RS..TP.\f
5d80: 42 63 69 70 68 65 72 5c 66 52 20 5c 66 49 63 69 Bcipher\fR \fIci
5d90: 70 68 65 72 5c 66 52 0a 54 68 65 20 63 75 72 72 pher\fR.The curr
5da0: 65 6e 74 20 63 69 70 68 65 72 20 69 6e 20 75 73 ent cipher in us
5db0: 65 20 66 6f 72 20 74 68 65 20 63 6f 6e 6e 65 63 e for the connec
5dc0: 74 69 6f 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 tion\&...TP.\fBs
5dd0: 74 61 6e 64 61 72 64 5f 6e 61 6d 65 5c 66 52 20 tandard_name\fR
5de0: 5c 66 49 6e 61 6d 65 5c 66 52 0a 54 68 65 20 73 \fIname\fR.The s
5df0: 74 61 6e 64 61 72 64 20 52 46 43 20 6e 61 6d 65 tandard RFC name
5e00: 20 6f 66 20 63 69 70 68 65 72 5c 26 2e 0a 2e 54 of cipher\&...T
5e10: 50 0a 5c 66 42 61 6c 67 6f 72 69 74 68 6d 5f 62 P.\fBalgorithm_b
5e20: 69 74 73 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 54 its\fR \fIn\fR.T
5e30: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 72 6f he number of pro
5e40: 63 65 73 73 65 64 20 62 69 74 73 20 75 73 65 64 cessed bits used
5e50: 20 66 6f 72 20 63 69 70 68 65 72 5c 26 2e 0a 2e for cipher\&...
5e60: 54 50 0a 5c 66 42 73 65 63 72 65 74 5f 62 69 74 TP.\fBsecret_bit
5e70: 73 5c 66 52 20 5c 66 49 6e 5c 66 52 0a 54 68 65 s\fR \fIn\fR.The
5e80: 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 63 72 65 number of secre
5e90: 74 20 62 69 74 73 20 75 73 65 64 20 66 6f 72 20 t bits used for
5ea0: 63 69 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 cipher\&...TP.\f
5eb0: 42 6d 69 6e 5f 76 65 72 73 69 6f 6e 5c 66 52 20 Bmin_version\fR
5ec0: 5c 66 49 76 65 72 73 69 6f 6e 5c 66 52 0a 54 68 \fIversion\fR.Th
5ed0: 65 20 6d 69 6e 69 6d 75 6d 20 70 72 6f 74 6f 63 e minimum protoc
5ee0: 6f 6c 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 63 ol version for c
5ef0: 69 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c 66 42 ipher\&...TP.\fB
5f00: 63 69 70 68 65 72 5f 69 73 5f 61 65 61 64 5c 66 cipher_is_aead\f
5f10: 52 20 5c 66 49 62 6f 6f 6c 65 61 6e 5c 66 52 0a R \fIboolean\fR.
5f20: 57 68 65 74 68 65 72 20 74 68 65 20 63 69 70 68 Whether the ciph
5f30: 65 72 20 69 73 20 41 75 74 68 65 6e 74 69 63 61 er is Authentica
5f40: 74 65 64 20 45 6e 63 72 79 70 74 69 6f 6e 20 77 ted Encryption w
5f50: 69 74 68 20 41 73 73 6f 63 69 61 74 65 64 20 44 ith Associated D
5f60: 61 74 61 20 28 41 45 41 44 29 5c 26 2e 0a 2e 54 ata (AEAD)\&...T
5f70: 50 0a 5c 66 42 63 69 70 68 65 72 5f 69 64 5c 66 P.\fBcipher_id\f
5f80: 52 20 5c 66 49 69 64 5c 66 52 0a 54 68 65 20 4f R \fIid\fR.The O
5f90: 70 65 6e 53 53 4c 20 63 69 70 68 65 72 20 69 64 penSSL cipher id
5fa0: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 64 65 73 63 72 \&...TP.\fBdescr
5fb0: 69 70 74 69 6f 6e 5c 66 52 20 5c 66 49 73 74 72 iption\fR \fIstr
5fc0: 69 6e 67 5c 66 52 0a 41 20 74 65 78 74 20 64 65 ing\fR.A text de
5fd0: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 scription of the
5fe0: 20 63 69 70 68 65 72 5c 26 2e 0a 2e 54 50 0a 5c cipher\&...TP.\
5ff0: 66 42 68 61 6e 64 73 68 61 6b 65 5f 64 69 67 65 fBhandshake_dige
6000: 73 74 5c 66 52 20 5c 66 49 62 6f 6f 6c 65 61 6e st\fR \fIboolean
6010: 5c 66 52 0a 44 69 67 65 73 74 20 75 73 65 64 20 \fR.Digest used
6020: 64 75 72 69 6e 67 20 68 61 6e 64 73 68 61 6b 65 during handshake
6030: 5c 26 2e 0a 2e 52 45 0a 2e 49 50 0a 53 65 73 73 \&...RE..IP.Sess
6040: 69 6f 6e 20 49 6e 66 6f 0a 2e 52 53 0a 2e 54 50 ion Info..RS..TP
6050: 0a 5c 66 42 61 6c 70 6e 5c 66 52 20 5c 66 49 70 .\fBalpn\fR \fIp
6060: 72 6f 74 6f 63 6f 6c 5c 66 52 0a 54 68 65 20 70 rotocol\fR.The p
6070: 72 6f 74 6f 63 6f 6c 20 73 65 6c 65 63 74 65 64 rotocol selected
6080: 20 61 66 74 65 72 20 41 70 70 6c 69 63 61 74 69 after Applicati
6090: 6f 6e 2d 4c 61 79 65 72 20 50 72 6f 74 6f 63 6f on-Layer Protoco
60a0: 6c 20 4e 65 67 6f 74 69 61 74 69 6f 6e 20 28 41 l Negotiation (A
60b0: 4c 50 4e 29 5c 26 2e 0a 2e 54 50 0a 5c 66 42 72 LPN)\&...TP.\fBr
60c0: 65 73 75 6d 61 62 6c 65 5c 66 52 20 5c 66 49 62 esumable\fR \fIb
60d0: 6f 6f 6c 65 61 6e 5c 66 52 0a 57 68 65 74 68 65 oolean\fR.Whethe
60e0: 72 20 74 68 65 20 73 65 73 73 69 6f 6e 20 63 61 r the session ca
60f0: 6e 20 62 65 20 72 65 73 75 6d 65 64 20 6f 72 20 n be resumed or
6100: 6e 6f 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 73 74 not\&...TP.\fBst
6110: 61 72 74 5f 74 69 6d 65 5c 66 52 20 5c 66 49 73 art_time\fR \fIs
6120: 65 63 6f 6e 64 73 5c 66 52 0a 54 69 6d 65 20 73 econds\fR.Time s
6130: 69 6e 63 65 20 73 65 73 73 69 6f 6e 20 73 74 61 ince session sta
6140: 72 74 65 64 20 69 6e 20 73 65 63 6f 6e 64 73 20 rted in seconds
6150: 73 69 6e 63 65 20 65 70 6f 63 68 5c 26 2e 0a 2e since epoch\&...
6160: 54 50 0a 5c 66 42 74 69 6d 65 6f 75 74 5c 66 52 TP.\fBtimeout\fR
6170: 20 5c 66 49 73 65 63 6f 6e 64 73 5c 66 52 0a 4d \fIseconds\fR.M
6180: 61 78 20 64 75 72 61 74 69 6f 6e 20 6f 66 20 73 ax duration of s
6190: 65 73 73 69 6f 6e 20 69 6e 20 73 65 63 6f 6e 64 ession in second
61a0: 73 20 62 65 66 6f 72 65 20 74 69 6d 65 2d 6f 75 s before time-ou
61b0: 74 5c 26 2e 0a 2e 54 50 0a 5c 66 42 6c 69 66 65 t\&...TP.\fBlife
61c0: 74 69 6d 65 5c 66 52 20 5c 66 49 73 65 63 6f 6e time\fR \fIsecon
61d0: 64 73 5c 66 52 0a 53 65 73 73 69 6f 6e 20 74 69 ds\fR.Session ti
61e0: 63 6b 65 74 20 6c 69 66 65 74 69 6d 65 20 68 69 cket lifetime hi
61f0: 6e 74 20 69 6e 20 73 65 63 6f 6e 64 73 5c 26 2e nt in seconds\&.
6200: 0a 2e 54 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f ..TP.\fBsession_
6210: 69 64 5c 66 52 20 5c 66 49 62 69 6e 61 72 79 5f id\fR \fIbinary_
6220: 73 74 72 69 6e 67 5c 66 52 0a 55 6e 69 71 75 65 string\fR.Unique
6230: 20 73 65 73 73 69 6f 6e 20 69 64 20 66 6f 72 20 session id for
6240: 75 73 65 20 69 6e 20 72 65 73 75 6d 69 6e 67 20 use in resuming
6250: 74 68 65 20 73 65 73 73 69 6f 6e 5c 26 2e 0a 2e the session\&...
6260: 54 50 0a 5c 66 42 73 65 73 73 69 6f 6e 5f 74 69 TP.\fBsession_ti
6270: 63 6b 65 74 5c 66 52 20 5c 66 49 62 69 6e 61 72 cket\fR \fIbinar
6280: 79 5f 73 74 72 69 6e 67 5c 66 52 0a 55 6e 69 71 y_string\fR.Uniq
6290: 75 65 20 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 ue session ticke
62a0: 74 20 66 6f 72 20 75 73 65 20 69 6e 20 72 65 73 t for use in res
62b0: 75 6d 69 6e 67 20 74 68 65 20 73 65 73 73 69 6f uming the sessio
62c0: 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 69 63 6b n\&...TP.\fBtick
62d0: 65 74 5f 61 70 70 5f 64 61 74 61 5c 66 52 20 5c et_app_data\fR \
62e0: 66 49 62 69 6e 61 72 79 5f 73 74 72 69 6e 67 5c fIbinary_string\
62f0: 66 52 0a 55 6e 69 71 75 65 20 73 65 73 73 69 6f fR.Unique sessio
6300: 6e 20 74 69 63 6b 65 74 20 61 70 70 6c 69 63 61 n ticket applica
6310: 74 69 6f 6e 20 64 61 74 61 5c 26 2e 0a 2e 54 50 tion data\&...TP
6320: 0a 5c 66 42 6d 61 73 74 65 72 5f 6b 65 79 5c 66 .\fBmaster_key\f
6330: 52 20 5c 66 49 62 69 6e 61 72 79 5f 73 74 72 69 R \fIbinary_stri
6340: 6e 67 5c 66 52 0a 55 6e 69 71 75 65 20 73 65 73 ng\fR.Unique ses
6350: 73 69 6f 6e 20 6d 61 73 74 65 72 20 6b 65 79 5c sion master key\
6360: 26 2e 0a 2e 54 50 0a 5c 66 42 73 65 73 73 69 6f &...TP.\fBsessio
6370: 6e 5f 63 61 63 68 65 5f 6d 6f 64 65 5c 66 52 20 n_cache_mode\fR
6380: 5c 66 49 6d 6f 64 65 5c 66 52 0a 53 65 72 76 65 \fImode\fR.Serve
6390: 72 20 63 61 63 68 65 20 6d 6f 64 65 20 28 63 6c r cache mode (cl
63a0: 69 65 6e 74 2c 20 73 65 72 76 65 72 2c 20 6f 72 ient, server, or
63b0: 20 62 6f 74 68 29 5c 26 2e 0a 2e 52 45 0a 2e 54 both)\&...RE..T
63c0: 50 0a 5c 66 42 74 6c 73 3a 3a 63 69 70 68 65 72 P.\fBtls::cipher
63d0: 73 5c 66 52 20 3f 5c 66 49 70 72 6f 74 6f 63 6f s\fR ?\fIprotoco
63e0: 6c 5c 66 52 3f 20 3f 5c 66 49 76 65 72 62 6f 73 l\fR? ?\fIverbos
63f0: 65 5c 66 52 3f 20 3f 5c 66 49 73 75 70 70 6f 72 e\fR? ?\fIsuppor
6400: 74 65 64 5c 66 52 3f 0a 57 69 74 68 6f 75 74 20 ted\fR?.Without
6410: 61 6e 79 20 6f 70 74 69 6f 6e 73 2c 20 69 74 20 any options, it
6420: 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f returns a list o
6430: 66 20 61 6c 6c 20 73 79 6d 6d 65 74 72 69 63 20 f all symmetric
6440: 63 69 70 68 65 72 73 20 66 6f 72 20 75 73 65 20 ciphers for use
6450: 77 69 74 68 20 74 68 65 0a 5c 66 49 2d 63 69 70 with the.\fI-cip
6460: 68 65 72 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e her\fR option\&.
6470: 20 57 69 74 68 20 5c 66 49 70 72 6f 74 6f 63 6f With \fIprotoco
6480: 6c 5c 66 52 2c 20 6f 6e 6c 79 20 74 68 65 20 63 l\fR, only the c
6490: 69 70 68 65 72 73 20 73 75 70 70 6f 72 74 65 64 iphers supported
64a0: 20 66 6f 72 20 74 68 61 74 0a 70 72 6f 74 6f 63 for that.protoc
64b0: 6f 6c 20 61 72 65 20 72 65 74 75 72 6e 65 64 5c ol are returned\
64c0: 26 2e 20 53 65 65 20 74 68 65 20 5c 66 42 74 6c &. See the \fBtl
64d0: 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 20 s::protocols\fR
64e0: 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 65 20 command for the
64f0: 73 75 70 70 6f 72 74 65 64 0a 70 72 6f 74 6f 63 supported.protoc
6500: 6f 6c 73 5c 26 2e 20 49 66 20 5c 66 49 76 65 72 ols\&. If \fIver
6510: 62 6f 73 65 5c 66 52 20 69 73 20 73 70 65 63 69 bose\fR is speci
6520: 66 69 65 64 20 61 73 20 74 72 75 65 20 74 68 65 fied as true the
6530: 6e 20 61 20 76 65 72 62 6f 73 65 2c 20 68 75 6d n a verbose, hum
6540: 61 6e 20 72 65 61 64 61 62 6c 65 0a 6c 69 73 74 an readable.list
6550: 20 69 73 20 72 65 74 75 72 6e 65 64 20 77 69 74 is returned wit
6560: 68 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 h additional inf
6570: 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 ormation on the
6580: 63 69 70 68 65 72 5c 26 2e 20 49 66 20 5c 66 49 cipher\&. If \fI
6590: 73 75 70 70 6f 72 74 65 64 5c 66 52 0a 69 73 20 supported\fR.is
65a0: 73 70 65 63 69 66 69 65 64 20 61 73 20 74 72 75 specified as tru
65b0: 65 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 74 68 65 e, then only the
65c0: 20 63 69 70 68 65 72 73 20 73 75 70 70 6f 72 74 ciphers support
65d0: 65 64 20 66 6f 72 20 70 72 6f 74 6f 63 6f 6c 20 ed for protocol
65e0: 77 69 6c 6c 20 62 65 20 6c 69 73 74 65 64 5c 26 will be listed\&
65f0: 2e 0a 54 68 65 20 5c 66 49 73 75 70 70 6f 72 74 ..The \fIsupport
6600: 65 64 5c 66 52 20 61 72 67 20 69 73 20 6e 65 77 ed\fR arg is new
6610: 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c 26 2e for TclTLS 1\&.
6620: 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c 73 3a 8\&...TP.\fBtls:
6630: 3a 70 72 6f 74 6f 63 6f 6c 73 5c 66 52 0a 52 65 :protocols\fR.Re
6640: 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 turns a list of
6650: 74 68 65 20 73 75 70 70 6f 72 74 65 64 20 53 53 the supported SS
6660: 4c 2f 54 4c 53 20 70 72 6f 74 6f 63 6f 6c 73 5c L/TLS protocols\
6670: 26 2e 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 &. Valid values
6680: 61 72 65 3a 0a 5c 66 42 73 73 6c 32 5c 66 52 2c are:.\fBssl2\fR,
6690: 20 5c 66 42 73 73 6c 33 5c 66 52 2c 20 5c 66 42 \fBssl3\fR, \fB
66a0: 74 6c 73 31 5c 66 52 2c 20 5c 66 42 74 6c 73 31 tls1\fR, \fBtls1
66b0: 5c 26 2e 31 5c 66 52 2c 20 5c 66 42 74 6c 73 31 \&.1\fR, \fBtls1
66c0: 5c 26 2e 32 5c 66 52 2c 20 61 6e 64 0a 5c 66 42 \&.2\fR, and.\fB
66d0: 74 6c 73 31 5c 26 2e 33 5c 66 52 5c 26 2e 20 45 tls1\&.3\fR\&. E
66e0: 78 61 63 74 20 6c 69 73 74 20 64 65 70 65 6e 64 xact list depend
66f0: 73 20 6f 6e 20 4f 70 65 6e 53 53 4c 20 76 65 72 s on OpenSSL ver
6700: 73 69 6f 6e 20 61 6e 64 20 63 6f 6d 70 69 6c 65 sion and compile
6710: 20 74 69 6d 65 20 66 6c 61 67 73 5c 26 2e 0a 54 time flags\&..T
6720: 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 73 20 6e his command is n
6730: 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 31 5c ew for TclTLS 1\
6740: 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 42 74 6c &.8\&...TP.\fBtl
6750: 73 3a 3a 76 65 72 73 69 6f 6e 5c 66 52 0a 52 65 s::version\fR.Re
6760: 74 75 72 6e 73 20 74 68 65 20 4f 70 65 6e 53 53 turns the OpenSS
6770: 4c 20 76 65 72 73 69 6f 6e 20 73 74 72 69 6e 67 L version string
6780: 5c 26 2e 0a 2e 50 50 0a 2e 53 48 20 22 43 45 52 \&...PP..SH "CER
6790: 54 49 46 49 43 41 54 45 20 56 41 4c 49 44 41 54 TIFICATE VALIDAT
67a0: 49 4f 4e 22 0a 2e 53 53 20 22 50 4b 49 20 41 4e ION"..SS "PKI AN
67b0: 44 20 43 45 52 54 49 46 49 43 41 54 45 53 22 0a D CERTIFICATES".
67c0: 55 73 69 6e 67 20 74 68 65 20 50 75 62 6c 69 63 Using the Public
67d0: 20 4b 65 79 20 49 6e 66 72 61 73 74 72 75 63 74 Key Infrastruct
67e0: 75 72 65 20 28 50 4b 49 29 2c 20 65 61 63 68 20 ure (PKI), each
67f0: 75 73 65 72 20 63 72 65 61 74 65 73 20 61 20 70 user creates a p
6800: 72 69 76 61 74 65 20 6b 65 79 20 74 68 61 74 0a rivate key that.
6810: 6f 6e 6c 79 20 74 68 65 79 20 6b 6e 6f 77 20 61 only they know a
6820: 62 6f 75 74 20 61 6e 64 20 61 20 70 75 62 6c 69 bout and a publi
6830: 63 20 6b 65 79 20 74 68 65 79 20 63 61 6e 20 65 c key they can e
6840: 78 63 68 61 6e 67 65 20 77 69 74 68 20 6f 74 68 xchange with oth
6850: 65 72 73 20 66 6f 72 20 75 73 65 20 69 6e 0a 65 ers for use in.e
6860: 6e 63 72 79 70 74 69 6e 67 20 61 6e 64 20 64 65 ncrypting and de
6870: 63 72 79 70 74 69 6e 67 20 64 61 74 61 5c 26 2e crypting data\&.
6880: 20 54 68 65 20 70 72 6f 63 65 73 73 20 69 73 20 The process is
6890: 74 68 65 20 73 65 6e 64 65 72 20 65 6e 63 72 79 the sender encry
68a0: 70 74 73 20 74 68 65 69 72 20 64 61 74 61 0a 75 pts their data.u
68b0: 73 69 6e 67 20 74 68 65 69 72 20 70 72 69 76 61 sing their priva
68c0: 74 65 20 6b 65 79 20 61 6e 64 20 74 68 65 20 72 te key and the r
68d0: 65 63 65 69 76 65 72 27 73 20 70 75 62 6c 69 63 eceiver's public
68e0: 20 6b 65 79 5c 26 2e 20 54 68 65 20 64 61 74 61 key\&. The data
68f0: 20 69 73 20 74 68 65 6e 20 73 65 6e 74 0a 74 6f is then sent.to
6900: 20 74 68 65 20 72 65 63 65 69 76 65 72 5c 26 2e the receiver\&.
6910: 20 49 6e 20 61 20 73 69 6d 69 6c 61 72 20 6d 61 In a similar ma
6920: 6e 6e 65 72 2c 20 74 68 65 20 72 65 63 65 69 76 nner, the receiv
6930: 65 72 20 75 73 65 73 20 74 68 65 69 72 20 70 72 er uses their pr
6940: 69 76 61 74 65 20 6b 65 79 20 61 6e 64 0a 74 68 ivate key and.th
6950: 65 20 73 65 6e 64 65 72 27 73 20 70 75 62 6c 69 e sender's publi
6960: 63 20 6b 65 79 20 74 6f 20 64 65 63 72 79 70 74 c key to decrypt
6970: 20 74 68 65 20 64 61 74 61 5c 26 2e 20 54 68 69 the data\&. Thi
6980: 73 20 70 72 6f 76 69 64 65 73 20 64 61 74 61 20 s provides data
6990: 69 6e 74 65 67 72 69 74 79 2c 20 74 6f 0a 65 6e integrity, to.en
69a0: 73 75 72 65 20 74 68 65 20 64 61 74 61 20 63 61 sure the data ca
69b0: 6e 27 74 20 62 65 20 76 69 65 77 65 64 20 6f 72 n't be viewed or
69c0: 20 61 6c 74 65 72 65 64 20 64 75 72 69 6e 67 20 altered during
69d0: 74 72 61 6e 73 70 6f 72 74 5c 26 2e 20 53 65 65 transport\&. See
69e0: 20 74 68 65 0a 5c 66 42 2d 6b 65 79 5c 66 52 20 the.\fB-key\fR
69f0: 61 6e 64 20 5c 66 42 2d 6b 65 79 66 69 6c 65 5c and \fB-keyfile\
6a00: 66 52 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 68 fR options for h
6a10: 6f 77 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 ow to specify th
6a20: 65 20 70 72 69 76 61 74 65 20 6b 65 79 5c 26 2e e private key\&.
6a30: 0a 41 6c 73 6f 20 73 65 65 20 74 68 65 20 5c 66 .Also see the \f
6a40: 42 2d 70 61 73 73 77 6f 72 64 5c 66 52 20 6f 70 B-password\fR op
6a50: 74 69 6f 6e 20 66 6f 72 20 68 6f 77 20 74 6f 20 tion for how to
6a60: 70 72 6f 76 69 64 65 20 74 68 65 20 70 61 73 73 provide the pass
6a70: 77 6f 72 64 5c 26 2e 0a 2e 50 50 0a 49 6e 20 6f word\&...PP.In o
6a80: 72 64 65 72 20 74 6f 20 70 72 6f 76 69 64 65 20 rder to provide
6a90: 61 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 2c 20 authentication,
6aa0: 69 5c 26 2e 65 5c 26 2e 20 65 6e 73 75 72 69 6e i\&.e\&. ensurin
6ab0: 67 20 73 6f 6d 65 6f 6e 65 20 69 73 20 77 68 6f g someone is who
6ac0: 20 74 68 65 79 20 73 61 79 20 74 68 65 79 0a 61 they say they.a
6ad0: 72 65 2c 20 74 68 65 20 70 75 62 6c 69 63 20 6b re, the public k
6ae0: 65 79 20 61 6e 64 20 75 73 65 72 20 69 64 65 6e ey and user iden
6af0: 74 69 66 69 63 61 74 69 6f 6e 20 69 6e 66 6f 20 tification info
6b00: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 58 is stored in a X
6b10: 5c 26 2e 35 30 39 0a 63 65 72 74 69 66 69 63 61 \&.509.certifica
6b20: 74 65 20 61 6e 64 20 74 68 61 74 20 63 65 72 74 te and that cert
6b30: 69 66 69 63 61 74 65 20 69 73 20 61 75 74 68 65 ificate is authe
6b40: 6e 74 69 63 61 74 65 64 20 28 69 5c 26 2e 65 5c nticated (i\&.e\
6b50: 26 2e 20 73 69 67 6e 65 64 29 20 62 79 20 61 20 &. signed) by a
6b60: 43 65 72 74 69 66 69 63 61 74 65 0a 41 75 74 68 Certificate.Auth
6b70: 6f 72 69 74 79 20 28 43 41 29 5c 26 2e 20 55 73 ority (CA)\&. Us
6b80: 65 72 73 20 63 61 6e 20 74 68 65 6e 20 65 78 63 ers can then exc
6b90: 68 61 6e 67 65 20 74 68 65 73 65 20 63 65 72 74 hange these cert
6ba0: 69 66 69 63 61 74 65 73 20 64 75 72 69 6e 67 20 ificates during
6bb0: 74 68 65 20 54 4c 53 0a 69 6e 69 74 69 61 6c 69 the TLS.initiali
6bc0: 7a 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 61 zation process a
6bd0: 6e 64 20 63 68 65 63 6b 20 74 68 65 6d 20 61 67 nd check them ag
6be0: 61 69 6e 73 74 20 74 68 65 20 72 6f 6f 74 20 43 ainst the root C
6bf0: 41 20 63 65 72 74 69 66 69 63 61 74 65 73 20 74 A certificates t
6c00: 6f 20 65 6e 73 75 72 65 0a 74 68 65 79 20 61 72 o ensure.they ar
6c10: 65 20 76 61 6c 69 64 5c 26 2e 20 54 68 69 73 20 e valid\&. This
6c20: 69 73 20 68 61 6e 64 6c 65 64 20 62 79 20 4f 70 is handled by Op
6c30: 65 6e 53 53 4c 20 76 69 61 20 74 68 65 20 5c 66 enSSL via the \f
6c40: 42 2d 72 65 71 75 65 73 74 5c 66 52 20 61 6e 64 B-request\fR and
6c50: 0a 5c 66 42 2d 72 65 71 75 69 72 65 5c 66 52 20 .\fB-require\fR
6c60: 6f 70 74 69 6f 6e 73 5c 26 2e 20 53 65 65 20 74 options\&. See t
6c70: 68 65 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c he \fB-cadir\fR,
6c80: 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 61 \fB-cadir\fR, a
6c90: 6e 64 0a 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 nd.\fB-castore\f
6ca0: 52 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 68 6f R options for ho
6cb0: 77 20 74 6f 20 73 70 65 63 69 66 79 20 77 68 65 w to specify whe
6cc0: 72 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 43 re to find the C
6cd0: 41 20 63 65 72 74 69 66 69 63 61 74 65 73 5c 26 A certificates\&
6ce0: 2e 0a 4f 70 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e ..Optionally, in
6cf0: 20 61 20 66 75 74 75 72 65 20 72 65 6c 65 61 73 a future releas
6d00: 65 2c 20 74 68 65 79 20 63 61 6e 20 61 6c 73 6f e, they can also
6d10: 20 62 65 20 63 68 65 63 6b 65 64 20 61 67 61 69 be checked agai
6d20: 6e 73 74 20 74 68 65 20 43 65 72 74 69 66 69 63 nst the Certific
6d30: 61 74 65 0a 52 65 76 6f 63 61 74 69 6f 6e 20 4c ate.Revocation L
6d40: 69 73 74 20 28 43 52 4c 29 20 6f 66 20 72 65 76 ist (CRL) of rev
6d50: 6f 6b 65 64 20 63 65 72 74 69 66 69 63 61 74 65 oked certificate
6d60: 73 5c 26 2e 20 43 65 72 74 69 66 69 63 61 74 65 s\&. Certificate
6d70: 73 20 63 61 6e 20 61 6c 73 6f 20 62 65 0a 73 65 s can also be.se
6d80: 6c 66 2d 73 69 67 6e 65 64 2c 20 62 75 74 20 74 lf-signed, but t
6d90: 68 65 79 20 61 72 65 20 62 79 20 64 65 66 61 75 hey are by defau
6da0: 6c 74 20 6e 6f 74 20 74 72 75 73 74 65 64 20 75 lt not trusted u
6db0: 6e 6c 65 73 73 20 79 6f 75 20 61 64 64 20 74 68 nless you add th
6dc0: 65 6d 20 74 6f 20 79 6f 75 72 0a 63 65 72 74 69 em to your.certi
6dd0: 66 69 63 61 74 65 20 73 74 6f 72 65 5c 26 2e 0a ficate store\&..
6de0: 2e 50 50 0a 54 79 70 69 63 61 6c 6c 79 20 77 68 .PP.Typically wh
6df0: 65 6e 20 76 69 73 69 74 69 6e 67 20 77 65 62 20 en visiting web
6e00: 73 69 74 65 73 2c 20 6f 6e 6c 79 20 74 68 65 20 sites, only the
6e10: 63 6c 69 65 6e 74 20 6e 65 65 64 73 20 74 6f 20 client needs to
6e20: 63 68 65 63 6b 20 74 68 65 20 73 65 72 76 65 72 check the server
6e30: 27 73 0a 63 65 72 74 69 66 69 63 61 74 65 20 74 's.certificate t
6e40: 6f 20 65 6e 73 75 72 65 20 69 74 20 69 73 20 76 o ensure it is v
6e50: 61 6c 69 64 5c 26 2e 20 54 68 65 20 73 65 72 76 alid\&. The serv
6e60: 65 72 20 64 6f 65 73 6e 27 74 20 6e 65 65 64 20 er doesn't need
6e70: 74 6f 20 63 68 65 63 6b 20 74 68 65 20 63 6c 69 to check the cli
6e80: 65 6e 74 0a 63 65 72 74 69 66 69 63 61 74 65 20 ent.certificate
6e90: 75 6e 6c 65 73 73 20 79 6f 75 20 6e 65 65 64 20 unless you need
6ea0: 74 6f 20 61 75 74 68 65 6e 74 69 63 61 74 65 20 to authenticate
6eb0: 77 69 74 68 20 74 68 65 6d 20 74 6f 20 6c 6f 67 with them to log
6ec0: 69 6e 2c 20 65 74 63 5c 26 2e 20 53 65 65 20 74 in, etc\&. See t
6ed0: 68 65 0a 5c 66 42 2d 63 65 72 74 5c 66 52 20 61 he.\fB-cert\fR a
6ee0: 6e 64 20 5c 66 42 2d 63 65 72 74 66 69 6c 65 5c nd \fB-certfile\
6ef0: 66 52 20 6f 70 74 69 6f 6e 73 20 69 66 20 79 6f fR options if yo
6f00: 75 20 6e 65 65 64 20 74 6f 20 70 72 6f 76 69 64 u need to provid
6f10: 65 20 61 20 63 65 72 74 69 66 69 63 61 74 65 5c e a certificate\
6f20: 26 2e 0a 2e 53 53 20 22 53 55 4d 4d 41 52 59 20 &...SS "SUMMARY
6f30: 4f 46 20 43 4f 4d 4d 41 4e 44 20 4c 49 4e 45 20 OF COMMAND LINE
6f40: 4f 50 54 49 4f 4e 53 22 0a 54 68 65 20 66 6f 6c OPTIONS".The fol
6f50: 6c 6f 77 69 6e 67 20 6f 70 74 69 6f 6e 73 20 61 lowing options a
6f60: 72 65 20 75 73 65 64 20 66 6f 72 20 70 65 65 72 re used for peer
6f70: 20 63 65 72 74 69 66 69 63 61 74 65 20 76 61 6c certificate val
6f80: 69 64 61 74 69 6f 6e 3a 0a 2e 54 50 0a 5c 66 42 idation:..TP.\fB
6f90: 2d 63 61 64 69 72 5c 66 52 20 5c 66 49 64 69 72 -cadir\fR \fIdir
6fa0: 65 63 74 6f 72 79 5c 66 52 0a 53 70 65 63 69 66 ectory\fR.Specif
6fb0: 69 65 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 ies the director
6fc0: 79 20 77 68 65 72 65 20 74 68 65 20 43 65 72 74 y where the Cert
6fd0: 69 66 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 ificate Authorit
6fe0: 79 20 28 43 41 29 20 63 65 72 74 69 66 69 63 61 y (CA) certifica
6ff0: 74 65 73 20 61 72 65 0a 73 74 6f 72 65 64 5c 26 tes are.stored\&
7000: 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 . The default is
7010: 20 70 6c 61 74 66 6f 72 6d 20 73 70 65 63 69 66 platform specif
7020: 69 63 2c 20 62 75 74 20 69 73 20 75 73 75 61 6c ic, but is usual
7030: 6c 79 20 22 5c 66 49 2f 65 74 63 2f 73 73 6c 2f ly "\fI/etc/ssl/
7040: 63 65 72 74 73 5c 66 52 22 20 6f 6e 0a 4c 69 6e certs\fR" on.Lin
7050: 75 78 2f 55 6e 69 78 20 73 79 73 74 65 6d 73 5c ux/Unix systems\
7060: 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 6c &. The default l
7070: 6f 63 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 6f ocation can be o
7080: 76 65 72 72 69 64 64 65 6e 20 62 79 20 74 68 65 verridden by the
7090: 0a 5c 66 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 .\fBSSL_CERT_DIR
70a0: 5c 66 52 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 \fR environment
70b0: 76 61 72 69 61 62 6c 65 5c 26 2e 0a 2e 54 50 0a variable\&...TP.
70c0: 5c 66 42 2d 63 61 66 69 6c 65 5c 66 52 20 5c 66 \fB-cafile\fR \f
70d0: 49 66 69 6c 65 6e 61 6d 65 5c 66 52 0a 53 70 65 Ifilename\fR.Spe
70e0: 63 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 20 cifies the file
70f0: 77 69 74 68 20 74 68 65 20 43 65 72 74 69 66 69 with the Certifi
7100: 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 28 cate Authority (
7110: 43 41 29 20 63 65 72 74 69 66 69 63 61 74 65 73 CA) certificates
7120: 20 74 6f 20 75 73 65 20 69 6e 0a 5c 66 42 50 45 to use in.\fBPE
7130: 4d 5c 66 52 20 66 69 6c 65 20 66 6f 72 6d 61 74 M\fR file format
7140: 5c 26 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 \&. The default
7150: 69 73 20 22 5c 66 49 63 65 72 74 5c 26 2e 70 65 is "\fIcert\&.pe
7160: 6d 5c 66 52 22 2c 20 69 6e 20 74 68 65 20 4f 70 m\fR", in the Op
7170: 65 6e 53 53 4c 0a 64 69 72 65 63 74 6f 72 79 5c enSSL.directory\
7180: 26 2e 20 4f 6e 20 4c 69 6e 75 78 2f 55 6e 69 78 &. On Linux/Unix
7190: 20 73 79 73 74 65 6d 73 2c 20 74 68 69 73 20 69 systems, this i
71a0: 73 20 75 73 75 61 6c 6c 79 20 22 5c 66 49 2f 65 s usually "\fI/e
71b0: 74 63 2f 73 73 6c 2f 63 61 2d 62 75 6e 64 6c 65 tc/ssl/ca-bundle
71c0: 5c 26 2e 70 65 6d 5c 66 52 22 5c 26 2e 0a 54 68 \&.pem\fR"\&..Th
71d0: 65 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 63 e default file c
71e0: 61 6e 20 62 65 20 6f 76 65 72 72 69 64 64 65 6e an be overridden
71f0: 20 62 79 20 74 68 65 20 5c 66 42 53 53 4c 5f 43 by the \fBSSL_C
7200: 45 52 54 5f 46 49 4c 45 5c 66 52 20 65 6e 76 69 ERT_FILE\fR envi
7210: 72 6f 6e 6d 65 6e 74 0a 76 61 72 69 61 62 6c 65 ronment.variable
7220: 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 63 61 73 74 \&...TP.\fB-cast
7230: 6f 72 65 5c 66 52 20 5c 66 49 55 52 49 5c 66 52 ore\fR \fIURI\fR
7240: 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 55 .Specifies the U
7250: 6e 69 66 6f 72 6d 20 52 65 73 6f 75 72 63 65 20 niform Resource
7260: 49 64 65 6e 74 69 66 69 65 72 20 28 55 52 49 29 Identifier (URI)
7270: 20 66 6f 72 20 74 68 65 20 43 65 72 74 69 66 69 for the Certifi
7280: 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 0a 28 cate Authority.(
7290: 43 41 29 20 73 74 6f 72 65 2c 20 77 68 69 63 68 CA) store, which
72a0: 20 6d 61 79 20 62 65 20 61 20 73 69 6e 67 6c 65 may be a single
72b0: 20 63 6f 6e 74 61 69 6e 65 72 20 6f 72 20 61 20 container or a
72c0: 63 61 74 61 6c 6f 67 20 6f 66 20 63 6f 6e 74 61 catalog of conta
72d0: 69 6e 65 72 73 5c 26 2e 0a 53 74 61 72 74 69 6e iners\&..Startin
72e0: 67 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 33 g with OpenSSL 3
72f0: 5c 26 2e 32 20 6f 6e 20 4d 53 20 57 69 6e 64 6f \&.2 on MS Windo
7300: 77 73 2c 20 73 65 74 20 74 6f 20 22 5c 66 42 6f ws, set to "\fBo
7310: 72 67 5c 26 2e 6f 70 65 6e 73 73 6c 5c 26 2e 77 rg\&.openssl\&.w
7320: 69 6e 73 74 6f 72 65 3a 2f 2f 5c 66 52 22 0a 74 instore://\fR".t
7330: 6f 20 75 73 65 20 74 68 65 20 62 75 69 6c 74 2d o use the built-
7340: 69 6e 20 4d 53 20 57 69 6e 64 6f 77 73 20 43 65 in MS Windows Ce
7350: 72 74 69 66 69 63 61 74 65 20 53 74 6f 72 65 5c rtificate Store\
7360: 26 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 &. Starting in T
7370: 63 6c 54 4c 53 20 32 5c 26 2e 30 2c 20 74 68 69 clTLS 2\&.0, thi
7380: 73 0a 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 s.is the default
7390: 20 69 66 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 if \fB-cadir\fR
73a0: 2c 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 , \fB-cadir\fR,
73b0: 61 6e 64 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c and \fB-castore\
73c0: 66 52 20 61 72 65 0a 6e 6f 74 20 73 70 65 63 69 fR are.not speci
73d0: 66 69 65 64 5c 26 2e 20 54 68 69 73 20 73 74 6f fied\&. This sto
73e0: 72 65 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 73 re only supports
73f0: 20 72 6f 6f 74 20 63 65 72 74 69 66 69 63 61 74 root certificat
7400: 65 20 73 74 6f 72 65 73 5c 26 2e 0a 2e 54 50 0a e stores\&...TP.
7410: 5c 66 42 2d 72 65 71 75 65 73 74 5c 66 52 20 5c \fB-request\fR \
7420: 66 49 62 6f 6f 6c 5c 66 52 0a 52 65 71 75 65 73 fIbool\fR.Reques
7430: 74 20 61 20 63 65 72 74 69 66 69 63 61 74 65 20 t a certificate
7440: 66 72 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 from the peer du
7450: 72 69 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e ring the SSL han
7460: 64 73 68 61 6b 65 5c 26 2e 20 54 68 69 73 20 69 dshake\&. This i
7470: 73 20 6e 65 65 64 65 64 0a 74 6f 20 64 6f 20 43 s needed.to do C
7480: 65 72 74 69 66 69 63 61 74 65 20 56 61 6c 69 64 ertificate Valid
7490: 61 74 69 6f 6e 5c 26 2e 20 53 74 61 72 74 69 6e ation\&. Startin
74a0: 67 20 69 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e g in TclTLS 1\&.
74b0: 38 2c 20 74 68 65 20 64 65 66 61 75 6c 74 20 69 8, the default i
74c0: 73 0a 5c 66 42 74 72 75 65 5c 66 52 20 66 6f 72 s.\fBtrue\fR for
74d0: 20 63 6c 69 65 6e 74 20 63 6f 6e 6e 65 63 74 69 client connecti
74e0: 6f 6e 73 5c 26 2e 20 53 74 61 72 74 69 6e 67 20 ons\&. Starting
74f0: 69 6e 20 54 63 6c 54 4c 53 20 32 5c 26 2e 30 2c in TclTLS 2\&.0,
7500: 20 69 66 20 73 65 74 20 74 6f 0a 5c 66 42 66 61 if set to.\fBfa
7510: 6c 73 65 5c 66 52 20 61 6e 64 20 5c 66 42 2d 72 lse\fR and \fB-r
7520: 65 71 75 69 72 65 5c 66 52 20 69 73 20 5c 66 42 equire\fR is \fB
7530: 74 72 75 65 5c 66 52 2c 20 74 68 65 6e 20 74 68 true\fR, then th
7540: 69 73 20 77 69 6c 6c 20 62 65 0a 6f 76 65 72 72 is will be.overr
7550: 69 64 64 65 6e 20 74 6f 20 5c 66 42 74 72 75 65 idden to \fBtrue
7560: 5c 66 52 5c 26 2e 20 49 6e 20 61 64 64 69 74 69 \fR\&. In additi
7570: 6f 6e 2c 20 74 68 65 20 63 6c 69 65 6e 74 20 63 on, the client c
7580: 61 6e 20 6d 61 6e 75 61 6c 6c 79 20 69 6e 73 70 an manually insp
7590: 65 63 74 20 61 6e 64 0a 61 63 63 65 70 74 20 6f ect and.accept o
75a0: 72 20 72 65 6a 65 63 74 20 65 61 63 68 20 63 65 r reject each ce
75b0: 72 74 69 66 69 63 61 74 65 20 75 73 69 6e 67 20 rtificate using
75c0: 74 68 65 20 5c 66 42 2d 76 61 6c 69 64 61 74 65 the \fB-validate
75d0: 63 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f command\fR optio
75e0: 6e 5c 26 2e 0a 2e 54 50 0a 5c 66 42 2d 72 65 71 n\&...TP.\fB-req
75f0: 75 69 72 65 5c 66 52 20 5c 66 49 62 6f 6f 6c 5c uire\fR \fIbool\
7600: 66 52 0a 52 65 71 75 69 72 65 20 61 20 76 61 6c fR.Require a val
7610: 69 64 20 63 65 72 74 69 66 69 63 61 74 65 20 66 id certificate f
7620: 72 6f 6d 20 74 68 65 20 70 65 65 72 20 64 75 72 rom the peer dur
7630: 69 6e 67 20 74 68 65 20 53 53 4c 20 68 61 6e 64 ing the SSL hand
7640: 73 68 61 6b 65 5c 26 2e 20 49 66 20 74 68 69 73 shake\&. If this
7650: 20 69 73 0a 73 65 74 20 74 6f 20 74 72 75 65 2c is.set to true,
7660: 20 74 68 65 6e 20 5c 66 42 2d 72 65 71 75 65 73 then \fB-reques
7670: 74 5c 66 52 20 6d 75 73 74 20 61 6c 73 6f 20 62 t\fR must also b
7680: 65 20 73 65 74 20 74 6f 20 74 72 75 65 20 61 6e e set to true an
7690: 64 20 61 20 65 69 74 68 65 72 0a 5c 66 42 2d 63 d a either.\fB-c
76a0: 61 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 61 66 adir\fR, \fB-caf
76b0: 69 6c 65 5c 66 52 2c 20 5c 66 42 2d 63 61 73 74 ile\fR, \fB-cast
76c0: 6f 72 65 5c 66 52 2c 20 6f 72 20 61 20 70 6c 61 ore\fR, or a pla
76d0: 74 66 6f 72 6d 20 64 65 66 61 75 6c 74 0a 6d 75 tform default.mu
76e0: 73 74 20 62 65 20 70 72 6f 76 69 64 65 64 20 69 st be provided i
76f0: 6e 20 6f 72 64 65 72 20 74 6f 20 76 61 6c 69 64 n order to valid
7700: 61 74 65 20 61 67 61 69 6e 73 74 5c 26 2e 20 54 ate against\&. T
7710: 68 65 20 64 65 66 61 75 6c 74 20 69 6e 20 54 63 he default in Tc
7720: 6c 54 4c 53 20 31 5c 26 2e 38 20 61 6e 64 0a 65 lTLS 1\&.8 and.e
7730: 61 72 6c 69 65 72 20 76 65 72 73 69 6f 6e 73 20 arlier versions
7740: 69 73 20 5c 66 42 66 61 6c 73 65 5c 66 52 20 73 is \fBfalse\fR s
7750: 69 6e 63 65 20 6e 6f 74 20 61 6c 6c 20 70 6c 61 ince not all pla
7760: 74 66 6f 72 6d 73 20 68 61 76 65 20 63 65 72 74 tforms have cert
7770: 69 66 69 63 61 74 65 73 20 74 6f 0a 76 61 6c 69 ificates to.vali
7780: 64 61 74 65 20 61 67 61 69 6e 73 74 20 69 6e 20 date against in
7790: 61 20 66 6f 72 6d 20 63 6f 6d 70 61 74 69 62 6c a form compatibl
77a0: 65 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 5c 26 e with OpenSSL\&
77b0: 2e 20 53 74 61 72 74 69 6e 67 20 69 6e 20 54 63 . Starting in Tc
77c0: 6c 54 4c 53 20 32 5c 26 2e 30 2c 0a 74 68 65 20 lTLS 2\&.0,.the
77d0: 64 65 66 61 75 6c 74 20 69 73 20 5c 66 42 74 72 default is \fBtr
77e0: 75 65 5c 66 52 20 66 6f 72 20 63 6c 69 65 6e 74 ue\fR for client
77f0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 5c 26 2e 0a connections\&..
7800: 2e 50 50 0a 2e 53 53 20 22 57 48 45 4e 20 41 52 .PP..SS "WHEN AR
7810: 45 20 43 4f 4d 4d 41 4e 44 20 4c 49 4e 45 20 4f E COMMAND LINE O
7820: 50 54 49 4f 4e 53 20 4e 45 45 44 45 44 3f 22 0a PTIONS NEEDED?".
7830: 49 6e 20 54 63 6c 54 4c 53 20 31 5c 26 2e 38 20 In TclTLS 1\&.8
7840: 61 6e 64 20 65 61 72 6c 69 65 72 20 76 65 72 73 and earlier vers
7850: 69 6f 6e 73 2c 20 63 65 72 74 69 66 69 63 61 74 ions, certificat
7860: 65 20 76 61 6c 69 64 61 74 69 6f 6e 20 69 73 0a e validation is.
7870: 5c 66 49 4e 4f 54 5c 66 52 20 65 6e 61 62 6c 65 \fINOT\fR enable
7880: 64 20 62 79 20 64 65 66 61 75 6c 74 5c 26 2e 20 d by default\&.
7890: 54 68 69 73 20 6c 69 6d 69 74 61 74 69 6f 6e 20 This limitation
78a0: 69 73 20 64 75 65 20 74 6f 20 74 68 65 20 6c 61 is due to the la
78b0: 63 6b 20 6f 66 20 61 20 63 6f 6d 6d 6f 6e 0a 63 ck of a common.c
78c0: 72 6f 73 73 20 70 6c 61 74 66 6f 72 6d 20 64 61 ross platform da
78d0: 74 61 62 61 73 65 20 6f 66 20 43 65 72 74 69 66 tabase of Certif
78e0: 69 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 icate Authority
78f0: 28 43 41 29 20 70 72 6f 76 69 64 65 64 20 63 65 (CA) provided ce
7900: 72 74 69 66 69 63 61 74 65 73 20 74 6f 0a 76 61 rtificates to.va
7910: 6c 69 64 61 74 65 20 61 67 61 69 6e 73 74 5c 26 lidate against\&
7920: 2e 20 4d 61 6e 79 20 4c 69 6e 75 78 20 73 79 73 . Many Linux sys
7930: 74 65 6d 73 20 6e 61 74 69 76 65 6c 79 20 73 75 tems natively su
7940: 70 70 6f 72 74 20 4f 70 65 6e 53 53 4c 20 61 6e pport OpenSSL an
7950: 64 20 74 68 75 73 20 68 61 76 65 0a 74 68 65 73 d thus have.thes
7960: 65 20 63 65 72 74 69 66 69 63 61 74 65 73 20 69 e certificates i
7970: 6e 73 74 61 6c 6c 65 64 20 61 73 20 70 61 72 74 nstalled as part
7980: 20 6f 66 20 74 68 65 20 4f 53 2c 20 62 75 74 20 of the OS, but
7990: 4d 61 63 4f 53 20 61 6e 64 20 4d 53 20 57 69 6e MacOS and MS Win
79a0: 64 6f 77 73 20 64 6f 20 6e 6f 74 5c 26 2e 0a 53 dows do not\&..S
79b0: 74 61 72 69 6e 67 20 69 6e 20 54 63 6c 54 4c 53 taring in TclTLS
79c0: 20 32 5c 26 2e 30 2c 20 74 68 65 20 64 65 66 61 2\&.0, the defa
79d0: 75 6c 74 20 66 6f 72 20 63 6c 69 65 6e 74 20 63 ult for client c
79e0: 6f 6e 6e 65 63 74 69 6f 6e 73 20 68 61 73 20 62 onnections has b
79f0: 65 65 6e 20 63 68 61 6e 67 65 64 20 74 6f 0a 72 een changed to.r
7a00: 65 71 75 69 72 65 20 63 65 72 74 69 66 69 63 61 equire certifica
7a10: 74 65 20 76 61 6c 69 64 61 74 69 6f 6e 20 62 79 te validation by
7a20: 20 64 65 66 61 75 6c 74 5c 26 2e 20 49 6e 20 6f default\&. In o
7a30: 72 64 65 72 20 74 6f 20 75 73 65 20 74 68 65 20 rder to use the
7a40: 5c 66 42 2d 72 65 71 75 69 72 65 5c 66 52 0a 6f \fB-require\fR.o
7a50: 70 74 69 6f 6e 2c 20 6f 6e 65 20 6f 66 20 74 68 ption, one of th
7a60: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 75 73 74 e following must
7a70: 20 62 65 20 74 72 75 65 3a 0a 2e 49 50 20 5c 28 be true:..IP \(
7a80: 62 75 0a 4f 6e 20 4c 69 6e 75 78 20 61 6e 64 20 bu.On Linux and
7a90: 55 6e 69 78 20 73 79 73 74 65 6d 73 20 77 69 74 Unix systems wit
7aa0: 68 20 4f 70 65 6e 53 53 4c 20 61 6c 72 65 61 64 h OpenSSL alread
7ab0: 79 20 69 6e 73 74 61 6c 6c 65 64 20 6f 72 20 69 y installed or i
7ac0: 66 20 74 68 65 20 43 41 0a 63 65 72 74 69 66 69 f the CA.certifi
7ad0: 63 61 74 65 73 20 61 72 65 20 61 76 61 69 6c 61 cates are availa
7ae0: 62 6c 65 20 69 6e 20 50 45 4d 20 66 6f 72 6d 61 ble in PEM forma
7af0: 74 2c 20 61 6e 64 20 69 66 20 74 68 65 79 20 61 t, and if they a
7b00: 72 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 re stored in the
7b10: 0a 73 74 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 .standard locati
7b20: 6f 6e 73 2c 20 6f 72 20 69 66 20 74 68 65 20 5c ons, or if the \
7b30: 66 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 5c 66 fBSSL_CERT_DIR\f
7b40: 52 20 6f 72 20 5c 66 42 53 53 4c 5f 43 45 52 54 R or \fBSSL_CERT
7b50: 5f 46 49 4c 45 5c 66 52 0a 65 6e 76 69 72 6f 6e _FILE\fR.environ
7b60: 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 61 ment variables a
7b70: 72 65 20 73 65 74 2c 20 74 68 65 6e 20 5c 66 42 re set, then \fB
7b80: 2d 63 61 64 69 72 5c 66 52 2c 20 5c 66 42 2d 63 -cadir\fR, \fB-c
7b90: 61 64 69 72 5c 66 52 2c 0a 61 6e 64 20 5c 66 42 adir\fR,.and \fB
7ba0: 2d 63 61 73 74 6f 72 65 5c 66 52 20 61 72 65 6e -castore\fR aren
7bb0: 27 74 20 6e 65 65 64 65 64 5c 26 2e 0a 2e 49 50 't needed\&...IP
7bc0: 20 5c 28 62 75 0a 49 66 20 4f 70 65 6e 53 53 4c \(bu.If OpenSSL
7bd0: 20 69 73 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65 is not installe
7be0: 64 20 69 6e 20 74 68 65 20 64 65 66 61 75 6c 74 d in the default
7bf0: 20 6c 6f 63 61 74 69 6f 6e 2c 20 6f 72 20 77 68 location, or wh
7c00: 65 6e 20 75 73 69 6e 67 20 4d 61 63 20 4f 53 0a en using Mac OS.
7c10: 6f 72 20 4d 53 20 57 69 6e 64 6f 77 73 20 61 6e or MS Windows an
7c20: 64 20 4f 70 65 6e 53 53 4c 20 69 73 20 69 6e 73 d OpenSSL is ins
7c30: 74 61 6c 6c 65 64 2c 20 74 68 65 20 5c 66 42 53 talled, the \fBS
7c40: 53 4c 5f 43 45 52 54 5f 44 49 52 5c 66 52 20 61 SL_CERT_DIR\fR a
7c50: 6e 64 2f 6f 72 0a 5c 66 42 53 53 4c 5f 43 45 52 nd/or.\fBSSL_CER
7c60: 54 5f 46 49 4c 45 5c 66 52 20 65 6e 76 69 72 6f T_FILE\fR enviro
7c70: 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c 65 73 20 nment variables
7c80: 6f 72 20 74 68 65 20 6f 6e 65 20 6f 66 20 74 68 or the one of th
7c90: 65 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 0a e \fB-cadir\fR,.
7ca0: 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 6f 72 \fB-cadir\fR, or
7cb0: 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 \fB-castore\fR
7cc0: 6f 70 74 69 6f 6e 73 20 6d 75 73 74 20 62 65 20 options must be
7cd0: 64 65 66 69 6e 65 64 5c 26 2e 0a 2e 49 50 20 5c defined\&...IP \
7ce0: 28 62 75 0a 4f 6e 20 4d 53 20 57 69 6e 64 6f 77 (bu.On MS Window
7cf0: 73 2c 20 73 74 61 72 74 69 6e 67 20 69 6e 20 4f s, starting in O
7d00: 70 65 6e 53 53 4c 20 33 5c 26 2e 32 2c 20 69 74 penSSL 3\&.2, it
7d10: 20 69 73 20 6e 6f 77 20 70 6f 73 73 69 62 6c 65 is now possible
7d20: 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 0a 62 to access the.b
7d30: 75 69 6c 74 2d 69 6e 20 57 69 6e 64 6f 77 73 20 uilt-in Windows
7d40: 43 65 72 74 69 66 69 63 61 74 65 20 53 74 6f 72 Certificate Stor
7d50: 65 20 66 72 6f 6d 20 4f 70 65 6e 53 53 4c 5c 26 e from OpenSSL\&
7d60: 2e 20 54 68 69 73 20 63 61 6e 20 75 74 69 6c 69 . This can utili
7d70: 7a 65 64 20 62 79 0a 73 65 74 74 69 6e 67 20 74 zed by.setting t
7d80: 68 65 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 he \fB-castore\f
7d90: 52 20 6f 70 74 69 6f 6e 20 74 6f 20 22 5c 66 42 R option to "\fB
7da0: 6f 72 67 5c 26 2e 6f 70 65 6e 73 73 6c 5c 26 2e org\&.openssl\&.
7db0: 77 69 6e 73 74 6f 72 65 3a 2f 2f 5c 66 52 22 5c winstore://\fR"\
7dc0: 26 2e 0a 49 6e 20 54 63 6c 54 4c 53 20 32 5c 26 &..In TclTLS 2\&
7dd0: 2e 30 2c 20 74 68 69 73 20 69 73 20 74 68 65 20 .0, this is the
7de0: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 66 default value if
7df0: 20 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 0a 5c \fB-cadir\fR,.\
7e00: 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 61 6e 64 fB-cadir\fR, and
7e10: 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 \fB-castore\fR
7e20: 61 72 65 20 6e 6f 74 20 73 70 65 63 69 66 69 65 are not specifie
7e30: 64 5c 26 2e 0a 2e 49 50 20 5c 28 62 75 0a 49 66 d\&...IP \(bu.If
7e40: 20 4f 70 65 6e 53 53 4c 20 69 73 20 6e 6f 74 20 OpenSSL is not
7e50: 69 6e 73 74 61 6c 6c 65 64 20 6f 72 20 74 68 65 installed or the
7e60: 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 73 CA certificates
7e70: 20 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 are not availab
7e80: 6c 65 20 69 6e 20 50 45 4d 0a 66 6f 72 6d 61 74 le in PEM.format
7e90: 2c 20 74 68 65 20 43 41 20 63 65 72 74 69 66 69 , the CA certifi
7ea0: 63 61 74 65 73 20 6d 75 73 74 20 62 65 20 64 6f cates must be do
7eb0: 77 6e 6c 6f 61 64 65 64 20 61 6e 64 20 69 6e 73 wnloaded and ins
7ec0: 74 61 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 talled with the
7ed0: 75 73 65 72 0a 73 6f 66 74 77 61 72 65 5c 26 2e user.software\&.
7ee0: 20 54 68 65 20 43 55 52 4c 20 74 65 61 6d 20 6d The CURL team m
7ef0: 61 6b 65 73 20 74 68 65 6d 20 61 76 61 69 6c 61 akes them availa
7f00: 62 6c 65 20 61 74 0a 5c 66 49 43 41 20 63 65 72 ble at.\fICA cer
7f10: 74 69 66 69 63 61 74 65 73 20 65 78 74 72 61 63 tificates extrac
7f20: 74 65 64 0a 66 72 6f 6d 20 4d 6f 7a 69 6c 6c 61 ted.from Mozilla
7f30: 5c 66 52 20 5b 68 74 74 70 73 3a 2f 2f 63 75 72 \fR [https://cur
7f40: 6c 5c 26 2e 73 65 2f 64 6f 63 73 2f 63 61 65 78 l\&.se/docs/caex
7f50: 74 72 61 63 74 5c 26 2e 68 74 6d 6c 5d 20 69 6e tract\&.html] in
7f60: 20 74 68 65 20 22 5c 66 49 63 61 63 65 72 74 5c the "\fIcacert\
7f70: 26 2e 70 65 6d 5c 66 52 22 20 66 69 6c 65 5c 26 &.pem\fR" file\&
7f80: 2e 20 59 6f 75 20 6d 75 73 74 20 74 68 65 6e 20 . You must then
7f90: 65 69 74 68 65 72 20 73 65 74 20 74 68 65 0a 5c either set the.\
7fa0: 66 42 53 53 4c 5f 43 45 52 54 5f 44 49 52 5c 66 fBSSL_CERT_DIR\f
7fb0: 52 20 61 6e 64 2f 6f 72 20 5c 66 42 53 53 4c 5f R and/or \fBSSL_
7fc0: 43 45 52 54 5f 46 49 4c 45 5c 66 52 20 65 6e 76 CERT_FILE\fR env
7fd0: 69 72 6f 6e 6d 65 6e 74 20 76 61 72 69 61 62 6c ironment variabl
7fe0: 65 73 20 6f 72 20 74 68 65 0a 5c 66 42 2d 63 61 es or the.\fB-ca
7ff0: 64 69 72 5c 66 52 20 6f 72 20 5c 66 42 2d 63 61 dir\fR or \fB-ca
8000: 66 69 6c 65 5c 66 52 20 6f 70 74 69 6f 6e 73 20 file\fR options
8010: 74 6f 20 74 68 65 20 43 41 20 63 65 72 74 20 66 to the CA cert f
8020: 69 6c 65 27 73 20 69 6e 73 74 61 6c 6c 0a 6c 6f ile's install.lo
8030: 63 61 74 69 6f 6e 5c 26 2e 20 49 74 20 69 73 20 cation\&. It is
8040: 79 6f 75 72 20 72 65 73 70 6f 6e 73 69 62 69 6c your responsibil
8050: 69 74 79 20 74 6f 20 6b 65 65 70 20 74 68 69 73 ity to keep this
8060: 20 66 69 6c 65 20 75 70 20 74 6f 20 64 61 74 65 file up to date
8070: 5c 26 2e 0a 2e 50 50 0a 2e 53 48 20 22 43 41 4c \&...PP..SH "CAL
8080: 4c 42 41 43 4b 20 4f 50 54 49 4f 4e 53 22 0a 41 LBACK OPTIONS".A
8090: 73 20 70 72 65 76 69 6f 75 73 6c 79 20 64 65 73 s previously des
80a0: 63 72 69 62 65 64 2c 20 65 61 63 68 20 63 68 61 cribed, each cha
80b0: 6e 6e 65 6c 20 63 61 6e 20 62 65 20 67 69 76 65 nnel can be give
80c0: 6e 20 74 68 65 69 72 20 6f 77 6e 20 63 61 6c 6c n their own call
80d0: 62 61 63 6b 73 0a 74 6f 20 68 61 6e 64 6c 65 20 backs.to handle
80e0: 69 6e 74 65 72 6d 65 64 69 61 74 65 20 70 72 6f intermediate pro
80f0: 63 65 73 73 69 6e 67 20 62 79 20 74 68 65 20 4f cessing by the O
8100: 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 2c 20 penSSL library,
8110: 75 73 69 6e 67 20 74 68 65 0a 5c 66 42 2d 63 6f using the.\fB-co
8120: 6d 6d 61 6e 64 5c 66 52 2c 20 5c 66 42 2d 70 61 mmand\fR, \fB-pa
8130: 73 73 77 6f 72 64 5c 66 52 2c 20 61 6e 64 20 5c ssword\fR, and \
8140: 66 42 2d 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d fB-validate_comm
8150: 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 73 0a 70 and\fR options.p
8160: 61 73 73 65 64 20 74 6f 20 65 69 74 68 65 72 20 assed to either
8170: 6f 66 20 5c 66 42 74 6c 73 3a 3a 73 6f 63 6b 65 of \fBtls::socke
8180: 74 5c 66 52 20 6f 72 20 5c 66 42 74 6c 73 3a 3a t\fR or \fBtls::
8190: 69 6d 70 6f 72 74 5c 66 52 5c 26 2e 0a 55 6e 6c import\fR\&..Unl
81a0: 69 6b 65 20 70 72 65 76 69 6f 75 73 20 76 65 72 ike previous ver
81b0: 73 69 6f 6e 73 20 6f 66 20 54 63 6c 54 4c 53 2c sions of TclTLS,
81c0: 20 6f 6e 6c 79 20 69 66 20 74 68 65 20 63 61 6c only if the cal
81d0: 6c 62 61 63 6b 20 67 65 6e 65 72 61 74 65 73 20 lback generates
81e0: 61 6e 20 65 72 72 6f 72 2c 0a 77 69 6c 6c 20 74 an error,.will t
81f0: 68 65 20 5c 66 42 62 67 65 72 72 6f 72 5c 66 52 he \fBbgerror\fR
8200: 20 63 6f 6d 6d 61 6e 64 20 62 65 20 69 6e 76 6f command be invo
8210: 6b 65 64 20 77 69 74 68 20 74 68 65 20 65 72 72 ked with the err
8220: 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 5c 26 or information\&
8230: 2e 0a 2e 53 53 20 22 56 41 4c 55 45 53 20 46 4f ...SS "VALUES FO
8240: 52 20 43 4f 4d 4d 41 4e 44 20 43 41 4c 4c 42 41 R COMMAND CALLBA
8250: 43 4b 22 0a 54 68 65 20 63 61 6c 6c 62 61 63 6b CK".The callback
8260: 20 66 6f 72 20 74 68 65 20 5c 66 42 2d 63 6f 6d for the \fB-com
8270: 6d 61 6e 64 5c 66 52 20 6f 70 74 69 6f 6e 20 69 mand\fR option i
8280: 73 20 69 6e 76 6f 6b 65 64 20 61 74 20 73 65 76 s invoked at sev
8290: 65 72 61 6c 20 70 6f 69 6e 74 73 20 64 75 72 69 eral points duri
82a0: 6e 67 20 74 68 65 0a 4f 70 65 6e 53 53 4c 20 68 ng the.OpenSSL h
82b0: 61 6e 64 73 68 61 6b 65 20 61 6e 64 20 64 75 72 andshake and dur
82c0: 69 6e 67 20 72 6f 75 74 69 6e 65 20 6f 70 65 72 ing routine oper
82d0: 61 74 69 6f 6e 73 5c 26 2e 20 53 65 65 20 62 65 ations\&. See be
82e0: 6c 6f 77 20 66 6f 72 20 74 68 65 20 70 6f 73 73 low for the poss
82f0: 69 62 6c 65 0a 61 72 67 75 6d 65 6e 74 73 20 70 ible.arguments p
8300: 61 73 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c assed to the cal
8310: 6c 62 61 63 6b 20 73 63 72 69 70 74 5c 26 2e 20 lback script\&.
8320: 56 61 6c 75 65 73 20 72 65 74 75 72 6e 65 64 20 Values returned
8330: 66 72 6f 6d 20 74 68 65 20 63 61 6c 6c 62 61 63 from the callbac
8340: 6b 20 61 72 65 0a 69 67 6e 6f 72 65 64 5c 26 2e k are.ignored\&.
8350: 0a 2e 54 50 0a 5c 66 42 65 72 72 6f 72 5c 66 52 ..TP.\fBerror\fR
8360: 20 5c 66 49 63 68 61 6e 6e 65 6c 49 64 20 6d 65 \fIchannelId me
8370: 73 73 61 67 65 5c 66 52 0a 54 68 69 73 20 66 6f ssage\fR.This fo
8380: 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 6b 20 69 rm of callback i
8390: 73 20 69 6e 76 6f 6b 65 64 20 77 68 65 6e 65 76 s invoked whenev
83a0: 65 72 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 er an error occu
83b0: 72 73 20 64 75 72 69 6e 67 20 74 68 65 20 69 6e rs during the in
83c0: 69 74 69 61 6c 0a 63 6f 6e 6e 65 63 74 69 6f 6e itial.connection
83d0: 2c 20 68 61 6e 64 73 68 61 6b 65 2c 20 6f 72 20 , handshake, or
83e0: 49 2f 4f 20 6f 70 65 72 61 74 69 6f 6e 73 5c 26 I/O operations\&
83f0: 2e 20 54 68 65 20 5c 66 49 6d 65 73 73 61 67 65 . The \fImessage
8400: 5c 66 52 20 61 72 67 75 6d 65 6e 74 20 63 61 6e \fR argument can
8410: 20 62 65 0a 66 72 6f 6d 20 74 68 65 20 54 63 6c be.from the Tcl
8420: 5f 45 72 72 6e 6f 4d 73 67 2c 20 4f 70 65 6e 53 _ErrnoMsg, OpenS
8430: 53 4c 20 66 75 6e 63 74 69 6f 6e 20 5c 66 42 45 SL function \fBE
8440: 52 52 5f 72 65 61 73 6f 6e 5f 65 72 72 6f 72 5f RR_reason_error_
8450: 73 74 72 69 6e 67 28 29 5c 66 52 2c 0a 6f 72 20 string()\fR,.or
8460: 61 20 63 75 73 74 6f 6d 20 6d 65 73 73 61 67 65 a custom message
8470: 5c 26 2e 20 54 68 69 73 20 63 61 6c 6c 62 61 63 \&. This callbac
8480: 6b 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c k is new for Tcl
8490: 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 TLS 1\&.8\&...TP
84a0: 0a 5c 66 42 69 6e 66 6f 5c 66 52 20 5c 66 49 63 .\fBinfo\fR \fIc
84b0: 68 61 6e 6e 65 6c 49 64 20 6d 61 6a 6f 72 20 6d hannelId major m
84c0: 69 6e 6f 72 20 6d 65 73 73 61 67 65 20 74 79 70 inor message typ
84d0: 65 5c 66 52 0a 54 68 69 73 20 66 6f 72 6d 20 6f e\fR.This form o
84e0: 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e f callback is in
84f0: 76 6f 6b 65 64 20 62 79 20 74 68 65 20 4f 70 65 voked by the Ope
8500: 6e 53 53 4c 20 66 75 6e 63 74 69 6f 6e 0a 5c 66 nSSL function.\f
8510: 42 53 53 4c 5f 73 65 74 5f 69 6e 66 6f 5f 63 61 BSSL_set_info_ca
8520: 6c 6c 62 61 63 6b 28 29 5c 66 52 20 64 75 72 69 llback()\fR duri
8530: 6e 67 20 74 68 65 20 69 6e 69 74 69 61 6c 20 63 ng the initial c
8540: 6f 6e 6e 65 63 74 69 6f 6e 20 61 6e 64 20 68 61 onnection and ha
8550: 6e 64 73 68 61 6b 65 0a 6f 70 65 72 61 74 69 6f ndshake.operatio
8560: 6e 73 5c 26 2e 20 54 68 65 20 61 72 67 75 6d 65 ns\&. The argume
8570: 6e 74 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 nts are:..RS..TP
8580: 0a 5c 66 49 6d 61 6a 6f 72 5c 66 52 0a 4d 61 6a .\fImajor\fR.Maj
8590: 6f 72 20 63 61 74 65 67 6f 72 79 20 66 6f 72 20 or category for
85a0: 65 72 72 6f 72 5c 26 2e 20 56 61 6c 69 64 20 65 error\&. Valid e
85b0: 6e 75 6d 73 20 61 72 65 3a 20 5c 66 42 68 61 6e nums are: \fBhan
85c0: 64 73 68 61 6b 65 5c 66 52 2c 20 5c 66 42 61 6c dshake\fR, \fBal
85d0: 65 72 74 5c 66 52 2c 0a 5c 66 42 63 6f 6e 6e 65 ert\fR,.\fBconne
85e0: 63 74 5c 66 52 2c 20 5c 66 42 61 63 63 65 70 74 ct\fR, \fBaccept
85f0: 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 49 6d 69 \fR\&...TP.\fImi
8600: 6e 6f 72 5c 66 52 0a 4d 69 6e 6f 72 20 63 61 74 nor\fR.Minor cat
8610: 65 67 6f 72 79 20 66 6f 72 20 65 72 72 6f 72 5c egory for error\
8620: 26 2e 20 56 61 6c 69 64 20 65 6e 75 6d 73 20 61 &. Valid enums a
8630: 72 65 3a 20 5c 66 42 73 74 61 72 74 5c 66 52 2c re: \fBstart\fR,
8640: 20 5c 66 42 64 6f 6e 65 5c 66 52 2c 20 5c 66 42 \fBdone\fR, \fB
8650: 72 65 61 64 5c 66 52 2c 0a 5c 66 42 77 72 69 74 read\fR,.\fBwrit
8660: 65 5c 66 52 2c 20 5c 66 42 6c 6f 6f 70 5c 66 52 e\fR, \fBloop\fR
8670: 2c 20 5c 66 42 65 78 69 74 5c 66 52 5c 26 2e 0a , \fBexit\fR\&..
8680: 2e 54 50 0a 5c 66 49 6d 65 73 73 61 67 65 5c 66 .TP.\fImessage\f
8690: 52 0a 44 65 73 63 72 69 70 74 69 76 65 20 6d 65 R.Descriptive me
86a0: 73 73 61 67 65 20 73 74 72 69 6e 67 20 77 68 69 ssage string whi
86b0: 63 68 20 6d 61 79 20 62 65 20 67 65 6e 65 72 61 ch may be genera
86c0: 74 65 64 20 65 69 74 68 65 72 20 62 79 0a 5c 66 ted either by.\f
86d0: 42 53 53 4c 5f 73 74 61 74 65 5f 73 74 72 69 6e BSSL_state_strin
86e0: 67 5f 6c 6f 6e 67 28 29 5c 66 52 20 6f 72 20 5c g_long()\fR or \
86f0: 66 42 53 53 4c 5f 61 6c 65 72 74 5f 64 65 73 63 fBSSL_alert_desc
8700: 5f 73 74 72 69 6e 67 5f 6c 6f 6e 67 28 29 5c 66 _string_long()\f
8710: 52 2c 0a 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 R,.depending on
8720: 74 68 65 20 63 6f 6e 74 65 78 74 5c 26 2e 0a 2e the context\&...
8730: 54 50 0a 5c 66 49 74 79 70 65 5c 66 52 0a 46 6f TP.\fItype\fR.Fo
8740: 72 20 61 6c 65 72 74 73 2c 20 74 68 65 20 70 6f r alerts, the po
8750: 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 61 72 ssible values ar
8760: 65 3a 20 5c 66 42 77 61 72 6e 69 6e 67 5c 66 52 e: \fBwarning\fR
8770: 2c 0a 5c 66 42 66 61 74 61 6c 5c 66 52 2c 20 61 ,.\fBfatal\fR, a
8780: 6e 64 20 5c 66 42 75 6e 6b 6e 6f 77 6e 5c 66 52 nd \fBunknown\fR
8790: 5c 26 2e 20 46 6f 72 20 6f 74 68 65 72 73 2c 20 \&. For others,
87a0: 5c 66 42 69 6e 66 6f 5c 66 52 20 69 73 20 75 73 \fBinfo\fR is us
87b0: 65 64 5c 26 2e 0a 54 68 69 73 20 61 72 67 75 6d ed\&..This argum
87c0: 65 6e 74 20 69 73 20 6e 65 77 20 66 6f 72 20 54 ent is new for T
87d0: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
87e0: 52 45 0a 2e 54 50 0a 5c 66 42 6d 65 73 73 61 67 RE..TP.\fBmessag
87f0: 65 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c 49 e\fR \fIchannelI
8800: 64 20 64 69 72 65 63 74 69 6f 6e 20 76 65 72 73 d direction vers
8810: 69 6f 6e 20 63 6f 6e 74 65 6e 74 5f 74 79 70 65 ion content_type
8820: 20 6d 65 73 73 61 67 65 5c 66 52 0a 54 68 69 73 message\fR.This
8830: 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 61 63 form of callbac
8840: 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 79 20 k is invoked by
8850: 74 68 65 20 4f 70 65 6e 53 53 4c 20 66 75 6e 63 the OpenSSL func
8860: 74 69 6f 6e 0a 5c 66 42 53 53 4c 5f 73 65 74 5f tion.\fBSSL_set_
8870: 6d 73 67 5f 63 61 6c 6c 62 61 63 6b 28 29 5c 66 msg_callback()\f
8880: 52 20 77 68 65 6e 65 76 65 72 20 61 20 6d 65 73 R whenever a mes
8890: 73 61 67 65 20 69 73 20 73 65 6e 74 20 6f 72 20 sage is sent or
88a0: 72 65 63 65 69 76 65 64 20 64 75 72 69 6e 67 20 received during
88b0: 74 68 65 0a 69 6e 69 74 69 61 6c 20 63 6f 6e 6e the.initial conn
88c0: 65 63 74 69 6f 6e 2c 20 68 61 6e 64 73 68 61 6b ection, handshak
88d0: 65 2c 20 6f 72 20 49 2f 4f 20 6f 70 65 72 61 74 e, or I/O operat
88e0: 69 6f 6e 73 5c 26 2e 20 49 74 20 69 73 20 6f 6e ions\&. It is on
88f0: 6c 79 20 61 76 61 69 6c 61 62 6c 65 20 77 68 65 ly available whe
8900: 6e 0a 4f 70 65 6e 53 53 4c 20 69 73 20 63 6f 6d n.OpenSSL is com
8910: 70 6c 69 65 64 20 77 69 74 68 20 74 68 65 20 5c plied with the \
8920: 66 42 65 6e 61 62 6c 65 2d 73 73 6c 2d 74 72 61 fBenable-ssl-tra
8930: 63 65 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e 20 ce\fR option\&.
8940: 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 69 73 This callback is
8950: 0a 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 20 .new for TclTLS
8960: 31 5c 26 2e 38 5c 26 2e 20 54 68 65 20 61 72 67 1\&.8\&. The arg
8970: 75 6d 65 6e 74 73 20 61 72 65 3a 0a 2e 52 53 0a uments are:..RS.
8980: 2e 54 50 0a 5c 66 49 64 69 72 65 63 74 69 6f 6e .TP.\fIdirection
8990: 5c 66 52 0a 44 69 72 65 63 74 69 6f 6e 20 69 73 \fR.Direction is
89a0: 20 65 69 74 68 65 72 20 5c 66 42 53 65 6e 74 5c either \fBSent\
89b0: 66 52 20 6f 72 20 5c 66 42 52 65 63 65 69 76 65 fR or \fBReceive
89c0: 64 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 49 76 d\fR\&...TP.\fIv
89d0: 65 72 73 69 6f 6e 5c 66 52 0a 56 65 72 73 69 6f ersion\fR.Versio
89e0: 6e 20 69 73 20 74 68 65 20 70 72 6f 74 6f 63 6f n is the protoco
89f0: 6c 20 76 65 72 73 69 6f 6e 5c 26 2e 0a 2e 54 50 l version\&...TP
8a00: 0a 5c 66 49 63 6f 6e 74 65 6e 74 5f 74 79 70 65 .\fIcontent_type
8a10: 5c 66 52 0a 43 6f 6e 74 65 6e 74 20 74 79 70 65 \fR.Content type
8a20: 20 69 73 20 74 68 65 20 6d 65 73 73 61 67 65 20 is the message
8a30: 63 6f 6e 74 65 6e 74 20 74 79 70 65 5c 26 2e 0a content type\&..
8a40: 2e 54 50 0a 5c 66 49 6d 65 73 73 61 67 65 5c 66 .TP.\fImessage\f
8a50: 52 0a 4d 65 73 73 61 67 65 20 69 73 20 6d 6f 72 R.Message is mor
8a60: 65 20 69 6e 66 6f 20 66 72 6f 6d 20 74 68 65 20 e info from the
8a70: 5c 66 42 53 53 4c 5f 74 72 61 63 65 5c 66 52 20 \fBSSL_trace\fR
8a80: 41 50 49 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c API\&...RE..TP.\
8a90: 66 42 73 65 73 73 69 6f 6e 5c 66 52 20 5c 66 49 fBsession\fR \fI
8aa0: 63 68 61 6e 6e 65 6c 49 64 20 73 65 73 73 69 6f channelId sessio
8ab0: 6e 5f 69 64 20 73 65 73 73 69 6f 6e 5f 74 69 63 n_id session_tic
8ac0: 6b 65 74 20 6c 69 66 65 74 69 6d 65 5c 66 52 0a ket lifetime\fR.
8ad0: 54 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c This form of cal
8ae0: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
8af0: 20 62 79 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 by the OpenSSL
8b00: 66 75 6e 63 74 69 6f 6e 0a 5c 66 42 53 53 4c 5f function.\fBSSL_
8b10: 43 54 58 5f 73 65 73 73 5f 73 65 74 5f 6e 65 77 CTX_sess_set_new
8b20: 5f 63 62 28 29 5c 66 52 20 77 68 65 6e 65 76 65 _cb()\fR wheneve
8b30: 72 20 61 20 6e 65 77 20 73 65 73 73 69 6f 6e 20 r a new session
8b40: 69 64 20 69 73 20 73 65 6e 74 20 62 79 20 74 68 id is sent by th
8b50: 65 0a 73 65 72 76 65 72 20 64 75 72 69 6e 67 20 e.server during
8b60: 74 68 65 20 69 6e 69 74 69 61 6c 20 63 6f 6e 6e the initial conn
8b70: 65 63 74 69 6f 6e 20 61 6e 64 20 68 61 6e 64 73 ection and hands
8b80: 68 61 6b 65 20 61 6e 64 20 61 6c 73 6f 20 64 75 hake and also du
8b90: 72 69 6e 67 20 74 68 65 20 73 65 73 73 69 6f 6e ring the session
8ba0: 0a 69 66 20 74 68 65 20 5c 66 42 2d 70 6f 73 74 .if the \fB-post
8bb0: 5f 68 61 6e 64 73 68 61 6b 65 5c 66 52 20 6f 70 _handshake\fR op
8bc0: 74 69 6f 6e 20 69 73 20 73 65 74 20 74 6f 20 74 tion is set to t
8bd0: 72 75 65 5c 26 2e 20 54 68 69 73 20 63 61 6c 6c rue\&. This call
8be0: 62 61 63 6b 20 69 73 20 6e 65 77 20 66 6f 72 0a back is new for.
8bf0: 54 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 20 TclTLS 1\&.8\&.
8c00: 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 61 72 The arguments ar
8c10: 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c 66 49 73 65 e:..RS..TP.\fIse
8c20: 73 73 69 6f 6e 5f 69 64 5c 66 52 0a 53 65 73 73 ssion_id\fR.Sess
8c30: 69 6f 6e 20 49 64 20 69 73 20 74 68 65 20 63 75 ion Id is the cu
8c40: 72 72 65 6e 74 20 73 65 73 73 69 6f 6e 20 69 64 rrent session id
8c50: 65 6e 74 69 66 69 65 72 0a 2e 54 50 0a 5c 66 49 entifier..TP.\fI
8c60: 73 65 73 73 69 6f 6e 5f 74 69 63 6b 65 74 5c 66 session_ticket\f
8c70: 52 0a 54 69 63 6b 65 74 20 69 73 20 74 68 65 20 R.Ticket is the
8c80: 73 65 73 73 69 6f 6e 20 74 69 63 6b 65 74 20 69 session ticket i
8c90: 6e 66 6f 0a 2e 54 50 0a 5c 66 49 6c 69 66 65 74 nfo..TP.\fIlifet
8ca0: 69 6d 65 5c 66 52 0a 4c 69 66 65 74 69 6d 65 20 ime\fR.Lifetime
8cb0: 69 73 20 74 68 65 20 74 69 63 6b 65 74 20 6c 69 is the ticket li
8cc0: 66 65 74 69 6d 65 20 69 6e 20 73 65 63 6f 6e 64 fetime in second
8cd0: 73 5c 26 2e 0a 2e 52 45 0a 2e 54 50 0a 5c 66 42 s\&...RE..TP.\fB
8ce0: 76 65 72 69 66 79 5c 66 52 20 5c 66 49 63 68 61 verify\fR \fIcha
8cf0: 6e 6e 65 6c 49 64 20 64 65 70 74 68 20 63 65 72 nnelId depth cer
8d00: 74 20 73 74 61 74 75 73 20 65 72 72 6f 72 5c 66 t status error\f
8d10: 52 0a 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 R.This callback
8d20: 77 61 73 20 6d 6f 76 65 64 20 74 6f 20 5c 66 42 was moved to \fB
8d30: 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d 61 6e 64 -validatecommand
8d40: 5c 66 52 20 69 6e 20 54 63 6c 54 4c 53 20 31 5c \fR in TclTLS 1\
8d50: 26 2e 38 5c 26 2e 0a 2e 50 50 0a 2e 53 53 20 22 &.8\&...PP..SS "
8d60: 56 41 4c 55 45 53 20 46 4f 52 20 50 41 53 53 57 VALUES FOR PASSW
8d70: 4f 52 44 20 43 41 4c 4c 42 41 43 4b 22 0a 54 68 ORD CALLBACK".Th
8d80: 65 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 74 e callback for t
8d90: 68 65 20 5c 66 42 2d 70 61 73 73 77 6f 72 64 5c he \fB-password\
8da0: 66 52 20 6f 70 74 69 6f 6e 20 69 73 20 69 6e 76 fR option is inv
8db0: 6f 6b 65 64 20 62 79 20 54 63 6c 54 4c 53 20 77 oked by TclTLS w
8dc0: 68 65 6e 65 76 65 72 20 4f 70 65 6e 53 53 4c 20 henever OpenSSL
8dd0: 6e 65 65 64 73 0a 74 6f 20 6f 62 74 61 69 6e 20 needs.to obtain
8de0: 61 20 70 61 73 73 77 6f 72 64 5c 26 2e 20 53 65 a password\&. Se
8df0: 65 20 62 65 6c 6f 77 20 66 6f 72 20 74 68 65 20 e below for the
8e00: 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d 65 6e possible argumen
8e10: 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 ts passed to the
8e20: 0a 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 70 74 .callback script
8e30: 5c 26 2e 20 54 68 65 20 75 73 65 72 20 70 72 6f \&. The user pro
8e40: 76 69 64 65 64 20 70 61 73 73 77 6f 72 64 20 69 vided password i
8e50: 73 20 65 78 70 65 63 74 65 64 20 74 6f 20 62 65 s expected to be
8e60: 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 returned by the
8e70: 0a 63 61 6c 6c 62 61 63 6b 5c 26 2e 0a 2e 54 50 .callback\&...TP
8e80: 0a 5c 66 42 70 61 73 73 77 6f 72 64 5c 66 52 20 .\fBpassword\fR
8e90: 5c 66 49 72 77 66 6c 61 67 20 73 69 7a 65 5c 66 \fIrwflag size\f
8ea0: 52 0a 49 6e 76 6f 6b 65 64 20 77 68 65 6e 20 6c R.Invoked when l
8eb0: 6f 61 64 69 6e 67 20 6f 72 20 73 74 6f 72 69 6e oading or storin
8ec0: 67 20 61 6e 20 65 6e 63 72 79 70 74 65 64 20 50 g an encrypted P
8ed0: 45 4d 20 63 65 72 74 69 66 69 63 61 74 65 5c 26 EM certificate\&
8ee0: 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 73 20 . The arguments
8ef0: 61 72 65 3a 0a 2e 52 53 0a 2e 54 50 0a 5c 66 49 are:..RS..TP.\fI
8f00: 72 77 66 6c 61 67 5c 66 52 0a 54 68 65 20 72 65 rwflag\fR.The re
8f10: 61 64 2f 77 72 69 74 65 20 66 6c 61 67 20 69 73 ad/write flag is
8f20: 20 30 20 66 6f 72 20 72 65 61 64 69 6e 67 2f 64 0 for reading/d
8f30: 65 63 72 79 70 74 69 6f 6e 20 6f 72 20 31 20 66 ecryption or 1 f
8f40: 6f 72 20 77 72 69 74 69 6e 67 2f 65 6e 63 72 79 or writing/encry
8f50: 70 74 69 6f 6e 5c 26 2e 0a 54 68 65 20 6c 61 74 ption\&..The lat
8f60: 74 65 72 20 63 61 6e 20 62 65 20 75 73 65 64 20 ter can be used
8f70: 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68 65 to determine whe
8f80: 6e 20 74 6f 20 70 72 6f 6d 70 74 20 74 68 65 20 n to prompt the
8f90: 75 73 65 72 20 74 6f 20 63 6f 6e 66 69 72 6d 5c user to confirm\
8fa0: 26 2e 0a 54 68 69 73 20 61 72 67 75 6d 65 6e 74 &..This argument
8fb0: 20 69 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 is new for TclT
8fc0: 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a LS 1\&.8\&...TP.
8fd0: 5c 66 49 73 69 7a 65 5c 66 52 0a 54 68 65 20 73 \fIsize\fR.The s
8fe0: 69 7a 65 20 69 73 20 74 68 65 20 6d 61 78 69 6d ize is the maxim
8ff0: 75 6d 20 6c 65 6e 67 74 68 20 6f 66 20 74 68 65 um length of the
9000: 20 70 61 73 73 77 6f 72 64 20 69 6e 20 62 79 74 password in byt
9010: 65 73 5c 26 2e 0a 54 68 69 73 20 61 72 67 75 6d es\&..This argum
9020: 65 6e 74 20 69 73 20 6e 65 77 20 66 6f 72 20 54 ent is new for T
9030: 63 6c 54 4c 53 20 31 5c 26 2e 38 5c 26 2e 0a 2e clTLS 1\&.8\&...
9040: 52 45 0a 2e 50 50 0a 2e 53 53 20 22 56 41 4c 55 RE..PP..SS "VALU
9050: 45 53 20 46 4f 52 20 56 41 4c 49 44 41 54 45 20 ES FOR VALIDATE
9060: 43 4f 4d 4d 41 4e 44 20 43 41 4c 4c 42 41 43 4b COMMAND CALLBACK
9070: 22 0a 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 66 ".The callback f
9080: 6f 72 20 74 68 65 20 5c 66 42 2d 76 61 6c 69 64 or the \fB-valid
9090: 61 74 65 63 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 atecommand\fR op
90a0: 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b 65 64 20 tion is invoked
90b0: 64 75 72 69 6e 67 20 74 68 65 20 68 61 6e 64 73 during the hands
90c0: 68 61 6b 65 0a 70 72 6f 63 65 73 73 20 69 6e 20 hake.process in
90d0: 6f 72 64 65 72 20 66 6f 72 20 74 68 65 20 61 70 order for the ap
90e0: 70 6c 69 63 61 74 69 6f 6e 20 74 6f 20 76 61 6c plication to val
90f0: 69 64 61 74 65 20 74 68 65 20 70 72 6f 76 69 64 idate the provid
9100: 65 64 20 76 61 6c 75 65 28 73 29 5c 26 2e 20 53 ed value(s)\&. S
9110: 65 65 0a 62 65 6c 6f 77 20 66 6f 72 20 74 68 65 ee.below for the
9120: 20 70 6f 73 73 69 62 6c 65 20 61 72 67 75 6d 65 possible argume
9130: 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 nts passed to th
9140: 65 20 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 70 e callback scrip
9150: 74 5c 26 2e 20 49 66 20 6e 6f 74 0a 73 70 65 63 t\&. If not.spec
9160: 69 66 69 65 64 2c 20 4f 70 65 6e 53 53 4c 20 77 ified, OpenSSL w
9170: 69 6c 6c 20 61 63 63 65 70 74 20 61 6c 6c 20 76 ill accept all v
9180: 61 6c 69 64 20 63 65 72 74 69 66 69 63 61 74 65 alid certificate
9190: 73 20 61 6e 64 20 65 78 74 65 6e 73 69 6f 6e 73 s and extensions
91a0: 5c 26 2e 20 54 6f 20 72 65 6a 65 63 74 0a 74 68 \&. To reject.th
91b0: 65 20 76 61 6c 75 65 20 61 6e 64 20 61 62 6f 72 e value and abor
91c0: 74 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e t the connection
91d0: 2c 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 73 , the callback s
91e0: 68 6f 75 6c 64 20 72 65 74 75 72 6e 20 30 5c 26 hould return 0\&
91f0: 2e 20 54 6f 20 61 63 63 65 70 74 20 74 68 65 0a . To accept the.
9200: 76 61 6c 75 65 20 61 6e 64 20 63 6f 6e 74 69 6e value and contin
9210: 75 65 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f ue the connectio
9220: 6e 2c 20 69 74 20 73 68 6f 75 6c 64 20 72 65 74 n, it should ret
9230: 75 72 6e 20 31 5c 26 2e 20 54 6f 20 72 65 6a 65 urn 1\&. To reje
9240: 63 74 20 74 68 65 20 76 61 6c 75 65 2c 20 62 75 ct the value, bu
9250: 74 0a 63 6f 6e 74 69 6e 75 65 20 74 68 65 20 63 t.continue the c
9260: 6f 6e 6e 65 63 74 69 6f 6e 2c 20 69 74 20 73 68 onnection, it sh
9270: 6f 75 6c 64 20 72 65 74 75 72 6e 20 32 5c 26 2e ould return 2\&.
9280: 20 54 68 69 73 20 63 61 6c 6c 62 61 63 6b 20 69 This callback i
9290: 73 20 6e 65 77 20 66 6f 72 20 54 63 6c 54 4c 53 s new for TclTLS
92a0: 20 31 5c 26 2e 38 5c 26 2e 0a 2e 54 50 0a 5c 66 1\&.8\&...TP.\f
92b0: 42 61 6c 70 6e 5c 66 52 20 5c 66 49 63 68 61 6e Balpn\fR \fIchan
92c0: 6e 65 6c 49 64 20 70 72 6f 74 6f 63 6f 6c 20 6d nelId protocol m
92d0: 61 74 63 68 5c 66 52 0a 46 6f 72 20 73 65 72 76 atch\fR.For serv
92e0: 65 72 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f ers, this form o
92f0: 66 20 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e f callback is in
9300: 76 6f 6b 65 64 20 77 68 65 6e 20 74 68 65 20 63 voked when the c
9310: 6c 69 65 6e 74 20 41 4c 50 4e 20 65 78 74 65 6e lient ALPN exten
9320: 73 69 6f 6e 20 69 73 0a 72 65 63 65 69 76 65 64 sion is.received
9330: 5c 26 2e 20 49 66 20 5c 66 49 6d 61 74 63 68 5c \&. If \fImatch\
9340: 66 52 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e fR is true, then
9350: 20 5c 66 49 70 72 6f 74 6f 63 6f 6c 5c 66 52 20 \fIprotocol\fR
9360: 69 73 20 74 68 65 20 66 69 72 73 74 0a 5c 66 42 is the first.\fB
9370: 2d 61 6c 70 6e 5c 66 52 20 70 72 6f 74 6f 63 6f -alpn\fR protoco
9380: 6c 20 6f 70 74 69 6f 6e 20 69 6e 20 63 6f 6d 6d l option in comm
9390: 6f 6e 20 74 6f 20 62 6f 74 68 20 74 68 65 20 63 on to both the c
93a0: 6c 69 65 6e 74 20 61 6e 64 20 73 65 72 76 65 72 lient and server
93b0: 5c 26 2e 0a 49 66 20 6e 6f 74 2c 20 74 68 65 20 \&..If not, the
93c0: 66 69 72 73 74 20 63 6c 69 65 6e 74 20 73 70 65 first client spe
93d0: 63 69 66 69 65 64 20 70 72 6f 74 6f 63 6f 6c 20 cified protocol
93e0: 69 73 20 75 73 65 64 5c 26 2e 20 54 68 69 73 20 is used\&. This
93f0: 63 61 6c 6c 62 61 63 6b 20 69 73 20 63 61 6c 6c callback is call
9400: 65 64 0a 61 66 74 65 72 20 74 68 65 20 48 65 6c ed.after the Hel
9410: 6c 6f 20 61 6e 64 20 53 4e 49 20 63 61 6c 6c 62 lo and SNI callb
9420: 61 63 6b 73 5c 26 2e 0a 2e 54 50 0a 5c 66 42 68 acks\&...TP.\fBh
9430: 65 6c 6c 6f 5c 66 52 20 5c 66 49 63 68 61 6e 6e ello\fR \fIchann
9440: 65 6c 49 64 20 73 65 72 76 65 72 6e 61 6d 65 5c elId servername\
9450: 66 52 0a 46 6f 72 20 73 65 72 76 65 72 73 2c 20 fR.For servers,
9460: 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c this form of cal
9470: 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 lback is invoked
9480: 20 64 75 72 69 6e 67 20 63 6c 69 65 6e 74 20 68 during client h
9490: 65 6c 6c 6f 20 6d 65 73 73 61 67 65 0a 70 72 6f ello message.pro
94a0: 63 65 73 73 69 6e 67 5c 26 2e 20 54 68 65 20 70 cessing\&. The p
94b0: 75 72 70 6f 73 65 20 69 73 20 73 6f 20 74 68 65 urpose is so the
94c0: 20 73 65 72 76 65 72 20 63 61 6e 20 73 65 6c 65 server can sele
94d0: 63 74 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 ct the appropria
94e0: 74 65 20 63 65 72 74 69 66 69 63 61 74 65 0a 74 te certificate.t
94f0: 6f 20 70 72 65 73 65 6e 74 20 74 6f 20 74 68 65 o present to the
9500: 20 63 6c 69 65 6e 74 2c 20 61 6e 64 20 74 6f 20 client, and to
9510: 6d 61 6b 65 20 6f 74 68 65 72 20 63 6f 6e 66 69 make other confi
9520: 67 75 72 61 74 69 6f 6e 20 61 64 6a 75 73 74 6d guration adjustm
9530: 65 6e 74 73 20 72 65 6c 65 76 61 6e 74 0a 74 6f ents relevant.to
9540: 20 74 68 61 74 20 73 65 72 76 65 72 20 6e 61 6d that server nam
9550: 65 20 61 6e 64 20 69 74 73 20 63 6f 6e 66 69 67 e and its config
9560: 75 72 61 74 69 6f 6e 5c 26 2e 20 49 74 20 69 73 uration\&. It is
9570: 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 74 called before t
9580: 68 65 20 53 4e 49 20 61 6e 64 20 41 4c 50 4e 0a he SNI and ALPN.
9590: 63 61 6c 6c 62 61 63 6b 73 5c 26 2e 0a 2e 54 50 callbacks\&...TP
95a0: 0a 5c 66 42 73 6e 69 5c 66 52 20 5c 66 49 63 68 .\fBsni\fR \fIch
95b0: 61 6e 6e 65 6c 49 64 20 73 65 72 76 65 72 6e 61 annelId serverna
95c0: 6d 65 5c 66 52 0a 46 6f 72 20 73 65 72 76 65 72 me\fR.For server
95d0: 73 2c 20 74 68 69 73 20 66 6f 72 6d 20 6f 66 20 s, this form of
95e0: 63 61 6c 6c 62 61 63 6b 20 69 73 20 69 6e 76 6f callback is invo
95f0: 6b 65 64 20 77 68 65 6e 20 74 68 65 20 53 65 72 ked when the Ser
9600: 76 65 72 20 4e 61 6d 65 20 49 6e 64 69 63 61 74 ver Name Indicat
9610: 69 6f 6e 0a 28 53 4e 49 29 20 65 78 74 65 6e 73 ion.(SNI) extens
9620: 69 6f 6e 20 69 73 20 72 65 63 65 69 76 65 64 5c ion is received\
9630: 26 2e 20 54 68 65 20 5c 66 49 73 65 72 76 65 72 &. The \fIserver
9640: 6e 61 6d 65 5c 66 52 20 61 72 67 75 6d 65 6e 74 name\fR argument
9650: 20 69 73 20 74 68 65 20 63 6c 69 65 6e 74 0a 70 is the client.p
9660: 72 6f 76 69 64 65 64 20 73 65 72 76 65 72 20 6e rovided server n
9670: 61 6d 65 20 73 70 65 63 69 66 69 65 64 20 69 6e ame specified in
9680: 20 74 68 65 20 5c 66 42 2d 73 65 72 76 65 72 6e the \fB-servern
9690: 61 6d 65 5c 66 52 20 6f 70 74 69 6f 6e 5c 26 2e ame\fR option\&.
96a0: 20 54 68 65 0a 70 75 72 70 6f 73 65 20 69 73 20 The.purpose is
96b0: 73 6f 20 77 68 65 6e 20 61 20 73 65 72 76 65 72 so when a server
96c0: 20 73 75 70 70 6f 72 74 73 20 6d 75 6c 74 69 70 supports multip
96d0: 6c 65 20 6e 61 6d 65 73 2c 20 74 68 65 20 72 69 le names, the ri
96e0: 67 68 74 20 63 65 72 74 69 66 69 63 61 74 65 0a ght certificate.
96f0: 63 61 6e 20 62 65 20 75 73 65 64 5c 26 2e 20 49 can be used\&. I
9700: 74 20 69 73 20 63 61 6c 6c 65 64 20 61 66 74 65 t is called afte
9710: 72 20 74 68 65 20 48 65 6c 6c 6f 20 63 61 6c 6c r the Hello call
9720: 62 61 63 6b 20 62 75 74 20 62 65 66 6f 72 65 20 back but before
9730: 74 68 65 20 41 4c 50 4e 0a 63 61 6c 6c 62 61 63 the ALPN.callbac
9740: 6b 5c 26 2e 0a 2e 54 50 0a 5c 66 42 76 65 72 69 k\&...TP.\fBveri
9750: 66 79 5c 66 52 20 5c 66 49 63 68 61 6e 6e 65 6c fy\fR \fIchannel
9760: 49 64 20 64 65 70 74 68 20 63 65 72 74 20 73 74 Id depth cert st
9770: 61 74 75 73 20 65 72 72 6f 72 5c 66 52 0a 54 68 atus error\fR.Th
9780: 69 73 20 66 6f 72 6d 20 6f 66 20 63 61 6c 6c 62 is form of callb
9790: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62 ack is invoked b
97a0: 79 20 4f 70 65 6e 53 53 4c 20 77 68 65 6e 20 61 y OpenSSL when a
97b0: 20 6e 65 77 20 63 65 72 74 69 66 69 63 61 74 65 new certificate
97c0: 20 69 73 20 72 65 63 65 69 76 65 64 0a 66 72 6f is received.fro
97d0: 6d 20 74 68 65 20 70 65 65 72 5c 26 2e 20 49 74 m the peer\&. It
97e0: 20 61 6c 6c 6f 77 73 20 74 68 65 20 63 6c 69 65 allows the clie
97f0: 6e 74 20 74 6f 20 63 68 65 63 6b 20 74 68 65 20 nt to check the
9800: 63 65 72 74 69 66 69 63 61 74 65 20 76 65 72 69 certificate veri
9810: 66 69 63 61 74 69 6f 6e 0a 72 65 73 75 6c 74 73 fication.results
9820: 20 61 6e 64 20 63 68 6f 6f 73 65 20 77 68 65 74 and choose whet
9830: 68 65 72 20 74 6f 20 63 6f 6e 74 69 6e 75 65 20 her to continue
9840: 6f 72 20 6e 6f 74 5c 26 2e 20 49 74 20 69 73 20 or not\&. It is
9850: 63 61 6c 6c 65 64 20 66 6f 72 20 65 61 63 68 0a called for each.
9860: 63 65 72 74 69 66 69 63 61 74 65 20 69 6e 20 74 certificate in t
9870: 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 63 he certificate c
9880: 68 61 69 6e 5c 26 2e 20 54 68 69 73 20 63 61 6c hain\&. This cal
9890: 6c 62 61 63 6b 20 77 61 73 20 6d 6f 76 65 64 20 lback was moved
98a0: 66 72 6f 6d 0a 5c 66 42 2d 63 6f 6d 6d 61 6e 64 from.\fB-command
98b0: 5c 66 52 20 69 6e 20 54 63 6c 54 4c 53 20 31 5c \fR in TclTLS 1\
98c0: 26 2e 38 5c 26 2e 20 54 68 65 20 61 72 67 75 6d &.8\&. The argum
98d0: 65 6e 74 73 20 61 72 65 3a 0a 2e 52 53 0a 2e 54 ents are:..RS..T
98e0: 50 0a 5c 66 49 64 65 70 74 68 5c 66 52 0a 54 68 P.\fIdepth\fR.Th
98f0: 65 20 64 65 70 74 68 20 69 73 20 74 68 65 20 69 e depth is the i
9900: 6e 74 65 67 65 72 20 64 65 70 74 68 20 6f 66 20 nteger depth of
9910: 74 68 65 20 63 65 72 74 69 66 69 63 61 74 65 20 the certificate
9920: 69 6e 20 74 68 65 20 63 65 72 74 69 66 69 63 61 in the certifica
9930: 74 65 20 63 68 61 69 6e 2c 0a 77 68 65 72 65 20 te chain,.where
9940: 30 20 69 73 20 74 68 65 20 70 65 65 72 20 63 65 0 is the peer ce
9950: 72 74 69 66 69 63 61 74 65 20 61 6e 64 20 68 69 rtificate and hi
9960: 67 68 65 72 20 76 61 6c 75 65 73 20 67 6f 69 6e gher values goin
9970: 67 20 75 70 20 74 6f 20 74 68 65 20 43 65 72 74 g up to the Cert
9980: 69 66 69 63 61 74 65 0a 41 75 74 68 6f 72 69 74 ificate.Authorit
9990: 79 20 28 43 41 29 5c 26 2e 0a 2e 54 50 0a 5c 66 y (CA)\&...TP.\f
99a0: 49 63 65 72 74 5c 66 52 0a 54 68 65 20 63 65 72 Icert\fR.The cer
99b0: 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 t argument is a
99c0: 6c 69 73 74 20 6f 66 20 6b 65 79 2d 76 61 6c 75 list of key-valu
99d0: 65 20 70 61 69 72 73 20 73 69 6d 69 6c 61 72 20 e pairs similar
99e0: 74 6f 20 74 68 6f 73 65 20 72 65 74 75 72 6e 65 to those returne
99f0: 64 20 62 79 0a 5c 66 42 74 6c 73 3a 3a 73 74 61 d by.\fBtls::sta
9a00: 74 75 73 5c 66 52 5c 26 2e 0a 2e 54 50 0a 5c 66 tus\fR\&...TP.\f
9a10: 49 73 74 61 74 75 73 5c 66 52 0a 54 68 65 20 73 Istatus\fR.The s
9a20: 74 61 74 75 73 20 61 72 67 75 6d 65 6e 74 20 69 tatus argument i
9a30: 73 20 74 68 65 20 62 6f 6f 6c 65 61 6e 20 76 61 s the boolean va
9a40: 6c 69 64 69 74 79 20 6f 66 20 74 68 65 20 63 75 lidity of the cu
9a50: 72 72 65 6e 74 20 63 65 72 74 69 66 69 63 61 74 rrent certificat
9a60: 65 20 77 68 65 72 65 20 30 0a 69 73 20 69 6e 76 e where 0.is inv
9a70: 61 6c 69 64 20 61 6e 64 20 31 20 69 73 20 76 61 alid and 1 is va
9a80: 6c 69 64 5c 26 2e 0a 2e 54 50 0a 5c 66 49 65 72 lid\&...TP.\fIer
9a90: 72 6f 72 5c 66 52 0a 54 68 65 20 65 72 72 6f 72 ror\fR.The error
9aa0: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 argument is the
9ab0: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2c 20 error message,
9ac0: 69 66 20 61 6e 79 2c 20 67 65 6e 65 72 61 74 65 if any, generate
9ad0: 64 20 62 79 0a 5c 66 42 58 35 30 39 5f 53 54 4f d by.\fBX509_STO
9ae0: 52 45 5f 43 54 58 5f 67 65 74 5f 65 72 72 6f 72 RE_CTX_get_error
9af0: 28 29 5c 66 52 5c 26 2e 0a 2e 52 45 0a 2e 50 50 ()\fR\&...RE..PP
9b00: 0a 52 65 66 65 72 65 6e 63 65 20 69 6d 70 6c 65 .Reference imple
9b10: 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 mentations of th
9b20: 65 73 65 20 63 61 6c 6c 62 61 63 6b 73 20 61 72 ese callbacks ar
9b30: 65 20 70 72 6f 76 69 64 65 64 20 69 6e 20 22 5c e provided in "\
9b40: 66 49 74 6c 73 5c 26 2e 74 63 6c 5c 66 52 22 0a fItls\&.tcl\fR".
9b50: 61 73 20 5c 66 42 74 6c 73 3a 3a 63 61 6c 6c 62 as \fBtls::callb
9b60: 61 63 6b 5c 66 52 2c 20 5c 66 42 74 6c 73 3a 3a ack\fR, \fBtls::
9b70: 70 61 73 73 77 6f 72 64 5c 66 52 2c 20 61 6e 64 password\fR, and
9b80: 20 5c 66 42 74 6c 73 3a 3a 76 61 6c 69 64 61 74 \fBtls::validat
9b90: 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 0a 72 65 73 e_command\fR.res
9ba0: 70 65 63 74 69 76 65 6c 79 5c 26 2e 20 4e 6f 74 pectively\&. Not
9bb0: 65 20 74 68 61 74 20 74 68 65 73 65 20 61 72 65 e that these are
9bc0: 20 6f 6e 6c 79 20 5c 66 49 73 61 6d 70 6c 65 5c only \fIsample\
9bd0: 66 52 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f fR implementatio
9be0: 6e 73 5c 26 2e 20 49 6e 20 61 20 6d 6f 72 65 0a ns\&. In a more.
9bf0: 72 65 61 6c 69 73 74 69 63 20 64 65 70 6c 6f 79 realistic deploy
9c00: 6d 65 6e 74 20 79 6f 75 20 77 6f 75 6c 64 20 73 ment you would s
9c10: 70 65 63 69 66 79 20 79 6f 75 72 20 6f 77 6e 20 pecify your own
9c20: 63 61 6c 6c 62 61 63 6b 20 73 63 72 69 70 74 73 callback scripts
9c30: 20 6f 6e 20 65 61 63 68 20 54 4c 53 0a 63 68 61 on each TLS.cha
9c40: 6e 6e 65 6c 20 75 73 69 6e 67 20 74 68 65 20 5c nnel using the \
9c50: 66 42 2d 63 6f 6d 6d 61 6e 64 5c 66 52 2c 20 5c fB-command\fR, \
9c60: 66 42 2d 70 61 73 73 77 6f 72 64 5c 66 52 2c 20 fB-password\fR,
9c70: 61 6e 64 0a 5c 66 42 2d 76 61 6c 69 64 61 74 65 and.\fB-validate
9c80: 5f 63 6f 6d 6d 61 6e 64 5c 66 52 20 6f 70 74 69 _command\fR opti
9c90: 6f 6e 73 5c 26 2e 0a 2e 50 50 0a 54 68 65 20 64 ons\&...PP.The d
9ca0: 65 66 61 75 6c 74 20 62 65 68 61 76 69 6f 72 20 efault behavior
9cb0: 77 68 65 6e 20 74 68 65 20 5c 66 42 2d 63 6f 6d when the \fB-com
9cc0: 6d 61 6e 64 5c 66 52 20 61 6e 64 20 5c 66 42 2d mand\fR and \fB-
9cd0: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
9ce0: 5c 66 52 0a 6f 70 74 69 6f 6e 73 20 61 72 65 20 \fR.options are
9cf0: 6e 6f 74 20 73 70 65 63 69 66 69 65 64 2c 20 69 not specified, i
9d00: 73 20 66 6f 72 20 54 63 6c 54 4c 53 20 74 6f 20 s for TclTLS to
9d10: 70 72 6f 63 65 73 73 20 74 68 65 20 61 73 73 6f process the asso
9d20: 63 69 61 74 65 64 20 6c 69 62 72 61 72 79 0a 63 ciated library.c
9d30: 61 6c 6c 62 61 63 6b 73 20 69 6e 74 65 72 6e 61 allbacks interna
9d40: 6c 6c 79 5c 26 2e 20 54 68 65 20 64 65 66 61 75 lly\&. The defau
9d50: 6c 74 20 62 65 68 61 76 69 6f 72 20 77 68 65 6e lt behavior when
9d60: 20 74 68 65 20 5c 66 42 2d 70 61 73 73 77 6f 72 the \fB-passwor
9d70: 64 5c 66 52 20 6f 70 74 69 6f 6e 0a 69 73 20 6e d\fR option.is n
9d80: 6f 74 20 73 70 65 63 69 66 69 65 64 20 69 73 20 ot specified is
9d90: 66 6f 72 20 54 63 6c 54 4c 53 20 74 6f 20 70 72 for TclTLS to pr
9da0: 6f 63 65 73 73 20 74 68 65 20 61 73 73 6f 63 69 ocess the associ
9db0: 61 74 65 64 20 6c 69 62 72 61 72 79 20 63 61 6c ated library cal
9dc0: 6c 62 61 63 6b 73 20 62 79 0a 61 74 74 65 6d 70 lbacks by.attemp
9dd0: 74 69 6e 67 20 74 6f 20 63 61 6c 6c 20 5c 66 42 ting to call \fB
9de0: 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 5c 66 52 tls::password\fR
9df0: 5c 26 2e 20 54 68 65 20 64 69 66 66 65 72 65 6e \&. The differen
9e00: 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 73 65 ce between these
9e10: 20 74 77 6f 0a 62 65 68 61 76 69 6f 72 73 20 69 two.behaviors i
9e20: 73 20 61 20 63 6f 6e 73 65 71 75 65 6e 63 65 20 s a consequence
9e30: 6f 66 20 6d 61 69 6e 74 61 69 6e 69 6e 67 20 63 of maintaining c
9e40: 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 ompatibility wit
9e50: 68 20 65 61 72 6c 69 65 72 0a 69 6d 70 6c 65 6d h earlier.implem
9e60: 65 6e 74 61 74 69 6f 6e 73 5c 26 2e 0a 2e 50 50 entations\&...PP
9e70: 0a 5c 66 49 54 68 65 20 75 73 65 20 6f 66 20 74 .\fIThe use of t
9e80: 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 61 6c he reference cal
9e90: 6c 62 61 63 6b 73 20 5c 66 42 74 6c 73 3a 3a 63 lbacks \fBtls::c
9ea0: 61 6c 6c 62 61 63 6b 5c 66 52 2c 20 5c 66 42 74 allback\fR, \fBt
9eb0: 6c 73 3a 3a 70 61 73 73 77 6f 72 64 5c 66 52 2c ls::password\fR,
9ec0: 0a 61 6e 64 20 5c 66 42 74 6c 73 3a 3a 76 61 6c .and \fBtls::val
9ed0: 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 5c 66 52 idate_command\fR
9ee0: 20 69 73 20 6e 6f 74 20 72 65 63 6f 6d 6d 65 6e is not recommen
9ef0: 64 65 64 5c 26 2e 20 54 68 65 79 20 6d 61 79 20 ded\&. They may
9f00: 62 65 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 be removed from
9f10: 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 5c future releases\
9f20: 26 2e 5c 66 52 0a 2e 53 48 20 44 45 42 55 47 0a &.\fR..SH DEBUG.
9f30: 46 6f 72 20 6d 6f 73 74 20 64 65 62 75 67 67 69 For most debuggi
9f40: 6e 67 20 6e 65 65 64 73 2c 20 74 68 65 20 5c 66 ng needs, the \f
9f50: 42 2d 63 61 6c 6c 62 61 63 6b 5c 66 52 20 6f 70 B-callback\fR op
9f60: 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 tion can be used
9f70: 20 74 6f 20 70 72 6f 76 69 64 65 0a 73 75 66 66 to provide.suff
9f80: 69 63 69 65 6e 74 20 69 6e 73 69 67 68 74 20 61 icient insight a
9f90: 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f nd information o
9fa0: 6e 20 74 68 65 20 54 4c 53 20 68 61 6e 64 73 68 n the TLS handsh
9fb0: 61 6b 65 20 61 6e 64 20 70 72 6f 67 72 65 73 73 ake and progress
9fc0: 5c 26 2e 20 49 66 0a 66 75 72 74 68 65 72 20 74 \&. If.further t
9fd0: 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 20 69 roubleshooting i
9fe0: 6e 73 69 67 68 74 20 69 73 20 6e 65 65 64 65 64 nsight is needed
9ff0: 2c 20 74 68 65 20 63 6f 6d 70 69 6c 65 20 74 69 , the compile ti
a000: 6d 65 20 6f 70 74 69 6f 6e 0a 5c 66 42 2d 2d 65 me option.\fB--e
a010: 6e 61 62 6c 65 2d 64 65 62 75 67 5c 66 52 20 63 nable-debug\fR c
a020: 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 67 65 an be used to ge
a030: 74 20 64 65 74 61 69 6c 65 64 20 65 78 65 63 75 t detailed execu
a040: 74 69 6f 6e 20 66 6c 6f 77 20 73 74 61 74 75 73 tion flow status
a050: 5c 26 2e 0a 2e 50 50 0a 54 4c 53 20 6b 65 79 20 \&...PP.TLS key
a060: 6c 6f 67 67 69 6e 67 20 63 61 6e 20 62 65 20 65 logging can be e
a070: 6e 61 62 6c 65 64 20 62 79 20 73 65 74 74 69 6e nabled by settin
a080: 67 20 74 68 65 20 65 6e 76 69 72 6f 6e 6d 65 6e g the environmen
a090: 74 20 76 61 72 69 61 62 6c 65 0a 5c 66 42 53 53 t variable.\fBSS
a0a0: 4c 4b 45 59 4c 4f 47 46 49 4c 45 5c 66 52 20 74 LKEYLOGFILE\fR t
a0b0: 6f 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 o the name of th
a0c0: 65 20 66 69 6c 65 20 74 6f 20 6c 6f 67 20 74 6f e file to log to
a0d0: 5c 26 2e 20 54 68 65 6e 20 77 68 65 6e 65 76 65 \&. Then wheneve
a0e0: 72 20 54 4c 53 20 6b 65 79 0a 6d 61 74 65 72 69 r TLS key.materi
a0f0: 61 6c 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 al is generated
a100: 6f 72 20 72 65 63 65 69 76 65 64 20 69 74 20 77 or received it w
a110: 69 6c 6c 20 62 65 20 6c 6f 67 67 65 64 20 74 6f ill be logged to
a120: 20 74 68 65 20 66 69 6c 65 5c 26 2e 20 54 68 69 the file\&. Thi
a130: 73 20 69 73 20 75 73 65 66 75 6c 0a 66 6f 72 20 s is useful.for
a140: 6c 6f 67 67 69 6e 67 20 6b 65 79 20 64 61 74 61 logging key data
a150: 20 66 6f 72 20 6e 65 74 77 6f 72 6b 20 6c 6f 67 for network log
a160: 67 69 6e 67 20 74 6f 6f 6c 73 20 74 6f 20 75 73 ging tools to us
a170: 65 20 74 6f 20 64 65 63 72 79 70 74 20 74 68 65 e to decrypt the
a180: 20 64 61 74 61 5c 26 2e 0a 2e 50 50 0a 54 68 65 data\&...PP.The
a190: 20 5c 66 42 74 6c 73 3a 3a 64 65 62 75 67 5c 66 \fBtls::debug\f
a1a0: 52 20 76 61 72 69 61 62 6c 65 20 70 72 6f 76 69 R variable provi
a1b0: 64 65 73 20 73 6f 6d 65 20 61 64 64 69 74 69 6f des some additio
a1c0: 6e 61 6c 20 63 6f 6e 74 72 6f 6c 20 6f 76 65 72 nal control over
a1d0: 20 74 68 65 0a 64 65 62 75 67 20 6c 6f 67 67 69 the.debug loggi
a1e0: 6e 67 20 69 6e 20 74 68 65 20 5c 66 42 74 6c 73 ng in the \fBtls
a1f0: 3a 3a 63 61 6c 6c 62 61 63 6b 5c 66 52 2c 20 5c ::callback\fR, \
a200: 66 42 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 5c fBtls::password\
a210: 66 52 2c 20 61 6e 64 0a 5c 66 42 74 6c 73 3a 3a fR, and.\fBtls::
a220: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
a230: 5c 66 52 20 64 65 66 61 75 6c 74 20 68 61 6e 64 \fR default hand
a240: 6c 65 72 73 20 69 6e 20 22 5c 66 49 74 6c 73 5c lers in "\fItls\
a250: 26 2e 74 63 6c 5c 66 52 22 5c 26 2e 0a 54 68 65 &.tcl\fR"\&..The
a260: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 69 default value i
a270: 73 20 30 20 77 69 74 68 20 68 69 67 68 65 72 20 s 0 with higher
a280: 76 61 6c 75 65 73 20 70 72 6f 64 75 63 69 6e 67 values producing
a290: 20 6d 6f 72 65 20 64 69 61 67 6e 6f 73 74 69 63 more diagnostic
a2a0: 20 6f 75 74 70 75 74 2c 0a 61 6e 64 20 77 69 6c output,.and wil
a2b0: 6c 20 61 6c 73 6f 20 66 6f 72 63 65 20 74 68 65 l also force the
a2c0: 20 76 65 72 69 66 79 20 6d 65 74 68 6f 64 20 69 verify method i
a2d0: 6e 20 5c 66 42 74 6c 73 3a 3a 63 61 6c 6c 62 61 n \fBtls::callba
a2e0: 63 6b 5c 66 52 20 74 6f 20 61 63 63 65 70 74 20 ck\fR to accept
a2f0: 74 68 65 0a 63 65 72 74 69 66 69 63 61 74 65 2c the.certificate,
a300: 20 65 76 65 6e 20 69 66 20 69 74 20 69 73 20 69 even if it is i
a310: 6e 76 61 6c 69 64 20 77 68 65 6e 20 74 68 65 20 nvalid when the
a320: 5c 66 42 2d 76 61 6c 69 64 61 74 65 63 6f 6d 6d \fB-validatecomm
a330: 61 6e 64 5c 66 52 0a 6f 70 74 69 6f 6e 20 69 73 and\fR.option is
a340: 20 73 65 74 20 74 6f 20 5c 66 42 74 6c 73 3a 3a set to \fBtls::
a350: 76 61 6c 69 64 61 74 65 5f 63 6f 6d 6d 61 6e 64 validate_command
a360: 5c 66 52 5c 26 2e 0a 2e 50 50 0a 5c 66 49 54 68 \fR\&...PP.\fITh
a370: 65 20 75 73 65 20 6f 66 20 74 68 65 20 76 61 72 e use of the var
a380: 69 61 62 6c 65 20 5c 66 42 74 6c 73 3a 3a 64 65 iable \fBtls::de
a390: 62 75 67 5c 66 52 20 69 73 20 6e 6f 74 20 72 65 bug\fR is not re
a3a0: 63 6f 6d 6d 65 6e 64 65 64 5c 26 2e 0a 49 74 20 commended\&..It
a3b0: 6d 61 79 20 62 65 20 72 65 6d 6f 76 65 64 20 66 may be removed f
a3c0: 72 6f 6d 20 66 75 74 75 72 65 20 72 65 6c 65 61 rom future relea
a3d0: 73 65 73 5c 26 2e 5c 66 52 0a 2e 53 48 20 45 58 ses\&.\fR..SH EX
a3e0: 41 4d 50 4c 45 53 0a 54 68 65 20 66 6f 6c 6c 6f AMPLES.The follo
a3f0: 77 69 6e 67 20 61 72 65 20 65 78 61 6d 70 6c 65 wing are example
a400: 20 73 63 72 69 70 74 73 20 74 6f 20 64 6f 77 6e scripts to down
a410: 6c 6f 61 64 20 61 20 77 65 62 70 61 67 65 20 61 load a webpage a
a420: 6e 64 20 66 69 6c 65 20 75 73 69 6e 67 20 74 68 nd file using th
a430: 65 0a 68 74 74 70 20 70 61 63 6b 61 67 65 5c 26 e.http package\&
a440: 2e 20 53 65 65 20 5c 66 42 43 65 72 74 69 66 69 . See \fBCertifi
a450: 63 61 74 65 20 56 61 6c 69 64 61 74 69 6f 6e 5c cate Validation\
a460: 66 52 20 66 6f 72 20 77 68 65 6e 20 74 68 65 0a fR for when the.
a470: 5c 66 42 2d 63 61 64 69 72 5c 66 52 2c 20 5c 66 \fB-cadir\fR, \f
a480: 42 2d 63 61 66 69 6c 65 5c 66 52 2c 20 61 6e 64 B-cafile\fR, and
a490: 20 5c 66 42 2d 63 61 73 74 6f 72 65 5c 66 52 20 \fB-castore\fR
a4a0: 6f 70 74 69 6f 6e 73 20 61 72 65 20 61 6c 73 6f options are also
a4b0: 0a 6e 65 65 64 65 64 5c 26 2e 20 53 65 65 20 74 .needed\&. See t
a4c0: 68 65 20 22 5c 66 49 64 65 6d 6f 73 5c 66 52 22 he "\fIdemos\fR"
a4d0: 20 64 69 72 65 63 74 6f 72 79 20 66 6f 72 20 6d directory for m
a4e0: 6f 72 65 20 65 78 61 6d 70 6c 65 20 73 63 72 69 ore example scri
a4f0: 70 74 73 5c 26 2e 0a 2e 50 50 0a 45 78 61 6d 70 pts\&...PP.Examp
a500: 6c 65 20 23 31 3a 20 44 6f 77 6e 6c 6f 61 64 20 le #1: Download
a510: 61 20 77 65 62 20 70 61 67 65 0a 2e 43 53 0a 0a a web page..CS..
a520: 0a 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 ..package requir
a530: 65 20 68 74 74 70 0a 70 61 63 6b 61 67 65 20 72 e http.package r
a540: 65 71 75 69 72 65 20 74 6c 73 0a 0a 73 65 74 20 equire tls..set
a550: 75 72 6c 20 22 68 74 74 70 73 3a 2f 2f 77 77 77 url "https://www
a560: 5c 26 2e 74 63 6c 5c 26 2e 74 6b 2f 22 0a 68 74 \&.tcl\&.tk/".ht
a570: 74 70 3a 3a 72 65 67 69 73 74 65 72 20 68 74 74 tp::register htt
a580: 70 73 20 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 ps 443 [list ::t
a590: 6c 73 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f ls::socket -auto
a5a0: 73 65 72 76 65 72 6e 61 6d 65 20 31 20 2d 72 65 servername 1 -re
a5b0: 71 75 69 72 65 20 31 5d 0a 0a 23 20 47 65 74 20 quire 1]..# Get
a5c0: 55 52 4c 0a 73 65 74 20 74 6f 6b 65 6e 20 5b 68 URL.set token [h
a5d0: 74 74 70 3a 3a 67 65 74 75 72 6c 20 24 75 72 6c ttp::geturl $url
a5e0: 5d 0a 0a 23 20 43 68 65 63 6b 20 66 6f 72 20 65 ]..# Check for e
a5f0: 72 72 6f 72 0a 69 66 20 7b 5b 68 74 74 70 3a 3a rror.if {[http::
a600: 73 74 61 74 75 73 20 24 74 6f 6b 65 6e 5d 20 6e status $token] n
a610: 65 20 22 6f 6b 22 7d 20 7b 0a 20 20 20 20 70 75 e "ok"} {. pu
a620: 74 73 20 5b 66 6f 72 6d 61 74 20 22 45 72 72 6f ts [format "Erro
a630: 72 20 25 73 22 20 5b 68 74 74 70 3a 3a 73 74 61 r %s" [http::sta
a640: 74 75 73 20 24 74 6f 6b 65 6e 5d 5d 0a 7d 0a 0a tus $token]].}..
a650: 23 20 53 61 76 65 20 77 65 62 20 70 61 67 65 20 # Save web page
a660: 74 6f 20 66 69 6c 65 0a 73 65 74 20 63 68 20 5b to file.set ch [
a670: 6f 70 65 6e 20 65 78 61 6d 70 6c 65 5c 26 2e 68 open example\&.h
a680: 74 6d 6c 20 77 62 5d 0a 70 75 74 73 20 24 63 68 tml wb].puts $ch
a690: 20 5b 68 74 74 70 3a 3a 64 61 74 61 20 24 74 6f [http::data $to
a6a0: 6b 65 6e 5d 0a 63 6c 6f 73 65 20 24 63 68 0a 0a ken].close $ch..
a6b0: 23 20 43 6c 65 61 6e 75 70 0a 3a 3a 68 74 74 70 # Cleanup.::http
a6c0: 3a 3a 63 6c 65 61 6e 75 70 20 24 74 6f 6b 65 6e ::cleanup $token
a6d0: 0a 0a 2e 43 45 0a 45 78 61 6d 70 6c 65 20 23 32 ...CE.Example #2
a6e0: 3a 20 44 6f 77 6e 6c 6f 61 64 20 61 20 66 69 6c : Download a fil
a6f0: 65 0a 2e 43 53 0a 0a 0a 0a 70 61 63 6b 61 67 65 e..CS....package
a700: 20 72 65 71 75 69 72 65 20 68 74 74 70 0a 70 61 require http.pa
a710: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 6c ckage require tl
a720: 73 0a 0a 73 65 74 20 75 72 6c 20 22 68 74 74 70 s..set url "http
a730: 73 3a 2f 2f 77 69 6b 69 5c 26 2e 74 63 6c 2d 6c s://wiki\&.tcl-l
a740: 61 6e 67 5c 26 2e 6f 72 67 2f 73 69 74 65 6d 61 ang\&.org/sitema
a750: 70 5c 26 2e 78 6d 6c 22 0a 68 74 74 70 3a 3a 72 p\&.xml".http::r
a760: 65 67 69 73 74 65 72 20 68 74 74 70 73 20 34 34 egister https 44
a770: 33 20 5b 6c 69 73 74 20 3a 3a 74 6c 73 3a 3a 73 3 [list ::tls::s
a780: 6f 63 6b 65 74 20 2d 61 75 74 6f 73 65 72 76 65 ocket -autoserve
a790: 72 6e 61 6d 65 20 31 20 2d 72 65 71 75 69 72 65 rname 1 -require
a7a0: 20 31 5d 0a 0a 23 20 4f 70 65 6e 20 6f 75 74 70 1]..# Open outp
a7b0: 75 74 20 66 69 6c 65 0a 73 65 74 20 66 69 6c 65 ut file.set file
a7c0: 6e 61 6d 65 20 5b 66 69 6c 65 20 74 61 69 6c 20 name [file tail
a7d0: 24 75 72 6c 5d 0a 73 65 74 20 63 68 20 5b 6f 70 $url].set ch [op
a7e0: 65 6e 20 24 66 69 6c 65 6e 61 6d 65 20 77 62 5d en $filename wb]
a7f0: 0a 0a 23 20 47 65 74 20 66 69 6c 65 0a 73 65 74 ..# Get file.set
a800: 20 74 6f 6b 65 6e 20 5b 3a 3a 68 74 74 70 3a 3a token [::http::
a810: 67 65 74 75 72 6c 20 24 75 72 6c 20 2d 62 6c 6f geturl $url -blo
a820: 63 6b 73 69 7a 65 20 36 35 35 33 36 20 2d 63 68 cksize 65536 -ch
a830: 61 6e 6e 65 6c 20 24 63 68 5d 0a 0a 23 20 43 68 annel $ch]..# Ch
a840: 65 63 6b 20 66 6f 72 20 65 72 72 6f 72 0a 69 66 eck for error.if
a850: 20 7b 5b 68 74 74 70 3a 3a 73 74 61 74 75 73 20 {[http::status
a860: 24 74 6f 6b 65 6e 5d 20 6e 65 20 22 6f 6b 22 7d $token] ne "ok"}
a870: 20 7b 0a 20 20 20 20 70 75 74 73 20 5b 66 6f 72 {. puts [for
a880: 6d 61 74 20 22 45 72 72 6f 72 20 25 73 22 20 5b mat "Error %s" [
a890: 68 74 74 70 3a 3a 73 74 61 74 75 73 20 24 74 6f http::status $to
a8a0: 6b 65 6e 5d 5d 0a 7d 0a 0a 23 20 43 6c 65 61 6e ken]].}..# Clean
a8b0: 75 70 0a 63 6c 6f 73 65 20 24 63 68 0a 3a 3a 68 up.close $ch.::h
a8c0: 74 74 70 3a 3a 63 6c 65 61 6e 75 70 20 24 74 6f ttp::cleanup $to
a8d0: 6b 65 6e 0a 0a 2e 43 45 0a 2e 53 48 20 22 53 50 ken...CE..SH "SP
a8e0: 45 43 49 41 4c 20 43 4f 4e 53 49 44 45 52 41 54 ECIAL CONSIDERAT
a8f0: 49 4f 4e 53 22 0a 54 68 65 20 63 61 70 61 62 69 IONS".The capabi
a900: 6c 69 74 69 65 73 20 6f 66 20 74 68 69 73 20 70 lities of this p
a910: 61 63 6b 61 67 65 20 63 61 6e 20 76 61 72 79 20 ackage can vary
a920: 65 6e 6f 72 6d 6f 75 73 6c 79 20 62 61 73 65 64 enormously based
a930: 20 75 70 6f 6e 20 68 6f 77 20 74 68 65 0a 6c 69 upon how the.li
a940: 6e 6b 65 64 20 74 6f 20 4f 70 65 6e 53 53 4c 20 nked to OpenSSL
a950: 6c 69 62 72 61 72 79 20 77 61 73 20 63 6f 6e 66 library was conf
a960: 69 67 75 72 65 64 20 61 6e 64 20 62 75 69 6c 74 igured and built
a970: 5c 26 2e 20 4e 65 77 20 76 65 72 73 69 6f 6e 73 \&. New versions
a980: 20 6d 61 79 20 6f 62 73 6f 6c 65 74 65 0a 6f 6c may obsolete.ol
a990: 64 65 72 20 70 72 6f 74 6f 63 6f 6c 20 76 65 72 der protocol ver
a9a0: 73 69 6f 6e 73 2c 20 61 64 64 20 6f 72 20 72 65 sions, add or re
a9b0: 6d 6f 76 65 20 63 69 70 68 65 72 73 2c 20 63 68 move ciphers, ch
a9c0: 61 6e 67 65 20 64 65 66 61 75 6c 74 20 76 61 6c ange default val
a9d0: 75 65 73 2c 20 65 74 63 5c 26 2e 0a 55 73 65 20 ues, etc\&..Use
a9e0: 74 68 65 20 5c 66 42 74 6c 73 3a 3a 70 72 6f 74 the \fBtls::prot
a9f0: 6f 63 6f 6c 73 5c 66 52 20 63 6f 6d 6d 61 6e 64 ocols\fR command
aa00: 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 73 to obtain the s
aa10: 75 70 70 6f 72 74 65 64 0a 70 72 6f 74 6f 63 6f upported.protoco
aa20: 6c 20 76 65 72 73 69 6f 6e 73 5c 26 2e 0a 2e 53 l versions\&...S
aa30: 48 20 22 53 45 45 20 41 4c 53 4f 22 0a 5c 66 49 H "SEE ALSO".\fI
aa40: 4f 70 65 6e 53 53 4c 5c 66 52 20 5b 68 74 74 70 OpenSSL\fR [http
aa50: 73 3a 2f 2f 77 77 77 5c 26 2e 6f 70 65 6e 73 73 s://www\&.openss
aa60: 6c 5c 26 2e 6f 72 67 2f 5d 2c 20 68 74 74 70 2c l\&.org/], http,
aa70: 20 73 6f 63 6b 65 74 0a 2e 53 48 20 4b 45 59 57 socket..SH KEYW
aa80: 4f 52 44 53 0a 49 2f 4f 2c 20 49 50 20 41 64 64 ORDS.I/O, IP Add
aa90: 72 65 73 73 2c 20 4f 70 65 6e 53 53 4c 2c 20 53 ress, OpenSSL, S
aaa0: 53 4c 2c 20 54 43 50 2c 20 54 4c 53 2c 20 54 63 SL, TCP, TLS, Tc
aab0: 6c 54 4c 53 2c 20 61 73 79 6e 63 68 72 6f 6e 6f lTLS, asynchrono
aac0: 75 73 20 49 2f 4f 2c 20 62 69 6e 64 2c 20 63 65 us I/O, bind, ce
aad0: 72 74 69 66 69 63 61 74 65 2c 20 63 68 61 6e 6e rtificate, chann
aae0: 65 6c 2c 20 63 6f 6e 6e 65 63 74 69 6f 6e 2c 20 el, connection,
aaf0: 64 6f 6d 61 69 6e 20 6e 61 6d 65 2c 20 68 6f 73 domain name, hos
ab00: 74 2c 20 68 74 74 70 73 2c 20 6e 65 74 77 6f 72 t, https, networ
ab10: 6b 2c 20 6e 65 74 77 6f 72 6b 20 61 64 64 72 65 k, network addre
ab20: 73 73 2c 20 73 6f 63 6b 65 74 2c 20 74 6c 73 0a ss, socket, tls.
ab30: 2e 53 48 20 43 41 54 45 47 4f 52 59 0a 74 6c 73 .SH CATEGORY.tls
ab40: 0a 2e 53 48 20 43 4f 50 59 52 49 47 48 54 0a 2e ..SH COPYRIGHT..
ab50: 6e 66 0a 43 6f 70 79 72 69 67 68 74 20 28 63 29 nf.Copyright (c)
ab60: 20 31 39 39 39 20 4d 61 74 74 20 4e 65 77 6d 61 1999 Matt Newma
ab70: 6e 0a 43 6f 70 79 72 69 67 68 74 20 28 63 29 20 n.Copyright (c)
ab80: 32 30 30 34 20 53 74 61 72 66 69 73 68 20 53 79 2004 Starfish Sy
ab90: 73 74 65 6d 73 0a 43 6f 70 79 72 69 67 68 74 20 stems.Copyright
aba0: 28 63 29 20 32 30 32 34 20 42 72 69 61 6e 20 4f (c) 2024 Brian O
abb0: 27 48 61 67 61 6e 0a 0a 2e 66 69 0a 'Hagan...fi.