Hex Artifact Content

Artifact 822c129c0c53c2762aa929d99553aa6aa519ae457dde38513ae2ce365e7e9d9d:


0000: 54 6f 6f 6c 20 43 6f 6d 6d 61 6e 64 20 4c 61 6e  Tool Command Lan
0010: 67 75 61 67 65 20 28 54 43 4c 29 20 54 72 61 6e  guage (TCL) Tran
0020: 73 70 6f 72 74 20 4c 61 79 65 72 20 53 65 63 75  sport Layer Secu
0030: 72 69 74 79 20 28 54 4c 53 29 20 45 78 74 65 6e  rity (TLS) Exten
0040: 73 69 6f 6e 0a 0a 49 6e 74 72 6f 0a 3d 3d 3d 3d  sion..Intro.====
0050: 3d 0a 0a 54 68 69 73 20 70 61 63 6b 61 67 65 20  =..This package 
0060: 70 72 6f 76 69 64 65 73 20 61 6e 20 65 78 74 65  provides an exte
0070: 6e 73 69 6f 6e 20 77 68 69 63 68 20 69 6d 70 6c  nsion which impl
0080: 65 6d 65 6e 74 73 20 53 65 63 75 72 65 20 53 6f  ements Secure So
0090: 63 6b 65 74 20 4c 61 79 65 72 20 28 53 53 4c 29  cket Layer (SSL)
00a0: 0a 61 6e 64 20 54 72 61 6e 73 70 6f 72 74 20 4c  .and Transport L
00b0: 61 79 65 72 20 53 65 63 75 72 69 74 79 20 28 54  ayer Security (T
00c0: 4c 53 29 20 65 6e 63 72 79 70 74 69 6f 6e 20 6f  LS) encryption o
00d0: 76 65 72 20 54 72 61 6e 73 6d 69 73 73 69 6f 6e  ver Transmission
00e0: 20 43 6f 6e 74 72 6f 6c 0a 50 72 6f 74 6f 63 6f   Control.Protoco
00f0: 6c 20 28 54 43 50 29 20 6e 65 74 77 6f 72 6b 20  l (TCP) network 
0100: 63 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 20 63 68  communication ch
0110: 61 6e 6e 65 6c 73 20 75 74 69 6c 69 7a 69 6e 67  annels utilizing
0120: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 6c 69 62   the OpenSSL lib
0130: 72 61 72 79 2e 0a 0a 0a 44 65 73 63 72 69 70 74  rary....Descript
0140: 69 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a  ion.===========.
0150: 0a 54 68 69 73 20 65 78 74 65 6e 73 69 6f 6e 20  .This extension 
0160: 77 6f 72 6b 73 20 62 79 20 63 72 65 61 74 69 6e  works by creatin
0170: 67 20 61 20 6c 61 79 65 72 65 64 20 54 43 4c 20  g a layered TCL 
0180: 43 68 61 6e 6e 65 6c 20 6f 6e 20 74 6f 70 20 6f  Channel on top o
0190: 66 20 61 6e 20 65 78 69 73 74 69 6e 67 0a 62 69  f an existing.bi
01a0: 2d 64 69 72 65 63 74 69 6f 6e 61 6c 20 63 68 61  -directional cha
01b0: 6e 6e 65 6c 20 63 72 65 61 74 65 64 20 62 79 20  nnel created by 
01c0: 74 68 65 20 54 4c 53 20 73 6f 63 6b 65 74 20 63  the TLS socket c
01d0: 6f 6d 6d 61 6e 64 2e 20 41 6c 6c 20 65 78 69 73  ommand. All exis
01e0: 74 69 6e 67 20 73 6f 63 6b 65 74 0a 66 75 6e 63  ting socket.func
01f0: 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 73 75 70  tionality is sup
0200: 70 6f 72 74 65 64 20 69 6e 20 61 64 64 69 74 69  ported in additi
0210: 6f 6e 20 74 6f 20 73 65 76 65 72 61 6c 20 6e 65  on to several ne
0220: 77 20 6f 70 74 69 6f 6e 73 2e 20 42 6f 74 68 20  w options. Both 
0230: 63 6c 69 65 6e 74 20 61 6e 64 0a 73 65 72 76 65  client and.serve
0240: 72 20 6d 6f 64 65 73 20 61 72 65 20 73 75 70 70  r modes are supp
0250: 6f 72 74 65 64 2e 0a 0a 0a 46 65 61 74 75 72 65  orted....Feature
0260: 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 20  s.========..The 
0270: 70 61 63 6b 61 67 65 20 70 72 6f 76 69 64 65 73  package provides
0280: 3a 0a 2d 20 45 6e 63 72 79 70 74 65 64 20 54 43  :.- Encrypted TC
0290: 50 20 63 6f 6d 6d 75 6e 69 63 61 74 69 6f 6e 73  P communications
02a0: 20 6c 61 79 65 72 65 64 20 6f 6e 20 54 43 4c 20   layered on TCL 
02b0: 63 68 61 6e 6e 65 6c 73 2e 0a 2d 20 53 74 61 74  channels..- Stat
02c0: 75 73 20 6f 66 20 65 6e 63 72 79 70 74 65 64 20  us of encrypted 
02d0: 63 68 61 6e 6e 65 6c 73 2e 0a 2d 20 56 69 65 77  channels..- View
02e0: 20 58 2e 35 30 39 20 63 65 72 74 69 66 69 63 61   X.509 certifica
02f0: 74 65 20 63 6f 6e 74 65 6e 74 73 2e 0a 0a 0a 44  te contents....D
0300: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 3d 3d 3d  ocumentation.===
0310: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 53 65 65 20  ==========..See 
0320: 74 68 65 20 64 6f 63 20 64 69 72 65 63 74 6f 72  the doc director
0330: 79 20 66 6f 72 20 74 68 65 20 66 75 6c 6c 20 75  y for the full u
0340: 73 61 67 65 20 64 6f 63 75 6d 65 6e 74 61 74 69  sage documentati
0350: 6f 6e 2e 0a 0a 0a 43 6f 6d 70 61 74 69 62 69 6c  on....Compatibil
0360: 69 74 79 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  ity.============
0370: 3d 0a 0a 54 43 4c 0a 2d 2d 2d 0a 0a 54 68 69 73  =..TCL.---..This
0380: 20 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65   package require
0390: 73 20 54 43 4c 20 38 2e 35 20 6f 72 20 6c 61 74  s TCL 8.5 or lat
03a0: 65 72 2e 20 49 74 20 77 69 6c 6c 20 61 6c 73 6f  er. It will also
03b0: 20 77 6f 72 6b 20 77 69 74 68 20 54 43 4c 20 39   work with TCL 9
03c0: 2c 20 62 75 74 20 69 74 20 69 73 0a 6e 6f 74 20  , but it is.not 
03d0: 62 69 6e 61 72 79 20 63 6f 6d 70 61 74 69 62 6c  binary compatibl
03e0: 65 20 62 65 74 77 65 65 6e 20 6d 61 6a 6f 72 20  e between major 
03f0: 54 43 4c 20 76 65 72 73 69 6f 6e 73 2e 20 54 68  TCL versions. Th
0400: 69 73 20 6d 65 61 6e 73 20 69 66 20 74 68 69 73  is means if this
0410: 20 65 78 74 65 6e 73 69 6f 6e 0a 69 73 20 62 75   extension.is bu
0420: 69 6c 74 20 77 69 74 68 20 54 43 4c 20 38 2e 78  ilt with TCL 8.x
0430: 20 69 74 20 77 69 6c 6c 20 6e 6f 74 20 6c 6f 61   it will not loa
0440: 64 20 69 6e 74 6f 20 54 43 4c 20 39 20 6f 72 20  d into TCL 9 or 
0450: 76 69 63 65 20 76 65 72 73 61 2e 20 49 74 20 69  vice versa. It i
0460: 73 20 62 65 73 74 0a 74 6f 20 63 6f 6d 70 69 6c  s best.to compil
0470: 65 20 62 6f 74 68 20 73 65 70 61 72 61 74 65 6c  e both separatel
0480: 79 20 74 68 65 6e 20 69 6e 73 74 61 6c 6c 20 74  y then install t
0490: 68 65 6d 20 77 69 74 68 20 74 68 65 20 63 6f 6d  hem with the com
04a0: 70 61 74 69 62 6c 65 20 54 43 4c 20 76 65 72 73  patible TCL vers
04b0: 69 6f 6e 73 2e 0a 0a 4f 70 65 6e 53 53 4c 0a 2d  ions...OpenSSL.-
04c0: 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 70 61 63  ------..This pac
04d0: 6b 61 67 65 20 69 73 20 63 6f 6d 70 61 74 69 62  kage is compatib
04e0: 6c 65 20 77 69 74 68 20 4f 70 65 6e 53 53 4c 20  le with OpenSSL 
04f0: 76 31 2e 31 2e 31 20 6f 72 20 6c 61 74 65 72 20  v1.1.1 or later 
0500: 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 33 2e  including the 3.
0510: 78 2c 20 34 2e 30 2c 0a 61 6e 64 20 34 2e 31 20  x, 4.0,.and 4.1 
0520: 72 65 6c 65 61 73 65 73 2e 20 4f 70 65 6e 53 53  releases. OpenSS
0530: 4c 20 33 2e 32 20 6f 72 20 6c 61 74 65 72 20 69  L 3.2 or later i
0540: 73 20 70 72 65 66 65 72 72 65 64 20 6f 6e 20 57  s preferred on W
0550: 69 6e 64 6f 77 73 2e 0a 53 65 65 20 68 74 74 70  indows..See http
0560: 3a 2f 2f 77 77 77 2e 6f 70 65 6e 73 73 6c 2e 6f  ://www.openssl.o
0570: 72 67 2f 2e 20 50 6c 65 61 73 65 20 6e 6f 74 65  rg/. Please note
0580: 20 74 68 61 74 20 74 68 65 72 65 20 61 72 65 20   that there are 
0590: 61 20 66 65 77 20 41 50 49 0a 69 6e 63 6f 6d 70  a few API.incomp
05a0: 61 74 69 62 69 6c 69 74 69 65 73 20 62 65 74 77  atibilities betw
05b0: 65 65 6e 20 4f 70 65 6e 53 53 4c 20 31 2e 31 2e  een OpenSSL 1.1.
05c0: 31 20 61 6e 64 20 33 2e 78 2c 20 73 6f 20 69 66  1 and 3.x, so if
05d0: 20 74 68 69 73 20 65 78 74 65 6e 73 69 6f 6e 20   this extension 
05e0: 69 73 20 62 75 69 6c 74 0a 61 67 61 69 6e 73 74  is built.against
05f0: 20 4f 70 65 6e 53 53 4c 20 31 2e 31 2e 31 20 69   OpenSSL 1.1.1 i
0600: 74 20 69 73 20 6e 6f 74 20 62 69 6e 61 72 79 20  t is not binary 
0610: 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20  compatible with 
0620: 4f 70 65 6e 53 53 4c 20 33 20 61 6e 64 20 34 20  OpenSSL 3 and 4 
0630: 6f 72 20 76 69 63 65 0a 76 65 72 73 61 2e 0a 0a  or vice.versa...
0640: 54 43 4c 54 4c 53 0a 2d 2d 2d 2d 2d 2d 0a 0a 54  TCLTLS.------..T
0650: 68 65 72 65 20 77 65 72 65 20 73 65 76 65 72 61  here were severa
0660: 6c 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 69  l changes made i
0670: 6e 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 63  n the callback c
0680: 6f 6d 6d 61 6e 64 20 61 72 67 75 6d 65 6e 74 73  ommand arguments
0690: 20 62 65 74 77 65 65 6e 0a 76 65 72 73 69 6f 6e   between.version
06a0: 73 20 31 2e 37 20 61 6e 64 20 32 2e 30 2e 20 53  s 1.7 and 2.0. S
06b0: 65 65 20 64 6f 63 2f 74 6c 73 2e 68 74 6d 6c 20  ee doc/tls.html 
06c0: 66 6f 72 20 77 68 61 74 20 63 68 61 6e 67 65 64  for what changed
06d0: 20 61 6e 64 20 6c 69 62 72 61 72 79 2f 74 6c 73   and library/tls
06e0: 2e 74 63 6c 0a 66 6f 72 20 65 78 61 6d 70 6c 65  .tcl.for example
06f0: 20 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f   handler functio
0700: 6e 73 20 74 68 61 74 20 61 72 65 20 62 61 63 6b  ns that are back
0710: 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 6c 65  wards compatible
0720: 2e 0a 0a 0a 49 6e 73 74 61 6c 6c 61 74 69 6f 6e  ....Installation
0730: 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54  .============..T
0740: 68 69 73 20 70 61 63 6b 61 67 65 20 75 73 65 73  his package uses
0750: 20 74 68 65 20 54 43 4c 20 45 78 74 65 6e 73 69   the TCL Extensi
0760: 6f 6e 20 41 72 63 68 69 74 65 63 74 75 72 65 20  on Architecture 
0770: 28 54 45 41 29 20 74 6f 20 62 75 69 6c 64 20 61  (TEA) to build a
0780: 6e 64 20 69 6e 73 74 61 6c 6c 20 6f 6e 0a 61 6e  nd install on.an
0790: 79 20 73 75 70 70 6f 72 74 65 64 20 55 6e 69 78  y supported Unix
07a0: 2c 20 4d 61 63 2c 20 6f 72 20 4d 53 20 57 69 6e  , Mac, or MS Win
07b0: 64 6f 77 73 20 73 79 73 74 65 6d 2e 20 49 74 20  dows system. It 
07c0: 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20 4f  depends on the O
07d0: 70 65 6e 53 53 4c 0a 6c 69 62 72 61 72 69 65 73  penSSL.libraries
07e0: 20 62 65 69 6e 67 20 61 76 61 69 6c 61 62 6c 65   being available
07f0: 20 70 72 69 6f 72 20 74 6f 20 62 75 69 6c 64 69   prior to buildi
0800: 6e 67 20 74 68 65 20 54 43 4c 54 4c 53 20 65 78  ng the TCLTLS ex
0810: 74 65 6e 73 69 6f 6e 2e 0a 0a 55 4e 49 58 20 61  tension...UNIX a
0820: 6e 64 20 4c 69 6e 75 78 0a 2d 2d 2d 2d 2d 2d 2d  nd Linux.-------
0830: 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 73 74 61  -------..The sta
0840: 6e 64 61 72 64 20 54 45 41 20 63 6f 6e 66 69 67  ndard TEA config
0850: 2c 20 6d 61 6b 65 2c 20 61 6e 64 20 69 6e 73 74  , make, and inst
0860: 61 6c 6c 20 70 72 6f 63 65 73 73 20 69 73 20 73  all process is s
0870: 75 70 70 6f 72 74 65 64 2e 0a 0a 09 24 20 63 64  upported....$ cd
0880: 20 74 63 6c 74 6c 73 0a 09 24 20 2e 2f 63 6f 6e   tcltls..$ ./con
0890: 66 69 67 75 72 65 20 2d 2d 65 6e 61 62 6c 65 2d  figure --enable-
08a0: 36 34 62 69 74 0a 09 24 20 6d 61 6b 65 0a 09 24  64bit..$ make..$
08b0: 20 6d 61 6b 65 20 74 65 73 74 0a 09 24 20 6d 61   make test..$ ma
08c0: 6b 65 20 69 6e 73 74 61 6c 6c 0a 0a 54 68 65 20  ke install..The 
08d0: 73 75 70 70 6f 72 74 65 64 20 63 6f 6e 66 69 67  supported config
08e0: 75 72 65 20 6f 70 74 69 6f 6e 73 20 69 6e 63 6c  ure options incl
08f0: 75 64 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 73  ude all of the s
0900: 74 61 6e 64 61 72 64 20 54 45 41 20 63 6f 6e 66  tandard TEA conf
0910: 69 67 75 72 65 0a 73 63 72 69 70 74 20 6f 70 74  igure.script opt
0920: 69 6f 6e 73 2c 20 70 6c 75 73 3a 0a 0a 20 20 2d  ions, plus:..  -
0930: 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31 20 20 20  -disable-tls1   
0940: 20 20 20 20 20 20 20 64 69 73 61 62 6c 65 20 54         disable T
0950: 4c 53 31 20 70 72 6f 74 6f 63 6f 6c 0a 20 20 2d  LS1 protocol.  -
0960: 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31 5f 31 20  -disable-tls1_1 
0970: 20 20 20 20 20 20 20 64 69 73 61 62 6c 65 20 54         disable T
0980: 4c 53 31 2e 31 20 70 72 6f 74 6f 63 6f 6c 0a 20  LS1.1 protocol. 
0990: 20 2d 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31 5f   --disable-tls1_
09a0: 32 20 20 20 20 20 20 20 20 64 69 73 61 62 6c 65  2        disable
09b0: 20 54 4c 53 31 2e 32 20 70 72 6f 74 6f 63 6f 6c   TLS1.2 protocol
09c0: 0a 20 20 2d 2d 64 69 73 61 62 6c 65 2d 74 6c 73  .  --disable-tls
09d0: 31 5f 33 20 20 20 20 20 20 20 20 64 69 73 61 62  1_3        disab
09e0: 6c 65 20 54 4c 53 31 2e 33 20 70 72 6f 74 6f 63  le TLS1.3 protoc
09f0: 6f 6c 0a 20 20 2d 2d 65 6e 61 62 6c 65 2d 64 65  ol.  --enable-de
0a00: 62 75 67 20 20 20 20 20 20 20 20 20 20 65 6e 61  bug          ena
0a10: 62 6c 65 20 64 65 62 75 67 67 69 6e 67 20 6d 6f  ble debugging mo
0a20: 64 65 20 61 6e 64 20 6f 75 74 70 75 74 20 6d 6f  de and output mo
0a30: 72 65 20 73 74 61 74 75 73 0a 20 20 2d 2d 65 6e  re status.  --en
0a40: 61 62 6c 65 2d 73 73 6c 2d 66 61 73 74 70 61 74  able-ssl-fastpat
0a50: 68 20 20 20 65 6e 61 62 6c 65 20 75 73 69 6e 67  h   enable using
0a60: 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20   the underlying 
0a70: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20  file descriptor 
0a80: 66 6f 72 20 74 61 6c 6b 69 6e 67 20 64 69 72 65  for talking dire
0a90: 63 74 6c 79 20 74 6f 20 74 68 65 20 53 53 4c 20  ctly to the SSL 
0aa0: 6c 69 62 72 61 72 79 0a 20 20 2d 2d 65 6e 61 62  library.  --enab
0ab0: 6c 65 2d 68 61 72 64 65 6e 69 6e 67 20 20 20 20  le-hardening    
0ac0: 20 20 65 6e 61 62 6c 65 20 68 61 72 64 65 6e 69    enable hardeni
0ad0: 6e 67 20 61 74 74 65 6d 70 74 73 0a 20 20 2d 2d  ng attempts.  --
0ae0: 65 6e 61 62 6c 65 2d 73 74 61 74 69 63 2d 73 73  enable-static-ss
0af0: 6c 20 20 20 20 20 65 6e 61 62 6c 65 20 73 74 61  l     enable sta
0b00: 74 69 63 20 6c 69 6e 6b 69 6e 67 20 74 6f 20 74  tic linking to t
0b10: 68 65 20 53 53 4c 20 6c 69 62 72 61 72 79 0a 0a  he SSL library..
0b20: 49 66 20 65 69 74 68 65 72 20 54 43 4c 20 6f 72  If either TCL or
0b30: 20 4f 70 65 6e 53 53 4c 20 61 72 65 20 69 6e 73   OpenSSL are ins
0b40: 74 61 6c 6c 65 64 20 69 6e 20 6e 6f 6e 2d 73 74  talled in non-st
0b50: 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 6f 6e 73  andard locations
0b60: 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a  , the following.
0b70: 63 6f 6e 66 69 67 75 72 65 20 6f 70 74 69 6f 6e  configure option
0b80: 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 2e  s are available.
0b90: 20 46 6f 72 20 61 6c 6c 20 6f 70 74 69 6f 6e 73   For all options
0ba0: 2c 20 73 65 65 20 2e 2f 63 6f 6e 66 69 67 75 72  , see ./configur
0bb0: 65 20 2d 2d 68 65 6c 70 2e 0a 0a 20 20 2d 2d 77  e --help...  --w
0bc0: 69 74 68 2d 74 63 6c 3d 3c 64 69 72 3e 09 09 09  ith-tcl=<dir>...
0bd0: 70 61 74 68 20 74 6f 20 77 68 65 72 65 20 74 63  path to where tc
0be0: 6c 43 6f 6e 64 69 67 2e 73 68 20 66 69 6c 65 20  lCondig.sh file 
0bf0: 72 65 73 69 64 65 73 0a 20 20 2d 2d 77 69 74 68  resides.  --with
0c00: 2d 74 63 6c 69 6e 63 6c 75 64 65 3d 3c 64 69 72  -tclinclude=<dir
0c10: 3e 09 09 64 69 72 65 63 74 6f 72 79 20 63 6f 6e  >..directory con
0c20: 74 61 69 6e 69 6e 67 20 74 68 65 20 70 75 62 6c  taining the publ
0c30: 69 63 20 54 63 6c 20 68 65 61 64 65 72 20 66 69  ic Tcl header fi
0c40: 6c 65 73 0a 20 20 2d 2d 77 69 74 68 2d 6f 70 65  les.  --with-ope
0c50: 6e 73 73 6c 2d 64 69 72 3d 3c 64 69 72 3e 09 09  nssl-dir=<dir>..
0c60: 70 61 74 68 20 74 6f 20 72 6f 6f 74 20 64 69 72  path to root dir
0c70: 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e 53 53  ectory of OpenSS
0c80: 4c 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a 20  L installation. 
0c90: 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73 6c 2d   --with-openssl-
0ca0: 69 6e 63 6c 75 64 65 64 69 72 3d 3c 64 69 72 3e  includedir=<dir>
0cb0: 09 70 61 74 68 20 74 6f 20 69 6e 63 6c 75 64 65  .path to include
0cc0: 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 4f 70   directory of Op
0cd0: 65 6e 53 53 4c 20 69 6e 73 74 61 6c 6c 61 74 69  enSSL installati
0ce0: 6f 6e 0a 20 20 2d 2d 77 69 74 68 2d 6f 70 65 6e  on.  --with-open
0cf0: 73 73 6c 2d 6c 69 62 64 69 72 3d 3c 64 69 72 3e  ssl-libdir=<dir>
0d00: 09 09 70 61 74 68 20 74 6f 20 6c 69 62 20 64 69  ..path to lib di
0d10: 72 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e 53  rectory of OpenS
0d20: 53 4c 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a  SL installation.
0d30: 20 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73 6c    --with-openssl
0d40: 2d 70 6b 67 63 6f 6e 66 69 67 3d 3c 64 69 72 3e  -pkgconfig=<dir>
0d50: 09 70 61 74 68 20 74 6f 20 72 6f 6f 74 20 64 69  .path to root di
0d60: 72 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e 53  rectory of OpenS
0d70: 53 4c 20 70 6b 67 2d 63 6f 6e 66 69 67 20 64 69  SL pkg-config di
0d80: 72 65 63 74 6f 72 79 0a 0a 0a 4d 61 63 4f 53 0a  rectory...MacOS.
0d90: 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 73 74 61 6e 64  -----..The stand
0da0: 61 72 64 20 54 45 41 20 69 6e 73 74 61 6c 6c 61  ard TEA installa
0db0: 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 69 73 20  tion process is 
0dc0: 73 75 70 70 6f 72 74 65 64 2e 20 55 73 65 20 74  supported. Use t
0dd0: 68 65 20 2d 2d 77 69 74 68 2d 74 63 6c 20 6f 70  he --with-tcl op
0de0: 74 69 6f 6e 0a 74 6f 20 73 65 74 20 74 68 65 20  tion.to set the 
0df0: 54 43 4c 20 70 61 74 68 20 69 66 20 74 68 65 20  TCL path if the 
0e00: 41 63 74 69 76 65 53 74 61 74 65 20 6f 72 20 6f  ActiveState or o
0e10: 74 68 65 72 20 6e 6f 6e 2d 41 70 70 6c 65 20 76  ther non-Apple v
0e20: 65 72 73 69 6f 6e 20 6f 66 20 54 43 4c 20 69 73  ersion of TCL is
0e30: 20 74 6f 0a 62 65 20 75 73 65 64 2e 0a 0a 09 24   to.be used....$
0e40: 20 63 64 20 74 63 6c 74 6c 73 0a 09 24 20 2e 2f   cd tcltls..$ ./
0e50: 63 6f 6e 66 69 67 75 72 65 20 2d 2d 77 69 74 68  configure --with
0e60: 2d 74 63 6c 3d 2f 4c 69 62 72 61 72 79 2f 46 72  -tcl=/Library/Fr
0e70: 61 6d 65 77 6f 72 6b 73 2f 54 63 6c 2e 66 72 61  ameworks/Tcl.fra
0e80: 6d 65 77 6f 72 6b 2f 0a 09 24 20 6d 61 6b 65 0a  mework/..$ make.
0e90: 09 24 20 6d 61 6b 65 20 74 65 73 74 0a 09 24 20  .$ make test..$ 
0ea0: 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0a 0a 0a 57  make install...W
0eb0: 69 6e 64 6f 77 73 0a 2d 2d 2d 2d 2d 2d 2d 0a 0a  indows.-------..
0ec0: 49 66 20 69 6e 73 74 61 6c 6c 69 6e 67 20 77 69  If installing wi
0ed0: 74 68 20 4d 69 6e 47 57 2c 20 75 73 65 20 74 68  th MinGW, use th
0ee0: 65 20 54 45 41 20 62 75 69 6c 64 20 70 72 6f 63  e TEA build proc
0ef0: 65 73 73 2e 20 49 66 20 75 73 69 6e 67 20 4d 53  ess. If using MS
0f00: 20 56 69 73 75 61 6c 20 43 0a 28 4d 53 56 43 29   Visual C.(MSVC)
0f10: 2c 20 73 65 65 20 77 69 6e 2f 52 45 41 44 4d 45  , see win/README
0f20: 2e 74 78 74 20 66 6f 72 20 74 68 65 20 62 75 69  .txt for the bui
0f30: 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 61 74  ld and installat
0f40: 69 6f 6e 20 69 6e 73 74 72 75 63 74 69 6f 6e 73  ion instructions
0f50: 2e 0a 0a 0a 43 65 72 74 69 66 69 63 61 74 65 20  ....Certificate 
0f60: 56 61 6c 69 64 61 74 69 6f 6e 0a 2d 2d 2d 2d 2d  Validation.-----
0f70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0f80: 2d 0a 0a 49 66 20 4f 70 65 6e 53 53 4c 20 69 73  -..If OpenSSL is
0f90: 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65 64 20 6f   not installed o
0fa0: 6e 20 74 68 65 20 73 79 73 74 65 6d 20 6f 72 20  n the system or 
0fb0: 74 68 65 20 43 65 72 74 69 66 69 63 61 74 65 20  the Certificate 
0fc0: 41 75 74 68 6f 72 69 74 79 20 28 43 41 29 0a 63  Authority (CA).c
0fd0: 65 72 74 69 66 69 63 61 74 65 73 20 61 72 65 20  ertificates are 
0fe0: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 69 6e  not available in
0ff0: 20 50 45 4d 20 66 6f 72 6d 61 74 2c 20 74 68 65   PEM format, the
1000: 20 43 41 20 63 65 72 74 69 66 69 63 61 74 65 73   CA certificates
1010: 20 6d 75 73 74 20 62 65 0a 64 6f 77 6e 6c 6f 61   must be.downloa
1020: 64 65 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 65  ded and installe
1030: 64 20 77 69 74 68 20 74 68 65 20 73 6f 66 74 77  d with the softw
1040: 61 72 65 2e 20 54 68 65 73 65 20 61 72 65 20 72  are. These are r
1050: 65 71 75 69 72 65 64 20 73 69 6e 63 65 20 74 68  equired since th
1060: 65 79 20 61 72 65 0a 75 73 65 64 20 66 6f 72 20  ey are.used for 
1070: 63 65 72 74 69 66 69 63 61 74 65 20 76 61 6c 69  certificate vali
1080: 64 61 74 69 6f 6e 2e 20 54 68 65 20 43 55 52 4c  dation. The CURL
1090: 20 74 65 61 6d 20 6d 61 6b 65 73 20 74 68 65 6d   team makes them
10a0: 20 61 76 61 69 6c 61 62 6c 65 20 61 74 0a 68 74   available at.ht
10b0: 74 70 73 3a 2f 2f 63 75 72 6c 2e 73 65 2f 64 6f  tps://curl.se/do
10c0: 63 73 2f 63 61 65 78 74 72 61 63 74 2e 68 74 6d  cs/caextract.htm
10d0: 6c 2e 20 4c 6f 6f 6b 20 66 6f 72 20 74 68 65 20  l. Look for the 
10e0: 63 61 63 65 72 74 2e 70 65 6d 20 66 69 6c 65 2e  cacert.pem file.
10f0: 20 54 68 69 73 20 66 69 6c 65 0a 69 73 20 75 70   This file.is up
1100: 64 61 74 65 64 20 6f 6e 20 61 20 72 65 67 75 6c  dated on a regul
1110: 61 72 20 62 61 73 69 73 2e 0a 0a 0a 43 6f 70 79  ar basis....Copy
1120: 72 69 67 68 74 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d  rights.=========
1130: 3d 0a 0a 4f 72 69 67 69 6e 61 6c 20 54 4c 53 20  =..Original TLS 
1140: 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 31 39  Copyright (C) 19
1150: 39 37 2d 32 30 30 30 20 4d 61 74 74 20 4e 65 77  97-2000 Matt New
1160: 6d 61 6e 20 3c 6d 61 74 74 40 6e 6f 76 61 64 69  man <matt@novadi
1170: 67 6d 2e 63 6f 6d 3e 0a 54 4c 53 20 31 2e 34 2e  gm.com>.TLS 1.4.
1180: 31 20 20 20 20 43 6f 70 79 72 69 67 68 74 20 28  1    Copyright (
1190: 43 29 20 32 30 30 30 20 41 6a 75 62 61 20 53 6f  C) 2000 Ajuba So
11a0: 6c 75 74 69 6f 6e 73 0a 54 4c 53 20 31 2e 36 20  lutions.TLS 1.6 
11b0: 20 20 20 20 20 43 6f 70 79 72 69 67 68 74 20 28       Copyright (
11c0: 43 29 20 32 30 30 38 20 41 63 74 69 76 65 53 74  C) 2008 ActiveSt
11d0: 61 74 65 20 53 6f 66 74 77 61 72 65 20 49 6e 63  ate Software Inc
11e0: 2e 0a 54 4c 53 20 31 2e 37 20 20 20 20 20 20 43  ..TLS 1.7      C
11f0: 6f 70 79 72 69 67 68 74 20 28 43 29 20 32 30 31  opyright (C) 201
1200: 36 20 4d 61 74 74 20 4e 65 77 6d 61 6e 2c 20 41  6 Matt Newman, A
1210: 6a 75 62 61 20 53 6f 6c 75 74 69 6f 6e 73 2c 20  juba Solutions, 
1220: 41 63 74 69 76 65 53 74 61 74 65 0a 20 20 20 20  ActiveState.    
1230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1240: 20 20 20 20 20 20 20 20 20 20 20 20 53 6f 66 74              Soft
1250: 77 61 72 65 20 49 6e 63 2c 20 52 6f 79 20 4b 65  ware Inc, Roy Ke
1260: 65 6e 65 20 3c 74 63 6c 74 6c 73 40 72 6b 65 65  ene <tcltls@rkee
1270: 6e 65 2e 6f 72 67 3e 0a 54 4c 53 20 31 2e 38 2d  ne.org>.TLS 1.8-
1280: 32 2e 30 20 20 43 6f 70 79 72 69 67 68 74 20 28  2.0  Copyright (
1290: 43 29 20 32 30 32 33 2d 32 30 32 36 20 42 72 69  C) 2023-2026 Bri
12a0: 61 6e 20 4f 27 48 61 67 61 6e 0a 0a 41 63 6b 6e  an O'Hagan..Ackn
12b0: 6f 77 6c 65 64 67 6d 65 6e 74 73 0a 3d 3d 3d 3d  owledgments.====
12c0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 4e 6f 6e  ===========..Non
12d0: 2d 65 78 63 6c 75 73 69 76 65 20 63 72 65 64 69  -exclusive credi
12e0: 74 73 20 66 6f 72 20 54 4c 53 20 61 72 65 3a 0a  ts for TLS are:.
12f0: 20 20 20 4f 72 69 67 69 6e 61 6c 20 77 6f 72 6b     Original work
1300: 3a 20 4d 61 74 74 20 4e 65 77 6d 61 6e 20 40 20  : Matt Newman @ 
1310: 4e 6f 76 61 64 69 67 6d 0a 20 20 20 55 70 64 61  Novadigm.   Upda
1320: 74 65 73 3a 20 4a 65 66 66 20 48 6f 62 62 73 20  tes: Jeff Hobbs 
1330: 40 20 41 63 74 69 76 65 53 74 61 74 65 0a 20 20  @ ActiveState.  
1340: 20 54 63 6c 20 43 68 61 6e 6e 65 6c 20 6d 65 63   Tcl Channel mec
1350: 68 61 6e 69 73 6d 3a 20 41 6e 64 72 65 61 73 20  hanism: Andreas 
1360: 4b 75 70 72 69 65 73 0a 20 20 20 49 6d 70 65 74  Kupries.   Impet
1370: 75 73 2f 52 65 6c 61 74 65 64 20 77 6f 72 6b 3a  us/Related work:
1380: 20 74 63 6c 53 53 4c 20 28 43 6f 6c 69 6e 20 4d   tclSSL (Colin M
1390: 63 43 6f 72 6d 61 63 6b 2c 20 53 68 61 72 65 64  cCormack, Shared
13a0: 20 54 65 63 68 6e 6f 6c 6f 67 79 29 0a 20 20 20   Technology).   
13b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
13c0: 20 20 20 20 20 20 53 53 4c 74 63 6c 20 28 50 65        SSLtcl (Pe
13d0: 74 65 72 20 41 6e 74 6d 61 6e 29 0a 0a 4c 69 63  ter Antman)..Lic
13e0: 65 6e 73 65 0a 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68  ense.=======..Th
13f0: 69 73 20 63 6f 64 65 20 69 73 20 6c 69 63 65 6e  is code is licen
1400: 73 65 64 20 75 6e 64 65 72 20 74 68 65 20 73 61  sed under the sa
1410: 6d 65 20 74 65 72 6d 73 20 61 73 20 74 68 65 20  me terms as the 
1420: 54 63 6c 20 43 6f 72 65 2e 0a                    Tcl Core..