mirror of
https://git.tartarus.org/simon/putty.git
synced 2025-04-15 10:08:06 -05:00
c8b66101ee
Use of thread-local storage on Windows (introduced recently in 69e8d471d1) could cause a -Wattributes warning in mingw-w64 builds, since that toolchain doesn't understand __declspec(thread). Define a portability macro THREADLOCAL, which should resolve to something appropriate for at least: - MSVC, which understands the Microsoft syntax __declspec(thread); - GCC (e.g., mingw-w64) which understands the GNU syntax __thread (GCC only implements __declspec() to the extent of understanding the arguments 'dllexport' and 'dllimport'); - Clang, which supports both syntaxes. (It's possible there's some more obscure Windows toolchain which will now hit the #error as a result of this change.) I haven't attempted to try to detect and use the C11 syntax 'thread_local'. And this is all still Windows-only, since that's all we need for now and it avoids opening the can of worms that is TLS on other platforms. (I considered delegating all this to cmake, but as well as being fiddly, it seems even the latest versions of cmake don't know about thread-local storage for C, as opposed to C++ (cxx_thread_local).)
This is the README for PuTTY, a free Windows and Unix Telnet and SSH
client.
PuTTY is built using CMake <https://cmake.org/>. To compile in the
simplest way (on any of Linux, Windows or Mac), run these commands in
the source directory:
cmake .
cmake --build .
Then, to install in the simplest way on Linux or Mac:
cmake --build . --target install
On Unix, pterm would like to be setuid or setgid, as appropriate, to
permit it to write records of user logins to /var/run/utmp and
/var/log/wtmp. (Of course it will not use this privilege for
anything else, and in particular it will drop all privileges before
starting up complex subsystems like GTK.) The cmake install step
doesn't attempt to add these privileges, so if you want user login
recording to work, you should manually ch{own,grp} and chmod the
pterm binary yourself after installation. If you don't do this,
pterm will still work, but not update the user login databases.
Documentation (in various formats including Windows Help and Unix
`man' pages) is built from the Halibut (`.but') files in the `doc'
subdirectory using `doc/Makefile'. If you aren't using one of our
source snapshots, you'll need to do this yourself. Halibut can be
found at <https://www.chiark.greenend.org.uk/~sgtatham/halibut/>.
The PuTTY home web site is
https://www.chiark.greenend.org.uk/~sgtatham/putty/
If you want to send bug reports or feature requests, please read the
Feedback section of the web site before doing so. Sending one-line
reports saying `it doesn't work' will waste your time as much as
ours.
See the file LICENCE for the licence conditions.