Back to Seed Clases

Gio

Classes

Interfaces

Structs

Unions

Enums

Interface Gio.Mount

Import line:	Gio = imports.gi.Gio;
GIR File:	Gio-2.0.gir
C documentation:	GMount
Interface :	Mount

The GMount interface represents user-visible mounts. Note, when
porting from GnomeVFS, GMount is the moral equivalent of GnomeVFSVolume.
GMount is a "mounted" filesystem that you can access. Mounted is in
quotes because it's not the same as a unix mount, it might be a gvfs
mount, but you can still access the files on it if you use GIO. Might or
might not be related to a volume object.
Unmounting a GMount instance is an asynchronous operation. For
more information about asynchronous operations, see GAsyncReady
and GSimpleAsyncReady. To unmount a GMount instance, first call
g_mount_unmount_with_operation() with (at least) the GMount instance and a
GAsyncReadyCallback. The callback will be fired when the
operation has resolved (either with success or failure), and a
GAsyncReady structure will be passed to the callback. That
callback should then call g_mount_unmount_with_operation_finish() with the GMount
and the GAsyncReady data to see if the operation was completed
successfully. If an error is present when g_mount_unmount_with_operation_finish()
is called, then it will be filled with any error information.

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	can_eject () : gboolean Checks if mount can be eject. Checks if mount can be eject. Returns: gboolean TRUE if the mount can be ejected.	Gio.Mount
	can_unmount () : gboolean Checks if mount can be mounted. Checks if mount can be mounted. Returns: gboolean TRUE if the mount can be unmounted.	Gio.Mount
	eject (MountUnmountFlags *flags, Cancellable cancellable, Function callback, void *user_data) : none Ejects a mount. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_finish() with the mount* and GAsyncResult data returned in the callback. Parameters: Gio.MountUnmountFlags flags Required (not null) flags affecting the unmount if required for eject Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none a GAsyncReadyCallback, or NULL. void user_data Required (not null) user data passed to callback. Returns: none	Gio.Mount
	eject_finish (AsyncResult *result) : gboolean Finishes ejecting a mount. Finishes ejecting a mount. If any errors occurred during the operation, Parameters: Gio.AsyncResult result* Required (not null) a GAsyncResult. Returns: gboolean TRUE if the mount was successfully ejected. FALSE otherwise.	Gio.Mount
	eject_with_operation (MountUnmountFlags *flags, MountOperation mount_operation, Cancellable cancellable, Function callback, void *user_data) : none Ejects a mount. Ejects a mount. This is an asynchronous operation, and is finished by calling g_mount_eject_with_operation_finish() with the mount* and GAsyncResult data returned in the callback. Parameters: Gio.MountUnmountFlags flags Required (not null) flags affecting the unmount if required for eject Gio.MountOperation mount_operation a GMountOperation or NULL to avoid user interaction. Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none a GAsyncReadyCallback, or NULL. void user_data Required (not null) user data passed to callback. Returns: none	Gio.Mount
	eject_with_operation_finish (AsyncResult *result) : gboolean Finishes ejecting a mount. Finishes ejecting a mount. If any errors occurred during the operation, Parameters: Gio.AsyncResult result* Required (not null) a GAsyncResult. Returns: gboolean TRUE if the mount was successfully ejected. FALSE otherwise.	Gio.Mount
	get_default_location () : Gio.File Gets the default location of mount. Gets the default location of mount. The default location of the given the home directory, or the root of the volume). The returned object should be unreffed with g_object_unref() when no longer needed. Returns: Gio.File a GFile.	Gio.Mount
	get_drive () : Gio.Drive Gets the drive for the mount. Gets the drive for the mount. This is a convenience method for getting the GVolume and then using that object to get the GDrive. The returned object should be unreffed with g_object_unref() when no longer needed. Returns: Gio.Drive a GDrive or NULL if mount is not associated with a volume or a drive.	Gio.Mount
	get_icon () : Gio.Icon Gets the icon for mount. Gets the icon for mount. The returned object should be unreffed with g_object_unref() when no longer needed. Returns: Gio.Icon a GIcon.	Gio.Mount
	get_name () : String Gets the name of mount. Gets the name of mount. The returned string should be freed with g_free() when no longer needed. Returns: String the name for the given mount.	Gio.Mount
	get_root () : Gio.File Gets the root directory on mount. Gets the root directory on mount. The returned object should be unreffed with g_object_unref() when no longer needed. Returns: Gio.File a GFile.	Gio.Mount
	get_uuid () : String Gets the UUID for the mount. Gets the UUID for the mount. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns NULL if there is no UUID available. The returned string should be freed with g_free() when no longer needed. Returns: String the UUID for mount or NULL if no UUID can be computed.	Gio.Mount
	get_volume () : Gio.Volume Gets the volume for the mount. Gets the volume for the mount. The returned object should be unreffed with g_object_unref() when no longer needed. Returns: Gio.Volume a GVolume or NULL if mount is not associated with a volume.	Gio.Mount
	guess_content_type (gboolean *force_rescan, Cancellable cancellable, Function callback, void *user_data) : none Tries to guess the type of content stored on mount. Tries to guess the type of content stored on mount. Returns one or more textual identifiers of well-known content types (typically prefixed with "x-content/"), e.g. x-content/image-dcf for camera memory cards. See the shared-mime-info specification for more on x-content types. This is an asynchronous operation (see g_mount_guess_content_type_sync() for the synchronous version), and is finished by calling g_mount_guess_content_type_finish() with the Parameters: gboolean force_rescan* Required (not null) Whether to force a rescan of the content. Otherwise a cached result will be used if available Gio.Cancellable cancellable optional GCancellable object, NULL to ignore Function (Object *source_object, AsyncResult res, void *user_data) : none Required (not null) a GAsyncReadyCallback* void* user_data Required (not null) user data passed to callback Returns: none	Gio.Mount
	guess_content_type_finish (AsyncResult *result) : Array Finishes guessing content types of mount. Finishes guessing content types of mount. If any errors occured during the operation, error* will be set to contain the errors and FALSE will be returned. In particular, you may get an G_IO_ERROR_NOT_SUPPORTED if the mount does not support content guessing. Caller should free this array with g_strfreev() when done with it. Parameters: Gio.AsyncResult result Required (not null) a GAsyncResult Returns: Array a NULL-terminated array of content types or NULL on error.	Gio.Mount
	guess_content_type_sync (gboolean *force_rescan, Cancellable cancellable) : Array Tries to guess the type of content stored on mount. Tries to guess the type of content stored on mount. Returns one or more textual identifiers of well-known content types (typically prefixed with "x-content/"), e.g. x-content/image-dcf for camera memory cards. See the shared-mime-info specification for more on x-content types. This is an synchronous operation and as such may block doing IO; see g_mount_guess_content_type() for the asynchronous version. Caller should free this array with g_strfreev() when done with it. Parameters: gboolean force_rescan* Required (not null) Whether to force a rescan of the content. Otherwise a cached result will be used if available Gio.Cancellable cancellable optional GCancellable object, NULL to ignore Returns: Array a NULL-terminated array of content types or NULL on error.	Gio.Mount
	is_shadowed () : gboolean Determines if mount is shadowed. Determines if mount is shadowed. Applications or libraries should avoid displaying mount in the user interface if it is shadowed. A mount is said to be shadowed if there exists one or more user visible objects (currently GMount objects) with a root that is inside the root of mount. One application of shadow mounts is when exposing a single file system that is used to address several logical volumes. In this situation, a GVolumeMonitor implementation would create two GVolume objects (for example, one for the camera functionality of the device and one for a SD card reader on the device) with activation URIs gphoto2://[usb:001,002]/store1/ and gphoto2://[usb:001,002]/store2/. When the underlying mount (with root gphoto2://[usb:001,002]/) is mounted, said GVolumeMonitor implementation would create two GMount objects (each with their root matching the corresponding volume activation root) that would shadow the original mount. The proxy monitor in GVfs 2.26 and later, automatically creates and manage shadow mounts (and shadows the underlying mount) if the activation root on a GVolume is set. Returns: gboolean TRUE if mount is shadowed.	Gio.Mount
	remount (MountMountFlags *flags, MountOperation mount_operation, Cancellable cancellable, Function callback, void *user_data) : none Remounts a mount. Remounts a mount. This is an asynchronous operation, and is finished by calling g_mount_remount_finish() with the mount* and GAsyncResults data returned in the callback. Remounting is useful when some setting affecting the operation of the volume has been changed, as these may need a remount to take affect. While this is semantically equivalent with unmounting and then remounting not all backends might need to actually be unmounted. Parameters: Gio.MountMountFlags flags Required (not null) flags affecting the operation Gio.MountOperation mount_operation a GMountOperation or NULL to avoid user interaction. Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none a GAsyncReadyCallback, or NULL. void user_data Required (not null) user data passed to callback. Returns: none	Gio.Mount
	remount_finish (AsyncResult *result) : gboolean Finishes remounting a mount. Finishes remounting a mount. If any errors occurred during the operation, Parameters: Gio.AsyncResult result* Required (not null) a GAsyncResult. Returns: gboolean TRUE if the mount was successfully remounted. FALSE otherwise.	Gio.Mount
	shadow () : none Increments the shadow count on mount. Increments the shadow count on mount. Usually used by GVolumeMonitor implementations when creating a shadow mount for will need to emit the GMount::changed signal on mount manually. Returns: none	Gio.Mount
	unmount (MountUnmountFlags *flags, Cancellable cancellable, Function callback, void *user_data) : none Unmounts a mount. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_finish() with the mount* and GAsyncResult data returned in the callback. Parameters: Gio.MountUnmountFlags flags Required (not null) flags affecting the operation Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none a GAsyncReadyCallback, or NULL. void user_data Required (not null) user data passed to callback. Returns: none	Gio.Mount
	unmount_finish (AsyncResult *result) : gboolean Finishes unmounting a mount. Finishes unmounting a mount. If any errors occurred during the operation, Parameters: Gio.AsyncResult result* Required (not null) a GAsyncResult. Returns: gboolean TRUE if the mount was successfully unmounted. FALSE otherwise.	Gio.Mount
	unmount_with_operation (MountUnmountFlags *flags, MountOperation mount_operation, Cancellable cancellable, Function callback, void *user_data) : none Unmounts a mount. Unmounts a mount. This is an asynchronous operation, and is finished by calling g_mount_unmount_with_operation_finish() with the mount* and GAsyncResult data returned in the callback. Parameters: Gio.MountUnmountFlags flags Required (not null) flags affecting the operation Gio.MountOperation mount_operation a GMountOperation or NULL to avoid user interaction. Gio.Cancellable cancellable optional GCancellable object, NULL to ignore. Function (Object *source_object, AsyncResult res, void *user_data) : none a GAsyncReadyCallback, or NULL. void user_data Required (not null) user data passed to callback. Returns: none	Gio.Mount
	unmount_with_operation_finish (AsyncResult *result) : gboolean Finishes unmounting a mount. Finishes unmounting a mount. If any errors occurred during the operation, Parameters: Gio.AsyncResult result* Required (not null) a GAsyncResult. Returns: gboolean TRUE if the mount was successfully unmounted. FALSE otherwise.	Gio.Mount
	unshadow () : none Decrements the shadow count on mount. Decrements the shadow count on mount. Usually used by GVolumeMonitor implementations when destroying a shadow mount for will need to emit the GMount::changed signal on mount manually. Returns: none	Gio.Mount

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	changed (Mount *self) : none Emitted when the mount has been changed. Emitted when the mount has been changed. Parameters: Gio.Mount self* Returns: {none}	Gio.Mount
	pre_unmount (Mount *self) : none This signal is emitted when the GMount* is about to be unmounted. This signal is emitted when the GMount is about to be unmounted. Parameters: Gio.Mount self Returns: {none}	Gio.Mount
	unmounted (Mount *self) : none This signal is emitted when the GMount* have been unmounted. This signal is emitted when the GMount have been unmounted. If the recipient is holding references to the object they should release them so the object can be finalized. Parameters: Gio.Mount self Returns: {none}	Gio.Mount

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gio.File Method	find_enclosing_mount (Cancellable *cancellable) : Gio.Mount Gets a GMount* for the GFile.
Gio.File Method	find_enclosing_mount_finish (AsyncResult *res*) : Gio.Mount Finishes an asynchronous find mount request.
Gio.Volume Method	get_mount () : Gio.Mount Gets the mount for the volume.
Gio.VolumeMonitor Signal	mount_added (VolumeMonitor *self, Mount mount*) : none Emitted when a mount is added.
Gio.VolumeMonitor Signal	mount_changed (VolumeMonitor *self, Mount mount*) : none Emitted when a mount changes.
Gio.VolumeMonitor Signal	mount_pre_unmount (VolumeMonitor *self, Mount mount*) : none Emitted when a mount is about to be removed.
Gio.VolumeMonitor Signal	mount_removed (VolumeMonitor *self, Mount mount*) : none Emitted when a mount is removed.
Gio.VolumeMonitor Method	Gio.VolumeMonitor.adopt_orphan_mount (Mount *mount) : Gio.Volume This function should be called by any GVolumeMonitor* implementation when a new GMount object is created that is not associated with a GVolume object.
Gio.VolumeMonitor Method	get_mount_for_uuid (String *uuid) : Gio.Mount Finds a GMount* object by its UUID (see g_mount_get_uuid()) Free the returned object with g_object_unref().