[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/misc tramp.texi
From: |
Michael Albinus |
Subject: |
[Emacs-diffs] emacs/doc/misc tramp.texi |
Date: |
Mon, 22 Jun 2009 21:39:28 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Michael Albinus <albinus> 09/06/22 21:39:28
Modified files:
doc/misc : tramp.texi
Log message:
* tramp.texi (History): Add GVFS support.
(External methods): Precise `rsync' description. Add `dav', `davs' and
`obex' methods. Add 'tramp-gvfs-methods' option.
(Multi-hops): Cells of `tramp-default-proxies-alist' can also be Lisp
forms.
(Remote Programs): Introduce `tramp-own-remote-path'.
(Remote processes): New subsection "Running remote programs that create
local X11 windows".
(Frequently Asked Questions): Improve code for disabling vc.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/tramp.texi?cvsroot=emacs&r1=1.25&r2=1.26
Patches:
Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -b -r1.25 -r1.26
--- tramp.texi 16 Feb 2009 17:42:04 -0000 1.25
+++ tramp.texi 22 Jun 2009 21:39:28 -0000 1.26
@@ -464,6 +464,9 @@
@ifset emacsgw
Support of gateways exists since April 2007.
@end ifset
address@hidden emacsgvfs
+GVFS integration started in February 2009.
address@hidden ifset
In December 2001, @value{tramp} has been added to the XEmacs package
repository. Being part of the GNU Emacs repository happened in June
@@ -854,11 +857,11 @@
While @command{rsync} performs much better than @command{scp} when
transferring files that exist on both hosts, this advantage is lost if
-the file exists only on one side of the connection.
-
-The @command{rsync} based method may be considerably faster than the
address@hidden based methods when writing to the remote system. Reading
-files to the local machine is no faster than with a direct copy.
+the file exists only on one side of the connection. A file can exists
+on both the remote and local host, when you copy a file from/to a
+remote host. When you just open a file from the remote host (or write
+a file there), this is not the case, because on the local side
+temporary files are used.
This method supports the @samp{-p} hack.
@@ -1025,8 +1028,45 @@
disadvantage is that there's no possibility to specify another user
name.
address@hidden emacsgvfs
address@hidden @option{dav}
address@hidden method dav
address@hidden dav method
+
+This method provides access to WebDAV files and directories. It is
+available on systems only which run GVFS
address@hidden://en.wikipedia.org/wiki/GVFS}. Via GVFS, the remote
+filesystem is mounted locally through FUSE. @value{tramp} uses
+internally this local mounted directory.
+
+The communication with GVFS is implemented via D-Bus messages.
+Therefore, your @value{emacsname} must have D-Bus integration.
+
+There exists also the external method @option{davs}, which uses SSL
+encryption for the access.
+
+Both methods support the port number specification as discussed above.
+
address@hidden @option{obex}
address@hidden method obex
address@hidden obex method
+
+OBEX is an FTP-like access protocol for simple devices, like cell
+phones. Like @option{dav} and @option{davs}, it uses GVFS for
+mounting remote files and directories via FUSE. Until now
address@hidden supports only OBEX over Bluetooth.
address@hidden ifset
@end table
address@hidden emacsgvfs
address@hidden tramp-gvfs-methods
+This customer option, a list, defines the external methods, which
+shall be used with GVFS. Per default, these are @option{dav},
address@hidden and @option{obex}. Other possible values are
address@hidden, @option{sftp} and @option{smb}.
address@hidden defopt
address@hidden ifset
+
@ifset emacsgw
@node Gateway methods
@@ -1346,6 +1386,19 @@
has been reached so far. @code{sudo -u root}, applied on your local
host, wouldn't be useful here.
address@hidden, @var{user} and @var{proxy} can also be Lisp forms. These
+forms are evaluated, and must return a string, or @code{nil}. The
+previous example could be generalized then: For all hosts except my
+local one connect via @code{ssh} first, and apply @code{sudo -u root}
+afterwards:
+
address@hidden
+(add-to-list 'tramp-default-proxies-alist
+ '(nil "\\`root\\'" "@trampfn{ssh, , %h,}"))
+(add-to-list 'tramp-default-proxies-alist
+ '((regexp-quote (system-name)) nil nil))
address@hidden lisp
+
This is the recommended configuration to work as @samp{root} on remote
Ubuntu hosts.
@@ -1640,6 +1693,9 @@
remote file access.
@vindex tramp-remote-path
address@hidden tramp-default-remote-path
address@hidden tramp-own-remote-path
address@hidden tramp-remote-path
When @value{tramp} connects to the remote machine, it searches for the
programs that it can use. The variable @code{tramp-remote-path}
controls the directories searched on the remote machine.
@@ -1671,6 +1727,17 @@
(add-to-list 'tramp-remote-path "/usr/local/perl/bin")
@end lisp
+Another possibility is to reuse the path settings of your remote
+account, when you log in. Usually, these settings are overwritten,
+because they might not be useful for @value{tramp}. The place holder
address@hidden preserves these settings. You can
+activate it via
+
address@hidden
+(add-to-list 'tramp-remote-path 'tramp-own-remote-path)
address@hidden lisp
address@hidden defopt
+
@value{tramp} caches several information, like the Perl binary
location. The changed remote search path wouldn't affect these
settings. In order to force @value{tramp} to recompute these values,
@@ -2379,6 +2446,28 @@
integrate them as well. @xref{Bug Reports}.
address@hidden Running remote programs that create local X11 windows
+
+If you want to run a remote program, which shall connect the X11
+server you are using with your local host, you can set the
address@hidden environment variable on the remote host:
+
address@hidden
+(add-to-list 'tramp-remote-process-environment
+ (format "DISPLAY=%s" (getenv "DISPLAY")))
address@hidden lisp
+
address@hidden
address@hidden(getenv "DISPLAY")} shall return a string containing a host
+name, which can be interpreted on the remote host; otherwise you might
+use a fixed host name. Strings like @code{:0} cannot be used properly
+on the remote host.
+
+Another trick might be that you put @code{ForwardX11 yes} or
address@hidden yes} to your @file{~/.ssh/config} file for
+that host.
+
+
@subsection Running shell-command on a remote host
@cindex shell-command
@@ -2598,7 +2687,10 @@
disabling VC. This can be achieved by
@lisp
-(setq vc-handled-backends nil)
+(setq vc-ignore-dir-regexp
+ (format "\\(%s\\)\\|\\(%s\\)"
+ vc-ignore-dir-regexp
+ tramp-file-name-regexp))
@end lisp
Disable excessive traces. The default trace level of @value{tramp},
- [Emacs-diffs] emacs/doc/misc tramp.texi,
Michael Albinus <=