Artifact
bce7b80fde934f0fc9f652a0c48e3755486d6fd3697ce7a2a633a5ef2468f35c:
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 20 4f 70 65 6e 20 53 53 4c 20 31 2e 31 2e 31 e Open SSL 1.1.1
0470: 0a 0a 20 20 41 74 20 56 69 73 75 61 6c 20 53 74 .. At Visual St
0480: 75 64 69 6f 20 78 36 34 20 6e 61 74 69 76 65 20 udio x64 native
0490: 70 72 6f 6d 70 74 3a 0a 0a 20 20 73 65 74 20 50 prompt:.. set P
04a0: 61 74 68 3d 25 50 41 54 48 25 3b 43 3a 5c 50 72 ath=%PATH%;C:\Pr
04b0: 6f 67 72 61 6d 20 46 69 6c 65 73 5c 4e 41 53 4d ogram Files\NASM
04c0: 3b 43 3a 5c 53 74 72 61 77 62 65 72 72 79 5c 70 ;C:\Strawberry\p
04d0: 65 72 6c 5c 62 69 6e 0a 20 20 70 65 72 6c 20 2e erl\bin. perl .
04e0: 2e 5c 43 6f 6e 66 69 67 75 72 65 20 56 43 2d 57 .\Configure VC-W
04f0: 49 4e 36 34 41 20 6e 6f 2d 73 68 61 72 65 64 20 IN64A no-shared
0500: 6e 6f 2d 66 69 6c 65 6e 61 6d 65 73 20 74 68 72 no-filenames thr
0510: 65 61 64 73 20 6e 6f 2d 73 73 6c 32 20 6e 6f 2d eads no-ssl2 no-
0520: 73 73 6c 33 20 2d 2d 61 70 69 3d 31 2e 31 2e 30 ssl3 --api=1.1.0
0530: 20 2d 2d 70 72 65 66 69 78 3d 22 25 53 53 4c 49 --prefix="%SSLI
0540: 4e 53 54 41 4c 4c 25 22 20 2d 2d 6f 70 65 6e 73 NSTALL%" --opens
0550: 73 6c 64 69 72 3d 22 25 53 53 4c 43 4f 4d 4d 4f sldir="%SSLCOMMO
0560: 4e 25 22 20 2d 44 4f 50 45 4e 53 53 4c 5f 4e 4f N%" -DOPENSSL_NO
0570: 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20 23 20 _DEPRECATED. #
0580: 4e 6f 74 20 75 73 65 64 20 6f 70 74 69 6f 6e 73 Not used options
0590: 3a 20 6e 6f 2d 61 73 6d 20 6e 6f 2d 7a 6c 69 62 : no-asm no-zlib
05a0: 20 6e 6f 2d 63 6f 6d 70 20 6e 6f 2d 75 69 2d 63 no-comp no-ui-c
05b0: 6f 6e 73 6f 6c 65 20 6e 6f 2d 61 75 74 6f 6c 6f onsole no-autolo
05c0: 61 64 2d 63 6f 6e 66 69 67 0a 0a 28 31 65 29 20 ad-config..(1e)
05d0: 43 6f 6e 66 69 67 75 72 65 20 4f 70 65 6e 20 53 Configure Open S
05e0: 53 4c 20 33 2e 30 2b 0a 0a 20 20 41 74 20 56 69 SL 3.0+.. At Vi
05f0: 73 75 61 6c 20 53 74 75 64 69 6f 20 78 36 34 20 sual Studio x64
0600: 6e 61 74 69 76 65 20 70 72 6f 6d 70 74 3a 0a 0a native prompt:..
0610: 20 20 73 65 74 20 50 61 74 68 3d 25 50 41 54 48 set Path=%PATH
0620: 25 3b 43 3a 5c 50 72 6f 67 72 61 6d 20 46 69 6c %;C:\Program Fil
0630: 65 73 5c 4e 41 53 4d 3b 43 3a 5c 53 74 72 61 77 es\NASM;C:\Straw
0640: 62 65 72 72 79 5c 70 65 72 6c 5c 62 69 6e 0a 20 berry\perl\bin.
0650: 20 70 65 72 6c 20 2e 2e 5c 43 6f 6e 66 69 67 75 perl ..\Configu
0660: 72 65 20 56 43 2d 57 49 4e 36 34 41 20 6e 6f 2d re VC-WIN64A no-
0670: 73 68 61 72 65 64 20 6e 6f 2d 66 69 6c 65 6e 61 shared no-filena
0680: 6d 65 73 20 74 68 72 65 61 64 73 20 6e 6f 2d 73 mes threads no-s
0690: 73 6c 32 20 6e 6f 2d 73 73 6c 33 20 2d 2d 70 72 sl2 no-ssl3 --pr
06a0: 65 66 69 78 3d 22 25 53 53 4c 49 4e 53 54 41 4c efix="%SSLINSTAL
06b0: 4c 25 22 20 2d 2d 6f 70 65 6e 73 73 6c 64 69 72 L%" --openssldir
06c0: 3d 22 25 53 53 4c 43 4f 4d 4d 4f 4e 25 22 0a 20 ="%SSLCOMMON%".
06d0: 20 23 20 4e 6f 74 20 75 73 65 64 20 6f 70 74 69 # Not used opti
06e0: 6f 6e 73 3a 20 6e 6f 2d 61 73 6d 20 6e 6f 2d 7a ons: no-asm no-z
06f0: 6c 69 62 20 6e 6f 2d 63 6f 6d 70 20 6e 6f 2d 75 lib no-comp no-u
0700: 69 2d 63 6f 6e 73 6f 6c 65 20 6e 6f 2d 61 75 74 i-console no-aut
0710: 6f 6c 6f 61 64 2d 63 6f 6e 66 69 67 0a 0a 28 31 oload-config..(1
0720: 66 29 20 42 75 69 6c 64 20 4f 70 65 6e 53 53 4c f) Build OpenSSL
0730: 0a 0a 20 20 6e 6d 61 6b 65 0a 20 20 6e 6d 61 6b .. nmake. nmak
0740: 65 20 74 65 73 74 0a 20 20 6e 6d 61 6b 65 20 69 e test. nmake i
0750: 6e 73 74 61 6c 6c 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d nstall..--------
0760: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0770: 2d 2d 2d 2d 2d 0a 0a 32 29 20 42 75 69 6c 64 20 -----..2) Build
0780: 54 63 6c 54 4c 53 0a 0a 20 20 73 65 74 20 42 55 TclTLS.. set BU
0790: 49 4c 44 44 49 52 3d 5c 70 61 74 68 5c 74 6f 5c ILDDIR=\path\to\
07a0: 62 75 69 6c 64 5c 64 69 72 0a 20 20 73 65 74 20 build\dir. set
07b0: 54 43 4c 49 4e 53 54 41 4c 4c 3d 5c 70 61 74 68 TCLINSTALL=\path
07c0: 5c 74 6f 5c 74 63 6c 5c 64 69 72 0a 0a 32 61 29 \to\tcl\dir..2a)
07d0: 20 55 6e 7a 69 70 20 64 69 73 74 72 69 62 75 74 Unzip distribut
07e0: 69 6f 6e 20 74 6f 20 25 42 55 49 4c 44 44 49 52 ion to %BUILDDIR
07f0: 25 0a 0a 32 62 29 20 53 74 61 72 74 20 42 41 53 %..2b) Start BAS
0800: 48 20 73 68 65 6c 6c 20 28 4d 69 6e 47 57 36 32 H shell (MinGW62
0810: 20 47 69 74 20 73 68 65 6c 6c 29 0a 0a 20 20 63 Git shell).. c
0820: 64 20 25 42 55 49 4c 44 44 49 52 25 0a 20 20 6f d %BUILDDIR%. o
0830: 64 20 2d 41 20 6e 20 2d 76 20 2d 74 20 78 43 20 d -A n -v -t xC
0840: 3c 20 27 6c 69 62 72 61 72 79 2f 74 6c 73 2e 74 < 'library/tls.t
0850: 63 6c 27 20 3e 20 74 6c 73 2e 74 63 6c 2e 68 2e cl' > tls.tcl.h.
0860: 6e 65 77 2e 31 0a 20 20 73 65 64 20 27 73 40 5b new.1. sed 's@[
0870: 5e 30 2d 39 41 2d 46 61 2d 66 5d 40 40 67 3b 73 ^0-9A-Fa-f]@@g;s
0880: 40 2e 2e 40 30 78 26 2c 20 40 67 27 20 3c 20 74 @..@0x&, @g' < t
0890: 6c 73 2e 74 63 6c 2e 68 2e 6e 65 77 2e 31 20 3e ls.tcl.h.new.1 >
08a0: 20 67 65 6e 65 72 69 63 2f 74 6c 73 2e 74 63 6c generic/tls.tcl
08b0: 2e 68 0a 20 20 72 6d 20 2d 66 20 74 6c 73 2e 74 .h. rm -f tls.t
08c0: 63 6c 2e 68 2e 6e 65 77 2e 31 0a 0a 32 63 29 20 cl.h.new.1..2c)
08d0: 53 74 61 72 74 20 56 69 73 75 61 6c 20 53 74 75 Start Visual Stu
08e0: 64 69 6f 20 73 68 65 6c 6c 0a 0a 20 20 41 74 20 dio shell.. At
08f0: 56 69 73 75 61 6c 20 53 74 75 64 69 6f 20 78 36 Visual Studio x6
0900: 34 20 6e 61 74 69 76 65 20 70 72 6f 6d 70 74 3a 4 native prompt:
0910: 0a 0a 20 20 63 64 20 25 42 55 49 4c 44 44 49 52 .. cd %BUILDDIR
0920: 25 5c 77 69 6e 0a 0a 20 20 6e 6d 61 6b 65 20 2d %\win.. nmake -
0930: 66 20 6d 61 6b 65 66 69 6c 65 2e 76 63 20 54 43 f makefile.vc TC
0940: 4c 44 49 52 3d 25 54 43 4c 49 4e 53 54 41 4c 4c LDIR=%TCLINSTALL
0950: 25 20 53 53 4c 5f 49 4e 53 54 41 4c 4c 5f 46 4f % SSL_INSTALL_FO
0960: 4c 44 45 52 3d 25 53 53 4c 49 4e 53 54 41 4c 4c LDER=%SSLINSTALL
0970: 25 0a 20 20 6e 6d 61 6b 65 20 2d 66 20 6d 61 6b %. nmake -f mak
0980: 65 66 69 6c 65 2e 76 63 20 69 6e 73 74 61 6c 6c efile.vc install
0990: 20 54 43 4c 44 49 52 3d 63 3a 5c 74 65 73 74 5c TCLDIR=c:\test\
09a0: 74 63 6c 38 36 31 30 20 49 4e 53 54 41 4c 4c 44 tcl8610 INSTALLD
09b0: 49 52 3d 25 54 43 4c 49 4e 53 54 41 4c 4c 25 20 IR=%TCLINSTALL%
09c0: 53 53 4c 5f 49 4e 53 54 41 4c 4c 5f 46 4f 4c 44 SSL_INSTALL_FOLD
09d0: 45 52 3d 25 53 53 4c 49 4e 53 54 41 4c 4c 25 0a ER=%SSLINSTALL%.
09e0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
09f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
0a00: 33 29 20 54 65 73 74 0a 0a 53 74 61 72 74 20 74 3) Test..Start t
0a10: 63 6c 73 68 20 6f 72 20 77 69 73 68 0a 0a 70 61 clsh or wish..pa
0a20: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 6c ckage require tl
0a30: 73 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 s.package requir
0a40: 65 20 68 74 74 70 0a 68 74 74 70 3a 3a 72 65 67 e http.http::reg
0a50: 69 73 74 65 72 20 68 74 74 70 73 20 34 34 33 20 ister https 443
0a60: 5b 6c 69 73 74 20 3a 3a 74 6c 73 3a 3a 73 6f 63 [list ::tls::soc
0a70: 6b 65 74 20 2d 61 75 74 6f 73 65 72 76 65 72 6e ket -autoservern
0a80: 61 6d 65 20 74 72 75 65 5d 0a 73 65 74 20 74 6f ame true].set to
0a90: 6b 20 5b 68 74 74 70 3a 3a 64 61 74 61 20 5b 68 k [http::data [h
0aa0: 74 74 70 3a 3a 67 65 74 75 72 6c 20 68 74 74 70 ttp::geturl http
0ab0: 73 3a 2f 2f 77 77 77 2e 74 63 6c 2d 6c 61 6e 67 s://www.tcl-lang
0ac0: 2e 6f 72 67 5d 5d 0a 3a 3a 68 74 74 70 3a 3a 63 .org]].::http::c
0ad0: 6c 65 61 6e 75 70 20 24 74 6f 6b 0a leanup $tok.