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