From b94bdac931bbe8f66b32595dea8daec63f286a21 Mon Sep 17 00:00:00 2001 From: Simon Tatham Date: Wed, 29 Dec 2021 16:35:57 +0000 Subject: [PATCH] Document Cygwin as a use case for psusan. I have _no_ idea how I managed to leave this out of the list of examples when I first wrote this man page. It should have been the very first one I thought of, since Cygwin was the platform I wrote cygtermd for, and one of psusan's primary purposes was to be a productised and improved replacement for cygtermd! Oh well, better late than never. --- doc/man-psusan.but | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/doc/man-psusan.but b/doc/man-psusan.but index a9c8baab..64d3a030 100644 --- a/doc/man-psusan.but +++ b/doc/man-psusan.but @@ -252,6 +252,39 @@ ports in and out of the WSL environment (e.g. expose a WSL2 network service through the hypervisor's internal NAT), forward Pageant into it, and so on. +\S2{psusan-manpage-examples-cygwin} Cygwin + +Another Unix-like environment on Windows is Cygwin. That comes with +its own GUI terminal application, \cw{mintty} (as it happens, a +derivative of PuTTY); but if you'd prefer to use PuTTY itself to talk +to your Cygwin terminal sessions, \cw{psusan} can help. + +To do this, you'll first need to build the Unix PuTTY tools inside +Cygwin (via the usual \cw{cmake} method). Then, copy the resulting +\cw{psusan.exe} into Cygwin's \cw{/bin} directory. (It has to be +in that directory for non-Cygwin programs to run it; otherwise it +won't be able to find the Cygwin DLL at startup.) + +Then set up your PuTTY saved session like this: + +\b set the local proxy command to run \cw{psusan.exe} via its real +Windows path. You might also want to add the \cw{--sessiondir} option +so that shell sessions start up in your Cygwin home directory. For +example, you might use the command \cq{c:\\cygwin64\\bin\\psusan.exe +--sessiondir /home/simon} (changing the pathname and username to match +your setup). + +\b enter anything you like in the host name box; \cq{Cygwin} is +probably a good choice + +\b set the protocol to \q{Bare ssh-connection}, as usual. + +Port forwarding is probably not particularly useful in this case, +since Cygwin shares the same network port space as the host machine. +But turning on agent forwarding is useful, because then the Cygwin +command-line SSH client can talk to Pageant without any further +configuration. + \S2{psusan-manpage-examples-schroot} \cw{schroot} Another example of a container-like environment is the alternative