procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Adapt Tramp manual

Browse source 
* doc/misc/tramp.texi (Default Method): OpenSSH for MS Windows can
be used.
(Ssh setup): Extend for MS Windows and ssh.
This commit is contained in:
Michael Albinus 2023-03-24 13:30:25 +01:00
parent accb387166
commit 08fbc13375
1 changed files with 21 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

30
doc/misc/tramp.texi
View file

@ -1493,8 +1493,10 @@ access and it has the most reasonable security protocols, use
@end example @end example
If @option{ssh} is unavailable for whatever reason, look for other If @option{ssh} is unavailable for whatever reason, look for other
obvious options. For MS Windows, try the @option{plink} method. For obvious options. For MS Windows, try the @option{plink}
Kerberos, try @option{krlogin}. method@footnote{This shouldn't be needed with recent @code{OpenSSH}
versions for MS Windows. Use method @option{sshx}.}. For Kerberos,
try @option{krlogin}.
For editing local files as @option{su} or @option{sudo} methods, try For editing local files as @option{su} or @option{sudo} methods, try
the shortened syntax of @samp{root}: the shortened syntax of @samp{root}:
@ -2837,11 +2839,19 @@ When @value{tramp} uses direct remote copying, password caches are not
consulted. consulted.
@subsection Issues with Cygwin ssh @subsection Issues with Cygwin and MS Windows ssh
@cindex cygwin, issues @cindex cygwin, issues
@cindex ms Windows, issues
This section is incomplete. Please share your solutions. This section is incomplete. Please share your solutions.
@cindex ms windows and @command{ssh}
@cindex ms windows and @command{ssh-agent}
MS Windows' @command{ssh} does not open a remote TTY@. Use the method
@option{sshx} or @option{scpx} instead. Furthermore, it cannot read a
passphrase for ssh private keys. Use the MS @code{ssh-agent}.
@cindex method @option{sshx} with cygwin @cindex method @option{sshx} with cygwin
@cindex @option{sshx} method with cygwin @cindex @option{sshx} method with cygwin
@ -2881,13 +2891,15 @@ Windows file names to Cygwin file names.
@cindex @env{SSH_AUTH_SOCK} and emacs on ms windows @cindex @env{SSH_AUTH_SOCK} and emacs on ms windows
@vindex SSH_AUTH_SOCK@r{, environment variable} @vindex SSH_AUTH_SOCK@r{, environment variable}
When using the @command{ssh-agent} on MS Windows for password-less When using the cygwin @command{ssh-agent} on MS Windows for
interaction, @option{ssh} methods depend on the environment variable password-less interaction, @option{ssh} methods depend on the
@env{SSH_AUTH_SOCK}. But this variable is not set when Emacs is environment variable @env{SSH_AUTH_SOCK}. But this variable is not
started from a Desktop shortcut and authentication fails. set when Emacs is started from a Desktop shortcut and authentication
fails.
One workaround is to use an MS Windows based SSH Agent, such as One workaround is to use an MS Windows based SSH Agent, such as the
@command{Pageant}. It is part of the PuTTY Suite of tools. native MS @command{ssh-agent} or @command{Pageant}. The latter is
part of the PuTTY Suite of tools.
The fallback is to start Emacs from a shell. The fallback is to start Emacs from a shell.