MountT

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 GAsyncResult and GTask. 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.

template MountT (

TStruct

) {

protected

GMount* gMount;

GMount* getMountTStruct();

int[string] connectedSignals;

void delegate(MountIF)[] _onChangedListeners;

void delegate(MountIF)[] onChangedListeners [@property getter];

void addOnChanged(void delegate(MountIF) dlg, ConnectFlags connectFlags);

static void callBackChanged(GMount* mountStruct, MountIF _mountIF);

void delegate(MountIF)[] _onPreUnmountListeners;

void delegate(MountIF)[] onPreUnmountListeners [@property getter];

void addOnPreUnmount(void delegate(MountIF) dlg, ConnectFlags connectFlags);

static void callBackPreUnmount(GMount* mountStruct, MountIF _mountIF);

void delegate(MountIF)[] _onUnmountedListeners;

void delegate(MountIF)[] onUnmountedListeners [@property getter];

void addOnUnmounted(void delegate(MountIF) dlg, ConnectFlags connectFlags);

static void callBackUnmounted(GMount* mountStruct, MountIF _mountIF);

string getName();

string getUuid();

IconIF getIcon();

IconIF getSymbolicIcon();

DriveIF getDrive();

File getRoot();

VolumeIF getVolume();

File getDefaultLocation();

int canUnmount();

void unmount(GMountUnmountFlags flags, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

int unmountFinish(AsyncResultIF result);

void unmountWithOperation(GMountUnmountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

int unmountWithOperationFinish(AsyncResultIF result);

void remount(GMountMountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

int remountFinish(AsyncResultIF result);

int canEject();

void eject(GMountUnmountFlags flags, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

int ejectFinish(AsyncResultIF result);

void ejectWithOperation(GMountUnmountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

int ejectWithOperationFinish(AsyncResultIF result);

void guessContentType(int forceRescan, Cancellable cancellable, GAsyncReadyCallback callback, void* userData);

string[] guessContentTypeFinish(AsyncResultIF result);

string[] guessContentTypeSync(int forceRescan, Cancellable cancellable);

int isShadowed();

void shadow();

void unshadow();

string getSortKey();

}

Members

Functions

addOnChanged void addOnChanged(void delegate(MountIF) dlg, ConnectFlags connectFlags): Emitted when the mount has been changed.
addOnPreUnmount void addOnPreUnmount(void delegate(MountIF) dlg, ConnectFlags connectFlags): This signal is emitted when the GMount is about to be unmounted. Since 2.22
addOnUnmounted void addOnUnmounted(void delegate(MountIF) dlg, ConnectFlags connectFlags): 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. See Also GVolume, GUnixMountEntry, GUnixMountPoint
canEject int canEject(): Checks if mount can be eject.
canUnmount int canUnmount(): Checks if mount can be mounted.
eject void eject(GMountUnmountFlags flags, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): Warning g_mount_eject has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_eject_with_operation() instead. 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.
ejectFinish int ejectFinish(AsyncResultIF result): Warning g_mount_eject_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_eject_with_operation_finish() instead. Finishes ejecting a mount. If any errors occurred during the operation, error will be set to contain the errors and FALSE will be returned.
ejectWithOperation void ejectWithOperation(GMountUnmountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): 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. Since 2.22
ejectWithOperationFinish int ejectWithOperationFinish(AsyncResultIF result): Finishes ejecting a mount. If any errors occurred during the operation, error will be set to contain the errors and FALSE will be returned. Since 2.22
getDefaultLocation File getDefaultLocation(): Gets the default location of mount. The default location of the given mount is a path that reflects the main entry point for the user (e.g. the home directory, or the root of the volume).
getDrive DriveIF getDrive(): Gets the drive for the mount. This is a convenience method for getting the GVolume and then using that object to get the GDrive.
getIcon IconIF getIcon(): Gets the icon for mount.
getMountTStruct GMount* getMountTStruct(): Undocumented in source. Be warned that the author may not have intended to support it.
getName string getName(): Gets the name of mount.
getRoot File getRoot(): Gets the root directory on mount.
getSortKey string getSortKey(): Gets the sort key for mount, if any. Since 2.32 Signal Details The "changed" signal void user_function (GMount *mount, gpointer user_data) : Run Last Emitted when the mount has been changed.
getSymbolicIcon IconIF getSymbolicIcon(): Gets the symbolic icon for mount. Since 2.34
getUuid string getUuid(): 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.
getVolume VolumeIF getVolume(): Gets the volume for the mount.
guessContentType void guessContentType(int forceRescan, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): 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 mount and GAsyncResult data returned in the callback. Since 2.18
guessContentTypeFinish string[] guessContentTypeFinish(AsyncResultIF result): Finishes guessing content types of mount. If any errors occurred 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. Since 2.18
guessContentTypeSync string[] guessContentTypeSync(int forceRescan, Cancellable cancellable): 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. Since 2.18
isShadowed int isShadowed(): 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. Since 2.20
remount void remount(GMountMountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): 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.
remountFinish int remountFinish(AsyncResultIF result): Finishes remounting a mount. If any errors occurred during the operation, error will be set to contain the errors and FALSE will be returned.
shadow void shadow(): Increments the shadow count on mount. Usually used by GVolumeMonitor implementations when creating a shadow mount for mount, see g_mount_is_shadowed() for more information. The caller will need to emit the "changed" signal on mount manually. Since 2.20
unmount void unmount(GMountUnmountFlags flags, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): Warning g_mount_unmount has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_unmount_with_operation() instead. 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.
unmountFinish int unmountFinish(AsyncResultIF result): Warning g_mount_unmount_finish has been deprecated since version 2.22 and should not be used in newly-written code. Use g_mount_unmount_with_operation_finish() instead. Finishes unmounting a mount. If any errors occurred during the operation, error will be set to contain the errors and FALSE will be returned.
unmountWithOperation void unmountWithOperation(GMountUnmountFlags flags, MountOperation mountOperation, Cancellable cancellable, GAsyncReadyCallback callback, void* userData): 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. Since 2.22
unmountWithOperationFinish int unmountWithOperationFinish(AsyncResultIF result): Finishes unmounting a mount. If any errors occurred during the operation, error will be set to contain the errors and FALSE will be returned. Since 2.22
unshadow void unshadow(): Decrements the shadow count on mount. Usually used by GVolumeMonitor implementations when destroying a shadow mount for mount, see g_mount_is_shadowed() for more information. The caller will need to emit the "changed" signal on mount manually. Since 2.20

Properties

onChangedListeners void delegate(MountIF)[] onChangedListeners [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.
onPreUnmountListeners void delegate(MountIF)[] onPreUnmountListeners [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.
onUnmountedListeners void delegate(MountIF)[] onUnmountedListeners [@property getter]: Undocumented in source. Be warned that the author may not have intended to support it.

Static functions

callBackChanged void callBackChanged(GMount* mountStruct, MountIF _mountIF): Undocumented in source. Be warned that the author may not have intended to support it.
callBackPreUnmount void callBackPreUnmount(GMount* mountStruct, MountIF _mountIF): Undocumented in source. Be warned that the author may not have intended to support it.
callBackUnmounted void callBackUnmounted(GMount* mountStruct, MountIF _mountIF): Undocumented in source. Be warned that the author may not have intended to support it.

Variables

_onChangedListeners void delegate(MountIF)[] _onChangedListeners;: Undocumented in source.
_onPreUnmountListeners void delegate(MountIF)[] _onPreUnmountListeners;: Undocumented in source.
_onUnmountedListeners void delegate(MountIF)[] _onUnmountedListeners;: Undocumented in source.
connectedSignals int[string] connectedSignals;
gMount GMount* gMount;: the main Gtk struct