mirror of
https://git.tartarus.org/simon/putty.git
synced 2025-04-13 09:08:06 -05:00
1cf4f50981
prepare_session() is the function that takes a Conf in the form it was loaded from the configuration, and normalises it into the form that backends can make sense of easily. In particular, if CONF_host contains something like "user@hostname", this is the place where the "user@" is stripped off the hostname field and moved into CONF_username where the backend will expect to find it. Therefore, you're _always_ supposed to call prepare_session() before launching a backend from a Conf you (potentially) got from a saved session. But the SSH proxy code forgot to. As a result, if you had a saved session with "user@hostname" in the hostname field, it would work fine to launch that session directly in PuTTY, but trying to use the same saved session as an SSH proxy would fail mysteriously after trying to pass "user@hostname" to getaddrinfo() and getting nothing useful back. (On Windows, the error message is especially opaque: an invalid string of that kind generates an error code that we weren't even tranlsating. And even if we _do_ translate it, it wouldn't be very meaningful, because the error in question is WSANO_RECOVERY, which FormatMessage renders as "A non-recoverable error occurred during a database lookup." I guess the error in question was that Windows couldn't even figure out how to translate that string into the format of a DNS request message!)
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 .
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.