[Emacs-diffs] Changes to emacs/doc/misc/tramp.texi,v

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       08/06/21 11:50:33

Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -b -r1.18 -r1.19
--- tramp.texi  15 Jun 2008 02:30:25 -0000      1.18
+++ tramp.texi  21 Jun 2008 11:50:33 -0000      1.19
@@ -197,7 +197,7 @@
 * Multi-hops::                  Connecting to a remote host using multiple 
hops.
 * Customizing Methods::         Using Non-Standard Methods.
 * Customizing Completion::      Selecting config files for user/host name 
completion.
-* Password caching::            Reusing passwords for several connections.
+* Password handling::           Reusing passwords for several connections.
 * Connection caching::          Reusing connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
@@ -525,7 +525,7 @@
 * Multi-hops::                  Connecting to a remote host using multiple 
hops.
 * Customizing Methods::         Using Non-Standard Methods.
 * Customizing Completion::      Selecting config files for user/host name 
completion.
-* Password caching::            Reusing passwords for several connections.
+* Password handling::           Reusing passwords for several connections.
 * Connection caching::          Reusing connection related information.
 * Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
 * Remote shell setup::          Remote shell setup hints.
@@ -578,7 +578,7 @@
 don't require a password (with @command{ssh-agent}, or such alike).
 Modern @command{scp} implementations offer options to reuse existing
 @command{ssh} connections, see method @command{scpc}.  If it isn't
-possible, you should consider @ref{Password caching}, otherwise you
+possible, you should consider @ref{Password handling}, otherwise you
 will be prompted for a password every copy action.
 
 
@@ -1008,7 +1008,7 @@
 
 Since authorization is done on share level, you will be prompted
 always for a password if you access another share on the same host.
-This can be suppressed by @ref{Password caching}.
+This can be suppressed by @ref{Password handling}.
 
 MS Windows uses for authorization both a user name and a domain name.
 Because of this, the @value{tramp} syntax has been extended: you can
@@ -1521,7 +1521,7 @@
 @end defun
 
 
address@hidden Password caching
address@hidden Password handling
 @section Reusing passwords for several connections.
 @cindex passwords
 
@@ -1530,9 +1530,43 @@
 the chosen method does not support access without password prompt
 through own configuration.
 
-By default, @value{tramp} caches the passwords entered by you.  They will
-be reused next time if a connection needs them for the same user name
-and host name, independently of the connection method.
+The best recommendation is to use the method's own mechanism for
+password handling. Consider @command{ssh-agent} for @option{ssh}-like
+methods, or @command{pageant} for @option{plink}-like methods.
+
+However, if you cannot apply such native password handling,
address@hidden offers altenatives.
+
+
address@hidden
address@hidden Using an authentication file
+
address@hidden auth-sources
+The package @file{auth-source.el}, originally developed in No Gnus,
+offers the possibility to read passwords from a file, like FTP does it
+from @file{~/.netrc}.  The default authentication file is
address@hidden/.authinfo.gpg}, this can be changed via the variable
address@hidden
+
address@hidden
+A typical entry in the authentication file would be
+
address@hidden
+machine melancholia port scp login daniel password geheim
address@hidden example
+
+The port can be any @value{tramp} method (@pxref{Inline methods},
address@hidden transfer methods}), to match only this method.  When
+you omit the port, you match all @value{tramp} methods.
+
+
address@hidden
address@hidden Caching passwords
+
+If there is no authentication file, @value{tramp} caches the passwords
+entered by you.  They will be reused next time if a connection needs
+them for the same user name and host name, independently of the
+connection method.
 
 @vindex password-cache-expiry
 Passwords are not saved permanently, that means the password caching
@@ -1548,16 +1582,14 @@
 @code{password-cache} (setting it to @code{nil}).
 
 Implementation Note: password caching is based on the package
address@hidden in No Gnus.  For the time being, it is activated
-only when this package is seen in the @code{load-path} while loading
address@hidden  For the time being, it is activated only
+when this package is seen in the @code{load-path} while loading
 @value{tramp}.
 @ifset installchapter
 If you don't use No Gnus, you can take @file{password.el} from the
 @value{tramp} @file{contrib} directory, see @ref{Installation
 parameters}.
 @end ifset
-It will be activated mandatory once No Gnus has found its way into
address@hidden
 
 
 @node Connection caching
@@ -1601,16 +1633,8 @@
 
 When @value{tramp} detects a changed operating system version on a
 remote host (via the command @command{uname -sr}), it flushes all
-connection related information for this host, quits the execution, and
-displays a message like this:
-
address@hidden
-Quit: "Connection reset, because remote host changed from `Linux
-2.6.22-13-generic' to `Linux 2.6.22-14-generic'"
address@hidden example
-
address@hidden
-You can simply open the remote file again in such a case.
+connection related information for this host, and opens the
+connection, again.
 
 
 @node Remote Programs
@@ -2445,7 +2469,7 @@
 interactively, the command offers all active remote connections in the
 minibuffer as remote file name prefix like @address@hidden,
 user, host, }}.  The cleanup includes password cache (@pxref{Password
-caching}), file cache, connection cache (@pxref{Connection caching}),
+handling}), file cache, connection cache (@pxref{Connection caching}),
 connection buffers.
 @end deffn