Building

Build PuTTY with the wincrypt patch from source.

Requirements

• The putty_wincrypt_068_git.patch found on the download page of this project

• The PuTTY 0.68 source checked out from git at:

  git clone --branch 0.68 git://git.tartarus.org/simon/putty.git
  

• Microsoft Visual C compiler (visual studio)

(Cygwin, BCC5.5 or LCC may also work)

Details

1: Apply the patch

Apply the putty_wincrypt_068_git.patch to the source code.

    patch -p1 -i putty_wincrypt_068_git.patch

Ignore any patch warnings about offsets.

2: Generate the Makefiles

    ./mkfiles.pl

3: Set up the build environment (Visual C only)

This can be done by starting the "Visual Studio Command Prompt" in the Visual Studio tools folder in the start menu.

4: Build

In the PuTTY source directory move into the windows sub-directory and compile PuTTY with the wincrypt patch. This is done by executing the following command:

Visual C:

    nmake -f Makefile.vc

Cygwin:

    make -f Makefile.cyg

BCC:

    make -f Makefile.bcc

LCC:

    make -f Makefile.lcc

5: Use

If the build was successful it should now be possible to use the newly compiled versions of PuTTY and Pageant. The executables will be found in the windows sub-directory of the PuTTY source.

Notes about the build environment

It is possible to build the wincrypt patched version of PuTTY with Microsoft Visual C / Cygwin / BCC or LCC. Both BCC and LCC will generate some errors not directly related to the path. Because of these problems the recommended build environment is Visual C.