* dired.el (dired-mode-map): Rebind "\C-t\C-t" from
[emacs.git] / lisp / net / tramp-gvfs.el
blob2cad20e4cfbebbc632d0f9a4478c686b43b69f66
1 ;;; tramp-gvfs.el --- Tramp access functions for GVFS daemon
3 ;; Copyright (C) 2009, 2010 Free Software Foundation, Inc.
5 ;; Author: Michael Albinus <michael.albinus@gmx.de>
6 ;; Keywords: comm, processes
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software: you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation, either version 3 of the License, or
13 ;; (at your option) any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
23 ;;; Commentary:
25 ;; Access functions for the GVFS daemon from Tramp. Tested with GVFS
26 ;; 1.0.2 (Ubuntu 8.10, Gnome 2.24). It has been reported also to run
27 ;; with GVFS 0.2.5 (Ubuntu 8.04, Gnome 2.22), but there is an
28 ;; incompatibility with the mount_info structure, which has been
29 ;; worked around.
31 ;; All actions to mount a remote location, and to retrieve mount
32 ;; information, are performed by D-Bus messages. File operations
33 ;; themselves are performed via the mounted filesystem in ~/.gvfs.
34 ;; Consequently, GNU Emacs 23.1 with enabled D-Bus bindings is a
35 ;; precondition.
37 ;; The GVFS D-Bus interface is said to be instable. There are even no
38 ;; introspection data. The interface, as discovered during
39 ;; development time, is given in respective comments.
41 ;; The customer option `tramp-gvfs-methods' contains the list of
42 ;; supported connection methods. Per default, these are "dav",
43 ;; "davs", "obex" and "synce". Note that with "obex" it might be
44 ;; necessary to pair with the other bluetooth device, if it hasn't
45 ;; been done already. There might be also some few seconds delay in
46 ;; discovering available bluetooth devices.
48 ;; Other possible connection methods are "ftp", "sftp" and "smb".
49 ;; When one of these methods is added to the list, the remote access
50 ;; for that method is performed via GVFS instead of the native Tramp
51 ;; implementation.
53 ;; GVFS offers even more connection methods. The complete list of
54 ;; connection methods of the actual GVFS implementation can be
55 ;; retrieved by:
57 ;; (message
58 ;; "%s"
59 ;; (mapcar
60 ;; 'car
61 ;; (dbus-call-method
62 ;; :session tramp-gvfs-service-daemon tramp-gvfs-path-mounttracker
63 ;; tramp-gvfs-interface-mounttracker "listMountableInfo")))
65 ;; Note that all other connection methods are not tested, beside the
66 ;; ones offered for customization in `tramp-gvfs-methods'. If you
67 ;; request an additional connection method to be supported, please
68 ;; drop me a note.
70 ;; For hostname completion, information is retrieved either from the
71 ;; bluez daemon (for the "obex" method), the hal daemon (for the
72 ;; "synce" method), or from the zeroconf daemon (for the "dav",
73 ;; "davs", and "sftp" methods). The zeroconf daemon is pre-configured
74 ;; to discover services in the "local" domain. If another domain
75 ;; shall be used for discovering services, the customer option
76 ;; `tramp-gvfs-zeroconf-domain' can be set accordingly.
78 ;; Restrictions:
80 ;; * The current GVFS implementation does not allow to write on the
81 ;; remote bluetooth device via OBEX.
83 ;; * Two shares of the same SMB server cannot be mounted in parallel.
85 ;;; Code:
87 ;; D-Bus support in the Emacs core can be disabled with configuration
88 ;; option "--without-dbus". Declare used subroutines and variables.
89 (declare-function dbus-call-method "dbusbind.c")
90 (declare-function dbus-call-method-asynchronously "dbusbind.c")
91 (declare-function dbus-get-unique-name "dbusbind.c")
92 (declare-function dbus-register-method "dbusbind.c")
93 (declare-function dbus-register-signal "dbusbind.c")
95 ;; Pacify byte-compiler
96 (eval-when-compile
97 (require 'cl)
98 (require 'custom))
100 (require 'tramp)
101 (require 'dbus)
102 (require 'url-parse)
103 (require 'zeroconf)
105 (defcustom tramp-gvfs-methods '("dav" "davs" "obex" "synce")
106 "*List of methods for remote files, accessed with GVFS."
107 :group 'tramp
108 :version "23.2"
109 :type '(repeat (choice (const "dav")
110 (const "davs")
111 (const "ftp")
112 (const "obex")
113 (const "sftp")
114 (const "smb")
115 (const "synce"))))
117 ;; Add a default for `tramp-default-user-alist'. Rule: For the SYNCE
118 ;; method, no user is chosen.
119 (add-to-list 'tramp-default-user-alist
120 '("synce" nil nil))
122 (defcustom tramp-gvfs-zeroconf-domain "local"
123 "*Zeroconf domain to be used for discovering services, like host names."
124 :group 'tramp
125 :version "23.2"
126 :type 'string)
128 ;; Add the methods to `tramp-methods', in order to allow minibuffer
129 ;; completion.
130 (eval-after-load "tramp-gvfs"
131 '(when (featurep 'tramp-gvfs)
132 (dolist (elt tramp-gvfs-methods)
133 (unless (assoc elt tramp-methods)
134 (add-to-list 'tramp-methods (cons elt nil))))))
136 (defconst tramp-gvfs-mount-point
137 (file-name-as-directory (expand-file-name ".gvfs" "~/"))
138 "The directory name, fuses mounts remote ressources.")
140 (defconst tramp-gvfs-path-tramp (concat dbus-path-emacs "/Tramp")
141 "The preceeding object path for own objects.")
143 (defconst tramp-gvfs-service-daemon "org.gtk.vfs.Daemon"
144 "The well known name of the GVFS daemon.")
146 ;; Check that GVFS is available.
147 (unless (dbus-ping :session tramp-gvfs-service-daemon 100)
148 (throw 'tramp-loading nil))
150 (defconst tramp-gvfs-path-mounttracker "/org/gtk/vfs/mounttracker"
151 "The object path of the GVFS daemon.")
153 (defconst tramp-gvfs-interface-mounttracker "org.gtk.vfs.MountTracker"
154 "The mount tracking interface in the GVFS daemon.")
156 ;; <interface name='org.gtk.vfs.MountTracker'>
157 ;; <method name='listMounts'>
158 ;; <arg name='mount_info_list'
159 ;; type='a{sosssssbay{aya{say}}}'
160 ;; direction='out'/>
161 ;; </method>
162 ;; <method name='mountLocation'>
163 ;; <arg name='mount_spec' type='{aya{say}}' direction='in'/>
164 ;; <arg name='dbus_id' type='s' direction='in'/>
165 ;; <arg name='object_path' type='o' direction='in'/>
166 ;; </method>
167 ;; <signal name='mounted'>
168 ;; <arg name='mount_info'
169 ;; type='{sosssssbay{aya{say}}}'/>
170 ;; </signal>
171 ;; <signal name='unmounted'>
172 ;; <arg name='mount_info'
173 ;; type='{sosssssbay{aya{say}}}'/>
174 ;; </signal>
175 ;; </interface>
177 ;; STRUCT mount_info
178 ;; STRING dbus_id
179 ;; OBJECT_PATH object_path
180 ;; STRING display_name
181 ;; STRING stable_name
182 ;; STRING x_content_types Since GVFS 1.0 only !!!
183 ;; STRING icon
184 ;; STRING prefered_filename_encoding
185 ;; BOOLEAN user_visible
186 ;; ARRAY BYTE fuse_mountpoint
187 ;; STRUCT mount_spec
188 ;; ARRAY BYTE mount_prefix
189 ;; ARRAY
190 ;; STRUCT mount_spec_item
191 ;; STRING key (server, share, type, user, host, port)
192 ;; ARRAY BYTE value
194 (defconst tramp-gvfs-interface-mountoperation "org.gtk.vfs.MountOperation"
195 "Used by the dbus-proxying implementation of GMountOperation.")
197 ;; <interface name='org.gtk.vfs.MountOperation'>
198 ;; <method name='askPassword'>
199 ;; <arg name='message' type='s' direction='in'/>
200 ;; <arg name='default_user' type='s' direction='in'/>
201 ;; <arg name='default_domain' type='s' direction='in'/>
202 ;; <arg name='flags' type='u' direction='in'/>
203 ;; <arg name='handled' type='b' direction='out'/>
204 ;; <arg name='aborted' type='b' direction='out'/>
205 ;; <arg name='password' type='s' direction='out'/>
206 ;; <arg name='username' type='s' direction='out'/>
207 ;; <arg name='domain' type='s' direction='out'/>
208 ;; <arg name='anonymous' type='b' direction='out'/>
209 ;; <arg name='password_save' type='u' direction='out'/>
210 ;; </method>
211 ;; <method name='askQuestion'>
212 ;; <arg name='message' type='s' direction='in'/>
213 ;; <arg name='choices' type='as' direction='in'/>
214 ;; <arg name='handled' type='b' direction='out'/>
215 ;; <arg name='aborted' type='b' direction='out'/>
216 ;; <arg name='choice' type='u' direction='out'/>
217 ;; </method>
218 ;; </interface>
220 ;; The following flags are used in "askPassword". They are defined in
221 ;; /usr/include/glib-2.0/gio/gioenums.h.
223 (defconst tramp-gvfs-password-need-password 1
224 "Operation requires a password.")
226 (defconst tramp-gvfs-password-need-username 2
227 "Operation requires a username.")
229 (defconst tramp-gvfs-password-need-domain 4
230 "Operation requires a domain.")
232 (defconst tramp-gvfs-password-saving-supported 8
233 "Operation supports saving settings.")
235 (defconst tramp-gvfs-password-anonymous-supported 16
236 "Operation supports anonymous users.")
238 (defconst tramp-bluez-service "org.bluez"
239 "The well known name of the BLUEZ service.")
241 (defconst tramp-bluez-interface-manager "org.bluez.Manager"
242 "The manager interface of the BLUEZ daemon.")
244 ;; <interface name='org.bluez.Manager'>
245 ;; <method name='DefaultAdapter'>
246 ;; <arg type='o' direction='out'/>
247 ;; </method>
248 ;; <method name='FindAdapter'>
249 ;; <arg type='s' direction='in'/>
250 ;; <arg type='o' direction='out'/>
251 ;; </method>
252 ;; <method name='ListAdapters'>
253 ;; <arg type='ao' direction='out'/>
254 ;; </method>
255 ;; <signal name='AdapterAdded'>
256 ;; <arg type='o'/>
257 ;; </signal>
258 ;; <signal name='AdapterRemoved'>
259 ;; <arg type='o'/>
260 ;; </signal>
261 ;; <signal name='DefaultAdapterChanged'>
262 ;; <arg type='o'/>
263 ;; </signal>
264 ;; </interface>
266 (defconst tramp-bluez-interface-adapter "org.bluez.Adapter"
267 "The adapter interface of the BLUEZ daemon.")
269 ;; <interface name='org.bluez.Adapter'>
270 ;; <method name='GetProperties'>
271 ;; <arg type='a{sv}' direction='out'/>
272 ;; </method>
273 ;; <method name='SetProperty'>
274 ;; <arg type='s' direction='in'/>
275 ;; <arg type='v' direction='in'/>
276 ;; </method>
277 ;; <method name='RequestMode'>
278 ;; <arg type='s' direction='in'/>
279 ;; </method>
280 ;; <method name='ReleaseMode'/>
281 ;; <method name='RequestSession'/>
282 ;; <method name='ReleaseSession'/>
283 ;; <method name='StartDiscovery'/>
284 ;; <method name='StopDiscovery'/>
285 ;; <method name='ListDevices'>
286 ;; <arg type='ao' direction='out'/>
287 ;; </method>
288 ;; <method name='CreateDevice'>
289 ;; <arg type='s' direction='in'/>
290 ;; <arg type='o' direction='out'/>
291 ;; </method>
292 ;; <method name='CreatePairedDevice'>
293 ;; <arg type='s' direction='in'/>
294 ;; <arg type='o' direction='in'/>
295 ;; <arg type='s' direction='in'/>
296 ;; <arg type='o' direction='out'/>
297 ;; </method>
298 ;; <method name='CancelDeviceCreation'>
299 ;; <arg type='s' direction='in'/>
300 ;; </method>
301 ;; <method name='RemoveDevice'>
302 ;; <arg type='o' direction='in'/>
303 ;; </method>
304 ;; <method name='FindDevice'>
305 ;; <arg type='s' direction='in'/>
306 ;; <arg type='o' direction='out'/>
307 ;; </method>
308 ;; <method name='RegisterAgent'>
309 ;; <arg type='o' direction='in'/>
310 ;; <arg type='s' direction='in'/>
311 ;; </method>
312 ;; <method name='UnregisterAgent'>
313 ;; <arg type='o' direction='in'/>
314 ;; </method>
315 ;; <signal name='DeviceCreated'>
316 ;; <arg type='o'/>
317 ;; </signal>
318 ;; <signal name='DeviceRemoved'>
319 ;; <arg type='o'/>
320 ;; </signal>
321 ;; <signal name='DeviceFound'>
322 ;; <arg type='s'/>
323 ;; <arg type='a{sv}'/>
324 ;; </signal>
325 ;; <signal name='PropertyChanged'>
326 ;; <arg type='s'/>
327 ;; <arg type='v'/>
328 ;; </signal>
329 ;; <signal name='DeviceDisappeared'>
330 ;; <arg type='s'/>
331 ;; </signal>
332 ;; </interface>
334 (defcustom tramp-bluez-discover-devices-timeout 60
335 "Defines seconds since last bluetooth device discovery before rescanning.
336 A value of 0 would require an immediate discovery during hostname
337 completion, nil means to use always cached values for discovered
338 devices."
339 :group 'tramp
340 :version "23.2"
341 :type '(choice (const nil) integer))
343 (defvar tramp-bluez-discovery nil
344 "Indicator for a running bluetooth device discovery.
345 It keeps the timestamp of last discovery.")
347 (defvar tramp-bluez-devices nil
348 "Alist of detected bluetooth devices.
349 Every entry is a list (NAME ADDRESS).")
351 (defconst tramp-hal-service "org.freedesktop.Hal"
352 "The well known name of the HAL service.")
354 (defconst tramp-hal-path-manager "/org/freedesktop/Hal/Manager"
355 "The object path of the HAL daemon manager.")
357 (defconst tramp-hal-interface-manager "org.freedesktop.Hal.Manager"
358 "The manager interface of the HAL daemon.")
360 (defconst tramp-hal-interface-device "org.freedesktop.Hal.Device"
361 "The device interface of the HAL daemon.")
364 ;; New handlers should be added here.
365 (defconst tramp-gvfs-file-name-handler-alist
367 (access-file . ignore)
368 (add-name-to-file . tramp-gvfs-handle-copy-file)
369 ;; `byte-compiler-base-file-name' performed by default handler.
370 (copy-file . tramp-gvfs-handle-copy-file)
371 (delete-directory . tramp-gvfs-handle-delete-directory)
372 (delete-file . tramp-gvfs-handle-delete-file)
373 ;; `diff-latest-backup-file' performed by default handler.
374 (directory-file-name . tramp-handle-directory-file-name)
375 (directory-files . tramp-gvfs-handle-directory-files)
376 (directory-files-and-attributes
377 . tramp-gvfs-handle-directory-files-and-attributes)
378 (dired-call-process . ignore)
379 (dired-compress-file . ignore)
380 (dired-uncache . tramp-handle-dired-uncache)
381 ;; `executable-find' is not official yet. performed by default handler.
382 (expand-file-name . tramp-gvfs-handle-expand-file-name)
383 ;; `file-accessible-directory-p' performed by default handler.
384 (file-attributes . tramp-gvfs-handle-file-attributes)
385 (file-directory-p . tramp-smb-handle-file-directory-p)
386 (file-executable-p . tramp-gvfs-handle-file-executable-p)
387 (file-exists-p . tramp-gvfs-handle-file-exists-p)
388 (file-local-copy . tramp-gvfs-handle-file-local-copy)
389 ;; `file-modes' performed by default handler.
390 (file-name-all-completions . tramp-gvfs-handle-file-name-all-completions)
391 (file-name-as-directory . tramp-handle-file-name-as-directory)
392 (file-name-completion . tramp-handle-file-name-completion)
393 (file-name-directory . tramp-handle-file-name-directory)
394 (file-name-nondirectory . tramp-handle-file-name-nondirectory)
395 ;; `file-name-sans-versions' performed by default handler.
396 (file-newer-than-file-p . tramp-handle-file-newer-than-file-p)
397 (file-ownership-preserved-p . ignore)
398 (file-readable-p . tramp-gvfs-handle-file-readable-p)
399 (file-regular-p . tramp-handle-file-regular-p)
400 (file-remote-p . tramp-handle-file-remote-p)
401 (file-selinux-context . tramp-gvfs-handle-file-selinux-context)
402 (file-symlink-p . tramp-handle-file-symlink-p)
403 ;; `file-truename' performed by default handler.
404 (file-writable-p . tramp-gvfs-handle-file-writable-p)
405 (find-backup-file-name . tramp-handle-find-backup-file-name)
406 ;; `find-file-noselect' performed by default handler.
407 ;; `get-file-buffer' performed by default handler.
408 (insert-directory . tramp-gvfs-handle-insert-directory)
409 (insert-file-contents . tramp-gvfs-handle-insert-file-contents)
410 (load . tramp-handle-load)
411 (make-directory . tramp-gvfs-handle-make-directory)
412 (make-directory-internal . ignore)
413 (make-symbolic-link . ignore)
414 (process-file . tramp-gvfs-handle-process-file)
415 (rename-file . tramp-gvfs-handle-rename-file)
416 (set-file-modes . tramp-gvfs-handle-set-file-modes)
417 (set-file-selinux-context . tramp-gvfs-handle-set-file-selinux-context)
418 (set-visited-file-modtime . tramp-gvfs-handle-set-visited-file-modtime)
419 (shell-command . tramp-gvfs-handle-shell-command)
420 (start-file-process . tramp-gvfs-handle-start-file-process)
421 (substitute-in-file-name . tramp-handle-substitute-in-file-name)
422 (unhandled-file-name-directory . tramp-handle-unhandled-file-name-directory)
423 (vc-registered . ignore)
424 (verify-visited-file-modtime
425 . tramp-gvfs-handle-verify-visited-file-modtime)
426 (write-region . tramp-gvfs-handle-write-region)
428 "Alist of handler functions for Tramp GVFS method.
429 Operations not mentioned here will be handled by the default Emacs primitives.")
431 (defun tramp-gvfs-file-name-p (filename)
432 "Check if it's a filename handled by the GVFS daemon."
433 (and (tramp-tramp-file-p filename)
434 (let ((method
435 (tramp-file-name-method (tramp-dissect-file-name filename))))
436 (and (stringp method) (member method tramp-gvfs-methods)))))
438 (defun tramp-gvfs-file-name-handler (operation &rest args)
439 "Invoke the GVFS related OPERATION.
440 First arg specifies the OPERATION, second arg is a list of arguments to
441 pass to the OPERATION."
442 (let ((fn (assoc operation tramp-gvfs-file-name-handler-alist)))
443 (if fn
444 (save-match-data (apply (cdr fn) args))
445 (tramp-run-real-handler operation args))))
447 ;; This might be moved to tramp.el. It shall be the first file name
448 ;; handler.
449 (add-to-list 'tramp-foreign-file-name-handler-alist
450 (cons 'tramp-gvfs-file-name-p 'tramp-gvfs-file-name-handler))
452 (defmacro with-tramp-dbus-call-method
453 (vec synchronous bus service path interface method &rest args)
454 "Apply a D-Bus call on bus BUS.
456 If SYNCHRONOUS is non-nil, the call is synchronously. Otherwise,
457 it is an asynchronous call, with `ignore' as callback function.
459 The other arguments have the same meaning as with `dbus-call-method'
460 or `dbus-call-method-asynchronously'. Additionally, the call
461 will be traced by Tramp with trace level 6."
462 `(let ((func (if ,synchronous
463 'dbus-call-method 'dbus-call-method-asynchronously))
464 (args (append (list ,bus ,service ,path ,interface ,method)
465 (if ,synchronous (list ,@args) (list 'ignore ,@args))))
466 result)
467 (tramp-message ,vec 6 "%s %s" func args)
468 (setq result (apply func args))
469 (tramp-message ,vec 6 "\n%s" result)
470 result))
472 (put 'with-tramp-dbus-call-method 'lisp-indent-function 2)
473 (put 'with-tramp-dbus-call-method 'edebug-form-spec '(form symbolp body))
474 (font-lock-add-keywords 'emacs-lisp-mode '("\\<with-tramp-dbus-call-method\\>"))
476 (defmacro with-tramp-gvfs-error-message (filename handler &rest args)
477 "Apply a Tramp GVFS `handler'.
478 In case of an error, modify the error message by replacing
479 `filename' with its GVFS mounted name."
480 `(let ((fuse-file-name (regexp-quote (tramp-gvfs-fuse-file-name ,filename)))
481 elt)
482 (condition-case err
483 (apply ,handler (list ,@args))
484 (error
485 (setq elt (cdr err))
486 (while elt
487 (when (and (stringp (car elt))
488 (string-match fuse-file-name (car elt)))
489 (setcar elt (replace-match ,filename t t (car elt))))
490 (setq elt (cdr elt)))
491 (signal (car err) (cdr err))))))
493 (put 'with-tramp-gvfs-error-message 'lisp-indent-function 2)
494 (put 'with-tramp-gvfs-error-message 'edebug-form-spec '(form symbolp body))
495 (font-lock-add-keywords 'emacs-lisp-mode '("\\<with-tramp-gvfs-error-message\\>"))
497 (defvar tramp-gvfs-dbus-event-vector nil
498 "Current Tramp file name to be used, as vector.
499 It is needed when D-Bus signals or errors arrive, because there
500 is no information where to trace the message.")
502 (defun tramp-gvfs-dbus-event-error (event err)
503 "Called when a D-Bus error message arrives, see `dbus-event-error-hooks'."
504 (when tramp-gvfs-dbus-event-vector
505 ;(tramp-cleanup-connection tramp-gvfs-dbus-event-vector)
506 (tramp-message tramp-gvfs-dbus-event-vector 10 "%S" event)
507 (tramp-error tramp-gvfs-dbus-event-vector 'file-error "%s" (cadr err))))
509 (add-hook 'dbus-event-error-hooks 'tramp-gvfs-dbus-event-error)
512 ;; File name primitives.
514 (defun tramp-gvfs-handle-copy-file
515 (filename newname &optional ok-if-already-exists keep-date
516 preserve-uid-gid preserve-selinux-context)
517 "Like `copy-file' for Tramp files."
518 (let ((args
519 (list
520 (if (tramp-gvfs-file-name-p filename)
521 (tramp-gvfs-fuse-file-name filename)
522 filename)
523 (if (tramp-gvfs-file-name-p newname)
524 (tramp-gvfs-fuse-file-name newname)
525 newname)
526 ok-if-already-exists keep-date preserve-uid-gid)))
527 (when preserve-selinux-context
528 (setq args (append args (list preserve-selinux-context))))
529 (apply 'copy-file args)))
531 (defun tramp-gvfs-handle-delete-directory (directory &optional recursive)
532 "Like `delete-directory' for Tramp files."
533 (tramp-compat-delete-directory
534 (tramp-gvfs-fuse-file-name directory) recursive))
536 (defun tramp-gvfs-handle-delete-file (filename &optional force)
537 "Like `delete-file' for Tramp files."
538 (tramp-compat-delete-file (tramp-gvfs-fuse-file-name filename) force))
540 (defun tramp-gvfs-handle-directory-files
541 (directory &optional full match nosort)
542 "Like `directory-files' for Tramp files."
543 (let ((fuse-file-name (tramp-gvfs-fuse-file-name directory)))
544 (mapcar
545 (lambda (x)
546 (if (string-match fuse-file-name x)
547 (replace-match directory t t x)
549 (directory-files fuse-file-name full match nosort))))
551 (defun tramp-gvfs-handle-directory-files-and-attributes
552 (directory &optional full match nosort id-format)
553 "Like `directory-files-and-attributes' for Tramp files."
554 (let ((fuse-file-name (tramp-gvfs-fuse-file-name directory)))
555 (mapcar
556 (lambda (x)
557 (when (string-match fuse-file-name (car x))
558 (setcar x (replace-match directory t t (car x))))
560 (directory-files-and-attributes
561 fuse-file-name full match nosort id-format))))
563 (defun tramp-gvfs-handle-expand-file-name (name &optional dir)
564 "Like `expand-file-name' for Tramp files."
565 ;; If DIR is not given, use DEFAULT-DIRECTORY or "/".
566 (setq dir (or dir default-directory "/"))
567 ;; Unless NAME is absolute, concat DIR and NAME.
568 (unless (file-name-absolute-p name)
569 (setq name (concat (file-name-as-directory dir) name)))
570 ;; If NAME is not a Tramp file, run the real handler.
571 (if (not (tramp-tramp-file-p name))
572 (tramp-run-real-handler 'expand-file-name (list name nil))
573 ;; Dissect NAME.
574 (with-parsed-tramp-file-name name nil
575 ;; Tilde expansion is not possible.
576 (when (string-match "\\`\\(~[^/]*\\)\\(.*\\)\\'" localname)
577 (tramp-error
578 v 'file-error
579 "Cannot expand tilde in file `%s'" name))
580 (unless (tramp-run-real-handler 'file-name-absolute-p (list localname))
581 (setq localname (concat "/" localname)))
582 ;; We do not pass "/..".
583 (if (string-equal "smb" method)
584 (when (string-match "^/[^/]+\\(/\\.\\./?\\)" localname)
585 (setq localname (replace-match "/" t t localname 1)))
586 (when (string-match "^/\\.\\./?" localname)
587 (setq localname (replace-match "/" t t localname))))
588 ;; There might be a double slash. Remove this.
589 (while (string-match "//" localname)
590 (setq localname (replace-match "/" t t localname)))
591 ;; No tilde characters in file name, do normal
592 ;; `expand-file-name' (this does "/./" and "/../").
593 (tramp-make-tramp-file-name
594 method user host
595 (tramp-run-real-handler
596 'expand-file-name (list localname))))))
598 (defun tramp-gvfs-handle-file-attributes (filename &optional id-format)
599 "Like `file-attributes' for Tramp files."
600 (file-attributes (tramp-gvfs-fuse-file-name filename) id-format))
602 (defun tramp-gvfs-handle-file-executable-p (filename)
603 "Like `file-executable-p' for Tramp files."
604 (file-executable-p (tramp-gvfs-fuse-file-name filename)))
606 (defun tramp-gvfs-handle-file-exists-p (filename)
607 "Like `file-exists-p' for Tramp files."
608 (file-exists-p (tramp-gvfs-fuse-file-name filename)))
610 (defun tramp-gvfs-handle-file-local-copy (filename)
611 "Like `file-local-copy' for Tramp files."
612 (with-parsed-tramp-file-name filename nil
613 (let ((tmpfile (tramp-compat-make-temp-file filename)))
614 (unless (file-exists-p filename)
615 (tramp-error
616 v 'file-error
617 "Cannot make local copy of non-existing file `%s'" filename))
618 (copy-file filename tmpfile t t)
619 tmpfile)))
621 (defun tramp-gvfs-handle-file-name-all-completions (filename directory)
622 "Like `file-name-all-completions' for Tramp files."
623 (unless (save-match-data (string-match "/" filename))
624 (file-name-all-completions filename (tramp-gvfs-fuse-file-name directory))))
626 (defun tramp-gvfs-handle-file-readable-p (filename)
627 "Like `file-readable-p' for Tramp files."
628 (file-readable-p (tramp-gvfs-fuse-file-name filename)))
630 (defun tramp-gvfs-handle-file-selinux-context (filename)
631 "Like `file-selinux-context' for Tramp files."
632 (tramp-compat-funcall
633 'file-selinux-context (tramp-gvfs-fuse-file-name filename)))
635 (defun tramp-gvfs-handle-file-writable-p (filename)
636 "Like `file-writable-p' for Tramp files."
637 (file-writable-p (tramp-gvfs-fuse-file-name filename)))
639 (defun tramp-gvfs-handle-insert-directory
640 (filename switches &optional wildcard full-directory-p)
641 "Like `insert-directory' for Tramp files."
642 (insert-directory
643 (tramp-gvfs-fuse-file-name filename) switches wildcard full-directory-p))
645 (defun tramp-gvfs-handle-insert-file-contents
646 (filename &optional visit beg end replace)
647 "Like `insert-file-contents' for Tramp files."
648 (unwind-protect
649 (let ((fuse-file-name (tramp-gvfs-fuse-file-name filename))
650 (result
651 (insert-file-contents
652 (tramp-gvfs-fuse-file-name filename) visit beg end replace)))
653 (when (string-match fuse-file-name (car result))
654 (setcar result (replace-match filename t t (car result))))
655 result)
656 (setq buffer-file-name filename)))
658 (defun tramp-gvfs-handle-make-directory (dir &optional parents)
659 "Like `make-directory' for Tramp files."
660 (condition-case err
661 (with-tramp-gvfs-error-message dir 'make-directory
662 (tramp-gvfs-fuse-file-name dir) parents)
663 ;; Error case. Let's try it with the GVFS utilities.
664 (error
665 (with-parsed-tramp-file-name dir nil
666 (tramp-message v 4 "`make-directory' failed, trying `gvfs-mkdir'")
667 (unless
668 (zerop
669 (tramp-local-call-process
670 "gvfs-mkdir" nil (tramp-get-buffer v) nil
671 (tramp-gvfs-url-file-name dir)))
672 (signal (car err) (cdr err)))))))
674 (defun tramp-gvfs-handle-process-file
675 (program &optional infile destination display &rest args)
676 "Like `process-file' for Tramp files."
677 (let ((default-directory (tramp-gvfs-fuse-file-name default-directory)))
678 (apply 'call-process program infile destination display args)))
680 (defun tramp-gvfs-handle-rename-file
681 (filename newname &optional ok-if-already-exists)
682 "Like `rename-file' for Tramp files."
683 (rename-file
684 (if (tramp-gvfs-file-name-p filename)
685 (tramp-gvfs-fuse-file-name filename)
686 filename)
687 (if (tramp-gvfs-file-name-p newname)
688 (tramp-gvfs-fuse-file-name newname)
689 newname)
690 ok-if-already-exists))
692 (defun tramp-gvfs-handle-set-file-modes (filename mode)
693 "Like `set-file-modes' for Tramp files."
694 (with-tramp-gvfs-error-message filename 'set-file-modes
695 (tramp-gvfs-fuse-file-name filename) mode))
697 (defun tramp-gvfs-handle-set-file-selinux-context (filename context)
698 "Like `set-file-selinux-context' for Tramp files."
699 (with-tramp-gvfs-error-message filename 'set-file-selinux-context
700 (tramp-gvfs-fuse-file-name filename) context))
702 (defun tramp-gvfs-handle-set-visited-file-modtime (&optional time-list)
703 "Like `set-visited-file-modtime' for Tramp files."
704 (let ((buffer-file-name (tramp-gvfs-fuse-file-name (buffer-file-name))))
705 (set-visited-file-modtime time-list)))
707 (defun tramp-gvfs-handle-shell-command
708 (command &optional output-buffer error-buffer)
709 "Like `shell-command' for Tramp files."
710 (let ((default-directory (tramp-gvfs-fuse-file-name default-directory)))
711 (shell-command command output-buffer error-buffer)))
713 (defun tramp-gvfs-handle-start-file-process (name buffer program &rest args)
714 "Like `start-file-process' for Tramp files."
715 (let ((default-directory (tramp-gvfs-fuse-file-name default-directory)))
716 (apply 'start-process name buffer program args)))
718 (defun tramp-gvfs-handle-verify-visited-file-modtime (buf)
719 "Like `verify-visited-file-modtime' for Tramp files."
720 (with-current-buffer buf
721 (let ((buffer-file-name (tramp-gvfs-fuse-file-name (buffer-file-name))))
722 (verify-visited-file-modtime buf))))
724 (defun tramp-gvfs-handle-write-region
725 (start end filename &optional append visit lockname confirm)
726 "Like `write-region' for Tramp files."
727 (with-parsed-tramp-file-name filename nil
728 (condition-case err
729 (with-tramp-gvfs-error-message filename 'write-region
730 start end (tramp-gvfs-fuse-file-name filename)
731 append visit lockname confirm)
733 ;; Error case. Let's try it with the GVFS utilities.
734 (error
735 (let ((tmpfile (tramp-compat-make-temp-file filename)))
736 (tramp-message v 4 "`write-region' failed, trying `gvfs-save'")
737 (write-region start end tmpfile)
738 (unwind-protect
739 (unless
740 (zerop
741 (tramp-local-call-process
742 "gvfs-save" tmpfile (tramp-get-buffer v) nil
743 (tramp-gvfs-url-file-name filename)))
744 (signal (car err) (cdr err)))
745 (tramp-compat-delete-file tmpfile 'force)))))
747 ;; Set file modification time.
748 (when (or (eq visit t) (stringp visit))
749 (set-visited-file-modtime (nth 5 (file-attributes filename))))
751 ;; The end.
752 (when (or (eq visit t) (null visit) (stringp visit))
753 (tramp-message v 0 "Wrote %s" filename))
754 (run-hooks 'tramp-handle-write-region-hook)))
757 ;; File name conversions.
759 (defun tramp-gvfs-url-file-name (filename)
760 "Return FILENAME in URL syntax."
761 (url-recreate-url
762 (if (tramp-tramp-file-p filename)
763 (with-parsed-tramp-file-name (file-truename filename) nil
764 (when (string-match tramp-user-with-domain-regexp user)
765 (setq user
766 (concat (match-string 2 user) ";" (match-string 2 user))))
767 (url-parse-make-urlobj
768 method user nil
769 (tramp-file-name-real-host v) (tramp-file-name-port v) localname))
770 (url-parse-make-urlobj "file" nil nil nil nil (file-truename filename)))))
772 (defun tramp-gvfs-object-path (filename)
773 "Create a D-Bus object path from FILENAME."
774 (expand-file-name (dbus-escape-as-identifier filename) tramp-gvfs-path-tramp))
776 (defun tramp-gvfs-file-name (object-path)
777 "Retrieve file name from D-Bus OBJECT-PATH."
778 (dbus-unescape-from-identifier
779 (replace-regexp-in-string "^.*/\\([^/]+\\)$" "\\1" object-path)))
781 (defun tramp-gvfs-fuse-file-name (filename)
782 "Return FUSE file name, which is directly accessible."
783 (with-parsed-tramp-file-name (expand-file-name filename) nil
784 (tramp-gvfs-maybe-open-connection v)
785 (let ((fuse-mountpoint
786 (tramp-get-file-property v "/" "fuse-mountpoint" nil)))
787 (unless fuse-mountpoint
788 (tramp-error
789 v 'file-error "There is no FUSE mount point for `%s'" filename))
790 ;; We must remove the share from the local name.
791 (when (and (string-equal "smb" method) (string-match "/[^/]+" localname))
792 (setq localname (replace-match "" t t localname)))
793 (concat tramp-gvfs-mount-point fuse-mountpoint localname))))
795 (defun tramp-bluez-address (device)
796 "Return bluetooth device address from a given bluetooth DEVICE name."
797 (when (stringp device)
798 (if (string-match tramp-ipv6-regexp device)
799 (match-string 0 device)
800 (cadr (assoc device (tramp-bluez-list-devices))))))
802 (defun tramp-bluez-device (address)
803 "Return bluetooth device name from a given bluetooth device ADDRESS.
804 ADDRESS can have the form \"xx:xx:xx:xx:xx:xx\" or \"[xx:xx:xx:xx:xx:xx]\"."
805 (when (stringp address)
806 (while (string-match "[][]" address)
807 (setq address (replace-match "" t t address)))
808 (let (result)
809 (dolist (item (tramp-bluez-list-devices) result)
810 (when (string-match address (cadr item))
811 (setq result (car item)))))))
814 ;; D-Bus GVFS functions.
816 (defun tramp-gvfs-handler-askpassword (message user domain flags)
817 "Implementation for the \"org.gtk.vfs.MountOperation.askPassword\" method."
818 (let* ((filename
819 (tramp-gvfs-file-name (dbus-event-path-name last-input-event)))
820 (pw-prompt
821 (format
822 "%s for %s "
823 (if (string-match "\\([pP]assword\\|[pP]assphrase\\)" message)
824 (capitalize (match-string 1 message))
825 "Password")
826 filename))
827 password)
829 (condition-case nil
830 (with-parsed-tramp-file-name filename l
831 (when (and (zerop (length user))
832 (not
833 (zerop (logand flags tramp-gvfs-password-need-username))))
834 (setq user (read-string "User name: ")))
835 (when (and (zerop (length domain))
836 (not (zerop (logand flags tramp-gvfs-password-need-domain))))
837 (setq domain (read-string "Domain name: ")))
839 (tramp-message l 6 "%S %S %S %d" message user domain flags)
840 (setq tramp-current-method l-method
841 tramp-current-user user
842 tramp-current-host l-host
843 password (tramp-read-passwd
844 (tramp-get-connection-process l) pw-prompt))
846 ;; Return result.
847 (if (stringp password)
848 (list
849 t ;; password handled.
850 nil ;; no abort of D-Bus.
851 password
852 (tramp-file-name-real-user l)
853 domain
854 nil ;; not anonymous.
855 0) ;; no password save.
856 ;; No password provided.
857 (list nil t "" (tramp-file-name-real-user l) domain nil 0)))
859 ;; When QUIT is raised, we shall return this information to D-Bus.
860 (quit (list nil t "" "" "" nil 0)))))
862 (defun tramp-gvfs-handler-askquestion (message choices)
863 "Implementation for the \"org.gtk.vfs.MountOperation.askQuestion\" method."
864 (save-window-excursion
865 (let ((enable-recursive-minibuffers t)
866 choice)
868 (condition-case nil
869 (with-parsed-tramp-file-name
870 (tramp-gvfs-file-name (dbus-event-path-name last-input-event)) nil
871 (tramp-message v 6 "%S %S" message choices)
873 ;; In theory, there can be several choices. Until now,
874 ;; there is only the question whether to accept an unknown
875 ;; host signature.
876 (with-temp-buffer
877 ;; Preserve message for `progress-reporter'.
878 (with-temp-message ""
879 (insert message)
880 (pop-to-buffer (current-buffer))
881 (setq choice (if (yes-or-no-p (concat (car choices) " ")) 0 1))
882 (tramp-message v 6 "%d" choice)))
884 ;; When the choice is "no", we set an empty
885 ;; fuse-mountpoint in order to leave the timeout.
886 (unless (zerop choice)
887 (tramp-set-file-property v "/" "fuse-mountpoint" ""))
889 (list
890 t ;; handled.
891 nil ;; no abort of D-Bus.
892 choice))
894 ;; When QUIT is raised, we shall return this information to D-Bus.
895 (quit (list nil t 0))))))
897 (defun tramp-gvfs-handler-mounted-unmounted (mount-info)
898 "Signal handler for the \"org.gtk.vfs.MountTracker.mounted\" and
899 \"org.gtk.vfs.MountTracker.unmounted\" signals."
900 (ignore-errors
901 (let* ((signal-name (dbus-event-member-name last-input-event))
902 (mount-spec (cadar (last mount-info)))
903 (method (dbus-byte-array-to-string (cadr (assoc "type" mount-spec))))
904 (user (dbus-byte-array-to-string (cadr (assoc "user" mount-spec))))
905 (domain (dbus-byte-array-to-string
906 (cadr (assoc "domain" mount-spec))))
907 (host (dbus-byte-array-to-string
908 (cadr (or (assoc "host" mount-spec)
909 (assoc "server" mount-spec)))))
910 (port (dbus-byte-array-to-string (cadr (assoc "port" mount-spec))))
911 (ssl (dbus-byte-array-to-string (cadr (assoc "ssl" mount-spec)))))
912 (when (string-match "^smb" method)
913 (setq method "smb"))
914 (when (string-equal "obex" method)
915 (setq host (tramp-bluez-device host)))
916 (when (and (string-equal "dav" method) (string-equal "true" ssl))
917 (setq method "davs"))
918 (unless (zerop (length domain))
919 (setq user (concat user tramp-prefix-domain-format domain)))
920 (unless (zerop (length port))
921 (setq host (concat host tramp-prefix-port-format port)))
922 (with-parsed-tramp-file-name
923 (tramp-make-tramp-file-name method user host "") nil
924 (tramp-message v 6 "%s %s" signal-name mount-info)
925 (tramp-set-file-property v "/" "list-mounts" 'undef)
926 (if (string-equal signal-name "unmounted")
927 (tramp-set-file-property v "/" "fuse-mountpoint" nil)
928 (tramp-set-file-property
929 v "/" "fuse-mountpoint"
930 (file-name-nondirectory
931 (dbus-byte-array-to-string (car (last mount-info 2))))))))))
933 (dbus-register-signal
934 :session nil tramp-gvfs-path-mounttracker
935 tramp-gvfs-interface-mounttracker "mounted"
936 'tramp-gvfs-handler-mounted-unmounted)
938 (dbus-register-signal
939 :session nil tramp-gvfs-path-mounttracker
940 tramp-gvfs-interface-mounttracker "unmounted"
941 'tramp-gvfs-handler-mounted-unmounted)
943 (defun tramp-gvfs-connection-mounted-p (vec)
944 "Check, whether the location is already mounted."
945 (catch 'mounted
946 (dolist
947 (elt
948 (with-file-property vec "/" "list-mounts"
949 (with-tramp-dbus-call-method vec t
950 :session tramp-gvfs-service-daemon tramp-gvfs-path-mounttracker
951 tramp-gvfs-interface-mounttracker "listMounts"))
952 nil)
953 (let* ((mount-spec (cadar (last elt)))
954 (method (dbus-byte-array-to-string
955 (cadr (assoc "type" mount-spec))))
956 (user (dbus-byte-array-to-string
957 (cadr (assoc "user" mount-spec))))
958 (domain (dbus-byte-array-to-string
959 (cadr (assoc "domain" mount-spec))))
960 (host (dbus-byte-array-to-string
961 (cadr (or (assoc "host" mount-spec)
962 (assoc "server" mount-spec)))))
963 (port (dbus-byte-array-to-string (cadr (assoc "port" mount-spec))))
964 (ssl (dbus-byte-array-to-string (cadr (assoc "ssl" mount-spec)))))
965 (when (string-match "^smb" method)
966 (setq method "smb"))
967 (when (string-equal "obex" method)
968 (setq host (tramp-bluez-device host)))
969 (when (and (string-equal "dav" method) (string-equal "true" ssl))
970 (setq method "davs"))
971 (when (and (string-equal "synce" method) (zerop (length user)))
972 (setq user (or (tramp-file-name-user vec) "")))
973 (unless (zerop (length domain))
974 (setq user (concat user tramp-prefix-domain-format domain)))
975 (unless (zerop (length port))
976 (setq host (concat host tramp-prefix-port-format port)))
977 (when (and
978 (string-equal method (tramp-file-name-method vec))
979 (string-equal user (or (tramp-file-name-user vec) ""))
980 (string-equal host (tramp-file-name-host vec)))
981 (tramp-set-file-property
982 vec "/" "fuse-mountpoint"
983 (file-name-nondirectory
984 (dbus-byte-array-to-string (car (last elt 2)))))
985 (throw 'mounted t))))))
987 (defun tramp-gvfs-mount-spec (vec)
988 "Return a mount-spec for \"org.gtk.vfs.MountTracker.mountLocation\"."
989 (let* ((method (tramp-file-name-method vec))
990 (user (tramp-file-name-real-user vec))
991 (domain (tramp-file-name-domain vec))
992 (host (tramp-file-name-real-host vec))
993 (port (tramp-file-name-port vec))
994 (localname (tramp-file-name-localname vec))
995 (ssl (if (string-match "^davs" method) "true" "false"))
996 (mount-spec `(:array)))
998 (setq
999 mount-spec
1000 (append
1001 mount-spec
1002 (cond
1003 ((string-equal "smb" method)
1004 (string-match "^/?\\([^/]+\\)" localname)
1005 `((:struct "type" ,(dbus-string-to-byte-array "smb-share"))
1006 (:struct "server" ,(dbus-string-to-byte-array host))
1007 (:struct "share" ,(dbus-string-to-byte-array
1008 (match-string 1 localname)))))
1009 ((string-equal "obex" method)
1010 `((:struct "type" ,(dbus-string-to-byte-array method))
1011 (:struct "host" ,(dbus-string-to-byte-array
1012 (concat "[" (tramp-bluez-address host) "]")))))
1013 ((string-match "^dav" method)
1014 `((:struct "type" ,(dbus-string-to-byte-array "dav"))
1015 (:struct "host" ,(dbus-string-to-byte-array host))
1016 (:struct "ssl" ,(dbus-string-to-byte-array ssl))))
1018 `((:struct "type" ,(dbus-string-to-byte-array method))
1019 (:struct "host" ,(dbus-string-to-byte-array host)))))))
1021 (when user
1022 (add-to-list
1023 'mount-spec
1024 `(:struct "user" ,(dbus-string-to-byte-array user))
1025 'append))
1027 (when domain
1028 (add-to-list
1029 'mount-spec
1030 `(:struct "domain" ,(dbus-string-to-byte-array domain))
1031 'append))
1033 (when port
1034 (add-to-list
1035 'mount-spec
1036 `(:struct "port" ,(dbus-string-to-byte-array (number-to-string port)))
1037 'append))
1039 ;; Return.
1040 mount-spec))
1043 ;; Connection functions
1045 (defun tramp-gvfs-maybe-open-connection (vec)
1046 "Maybe open a connection VEC.
1047 Does not do anything if a connection is already open, but re-opens the
1048 connection if a previous connection has died for some reason."
1050 ;; We set the file name, in case there are incoming D-Bus signals or
1051 ;; D-Bus errors.
1052 (setq tramp-gvfs-dbus-event-vector vec)
1054 ;; For password handling, we need a process bound to the connection
1055 ;; buffer. Therefore, we create a dummy process. Maybe there is a
1056 ;; better solution?
1057 (unless (get-buffer-process (tramp-get-buffer vec))
1058 (let ((p (make-network-process
1059 :name (tramp-buffer-name vec)
1060 :buffer (tramp-get-buffer vec)
1061 :server t :host 'local :service t)))
1062 (tramp-set-process-query-on-exit-flag p nil)))
1064 (unless (tramp-gvfs-connection-mounted-p vec)
1065 (let* ((method (tramp-file-name-method vec))
1066 (user (tramp-file-name-user vec))
1067 (host (tramp-file-name-host vec))
1068 (object-path
1069 (tramp-gvfs-object-path
1070 (tramp-make-tramp-file-name method user host ""))))
1072 (with-progress-reporter
1073 vec 3
1074 (if (zerop (length user))
1075 (format "Opening connection for %s using %s" host method)
1076 (format "Opening connection for %s@%s using %s" user host method))
1078 ;; Enable auth-sorce and password-cache.
1079 (tramp-set-connection-property vec "first-password-request" t)
1081 ;; There will be a callback of "askPassword", when a password is
1082 ;; needed.
1083 (dbus-register-method
1084 :session dbus-service-emacs object-path
1085 tramp-gvfs-interface-mountoperation "askPassword"
1086 'tramp-gvfs-handler-askpassword)
1088 ;; There could be a callback of "askQuestion", when adding fingerprint.
1089 (dbus-register-method
1090 :session dbus-service-emacs object-path
1091 tramp-gvfs-interface-mountoperation "askQuestion"
1092 'tramp-gvfs-handler-askquestion)
1094 ;; The call must be asynchronously, because of the "askPassword"
1095 ;; or "askQuestion"callbacks.
1096 (with-tramp-dbus-call-method vec nil
1097 :session tramp-gvfs-service-daemon tramp-gvfs-path-mounttracker
1098 tramp-gvfs-interface-mounttracker "mountLocation"
1099 `(:struct
1100 ,(dbus-string-to-byte-array "/")
1101 ,(tramp-gvfs-mount-spec vec))
1102 (dbus-get-unique-name :session)
1103 :object-path object-path)
1105 ;; We must wait, until the mount is applied. This will be
1106 ;; indicated by the "mounted" signal, i.e. the "fuse-mountpoint"
1107 ;; file property.
1108 (with-timeout
1110 (if (zerop (length (tramp-file-name-user vec)))
1111 (tramp-error
1112 vec 'file-error
1113 "Timeout reached mounting %s using %s" host method)
1114 (tramp-error
1115 vec 'file-error
1116 "Timeout reached mounting %s@%s using %s" user host method)))
1117 (while (not (tramp-get-file-property vec "/" "fuse-mountpoint" nil))
1118 (read-event nil nil 0.1)))
1120 ;; We set the connection property "started" in order to put the
1121 ;; remote location into the cache, which is helpful for further
1122 ;; completion.
1123 (tramp-set-connection-property vec "started" t)))))
1126 ;; D-Bus BLUEZ functions.
1128 (defun tramp-bluez-list-devices ()
1129 "Return all discovered bluetooth devices as list.
1130 Every entry is a list (NAME ADDRESS).
1132 If `tramp-bluez-discover-devices-timeout' is an integer, and the last
1133 discovery happened more time before indicated there, a rescan will be
1134 started, which lasts some ten seconds. Otherwise, cached results will
1135 be used."
1136 ;; Reset the scanned devices list if time has passed.
1137 (and (integerp tramp-bluez-discover-devices-timeout)
1138 (integerp tramp-bluez-discovery)
1139 (> (tramp-time-diff (current-time) tramp-bluez-discovery)
1140 tramp-bluez-discover-devices-timeout)
1141 (setq tramp-bluez-devices nil))
1143 ;; Rescan if needed.
1144 (unless tramp-bluez-devices
1145 (let ((object-path
1146 (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector t
1147 :system tramp-bluez-service "/"
1148 tramp-bluez-interface-manager "DefaultAdapter")))
1149 (setq tramp-bluez-devices nil
1150 tramp-bluez-discovery t)
1151 (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector nil
1152 :system tramp-bluez-service object-path
1153 tramp-bluez-interface-adapter "StartDiscovery")
1154 (while tramp-bluez-discovery
1155 (read-event nil nil 0.1))))
1156 (setq tramp-bluez-discovery (current-time))
1157 (tramp-message tramp-gvfs-dbus-event-vector 10 "%s" tramp-bluez-devices)
1158 tramp-bluez-devices)
1160 (defun tramp-bluez-property-changed (property value)
1161 "Signal handler for the \"org.bluez.Adapter.PropertyChanged\" signal."
1162 (tramp-message tramp-gvfs-dbus-event-vector 6 "%s %s" property value)
1163 (cond
1164 ((string-equal property "Discovering")
1165 (unless (car value)
1166 ;; "Discovering" FALSE means discovery run has been completed.
1167 ;; We stop it, because we don't need another run.
1168 (setq tramp-bluez-discovery nil)
1169 (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector t
1170 :system tramp-bluez-service (dbus-event-path-name last-input-event)
1171 tramp-bluez-interface-adapter "StopDiscovery")))))
1173 (dbus-register-signal
1174 :system nil nil tramp-bluez-interface-adapter "PropertyChanged"
1175 'tramp-bluez-property-changed)
1177 (defun tramp-bluez-device-found (device args)
1178 "Signal handler for the \"org.bluez.Adapter.DeviceFound\" signal."
1179 (tramp-message tramp-gvfs-dbus-event-vector 6 "%s %s" device args)
1180 (let ((alias (car (cadr (assoc "Alias" args))))
1181 (address (car (cadr (assoc "Address" args)))))
1182 ;; Maybe we shall check the device class for being a proper
1183 ;; device, and call also SDP in order to find the obex service.
1184 (add-to-list 'tramp-bluez-devices (list alias address))))
1186 (dbus-register-signal
1187 :system nil nil tramp-bluez-interface-adapter "DeviceFound"
1188 'tramp-bluez-device-found)
1190 (defun tramp-bluez-parse-device-names (ignore)
1191 "Return a list of (nil host) tuples allowed to access."
1192 (mapcar
1193 (lambda (x) (list nil (car x)))
1194 (tramp-bluez-list-devices)))
1196 ;; Add completion function for OBEX method.
1197 (when (member tramp-bluez-service (dbus-list-known-names :system))
1198 (tramp-set-completion-function
1199 "obex" '((tramp-bluez-parse-device-names ""))))
1202 ;; D-Bus zeroconf functions.
1204 (defun tramp-zeroconf-parse-workstation-device-names (ignore)
1205 "Return a list of (user host) tuples allowed to access."
1206 (mapcar
1207 (lambda (x)
1208 (list nil (zeroconf-service-host x)))
1209 (zeroconf-list-services "_workstation._tcp")))
1211 (defun tramp-zeroconf-parse-webdav-device-names (ignore)
1212 "Return a list of (user host) tuples allowed to access."
1213 (mapcar
1214 (lambda (x)
1215 (let ((host (zeroconf-service-host x))
1216 (port (zeroconf-service-port x))
1217 (text (zeroconf-service-txt x))
1218 user)
1219 (when port
1220 (setq host (format "%s%s%d" host tramp-prefix-port-regexp port)))
1221 ;; A user is marked in a TXT field like "u=guest".
1222 (while text
1223 (when (string-match "u=\\(.+\\)$" (car text))
1224 (setq user (match-string 1 (car text))))
1225 (setq text (cdr text)))
1226 (list user host)))
1227 (zeroconf-list-services "_webdav._tcp")))
1229 ;; Add completion function for DAV and DAVS methods.
1230 (when (member zeroconf-service-avahi (dbus-list-known-names :system))
1231 (zeroconf-init tramp-gvfs-zeroconf-domain)
1232 (tramp-set-completion-function
1233 "sftp" '((tramp-zeroconf-parse-workstation-device-names "")))
1234 (tramp-set-completion-function
1235 "dav" '((tramp-zeroconf-parse-webdav-device-names "")))
1236 (tramp-set-completion-function
1237 "davs" '((tramp-zeroconf-parse-webdav-device-names ""))))
1240 ;; D-Bus SYNCE functions.
1242 (defun tramp-synce-list-devices ()
1243 "Return all discovered synce devices as list.
1244 They are retrieved from the hal daemon."
1245 (let (tramp-synce-devices)
1246 (dolist (device
1247 (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector t
1248 :system tramp-hal-service tramp-hal-path-manager
1249 tramp-hal-interface-manager "GetAllDevices"))
1250 (when (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector t
1251 :system tramp-hal-service device tramp-hal-interface-device
1252 "PropertyExists" "sync.plugin")
1253 (add-to-list
1254 'tramp-synce-devices
1255 (with-tramp-dbus-call-method tramp-gvfs-dbus-event-vector t
1256 :system tramp-hal-service device tramp-hal-interface-device
1257 "GetPropertyString" "pda.pocketpc.name"))))
1258 (tramp-message tramp-gvfs-dbus-event-vector 10 "%s" tramp-synce-devices)
1259 tramp-synce-devices))
1261 (defun tramp-synce-parse-device-names (ignore)
1262 "Return a list of (nil host) tuples allowed to access."
1263 (mapcar
1264 (lambda (x) (list nil x))
1265 (tramp-synce-list-devices)))
1267 ;; Add completion function for SYNCE method.
1268 (tramp-set-completion-function
1269 "synce" '((tramp-synce-parse-device-names "")))
1271 (provide 'tramp-gvfs)
1273 ;;; TODO:
1275 ;; * Host name completion via smb-server or smb-network.
1276 ;; * Check, how two shares of the same SMB server can be mounted in
1277 ;; parallel.
1278 ;; * Apply SDP on bluetooth devices, in order to filter out obex
1279 ;; capability.
1280 ;; * Implement obex for other serial communication but bluetooth.
1282 ;; arch-tag: f7f660ce-77f4-4132-9663-f5c25a47f7ed
1283 ;;; tramp-gvfs.el ends here