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 49fb598b0e Add automatic type-checking to GET_WINDOWS_FUNCTION.
This gives me an extra safety-check against having mistyped one of the
function prototypes that we load at run time from DLLs: we verify that
the typedef we defined based on the prototype in our source code
matches the type of the real function as declared in the Windows
headers.

This was an idea I had while adding a pile of further functions using
this mechanism. It didn't catch any errors (either in the new
functions or in the existing collection), but that's no reason not to
keep it anyway now that I've thought of it!

In VS2015, this automated type-check works for most functions, but a
couple manage to break it. SetCurrentProcessExplicitAppUserModelID in
winjump.c can't be type-checked, because including <shobjidl.h> where
that function is declared would also bring in a load of other stuff
that conflicts with the painful manual COM declarations in winjump.c.
(That stuff could probably be removed now we're on an up-to-date
Visual Studio, on the other hand, but that's a separate chore.) And
gai_strerror, used in winnet.c, does _have_ an implementation in a
DLL, but the header files like to provide an inline version with a
different calling convention, which defeats this error-checking trick.
And in the older VS2003 that we still precautionarily build with,
several more type-checks have to be #ifdeffed out because the
functions they check against just aren't there at all.
2017-04-11 18:56:55 +01:00
..
installer.wxs Set our explicit AppUserModelID on our Start Menu shortcut. 2017-02-23 18:28:14 +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 Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +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 Set our explicit AppUserModelID on our Start Menu shortcut. 2017-02-23 18:28:14 +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 Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +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-msi.txt Provide a separate post-install README for MSI. 2016-04-02 08:26:26 +01: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 Include 'build info' in all --version text and About boxes. 2017-01-21 14:55:53 +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 Windows Plink: treat EOF at host key prompt as 'abort connection'. 2017-02-15 06:03:50 +00:00
winctrls.c Fix completely broken dialog-building functions. 2017-02-14 23:25:25 +00:00
windefs.c Turn 'Filename' into a dynamically allocated type with no arbitrary 2011-10-02 11:01:57 +00:00
windlg.c Include 'build info' in all --version text and About boxes. 2017-01-21 14:55:53 +00:00
window.c Remove a redundant ?: in the nethack_keypad code. 2017-02-15 05:47:16 +00:00
wingss.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
winhandl.c Fix an EOF-testing goof in winhandl.c. 2017-02-03 19:33:50 +00:00
winhelp.c Add an assortment of missing frees and closes. 2017-02-14 22:14:25 +00:00
winhelp.h Document proxy logging control. 2017-02-11 23:30:52 +00:00
winhsock.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
winjump.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
winmisc.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
winnet.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +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 Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +00:00
winpgnt.c Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +00:00
winpgntc.c Remove duplicate definition of AGENT_MAX_MSGLEN. 2017-01-30 19:42:28 +00:00
winplink.c Return zero when reporting our version. 2017-02-15 20:54:10 +00:00
winprint.c A bunch of further warning fixes in the Windows code. 2017-02-03 19:37:59 +00:00
winproxy.c Add an assortment of missing frees and closes. 2017-02-14 22:14:25 +00:00
winsecur.c clang-specific pragmas to suppress -Wmissing-braces. 2017-02-05 11:53:58 +00:00
winsecur.h Turn off Windows process ACL restriction by default. 2017-01-29 23:08:19 +00:00
winser.c Add an assortment of missing frees and closes. 2017-02-14 22:14:25 +00:00
winsftp.c Fixes for winelib building (used by our Coverity build). 2017-02-14 23:25:26 +00:00
winshare.c Rename Makefile.cyg to Makefile.mgw. 2016-04-10 15:10:45 +01:00
winstore.c A bunch of further warning fixes in the Windows code. 2017-02-03 19:37:59 +00:00
winstuff.h Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
wintime.c wintime: add a precautionary memset to zero. 2017-02-14 23:25:25 +00:00
winucs.c Reformat the composetbl[] array in winucs.c. 2017-04-08 15:10:57 +01:00
winutils.c Remove assorted dead code. 2017-02-14 22:18:01 +00: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'.