gio.mount

Module for [Mount] interface

Types 2

interfaceMount

The [gio.mount.Mount] interface represents user-visible mounts. Note, when

porting from GnomeVFS, [gio.mount.Mount] is the moral

equivalent of GnomeVFSVolume.

[gio.mount.Mount] 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 [gio.mount.Mount] instance is an asynchronous operation. For more information about asynchronous operations, see [gio.async_result.AsyncResult] and [gio.task.Task]. To unmount a [gio.mount.Mount] instance, first call [gio.mount.Mount.unmountWithOperation] with (at least) the [gio.mount.Mount] instance and a [gio.types.AsyncReadyCallback]. The callback will be fired when the operation has resolved (either with success or failure), and a [gio.async_result.AsyncResult] structure will be passed to the callback. That callback should then call [gio.mount.Mount.unmountWithOperationFinish] with the [gio.mount.Mount] and the [gio.async_result.AsyncResult] data to see if the operation was completed successfully. If an error is present when [gio.mount.Mount.unmountWithOperationFinish] is called, then it will be filled with any error information.

Methods
bool canEject()Checks if mount can be ejected. Returns: true if the mount can be ejected.
bool canUnmount()Checks if mount can be unmounted. Returns: true if the mount can be unmounted.
void eject(gio.types.MountUnmountFlags flags, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)Ejects a mount. This is an asynchronous operation, and is finished by calling [gio.mount.Mount.ejectFinish] with the mount and #GAsyncResult data returned in the callback.
bool ejectFinish(gio.async_result.AsyncResult 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.
void ejectWithOperation(gio.types.MountUnmountFlags flags, gio.mount_operation.MountOperation mountOperation = null, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)Ejects a mount. This is an asynchronous operation, and is finished by calling [gio.mount.Mount.ejectWithOperationFinish] with the mount and #GAsyncResult data returned in the callback.
bool ejectWithOperationFinish(gio.async_result.AsyncResult 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.
gio.file.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). Returns: ...
gio.drive.Drive getDrive()Gets the drive for the mount.
gio.icon.Icon getIcon()Gets the icon for mount. Returns: a #GIcon. The returned object should be unreffed with [gobject.object.ObjectWrap.unref] when no longer needed.
string getName()Gets the name of mount. Returns: the name for the given mount. The returned string should be freed with [glib.global.gfree] when no longer needed.
gio.file.File getRoot()Gets the root directory on mount. Returns: a #GFile. The returned object should be unreffed with [gobject.object.ObjectWrap.unref] when no longer needed.
string getSortKey()Gets the sort key for mount, if any. Returns: Sorting key for mount or null if no such key is available.
gio.icon.Icon getSymbolicIcon()Gets the symbolic icon for mount. Returns: a #GIcon. The returned object should be unreffed with [gobject.object.ObjectWrap.unref] when no longer needed.
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...
gio.volume.Volume getVolume()Gets the volume for the mount. Returns: a #GVolume or null if mount is not associated with a volume. The returned object should be unreffed with [gobject.object.ObjectWrap.unref] when no longer nee...
void guessContentType(bool forceRescan, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)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 m...
string[] guessContentTypeFinish(gio.async_result.AsyncResult 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 [gio.types.I...
string[] guessContentTypeSync(bool forceRescan, gio.cancellable.Cancellable cancellable = null)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 m...
bool isShadowed()Determines if mount is shadowed. Applications or libraries should avoid displaying mount in the user interface if it is shadowed.
void remount(gio.types.MountMountFlags flags, gio.mount_operation.MountOperation mountOperation = null, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)Remounts a mount. This is an asynchronous operation, and is finished by calling [gio.mount.Mount.remountFinish] with the mount and #GAsyncResults data returned in the callback.
bool remountFinish(gio.async_result.AsyncResult 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.
void shadow()Increments the shadow count on mount. Usually used by #GVolumeMonitor implementations when creating a shadow mount for mount, see [gio.mount.Mount.isShadowed] for more information. The caller will ...
void unmount(gio.types.MountUnmountFlags flags, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)Unmounts a mount. This is an asynchronous operation, and is finished by calling [gio.mount.Mount.unmountFinish] with the mount and #GAsyncResult data returned in the callback.
bool unmountFinish(gio.async_result.AsyncResult 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.
void unmountWithOperation(gio.types.MountUnmountFlags flags, gio.mount_operation.MountOperation mountOperation = null, gio.cancellable.Cancellable cancellable = null, gio.types.AsyncReadyCallback callback = null)Unmounts a mount. This is an asynchronous operation, and is finished by calling [gio.mount.Mount.unmountWithOperationFinish] with the mount and #GAsyncResult data returned in the callback.
bool unmountWithOperationFinish(gio.async_result.AsyncResult 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.
void unshadow()Decrements the shadow count on mount. Usually used by #GVolumeMonitor implementations when destroying a shadow mount for mount, see [gio.mount.Mount.isShadowed] for more information. The caller wil...
gulong connectChanged(T)(T callback, Flag!"After" after = No.After)Connect to `Changed` signal.
gulong connectPreUnmount(T)(T callback, Flag!"After" after = No.After)Connect to `PreUnmount` signal.
gulong connectUnmounted(T)(T callback, Flag!"After" after = No.After)Connect to `Unmounted` signal.