Hex Artifact Content

Artifact c7887e2d3217cd743948ebcf98e1c64a1ded86c5ccb8ffafbcdeea6ef9996678:


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 2c  v1.1.1 or later,
0500: 20 74 68 6f 75 67 68 20 33 2e 32 20 6f 72 20 6c   though 3.2 or l
0510: 61 74 65 72 20 69 73 0a 70 72 65 66 65 72 72 65  ater is.preferre
0520: 64 2e 20 53 65 65 20 68 74 74 70 3a 2f 2f 77 77  d. See http://ww
0530: 77 2e 6f 70 65 6e 73 73 6c 2e 6f 72 67 2f 2e 20  w.openssl.org/. 
0540: 50 6c 65 61 73 65 20 6e 6f 74 65 20 74 68 61 74  Please note that
0550: 20 74 68 65 72 65 20 61 72 65 20 61 20 66 65 77   there are a few
0560: 20 41 50 49 0a 69 6e 63 6f 6d 70 61 74 69 62 69   API.incompatibi
0570: 6c 69 74 69 65 73 20 62 65 74 77 65 65 6e 20 4f  lities between O
0580: 70 65 6e 53 53 4c 20 31 2e 31 2e 31 20 61 6e 64  penSSL 1.1.1 and
0590: 20 33 2e 78 2c 20 73 6f 20 69 66 20 74 68 69 73   3.x, so if this
05a0: 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 62 75   extension is bu
05b0: 69 6c 74 0a 61 67 61 69 6e 73 74 20 4f 70 65 6e  ilt.against Open
05c0: 53 53 4c 20 31 2e 31 2e 31 20 69 74 20 69 73 20  SSL 1.1.1 it is 
05d0: 6e 6f 74 20 62 69 6e 61 72 79 20 63 6f 6d 70 61  not binary compa
05e0: 74 69 62 6c 65 20 77 69 74 68 20 4f 70 65 6e 53  tible with OpenS
05f0: 53 4c 20 33 2e 78 20 6f 72 20 76 69 63 65 0a 76  SL 3.x or vice.v
0600: 65 72 73 61 2e 0a 0a 54 43 4c 54 4c 53 0a 2d 2d  ersa...TCLTLS.--
0610: 2d 2d 2d 2d 0a 0a 54 68 65 72 65 20 77 65 72 65  ----..There were
0620: 20 73 65 76 65 72 61 6c 20 63 68 61 6e 67 65 73   several changes
0630: 20 6d 61 64 65 20 69 6e 20 74 68 65 20 63 61 6c   made in the cal
0640: 6c 62 61 63 6b 20 63 6f 6d 6d 61 6e 64 20 61 72  lback command ar
0650: 67 75 6d 65 6e 74 73 20 62 65 74 77 65 65 6e 0a  guments between.
0660: 76 65 72 73 69 6f 6e 73 20 31 2e 37 20 61 6e 64  versions 1.7 and
0670: 20 32 2e 30 2e 20 53 65 65 20 64 6f 63 2f 74 6c   2.0. See doc/tl
0680: 73 2e 68 74 6d 6c 20 66 6f 72 20 77 68 61 74 20  s.html for what 
0690: 63 68 61 6e 67 65 64 20 61 6e 64 20 6c 69 62 72  changed and libr
06a0: 61 72 79 2f 74 6c 73 2e 74 63 6c 0a 66 6f 72 20  ary/tls.tcl.for 
06b0: 65 78 61 6d 70 6c 65 20 68 61 6e 64 6c 65 72 20  example handler 
06c0: 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 20 61  functions that a
06d0: 72 65 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d  re backwards com
06e0: 70 61 74 69 62 6c 65 2e 0a 0a 0a 49 6e 73 74 61  patible....Insta
06f0: 6c 6c 61 74 69 6f 6e 0a 3d 3d 3d 3d 3d 3d 3d 3d  llation.========
0700: 3d 3d 3d 3d 0a 0a 54 68 69 73 20 70 61 63 6b 61  ====..This packa
0710: 67 65 20 75 73 65 73 20 74 68 65 20 54 43 4c 20  ge uses the TCL 
0720: 45 78 74 65 6e 73 69 6f 6e 20 41 72 63 68 69 74  Extension Archit
0730: 65 63 74 75 72 65 20 28 54 45 41 29 20 74 6f 20  ecture (TEA) to 
0740: 62 75 69 6c 64 20 61 6e 64 20 69 6e 73 74 61 6c  build and instal
0750: 6c 20 6f 6e 0a 61 6e 79 20 73 75 70 70 6f 72 74  l on.any support
0760: 65 64 20 55 6e 69 78 2c 20 4d 61 63 2c 20 6f 72  ed Unix, Mac, or
0770: 20 4d 53 20 57 69 6e 64 6f 77 73 20 73 79 73 74   MS Windows syst
0780: 65 6d 2e 20 49 74 20 64 65 70 65 6e 64 73 20 6f  em. It depends o
0790: 6e 20 74 68 65 20 4f 70 65 6e 53 53 4c 0a 6c 69  n the OpenSSL.li
07a0: 62 72 61 72 69 65 73 20 62 65 69 6e 67 20 61 76  braries being av
07b0: 61 69 6c 61 62 6c 65 20 70 72 69 6f 72 20 74 6f  ailable prior to
07c0: 20 62 75 69 6c 64 69 6e 67 20 74 68 65 20 54 43   building the TC
07d0: 4c 54 4c 53 20 65 78 74 65 6e 73 69 6f 6e 2e 0a  LTLS extension..
07e0: 0a 55 4e 49 58 20 61 6e 64 20 4c 69 6e 75 78 0a  .UNIX and Linux.
07f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a  --------------..
0800: 54 68 65 20 73 74 61 6e 64 61 72 64 20 54 45 41  The standard TEA
0810: 20 63 6f 6e 66 69 67 2c 20 6d 61 6b 65 2c 20 61   config, make, a
0820: 6e 64 20 69 6e 73 74 61 6c 6c 20 70 72 6f 63 65  nd install proce
0830: 73 73 20 69 73 20 73 75 70 70 6f 72 74 65 64 2e  ss is supported.
0840: 0a 0a 09 24 20 63 64 20 74 63 6c 74 6c 73 0a 09  ...$ cd tcltls..
0850: 24 20 2e 2f 63 6f 6e 66 69 67 75 72 65 20 2d 2d  $ ./configure --
0860: 65 6e 61 62 6c 65 2d 36 34 62 69 74 0a 09 24 20  enable-64bit..$ 
0870: 6d 61 6b 65 0a 09 24 20 6d 61 6b 65 20 74 65 73  make..$ make tes
0880: 74 0a 09 24 20 6d 61 6b 65 20 69 6e 73 74 61 6c  t..$ make instal
0890: 6c 0a 0a 54 68 65 20 73 75 70 70 6f 72 74 65 64  l..The supported
08a0: 20 63 6f 6e 66 69 67 75 72 65 20 6f 70 74 69 6f   configure optio
08b0: 6e 73 20 69 6e 63 6c 75 64 65 20 61 6c 6c 20 6f  ns include all o
08c0: 66 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 54  f the standard T
08d0: 45 41 20 63 6f 6e 66 69 67 75 72 65 0a 73 63 72  EA configure.scr
08e0: 69 70 74 20 6f 70 74 69 6f 6e 73 2c 20 70 6c 75  ipt options, plu
08f0: 73 3a 0a 0a 20 20 2d 2d 64 69 73 61 62 6c 65 2d  s:..  --disable-
0900: 74 6c 73 31 20 20 20 20 20 20 20 20 20 20 64 69  tls1          di
0910: 73 61 62 6c 65 20 54 4c 53 31 20 70 72 6f 74 6f  sable TLS1 proto
0920: 63 6f 6c 0a 20 20 2d 2d 64 69 73 61 62 6c 65 2d  col.  --disable-
0930: 74 6c 73 31 5f 31 20 20 20 20 20 20 20 20 64 69  tls1_1        di
0940: 73 61 62 6c 65 20 54 4c 53 31 2e 31 20 70 72 6f  sable TLS1.1 pro
0950: 74 6f 63 6f 6c 0a 20 20 2d 2d 64 69 73 61 62 6c  tocol.  --disabl
0960: 65 2d 74 6c 73 31 5f 32 20 20 20 20 20 20 20 20  e-tls1_2        
0970: 64 69 73 61 62 6c 65 20 54 4c 53 31 2e 32 20 70  disable TLS1.2 p
0980: 72 6f 74 6f 63 6f 6c 0a 20 20 2d 2d 64 69 73 61  rotocol.  --disa
0990: 62 6c 65 2d 74 6c 73 31 5f 33 20 20 20 20 20 20  ble-tls1_3      
09a0: 20 20 64 69 73 61 62 6c 65 20 54 4c 53 31 2e 33    disable TLS1.3
09b0: 20 70 72 6f 74 6f 63 6f 6c 0a 20 20 2d 2d 65 6e   protocol.  --en
09c0: 61 62 6c 65 2d 64 65 62 75 67 20 20 20 20 20 20  able-debug      
09d0: 20 20 20 20 65 6e 61 62 6c 65 20 64 65 62 75 67      enable debug
09e0: 67 69 6e 67 20 6d 6f 64 65 20 61 6e 64 20 6f 75  ging mode and ou
09f0: 74 70 75 74 20 6d 6f 72 65 20 73 74 61 74 75 73  tput more status
0a00: 0a 20 20 2d 2d 65 6e 61 62 6c 65 2d 73 73 6c 2d  .  --enable-ssl-
0a10: 66 61 73 74 70 61 74 68 20 20 20 65 6e 61 62 6c  fastpath   enabl
0a20: 65 20 75 73 69 6e 67 20 74 68 65 20 75 6e 64 65  e using the unde
0a30: 72 6c 79 69 6e 67 20 66 69 6c 65 20 64 65 73 63  rlying file desc
0a40: 72 69 70 74 6f 72 20 66 6f 72 20 74 61 6c 6b 69  riptor for talki
0a50: 6e 67 20 64 69 72 65 63 74 6c 79 20 74 6f 20 74  ng directly to t
0a60: 68 65 20 53 53 4c 20 6c 69 62 72 61 72 79 0a 20  he SSL library. 
0a70: 20 2d 2d 65 6e 61 62 6c 65 2d 68 61 72 64 65 6e   --enable-harden
0a80: 69 6e 67 20 20 20 20 20 20 65 6e 61 62 6c 65 20  ing      enable 
0a90: 68 61 72 64 65 6e 69 6e 67 20 61 74 74 65 6d 70  hardening attemp
0aa0: 74 73 0a 20 20 2d 2d 65 6e 61 62 6c 65 2d 73 74  ts.  --enable-st
0ab0: 61 74 69 63 2d 73 73 6c 20 20 20 20 20 65 6e 61  atic-ssl     ena
0ac0: 62 6c 65 20 73 74 61 74 69 63 20 6c 69 6e 6b 69  ble static linki
0ad0: 6e 67 20 74 6f 20 74 68 65 20 53 53 4c 20 6c 69  ng to the SSL li
0ae0: 62 72 61 72 79 0a 0a 49 66 20 65 69 74 68 65 72  brary..If either
0af0: 20 54 43 4c 20 6f 72 20 4f 70 65 6e 53 53 4c 20   TCL or OpenSSL 
0b00: 61 72 65 20 69 6e 73 74 61 6c 6c 65 64 20 69 6e  are installed in
0b10: 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64 20 6c 6f   non-standard lo
0b20: 63 61 74 69 6f 6e 73 2c 20 74 68 65 20 66 6f 6c  cations, the fol
0b30: 6c 6f 77 69 6e 67 0a 63 6f 6e 66 69 67 75 72 65  lowing.configure
0b40: 20 6f 70 74 69 6f 6e 73 20 61 72 65 20 61 76 61   options are ava
0b50: 69 6c 61 62 6c 65 2e 20 46 6f 72 20 61 6c 6c 20  ilable. For all 
0b60: 6f 70 74 69 6f 6e 73 2c 20 73 65 65 20 2e 2f 63  options, see ./c
0b70: 6f 6e 66 69 67 75 72 65 20 2d 2d 68 65 6c 70 2e  onfigure --help.
0b80: 0a 0a 20 20 2d 2d 77 69 74 68 2d 74 63 6c 3d 3c  ..  --with-tcl=<
0b90: 64 69 72 3e 09 09 09 70 61 74 68 20 74 6f 20 77  dir>...path to w
0ba0: 68 65 72 65 20 74 63 6c 43 6f 6e 64 69 67 2e 73  here tclCondig.s
0bb0: 68 20 66 69 6c 65 20 72 65 73 69 64 65 73 0a 20  h file resides. 
0bc0: 20 2d 2d 77 69 74 68 2d 74 63 6c 69 6e 63 6c 75   --with-tclinclu
0bd0: 64 65 3d 3c 64 69 72 3e 09 09 64 69 72 65 63 74  de=<dir>..direct
0be0: 6f 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ory containing t
0bf0: 68 65 20 70 75 62 6c 69 63 20 54 63 6c 20 68 65  he public Tcl he
0c00: 61 64 65 72 20 66 69 6c 65 73 0a 20 20 2d 2d 77  ader files.  --w
0c10: 69 74 68 2d 6f 70 65 6e 73 73 6c 2d 64 69 72 3d  ith-openssl-dir=
0c20: 3c 64 69 72 3e 09 09 70 61 74 68 20 74 6f 20 72  <dir>..path to r
0c30: 6f 6f 74 20 64 69 72 65 63 74 6f 72 79 20 6f 66  oot directory of
0c40: 20 4f 70 65 6e 53 53 4c 20 69 6e 73 74 61 6c 6c   OpenSSL install
0c50: 61 74 69 6f 6e 0a 20 20 2d 2d 77 69 74 68 2d 6f  ation.  --with-o
0c60: 70 65 6e 73 73 6c 2d 69 6e 63 6c 75 64 65 64 69  penssl-includedi
0c70: 72 3d 3c 64 69 72 3e 09 70 61 74 68 20 74 6f 20  r=<dir>.path to 
0c80: 69 6e 63 6c 75 64 65 20 64 69 72 65 63 74 6f 72  include director
0c90: 79 20 6f 66 20 4f 70 65 6e 53 53 4c 20 69 6e 73  y of OpenSSL ins
0ca0: 74 61 6c 6c 61 74 69 6f 6e 0a 20 20 2d 2d 77 69  tallation.  --wi
0cb0: 74 68 2d 6f 70 65 6e 73 73 6c 2d 6c 69 62 64 69  th-openssl-libdi
0cc0: 72 3d 3c 64 69 72 3e 09 09 70 61 74 68 20 74 6f  r=<dir>..path to
0cd0: 20 6c 69 62 20 64 69 72 65 63 74 6f 72 79 20 6f   lib directory o
0ce0: 66 20 4f 70 65 6e 53 53 4c 20 69 6e 73 74 61 6c  f OpenSSL instal
0cf0: 6c 61 74 69 6f 6e 0a 20 20 2d 2d 77 69 74 68 2d  lation.  --with-
0d00: 6f 70 65 6e 73 73 6c 2d 70 6b 67 63 6f 6e 66 69  openssl-pkgconfi
0d10: 67 3d 3c 64 69 72 3e 09 70 61 74 68 20 74 6f 20  g=<dir>.path to 
0d20: 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 79 20 6f  root directory o
0d30: 66 20 4f 70 65 6e 53 53 4c 20 70 6b 67 2d 63 6f  f OpenSSL pkg-co
0d40: 6e 66 69 67 20 64 69 72 65 63 74 6f 72 79 0a 0a  nfig directory..
0d50: 0a 4d 61 63 4f 53 0a 2d 2d 2d 2d 2d 0a 0a 54 68  .MacOS.-----..Th
0d60: 65 20 73 74 61 6e 64 61 72 64 20 54 45 41 20 69  e standard TEA i
0d70: 6e 73 74 61 6c 6c 61 74 69 6f 6e 20 70 72 6f 63  nstallation proc
0d80: 65 73 73 20 69 73 20 73 75 70 70 6f 72 74 65 64  ess is supported
0d90: 2e 20 55 73 65 20 74 68 65 20 2d 2d 77 69 74 68  . Use the --with
0da0: 2d 74 63 6c 20 6f 70 74 69 6f 6e 0a 74 6f 20 73  -tcl option.to s
0db0: 65 74 20 74 68 65 20 54 43 4c 20 70 61 74 68 20  et the TCL path 
0dc0: 69 66 20 74 68 65 20 41 63 74 69 76 65 53 74 61  if the ActiveSta
0dd0: 74 65 20 6f 72 20 6f 74 68 65 72 20 6e 6f 6e 2d  te or other non-
0de0: 41 70 70 6c 65 20 76 65 72 73 69 6f 6e 20 6f 66  Apple version of
0df0: 20 54 43 4c 20 69 73 20 74 6f 0a 62 65 20 75 73   TCL is to.be us
0e00: 65 64 2e 0a 0a 09 24 20 63 64 20 74 63 6c 74 6c  ed....$ cd tcltl
0e10: 73 0a 09 24 20 2e 2f 63 6f 6e 66 69 67 75 72 65  s..$ ./configure
0e20: 20 2d 2d 77 69 74 68 2d 74 63 6c 3d 2f 4c 69 62   --with-tcl=/Lib
0e30: 72 61 72 79 2f 46 72 61 6d 65 77 6f 72 6b 73 2f  rary/Frameworks/
0e40: 54 63 6c 2e 66 72 61 6d 65 77 6f 72 6b 2f 0a 09  Tcl.framework/..
0e50: 24 20 6d 61 6b 65 0a 09 24 20 6d 61 6b 65 20 74  $ make..$ make t
0e60: 65 73 74 0a 09 24 20 6d 61 6b 65 20 69 6e 73 74  est..$ make inst
0e70: 61 6c 6c 0a 0a 0a 57 69 6e 64 6f 77 73 0a 2d 2d  all...Windows.--
0e80: 2d 2d 2d 2d 2d 0a 0a 49 66 20 69 6e 73 74 61 6c  -----..If instal
0e90: 6c 69 6e 67 20 77 69 74 68 20 4d 69 6e 47 57 2c  ling with MinGW,
0ea0: 20 75 73 65 20 74 68 65 20 54 45 41 20 62 75 69   use the TEA bui
0eb0: 6c 64 20 70 72 6f 63 65 73 73 2e 20 49 66 20 75  ld process. If u
0ec0: 73 69 6e 67 20 4d 53 20 56 69 73 75 61 6c 20 43  sing MS Visual C
0ed0: 0a 28 4d 53 56 43 29 2c 20 73 65 65 20 77 69 6e  .(MSVC), see win
0ee0: 2f 52 45 41 44 4d 45 2e 74 78 74 20 66 6f 72 20  /README.txt for 
0ef0: 74 68 65 20 62 75 69 6c 64 20 61 6e 64 20 69 6e  the build and in
0f00: 73 74 61 6c 6c 61 74 69 6f 6e 20 69 6e 73 74 72  stallation instr
0f10: 75 63 74 69 6f 6e 73 2e 0a 0a 0a 43 65 72 74 69  uctions....Certi
0f20: 66 69 63 61 74 65 20 56 61 6c 69 64 61 74 69 6f  ficate Validatio
0f30: 6e 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  n.--------------
0f40: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 66 20 4f 70 65  --------..If Ope
0f50: 6e 53 53 4c 20 69 73 20 6e 6f 74 20 69 6e 73 74  nSSL is not inst
0f60: 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 73 79 73  alled on the sys
0f70: 74 65 6d 2c 20 74 68 65 20 43 65 72 74 69 66 69  tem, the Certifi
0f80: 63 61 74 65 20 41 75 74 68 6f 72 69 74 79 20 28  cate Authority (
0f90: 43 41 29 0a 70 72 6f 76 69 64 65 64 20 63 65 72  CA).provided cer
0fa0: 74 69 66 69 63 61 74 65 73 20 6d 75 73 74 20 62  tificates must b
0fb0: 65 20 64 6f 77 6e 6c 6f 61 64 65 64 20 61 6e 64  e downloaded and
0fc0: 20 69 6e 73 74 61 6c 6c 65 64 20 77 69 74 68 20   installed with 
0fd0: 74 68 65 20 73 6f 66 74 77 61 72 65 2e 0a 54 68  the software..Th
0fe0: 65 73 65 20 61 72 65 20 75 73 65 64 20 66 6f 72  ese are used for
0ff0: 20 63 65 72 74 69 66 69 63 61 74 65 20 76 61 6c   certificate val
1000: 69 64 61 74 69 6f 6e 2e 20 54 68 65 20 43 55 52  idation. The CUR
1010: 4c 20 74 65 61 6d 20 6d 61 6b 65 73 20 74 68 65  L team makes the
1020: 6d 20 61 76 61 69 6c 61 62 6c 65 0a 61 74 20 68  m available.at h
1030: 74 74 70 73 3a 2f 2f 63 75 72 6c 2e 73 65 2f 64  ttps://curl.se/d
1040: 6f 63 73 2f 63 61 65 78 74 72 61 63 74 2e 68 74  ocs/caextract.ht
1050: 6d 6c 2e 20 4c 6f 6f 6b 20 66 6f 72 20 74 68 65  ml. Look for the
1060: 20 63 61 63 65 72 74 2e 70 65 6d 20 66 69 6c 65   cacert.pem file
1070: 2e 0a 0a 0a 43 6f 70 79 72 69 67 68 74 73 0a 3d  ....Copyrights.=
1080: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 4f 72 69 67 69  =========..Origi
1090: 6e 61 6c 20 54 4c 53 20 43 6f 70 79 72 69 67 68  nal TLS Copyrigh
10a0: 74 20 28 43 29 20 31 39 39 37 2d 32 30 30 30 20  t (C) 1997-2000 
10b0: 4d 61 74 74 20 4e 65 77 6d 61 6e 20 3c 6d 61 74  Matt Newman <mat
10c0: 74 40 6e 6f 76 61 64 69 67 6d 2e 63 6f 6d 3e 0a  t@novadigm.com>.
10d0: 54 4c 53 20 31 2e 34 2e 31 20 20 20 20 43 6f 70  TLS 1.4.1    Cop
10e0: 79 72 69 67 68 74 20 28 43 29 20 32 30 30 30 20  yright (C) 2000 
10f0: 41 6a 75 62 61 20 53 6f 6c 75 74 69 6f 6e 73 0a  Ajuba Solutions.
1100: 54 4c 53 20 31 2e 36 20 20 20 20 20 20 43 6f 70  TLS 1.6      Cop
1110: 79 72 69 67 68 74 20 28 43 29 20 32 30 30 38 20  yright (C) 2008 
1120: 41 63 74 69 76 65 53 74 61 74 65 20 53 6f 66 74  ActiveState Soft
1130: 77 61 72 65 20 49 6e 63 2e 0a 54 4c 53 20 31 2e  ware Inc..TLS 1.
1140: 37 20 20 20 20 20 20 43 6f 70 79 72 69 67 68 74  7      Copyright
1150: 20 28 43 29 20 32 30 31 36 20 4d 61 74 74 20 4e   (C) 2016 Matt N
1160: 65 77 6d 61 6e 2c 20 41 6a 75 62 61 20 53 6f 6c  ewman, Ajuba Sol
1170: 75 74 69 6f 6e 73 2c 20 41 63 74 69 76 65 53 74  utions, ActiveSt
1180: 61 74 65 0a 20 20 20 20 20 20 20 20 20 20 20 20  ate.            
1190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
11a0: 20 20 20 20 53 6f 66 74 77 61 72 65 20 49 6e 63      Software Inc
11b0: 2c 20 52 6f 79 20 4b 65 65 6e 65 20 3c 74 63 6c  , Roy Keene <tcl
11c0: 74 6c 73 40 72 6b 65 65 6e 65 2e 6f 72 67 3e 0a  tls@rkeene.org>.
11d0: 54 4c 53 20 31 2e 38 2d 32 2e 30 20 20 43 6f 70  TLS 1.8-2.0  Cop
11e0: 79 72 69 67 68 74 20 28 43 29 20 32 30 32 33 2d  yright (C) 2023-
11f0: 32 30 32 34 20 42 72 69 61 6e 20 4f 27 48 61 67  2024 Brian O'Hag
1200: 61 6e 0a 0a 41 63 6b 6e 6f 77 6c 65 64 67 6d 65  an..Acknowledgme
1210: 6e 74 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d  nts.============
1220: 3d 3d 3d 0a 0a 4e 6f 6e 2d 65 78 63 6c 75 73 69  ===..Non-exclusi
1230: 76 65 20 63 72 65 64 69 74 73 20 66 6f 72 20 54  ve credits for T
1240: 4c 53 20 61 72 65 3a 0a 20 20 20 4f 72 69 67 69  LS are:.   Origi
1250: 6e 61 6c 20 77 6f 72 6b 3a 20 4d 61 74 74 20 4e  nal work: Matt N
1260: 65 77 6d 61 6e 20 40 20 4e 6f 76 61 64 69 67 6d  ewman @ Novadigm
1270: 0a 20 20 20 55 70 64 61 74 65 73 3a 20 4a 65 66  .   Updates: Jef
1280: 66 20 48 6f 62 62 73 20 40 20 41 63 74 69 76 65  f Hobbs @ Active
1290: 53 74 61 74 65 0a 20 20 20 54 63 6c 20 43 68 61  State.   Tcl Cha
12a0: 6e 6e 65 6c 20 6d 65 63 68 61 6e 69 73 6d 3a 20  nnel mechanism: 
12b0: 41 6e 64 72 65 61 73 20 4b 75 70 72 69 65 73 0a  Andreas Kupries.
12c0: 20 20 20 49 6d 70 65 74 75 73 2f 52 65 6c 61 74     Impetus/Relat
12d0: 65 64 20 77 6f 72 6b 3a 20 74 63 6c 53 53 4c 20  ed work: tclSSL 
12e0: 28 43 6f 6c 69 6e 20 4d 63 43 6f 72 6d 61 63 6b  (Colin McCormack
12f0: 2c 20 53 68 61 72 65 64 20 54 65 63 68 6e 6f 6c  , Shared Technol
1300: 6f 67 79 29 0a 20 20 20 20 20 20 20 20 20 20 20  ogy).           
1310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 53                SS
1320: 4c 74 63 6c 20 28 50 65 74 65 72 20 41 6e 74 6d  Ltcl (Peter Antm
1330: 61 6e 29 0a 0a 4c 69 63 65 6e 73 65 0a 3d 3d 3d  an)..License.===
1340: 3d 3d 3d 3d 0a 0a 54 68 69 73 20 63 6f 64 65 20  ====..This code 
1350: 69 73 20 6c 69 63 65 6e 73 65 64 20 75 6e 64 65  is licensed unde
1360: 72 20 74 68 65 20 73 61 6d 65 20 74 65 72 6d 73  r the same terms
1370: 20 61 73 20 74 68 65 20 54 63 6c 20 43 6f 72 65   as the Tcl Core
1380: 2e 0a                                            ..