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