File: tramp-gvfs.el.html

Access functions for the GVFS daemon from Tramp. Tested with GVFS
1.0 (Ubuntu 8.10, Gnome 2.24). It has been reported also to run
with GVFS 0.2.5 (Ubuntu 8.04, Gnome 2.22), but there is an incompatibility with the mount_info structure, which has been worked around.

It has also been tested with GVFS 1.6 (Ubuntu 10.04, Gnome 2.30), where the default_location has been added to mount_info (see
<https://bugzilla.gnome.org/show_bug.cgi?id=561998>.

With GVFS 1.14 (Ubuntu 12.10, Gnome 3.6) the interfaces have been changed, again. So we must introspect the D-Bus interfaces.

All actions to mount a remote location, and to retrieve mount information, are performed by D-Bus messages. File operations themselves are performed via the mounted filesystem in ~/.gvfs. Consequently, GNU Emacs with enabled D-Bus bindings is a precondition.

The GVFS D-Bus interface is said to be unstable. There were even no introspection data before GVFS 1.14. The interface, as discovered during development time, is given in respective comments.

The user option tramp-gvfs-methods contains the list of supported connection methods. Per default, these are "afp", "dav", "davs",
"gdrive", "mtp", "nextcloud" and "sftp".

"gdrive" and "nextcloud" connection methods require a respective
account in GNOME Online Accounts, with enabled "Files" service.

The "mtp" connection method is responsible for media devices, like cell phones, tablets, cameras etc. The device must already be connected via USB, before accessing it.

Other possible connection methods are "ftp", "http", "https" and
"smb". When one of these methods is added to the list, the remote
access for that method is performed via GVFS instead of the native Tramp implementation. However, this is not recommended. These methods are listed here for the benefit of file archives, see tramp-archive.el.

GVFS offers even more connection methods. The complete list of connection methods of the actual GVFS implementation can be retrieved by:

(message
 "%s"
 (mapcar
  #'car
  (dbus-call-method
   :session tramp-gvfs-service-daemon tramp-gvfs-path-mounttracker
   tramp-gvfs-interface-mounttracker "ListMountableInfo")))

See also /usr/share/gvfs/mounts

Note that all other connection methods are not tested, beside the ones offered for customization in tramp-gvfs-methods. If you request an additional connection method to be supported, please drop me a note.

For hostname completion, information is retrieved from the zeroconf daemon (for the "afp", "dav", "davs", and "sftp" methods). The zeroconf daemon is pre-configured to discover services in the
"local" domain. If another domain should be used for discovering
services, the user option tramp-gvfs-zeroconf-domain can be set accordingly.

Restrictions:

* Two shares of the same SMB server cannot be mounted in parallel.

Defined variables (50)

Defined functions (81)

Defined faces (0)