1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
3 /* GIO - GLib Input, Output and Streaming Library
5 * Copyright (C) 2006-2008 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 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, write to the
19 * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20 * Boston, MA 02111-1307, USA.
22 * Author: Alexander Larsson <alexl@redhat.com>
23 * David Zeuthen <davidz@redhat.com>
31 #include "gmountprivate.h"
32 #include "gasyncresult.h"
33 #include "gsimpleasyncresult.h"
40 * @short_description: Mount management
42 * @see_also: GVolume, GUnixMountEntry, GUnixMountPoint
44 * The #GMount interface represents user-visible mounts. Note, when
45 * porting from GnomeVFS, #GMount is the moral equivalent of #GnomeVFSVolume.
47 * #GMount is a "mounted" filesystem that you can access. Mounted is in
48 * quotes because it's not the same as a unix mount, it might be a gvfs
49 * mount, but you can still access the files on it if you use GIO. Might or
50 * might not be related to a volume object.
52 * Unmounting a #GMount instance is an asynchronous operation. For
53 * more information about asynchronous operations, see #GAsyncResult
54 * and #GSimpleAsyncResult. To unmount a #GMount instance, first call
55 * g_mount_unmount_with_operation() with (at least) the #GMount instance and a
56 * #GAsyncReadyCallback. The callback will be fired when the
57 * operation has resolved (either with success or failure), and a
58 * #GAsyncReady structure will be passed to the callback. That
59 * callback should then call g_mount_unmount_with_operation_finish() with the #GMount
60 * and the #GAsyncReady data to see if the operation was completed
61 * successfully. If an @error is present when g_mount_unmount_with_operation_finish()
62 * is called, then it will be filled with any error information.
65 typedef GMountIface GMountInterface;
66 G_DEFINE_INTERFACE (GMount, g_mount, G_TYPE_OBJECT)
69 g_mount_default_init (GMountInterface *iface)
73 * @mount: the object on which the signal is emitted
75 * Emitted when the mount has been changed.
77 g_signal_new (I_("changed"),
80 G_STRUCT_OFFSET (GMountIface, changed),
82 g_cclosure_marshal_VOID__VOID,
87 * @mount: the object on which the signal is emitted
89 * This signal is emitted when the #GMount have been
90 * unmounted. If the recipient is holding references to the
91 * object they should release them so the object can be
94 g_signal_new (I_("unmounted"),
97 G_STRUCT_OFFSET (GMountIface, unmounted),
99 g_cclosure_marshal_VOID__VOID,
102 * GMount::pre-unmount:
103 * @mount: the object on which the signal is emitted
105 * This signal is emitted when the #GMount is about to be
110 g_signal_new (I_("pre-unmount"),
113 G_STRUCT_OFFSET (GMountIface, pre_unmount),
115 g_cclosure_marshal_VOID__VOID,
123 * Gets the root directory on @mount.
125 * Returns: (transfer full): a #GFile.
126 * The returned object should be unreffed with
127 * g_object_unref() when no longer needed.
130 g_mount_get_root (GMount *mount)
134 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
136 iface = G_MOUNT_GET_IFACE (mount);
138 return (* iface->get_root) (mount);
142 * g_mount_get_default_location:
145 * Gets the default location of @mount. The default location of the given
146 * @mount is a path that reflects the main entry point for the user (e.g.
147 * the home directory, or the root of the volume).
149 * Returns: (transfer full): a #GFile.
150 * The returned object should be unreffed with
151 * g_object_unref() when no longer needed.
154 g_mount_get_default_location (GMount *mount)
159 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
161 iface = G_MOUNT_GET_IFACE (mount);
163 /* Fallback to get_root when default_location () is not available */
164 if (iface->get_default_location)
165 file = (* iface->get_default_location) (mount);
167 file = (* iface->get_root) (mount);
176 * Gets the name of @mount.
178 * Returns: the name for the given @mount.
179 * The returned string should be freed with g_free()
180 * when no longer needed.
183 g_mount_get_name (GMount *mount)
187 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
189 iface = G_MOUNT_GET_IFACE (mount);
191 return (* iface->get_name) (mount);
198 * Gets the icon for @mount.
200 * Returns: (transfer full): a #GIcon.
201 * The returned object should be unreffed with
202 * g_object_unref() when no longer needed.
205 g_mount_get_icon (GMount *mount)
209 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
211 iface = G_MOUNT_GET_IFACE (mount);
213 return (* iface->get_icon) (mount);
220 * Gets the UUID for the @mount. The reference is typically based on
221 * the file system UUID for the mount in question and should be
222 * considered an opaque string. Returns %NULL if there is no UUID
225 * Returns: the UUID for @mount or %NULL if no UUID can be computed.
226 * The returned string should be freed with g_free()
227 * when no longer needed.
230 g_mount_get_uuid (GMount *mount)
234 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
236 iface = G_MOUNT_GET_IFACE (mount);
238 return (* iface->get_uuid) (mount);
242 * g_mount_get_volume:
245 * Gets the volume for the @mount.
247 * Returns: (transfer full): a #GVolume or %NULL if @mount is not associated with a volume.
248 * The returned object should be unreffed with
249 * g_object_unref() when no longer needed.
252 g_mount_get_volume (GMount *mount)
256 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
258 iface = G_MOUNT_GET_IFACE (mount);
260 return (* iface->get_volume) (mount);
267 * Gets the drive for the @mount.
269 * This is a convenience method for getting the #GVolume and then
270 * using that object to get the #GDrive.
272 * Returns: (transfer full): a #GDrive or %NULL if @mount is not associated with a volume or a drive.
273 * The returned object should be unreffed with
274 * g_object_unref() when no longer needed.
277 g_mount_get_drive (GMount *mount)
281 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
283 iface = G_MOUNT_GET_IFACE (mount);
285 return (* iface->get_drive) (mount);
289 * g_mount_can_unmount:
292 * Checks if @mount can be mounted.
294 * Returns: %TRUE if the @mount can be unmounted.
297 g_mount_can_unmount (GMount *mount)
301 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
303 iface = G_MOUNT_GET_IFACE (mount);
305 return (* iface->can_unmount) (mount);
312 * Checks if @mount can be eject.
314 * Returns: %TRUE if the @mount can be ejected.
317 g_mount_can_eject (GMount *mount)
321 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
323 iface = G_MOUNT_GET_IFACE (mount);
325 return (* iface->can_eject) (mount);
331 * @flags: flags affecting the operation
332 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
333 * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL.
334 * @user_data: user data passed to @callback.
336 * Unmounts a mount. This is an asynchronous operation, and is
337 * finished by calling g_mount_unmount_finish() with the @mount
338 * and #GAsyncResult data returned in the @callback.
340 * Deprecated: 2.22: Use g_mount_unmount_with_operation() instead.
343 g_mount_unmount (GMount *mount,
344 GMountUnmountFlags flags,
345 GCancellable *cancellable,
346 GAsyncReadyCallback callback,
351 g_return_if_fail (G_IS_MOUNT (mount));
353 iface = G_MOUNT_GET_IFACE (mount);
355 if (iface->unmount == NULL)
357 g_simple_async_report_error_in_idle (G_OBJECT (mount),
359 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
360 /* Translators: This is an error
361 * message for mount objects that
362 * don't implement unmount. */
363 _("mount doesn't implement \"unmount\""));
368 (* iface->unmount) (mount, flags, cancellable, callback, user_data);
372 * g_mount_unmount_finish:
374 * @result: a #GAsyncResult.
375 * @error: a #GError location to store the error occurring, or %NULL to
378 * Finishes unmounting a mount. If any errors occurred during the operation,
379 * @error will be set to contain the errors and %FALSE will be returned.
381 * Returns: %TRUE if the mount was successfully unmounted. %FALSE otherwise.
383 * Deprecated: 2.22: Use g_mount_unmount_with_operation_finish() instead.
386 g_mount_unmount_finish (GMount *mount,
387 GAsyncResult *result,
392 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
393 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
395 if (g_async_result_legacy_propagate_error (result, error))
398 iface = G_MOUNT_GET_IFACE (mount);
399 return (* iface->unmount_finish) (mount, result, error);
406 * @flags: flags affecting the unmount if required for eject
407 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
408 * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL.
409 * @user_data: user data passed to @callback.
411 * Ejects a mount. This is an asynchronous operation, and is
412 * finished by calling g_mount_eject_finish() with the @mount
413 * and #GAsyncResult data returned in the @callback.
415 * Deprecated: 2.22: Use g_mount_eject_with_operation() instead.
418 g_mount_eject (GMount *mount,
419 GMountUnmountFlags flags,
420 GCancellable *cancellable,
421 GAsyncReadyCallback callback,
426 g_return_if_fail (G_IS_MOUNT (mount));
428 iface = G_MOUNT_GET_IFACE (mount);
430 if (iface->eject == NULL)
432 g_simple_async_report_error_in_idle (G_OBJECT (mount),
434 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
435 /* Translators: This is an error
436 * message for mount objects that
437 * don't implement eject. */
438 _("mount doesn't implement \"eject\""));
443 (* iface->eject) (mount, flags, cancellable, callback, user_data);
447 * g_mount_eject_finish:
449 * @result: a #GAsyncResult.
450 * @error: a #GError location to store the error occurring, or %NULL to
453 * Finishes ejecting a mount. If any errors occurred during the operation,
454 * @error will be set to contain the errors and %FALSE will be returned.
456 * Returns: %TRUE if the mount was successfully ejected. %FALSE otherwise.
458 * Deprecated: 2.22: Use g_mount_eject_with_operation_finish() instead.
461 g_mount_eject_finish (GMount *mount,
462 GAsyncResult *result,
467 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
468 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
470 if (g_async_result_legacy_propagate_error (result, error))
473 iface = G_MOUNT_GET_IFACE (mount);
474 return (* iface->eject_finish) (mount, result, error);
478 * g_mount_unmount_with_operation:
480 * @flags: flags affecting the operation
481 * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid
483 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
484 * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL.
485 * @user_data: user data passed to @callback.
487 * Unmounts a mount. This is an asynchronous operation, and is
488 * finished by calling g_mount_unmount_with_operation_finish() with the @mount
489 * and #GAsyncResult data returned in the @callback.
494 g_mount_unmount_with_operation (GMount *mount,
495 GMountUnmountFlags flags,
496 GMountOperation *mount_operation,
497 GCancellable *cancellable,
498 GAsyncReadyCallback callback,
503 g_return_if_fail (G_IS_MOUNT (mount));
505 iface = G_MOUNT_GET_IFACE (mount);
507 if (iface->unmount == NULL && iface->unmount_with_operation == NULL)
509 g_simple_async_report_error_in_idle (G_OBJECT (mount),
511 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
512 /* Translators: This is an error
513 * message for mount objects that
514 * don't implement any of unmount or unmount_with_operation. */
515 _("mount doesn't implement \"unmount\" or \"unmount_with_operation\""));
520 if (iface->unmount_with_operation != NULL)
521 (* iface->unmount_with_operation) (mount, flags, mount_operation, cancellable, callback, user_data);
523 (* iface->unmount) (mount, flags, cancellable, callback, user_data);
527 * g_mount_unmount_with_operation_finish:
529 * @result: a #GAsyncResult.
530 * @error: a #GError location to store the error occurring, or %NULL to
533 * Finishes unmounting a mount. If any errors occurred during the operation,
534 * @error will be set to contain the errors and %FALSE will be returned.
536 * Returns: %TRUE if the mount was successfully unmounted. %FALSE otherwise.
541 g_mount_unmount_with_operation_finish (GMount *mount,
542 GAsyncResult *result,
547 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
548 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
550 if (g_async_result_legacy_propagate_error (result, error))
553 iface = G_MOUNT_GET_IFACE (mount);
554 if (iface->unmount_with_operation_finish != NULL)
555 return (* iface->unmount_with_operation_finish) (mount, result, error);
557 return (* iface->unmount_finish) (mount, result, error);
562 * g_mount_eject_with_operation:
564 * @flags: flags affecting the unmount if required for eject
565 * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid
567 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
568 * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL.
569 * @user_data: user data passed to @callback.
571 * Ejects a mount. This is an asynchronous operation, and is
572 * finished by calling g_mount_eject_with_operation_finish() with the @mount
573 * and #GAsyncResult data returned in the @callback.
578 g_mount_eject_with_operation (GMount *mount,
579 GMountUnmountFlags flags,
580 GMountOperation *mount_operation,
581 GCancellable *cancellable,
582 GAsyncReadyCallback callback,
587 g_return_if_fail (G_IS_MOUNT (mount));
589 iface = G_MOUNT_GET_IFACE (mount);
591 if (iface->eject == NULL && iface->eject_with_operation == NULL)
593 g_simple_async_report_error_in_idle (G_OBJECT (mount),
595 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
596 /* Translators: This is an error
597 * message for mount objects that
598 * don't implement any of eject or eject_with_operation. */
599 _("mount doesn't implement \"eject\" or \"eject_with_operation\""));
603 if (iface->eject_with_operation != NULL)
604 (* iface->eject_with_operation) (mount, flags, mount_operation, cancellable, callback, user_data);
606 (* iface->eject) (mount, flags, cancellable, callback, user_data);
610 * g_mount_eject_with_operation_finish:
612 * @result: a #GAsyncResult.
613 * @error: a #GError location to store the error occurring, or %NULL to
616 * Finishes ejecting a mount. If any errors occurred during the operation,
617 * @error will be set to contain the errors and %FALSE will be returned.
619 * Returns: %TRUE if the mount was successfully ejected. %FALSE otherwise.
624 g_mount_eject_with_operation_finish (GMount *mount,
625 GAsyncResult *result,
630 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
631 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
633 if (g_async_result_legacy_propagate_error (result, error))
636 iface = G_MOUNT_GET_IFACE (mount);
637 if (iface->eject_with_operation_finish != NULL)
638 return (* iface->eject_with_operation_finish) (mount, result, error);
640 return (* iface->eject_finish) (mount, result, error);
646 * @flags: flags affecting the operation
647 * @mount_operation: (allow-none): a #GMountOperation or %NULL to avoid
649 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore.
650 * @callback: (allow-none): a #GAsyncReadyCallback, or %NULL.
651 * @user_data: user data passed to @callback.
653 * Remounts a mount. This is an asynchronous operation, and is
654 * finished by calling g_mount_remount_finish() with the @mount
655 * and #GAsyncResults data returned in the @callback.
657 * Remounting is useful when some setting affecting the operation
658 * of the volume has been changed, as these may need a remount to
659 * take affect. While this is semantically equivalent with unmounting
660 * and then remounting not all backends might need to actually be
664 g_mount_remount (GMount *mount,
665 GMountMountFlags flags,
666 GMountOperation *mount_operation,
667 GCancellable *cancellable,
668 GAsyncReadyCallback callback,
673 g_return_if_fail (G_IS_MOUNT (mount));
675 iface = G_MOUNT_GET_IFACE (mount);
677 if (iface->remount == NULL)
679 g_simple_async_report_error_in_idle (G_OBJECT (mount),
681 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
682 /* Translators: This is an error
683 * message for mount objects that
684 * don't implement remount. */
685 _("mount doesn't implement \"remount\""));
690 (* iface->remount) (mount, flags, mount_operation, cancellable, callback, user_data);
694 * g_mount_remount_finish:
696 * @result: a #GAsyncResult.
697 * @error: a #GError location to store the error occurring, or %NULL to
700 * Finishes remounting a mount. If any errors occurred during the operation,
701 * @error will be set to contain the errors and %FALSE will be returned.
703 * Returns: %TRUE if the mount was successfully remounted. %FALSE otherwise.
706 g_mount_remount_finish (GMount *mount,
707 GAsyncResult *result,
712 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
713 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
715 if (g_async_result_legacy_propagate_error (result, error))
718 iface = G_MOUNT_GET_IFACE (mount);
719 return (* iface->remount_finish) (mount, result, error);
723 * g_mount_guess_content_type:
725 * @force_rescan: Whether to force a rescan of the content.
726 * Otherwise a cached result will be used if available
727 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
728 * @callback: a #GAsyncReadyCallback
729 * @user_data: user data passed to @callback
731 * Tries to guess the type of content stored on @mount. Returns one or
732 * more textual identifiers of well-known content types (typically
733 * prefixed with "x-content/"), e.g. x-content/image-dcf for camera
734 * memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
735 * specification for more on x-content types.
737 * This is an asynchronous operation (see
738 * g_mount_guess_content_type_sync() for the synchronous version), and
739 * is finished by calling g_mount_guess_content_type_finish() with the
740 * @mount and #GAsyncResult data returned in the @callback.
745 g_mount_guess_content_type (GMount *mount,
746 gboolean force_rescan,
747 GCancellable *cancellable,
748 GAsyncReadyCallback callback,
753 g_return_if_fail (G_IS_MOUNT (mount));
755 iface = G_MOUNT_GET_IFACE (mount);
757 if (iface->guess_content_type == NULL)
759 g_simple_async_report_error_in_idle (G_OBJECT (mount),
761 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
762 /* Translators: This is an error
763 * message for mount objects that
764 * don't implement content type guessing. */
765 _("mount doesn't implement content type guessing"));
770 (* iface->guess_content_type) (mount, force_rescan, cancellable, callback, user_data);
774 * g_mount_guess_content_type_finish:
776 * @result: a #GAsyncResult
777 * @error: a #GError location to store the error occurring, or %NULL to
780 * Finishes guessing content types of @mount. If any errors occurred
781 * during the operation, @error will be set to contain the errors and
782 * %FALSE will be returned. In particular, you may get an
783 * %G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
786 * Returns: (transfer full) (element-type utf8): a %NULL-terminated array of content types or %NULL on error.
787 * Caller should free this array with g_strfreev() when done with it.
792 g_mount_guess_content_type_finish (GMount *mount,
793 GAsyncResult *result,
798 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
799 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), NULL);
801 if (g_async_result_legacy_propagate_error (result, error))
804 iface = G_MOUNT_GET_IFACE (mount);
805 return (* iface->guess_content_type_finish) (mount, result, error);
809 * g_mount_guess_content_type_sync:
811 * @force_rescan: Whether to force a rescan of the content.
812 * Otherwise a cached result will be used if available
813 * @cancellable: (allow-none): optional #GCancellable object, %NULL to ignore
814 * @error: a #GError location to store the error occurring, or %NULL to
817 * Tries to guess the type of content stored on @mount. Returns one or
818 * more textual identifiers of well-known content types (typically
819 * prefixed with "x-content/"), e.g. x-content/image-dcf for camera
820 * memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink>
821 * specification for more on x-content types.
823 * This is an synchronous operation and as such may block doing IO;
824 * see g_mount_guess_content_type() for the asynchronous version.
826 * Returns: (transfer full) (element-type utf8): a %NULL-terminated array of content types or %NULL on error.
827 * Caller should free this array with g_strfreev() when done with it.
832 g_mount_guess_content_type_sync (GMount *mount,
833 gboolean force_rescan,
834 GCancellable *cancellable,
839 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
841 iface = G_MOUNT_GET_IFACE (mount);
843 if (iface->guess_content_type_sync == NULL)
845 g_set_error_literal (error,
846 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
847 /* Translators: This is an error
848 * message for mount objects that
849 * don't implement content type guessing. */
850 _("mount doesn't implement synchronous content type guessing"));
855 return (* iface->guess_content_type_sync) (mount, force_rescan, cancellable, error);
858 G_LOCK_DEFINE_STATIC (priv_lock);
860 /* only access this structure when holding priv_lock */
863 gint shadow_ref_count;
867 free_private (GMountPrivate *private)
871 G_UNLOCK (priv_lock);
874 /* may only be called when holding priv_lock */
875 static GMountPrivate *
876 get_private (GMount *mount)
878 GMountPrivate *private;
880 private = g_object_get_data (G_OBJECT (mount), "g-mount-private");
881 if (G_LIKELY (private != NULL))
884 private = g_new0 (GMountPrivate, 1);
885 g_object_set_data_full (G_OBJECT (mount),
888 (GDestroyNotify) free_private);
895 * g_mount_is_shadowed:
898 * Determines if @mount is shadowed. Applications or libraries should
899 * avoid displaying @mount in the user interface if it is shadowed.
901 * A mount is said to be shadowed if there exists one or more user
902 * visible objects (currently #GMount objects) with a root that is
903 * inside the root of @mount.
905 * One application of shadow mounts is when exposing a single file
906 * system that is used to address several logical volumes. In this
907 * situation, a #GVolumeMonitor implementation would create two
908 * #GVolume objects (for example, one for the camera functionality of
909 * the device and one for a SD card reader on the device) with
910 * activation URIs <literal>gphoto2://[usb:001,002]/store1/</literal>
911 * and <literal>gphoto2://[usb:001,002]/store2/</literal>. When the
912 * underlying mount (with root
913 * <literal>gphoto2://[usb:001,002]/</literal>) is mounted, said
914 * #GVolumeMonitor implementation would create two #GMount objects
915 * (each with their root matching the corresponding volume activation
916 * root) that would shadow the original mount.
918 * The proxy monitor in GVfs 2.26 and later, automatically creates and
919 * manage shadow mounts (and shadows the underlying mount) if the
920 * activation root on a #GVolume is set.
922 * Returns: %TRUE if @mount is shadowed.
927 g_mount_is_shadowed (GMount *mount)
932 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
935 priv = get_private (mount);
936 ret = (priv->shadow_ref_count > 0);
937 G_UNLOCK (priv_lock);
946 * Increments the shadow count on @mount. Usually used by
947 * #GVolumeMonitor implementations when creating a shadow mount for
948 * @mount, see g_mount_is_shadowed() for more information. The caller
949 * will need to emit the #GMount::changed signal on @mount manually.
954 g_mount_shadow (GMount *mount)
958 g_return_if_fail (G_IS_MOUNT (mount));
961 priv = get_private (mount);
962 priv->shadow_ref_count += 1;
963 G_UNLOCK (priv_lock);
970 * Decrements the shadow count on @mount. Usually used by
971 * #GVolumeMonitor implementations when destroying a shadow mount for
972 * @mount, see g_mount_is_shadowed() for more information. The caller
973 * will need to emit the #GMount::changed signal on @mount manually.
978 g_mount_unshadow (GMount *mount)
982 g_return_if_fail (G_IS_MOUNT (mount));
985 priv = get_private (mount);
986 priv->shadow_ref_count -= 1;
987 if (priv->shadow_ref_count < 0)
988 g_warning ("Shadow ref count on GMount is negative");
989 G_UNLOCK (priv_lock);
993 * g_mount_get_sort_key:
996 * Gets the sort key for @mount, if any.
998 * Returns: Sorting key for @mount or %NULL if no such key is available.
1003 g_mount_get_sort_key (GMount *mount)
1005 const gchar *ret = NULL;
1008 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
1010 iface = G_MOUNT_GET_IFACE (mount);
1011 if (iface->get_sort_key != NULL)
1012 ret = iface->get_sort_key (mount);