Hex Artifact Content

Artifact 9a1eb98644a1cdf6ef0562e9fece0a169a6a36dff5b302c30cd7425313832c62:


0000: 09 57 69 6e 64 6f 77 73 20 44 4c 4c 20 42 75 69  .Windows DLL Bui
0010: 6c 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20  ld instructions 
0020: 75 73 69 6e 67 20 6e 6d 61 6b 65 20 62 75 69 6c  using nmake buil
0030: 64 20 73 79 73 74 65 6d 0a 09 32 30 32 30 2d 31  d system..2020-1
0040: 30 2d 31 35 20 48 61 72 61 6c 64 2e 4f 65 68 6c  0-15 Harald.Oehl
0050: 6d 61 6e 6e 40 65 6c 6d 69 63 72 6f 6e 2e 64 65  mann@elmicron.de
0060: 0a 09 32 30 32 33 2d 30 34 2d 32 33 20 42 72 69  ..2023-04-23 Bri
0070: 61 6e 20 4f 27 48 61 67 61 6e 0a 0a 50 72 6f 70  an O'Hagan..Prop
0080: 65 72 74 69 65 73 3a 0a 2d 20 36 34 20 62 69 74  erties:.- 64 bit
0090: 20 44 4c 4c 0a 2d 20 56 69 73 75 61 6c 53 74 75   DLL.- VisualStu
00a0: 64 69 6f 20 32 30 31 35 0a 4e 6f 74 65 3a 20 56  dio 2015.Note: V
00b0: 69 73 75 61 6c 20 43 2b 2b 20 36 20 64 6f 65 73  isual C++ 6 does
00c0: 20 6e 6f 74 20 62 75 69 6c 64 20 4f 70 65 6e 53   not build OpenS
00d0: 53 4c 20 28 6c 6f 6e 67 20 6c 6f 6e 67 20 73 79  SL (long long sy
00e0: 6e 74 61 78 20 65 72 72 6f 72 29 0a 2d 20 43 79  ntax error).- Cy
00f0: 67 77 69 6e 33 32 20 28 74 65 6d 70 6f 72 61 72  gwin32 (temporar
0100: 79 20 68 65 6c 70 65 72 2c 20 70 6c 65 61 73 65  y helper, please
0110: 20 68 65 6c 70 20 74 6f 20 72 65 70 6c 61 63 65   help to replace
0120: 20 62 79 20 74 63 6c 73 68 29 0a 2d 20 4f 70 65   by tclsh).- Ope
0130: 6e 53 53 4c 20 73 74 61 74 69 63 61 6c 6c 79 20  nSSL statically 
0140: 6c 69 6e 6b 65 64 20 74 6f 20 54 43 4c 54 4c 53  linked to TCLTLS
0150: 20 44 4c 4c 2e 0a 4e 6f 74 65 3a 20 44 79 6e 61   DLL..Note: Dyna
0160: 6d 69 63 20 6c 69 6e 6b 69 6e 67 20 61 6c 73 6f  mic linking also
0170: 20 77 6f 72 6b 73 20 62 75 74 20 72 65 73 75 6c   works but resul
0180: 74 73 20 69 6e 20 61 20 44 4c 4c 20 64 65 70 65  ts in a DLL depe
0190: 6e 64 65 6e 63 79 20 6f 6e 20 4f 50 45 4e 53 53  ndency on OPENSS
01a0: 4c 20 44 4c 4c 27 73 0a 0a 2d 2d 2d 2d 2d 2d 2d  L DLL's..-------
01b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
01c0: 2d 2d 2d 2d 2d 2d 0a 0a 31 29 20 42 75 69 6c 64  ------..1) Build
01d0: 20 4f 70 65 6e 53 53 4c 20 73 74 61 74 69 63 20   OpenSSL static 
01e0: 6c 69 62 72 61 72 69 65 73 3a 0a 0a 73 65 74 20  libraries:..set 
01f0: 53 53 4c 42 55 49 4c 44 3d 5c 70 61 74 68 5c 74  SSLBUILD=\path\t
0200: 6f 5c 62 75 69 6c 64 5c 64 69 72 0a 73 65 74 20  o\build\dir.set 
0210: 53 53 4c 49 4e 53 54 41 4c 4c 3d 5c 70 61 74 68  SSLINSTALL=\path
0220: 5c 74 6f 5c 69 6e 73 74 61 6c 6c 5c 64 69 72 0a  \to\install\dir.
0230: 73 65 74 20 53 53 4c 43 4f 4d 4d 4f 4e 3d 5c 70  set SSLCOMMON=\p
0240: 61 74 68 5c 74 6f 5c 63 6f 6d 6d 6f 6e 5c 64 69  ath\to\common\di
0250: 72 0a 0a 28 31 61 29 20 47 65 74 20 4f 70 65 6e  r..(1a) Get Open
0260: 53 53 4c 0a 0a 20 20 68 74 74 70 73 3a 2f 2f 67  SSL..  https://g
0270: 69 74 68 75 62 2e 63 6f 6d 2f 6f 70 65 6e 73 73  ithub.com/openss
0280: 6c 2f 6f 70 65 6e 73 73 6c 2f 72 65 6c 65 61 73  l/openssl/releas
0290: 65 73 2f 64 6f 77 6e 6c 6f 61 64 2f 4f 70 65 6e  es/download/Open
02a0: 53 53 4c 5f 31 5f 31 5f 31 74 2f 6f 70 65 6e 73  SSL_1_1_1t/opens
02b0: 73 6c 2d 31 2e 31 2e 31 74 2e 74 61 72 2e 67 7a  sl-1.1.1t.tar.gz
02c0: 0a 0a 20 20 55 6e 70 61 63 6b 20 4f 70 65 6e 53  ..  Unpack OpenS
02d0: 53 4c 20 73 6f 75 72 63 65 20 64 69 73 74 72 69  SL source distri
02e0: 62 75 74 69 6f 6e 20 74 6f 20 25 53 53 4c 42 55  bution to %SSLBU
02f0: 49 4c 44 25 0a 0a 28 31 62 29 20 49 6e 73 74 61  ILD%..(1b) Insta
0300: 6c 6c 20 50 65 72 6c 20 66 72 6f 6d 20 68 74 74  ll Perl from htt
0310: 70 73 3a 2f 2f 73 74 72 61 77 62 65 72 72 79 70  ps://strawberryp
0320: 65 72 6c 2e 63 6f 6d 2f 0a 0a 20 20 68 74 74 70  erl.com/..  http
0330: 73 3a 2f 2f 73 74 72 61 77 62 65 72 72 79 70 65  s://strawberrype
0340: 72 6c 2e 63 6f 6d 2f 64 6f 77 6e 6c 6f 61 64 2f  rl.com/download/
0350: 35 2e 33 32 2e 31 2e 31 2f 73 74 72 61 77 62 65  5.32.1.1/strawbe
0360: 72 72 79 2d 70 65 72 6c 2d 35 2e 33 32 2e 31 2e  rry-perl-5.32.1.
0370: 31 2d 36 34 62 69 74 2e 6d 73 69 0a 20 20 49 6e  1-64bit.msi.  In
0380: 73 74 61 6c 6c 20 74 6f 20 43 3a 5c 53 74 72 61  stall to C:\Stra
0390: 77 62 65 72 72 79 5c 70 65 72 6c 0a 0a 28 31 63  wberry\perl..(1c
03a0: 29 20 49 6e 73 74 61 6c 6c 20 4e 41 53 4d 20 41  ) Install NASM A
03b0: 73 73 65 6d 62 6c 65 72 20 66 72 6f 6d 20 68 74  ssembler from ht
03c0: 74 70 73 3a 2f 2f 77 77 77 2e 6e 61 73 6d 2e 75  tps://www.nasm.u
03d0: 73 2f 0a 0a 20 20 68 74 74 70 73 3a 2f 2f 77 77  s/..  https://ww
03e0: 77 2e 6e 61 73 6d 2e 75 73 2f 70 75 62 2f 6e 61  w.nasm.us/pub/na
03f0: 73 6d 2f 72 65 6c 65 61 73 65 62 75 69 6c 64 73  sm/releasebuilds
0400: 2f 32 2e 31 36 2e 30 31 2f 77 69 6e 36 34 2f 6e  /2.16.01/win64/n
0410: 61 73 6d 2d 32 2e 31 36 2e 30 31 2d 69 6e 73 74  asm-2.16.01-inst
0420: 61 6c 6c 65 72 2d 78 36 34 2e 65 78 65 0a 20 20  aller-x64.exe.  
0430: 49 6e 73 74 61 6c 6c 20 74 6f 3a 20 43 3a 5c 50  Install to: C:\P
0440: 72 6f 67 72 61 6d 20 46 69 6c 65 73 5c 4e 41 53  rogram Files\NAS
0450: 4d 0a 0a 28 31 64 29 20 43 6f 6e 66 69 67 75 72  M..(1d) Configur
0460: 65 0a 0a 20 20 41 74 20 56 69 73 75 61 6c 20 53  e..  At Visual S
0470: 74 75 64 69 6f 20 78 38 36 20 6e 61 74 69 76 65  tudio x86 native
0480: 20 70 72 6f 6d 70 74 3a 0a 0a 20 20 73 65 74 20   prompt:..  set 
0490: 50 61 74 68 3d 25 50 41 54 48 25 3b 43 3a 5c 50  Path=%PATH%;C:\P
04a0: 72 6f 67 72 61 6d 20 46 69 6c 65 73 5c 4e 41 53  rogram Files\NAS
04b0: 4d 3b 43 3a 5c 53 74 72 61 77 62 65 72 72 79 5c  M;C:\Strawberry\
04c0: 70 65 72 6c 5c 62 69 6e 0a 20 20 70 65 72 6c 20  perl\bin.  perl 
04d0: 2e 2e 5c 43 6f 6e 66 69 67 75 72 65 20 56 43 2d  ..\Configure VC-
04e0: 57 49 4e 36 34 41 20 6e 6f 2d 73 68 61 72 65 64  WIN64A no-shared
04f0: 20 6e 6f 2d 66 69 6c 65 6e 61 6d 65 73 20 74 68   no-filenames th
0500: 72 65 61 64 73 20 6e 6f 2d 73 73 6c 32 20 6e 6f  reads no-ssl2 no
0510: 2d 73 73 6c 33 20 2d 2d 61 70 69 3d 31 2e 31 2e  -ssl3 --api=1.1.
0520: 30 20 2d 2d 70 72 65 66 69 78 3d 22 25 53 53 4c  0 --prefix="%SSL
0530: 49 4e 53 54 41 4c 4c 25 22 20 2d 2d 6f 70 65 6e  INSTALL%" --open
0540: 73 73 6c 64 69 72 3d 22 25 53 53 4c 43 4f 4d 4d  ssldir="%SSLCOMM
0550: 4f 4e 25 22 20 2d 44 4f 50 45 4e 53 53 4c 5f 4e  ON%" -DOPENSSL_N
0560: 4f 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20 23  O_DEPRECATED.  #
0570: 20 4e 6f 74 20 75 73 65 64 20 6f 70 74 69 6f 6e   Not used option
0580: 73 3a 20 6e 6f 2d 61 73 6d 20 6e 6f 2d 7a 6c 69  s: no-asm no-zli
0590: 62 20 6e 6f 2d 63 6f 6d 70 20 6e 6f 2d 75 69 2d  b no-comp no-ui-
05a0: 63 6f 6e 73 6f 6c 65 20 6e 6f 2d 61 75 74 6f 6c  console no-autol
05b0: 6f 61 64 2d 63 6f 6e 66 69 67 0a 0a 28 31 65 29  oad-config..(1e)
05c0: 20 42 75 69 6c 64 20 4f 70 65 6e 53 53 4c 0a 0a   Build OpenSSL..
05d0: 20 20 6e 6d 61 6b 65 0a 20 20 6e 6d 61 6b 65 20    nmake.  nmake 
05e0: 74 65 73 74 0a 20 20 6e 6d 61 6b 65 20 69 6e 73  test.  nmake ins
05f0: 74 61 6c 6c 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  tall..----------
0600: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0610: 2d 2d 2d 0a 0a 32 29 20 42 75 69 6c 64 20 54 63  ---..2) Build Tc
0620: 6c 54 4c 53 0a 0a 73 65 74 20 42 55 49 4c 44 44  lTLS..set BUILDD
0630: 49 52 3d 5c 70 61 74 68 5c 74 6f 5c 62 75 69 6c  IR=\path\to\buil
0640: 64 5c 64 69 72 0a 73 65 74 20 54 43 4c 49 4e 53  d\dir.set TCLINS
0650: 54 41 4c 4c 3d 5c 70 61 74 68 5c 74 6f 5c 74 63  TALL=\path\to\tc
0660: 6c 5c 64 69 72 0a 0a 32 61 29 20 55 6e 7a 69 70  l\dir..2a) Unzip
0670: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 74 6f   distribution to
0680: 20 25 42 55 49 4c 44 44 49 52 25 0a 0a 32 62 29   %BUILDDIR%..2b)
0690: 20 53 74 61 72 74 20 42 41 53 48 20 73 68 65 6c   Start BASH shel
06a0: 6c 20 28 4d 69 6e 47 57 36 32 20 47 69 74 20 73  l (MinGW62 Git s
06b0: 68 65 6c 6c 29 0a 0a 63 64 20 25 42 55 49 4c 44  hell)..cd %BUILD
06c0: 44 49 52 25 0a 6f 64 20 2d 41 20 6e 20 2d 76 20  DIR%.od -A n -v 
06d0: 2d 74 20 78 43 20 3c 20 27 6c 69 62 72 61 72 79  -t xC < 'library
06e0: 2f 74 6c 73 2e 74 63 6c 27 20 3e 20 74 6c 73 2e  /tls.tcl' > tls.
06f0: 74 63 6c 2e 68 2e 6e 65 77 2e 31 0a 73 65 64 20  tcl.h.new.1.sed 
0700: 27 73 40 5b 5e 30 2d 39 41 2d 46 61 2d 66 5d 40  's@[^0-9A-Fa-f]@
0710: 40 67 3b 73 40 2e 2e 40 30 78 26 2c 20 40 67 27  @g;s@..@0x&, @g'
0720: 20 3c 20 74 6c 73 2e 74 63 6c 2e 68 2e 6e 65 77   < tls.tcl.h.new
0730: 2e 31 20 3e 20 67 65 6e 65 72 69 63 2f 74 6c 73  .1 > generic/tls
0740: 2e 74 63 6c 2e 68 0a 72 6d 20 2d 66 20 74 6c 73  .tcl.h.rm -f tls
0750: 2e 74 63 6c 2e 68 2e 6e 65 77 2e 31 0a 0a 32 63  .tcl.h.new.1..2c
0760: 29 20 53 74 61 72 74 20 56 69 73 75 61 6c 20 53  ) Start Visual S
0770: 74 75 64 69 6f 20 73 68 65 6c 6c 0a 0a 63 64 20  tudio shell..cd 
0780: 25 42 55 49 4c 44 44 49 52 25 5c 77 69 6e 0a 0a  %BUILDDIR%\win..
0790: 6e 6d 61 6b 65 20 2d 66 20 6d 61 6b 65 66 69 6c  nmake -f makefil
07a0: 65 2e 76 63 20 54 43 4c 44 49 52 3d 25 54 43 4c  e.vc TCLDIR=%TCL
07b0: 49 4e 53 54 41 4c 4c 25 20 53 53 4c 5f 49 4e 53  INSTALL% SSL_INS
07c0: 54 41 4c 4c 5f 46 4f 4c 44 45 52 3d 25 53 53 4c  TALL_FOLDER=%SSL
07d0: 49 4e 53 54 41 4c 4c 25 0a 6e 6d 61 6b 65 20 2d  INSTALL%.nmake -
07e0: 66 20 6d 61 6b 65 66 69 6c 65 2e 76 63 20 69 6e  f makefile.vc in
07f0: 73 74 61 6c 6c 20 54 43 4c 44 49 52 3d 63 3a 5c  stall TCLDIR=c:\
0800: 74 65 73 74 5c 74 63 6c 38 36 31 30 20 49 4e 53  test\tcl8610 INS
0810: 54 41 4c 4c 44 49 52 3d 25 54 43 4c 49 4e 53 54  TALLDIR=%TCLINST
0820: 41 4c 4c 25 20 53 53 4c 5f 49 4e 53 54 41 4c 4c  ALL% SSL_INSTALL
0830: 5f 46 4f 4c 44 45 52 3d 25 53 53 4c 49 4e 53 54  _FOLDER=%SSLINST
0840: 41 4c 4c 25 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ALL%..----------
0850: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0860: 2d 2d 2d 0a 0a 33 29 20 54 65 73 74 0a 0a 53 74  ---..3) Test..St
0870: 61 72 74 20 74 63 6c 73 68 20 6f 72 20 77 69 73  art tclsh or wis
0880: 68 0a 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69  h..package requi
0890: 72 65 20 74 6c 73 0a 70 61 63 6b 61 67 65 20 72  re tls.package r
08a0: 65 71 75 69 72 65 20 68 74 74 70 0a 68 74 74 70  equire http.http
08b0: 3a 3a 72 65 67 69 73 74 65 72 20 68 74 74 70 73  ::register https
08c0: 20 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 6c 73   443 [list ::tls
08d0: 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f 73 65  ::socket -autose
08e0: 72 76 65 72 6e 61 6d 65 20 74 72 75 65 5d 0a 73  rvername true].s
08f0: 65 74 20 74 6f 6b 20 5b 68 74 74 70 3a 3a 64 61  et tok [http::da
0900: 74 61 20 5b 68 74 74 70 3a 3a 67 65 74 75 72 6c  ta [http::geturl
0910: 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 74 63 6c   https://www.tcl
0920: 2d 6c 61 6e 67 2e 6f 72 67 5d 5d 0a 3a 3a 68 74  -lang.org]].::ht
0930: 74 70 3a 3a 63 6c 65 61 6e 75 70 20 24 74 6f 6b  tp::cleanup $tok
0940: 0a                                               .