]> asedeno.scripts.mit.edu Git - PuTTY.git/blob - Recipe
ac7171cca93a680e7d46beb4e96a719ee282ff00
[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 mpw mac/Makefile.mpw
22 # Source directories.
23 !srcdir charset/
24 !srcdir windows/
25 !srcdir unix/
26 !srcdir mac/
27
28 # Help text added to the top of each Makefile, with /D converted
29 # into -D as appropriate for the particular Makefile.
30
31 !begin help
32 #
33 # Extra options you can set:
34 #
35 #  - FWHACK=/DFWHACK
36 #      Enables a hack that tunnels through some firewall proxies.
37 #
38 #  - VER=/DSNAPSHOT=1999-01-25
39 #      Generates executables whose About box report them as being a
40 #      development snapshot.
41 #
42 #  - VER=/DRELEASE=0.43
43 #      Generates executables whose About box report them as being a
44 #      release version.
45 #
46 #  - COMPAT=/DAUTO_WINSOCK
47 #      Causes PuTTY to assume that <windows.h> includes its own WinSock
48 #      header file, so that it won't try to include <winsock.h>.
49 #
50 #  - COMPAT=/DWINSOCK_TWO
51 #      Causes the PuTTY utilities to include <winsock2.h> instead of
52 #      <winsock.h>, except Plink which _needs_ WinSock 2 so it already
53 #      does this.
54 #
55 #  - COMPAT=/DNO_SECURITY
56 #      Disables Pageant's use of <aclapi.h>, which is not available
57 #      with some development environments (such as older versions of
58 #      the Cygwin/mingw GNU toolchain). This means that Pageant
59 #      won't care about the local user ID of processes accessing it; a
60 #      version of Pageant built with this option will therefore refuse
61 #      to run under NT-series OSes on security grounds (although it
62 #      will run fine on Win95-series OSes where there is no access
63 #      control anyway).
64 #
65 #  - COMPAT=/DNO_MULTIMON
66 #      Disables PuTTY's use of <multimon.h>, which is not available
67 #      with some development environments. This means that PuTTY's
68 #      full-screen mode (configurable to work on Alt-Enter) will
69 #      not behave usefully in a multi-monitor environment.
70 #
71 #      Note that this definition is always enabled in the Cygwin
72 #      build, since at the time of writing this <multimon.h> is
73 #      known not to be available in Cygwin.
74 #
75 #  - COMPAT=/DMSVC4
76 #  - RCFL=/DMSVC4
77 #      Makes a couple of minor changes so that PuTTY compiles using
78 #      MSVC 4. You will also need /DNO_SECURITY and /DNO_MULTIMON.
79 #
80 #  - RCFL=/DASCIICTLS
81 #      Uses ASCII rather than Unicode to specify the tab control in
82 #      the resource file. Probably most useful when compiling with
83 #      Cygnus/mingw32, whose resource compiler may have less of a
84 #      problem with it.
85 #
86 #  - XFLAGS=/DTELNET_DEFAULT
87 #      Causes PuTTY to default to the Telnet protocol (in the absence
88 #      of Default Settings and so on to the contrary). Normally PuTTY
89 #      will default to SSH.
90 #
91 #  - XFLAGS=/DDEBUG
92 #      Causes PuTTY to enable internal debugging.
93 #
94 #  - XFLAGS=/DMALLOC_LOG
95 #      Causes PuTTY to emit a file called putty_mem.log, logging every
96 #      memory allocation and free, so you can track memory leaks.
97 #
98 #  - XFLAGS=/DMINEFIELD
99 #      Causes PuTTY to use a custom memory allocator, similar in
100 #      concept to Electric Fence, in place of regular malloc(). Wastes
101 #      huge amounts of RAM, but should cause heap-corruption bugs to
102 #      show up as GPFs at the point of failure rather than appearing
103 #      later on as second-level damage.
104 #
105 !end
106
107 # ------------------------------------------------------------
108 # Additional text added verbatim to each individual Makefile.
109
110 # Hack to force version.o to be rebuilt always.
111 !begin vc
112 version.obj: *.c *.h *.rc
113         cl $(FWHACK) $(VER) $(CFLAGS) /c ..\version.c
114 !end
115 !specialobj vc version
116 !begin cygwin
117 version.o: FORCE
118 FORCE:
119         $(CC) $(COMPAT) $(FWHACK) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c
120 !end
121 !specialobj cygwin version
122 !begin borland
123 version.obj: FORCE
124 FORCE:
125         bcc32 $(FWHACK) $(VER) $(CFLAGS) /c ..\version.c
126 !end
127 !specialobj borland version
128 !begin lcc
129 version.o: FORCE
130 FORCE:
131         lcc $(FWHACK) $(VER) $(CFLAGS) /c ..\version.c
132 !end
133 !specialobj lcc version
134 # For Unix, we also need the gross MD5 hack that causes automatic
135 # version number selection in release source archives.
136 !begin gtk
137 version.o: FORCE;
138 FORCE:
139         if test -z "$(VER)" && (cd ..; md5sum -c manifest); then \
140                 $(CC) $(COMPAT) $(FWHACK) $(XFLAGS) $(CFLAGS) `cat ../version.def` -c ../version.c; \
141         else \
142                 $(CC) $(COMPAT) $(FWHACK) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c; \
143         fi
144 !end
145 !specialobj gtk version
146
147 # `make install' target for Unix.
148 !begin gtk
149 install:
150         $(INSTALL_PROGRAM) -m 755 plink $(DESTDIR)$(bindir)/plink
151         $(INSTALL_PROGRAM) -m 755 pscp $(DESTDIR)$(bindir)/pscp
152         $(INSTALL_PROGRAM) -m 755 psftp $(DESTDIR)$(bindir)/psftp
153         $(INSTALL_PROGRAM) -m 755 pterm $(DESTDIR)$(bindir)/pterm
154         $(INSTALL_PROGRAM) -m 755 putty $(DESTDIR)$(bindir)/putty
155         $(INSTALL_PROGRAM) -m 755 puttygen $(DESTDIR)$(bindir)/puttygen
156         $(INSTALL_PROGRAM) -m 755 puttytel $(DESTDIR)$(bindir)/puttytel
157         $(INSTALL_DATA) -m 644 ../doc/plink.1 $(DESTDIR)$(man1dir)/plink.1
158         $(INSTALL_DATA) -m 644 ../doc/pscp.1 $(DESTDIR)$(man1dir)/pscp.1
159         $(INSTALL_DATA) -m 644 ../doc/psftp.1 $(DESTDIR)$(man1dir)/psftp.1
160         $(INSTALL_DATA) -m 644 ../doc/pterm.1 $(DESTDIR)$(man1dir)/pterm.1
161         $(INSTALL_DATA) -m 644 ../doc/putty.1 $(DESTDIR)$(man1dir)/putty.1
162         $(INSTALL_DATA) -m 644 ../doc/puttygen.1 $(DESTDIR)$(man1dir)/puttygen.1
163         $(INSTALL_DATA) -m 644 ../doc/puttytel.1 $(DESTDIR)$(man1dir)/puttytel.1
164
165 install-strip:
166         $(MAKE) install INSTALL_PROGRAM="$(INSTALL_PROGRAM) -s"
167 !end
168
169 # ------------------------------------------------------------
170 # Definitions of object groups. A group name, followed by an =,
171 # followed by any number of objects or other already-defined group
172 # names. A line beginning `+' is assumed to continue the previous
173 # line.
174
175 # Terminal emulator and its (platform-independent) dependencies.
176 TERMINAL = terminal wcwidth ldiscucs logging tree234 minibidi
177          + config dialog
178
179 # GUI front end and terminal emulator (putty, puttytel).
180 GUITERM  = TERMINAL window windlg winctrls sizetip winucs winprint
181          + winutils wincfg
182
183 # Same thing on Unix.
184 UXTERM   = TERMINAL pterm uxcfg gtkdlg gtkcols gtkpanel uxucs uxprint xkeysym
185
186 # Non-SSH back ends (putty, puttytel, plink).
187 NONSSH   = telnet raw rlogin ldisc
188
189 # SSH back end (putty, plink, pscp, psftp).
190 SSH      = ssh sshcrc sshdes sshmd5 sshrsa sshrand sshsha sshblowf
191          + sshdh sshcrcda sshpubk sshzlib sshdss x11fwd portfwd
192          + sshaes sshsh512 sshbn wildcard
193 WINSSH   = SSH winnoise winpgntc
194 UXSSH    = SSH uxnoise uxagentc
195 MACSSH   = SSH macnoise
196
197 # SFTP implementation (pscp, psftp).
198 SFTP     = sftp int64 logging
199
200 # Miscellaneous objects appearing in all the network utilities (not
201 # Pageant or PuTTYgen).
202 WINMISC  = misc version winstore settings tree234 winnet proxy cmdline
203          + windefs winmisc pproxy
204 UXMISC   = misc version uxstore settings tree234 uxsel uxnet proxy cmdline
205          + uxmisc uxproxy
206 MACMISC  = misc version macstore settings tree234 macnet mtcpnet otnet proxy
207          + macmisc macabout pproxy
208
209 # Character set library, for use in pterm.
210 CHARSET  = sbcsdat slookup sbcs utf8 toucs fromucs xenc mimeenc macenc localenc
211
212 # Standard libraries.
213 LIBS     = advapi32.lib user32.lib gdi32.lib comctl32.lib comdlg32.lib
214          + shell32.lib winmm.lib imm32.lib winspool.lib
215
216 # Network backend sets. This also brings in the relevant attachment
217 # to proxy.c depending on whether we're crypto-avoidant or not.
218 BE_ALL   = be_all cproxy
219 BE_NOSSH = be_nossh nocproxy
220 BE_SSH   = be_none cproxy
221 BE_NONE  = be_none nocproxy
222
223 # ------------------------------------------------------------
224 # Definitions of actual programs. The program name, followed by a
225 # colon, followed by a list of objects. Also in the list may be the
226 # keywords [G] for Windows GUI app, [C] for Console app, [X] for
227 # X/GTK Unix app, [U] for command-line Unix app, [M] for Macintosh app.
228
229 putty    : [G] GUITERM NONSSH WINSSH BE_ALL WINMISC win_res.res LIBS
230 puttytel : [G] GUITERM NONSSH BE_NOSSH WINMISC win_res.res LIBS
231 plink    : [C] winplink wincons NONSSH WINSSH BE_ALL logging WINMISC
232          + plink.res LIBS
233 pscp     : [C] scp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC
234          + scp.res LIBS
235 psftp    : [C] psftp winsftp wincons WINSSH BE_SSH SFTP WINMISC scp.res LIBS
236
237 pageant  : [G] winpgnt sshrsa sshpubk sshdes sshbn sshmd5 version tree234
238          + misc sshaes sshsha winpgntc sshdss sshsh512 winutils winmisc
239          + pageant.res LIBS
240
241 puttygen : [G] winpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
242          + sshrand winnoise sshsha winstore misc winctrls sshrsa sshdss winmisc
243          + sshpubk sshaes sshsh512 import winutils puttygen.res tree234 LIBS
244
245 pterm    : [X] UXTERM uxmisc misc ldisc settings pty uxsel BE_NONE uxstore
246          + signal CHARSET cmdline ptermm version
247 putty    : [X] UXTERM uxmisc misc ldisc settings pty uxsel BE_ALL uxstore
248          + signal CHARSET uxputty NONSSH UXSSH UXMISC ux_x11
249 puttytel : [X] UXTERM uxmisc misc ldisc settings pty uxsel BE_NOSSH
250          + uxstore signal CHARSET uxputty NONSSH UXMISC
251
252 plink    : [U] uxplink uxcons NONSSH UXSSH BE_ALL logging UXMISC signal ux_x11
253
254 puttygen : [U] cmdgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
255          + sshrand uxnoise sshsha misc sshrsa sshdss uxcons uxstore uxmisc
256          + sshpubk sshaes sshsh512 import puttygen.res tree234 uxgen
257
258 pscp     : [U] scp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC
259 psftp    : [U] psftp uxsftp uxcons UXSSH BE_SSH SFTP UXMISC
260
261 PuTTY    : [M] terminal wcwidth ldiscucs logging BE_ALL mac macdlg macevlog
262          + macterm macucs mac_res.rsrc testback NONSSH MACSSH MACMISC CHARSET
263          + stricmp vsnprint dialog config macctrls
264 PuTTYtel : [M] terminal wcwidth ldiscucs logging BE_NOSSH mac macdlg
265          + macevlog macterm macucs mac_res.rsrc testback NONSSH MACMISC
266          + CHARSET stricmp vsnprint dialog config macctrls
267 PuTTYgen : [M] macpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
268          + sshrand macnoise sshsha macstore misc sshrsa sshdss macmisc sshpubk
269          + sshaes sshsh512 import macpgen.rsrc macpgkey macabout