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 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 "gsimpleasyncresult.h"
39 * @short_description: Mount management
42 * The #GMount interface represents user-visible mounts. Note, when
43 * porting from GnomeVFS, #GMount is the moral equivalent of #GnomeVFSVolume.
45 * Unmounting a #GMount instance is an asynchronous operation. For
46 * more information about asynchronous operations, see #GAsyncReady
47 * and #GSimpleAsyncReady. To unmount a #GMount instance, first call
48 * g_mount_unmount() with (at least) the #GMount instance and a
49 * #GAsyncReadyCallback. The callback will be fired when the
50 * operation has resolved (either with success or failure), and a
51 * #GAsyncReady structure will be passed to the callback. That
52 * callback should then call g_mount_unmount_finish() with the #GMount
53 * and the #GAsyncReady data to see if the operation was completed
54 * successfully. If an @error is present when g_mount_unmount_finish()
55 * is called, then it will be filled with any error information.
58 static void g_mount_base_init (gpointer g_class);
59 static void g_mount_class_init (gpointer g_class,
63 g_mount_get_type (void)
65 static GType mount_type = 0;
69 static const GTypeInfo mount_info =
71 sizeof (GMountIface), /* class_size */
72 g_mount_base_init, /* base_init */
73 NULL, /* base_finalize */
75 NULL, /* class_finalize */
76 NULL, /* class_data */
83 g_type_register_static (G_TYPE_INTERFACE, I_("GMount"),
86 g_type_interface_add_prerequisite (mount_type, G_TYPE_OBJECT);
93 g_mount_class_init (gpointer g_class,
99 g_mount_base_init (gpointer g_class)
101 static gboolean initialized = FALSE;
108 * Emitted when the mount has been changed.
110 g_signal_new (I_("changed"),
113 G_STRUCT_OFFSET (GMountIface, changed),
115 g_cclosure_marshal_VOID__VOID,
121 * This signal is emitted when the #GMount have been
122 * unmounted. If the recipient is holding references to the
123 * object they should release them so the object can be
126 g_signal_new (I_("unmounted"),
129 G_STRUCT_OFFSET (GMountIface, unmounted),
131 g_cclosure_marshal_VOID__VOID,
142 * Gets the root directory on @mount.
147 g_mount_get_root (GMount *mount)
151 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
153 iface = G_MOUNT_GET_IFACE (mount);
155 return (* iface->get_root) (mount);
162 * Gets the name of @mount.
164 * Returns: the name for the given @mount. The returned string should
165 * be freed when no longer needed.
168 g_mount_get_name (GMount *mount)
172 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
174 iface = G_MOUNT_GET_IFACE (mount);
176 return (* iface->get_name) (mount);
183 * Gets the icon for @mount.
188 g_mount_get_icon (GMount *mount)
192 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
194 iface = G_MOUNT_GET_IFACE (mount);
196 return (* iface->get_icon) (mount);
203 * Gets the UUID for the @mount. The reference is typically based on
204 * the file system UUID for the mount in question and should be
205 * considered an opaque string. Returns %NULL if there is no UUID
208 * Returns: the UUID for @mount or %NULL if no UUID can be computed.
211 g_mount_get_uuid (GMount *mount)
215 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
217 iface = G_MOUNT_GET_IFACE (mount);
219 return (* iface->get_uuid) (mount);
223 * g_mount_get_volume:
226 * Gets the volume for the @mount.
228 * Returns: a #GVolume or %NULL if @mount is not associated with a volume.
231 g_mount_get_volume (GMount *mount)
235 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
237 iface = G_MOUNT_GET_IFACE (mount);
239 return (* iface->get_volume) (mount);
246 * Gets the drive for the @mount.
248 * This is a convenience method for getting the #GVolume and then
249 * using that object to get the #GDrive.
251 * Returns: a #GDrive or %NULL if @mount is not associated with a volume or a drive.
254 g_mount_get_drive (GMount *mount)
258 g_return_val_if_fail (G_IS_MOUNT (mount), NULL);
260 iface = G_MOUNT_GET_IFACE (mount);
262 return (* iface->get_drive) (mount);
266 * g_mount_can_unmount:
269 * Checks if @mount can be mounted.
271 * Returns: %TRUE if the @mount can be unmounted.
274 g_mount_can_unmount (GMount *mount)
278 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
280 iface = G_MOUNT_GET_IFACE (mount);
282 return (* iface->can_unmount) (mount);
289 * Checks if @mount can be eject.
291 * Returns: %TRUE if the @mount can be ejected.
294 g_mount_can_eject (GMount *mount)
298 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
300 iface = G_MOUNT_GET_IFACE (mount);
302 return (* iface->can_eject) (mount);
308 * @flags: flags affecting the operation
309 * @cancellable: optional #GCancellable object, %NULL to ignore.
310 * @callback: a #GAsyncReadyCallback.
311 * @user_data: user data passed to @callback.
313 * Unmounts a mount. This is an asynchronous operation, and is
314 * finished by calling g_mount_unmount_finish() with the @mount
315 * and #GAsyncResults data returned in the @callback.
318 g_mount_unmount (GMount *mount,
319 GMountUnmountFlags flags,
320 GCancellable *cancellable,
321 GAsyncReadyCallback callback,
326 g_return_if_fail (G_IS_MOUNT (mount));
328 iface = G_MOUNT_GET_IFACE (mount);
330 if (iface->unmount == NULL)
332 g_simple_async_report_error_in_idle (G_OBJECT (mount),
334 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
335 _("mount doesn't implement unmount"));
340 (* iface->unmount) (mount, flags, cancellable, callback, user_data);
344 * g_mount_unmount_finish:
346 * @result: a #GAsyncResult.
347 * @error: a #GError location to store the error occuring, or %NULL to
350 * Finishes unmounting a mount. If any errors occured during the operation,
351 * @error will be set to contain the errors and %FALSE will be returned.
353 * Returns: %TRUE if the mount was successfully unmounted. %FALSE otherwise.
356 g_mount_unmount_finish (GMount *mount,
357 GAsyncResult *result,
362 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
363 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
365 if (G_IS_SIMPLE_ASYNC_RESULT (result))
367 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
368 if (g_simple_async_result_propagate_error (simple, error))
372 iface = G_MOUNT_GET_IFACE (mount);
373 return (* iface->unmount_finish) (mount, result, error);
380 * @flags: flags affecting the unmount if required for eject
381 * @cancellable: optional #GCancellable object, %NULL to ignore.
382 * @callback: a #GAsyncReadyCallback.
383 * @user_data: user data passed to @callback.
385 * Ejects a mount. This is an asynchronous operation, and is
386 * finished by calling g_mount_eject_finish() with the @mount
387 * and #GAsyncResults data returned in the @callback.
390 g_mount_eject (GMount *mount,
391 GMountUnmountFlags flags,
392 GCancellable *cancellable,
393 GAsyncReadyCallback callback,
398 g_return_if_fail (G_IS_MOUNT (mount));
400 iface = G_MOUNT_GET_IFACE (mount);
402 if (iface->eject == NULL)
404 g_simple_async_report_error_in_idle (G_OBJECT (mount),
406 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
407 _("mount doesn't implement eject"));
412 (* iface->eject) (mount, flags, cancellable, callback, user_data);
416 * g_mount_eject_finish:
418 * @result: a #GAsyncResult.
419 * @error: a #GError location to store the error occuring, or %NULL to
422 * Finishes ejecting a mount. If any errors occured during the operation,
423 * @error will be set to contain the errors and %FALSE will be returned.
425 * Returns: %TRUE if the mount was successfully ejected. %FALSE otherwise.
428 g_mount_eject_finish (GMount *mount,
429 GAsyncResult *result,
434 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
435 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
437 if (G_IS_SIMPLE_ASYNC_RESULT (result))
439 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
440 if (g_simple_async_result_propagate_error (simple, error))
444 iface = G_MOUNT_GET_IFACE (mount);
445 return (* iface->eject_finish) (mount, result, error);
451 * @mount_operation: a #GMountOperation or %NULL to avoid user interaction.
452 * @cancellable: optional #GCancellable object, %NULL to ignore.
453 * @callback: a #GAsyncReadyCallback.
454 * @user_data: user data passed to @callback.
456 * Remounts a mount. This is an asynchronous operation, and is
457 * finished by calling g_mount_unmount_finish() with the @mount
458 * and #GAsyncResults data returned in the @callback.
460 * Remounting is useful when some setting affecting the operation
461 * of the volume has been changed, as these may need a remount to
462 * take affect. While this is semantically equivalent with unmounting
463 * and then remounting not all backends might need to actually be
467 g_mount_remount (GMount *mount,
468 GMountOperation *mount_operation,
469 GCancellable *cancellable,
470 GAsyncReadyCallback callback,
475 g_return_if_fail (G_IS_MOUNT (mount));
477 iface = G_MOUNT_GET_IFACE (mount);
479 if (iface->remount == NULL)
481 g_simple_async_report_error_in_idle (G_OBJECT (mount),
483 G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED,
484 _("mount doesn't implement remount"));
489 (* iface->remount) (mount, mount_operation, cancellable, callback, user_data);
493 * g_mount_remount_finish:
495 * @result: a #GAsyncResult.
496 * @error: a #GError location to store the error occuring, or %NULL to
499 * Finishes remounting a mount. If any errors occured during the operation,
500 * @error will be set to contain the errors and %FALSE will be returned.
502 * Returns: %TRUE if the mount was successfully remounted. %FALSE otherwise.
505 g_mount_remount_finish (GMount *mount,
506 GAsyncResult *result,
511 g_return_val_if_fail (G_IS_MOUNT (mount), FALSE);
512 g_return_val_if_fail (G_IS_ASYNC_RESULT (result), FALSE);
514 if (G_IS_SIMPLE_ASYNC_RESULT (result))
516 GSimpleAsyncResult *simple = G_SIMPLE_ASYNC_RESULT (result);
517 if (g_simple_async_result_propagate_error (simple, error))
521 iface = G_MOUNT_GET_IFACE (mount);
522 return (* iface->remount_finish) (mount, result, error);
526 #define __G_MOUNT_C__
527 #include "gioaliasdef.c"