1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-10 01:48:00 +00:00
putty-source/windows
Simon Tatham 5c5879b99d New Windows installer system, using WiX to build an MSI.
Mostly this is a reaction to the reports of Inno Setup having a DLL
hijacking vulnerability. But also, the new installer has several other
nice features that our Inno Setup one didn't provide: it can put the
PuTTY install directory on PATH automatically, and it supports
completely automatic and silent install/uninstall via 'msiexec /q'
which should make it easier for sysadmins to roll out installation in
large organisations. Also, it just seems like good sense to be using
Windows's own native packaging system (or closest equivalent) rather
than going it alone.

(And on the developer side, I have to say I like the fact that WiX
lets me pass in the version number as a set of command-line #define-
equivalents, whereas for Inno Setup I had to have Buildscr apply Perl
rewriting to the source file.)

For the moment, I'm still building the old Inno Setup installer
alongside this one, but I expect to retire it once the WiX one has
survived in the wild for a while and proven itself more or less
stable.

I've found both MSI and WiX to be confusing and difficult
technologies, so this installer has some noticeable pieces missing
(e.g. retrospective reconfiguration of the installed feature set, and
per-user vs systemwide installation) simply because I couldn't get
them to work. I've commented the new installer source code heavily, in
the hope that a passing WiX expert can give me a hand!
2016-03-09 20:55:38 +00:00
..
installer.wxs New Windows installer system, using WiX to build an MSI. 2016-03-09 20:55:38 +00:00
pageant.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
pageant.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
pageant.rc Use readonly edit controls in some Windows dialogs. 2016-02-29 19:59:35 +00:00
pageants.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
plink.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
pscp.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
pscp.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
psftp.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
putty.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
putty.iss Update version number for 0.67 release. 2016-02-29 19:59:59 +00:00
putty.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
putty.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
puttycfg.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
puttygen.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
puttygen.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
puttygen.rc Use readonly edit controls in some Windows dialogs. 2016-02-29 19:59:35 +00:00
puttyins.ico `installer.ico' doesn't fit into 8.3, so gets truncated to INSTALLE.ICO in 2007-02-06 22:39:15 +00:00
puttytel.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
rcstuff.h `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
README.txt Refresh the Windows installer README.txt. 2015-02-27 09:26:47 +00:00
sizetip.c Sprinkle some header comments in various files in an attempt to explain what 2006-04-23 18:26:03 +00:00
version.rc2 Stop copying the licence text into C source code. 2016-02-29 19:59:35 +00:00
website.url Now that we have Subversion's file renaming ability, it's time at 2004-11-16 22:14:56 +00:00
win_res.h Use readonly edit controls in some Windows dialogs. 2016-02-29 19:59:35 +00:00
win_res.rc2 Use readonly edit controls in some Windows dialogs. 2016-02-29 19:59:35 +00:00
wincapi.c Make our process's ACL more restrictive. 2016-02-29 19:59:34 +00:00
wincapi.h Make our process's ACL more restrictive. 2016-02-29 19:59:34 +00:00
wincfg.c Post-release destabilisation! Completely remove the struct type 2011-07-14 18:52:21 +00:00
wincons.c Key rollover: put the new Master Key fingerprint in the tools. 2015-10-17 17:30:17 +01:00
winctrls.c Remove an unused variable. 2015-08-15 13:54:41 +01:00
windefs.c Turn 'Filename' into a dynamically allocated type with no arbitrary 2011-10-02 11:01:57 +00:00
windlg.c Stop copying the licence text into C source code. 2016-02-29 19:59:35 +00:00
window.c Fix a mistaken use of a format string in logevent(). 2016-02-29 19:59:34 +00:00
wingss.c Giant const-correctness patch of doom! 2015-05-15 12:47:44 +01:00
winhandl.c Fix winhandl.c's failure to ever free a foreign handle. 2015-10-29 09:27:54 +00:00
winhelp.c Fix type of 4th argument to WinHelp 2015-08-15 13:54:46 +01:00
winhelp.h Support RFC 4419. 2015-06-20 09:31:55 +01:00
winhsock.c In GUI PuTTY, log standard error from local proxy commands. 2015-11-22 15:11:00 +00:00
winjump.c Work around a failure in Windows 10 jump lists. 2015-10-17 17:30:17 +01:00
winmisc.c Sanitise bad characters in log file names. 2015-10-17 17:33:31 +01:00
winnet.c Cast pointers to uintptr_t instead of unsigned {long,int}. 2015-08-15 13:54:46 +01:00
winnoise.c Been meaning to get round to this for a while: use CryptGenRandom to 2013-07-20 08:34:54 +00:00
winnojmp.c Fix up svn:eol-style and svn:keywords on new files. 2010-12-27 00:24:48 +00:00
winnpc.c Merge branch 'pre-0.67' 2016-02-29 19:59:59 +00:00
winnps.c In GUI PuTTY, log standard error from local proxy commands. 2015-11-22 15:11:00 +00:00
winpgen.c Stop copying the licence text into C source code. 2016-02-29 19:59:35 +00:00
winpgnt.c Merge branch 'pre-0.67' 2016-02-29 19:59:59 +00:00
winpgntc.c Make get_user_sid() return the cached copy if one already exists. 2016-02-29 19:59:37 +00:00
winplink.c Rationalise and document log options somewhat. 2016-02-29 19:59:32 +00:00
winprint.c Another big batch of memory leak fixes, again mostly on error paths. 2013-07-22 07:11:54 +00:00
winproxy.c Fix a paste error in new make_handle_socket prototype. 2015-11-22 22:50:30 +00:00
winsecur.c Make get_user_sid() return the cached copy if one already exists. 2016-02-29 19:59:37 +00:00
winsecur.h Put back in a missing dynamic-load wrapper on SetSecurityInfo. 2016-02-29 19:59:35 +00:00
winser.c New Plink operating mode: 'plink -shareexists'. 2015-09-25 12:11:27 +01:00
winsftp.c Centralise stripslashes() and make it OS-sensitive. 2015-09-24 17:47:10 +01:00
winshare.c Make our process's ACL more restrictive. 2016-02-29 19:59:34 +00:00
winstore.c Use DWORD as length argument for RegQueryValueEx. 2015-08-15 13:54:55 +01:00
winstuff.h Include stdint.h (where available) for uintptr_t. 2015-09-28 19:52:38 +01:00
wintime.c Sprinkle some header comments in various files in an attempt to explain what 2006-04-23 18:26:03 +00:00
winucs.c Giant const-correctness patch of doom! 2015-05-15 12:47:44 +01:00
winutils.c Key rollover: put the new Master Key fingerprint in the tools. 2015-10-17 17:30:17 +01:00
winx11.c Post-release destabilisation! Completely remove the struct type 2011-07-14 18:52:21 +00:00

PuTTY README
============

This is the README file for the PuTTY installer distribution. If
you're reading this, you've probably just run our installer and
installed PuTTY on your system.

What should I do next?
----------------------

If you want to use PuTTY to connect to other computers, or use PSFTP
to transfer files, you should just be able to run them from the
Start menu.

If you want to use the command-line-only file transfer utility PSCP,
you will probably want to put the PuTTY installation directory on
your PATH. On Windows 7 and similar versions, you can do this at
Control Panel > System and Security > System > Advanced system
settings > Environment Variables.

Some versions of Windows will refuse to run HTML Help files (.CHM)
if they are installed on a network drive. If you have installed
PuTTY on a network drive, you might want to check that the help file
works properly. If not, see http://support.microsoft.com/kb/896054
for information on how to solve this problem.

What do I do if it doesn't work?
--------------------------------

The PuTTY home web site is

    http://www.chiark.greenend.org.uk/~sgtatham/putty/

Here you will find our list of known bugs and pending feature
requests. If your problem is not listed in there, or in the FAQ, or
in the manuals, read the Feedback page to find out how to report
bugs to us. PLEASE read the Feedback page carefully: it is there to
save you time as well as us. Do not send us one-line bug reports
telling us `it doesn't work'.