Hex Artifact Content

Artifact eaa33749538e0f88ded070c7b7d733f1ebb93f8436a03f95169fe62b5c4b2bfa:


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 44 6f 63 75 6d 65 6e  orted....Documen
0260: 74 61 74 69 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d  tation.=========
0270: 3d 3d 3d 3d 0a 0a 53 65 65 20 74 68 65 20 64 6f  ====..See the do
0280: 63 20 64 69 72 65 63 74 6f 72 79 20 66 6f 72 20  c directory for 
0290: 74 68 65 20 66 75 6c 6c 20 75 73 61 67 65 20 64  the full usage d
02a0: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 0a 0a 0a  ocumentation....
02b0: 43 6f 6d 70 61 74 69 62 69 6c 69 74 79 0a 3d 3d  Compatibility.==
02c0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 43 4c  ===========..TCL
02d0: 0a 2d 2d 2d 0a 0a 54 68 69 73 20 70 61 63 6b 61  .---..This packa
02e0: 67 65 20 72 65 71 75 69 72 65 73 20 54 43 4c 20  ge requires TCL 
02f0: 38 2e 35 20 6f 72 20 6c 61 74 65 72 2e 20 49 74  8.5 or later. It
0300: 20 77 69 6c 6c 20 61 6c 73 6f 20 77 6f 72 6b 20   will also work 
0310: 77 69 74 68 20 54 43 4c 20 39 2c 20 62 75 74 20  with TCL 9, but 
0320: 69 74 20 69 73 0a 6e 6f 74 20 62 69 6e 61 72 79  it is.not binary
0330: 20 63 6f 6d 70 61 74 69 62 6c 65 20 62 65 74 77   compatible betw
0340: 65 65 6e 20 6d 61 6a 6f 72 20 54 43 4c 20 76 65  een major TCL ve
0350: 72 73 69 6f 6e 73 2e 20 54 68 69 73 20 6d 65 61  rsions. This mea
0360: 6e 73 20 69 66 20 74 68 69 73 20 65 78 74 65 6e  ns if this exten
0370: 73 69 6f 6e 0a 69 73 20 62 75 69 6c 74 20 77 69  sion.is built wi
0380: 74 68 20 54 43 4c 20 38 2e 78 20 69 74 20 77 69  th TCL 8.x it wi
0390: 6c 6c 20 6e 6f 74 20 6c 6f 61 64 20 69 6e 74 6f  ll not load into
03a0: 20 54 43 4c 20 39 20 6f 72 20 76 69 63 65 20 76   TCL 9 or vice v
03b0: 65 72 73 61 2e 20 49 74 20 69 73 20 62 65 73 74  ersa. It is best
03c0: 0a 74 6f 20 63 6f 6d 70 69 6c 65 20 62 6f 74 68  .to compile both
03d0: 20 73 65 70 61 72 61 74 65 6c 79 20 74 68 65 6e   separately then
03e0: 20 69 6e 73 74 61 6c 6c 20 74 68 65 6d 20 77 69   install them wi
03f0: 74 68 20 74 68 65 20 63 6f 6d 70 61 74 69 62 6c  th the compatibl
0400: 65 20 54 43 4c 20 76 65 72 73 69 6f 6e 73 2e 0a  e TCL versions..
0410: 0a 4f 70 65 6e 53 53 4c 0a 2d 2d 2d 2d 2d 2d 2d  .OpenSSL.-------
0420: 0a 0a 54 68 69 73 20 70 61 63 6b 61 67 65 20 69  ..This package i
0430: 73 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74  s compatible wit
0440: 68 20 4f 70 65 6e 53 53 4c 20 76 31 2e 31 2e 31  h OpenSSL v1.1.1
0450: 20 6f 72 20 6c 61 74 65 72 2c 20 74 68 6f 75 67   or later, thoug
0460: 68 20 33 2e 32 20 6f 72 20 6c 61 74 65 72 20 69  h 3.2 or later i
0470: 73 0a 70 72 65 66 65 72 72 65 64 2e 20 53 65 65  s.preferred. See
0480: 20 68 74 74 70 3a 2f 2f 77 77 77 2e 6f 70 65 6e   http://www.open
0490: 73 73 6c 2e 6f 72 67 2f 2e 20 50 6c 65 61 73 65  ssl.org/. Please
04a0: 20 6e 6f 74 65 20 74 68 61 74 20 74 68 65 72 65   note that there
04b0: 20 61 72 65 20 61 20 66 65 77 20 41 50 49 0a 69   are a few API.i
04c0: 6e 63 6f 6d 70 61 74 69 62 69 6c 69 74 69 65 73  ncompatibilities
04d0: 20 62 65 74 77 65 65 6e 20 4f 70 65 6e 53 53 4c   between OpenSSL
04e0: 20 31 2e 31 2e 31 20 61 6e 64 20 33 2e 78 2c 20   1.1.1 and 3.x, 
04f0: 73 6f 20 69 66 20 74 68 69 73 20 65 78 74 65 6e  so if this exten
0500: 73 69 6f 6e 20 69 73 20 62 75 69 6c 74 0a 61 67  sion is built.ag
0510: 61 69 6e 73 74 20 4f 70 65 6e 53 53 4c 20 31 2e  ainst OpenSSL 1.
0520: 31 2e 31 20 69 74 20 69 73 20 6e 6f 74 20 62 69  1.1 it is not bi
0530: 6e 61 72 79 20 63 6f 6d 70 61 74 69 62 6c 65 20  nary compatible 
0540: 77 69 74 68 20 4f 70 65 6e 53 53 4c 20 33 2e 78  with OpenSSL 3.x
0550: 20 6f 72 20 76 69 63 65 0a 76 65 72 73 61 2e 0a   or vice.versa..
0560: 0a 54 43 4c 54 4c 53 0a 2d 2d 2d 2d 2d 2d 0a 0a  .TCLTLS.------..
0570: 54 68 65 72 65 20 77 65 72 65 20 73 65 76 65 72  There were sever
0580: 61 6c 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20  al changes made 
0590: 69 6e 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  in the callback 
05a0: 63 6f 6d 6d 61 6e 64 20 61 72 67 75 6d 65 6e 74  command argument
05b0: 73 20 62 65 74 77 65 65 6e 0a 76 65 72 73 69 6f  s between.versio
05c0: 6e 73 20 31 2e 37 20 61 6e 64 20 32 2e 30 2e 20  ns 1.7 and 2.0. 
05d0: 53 65 65 20 64 6f 63 2f 74 6c 73 2e 68 74 6d 6c  See doc/tls.html
05e0: 20 66 6f 72 20 77 68 61 74 20 63 68 61 6e 67 65   for what change
05f0: 64 20 61 6e 64 20 6c 69 62 72 61 72 79 2f 74 6c  d and library/tl
0600: 73 2e 74 63 6c 0a 66 6f 72 20 65 78 61 6d 70 6c  s.tcl.for exampl
0610: 65 20 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69  e handler functi
0620: 6f 6e 73 20 74 68 61 74 20 61 72 65 20 62 61 63  ons that are bac
0630: 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 6c  kwards compatibl
0640: 65 2e 0a 0a 0a 49 6e 73 74 61 6c 6c 61 74 69 6f  e....Installatio
0650: 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a  n.============..
0660: 54 68 69 73 20 70 61 63 6b 61 67 65 20 75 73 65  This package use
0670: 73 20 74 68 65 20 54 43 4c 20 45 78 74 65 6e 73  s the TCL Extens
0680: 69 6f 6e 20 41 72 63 68 69 74 65 63 74 75 72 65  ion Architecture
0690: 20 28 54 45 41 29 20 74 6f 20 62 75 69 6c 64 20   (TEA) to build 
06a0: 61 6e 64 20 69 6e 73 74 61 6c 6c 20 6f 6e 0a 61  and install on.a
06b0: 6e 79 20 73 75 70 70 6f 72 74 65 64 20 55 6e 69  ny supported Uni
06c0: 78 2c 20 4d 61 63 2c 20 6f 72 20 4d 53 20 57 69  x, Mac, or MS Wi
06d0: 6e 64 6f 77 73 20 73 79 73 74 65 6d 2e 20 49 74  ndows system. It
06e0: 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65 20   depends on the 
06f0: 4f 70 65 6e 53 53 4c 0a 6c 69 62 72 61 72 69 65  OpenSSL.librarie
0700: 73 20 62 65 69 6e 67 20 61 76 61 69 6c 61 62 6c  s being availabl
0710: 65 20 70 72 69 6f 72 20 74 6f 20 62 75 69 6c 64  e prior to build
0720: 69 6e 67 20 74 68 65 20 54 43 4c 54 4c 53 20 65  ing the TCLTLS e
0730: 78 74 65 6e 73 69 6f 6e 2e 0a 0a 55 4e 49 58 20  xtension...UNIX 
0740: 61 6e 64 20 4c 69 6e 75 78 0a 2d 2d 2d 2d 2d 2d  and Linux.------
0750: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 73 74  --------..The st
0760: 61 6e 64 61 72 64 20 54 45 41 20 63 6f 6e 66 69  andard TEA confi
0770: 67 2c 20 6d 61 6b 65 2c 20 61 6e 64 20 69 6e 73  g, make, and ins
0780: 74 61 6c 6c 20 70 72 6f 63 65 73 73 20 69 73 20  tall process is 
0790: 73 75 70 70 6f 72 74 65 64 2e 0a 0a 09 24 20 63  supported....$ c
07a0: 64 20 74 63 6c 74 6c 73 0a 09 24 20 2e 2f 63 6f  d tcltls..$ ./co
07b0: 6e 66 69 67 75 72 65 20 2d 2d 65 6e 61 62 6c 65  nfigure --enable
07c0: 2d 36 34 62 69 74 0a 09 24 20 6d 61 6b 65 0a 09  -64bit..$ make..
07d0: 24 20 6d 61 6b 65 20 74 65 73 74 0a 09 24 20 6d  $ make test..$ m
07e0: 61 6b 65 20 69 6e 73 74 61 6c 6c 0a 0a 54 68 65  ake install..The
07f0: 20 73 75 70 70 6f 72 74 65 64 20 63 6f 6e 66 69   supported confi
0800: 67 75 72 65 20 6f 70 74 69 6f 6e 73 20 69 6e 63  gure options inc
0810: 6c 75 64 65 20 61 6c 6c 20 6f 66 20 74 68 65 20  lude all of the 
0820: 73 74 61 6e 64 61 72 64 20 54 45 41 20 63 6f 6e  standard TEA con
0830: 66 69 67 75 72 65 0a 73 63 72 69 70 74 20 6f 70  figure.script op
0840: 74 69 6f 6e 73 2c 20 70 6c 75 73 3a 0a 0a 20 20  tions, plus:..  
0850: 2d 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31 20 20  --disable-tls1  
0860: 20 20 20 20 20 20 20 20 64 69 73 61 62 6c 65 20          disable 
0870: 54 4c 53 31 20 70 72 6f 74 6f 63 6f 6c 0a 20 20  TLS1 protocol.  
0880: 2d 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31 5f 31  --disable-tls1_1
0890: 20 20 20 20 20 20 20 20 64 69 73 61 62 6c 65 20          disable 
08a0: 54 4c 53 31 2e 31 20 70 72 6f 74 6f 63 6f 6c 0a  TLS1.1 protocol.
08b0: 20 20 2d 2d 64 69 73 61 62 6c 65 2d 74 6c 73 31    --disable-tls1
08c0: 5f 32 20 20 20 20 20 20 20 20 64 69 73 61 62 6c  _2        disabl
08d0: 65 20 54 4c 53 31 2e 32 20 70 72 6f 74 6f 63 6f  e TLS1.2 protoco
08e0: 6c 0a 20 20 2d 2d 64 69 73 61 62 6c 65 2d 74 6c  l.  --disable-tl
08f0: 73 31 5f 33 20 20 20 20 20 20 20 20 64 69 73 61  s1_3        disa
0900: 62 6c 65 20 54 4c 53 31 2e 33 20 70 72 6f 74 6f  ble TLS1.3 proto
0910: 63 6f 6c 0a 20 20 2d 2d 65 6e 61 62 6c 65 2d 64  col.  --enable-d
0920: 65 62 75 67 20 20 20 20 20 20 20 20 20 20 65 6e  ebug          en
0930: 61 62 6c 65 20 64 65 62 75 67 67 69 6e 67 20 6d  able debugging m
0940: 6f 64 65 20 61 6e 64 20 6f 75 74 70 75 74 20 6d  ode and output m
0950: 6f 72 65 20 73 74 61 74 75 73 0a 20 20 2d 2d 65  ore status.  --e
0960: 6e 61 62 6c 65 2d 73 73 6c 2d 66 61 73 74 70 61  nable-ssl-fastpa
0970: 74 68 20 20 20 65 6e 61 62 6c 65 20 75 73 69 6e  th   enable usin
0980: 67 20 74 68 65 20 75 6e 64 65 72 6c 79 69 6e 67  g the underlying
0990: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72   file descriptor
09a0: 20 66 6f 72 20 74 61 6c 6b 69 6e 67 20 64 69 72   for talking dir
09b0: 65 63 74 6c 79 20 74 6f 20 74 68 65 20 53 53 4c  ectly to the SSL
09c0: 20 6c 69 62 72 61 72 79 0a 20 20 2d 2d 65 6e 61   library.  --ena
09d0: 62 6c 65 2d 68 61 72 64 65 6e 69 6e 67 20 20 20  ble-hardening   
09e0: 20 20 20 65 6e 61 62 6c 65 20 68 61 72 64 65 6e     enable harden
09f0: 69 6e 67 20 61 74 74 65 6d 70 74 73 0a 20 20 2d  ing attempts.  -
0a00: 2d 65 6e 61 62 6c 65 2d 73 74 61 74 69 63 2d 73  -enable-static-s
0a10: 73 6c 20 20 20 20 20 65 6e 61 62 6c 65 20 73 74  sl     enable st
0a20: 61 74 69 63 20 6c 69 6e 6b 69 6e 67 20 74 6f 20  atic linking to 
0a30: 74 68 65 20 53 53 4c 20 6c 69 62 72 61 72 79 0a  the SSL library.
0a40: 0a 49 66 20 65 69 74 68 65 72 20 54 43 4c 20 6f  .If either TCL o
0a50: 72 20 4f 70 65 6e 53 53 4c 20 61 72 65 20 69 6e  r OpenSSL are in
0a60: 73 74 61 6c 6c 65 64 20 69 6e 20 6e 6f 6e 2d 73  stalled in non-s
0a70: 74 61 6e 64 61 72 64 20 6c 6f 63 61 74 69 6f 6e  tandard location
0a80: 73 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  s, the following
0a90: 0a 63 6f 6e 66 69 67 75 72 65 20 6f 70 74 69 6f  .configure optio
0aa0: 6e 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65  ns are available
0ab0: 2e 20 46 6f 72 20 61 6c 6c 20 6f 70 74 69 6f 6e  . For all option
0ac0: 73 2c 20 73 65 65 20 2e 2f 63 6f 6e 66 69 67 75  s, see ./configu
0ad0: 72 65 20 2d 2d 68 65 6c 70 2e 0a 0a 20 20 2d 2d  re --help...  --
0ae0: 77 69 74 68 2d 74 63 6c 3d 3c 64 69 72 3e 09 09  with-tcl=<dir>..
0af0: 09 70 61 74 68 20 74 6f 20 77 68 65 72 65 20 74  .path to where t
0b00: 63 6c 43 6f 6e 64 69 67 2e 73 68 20 66 69 6c 65  clCondig.sh file
0b10: 20 72 65 73 69 64 65 73 0a 20 20 2d 2d 77 69 74   resides.  --wit
0b20: 68 2d 74 63 6c 69 6e 63 6c 75 64 65 3d 3c 64 69  h-tclinclude=<di
0b30: 72 3e 09 09 64 69 72 65 63 74 6f 72 79 20 63 6f  r>..directory co
0b40: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 70 75 62  ntaining the pub
0b50: 6c 69 63 20 54 63 6c 20 68 65 61 64 65 72 20 66  lic Tcl header f
0b60: 69 6c 65 73 0a 20 20 2d 2d 77 69 74 68 2d 6f 70  iles.  --with-op
0b70: 65 6e 73 73 6c 2d 64 69 72 3d 3c 64 69 72 3e 09  enssl-dir=<dir>.
0b80: 09 70 61 74 68 20 74 6f 20 72 6f 6f 74 20 64 69  .path to root di
0b90: 72 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e 53  rectory of OpenS
0ba0: 53 4c 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a  SL installation.
0bb0: 20 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73 6c    --with-openssl
0bc0: 2d 69 6e 63 6c 75 64 65 64 69 72 3d 3c 64 69 72  -includedir=<dir
0bd0: 3e 09 70 61 74 68 20 74 6f 20 69 6e 63 6c 75 64  >.path to includ
0be0: 65 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 4f  e directory of O
0bf0: 70 65 6e 53 53 4c 20 69 6e 73 74 61 6c 6c 61 74  penSSL installat
0c00: 69 6f 6e 0a 20 20 2d 2d 77 69 74 68 2d 6f 70 65  ion.  --with-ope
0c10: 6e 73 73 6c 2d 6c 69 62 64 69 72 3d 3c 64 69 72  nssl-libdir=<dir
0c20: 3e 09 09 70 61 74 68 20 74 6f 20 6c 69 62 20 64  >..path to lib d
0c30: 69 72 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e  irectory of Open
0c40: 53 53 4c 20 69 6e 73 74 61 6c 6c 61 74 69 6f 6e  SSL installation
0c50: 0a 20 20 2d 2d 77 69 74 68 2d 6f 70 65 6e 73 73  .  --with-openss
0c60: 6c 2d 70 6b 67 63 6f 6e 66 69 67 3d 3c 64 69 72  l-pkgconfig=<dir
0c70: 3e 09 70 61 74 68 20 74 6f 20 72 6f 6f 74 20 64  >.path to root d
0c80: 69 72 65 63 74 6f 72 79 20 6f 66 20 4f 70 65 6e  irectory of Open
0c90: 53 53 4c 20 70 6b 67 2d 63 6f 6e 66 69 67 20 64  SSL pkg-config d
0ca0: 69 72 65 63 74 6f 72 79 0a 0a 0a 4d 61 63 4f 53  irectory...MacOS
0cb0: 0a 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 73 74 61 6e  .-----..The stan
0cc0: 64 61 72 64 20 54 45 41 20 69 6e 73 74 61 6c 6c  dard TEA install
0cd0: 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 20 69 73  ation process is
0ce0: 20 73 75 70 70 6f 72 74 65 64 2e 20 55 73 65 20   supported. Use 
0cf0: 74 68 65 20 2d 2d 77 69 74 68 2d 74 63 6c 20 6f  the --with-tcl o
0d00: 70 74 69 6f 6e 0a 74 6f 20 73 65 74 20 74 68 65  ption.to set the
0d10: 20 54 43 4c 20 70 61 74 68 20 69 66 20 74 68 65   TCL path if the
0d20: 20 41 63 74 69 76 65 53 74 61 74 65 20 6f 72 20   ActiveState or 
0d30: 6f 74 68 65 72 20 6e 6f 6e 2d 41 70 70 6c 65 20  other non-Apple 
0d40: 76 65 72 73 69 6f 6e 20 6f 66 20 54 43 4c 20 69  version of TCL i
0d50: 73 20 74 6f 0a 62 65 20 75 73 65 64 2e 0a 0a 09  s to.be used....
0d60: 24 20 63 64 20 74 63 6c 74 6c 73 0a 09 24 20 2e  $ cd tcltls..$ .
0d70: 2f 63 6f 6e 66 69 67 75 72 65 20 2d 2d 77 69 74  /configure --wit
0d80: 68 2d 74 63 6c 3d 2f 4c 69 62 72 61 72 79 2f 46  h-tcl=/Library/F
0d90: 72 61 6d 65 77 6f 72 6b 73 2f 54 63 6c 2e 66 72  rameworks/Tcl.fr
0da0: 61 6d 65 77 6f 72 6b 2f 0a 09 24 20 6d 61 6b 65  amework/..$ make
0db0: 0a 09 24 20 6d 61 6b 65 20 74 65 73 74 0a 09 24  ..$ make test..$
0dc0: 20 6d 61 6b 65 20 69 6e 73 74 61 6c 6c 0a 0a 0a   make install...
0dd0: 57 69 6e 64 6f 77 73 0a 2d 2d 2d 2d 2d 2d 2d 0a  Windows.-------.
0de0: 0a 49 66 20 69 6e 73 74 61 6c 6c 69 6e 67 20 77  .If installing w
0df0: 69 74 68 20 4d 69 6e 47 57 2c 20 75 73 65 20 74  ith MinGW, use t
0e00: 68 65 20 54 45 41 20 62 75 69 6c 64 20 70 72 6f  he TEA build pro
0e10: 63 65 73 73 2e 20 49 66 20 75 73 69 6e 67 20 4d  cess. If using M
0e20: 53 20 56 69 73 75 61 6c 20 43 0a 28 4d 53 56 43  S Visual C.(MSVC
0e30: 29 2c 20 73 65 65 20 77 69 6e 2f 52 45 41 44 4d  ), see win/READM
0e40: 45 2e 74 78 74 20 66 6f 72 20 74 68 65 20 62 75  E.txt for the bu
0e50: 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c 6c 61  ild and installa
0e60: 74 69 6f 6e 20 69 6e 73 74 72 75 63 74 69 6f 6e  tion instruction
0e70: 73 2e 0a 0a 0a 43 65 72 74 69 66 69 63 61 74 65  s....Certificate
0e80: 20 56 61 6c 69 64 61 74 69 6f 6e 0a 2d 2d 2d 2d   Validation.----
0e90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0ea0: 2d 2d 0a 0a 49 66 20 4f 70 65 6e 53 53 4c 20 69  --..If OpenSSL i
0eb0: 73 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65 64 20  s not installed 
0ec0: 6f 6e 20 74 68 65 20 73 79 73 74 65 6d 2c 20 74  on the system, t
0ed0: 68 65 20 43 65 72 74 69 66 69 63 61 74 65 20 41  he Certificate A
0ee0: 75 74 68 6f 72 69 74 79 20 28 43 41 29 0a 70 72  uthority (CA).pr
0ef0: 6f 76 69 64 65 64 20 63 65 72 74 69 66 69 63 61  ovided certifica
0f00: 74 65 73 20 6d 75 73 74 20 62 65 20 64 6f 77 6e  tes must be down
0f10: 6c 6f 61 64 65 64 20 61 6e 64 20 69 6e 73 74 61  loaded and insta
0f20: 6c 6c 65 64 20 77 69 74 68 20 74 68 65 20 73 6f  lled with the so
0f30: 66 74 77 61 72 65 2e 0a 54 68 65 73 65 20 61 72  ftware..These ar
0f40: 65 20 75 73 65 64 20 66 6f 72 20 63 65 72 74 69  e used for certi
0f50: 66 69 63 61 74 65 20 76 61 6c 69 64 61 74 69 6f  ficate validatio
0f60: 6e 2e 20 54 68 65 20 43 55 52 4c 20 74 65 61 6d  n. The CURL team
0f70: 20 6d 61 6b 65 73 20 74 68 65 6d 20 61 76 61 69   makes them avai
0f80: 6c 61 62 6c 65 0a 61 74 20 68 74 74 70 73 3a 2f  lable.at https:/
0f90: 2f 63 75 72 6c 2e 73 65 2f 64 6f 63 73 2f 63 61  /curl.se/docs/ca
0fa0: 65 78 74 72 61 63 74 2e 68 74 6d 6c 2e 20 4c 6f  extract.html. Lo
0fb0: 6f 6b 20 66 6f 72 20 74 68 65 20 63 61 63 65 72  ok for the cacer
0fc0: 74 2e 70 65 6d 20 66 69 6c 65 2e 0a 0a 0a 43 6f  t.pem file....Co
0fd0: 70 79 72 69 67 68 74 73 0a 3d 3d 3d 3d 3d 3d 3d  pyrights.=======
0fe0: 3d 3d 3d 0a 0a 4f 72 69 67 69 6e 61 6c 20 54 4c  ===..Original TL
0ff0: 53 20 43 6f 70 79 72 69 67 68 74 20 28 43 29 20  S Copyright (C) 
1000: 31 39 39 37 2d 32 30 30 30 20 4d 61 74 74 20 4e  1997-2000 Matt N
1010: 65 77 6d 61 6e 20 3c 6d 61 74 74 40 6e 6f 76 61  ewman <matt@nova
1020: 64 69 67 6d 2e 63 6f 6d 3e 0a 54 4c 53 20 31 2e  digm.com>.TLS 1.
1030: 34 2e 31 20 20 20 20 43 6f 70 79 72 69 67 68 74  4.1    Copyright
1040: 20 28 43 29 20 32 30 30 30 20 41 6a 75 62 61 20   (C) 2000 Ajuba 
1050: 53 6f 6c 75 74 69 6f 6e 73 0a 54 4c 53 20 31 2e  Solutions.TLS 1.
1060: 36 20 20 20 20 20 20 43 6f 70 79 72 69 67 68 74  6      Copyright
1070: 20 28 43 29 20 32 30 30 38 20 41 63 74 69 76 65   (C) 2008 Active
1080: 53 74 61 74 65 20 53 6f 66 74 77 61 72 65 20 49  State Software I
1090: 6e 63 2e 0a 54 4c 53 20 31 2e 37 20 20 20 20 20  nc..TLS 1.7     
10a0: 20 43 6f 70 79 72 69 67 68 74 20 28 43 29 20 32   Copyright (C) 2
10b0: 30 31 36 20 4d 61 74 74 20 4e 65 77 6d 61 6e 2c  016 Matt Newman,
10c0: 20 41 6a 75 62 61 20 53 6f 6c 75 74 69 6f 6e 73   Ajuba Solutions
10d0: 2c 20 41 63 74 69 76 65 53 74 61 74 65 0a 20 20  , ActiveState.  
10e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
10f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 6f                So
1100: 66 74 77 61 72 65 20 49 6e 63 2c 20 52 6f 79 20  ftware Inc, Roy 
1110: 4b 65 65 6e 65 20 3c 74 63 6c 74 6c 73 40 72 6b  Keene <tcltls@rk
1120: 65 65 6e 65 2e 6f 72 67 3e 0a 54 4c 53 20 31 2e  eene.org>.TLS 1.
1130: 38 2d 32 2e 30 20 20 43 6f 70 79 72 69 67 68 74  8-2.0  Copyright
1140: 20 28 43 29 20 32 30 32 33 2d 32 30 32 34 20 42   (C) 2023-2024 B
1150: 72 69 61 6e 20 4f 27 48 61 67 61 6e 0a 0a 41 63  rian O'Hagan..Ac
1160: 6b 6e 6f 77 6c 65 64 67 6d 65 6e 74 73 0a 3d 3d  knowledgments.==
1170: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 4e  =============..N
1180: 6f 6e 2d 65 78 63 6c 75 73 69 76 65 20 63 72 65  on-exclusive cre
1190: 64 69 74 73 20 66 6f 72 20 54 4c 53 20 61 72 65  dits for TLS are
11a0: 3a 0a 20 20 20 4f 72 69 67 69 6e 61 6c 20 77 6f  :.   Original wo
11b0: 72 6b 3a 20 4d 61 74 74 20 4e 65 77 6d 61 6e 20  rk: Matt Newman 
11c0: 40 20 4e 6f 76 61 64 69 67 6d 0a 20 20 20 55 70  @ Novadigm.   Up
11d0: 64 61 74 65 73 3a 20 4a 65 66 66 20 48 6f 62 62  dates: Jeff Hobb
11e0: 73 20 40 20 41 63 74 69 76 65 53 74 61 74 65 0a  s @ ActiveState.
11f0: 20 20 20 54 63 6c 20 43 68 61 6e 6e 65 6c 20 6d     Tcl Channel m
1200: 65 63 68 61 6e 69 73 6d 3a 20 41 6e 64 72 65 61  echanism: Andrea
1210: 73 20 4b 75 70 72 69 65 73 0a 20 20 20 49 6d 70  s Kupries.   Imp
1220: 65 74 75 73 2f 52 65 6c 61 74 65 64 20 77 6f 72  etus/Related wor
1230: 6b 3a 20 74 63 6c 53 53 4c 20 28 43 6f 6c 69 6e  k: tclSSL (Colin
1240: 20 4d 63 43 6f 72 6d 61 63 6b 2c 20 53 68 61 72   McCormack, Shar
1250: 65 64 20 54 65 63 68 6e 6f 6c 6f 67 79 29 0a 20  ed Technology). 
1260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1270: 20 20 20 20 20 20 20 20 53 53 4c 74 63 6c 20 28          SSLtcl (
1280: 50 65 74 65 72 20 41 6e 74 6d 61 6e 29 0a 0a 4c  Peter Antman)..L
1290: 69 63 65 6e 73 65 0a 3d 3d 3d 3d 3d 3d 3d 0a 0a  icense.=======..
12a0: 54 68 69 73 20 63 6f 64 65 20 69 73 20 6c 69 63  This code is lic
12b0: 65 6e 73 65 64 20 75 6e 64 65 72 20 74 68 65 20  ensed under the 
12c0: 73 61 6d 65 20 74 65 72 6d 73 20 61 73 20 74 68  same terms as th
12d0: 65 20 54 63 6c 20 43 6f 72 65 2e 0a              e Tcl Core..