# really be made by editing this file and/or the Perl script, not
# by editing the actual Makefiles.
+# ------------------------------------------------------------
+# Top-level configuration.
+
+# Overall project name.
+!name putty
+# Locations and types of output Makefiles.
+!makefile vc windows/Makefile.vc
+!makefile vcproj windows/MSVC
+!makefile cygwin windows/Makefile.mgw
+!makefile borland windows/Makefile.bor
+!makefile lcc windows/Makefile.lcc
+!makefile gtk unix/Makefile.gtk
+!makefile unix unix/Makefile.ux
+!makefile am Makefile.am
+!makefile devcppproj windows/DEVCPP
+!makefile vstudio10 windows/VS2010
+!makefile vstudio12 windows/VS2012
+# Source directories.
+!srcdir charset/
+!srcdir windows/
+!srcdir unix/
+
# Help text added to the top of each Makefile, with /D converted
# into -D as appropriate for the particular Makefile.
#
# Extra options you can set:
#
-# - FWHACK=/DFWHACK
-# Enables a hack that tunnels through some firewall proxies.
-#
-# - VER=/DSNAPSHOT=1999-01-25
-# Generates executables whose About box report them as being a
-# development snapshot.
-#
-# - VER=/DRELEASE=0.43
-# Generates executables whose About box report them as being a
-# release version.
-#
-# - COMPAT=/DAUTO_WINSOCK
+# - COMPAT=/DAUTO_WINSOCK (Windows only)
# Causes PuTTY to assume that <windows.h> includes its own WinSock
# header file, so that it won't try to include <winsock.h>.
#
-# - COMPAT=/DWINSOCK_TWO
+# - COMPAT=/DWINSOCK_TWO (Windows only)
# Causes the PuTTY utilities to include <winsock2.h> instead of
# <winsock.h>, except Plink which _needs_ WinSock 2 so it already
# does this.
#
-# - COMPAT=/DNO_SECURITY
-# Disables Pageant's use of <aclapi.h>, which is not available
-# with some development environments. This means that Pageant
-# won't care about the local user ID of processes accessing it; a
-# version of Pageant built with this option will therefore refuse
-# to run under NT-series OSes on security grounds (although it
-# will run fine on Win95-series OSes where there is no access
-# control anyway).
-#
-# Note that this definition is always enabled in the Cygwin
-# build, since at the time of writing this <aclapi.h> is known
-# not to be available in Cygwin.
+# - COMPAT=/DNO_SECURITY (Windows only)
+# Disables use of <aclapi.h>, which is not available with some
+# development environments (such as very old versions of the
+# mingw/Cygwin GNU toolchain). This has the following effects:
+# - Pageant won't care about the local user ID of processes
+# accessing it; a version of Pageant built with this option
+# will therefore refuse to run under NT-series OSes on
+# security grounds (although it will run fine on Win95-series
+# OSes where there is no access control anyway).
+# - SSH connection sharing is disabled.
+# - There is no restriction of the process ACLs (on all versions
+# of Windows, without warning), as if UNPROTECT below were set.
#
-# - COMPAT=/DNO_MULTIMON
+# - COMPAT=/DNO_MULTIMON (Windows only)
# Disables PuTTY's use of <multimon.h>, which is not available
# with some development environments. This means that PuTTY's
# full-screen mode (configurable to work on Alt-Enter) will
# not behave usefully in a multi-monitor environment.
#
-# Note that this definition is always enabled in the Cygwin
-# build, since at the time of writing this <multimon.h> is
-# known not to be available in Cygwin.
+# - COMPAT=/DNO_HTMLHELP (Windows only)
+# Disables PuTTY's use of <htmlhelp.h>, which is not available
+# with some development environments. The resulting binary
+# will only look for an old-style WinHelp file (.HLP/.CNT), and
+# will ignore any .CHM file.
+#
+# If you don't have this header, you may be able to use the copy
+# supplied with HTML Help Workshop.
+#
+# - RCFL=/DNO_MANIFESTS (Windows only)
+# Disables inclusion of XML application manifests in the PuTTY
+# binaries. This may be necessary to build for 64-bit Windows;
+# the manifests are only included to use the XP GUI style on
+# Windows XP, and the architecture tags are a lie on 64-bit.
+#
+# - COMPAT=/DNO_IPV6
+# Disables PuTTY's ability to make IPv6 connections, enabling
+# it to compile under development environments which do not
+# support IPv6 in their header files.
+#
+# - COMPAT=/DNO_GSSAPI
+# Disables PuTTY's ability to use GSSAPI functions for
+# authentication and key exchange.
+#
+# - COMPAT=/DSTATIC_GSSAPI
+# Causes PuTTY to try to link statically against the GSSAPI
+# library instead of the default of doing it at run time.
#
-# - COMPAT=/DMSVC4
+# - COMPAT=/DMSVC4 (Windows only)
# - RCFL=/DMSVC4
# Makes a couple of minor changes so that PuTTY compiles using
# MSVC 4. You will also need /DNO_SECURITY and /DNO_MULTIMON.
#
-# - RCFL=/DASCIICTLS
-# Uses ASCII rather than Unicode to specify the tab control in
-# the resource file. Probably most useful when compiling with
-# Cygnus/mingw32, whose resource compiler may have less of a
-# problem with it.
+# - COMPAT=/DNO_SECUREZEROMEMORY (Windows only)
+# Disables PuTTY's use of SecureZeroMemory(), which is missing
+# from some environments' header files.
#
# - XFLAGS=/DTELNET_DEFAULT
# Causes PuTTY to default to the Telnet protocol (in the absence
# - XFLAGS=/DDEBUG
# Causes PuTTY to enable internal debugging.
#
+# - XFLAGS=/DUNPROTECT
+# Disable tightened ACL on PuTTY process so that e.g. debuggers
+# can attach to it.
+#
# - XFLAGS=/DMALLOC_LOG
# Causes PuTTY to emit a file called putty_mem.log, logging every
# memory allocation and free, so you can track memory leaks.
#
-# - XFLAGS=/DMINEFIELD
+# - XFLAGS=/DMINEFIELD (Windows only)
# Causes PuTTY to use a custom memory allocator, similar in
# concept to Electric Fence, in place of regular malloc(). Wastes
# huge amounts of RAM, but should cause heap-corruption bugs to
# show up as GPFs at the point of failure rather than appearing
# later on as second-level damage.
#
+# - XFLAGS=/DFUZZING
+# Builds a version of PuTTY with some tweaks to make fuzz testing
+# easier: the SSH random number generator is replaced by one that
+# always returns the same thing. Note that this makes SSH
+# completely insecure -- a FUZZING build should never be used to
+# connect to a real server.
+!end
+
+# ------------------------------------------------------------
+# Additional text added verbatim to each individual Makefile.
+
+!begin vc vars
+CFLAGS = $(CFLAGS) /DHAS_GSSAPI
+!end
+
+# `make install' target for Unix.
+!begin gtk
+install:
+ mkdir -p $(DESTDIR)$(bindir) $(DESTDIR)$(man1dir)
+ $(INSTALL_PROGRAM) -m 755 plink $(DESTDIR)$(bindir)/plink
+ $(INSTALL_PROGRAM) -m 755 pscp $(DESTDIR)$(bindir)/pscp
+ $(INSTALL_PROGRAM) -m 755 psftp $(DESTDIR)$(bindir)/psftp
+ $(INSTALL_PROGRAM) -m 755 pterm $(DESTDIR)$(bindir)/pterm
+ if test -n "$(UTMP_GROUP)"; then \
+ chgrp $(UTMP_GROUP) $(DESTDIR)$(bindir)/pterm && \
+ chmod 2755 $(DESTDIR)$(bindir)/pterm; \
+ elif test -n "$(UTMP_USER)"; then \
+ chown $(UTMP_USER) $(DESTDIR)$(bindir)/pterm && \
+ chmod 4755 $(DESTDIR)$(bindir)/pterm; \
+ fi
+ $(INSTALL_PROGRAM) -m 755 putty $(DESTDIR)$(bindir)/putty
+ $(INSTALL_PROGRAM) -m 755 puttygen $(DESTDIR)$(bindir)/puttygen
+ $(INSTALL_PROGRAM) -m 755 puttytel $(DESTDIR)$(bindir)/puttytel
+ $(INSTALL_DATA) -m 644 ../doc/plink.1 $(DESTDIR)$(man1dir)/plink.1
+ $(INSTALL_DATA) -m 644 ../doc/pscp.1 $(DESTDIR)$(man1dir)/pscp.1
+ $(INSTALL_DATA) -m 644 ../doc/psftp.1 $(DESTDIR)$(man1dir)/psftp.1
+ $(INSTALL_DATA) -m 644 ../doc/pterm.1 $(DESTDIR)$(man1dir)/pterm.1
+ $(INSTALL_DATA) -m 644 ../doc/putty.1 $(DESTDIR)$(man1dir)/putty.1
+ $(INSTALL_DATA) -m 644 ../doc/puttygen.1 $(DESTDIR)$(man1dir)/puttygen.1
+ $(INSTALL_DATA) -m 644 ../doc/puttytel.1 $(DESTDIR)$(man1dir)/puttytel.1
+
+install-strip:
+ $(MAKE) install INSTALL_PROGRAM="$(INSTALL_PROGRAM) -s"
+!end
+
+# List the man pages for the automake makefile.
+!begin am
+man1_MANS = doc/plink.1 doc/pscp.1 doc/psftp.1 doc/pterm.1 \
+ doc/putty.1 doc/puttygen.1 doc/puttytel.1
+!end
+
+# In automake, chgrp/chmod pterm after installation, if configured to.
+!begin am
+if HAVE_SETID_CMD
+install-exec-local:
+ @SETID_CMD@ $(bindir)/pterm
+ chmod @SETID_MODE@ $(bindir)/pterm
+endif
+!end
+
+# In automake makefile, build the OS X app bundle, if configured in
+# Quartz mode.
+!begin am
+if HAVE_QUARTZ
+noinst_SCRIPTS = unix/PuTTY.app unix/Pterm.app
+unix/PuTTY.app: unix/putty.bundle puttyapp osxlaunch
+ rm -rf $@ && gtk-mac-bundler $<
+unix/Pterm.app: unix/pterm.bundle ptermapp osxlaunch
+ rm -rf $@ && gtk-mac-bundler $<
+endif
!end
+# Random symbols.
+!begin cygwin vars
+# _WIN32_IE is required to expose identifiers that only make sense on
+# systems with IE5+ installed, such as some arguments to SHGetFolderPath().
+# WINVER etc perform a similar function for FlashWindowEx().
+CFLAGS += -D_WIN32_IE=0x0500
+CFLAGS += -DWINVER=0x0500 -D_WIN32_WINDOWS=0x0410 -D_WIN32_WINNT=0x0500
+!end
+
+# ------------------------------------------------------------
# Definitions of object groups. A group name, followed by an =,
# followed by any number of objects or other already-defined group
# names. A line beginning `+' is assumed to continue the previous
# line.
+# Terminal emulator and its (platform-independent) dependencies.
+TERMINAL = terminal wcwidth ldiscucs logging tree234 minibidi
+ + config dialog conf
+
# GUI front end and terminal emulator (putty, puttytel).
-GUITERM = window windlg winctrls terminal sizetip wcwidth unicode ldiscucs
- + logging printing winutils
+GUITERM = TERMINAL window windlg winctrls sizetip winucs winprint
+ + winutils wincfg sercfg winhelp winjump miscucs
+
+# Same thing on Unix.
+UXTERM = TERMINAL uxcfg sercfg uxucs uxprint timing callback miscucs
+GTKTERM = UXTERM gtkwin gtkcfg gtkdlg gtkfont gtkcols gtkmisc xkeysym
+ + x11misc gtkcomm
# Non-SSH back ends (putty, puttytel, plink).
-NONSSH = telnet raw rlogin ldisc
+NONSSH = telnet raw rlogin ldisc pinger
# SSH back end (putty, plink, pscp, psftp).
SSH = ssh sshcrc sshdes sshmd5 sshrsa sshrand sshsha sshblowf
+ sshdh sshcrcda sshpubk sshzlib sshdss x11fwd portfwd
- + sshaes sshsh512 sshbn wildcard
-WINSSH = SSH noise pageantc
-UXSSH = SSH uxnoise uxagentc
-MACSSH = SSH macnoise
+ + sshaes sshccp sshsh256 sshsh512 sshbn wildcard pinger ssharcf
+ + sshgssc pgssapi sshshare sshecc
+WINSSH = SSH winnoise wincapi winpgntc wingss winshare winnps winnpc
+ + winhsock errsock
+UXSSH = SSH uxnoise uxagentc uxgss uxshare
# SFTP implementation (pscp, psftp).
SFTP = sftp int64 logging
# Miscellaneous objects appearing in all the network utilities (not
# Pageant or PuTTYgen).
-WINMISC = misc version winstore settings tree234 winnet proxy cmdline
- + windefs winmisc
-UXMISC = misc version uxstore settings tree234 uxnet proxy cmdline uxmisc
-MACMISC = misc version macstore settings tree234 macnet mtcpnet otnet proxy
+MISC = timing callback misc version settings tree234 proxy conf be_misc
+WINMISC = MISC winstore winnet winhandl cmdline windefs winmisc winproxy
+ + wintime winhsock errsock winsecur
+UXMISC = MISC uxstore uxsel uxnet uxpeer cmdline uxmisc uxproxy time
+
+# import.c and dependencies, for PuTTYgen-like utilities that have to
+# load foreign key files.
+IMPORT = import sshbcrypt sshblowf
# Character set library, for use in pterm.
-CHARSET = sbcsdat slookup sbcs utf8 toucs fromucs xenc mimeenc macenc
+CHARSET = sbcsdat slookup sbcs utf8 toucs fromucs xenc mimeenc macenc localenc
-# Standard libraries, and the same with WinSocks 1 and 2.
+# Standard libraries.
LIBS = advapi32.lib user32.lib gdi32.lib comctl32.lib comdlg32.lib
- + shell32.lib winmm.lib imm32.lib winspool.lib
-LIBS1 = LIBS wsock32.lib
-LIBS2 = LIBS ws2_32.lib
+ + shell32.lib winmm.lib imm32.lib winspool.lib ole32.lib
+
+# Network backend sets. This also brings in the relevant attachment
+# to proxy.c depending on whether we're crypto-avoidant or not.
+BE_ALL = be_all cproxy
+BE_NOSSH = be_nossh nocproxy
+BE_SSH = be_ssh cproxy
+BE_NONE = be_none nocproxy
+# More backend sets, with the additional Windows serial-port module.
+W_BE_ALL = be_all_s winser cproxy
+W_BE_NOSSH = be_nos_s winser nocproxy
+# And with the Unix serial-port module.
+U_BE_ALL = be_all_s uxser cproxy
+U_BE_NOSSH = be_nos_s uxser nocproxy
+# ------------------------------------------------------------
# Definitions of actual programs. The program name, followed by a
# colon, followed by a list of objects. Also in the list may be the
# keywords [G] for Windows GUI app, [C] for Console app, [X] for
-# X/GTK Unix app, [U] for command-line Unix app, [M] for Macintosh app.
-
-putty : [G] GUITERM NONSSH WINSSH be_all WINMISC win_res.res LIBS1
-puttytel : [G] GUITERM NONSSH be_nossh WINMISC win_res.res LIBS1
-plink : [C] plink console NONSSH WINSSH be_all logging WINMISC
- + plink.res LIBS2
-pscp : [C] scp console WINSSH be_none SFTP wildcard WINMISC scp.res LIBS1
-psftp : [C] psftp console WINSSH be_none SFTP WINMISC scp.res LIBS1
-
-pageant : [G] pageant sshrsa sshpubk sshdes sshbn sshmd5 version tree234
- + misc sshaes sshsha pageantc sshdss sshsh512 winutils winmisc
- + pageant.res LIBS
-
-puttygen : [G] puttygen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
- + sshrand noise sshsha winstore misc winctrls sshrsa sshdss winmisc
- + sshpubk sshaes sshsh512 import winutils puttygen.res LIBS
-
-pterm : [X] pterm terminal wcwidth uxucs uxmisc tree234 misc ldisc ldiscucs
- + logging uxprint settings pty be_none uxstore signal CHARSET
-
-plink : [U] uxplink uxcons NONSSH UXSSH be_all logging UXMISC signal ux_x11
-
-PuTTY : [M] terminal wcwidth ldiscucs logging be_all mac macdlg macevlog
- + macterm macucs mac_res.rsrc testback NONSSH MACSSH MACMISC CHARSET
- + stricmp vsnprint
-PuTTYtel : [M] terminal wcwidth ldiscucs logging be_nossh mac macdlg macevlog
- + macterm macucs mac_res.rsrc testback NONSSH MACMISC CHARSET
- + stricmp vsnprint
+# X/GTK Unix app, [U] for command-line Unix app.
+
+putty : [G] GUITERM NONSSH WINSSH W_BE_ALL WINMISC winx11 putty.res LIBS
+puttytel : [G] GUITERM NONSSH W_BE_NOSSH WINMISC puttytel.res nogss LIBS
+plink : [C] winplink wincons NONSSH WINSSH W_BE_ALL logging WINMISC
+ + winx11 plink.res winnojmp noterm LIBS
+pscp : [C] pscp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC
+ + pscp.res winnojmp LIBS
+psftp : [C] psftp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC
+ + psftp.res winnojmp LIBS
+
+pageant : [G] winpgnt pageant sshrsa sshpubk sshdes sshbn sshmd5 version
+ + tree234 misc sshaes sshsha winsecur winpgntc sshdss sshsh256
+ + sshsh512 winutils sshecc winmisc winhelp conf pageant.res LIBS
+
+puttygen : [G] winpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
+ + sshrand winnoise sshsha winstore misc winctrls sshrsa sshdss winmisc
+ + sshpubk sshaes sshsh256 sshsh512 IMPORT winutils puttygen.res
+ + tree234 notiming winhelp winnojmp conf LIBS wintime sshecc
+ + sshecdsag winsecur
+
+pterm : [X] GTKTERM uxmisc misc ldisc settings uxpty uxsel BE_NONE uxstore
+ + uxsignal CHARSET cmdline uxpterm version time xpmpterm xpmptcfg
+ + nogss gtkmain
+putty : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_ALL uxstore
+ + uxsignal CHARSET uxputty NONSSH UXSSH UXMISC ux_x11 xpmputty
+ + xpmpucfg gtkmain
+puttytel : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_NOSSH
+ + uxstore uxsignal CHARSET uxputty NONSSH UXMISC xpmputty xpmpucfg
+ + nogss gtkmain
+
+plink : [U] uxplink uxcons NONSSH UXSSH U_BE_ALL logging UXMISC uxsignal
+ + ux_x11 noterm
+
+PUTTYGEN_UNIX = sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
+ + sshrand uxnoise sshsha misc sshrsa sshdss uxcons uxstore uxmisc
+ + sshpubk sshaes sshsh256 sshsh512 IMPORT puttygen.res time tree234
+ + uxgen notiming conf sshecc sshecdsag
+puttygen : [U] cmdgen PUTTYGEN_UNIX
+cgtest : [UT] cgtest PUTTYGEN_UNIX
+
+pscp : [U] pscp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC
+psftp : [U] psftp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC
+
+pageant : [X] uxpgnt uxagentc pageant sshrsa sshpubk sshdes sshbn sshmd5
+ + version tree234 misc sshaes sshsha sshdss sshsh256 sshsh512 sshecc
+ + conf uxsignal nocproxy nogss be_none x11fwd ux_x11 uxcons gtkask
+ + gtkmisc UXMISC
+
+ptermapp : [XT] GTKTERM uxmisc misc ldisc settings uxpty uxsel BE_NONE uxstore
+ + uxsignal CHARSET cmdline uxpterm version time xpmpterm xpmptcfg
+ + nogss gtkapp
+puttyapp : [XT] GTKTERM uxmisc misc ldisc settings uxsel U_BE_ALL uxstore
+ + uxsignal CHARSET uxputty NONSSH UXSSH UXMISC ux_x11 xpmputty
+ + xpmpucfg gtkapp
+osxlaunch : [UT] osxlaunch
+
+fuzzterm : [UT] UXTERM CHARSET misc version uxmisc uxucs fuzzterm time settings
+ + uxstore be_none
+testbn : [UT] testbn sshbn misc version conf tree234 uxmisc
+testbn : [C] testbn sshbn misc version conf tree234 winmisc LIBS
+
+# ----------------------------------------------------------------------
+# On Windows, provide a means of removing local test binaries that we
+# aren't going to actually ship. (I prefer this to not building them
+# in the first place, so that we find out about build breakage early.)
+!begin vc
+cleantestprogs:
+ -del $(BUILDDIR)testbn.exe
+!end