Artifact
7588eb108e4249eb250a8185dbccaf8a3a863cd02983d87135ba5e87b66a3542:
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 47 69 ntax error).- Gi
00f0: 74 20 4d 69 6e 47 57 20 6f 72 20 4d 53 20 57 53 t MinGW or MS WS
0100: 4c 20 73 68 65 6c 6c 20 74 6f 20 63 6f 6e 76 65 L shell to conve
0110: 72 74 20 74 6c 73 2e 74 63 6c 20 69 6e 74 6f 20 rt tls.tcl into
0120: 2e 68 20 66 69 6c 65 0a 2d 20 4f 70 65 6e 53 53 .h file.- OpenSS
0130: 4c 20 73 74 61 74 69 63 61 6c 6c 79 20 6c 69 6e L statically lin
0140: 6b 65 64 20 74 6f 20 54 43 4c 54 4c 53 20 44 4c ked to TCLTLS DL
0150: 4c 2e 0a 4e 6f 74 65 3a 20 44 79 6e 61 6d 69 63 L..Note: Dynamic
0160: 20 6c 69 6e 6b 69 6e 67 20 61 6c 73 6f 20 77 6f linking also wo
0170: 72 6b 73 20 62 75 74 20 72 65 73 75 6c 74 73 20 rks but results
0180: 69 6e 20 61 20 44 4c 4c 20 64 65 70 65 6e 64 65 in a DLL depende
0190: 6e 63 79 20 6f 6e 20 4f 50 45 4e 53 53 4c 20 44 ncy on OPENSSL D
01a0: 4c 4c 27 73 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d LL's..----------
01b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
01c0: 2d 2d 2d 0a 0a 31 29 20 42 75 69 6c 64 20 4f 70 ---..1) Build Op
01d0: 65 6e 53 53 4c 20 73 74 61 74 69 63 20 6c 69 62 enSSL static lib
01e0: 72 61 72 69 65 73 3a 0a 0a 73 65 74 20 53 53 4c raries:..set SSL
01f0: 42 55 49 4c 44 3d 5c 70 61 74 68 5c 74 6f 5c 62 BUILD=\path\to\b
0200: 75 69 6c 64 5c 64 69 72 0a 73 65 74 20 53 53 4c uild\dir.set SSL
0210: 49 4e 53 54 41 4c 4c 3d 5c 70 61 74 68 5c 74 6f INSTALL=\path\to
0220: 5c 69 6e 73 74 61 6c 6c 5c 64 69 72 0a 73 65 74 \install\dir.set
0230: 20 53 53 4c 43 4f 4d 4d 4f 4e 3d 5c 70 61 74 68 SSLCOMMON=\path
0240: 5c 74 6f 5c 63 6f 6d 6d 6f 6e 5c 64 69 72 0a 0a \to\common\dir..
0250: 28 31 61 29 20 47 65 74 20 4f 70 65 6e 53 53 4c (1a) Get OpenSSL
0260: 0a 0a 20 20 68 74 74 70 73 3a 2f 2f 67 69 74 68 .. https://gith
0270: 75 62 2e 63 6f 6d 2f 6f 70 65 6e 73 73 6c 2f 6f ub.com/openssl/o
0280: 70 65 6e 73 73 6c 2f 72 65 6c 65 61 73 65 73 2f penssl/releases/
0290: 64 6f 77 6e 6c 6f 61 64 2f 4f 70 65 6e 53 53 4c download/OpenSSL
02a0: 5f 31 5f 31 5f 31 74 2f 6f 70 65 6e 73 73 6c 2d _1_1_1t/openssl-
02b0: 31 2e 31 2e 31 74 2e 74 61 72 2e 67 7a 0a 0a 20 1.1.1t.tar.gz..
02c0: 20 55 6e 70 61 63 6b 20 4f 70 65 6e 53 53 4c 20 Unpack OpenSSL
02d0: 73 6f 75 72 63 65 20 64 69 73 74 72 69 62 75 74 source distribut
02e0: 69 6f 6e 20 74 6f 20 25 53 53 4c 42 55 49 4c 44 ion to %SSLBUILD
02f0: 25 0a 0a 28 31 62 29 20 49 6e 73 74 61 6c 6c 20 %..(1b) Install
0300: 50 65 72 6c 20 66 72 6f 6d 20 68 74 74 70 73 3a Perl from https:
0310: 2f 2f 73 74 72 61 77 62 65 72 72 79 70 65 72 6c //strawberryperl
0320: 2e 63 6f 6d 2f 0a 0a 20 20 68 74 74 70 73 3a 2f .com/.. https:/
0330: 2f 73 74 72 61 77 62 65 72 72 79 70 65 72 6c 2e /strawberryperl.
0340: 63 6f 6d 2f 64 6f 77 6e 6c 6f 61 64 2f 35 2e 33 com/download/5.3
0350: 32 2e 31 2e 31 2f 73 74 72 61 77 62 65 72 72 79 2.1.1/strawberry
0360: 2d 70 65 72 6c 2d 35 2e 33 32 2e 31 2e 31 2d 36 -perl-5.32.1.1-6
0370: 34 62 69 74 2e 6d 73 69 0a 20 20 49 6e 73 74 61 4bit.msi. Insta
0380: 6c 6c 20 74 6f 20 43 3a 5c 53 74 72 61 77 62 65 ll to C:\Strawbe
0390: 72 72 79 5c 70 65 72 6c 0a 0a 28 31 63 29 20 49 rry\perl..(1c) I
03a0: 6e 73 74 61 6c 6c 20 4e 41 53 4d 20 41 73 73 65 nstall NASM Asse
03b0: 6d 62 6c 65 72 20 66 72 6f 6d 20 68 74 74 70 73 mbler from https
03c0: 3a 2f 2f 77 77 77 2e 6e 61 73 6d 2e 75 73 2f 0a ://www.nasm.us/.
03d0: 0a 20 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e 6e . https://www.n
03e0: 61 73 6d 2e 75 73 2f 70 75 62 2f 6e 61 73 6d 2f asm.us/pub/nasm/
03f0: 72 65 6c 65 61 73 65 62 75 69 6c 64 73 2f 32 2e releasebuilds/2.
0400: 31 36 2e 30 31 2f 77 69 6e 36 34 2f 6e 61 73 6d 16.01/win64/nasm
0410: 2d 32 2e 31 36 2e 30 31 2d 69 6e 73 74 61 6c 6c -2.16.01-install
0420: 65 72 2d 78 36 34 2e 65 78 65 0a 20 20 49 6e 73 er-x64.exe. Ins
0430: 74 61 6c 6c 20 74 6f 3a 20 43 3a 5c 50 72 6f 67 tall to: C:\Prog
0440: 72 61 6d 20 46 69 6c 65 73 5c 4e 41 53 4d 0a 0a ram Files\NASM..
0450: 28 31 64 29 20 43 6f 6e 66 69 67 75 72 65 20 4f (1d) Configure O
0460: 70 65 6e 20 53 53 4c 20 31 2e 31 2e 31 0a 0a 20 pen SSL 1.1.1..
0470: 20 41 74 20 56 69 73 75 61 6c 20 53 74 75 64 69 At Visual Studi
0480: 6f 20 78 36 34 20 6e 61 74 69 76 65 20 70 72 6f o x64 native pro
0490: 6d 70 74 3a 0a 0a 20 20 63 64 20 25 53 53 4c 42 mpt:.. cd %SSLB
04a0: 55 49 4c 44 25 0a 20 20 73 65 74 20 50 61 74 68 UILD%. set Path
04b0: 3d 25 50 41 54 48 25 3b 43 3a 5c 50 72 6f 67 72 =%PATH%;C:\Progr
04c0: 61 6d 20 46 69 6c 65 73 5c 4e 41 53 4d 3b 43 3a am Files\NASM;C:
04d0: 5c 53 74 72 61 77 62 65 72 72 79 5c 70 65 72 6c \Strawberry\perl
04e0: 5c 62 69 6e 0a 20 20 70 65 72 6c 20 2e 2e 5c 43 \bin. perl ..\C
04f0: 6f 6e 66 69 67 75 72 65 20 56 43 2d 57 49 4e 36 onfigure VC-WIN6
0500: 34 41 20 6e 6f 2d 73 68 61 72 65 64 20 6e 6f 2d 4A no-shared no-
0510: 66 69 6c 65 6e 61 6d 65 73 20 74 68 72 65 61 64 filenames thread
0520: 73 20 6e 6f 2d 73 73 6c 32 20 6e 6f 2d 73 73 6c s no-ssl2 no-ssl
0530: 33 20 2d 2d 61 70 69 3d 31 2e 31 2e 30 20 2d 2d 3 --api=1.1.0 --
0540: 70 72 65 66 69 78 3d 22 25 53 53 4c 49 4e 53 54 prefix="%SSLINST
0550: 41 4c 4c 25 22 20 2d 2d 6f 70 65 6e 73 73 6c 64 ALL%" --openssld
0560: 69 72 3d 22 25 53 53 4c 43 4f 4d 4d 4f 4e 25 22 ir="%SSLCOMMON%"
0570: 20 2d 44 4f 50 45 4e 53 53 4c 5f 4e 4f 5f 44 45 -DOPENSSL_NO_DE
0580: 50 52 45 43 41 54 45 44 0a 20 20 23 20 4e 6f 74 PRECATED. # Not
0590: 20 75 73 65 64 20 6f 70 74 69 6f 6e 73 3a 20 6e used options: n
05a0: 6f 2d 61 73 6d 20 6e 6f 2d 7a 6c 69 62 20 6e 6f o-asm no-zlib no
05b0: 2d 63 6f 6d 70 20 6e 6f 2d 75 69 2d 63 6f 6e 73 -comp no-ui-cons
05c0: 6f 6c 65 20 6e 6f 2d 61 75 74 6f 6c 6f 61 64 2d ole no-autoload-
05d0: 63 6f 6e 66 69 67 0a 0a 28 31 65 29 20 43 6f 6e config..(1e) Con
05e0: 66 69 67 75 72 65 20 4f 70 65 6e 20 53 53 4c 20 figure Open SSL
05f0: 33 2e 30 2b 0a 0a 20 20 41 74 20 56 69 73 75 61 3.0+.. At Visua
0600: 6c 20 53 74 75 64 69 6f 20 78 36 34 20 6e 61 74 l Studio x64 nat
0610: 69 76 65 20 70 72 6f 6d 70 74 3a 0a 0a 20 20 63 ive prompt:.. c
0620: 64 20 25 53 53 4c 42 55 49 4c 44 25 0a 20 20 73 d %SSLBUILD%. s
0630: 65 74 20 50 61 74 68 3d 25 50 41 54 48 25 3b 43 et Path=%PATH%;C
0640: 3a 5c 50 72 6f 67 72 61 6d 20 46 69 6c 65 73 5c :\Program Files\
0650: 4e 41 53 4d 3b 43 3a 5c 53 74 72 61 77 62 65 72 NASM;C:\Strawber
0660: 72 79 5c 70 65 72 6c 5c 62 69 6e 0a 20 20 70 65 ry\perl\bin. pe
0670: 72 6c 20 2e 2e 5c 43 6f 6e 66 69 67 75 72 65 20 rl ..\Configure
0680: 56 43 2d 57 49 4e 36 34 41 20 6e 6f 2d 73 68 61 VC-WIN64A no-sha
0690: 72 65 64 20 6e 6f 2d 66 69 6c 65 6e 61 6d 65 73 red no-filenames
06a0: 20 74 68 72 65 61 64 73 20 6e 6f 2d 73 73 6c 32 threads no-ssl2
06b0: 20 6e 6f 2d 73 73 6c 33 20 2d 2d 70 72 65 66 69 no-ssl3 --prefi
06c0: 78 3d 22 25 53 53 4c 49 4e 53 54 41 4c 4c 25 22 x="%SSLINSTALL%"
06d0: 20 2d 2d 6f 70 65 6e 73 73 6c 64 69 72 3d 22 25 --openssldir="%
06e0: 53 53 4c 43 4f 4d 4d 4f 4e 25 22 0a 20 20 23 20 SSLCOMMON%". #
06f0: 4e 6f 74 20 75 73 65 64 20 6f 70 74 69 6f 6e 73 Not used options
0700: 3a 20 6e 6f 2d 61 73 6d 20 6e 6f 2d 7a 6c 69 62 : no-asm no-zlib
0710: 20 6e 6f 2d 63 6f 6d 70 20 6e 6f 2d 75 69 2d 63 no-comp no-ui-c
0720: 6f 6e 73 6f 6c 65 20 6e 6f 2d 61 75 74 6f 6c 6f onsole no-autolo
0730: 61 64 2d 63 6f 6e 66 69 67 0a 0a 28 31 66 29 20 ad-config..(1f)
0740: 42 75 69 6c 64 20 4f 70 65 6e 53 53 4c 0a 0a 20 Build OpenSSL..
0750: 20 6e 6d 61 6b 65 0a 20 20 6e 6d 61 6b 65 20 74 nmake. nmake t
0760: 65 73 74 0a 20 20 6e 6d 61 6b 65 20 69 6e 73 74 est. nmake inst
0770: 61 6c 6c 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d all..-----------
0780: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0790: 2d 2d 0a 0a 32 29 20 42 75 69 6c 64 20 54 63 6c --..2) Build Tcl
07a0: 54 4c 53 0a 0a 20 20 73 65 74 20 42 55 49 4c 44 TLS.. set BUILD
07b0: 44 49 52 3d 5c 70 61 74 68 5c 74 6f 5c 62 75 69 DIR=\path\to\bui
07c0: 6c 64 5c 74 63 6c 74 6c 73 0a 20 20 73 65 74 20 ld\tcltls. set
07d0: 54 43 4c 49 4e 53 54 41 4c 4c 3d 5c 70 61 74 68 TCLINSTALL=\path
07e0: 5c 74 6f 5c 74 63 6c 0a 20 20 73 65 74 20 49 4e \to\tcl. set IN
07f0: 53 54 41 4c 4c 44 49 52 3d 25 54 43 4c 49 4e 53 STALLDIR=%TCLINS
0800: 54 41 4c 4c 25 5c 6c 69 62 0a 20 20 73 65 74 20 TALL%\lib. set
0810: 53 53 4c 49 4e 53 54 41 4c 4c 3d 5c 70 61 74 68 SSLINSTALL=\path
0820: 5c 74 6f 5c 6f 70 65 6e 73 73 6c 5c 64 69 72 0a \to\openssl\dir.
0830: 0a 32 61 29 20 55 6e 7a 69 70 20 64 69 73 74 72 .2a) Unzip distr
0840: 69 62 75 74 69 6f 6e 20 74 6f 20 25 42 55 49 4c ibution to %BUIL
0850: 44 44 49 52 25 0a 0a 32 62 29 20 53 74 61 72 74 DDIR%..2b) Start
0860: 20 42 41 53 48 20 73 68 65 6c 6c 20 28 4d 69 6e BASH shell (Min
0870: 47 57 36 32 20 47 69 74 20 73 68 65 6c 6c 29 0a GW62 Git shell).
0880: 0a 20 20 63 64 20 25 42 55 49 4c 44 44 49 52 25 . cd %BUILDDIR%
0890: 0a 20 20 6f 64 20 2d 41 20 6e 20 2d 76 20 2d 74 . od -A n -v -t
08a0: 20 78 43 20 3c 20 27 6c 69 62 72 61 72 79 2f 74 xC < 'library/t
08b0: 6c 73 2e 74 63 6c 27 20 3e 20 74 6c 73 2e 74 63 ls.tcl' > tls.tc
08c0: 6c 2e 68 2e 6e 65 77 2e 31 0a 20 20 73 65 64 20 l.h.new.1. sed
08d0: 27 73 40 5b 5e 30 2d 39 41 2d 46 61 2d 66 5d 40 's@[^0-9A-Fa-f]@
08e0: 40 67 3b 73 40 2e 2e 40 30 78 26 2c 20 40 67 27 @g;s@..@0x&, @g'
08f0: 20 3c 20 74 6c 73 2e 74 63 6c 2e 68 2e 6e 65 77 < tls.tcl.h.new
0900: 2e 31 20 3e 20 67 65 6e 65 72 69 63 2f 74 6c 73 .1 > generic/tls
0910: 2e 74 63 6c 2e 68 0a 20 20 72 6d 20 2d 66 20 74 .tcl.h. rm -f t
0920: 6c 73 2e 74 63 6c 2e 68 2e 6e 65 77 2e 31 0a 0a ls.tcl.h.new.1..
0930: 32 63 29 20 53 74 61 72 74 20 56 69 73 75 61 6c 2c) Start Visual
0940: 20 53 74 75 64 69 6f 20 73 68 65 6c 6c 0a 0a 20 Studio shell..
0950: 20 41 74 20 56 69 73 75 61 6c 20 53 74 75 64 69 At Visual Studi
0960: 6f 20 78 36 34 20 6e 61 74 69 76 65 20 70 72 6f o x64 native pro
0970: 6d 70 74 3a 0a 0a 20 20 63 64 20 25 42 55 49 4c mpt:.. cd %BUIL
0980: 44 44 49 52 25 5c 77 69 6e 0a 0a 20 20 6e 6d 61 DDIR%\win.. nma
0990: 6b 65 20 2d 66 20 6d 61 6b 65 66 69 6c 65 2e 76 ke -f makefile.v
09a0: 63 20 54 43 4c 44 49 52 3d 25 54 43 4c 49 4e 53 c TCLDIR=%TCLINS
09b0: 54 41 4c 4c 25 20 53 53 4c 5f 49 4e 53 54 41 4c TALL% SSL_INSTAL
09c0: 4c 5f 46 4f 4c 44 45 52 3d 25 53 53 4c 49 4e 53 L_FOLDER=%SSLINS
09d0: 54 41 4c 4c 25 0a 20 20 6e 6d 61 6b 65 20 2d 66 TALL%. nmake -f
09e0: 20 6d 61 6b 65 66 69 6c 65 2e 76 63 20 69 6e 73 makefile.vc ins
09f0: 74 61 6c 6c 20 54 43 4c 44 49 52 3d 25 54 43 4c tall TCLDIR=%TCL
0a00: 49 4e 53 54 41 4c 4c 25 20 49 4e 53 54 41 4c 4c INSTALL% INSTALL
0a10: 44 49 52 3d 25 49 4e 53 54 41 4c 4c 44 49 52 25 DIR=%INSTALLDIR%
0a20: 20 53 53 4c 5f 49 4e 53 54 41 4c 4c 5f 46 4f 4c SSL_INSTALL_FOL
0a30: 44 45 52 3d 25 53 53 4c 49 4e 53 54 41 4c 4c 25 DER=%SSLINSTALL%
0a40: 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ..--------------
0a50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0a60: 0a 33 29 20 54 65 73 74 0a 0a 53 74 61 72 74 20 .3) Test..Start
0a70: 74 63 6c 73 68 20 6f 72 20 77 69 73 68 0a 0a 70 tclsh or wish..p
0a80: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 74 ackage require t
0a90: 6c 73 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 ls.package requi
0aa0: 72 65 20 68 74 74 70 0a 68 74 74 70 3a 3a 72 65 re http.http::re
0ab0: 67 69 73 74 65 72 20 68 74 74 70 73 20 34 34 33 gister https 443
0ac0: 20 5b 6c 69 73 74 20 3a 3a 74 6c 73 3a 3a 73 6f [list ::tls::so
0ad0: 63 6b 65 74 20 2d 61 75 74 6f 73 65 72 76 65 72 cket -autoserver
0ae0: 6e 61 6d 65 20 74 72 75 65 5d 0a 73 65 74 20 74 name true].set t
0af0: 6f 6b 20 5b 68 74 74 70 3a 3a 64 61 74 61 20 5b ok [http::data [
0b00: 68 74 74 70 3a 3a 67 65 74 75 72 6c 20 68 74 74 http::geturl htt
0b10: 70 73 3a 2f 2f 77 77 77 2e 74 63 6c 2d 6c 61 6e ps://www.tcl-lan
0b20: 67 2e 6f 72 67 5d 5d 0a 3a 3a 68 74 74 70 3a 3a g.org]].::http::
0b30: 63 6c 65 61 6e 75 70 20 24 74 6f 6b 0a cleanup $tok.