1 2 INSTALLATION ON THE WIN64 PLATFORM 3 ---------------------------------- 4 5 Caveat lector 6 ------------- 7 8 As of moment of this writing Win64 support is classified "initial" 9 for the following reasons. 10 11 - No assembler modules are engaged upon initial 0.9.8 release. 12 - API might change within 0.9.8 life-span, *but* in a manner which 13 doesn't break backward binary compatibility. Or in other words, 14 application programs compiled with initial 0.9.8 headers will 15 be expected to work with future minor release .DLL without need 16 to re-compile, even if future minor release features modified API. 17 - Above mentioned API modifications have everything to do with 18 elimination of a number of limitations, which are normally 19 considered inherent to 32-bit platforms. Which in turn is why they 20 are treated as limitations on 64-bit platform such as Win64:-) 21 The current list comprises [but not necessarily limited to]: 22 23 - null-terminated strings may not be longer than 2G-1 bytes, 24 longer strings are treated as zero-length; 25 - dynamically and *internally* allocated chunks can't be larger 26 than 2G-1 bytes; 27 - inability to encrypt/decrypt chunks of data larger than 4GB 28 [it's possibly to *hash* chunks of arbitrary size through]; 29 30 Neither of these is actually big deal and hardly encountered 31 in real-life applications. 32 33 Compiling procedure 34 ------------------- 35 36 You will need Perl. You can run under Cygwin or you can download 37 ActiveState Perl from http://www.activestate.com/ActivePerl. 38 39 You will need Microsoft Platform SDK, available for download at 40 http://www.microsoft.com/msdownload/platformsdk/sdkupdate/. As per 41 April 2005 Platform SDK is equipped with Win64 compilers, as well 42 as assemblers, but it might change in the future. 43 44 To build for Win64/x64: 45 46 > perl Configure VC-WIN64A 47 > ms\do_win64a 48 > nmake -f ms\ntdll.mak 49 > cd out32dll 50 > ..\ms\test 51 52 To build for Win64/IA64: 53 54 > perl Configure VC-WIN64I 55 > ms\do_win64i 56 > nmake -f ms\ntdll.mak 57 > cd out32dll 58 > ..\ms\test 59 60 Naturally test-suite itself has to be executed on the target platform. 61 62 Installation 63 ------------ 64 65 TBD, for now see INSTALL.W32. 66 67