Artifact
ea17660b5631384f6dd5642e4dafe675a1de08f6363d2d7da2825454f8b2b834:
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 38 36 20 6e 61 74 69 76 65 20 udio x86 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 38 36 20 sual Studio x86
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 73 65 74 20 42 55 49 4c TclTLS..set BUIL
0790: 44 44 49 52 3d 5c 70 61 74 68 5c 74 6f 5c 62 75 DDIR=\path\to\bu
07a0: 69 6c 64 5c 64 69 72 0a 73 65 74 20 54 43 4c 49 ild\dir.set TCLI
07b0: 4e 53 54 41 4c 4c 3d 5c 70 61 74 68 5c 74 6f 5c NSTALL=\path\to\
07c0: 74 63 6c 5c 64 69 72 0a 0a 32 61 29 20 55 6e 7a tcl\dir..2a) Unz
07d0: 69 70 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 ip distribution
07e0: 74 6f 20 25 42 55 49 4c 44 44 49 52 25 0a 0a 32 to %BUILDDIR%..2
07f0: 62 29 20 53 74 61 72 74 20 42 41 53 48 20 73 68 b) Start BASH sh
0800: 65 6c 6c 20 28 4d 69 6e 47 57 36 32 20 47 69 74 ell (MinGW62 Git
0810: 20 73 68 65 6c 6c 29 0a 0a 63 64 20 25 42 55 49 shell)..cd %BUI
0820: 4c 44 44 49 52 25 0a 6f 64 20 2d 41 20 6e 20 2d LDDIR%.od -A n -
0830: 76 20 2d 74 20 78 43 20 3c 20 27 6c 69 62 72 61 v -t xC < 'libra
0840: 72 79 2f 74 6c 73 2e 74 63 6c 27 20 3e 20 74 6c ry/tls.tcl' > tl
0850: 73 2e 74 63 6c 2e 68 2e 6e 65 77 2e 31 0a 73 65 s.tcl.h.new.1.se
0860: 64 20 27 73 40 5b 5e 30 2d 39 41 2d 46 61 2d 66 d 's@[^0-9A-Fa-f
0870: 5d 40 40 67 3b 73 40 2e 2e 40 30 78 26 2c 20 40 ]@@g;s@..@0x&, @
0880: 67 27 20 3c 20 74 6c 73 2e 74 63 6c 2e 68 2e 6e g' < tls.tcl.h.n
0890: 65 77 2e 31 20 3e 20 67 65 6e 65 72 69 63 2f 74 ew.1 > generic/t
08a0: 6c 73 2e 74 63 6c 2e 68 0a 72 6d 20 2d 66 20 74 ls.tcl.h.rm -f t
08b0: 6c 73 2e 74 63 6c 2e 68 2e 6e 65 77 2e 31 0a 0a ls.tcl.h.new.1..
08c0: 32 63 29 20 53 74 61 72 74 20 56 69 73 75 61 6c 2c) Start Visual
08d0: 20 53 74 75 64 69 6f 20 73 68 65 6c 6c 0a 0a 63 Studio shell..c
08e0: 64 20 25 42 55 49 4c 44 44 49 52 25 5c 77 69 6e d %BUILDDIR%\win
08f0: 0a 0a 6e 6d 61 6b 65 20 2d 66 20 6d 61 6b 65 66 ..nmake -f makef
0900: 69 6c 65 2e 76 63 20 54 43 4c 44 49 52 3d 25 54 ile.vc TCLDIR=%T
0910: 43 4c 49 4e 53 54 41 4c 4c 25 20 53 53 4c 5f 49 CLINSTALL% SSL_I
0920: 4e 53 54 41 4c 4c 5f 46 4f 4c 44 45 52 3d 25 53 NSTALL_FOLDER=%S
0930: 53 4c 49 4e 53 54 41 4c 4c 25 0a 6e 6d 61 6b 65 SLINSTALL%.nmake
0940: 20 2d 66 20 6d 61 6b 65 66 69 6c 65 2e 76 63 20 -f makefile.vc
0950: 69 6e 73 74 61 6c 6c 20 54 43 4c 44 49 52 3d 63 install TCLDIR=c
0960: 3a 5c 74 65 73 74 5c 74 63 6c 38 36 31 30 20 49 :\test\tcl8610 I
0970: 4e 53 54 41 4c 4c 44 49 52 3d 25 54 43 4c 49 4e NSTALLDIR=%TCLIN
0980: 53 54 41 4c 4c 25 20 53 53 4c 5f 49 4e 53 54 41 STALL% SSL_INSTA
0990: 4c 4c 5f 46 4f 4c 44 45 52 3d 25 53 53 4c 49 4e LL_FOLDER=%SSLIN
09a0: 53 54 41 4c 4c 25 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d STALL%..--------
09b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
09c0: 2d 2d 2d 2d 2d 0a 0a 33 29 20 54 65 73 74 0a 0a -----..3) Test..
09d0: 53 74 61 72 74 20 74 63 6c 73 68 20 6f 72 20 77 Start tclsh or w
09e0: 69 73 68 0a 0a 70 61 63 6b 61 67 65 20 72 65 71 ish..package req
09f0: 75 69 72 65 20 74 6c 73 0a 70 61 63 6b 61 67 65 uire tls.package
0a00: 20 72 65 71 75 69 72 65 20 68 74 74 70 0a 68 74 require http.ht
0a10: 74 70 3a 3a 72 65 67 69 73 74 65 72 20 68 74 74 tp::register htt
0a20: 70 73 20 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 ps 443 [list ::t
0a30: 6c 73 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f ls::socket -auto
0a40: 73 65 72 76 65 72 6e 61 6d 65 20 74 72 75 65 5d servername true]
0a50: 0a 73 65 74 20 74 6f 6b 20 5b 68 74 74 70 3a 3a .set tok [http::
0a60: 64 61 74 61 20 5b 68 74 74 70 3a 3a 67 65 74 75 data [http::getu
0a70: 72 6c 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 74 rl https://www.t
0a80: 63 6c 2d 6c 61 6e 67 2e 6f 72 67 5d 5d 0a 3a 3a cl-lang.org]].::
0a90: 68 74 74 70 3a 3a 63 6c 65 61 6e 75 70 20 24 74 http::cleanup $t
0aa0: 6f 6b 0a ok.