putty/RECIPE

   1 # -*- makefile -*-\r
   2 # \r
   3 # This file describes which PuTTY programs are made up from which\r
   4 # object and resource files. It is processed into the various\r
   5 # Makefiles by means of a Perl script. Makefile changes should\r
   6 # really be made by editing this file and/or the Perl script, not\r
   7 # by editing the actual Makefiles.\r
   8 \r
   9 # ------------------------------------------------------------\r
  10 # Top-level configuration.\r
  11 \r
  12 # Overall project name.\r
  13 !name putty\r
  14 # Locations and types of output Makefiles.\r
  15 !makefile vc windows/Makefile.vc\r
  16 !makefile vcproj windows/MSVC\r
  17 !makefile cygwin windows/Makefile.cyg\r
  18 !makefile borland windows/Makefile.bor\r
  19 !makefile lcc windows/Makefile.lcc\r
  20 !makefile gtk unix/Makefile.gtk\r
  21 !makefile unix unix/Makefile.ux\r
  22 !makefile am unix/Makefile.am\r
  23 !makefile osx macosx/Makefile\r
  24 !makefile devcppproj windows/DEVCPP\r
  25 # Source directories.\r
  26 !srcdir charset/\r
  27 !srcdir windows/\r
  28 !srcdir unix/\r
  29 !srcdir macosx/\r
  30 \r
  31 # Help text added to the top of each Makefile, with /D converted\r
  32 # into -D as appropriate for the particular Makefile.\r
  33 \r
  34 !begin help\r
  35 #\r
  36 # Extra options you can set:\r
  37 #\r
  38 #  - VER="/DSNAPSHOT=1999-01-25 /DSVN_REV=1234"\r
  39 #      Generates executables whose About box report them as being a\r
  40 #      development snapshot. SVN_REV is a Subversion revision number.\r
  41 #\r
  42 #  - VER=/DRELEASE=0.43\r
  43 #      Generates executables whose About box report them as being a\r
  44 #      release version.\r
  45 #\r
  46 #  - COMPAT=/DAUTO_WINSOCK (Windows only)\r
  47 #      Causes PuTTY to assume that <windows.h> includes its own WinSock\r
  48 #      header file, so that it won't try to include <winsock.h>.\r
  49 #\r
  50 #  - COMPAT=/DWINSOCK_TWO (Windows only)\r
  51 #      Causes the PuTTY utilities to include <winsock2.h> instead of\r
  52 #      <winsock.h>, except Plink which _needs_ WinSock 2 so it already\r
  53 #      does this.\r
  54 #\r
  55 #  - COMPAT=/DNO_SECURITY (Windows only)\r
  56 #      Disables Pageant's use of <aclapi.h>, which is not available\r
  57 #      with some development environments (such as older versions of\r
  58 #      the Cygwin/mingw GNU toolchain). This means that Pageant\r
  59 #      won't care about the local user ID of processes accessing it; a\r
  60 #      version of Pageant built with this option will therefore refuse\r
  61 #      to run under NT-series OSes on security grounds (although it\r
  62 #      will run fine on Win95-series OSes where there is no access\r
  63 #      control anyway).\r
  64 #\r
  65 #  - COMPAT=/DNO_MULTIMON (Windows only)\r
  66 #      Disables PuTTY's use of <multimon.h>, which is not available\r
  67 #      with some development environments. This means that PuTTY's\r
  68 #      full-screen mode (configurable to work on Alt-Enter) will\r
  69 #      not behave usefully in a multi-monitor environment.\r
  70 #\r
  71 #      Note that this definition is always enabled in the Cygwin\r
  72 #      build, since at the time of writing this <multimon.h> is\r
  73 #      known not to be available in Cygwin.\r
  74 #\r
  75 #  - COMPAT=/DNO_HTMLHELP (Windows only)\r
  76 #      Disables PuTTY's use of <htmlhelp.h>, which is not available\r
  77 #      with some development environments. The resulting binary\r
  78 #      will only look for an old-style WinHelp file (.HLP/.CNT), and\r
  79 #      will ignore any .CHM file.\r
  80 #\r
  81 #      Note that this definition is always enabled in the Cygwin\r
  82 #      build, since at the time of writing this <htmlhelp.h> is\r
  83 #      known not to be available in Cygwin (although you can use\r
  84 #      the htmlhelp.h supplied with HTML Help Workshop).\r
  85 #\r
  86 #  - RCFL=/DNO_MANIFESTS (Windows only)\r
  87 #      Disables inclusion of XML application manifests in the PuTTY\r
  88 #      binaries. This may be necessary to build for 64-bit Windows;\r
  89 #      the manifests are only included to use the XP GUI style on\r
  90 #      Windows XP, and the architecture tags are a lie on 64-bit.\r
  91 #\r
  92 #  - COMPAT=/DNO_IPV6\r
  93 #      Disables PuTTY's ability to make IPv6 connections, enabling\r
  94 #      it to compile under development environments which do not\r
  95 #      support IPv6 in their header files.\r
  96 #\r
  97 #  - COMPAT=/DNO_GSSAPI\r
  98 #      Disables PuTTY's ability to use GSSAPI functions for\r
  99 #      authentication and key exchange.\r
 100 #\r
 101 #  - COMPAT=/DSTATIC_GSSAPI\r
 102 #      Causes PuTTY to try to link statically against the GSSAPI\r
 103 #      library instead of the default of doing it at run time.\r
 104 #\r
 105 #  - COMPAT=/DMSVC4 (Windows only)\r
 106 #  - RCFL=/DMSVC4\r
 107 #      Makes a couple of minor changes so that PuTTY compiles using\r
 108 #      MSVC 4. You will also need /DNO_SECURITY and /DNO_MULTIMON.\r
 109 #\r
 110 #  - RCFL=/DASCIICTLS (Windows only)\r
 111 #      Uses ASCII rather than Unicode to specify the tab control in\r
 112 #      the resource file. Probably most useful when compiling with\r
 113 #      Cygnus/mingw32, whose resource compiler may have less of a\r
 114 #      problem with it.\r
 115 #\r
 116 #  - COMPAT=/DNO_SECUREZEROMEMORY (Windows only)\r
 117 #      Disables PuTTY's use of SecureZeroMemory(), which is missing\r
 118 #      from some environments' header files.  This is enabled by\r
 119 #      default in the Cygwin Makefile.\r
 120 #\r
 121 #  - XFLAGS=/DTELNET_DEFAULT\r
 122 #      Causes PuTTY to default to the Telnet protocol (in the absence\r
 123 #      of Default Settings and so on to the contrary). Normally PuTTY\r
 124 #      will default to SSH.\r
 125 #\r
 126 #  - XFLAGS=/DDEBUG\r
 127 #      Causes PuTTY to enable internal debugging.\r
 128 #\r
 129 #  - XFLAGS=/DMALLOC_LOG\r
 130 #      Causes PuTTY to emit a file called putty_mem.log, logging every\r
 131 #      memory allocation and free, so you can track memory leaks.\r
 132 #\r
 133 #  - XFLAGS=/DMINEFIELD (Windows only)\r
 134 #      Causes PuTTY to use a custom memory allocator, similar in\r
 135 #      concept to Electric Fence, in place of regular malloc(). Wastes\r
 136 #      huge amounts of RAM, but should cause heap-corruption bugs to\r
 137 #      show up as GPFs at the point of failure rather than appearing\r
 138 #      later on as second-level damage.\r
 139 #\r
 140 !end\r
 141 \r
 142 # ------------------------------------------------------------\r
 143 # Additional text added verbatim to each individual Makefile.\r
 144 \r
 145 # Hack to force version.o to be rebuilt always.\r
 146 !begin vc\r
 147 version.obj: *.c *.h *.rc\r
 148         cl $(VER) $(CFLAGS) /c ..\version.c\r
 149 !end\r
 150 !specialobj vc version\r
 151 !begin cygwin\r
 152 version.o: FORCE\r
 153         $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c\r
 154 !end\r
 155 !specialobj cygwin version\r
 156 !begin borland\r
 157 version.obj: FORCE\r
 158         bcc32 $(VER) $(CFLAGS) /c ..\version.c\r
 159 !end\r
 160 !specialobj borland version\r
 161 !begin lcc\r
 162 version.obj: FORCE\r
 163         lcc $(VER) $(CFLAGS) /c ..\version.c\r
 164 !end\r
 165 !specialobj lcc version\r
 166 # For Unix, we also need the gross MD5 hack that causes automatic\r
 167 # version number selection in release source archives.\r
 168 !begin gtk\r
 169 version.o: FORCE\r
 170         if test -z "$(VER)" && (cd ..; md5sum -c manifest); then \\r
 171                 $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) `cat ../version.def` -c ../version.c; \\r
 172         else \\r
 173                 $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c; \\r
 174         fi\r
 175 !end\r
 176 !specialobj gtk version\r
 177 # In the automake build, we have to do the whole job by supplying\r
 178 # extra CFLAGS, so we have to put the if statement inside one big\r
 179 # backtick expression. We also force rebuilding via a -D option that\r
 180 # makes version.o include empty.h, which we construct ourselves and\r
 181 # touch whenever any source file is updated.\r
 182 !cflags am version $(VER) -DINCLUDE_EMPTY_H `if test -z "$(VER)" && (cd $(srcdir)/..; md5sum -c manifest >/dev/null 2>&1); then cat $(srcdir)/../version.def; else echo "$(VER)"; fi`\r
 183 !begin am\r
 184 BUILT_SOURCES = empty.h\r
 185 empty.h: $(allsources)\r
 186         echo '/* Empty file touched by automake makefile to force rebuild of version.o */' >$@\r
 187 \r
 188 !end\r
 189 !begin >empty.h\r
 190 /* Empty file touched by automake makefile to force rebuild of version.o */\r
 191 !end\r
 192 \r
 193 # Add VER to Windows resource targets, and force them to be rebuilt every\r
 194 # time, on the assumption that they will contain version information.\r
 195 !begin vc vars\r
 196 CFLAGS = $(CFLAGS) /DHAS_GSSAPI /DSECURITY_WIN32\r
 197 RCFLAGS = $(RCFLAGS) $(VER)\r
 198 !end\r
 199 !begin cygwin vars\r
 200 CFLAGS += -DSECURITY_WIN32\r
 201 # XXX GNU-ism, but it's probably all right for a Cygwin/MinGW Makefile.\r
 202 RCFLAGS += $(patsubst -D%,--define %,$(VER))\r
 203 !end\r
 204 !begin borland vars\r
 205 # Borland doesn't support +=. This probably shouldn't work, but seems to.\r
 206 RCFLAGS = $(RCFLAGS) $(VER)\r
 207 !end\r
 208 !begin lcc vars\r
 209 RCFLAGS += $(VER)\r
 210 !end\r
 211 !forceobj putty.res\r
 212 !forceobj puttytel.res\r
 213 !forceobj plink.res\r
 214 !forceobj pscp.res\r
 215 !forceobj psftp.res\r
 216 !forceobj pageant.res\r
 217 !forceobj puttygen.res\r
 218 \r
 219 # `make install' target for Unix.\r
 220 !begin gtk\r
 221 install:\r
 222         mkdir -p $(DESTDIR)$(bindir) $(DESTDIR)$(man1dir)\r
 223         $(INSTALL_PROGRAM) -m 755 plink $(DESTDIR)$(bindir)/plink\r
 224         $(INSTALL_PROGRAM) -m 755 pscp $(DESTDIR)$(bindir)/pscp\r
 225         $(INSTALL_PROGRAM) -m 755 psftp $(DESTDIR)$(bindir)/psftp\r
 226         $(INSTALL_PROGRAM) -m 755 pterm $(DESTDIR)$(bindir)/pterm\r
 227         if test -n "$(UTMP_GROUP)"; then \\r
 228           chgrp $(UTMP_GROUP) $(DESTDIR)$(bindir)/pterm && \\r
 229             chmod 2755 $(DESTDIR)$(bindir)/pterm; \\r
 230         elif test -n "$(UTMP_USER)"; then \\r
 231           chown $(UTMP_USER) $(DESTDIR)$(bindir)/pterm && \\r
 232             chmod 4755 $(DESTDIR)$(bindir)/pterm; \\r
 233         fi\r
 234         $(INSTALL_PROGRAM) -m 755 putty $(DESTDIR)$(bindir)/putty\r
 235         $(INSTALL_PROGRAM) -m 755 puttygen $(DESTDIR)$(bindir)/puttygen\r
 236         $(INSTALL_PROGRAM) -m 755 puttytel $(DESTDIR)$(bindir)/puttytel\r
 237         $(INSTALL_DATA) -m 644 ../doc/plink.1 $(DESTDIR)$(man1dir)/plink.1\r
 238         $(INSTALL_DATA) -m 644 ../doc/pscp.1 $(DESTDIR)$(man1dir)/pscp.1\r
 239         $(INSTALL_DATA) -m 644 ../doc/psftp.1 $(DESTDIR)$(man1dir)/psftp.1\r
 240         $(INSTALL_DATA) -m 644 ../doc/pterm.1 $(DESTDIR)$(man1dir)/pterm.1\r
 241         $(INSTALL_DATA) -m 644 ../doc/putty.1 $(DESTDIR)$(man1dir)/putty.1\r
 242         $(INSTALL_DATA) -m 644 ../doc/puttygen.1 $(DESTDIR)$(man1dir)/puttygen.1\r
 243         $(INSTALL_DATA) -m 644 ../doc/puttytel.1 $(DESTDIR)$(man1dir)/puttytel.1\r
 244 \r
 245 install-strip:\r
 246         $(MAKE) install INSTALL_PROGRAM="$(INSTALL_PROGRAM) -s"\r
 247 !end\r
 248 !begin osx vars\r
 249 CFLAGS += -DMACOSX\r
 250 !end\r
 251 \r
 252 # List the man pages for the automake makefile.\r
 253 !begin am\r
 254 man1_MANS = ../doc/plink.1 ../doc/pscp.1 ../doc/psftp.1 ../doc/pterm.1 \\r
 255             ../doc/putty.1 ../doc/puttygen.1 ../doc/puttytel.1\r
 256 !end\r
 257 \r
 258 # In automake, chgrp/chmod pterm after installation, if configured to.\r
 259 !begin am\r
 260 if HAVE_SETID_CMD\r
 261 install-exec-local:\r
 262         @SETID_CMD@ $(bindir)/pterm\r
 263         chmod @SETID_MODE@ $(bindir)/pterm\r
 264 endif\r
 265 !end\r
 266 \r
 267 # Random symbols.\r
 268 !begin cygwin vars\r
 269 # _WIN32_IE is required to expose identifiers that only make sense on\r
 270 # systems with IE5+ installed, such as some arguments to SHGetFolderPath().\r
 271 # WINVER etc perform a similar function for FlashWindowEx().\r
 272 CFLAGS += -D_WIN32_IE=0x0500\r
 273 CFLAGS += -DWINVER=0x0500 -D_WIN32_WINDOWS=0x0410 -D_WIN32_WINNT=0x0500\r
 274 !end\r
 275 \r
 276 # ------------------------------------------------------------\r
 277 # Definitions of object groups. A group name, followed by an =,\r
 278 # followed by any number of objects or other already-defined group\r
 279 # names. A line beginning `+' is assumed to continue the previous\r
 280 # line.\r
 281 \r
 282 # Terminal emulator and its (platform-independent) dependencies.\r
 283 TERMINAL = terminal wcwidth ldiscucs logging tree234 minibidi\r
 284          + config dialog conf\r
 285 \r
 286 # GUI front end and terminal emulator (putty, puttytel).\r
 287 GUITERM  = TERMINAL window windlg winctrls sizetip winucs winprint\r
 288          + winutils wincfg sercfg winhelp winjump\r
 289 \r
 290 # Same thing on Unix.\r
 291 UXTERM   = TERMINAL uxcfg sercfg uxucs uxprint timing\r
 292 GTKTERM  = UXTERM gtkwin gtkcfg gtkdlg gtkfont gtkcols xkeysym\r
 293 OSXTERM  = UXTERM osxwin osxdlg osxctrls\r
 294 \r
 295 # Non-SSH back ends (putty, puttytel, plink).\r
 296 NONSSH   = telnet raw rlogin ldisc pinger\r
 297 \r
 298 # SSH back end (putty, plink, pscp, psftp).\r
 299 SSH      = ssh sshcrc sshdes sshmd5 sshrsa sshrand sshsha sshblowf\r
 300          + sshdh sshcrcda sshpubk sshzlib sshdss x11fwd portfwd\r
 301          + sshaes sshsh256 sshsh512 sshbn wildcard pinger ssharcf\r
 302          + sshgssc pgssapi\r
 303 WINSSH   = SSH winnoise winpgntc wingss\r
 304 UXSSH    = SSH uxnoise uxagentc uxgss\r
 305 \r
 306 # SFTP implementation (pscp, psftp).\r
 307 SFTP     = sftp int64 logging\r
 308 \r
 309 # Miscellaneous objects appearing in all the network utilities (not\r
 310 # Pageant or PuTTYgen).\r
 311 MISC     = timing misc version settings tree234 proxy conf\r
 312 WINMISC  = MISC winstore winnet winhandl cmdline windefs winmisc winproxy\r
 313          + wintime\r
 314 UXMISC   = MISC uxstore uxsel uxnet cmdline uxmisc uxproxy time\r
 315 OSXMISC  = MISC uxstore uxsel osxsel uxnet uxmisc uxproxy time\r
 316 \r
 317 # Character set library, for use in pterm.\r
 318 CHARSET  = sbcsdat slookup sbcs utf8 toucs fromucs xenc mimeenc macenc localenc\r
 319 \r
 320 # Standard libraries.\r
 321 LIBS     = advapi32.lib user32.lib gdi32.lib comctl32.lib comdlg32.lib\r
 322          + shell32.lib winmm.lib imm32.lib winspool.lib ole32.lib\r
 323 \r
 324 # Network backend sets. This also brings in the relevant attachment\r
 325 # to proxy.c depending on whether we're crypto-avoidant or not.\r
 326 BE_ALL   = be_all cproxy\r
 327 BE_NOSSH = be_nossh nocproxy\r
 328 BE_SSH   = be_ssh cproxy\r
 329 BE_NONE  = be_none nocproxy\r
 330 # More backend sets, with the additional Windows serial-port module.\r
 331 W_BE_ALL = be_all_s winser cproxy\r
 332 W_BE_NOSSH = be_nos_s winser nocproxy\r
 333 # And with the Unix serial-port module.\r
 334 U_BE_ALL = be_all_s uxser cproxy\r
 335 U_BE_NOSSH = be_nos_s uxser nocproxy\r
 336 \r
 337 # ------------------------------------------------------------\r
 338 # Definitions of actual programs. The program name, followed by a\r
 339 # colon, followed by a list of objects. Also in the list may be the\r
 340 # keywords [G] for Windows GUI app, [C] for Console app, [X] for\r
 341 # X/GTK Unix app, [U] for command-line Unix app.\r
 342 \r
 343 putty    : [G] GUITERM NONSSH WINSSH W_BE_ALL WINMISC winx11 putty.res LIBS\r
 344 puttytel : [G] GUITERM NONSSH W_BE_NOSSH WINMISC puttytel.res nogss LIBS\r
 345 plink    : [C] winplink wincons NONSSH WINSSH W_BE_ALL logging WINMISC\r
 346          + winx11 plink.res winnojmp LIBS\r
 347 pscp     : [C] pscp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC\r
 348          + pscp.res winnojmp LIBS\r
 349 psftp    : [C] psftp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC\r
 350          + psftp.res winnojmp LIBS\r
 351 \r
 352 pageant  : [G] winpgnt sshrsa sshpubk sshdes sshbn sshmd5 version tree234\r
 353          + misc sshaes sshsha winpgntc sshdss sshsh256 sshsh512 winutils\r
 354          + winmisc winhelp conf pageant.res LIBS\r
 355 \r
 356 puttygen : [G] winpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version\r
 357          + sshrand winnoise sshsha winstore misc winctrls sshrsa sshdss winmisc\r
 358          + sshpubk sshaes sshsh256 sshsh512 import winutils puttygen.res\r
 359          + tree234 notiming winhelp winnojmp conf LIBS wintime\r
 360 \r
 361 pterm    : [X] GTKTERM uxmisc misc ldisc settings uxpty uxsel BE_NONE uxstore\r
 362          + uxsignal CHARSET cmdline uxpterm version time xpmpterm xpmptcfg\r
 363          + nogss\r
 364 putty    : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_ALL uxstore\r
 365          + uxsignal CHARSET uxputty NONSSH UXSSH UXMISC ux_x11 xpmputty\r
 366          + xpmpucfg\r
 367 puttytel : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_NOSSH\r
 368          + uxstore uxsignal CHARSET uxputty NONSSH UXMISC xpmputty xpmpucfg\r
 369          + nogss\r
 370 \r
 371 plink    : [U] uxplink uxcons NONSSH UXSSH U_BE_ALL logging UXMISC uxsignal\r
 372          + ux_x11\r
 373 \r
 374 puttygen : [U] cmdgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version\r
 375          + sshrand uxnoise sshsha misc sshrsa sshdss uxcons uxstore uxmisc\r
 376          + sshpubk sshaes sshsh256 sshsh512 import puttygen.res time tree234\r
 377          + uxgen notiming conf\r
 378 \r
 379 pscp     : [U] pscp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC\r
 380 psftp    : [U] psftp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC\r
 381 \r
 382 PuTTY    : [MX] osxmain OSXTERM OSXMISC CHARSET U_BE_ALL NONSSH UXSSH\r
 383          + ux_x11 uxpty uxsignal testback putty.icns info.plist\r