X-Git-Url: https://git.hcoop.net/bpt/emacs.git/blobdiff_plain/09d9db2c4921cb2eb0974892164dd03d6bffdd80..adf4e762813e58cd7b68982d448269965bb45616:/doc/misc/tramp.texi diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index bdbba437af..41ba6689f1 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -37,7 +37,7 @@ @end macro @copying -Copyright @copyright{} 1999-2011 Free Software Foundation, Inc. +Copyright @copyright{} 1999-2012 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document @@ -528,8 +528,8 @@ differ. @cindex methods, inline @cindex methods, external Loading or saving a remote file requires that the content of the file -be transfered between the two machines. The content of the file can -be transfered using one of two methods: the @dfn{inline method} over +be transferred between the two machines. The content of the file can +be transferred using one of two methods: the @dfn{inline method} over the same connection used to log in to the remote machine, or the @dfn{external method} through another connection using a remote copy program such as @command{rcp}, @command{scp} or @command{rsync}. @@ -1539,7 +1539,8 @@ can return user names only. @item @code{tramp-parse-netrc} @findex tramp-parse-netrc -Finally, a function which parses @file{~/.netrc} like files. +Finally, a function which parses @file{~/.netrc} like files. This +includes also @file{~/.authinfo}-style files. @end table If you want to keep your own data in a file, with your own structure, @@ -1574,7 +1575,7 @@ 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, -@value{tramp} offers altenatives. +@value{tramp} offers alternatives. @anchor{Using an authentication file} @@ -1598,6 +1599,10 @@ The port can be any @value{tramp} method (@pxref{Inline methods}, @pxref{External methods}), to match only this method. When you omit the port, you match all @value{tramp} methods. +In case of problems, setting @code{auth-source-debug} to @code{t} +gives useful debug messages. + + @anchor{Caching passwords} @subsection Caching passwords @@ -2540,7 +2545,28 @@ Another trick might be that you put @code{ForwardX11 yes} or that host. -@subsection Running shell-command on a remote host +@subsection Running @code{shell} on a remote host +@cindex shell + +Calling @code{M-x shell} in a buffer related to a remote host runs the +local shell as defined in @option{shell-file-name}. This might be +also a valid path name for a shell to be applied on the remote host, +but it will fail at least when your local and remote hosts belong to +different system types, like @samp{windows-nt} and @samp{gnu/linux}. + +You must set the variable @option{explicit-shell-file-name} to the +shell path name on the remote host, in order to start that shell on +the remote host. + +@ifset emacs +Starting with Emacs 24 this won't be necessary, if you call +@code{shell} interactively. You will be asked for the remote shell +path, if you are on a remote buffer, and if +@option{explicit-shell-file-name} is equal to @code{nil}. +@end ifset + + +@subsection Running @code{shell-command} on a remote host @cindex shell-command @code{shell-command} allows to execute commands in a shell, either @@ -2556,13 +2582,13 @@ You will see the buffer @file{*Async Shell Command*}, containing the continuous output of the @command{tail} command. -@subsection Running eshell on a remote host +@subsection Running @code{eshell} on a remote host @cindex eshell @value{tramp} is integrated into @file{eshell.el}. That is, you can open an interactive shell on your remote host, and run commands there. -After you have started @code{eshell}, you could perform commands like -this: +After you have started @code{M-x eshell}, you could perform commands +like this: @example @b{~ $} cd @trampfn{sudo, , , /etc} @key{RET} @@ -2654,6 +2680,12 @@ handling}), file cache, connection cache (@pxref{Connection caching}), connection buffers. @end deffn +@deffn Command tramp-cleanup-this-connection +This command flushes all objects of the current buffer's remote +connection. The same objects are removed as in +@code{tramp-cleanup-connection}. +@end deffn + @deffn Command tramp-cleanup-all-connections This command flushes objects for all active remote connections. The same objects are removed as in @code{tramp-cleanup-connection}. @@ -2791,7 +2823,6 @@ When @value{tramp} does not connect to the remote host, there are three reasons heading the bug mailing list: @itemize @minus - @item Unknown characters in the prompt @@ -2861,7 +2892,6 @@ checksum. (when (file-remote-p default-directory) (set (make-local-variable 'file-precious-flag) t)))) @end lisp - @end itemize @@ -3150,7 +3180,7 @@ names: '("^/xy" . "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}")) @end lisp -This shortens the file openening command to @kbd{C-x C-f /xy +This shortens the file opening command to @kbd{C-x C-f /xy @key{RET}}. The disadvantage is, again, that you cannot edit the file name, because the expansion happens after entering the file name only. @@ -3356,14 +3386,43 @@ export EDITOR=/path/to/emacsclient.sh @item -How can I disable @value{tramp}? +There are packages which call @value{tramp} although I haven't entered +a remote file name ever. I dislike it, how could I disable it? -Shame on you, why did you read until now? +In general, @value{tramp} functions are used only when +you apply remote file name syntax. However, some packages enable +@value{tramp} on their own. @itemize @minus +@item +@file{ido.el} + +You could disable @value{tramp} file name completion: + +@lisp +(custom-set-variables + '(ido-enable-tramp-completion nil)) +@end lisp + +@item +@file{rlogin.el} + +You could disable remote directory tracking mode: + +@lisp +(rlogin-directory-tracking-mode -1) +@end lisp +@end itemize + @item +How can I disable @value{tramp} at all? + +Shame on you, why did you read until now? + +@itemize @minus @ifset emacs +@item If you just want to have @value{ftppackagename} as default remote files access package, you should apply the following code: @@ -3514,7 +3573,7 @@ The verbosity levels are When @code{tramp-verbose} is greater than or equal to 4, the messages are also written into a @value{tramp} debug buffer. This debug buffer -is useful for analysing problems; sending a @value{tramp} bug report +is useful for analyzing problems; sending a @value{tramp} bug report should be done with @code{tramp-verbose} set to a verbosity level of at least 6 (@pxref{Bug Reports}). @@ -3645,4 +3704,4 @@ for @value{emacsothername}. @c host and then send commands to it. @c * Use `filename' resp. `file name' consistently. @c * Use `host' resp. `machine' consistently. -@c * Consistent small or capitalized words especially in menues. +@c * Consistent small or capitalized words especially in menus.