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