diff options
Diffstat (limited to 'doc/misc/tramp.texi')
-rw-r--r-- | doc/misc/tramp.texi | 75 |
1 files changed, 62 insertions, 13 deletions
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 6f14fc875f4..65892f8621e 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -1504,8 +1504,10 @@ access and it has the most reasonable security protocols, use @end example If @option{ssh} is unavailable for whatever reason, look for other -obvious options. For MS Windows, try the @option{plink} method. For -Kerberos, try @option{krlogin}. +obvious options. For MS Windows, try the @option{plink} +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 the shortened syntax of @samp{root}: @@ -2381,10 +2383,11 @@ This uses also the settings in @code{tramp-sh-extra-args}. @vindex RemoteCommand@r{, ssh option} @strong{Note}: If you use an @option{ssh}-based method for connection, do @emph{not} set the @option{RemoteCommand} option in your -@command{ssh} configuration, for example to @command{screen}. On the -other hand, some @option{ssh}-based methods, like @option{sshx} or -@option{scpx}, silently overwrite a @option{RemoteCommand} option of -the configuration file. +@command{ssh} configuration to something like @command{screen}. If +used, @option{RemoteCommand} must open an interactive shell on the +remote host. On the other hand, some @option{ssh}-based methods, like +@option{sshx} or @option{scpx}, silently overwrite a +@option{RemoteCommand} option of the configuration file. @subsection Other remote shell setup hints @@ -2866,11 +2869,19 @@ When @value{tramp} uses direct remote copying, password caches are not consulted. -@subsection Issues with Cygwin ssh +@subsection Issues with Cygwin and MS Windows ssh @cindex cygwin, issues +@cindex ms Windows, issues 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 @option{sshx} method with cygwin @@ -2910,13 +2921,15 @@ Windows file names to Cygwin file names. @cindex @env{SSH_AUTH_SOCK} and emacs on ms windows @vindex SSH_AUTH_SOCK@r{, environment variable} -When using the @command{ssh-agent} on MS Windows for password-less -interaction, @option{ssh} methods depend on the environment variable -@env{SSH_AUTH_SOCK}. But this variable is not set when Emacs is -started from a Desktop shortcut and authentication fails. +When using the cygwin @command{ssh-agent} on MS Windows for +password-less interaction, @option{ssh} methods depend on the +environment variable @env{SSH_AUTH_SOCK}. But this variable is not +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 -@command{Pageant}. It is part of the PuTTY Suite of tools. +One workaround is to use an MS Windows based SSH Agent, such as the +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. @@ -3190,6 +3203,11 @@ auto-saved files to the same directory as the original file. Alternatively, set the user option @code{tramp-auto-save-directory} to direct all auto saves to that location. +@c Since Emacs 30. +@vindex remote-file-name-inhibit-auto-save +If you want to suppress auto-saving of remote files at all, set user +option @code{remote-file-name-inhibit-auto-save} to non-@code{nil}. + @c Since Emacs 29. @vindex remote-file-name-inhibit-auto-save-visited An alternative to @code{auto-save-mode} is @@ -4907,6 +4925,36 @@ Disable file locks. Set @code{remote-file-name-inhibit-locks} to the same remote file. @item +@vindex remote-file-name-inhibit-auto-save +Keep auto-save files local. This is already the default configuration +in Emacs, don't change it. If you want to disable auto-saving for +remote files at all, set @code{remote-file-name-inhibit-auto-save} to +@code{t}, but think about the consequences! + +If you want to disable auto-saving just for selected connections, for +example due to security considerations, use connection-local variables +in order to set @code{buffer-auto-save-file-name}. If you, for +example, want to disable auto-saving for all @option{sudo} +connections, apply the following code. +@ifinfo +@xref{Connection Variables, , , emacs}. +@end ifinfo + +@lisp +@group +(connection-local-set-profile-variables + 'my-auto-save-profile + '((buffer-auto-save-file-name . nil))) +@end group + +@group +(connection-local-set-profiles + '(:application tramp :protocol "sudo") + 'my-auto-save-profile) +@end group +@end lisp + +@item Disable excessive traces. Set @code{tramp-verbose} to 3 or lower, default being 3. Increase trace levels temporarily when hunting for bugs. @@ -5220,6 +5268,7 @@ HISTFILE=/dev/null @item Where are remote files trashed to? +@vindex remote-file-name-inhibit-delete-by-moving-to-trash Emacs can trash file instead of deleting @ifinfo them, @ref{Misc File Ops, Trashing , , emacs}. |