1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
3 /* GIO - GLib Input, Output and Streaming Library
5 * Copyright (C) 2006-2007 Red Hat, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General
18 * Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
20 * Author: Alexander Larsson <alexl@redhat.com>
21 * David Zeuthen <davidz@redhat.com>
29 #include "gunionvolumemonitor.h"
30 #include "gmountprivate.h"
31 #include "giomodule-priv.h"
33 #include "gunixvolumemonitor.h"
35 #include "gnativevolumemonitor.h"
40 struct _GUnionVolumeMonitor
{
41 GVolumeMonitor parent
;
46 static void g_union_volume_monitor_remove_monitor (GUnionVolumeMonitor
*union_monitor
,
47 GVolumeMonitor
*child_monitor
);
50 #define g_union_volume_monitor_get_type _g_union_volume_monitor_get_type
51 G_DEFINE_TYPE (GUnionVolumeMonitor
, g_union_volume_monitor
, G_TYPE_VOLUME_MONITOR
)
53 static GRecMutex the_volume_monitor_mutex
;
55 static GUnionVolumeMonitor
*the_volume_monitor
= NULL
;
58 g_union_volume_monitor_finalize (GObject
*object
)
60 GUnionVolumeMonitor
*monitor
;
61 GVolumeMonitor
*child_monitor
;
63 monitor
= G_UNION_VOLUME_MONITOR (object
);
65 while (monitor
->monitors
!= NULL
)
67 child_monitor
= monitor
->monitors
->data
;
68 g_union_volume_monitor_remove_monitor (monitor
,
70 g_object_unref (child_monitor
);
73 G_OBJECT_CLASS (g_union_volume_monitor_parent_class
)->finalize (object
);
77 g_union_volume_monitor_dispose (GObject
*object
)
79 GUnionVolumeMonitor
*monitor
;
80 GVolumeMonitor
*child_monitor
;
83 monitor
= G_UNION_VOLUME_MONITOR (object
);
85 g_rec_mutex_lock (&the_volume_monitor_mutex
);
86 the_volume_monitor
= NULL
;
88 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
90 child_monitor
= l
->data
;
91 g_object_run_dispose (G_OBJECT (child_monitor
));
94 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
96 G_OBJECT_CLASS (g_union_volume_monitor_parent_class
)->dispose (object
);
100 get_mounts (GVolumeMonitor
*volume_monitor
)
102 GUnionVolumeMonitor
*monitor
;
103 GVolumeMonitor
*child_monitor
;
107 monitor
= G_UNION_VOLUME_MONITOR (volume_monitor
);
111 g_rec_mutex_lock (&the_volume_monitor_mutex
);
113 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
115 child_monitor
= l
->data
;
117 res
= g_list_concat (res
, g_volume_monitor_get_mounts (child_monitor
));
120 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
126 get_volumes (GVolumeMonitor
*volume_monitor
)
128 GUnionVolumeMonitor
*monitor
;
129 GVolumeMonitor
*child_monitor
;
133 monitor
= G_UNION_VOLUME_MONITOR (volume_monitor
);
137 g_rec_mutex_lock (&the_volume_monitor_mutex
);
139 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
141 child_monitor
= l
->data
;
143 res
= g_list_concat (res
, g_volume_monitor_get_volumes (child_monitor
));
146 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
152 get_connected_drives (GVolumeMonitor
*volume_monitor
)
154 GUnionVolumeMonitor
*monitor
;
155 GVolumeMonitor
*child_monitor
;
159 monitor
= G_UNION_VOLUME_MONITOR (volume_monitor
);
163 g_rec_mutex_lock (&the_volume_monitor_mutex
);
165 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
167 child_monitor
= l
->data
;
169 res
= g_list_concat (res
, g_volume_monitor_get_connected_drives (child_monitor
));
172 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
178 get_volume_for_uuid (GVolumeMonitor
*volume_monitor
, const char *uuid
)
180 GUnionVolumeMonitor
*monitor
;
181 GVolumeMonitor
*child_monitor
;
185 monitor
= G_UNION_VOLUME_MONITOR (volume_monitor
);
189 g_rec_mutex_lock (&the_volume_monitor_mutex
);
191 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
193 child_monitor
= l
->data
;
195 volume
= g_volume_monitor_get_volume_for_uuid (child_monitor
, uuid
);
201 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
207 get_mount_for_uuid (GVolumeMonitor
*volume_monitor
, const char *uuid
)
209 GUnionVolumeMonitor
*monitor
;
210 GVolumeMonitor
*child_monitor
;
214 monitor
= G_UNION_VOLUME_MONITOR (volume_monitor
);
218 g_rec_mutex_lock (&the_volume_monitor_mutex
);
220 for (l
= monitor
->monitors
; l
!= NULL
; l
= l
->next
)
222 child_monitor
= l
->data
;
224 mount
= g_volume_monitor_get_mount_for_uuid (child_monitor
, uuid
);
230 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
236 g_union_volume_monitor_class_init (GUnionVolumeMonitorClass
*klass
)
238 GObjectClass
*gobject_class
= G_OBJECT_CLASS (klass
);
239 GVolumeMonitorClass
*monitor_class
= G_VOLUME_MONITOR_CLASS (klass
);
241 gobject_class
->finalize
= g_union_volume_monitor_finalize
;
242 gobject_class
->dispose
= g_union_volume_monitor_dispose
;
244 monitor_class
->get_connected_drives
= get_connected_drives
;
245 monitor_class
->get_volumes
= get_volumes
;
246 monitor_class
->get_mounts
= get_mounts
;
247 monitor_class
->get_volume_for_uuid
= get_volume_for_uuid
;
248 monitor_class
->get_mount_for_uuid
= get_mount_for_uuid
;
252 child_volume_added (GVolumeMonitor
*child_monitor
,
253 GVolume
*child_volume
,
254 GUnionVolumeMonitor
*union_monitor
)
256 g_signal_emit_by_name (union_monitor
,
262 child_volume_removed (GVolumeMonitor
*child_monitor
,
263 GVolume
*child_volume
,
264 GUnionVolumeMonitor
*union_monitor
)
266 g_signal_emit_by_name (union_monitor
,
272 child_volume_changed (GVolumeMonitor
*child_monitor
,
273 GVolume
*child_volume
,
274 GUnionVolumeMonitor
*union_monitor
)
276 g_signal_emit_by_name (union_monitor
,
282 child_mount_added (GVolumeMonitor
*child_monitor
,
284 GUnionVolumeMonitor
*union_monitor
)
286 g_signal_emit_by_name (union_monitor
,
292 child_mount_removed (GVolumeMonitor
*child_monitor
,
294 GUnionVolumeMonitor
*union_monitor
)
296 g_signal_emit_by_name (union_monitor
,
302 child_mount_pre_unmount (GVolumeMonitor
*child_monitor
,
304 GUnionVolumeMonitor
*union_monitor
)
306 g_signal_emit_by_name (union_monitor
,
313 child_mount_changed (GVolumeMonitor
*child_monitor
,
315 GUnionVolumeMonitor
*union_monitor
)
317 g_signal_emit_by_name (union_monitor
,
323 child_drive_connected (GVolumeMonitor
*child_monitor
,
325 GUnionVolumeMonitor
*union_monitor
)
327 g_signal_emit_by_name (union_monitor
,
333 child_drive_disconnected (GVolumeMonitor
*child_monitor
,
335 GUnionVolumeMonitor
*union_monitor
)
337 g_signal_emit_by_name (union_monitor
,
338 "drive-disconnected",
343 child_drive_changed (GVolumeMonitor
*child_monitor
,
345 GUnionVolumeMonitor
*union_monitor
)
347 g_signal_emit_by_name (union_monitor
,
353 child_drive_eject_button (GVolumeMonitor
*child_monitor
,
355 GUnionVolumeMonitor
*union_monitor
)
357 g_signal_emit_by_name (union_monitor
,
358 "drive-eject-button",
363 child_drive_stop_button (GVolumeMonitor
*child_monitor
,
365 GUnionVolumeMonitor
*union_monitor
)
367 g_signal_emit_by_name (union_monitor
,
373 g_union_volume_monitor_add_monitor (GUnionVolumeMonitor
*union_monitor
,
374 GVolumeMonitor
*volume_monitor
)
376 if (g_list_find (union_monitor
->monitors
, volume_monitor
))
379 union_monitor
->monitors
=
380 g_list_prepend (union_monitor
->monitors
,
381 g_object_ref (volume_monitor
));
383 g_signal_connect (volume_monitor
, "volume-added", (GCallback
)child_volume_added
, union_monitor
);
384 g_signal_connect (volume_monitor
, "volume-removed", (GCallback
)child_volume_removed
, union_monitor
);
385 g_signal_connect (volume_monitor
, "volume-changed", (GCallback
)child_volume_changed
, union_monitor
);
386 g_signal_connect (volume_monitor
, "mount-added", (GCallback
)child_mount_added
, union_monitor
);
387 g_signal_connect (volume_monitor
, "mount-removed", (GCallback
)child_mount_removed
, union_monitor
);
388 g_signal_connect (volume_monitor
, "mount-pre-unmount", (GCallback
)child_mount_pre_unmount
, union_monitor
);
389 g_signal_connect (volume_monitor
, "mount-changed", (GCallback
)child_mount_changed
, union_monitor
);
390 g_signal_connect (volume_monitor
, "drive-connected", (GCallback
)child_drive_connected
, union_monitor
);
391 g_signal_connect (volume_monitor
, "drive-disconnected", (GCallback
)child_drive_disconnected
, union_monitor
);
392 g_signal_connect (volume_monitor
, "drive-changed", (GCallback
)child_drive_changed
, union_monitor
);
393 g_signal_connect (volume_monitor
, "drive-eject-button", (GCallback
)child_drive_eject_button
, union_monitor
);
394 g_signal_connect (volume_monitor
, "drive-stop-button", (GCallback
)child_drive_stop_button
, union_monitor
);
398 g_union_volume_monitor_remove_monitor (GUnionVolumeMonitor
*union_monitor
,
399 GVolumeMonitor
*child_monitor
)
403 l
= g_list_find (union_monitor
->monitors
, child_monitor
);
407 union_monitor
->monitors
= g_list_delete_link (union_monitor
->monitors
, l
);
409 g_signal_handlers_disconnect_by_func (child_monitor
, child_volume_added
, union_monitor
);
410 g_signal_handlers_disconnect_by_func (child_monitor
, child_volume_removed
, union_monitor
);
411 g_signal_handlers_disconnect_by_func (child_monitor
, child_volume_changed
, union_monitor
);
412 g_signal_handlers_disconnect_by_func (child_monitor
, child_mount_added
, union_monitor
);
413 g_signal_handlers_disconnect_by_func (child_monitor
, child_mount_removed
, union_monitor
);
414 g_signal_handlers_disconnect_by_func (child_monitor
, child_mount_pre_unmount
, union_monitor
);
415 g_signal_handlers_disconnect_by_func (child_monitor
, child_mount_changed
, union_monitor
);
416 g_signal_handlers_disconnect_by_func (child_monitor
, child_drive_connected
, union_monitor
);
417 g_signal_handlers_disconnect_by_func (child_monitor
, child_drive_disconnected
, union_monitor
);
418 g_signal_handlers_disconnect_by_func (child_monitor
, child_drive_changed
, union_monitor
);
419 g_signal_handlers_disconnect_by_func (child_monitor
, child_drive_eject_button
, union_monitor
);
420 g_signal_handlers_disconnect_by_func (child_monitor
, child_drive_stop_button
, union_monitor
);
424 get_default_native_class (gpointer data
)
426 GNativeVolumeMonitorClass
*klass
, *native_class
, **native_class_out
;
427 const char *use_this
;
428 GIOExtensionPoint
*ep
;
429 GIOExtension
*extension
;
432 native_class_out
= data
;
434 use_this
= g_getenv ("GIO_USE_VOLUME_MONITOR");
436 /* Ensure vfs in modules loaded */
437 _g_io_modules_ensure_loaded ();
439 ep
= g_io_extension_point_lookup (G_NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME
);
444 extension
= g_io_extension_point_get_extension_by_name (ep
, use_this
);
447 klass
= G_NATIVE_VOLUME_MONITOR_CLASS (g_io_extension_ref_class (extension
));
448 if (G_VOLUME_MONITOR_CLASS (klass
)->is_supported())
449 native_class
= klass
;
451 g_type_class_unref (klass
);
455 if (native_class
== NULL
)
457 for (l
= g_io_extension_point_get_extensions (ep
); l
!= NULL
; l
= l
->next
)
460 klass
= G_NATIVE_VOLUME_MONITOR_CLASS (g_io_extension_ref_class (extension
));
461 if (G_VOLUME_MONITOR_CLASS (klass
)->is_supported())
463 native_class
= klass
;
467 g_type_class_unref (klass
);
473 *native_class_out
= native_class
;
474 return G_TYPE_FROM_CLASS (native_class
);
477 return G_TYPE_INVALID
;
480 /* We return the class, with a ref taken.
481 * This way we avoid unloading the class/module
482 * between selecting the type and creating the
483 * instance on the first call.
485 static GNativeVolumeMonitorClass
*
486 get_native_class (void)
488 static GOnce once_init
= G_ONCE_INIT
;
489 GTypeClass
*type_class
;
492 g_once (&once_init
, (GThreadFunc
)get_default_native_class
, &type_class
);
494 if (type_class
== NULL
&& once_init
.retval
!= GUINT_TO_POINTER(G_TYPE_INVALID
))
495 type_class
= g_type_class_ref ((GType
)once_init
.retval
);
497 return (GNativeVolumeMonitorClass
*)type_class
;
501 g_union_volume_monitor_init (GUnionVolumeMonitor
*union_monitor
)
506 populate_union_monitor (GUnionVolumeMonitor
*union_monitor
)
508 GVolumeMonitor
*monitor
;
509 GNativeVolumeMonitorClass
*native_class
;
510 GVolumeMonitorClass
*klass
;
511 GIOExtensionPoint
*ep
;
512 GIOExtension
*extension
;
515 native_class
= get_native_class ();
517 if (native_class
!= NULL
)
519 monitor
= g_object_new (G_TYPE_FROM_CLASS (native_class
), NULL
);
520 g_union_volume_monitor_add_monitor (union_monitor
, monitor
);
521 g_object_unref (monitor
);
522 g_type_class_unref (native_class
);
525 ep
= g_io_extension_point_lookup (G_VOLUME_MONITOR_EXTENSION_POINT_NAME
);
526 for (l
= g_io_extension_point_get_extensions (ep
); l
!= NULL
; l
= l
->next
)
530 klass
= G_VOLUME_MONITOR_CLASS (g_io_extension_ref_class (extension
));
531 if (klass
->is_supported
== NULL
|| klass
->is_supported())
533 monitor
= g_object_new (g_io_extension_get_type (extension
), NULL
);
534 g_union_volume_monitor_add_monitor (union_monitor
, monitor
);
535 g_object_unref (monitor
);
537 g_type_class_unref (klass
);
541 static GUnionVolumeMonitor
*
542 g_union_volume_monitor_new (void)
544 GUnionVolumeMonitor
*monitor
;
546 monitor
= g_object_new (G_TYPE_UNION_VOLUME_MONITOR
, NULL
);
552 * g_volume_monitor_get:
554 * Gets the volume monitor used by gio.
556 * Returns: (transfer full): a reference to the #GVolumeMonitor used by gio. Call
557 * g_object_unref() when done with it.
560 g_volume_monitor_get (void)
564 g_rec_mutex_lock (&the_volume_monitor_mutex
);
566 if (the_volume_monitor
)
567 vm
= G_VOLUME_MONITOR (g_object_ref (the_volume_monitor
));
570 the_volume_monitor
= g_union_volume_monitor_new ();
571 populate_union_monitor (the_volume_monitor
);
572 vm
= G_VOLUME_MONITOR (the_volume_monitor
);
575 g_rec_mutex_unlock (&the_volume_monitor_mutex
);
581 _g_mount_get_for_mount_path (const gchar
*mount_path
,
582 GCancellable
*cancellable
)
584 GNativeVolumeMonitorClass
*klass
;
587 klass
= get_native_class ();
593 if (klass
->get_mount_for_mount_path
)
594 mount
= klass
->get_mount_for_mount_path (mount_path
, cancellable
);
596 /* TODO: How do we know this succeeded? Keep in mind that the native
597 * volume monitor may fail (e.g. not being able to connect to
598 * hald). Is the get_mount_for_mount_path() method allowed to
599 * return NULL? Seems like it is ... probably the method needs
600 * to take a boolean and write if it succeeds or not.. Messy.
604 g_type_class_unref (klass
);
610 * g_volume_monitor_adopt_orphan_mount:
611 * @mount: a #GMount object to find a parent for
613 * This function should be called by any #GVolumeMonitor
614 * implementation when a new #GMount object is created that is not
615 * associated with a #GVolume object. It must be called just before
616 * emitting the @mount_added signal.
618 * If the return value is not %NULL, the caller must associate the
619 * returned #GVolume object with the #GMount. This involves returning
620 * it in its g_mount_get_volume() implementation. The caller must
621 * also listen for the "removed" signal on the returned object
622 * and give up its reference when handling that signal
624 * Similary, if implementing g_volume_monitor_adopt_orphan_mount(),
625 * the implementor must take a reference to @mount and return it in
626 * its g_volume_get_mount() implemented. Also, the implementor must
627 * listen for the "unmounted" signal on @mount and give up its
628 * reference upon handling that signal.
630 * There are two main use cases for this function.
632 * One is when implementing a user space file system driver that reads
633 * blocks of a block device that is already represented by the native
634 * volume monitor (for example a CD Audio file system driver). Such
635 * a driver will generate its own #GMount object that needs to be
636 * associated with the #GVolume object that represents the volume.
638 * The other is for implementing a #GVolumeMonitor whose sole purpose
639 * is to return #GVolume objects representing entries in the users
640 * "favorite servers" list or similar.
642 * Returns: (transfer full): the #GVolume object that is the parent for @mount or %NULL
643 * if no wants to adopt the #GMount.
645 * Deprecated: 2.20: Instead of using this function, #GVolumeMonitor
646 * implementations should instead create shadow mounts with the URI of
647 * the mount they intend to adopt. See the proxy volume monitor in
648 * gvfs for an example of this. Also see g_mount_is_shadowed(),
649 * g_mount_shadow() and g_mount_unshadow() functions.
652 g_volume_monitor_adopt_orphan_mount (GMount
*mount
)
654 GVolumeMonitor
*child_monitor
;
655 GVolumeMonitorClass
*child_monitor_class
;
659 g_return_val_if_fail (mount
!= NULL
, NULL
);
661 if (the_volume_monitor
== NULL
)
666 g_rec_mutex_lock (&the_volume_monitor_mutex
);
668 for (l
= the_volume_monitor
->monitors
; l
!= NULL
; l
= l
->next
)
670 child_monitor
= l
->data
;
671 child_monitor_class
= G_VOLUME_MONITOR_GET_CLASS (child_monitor
);
673 if (child_monitor_class
->adopt_orphan_mount
!= NULL
)
675 volume
= child_monitor_class
->adopt_orphan_mount (mount
, child_monitor
);
681 g_rec_mutex_unlock (&the_volume_monitor_mutex
);