Drive
GDrive represents a piece of hardware connected to the machine. It’s generally only created for removable hardware or hardware with removable media. For example, an optical disc drive, or a USB flash drive.
GDrive is a container class for iface@Gio.Volume objects that stem from the same piece of media. As such, GDrive abstracts a drive with (or without) removable media and provides operations for querying whether media is available, determining whether media change is automatically detected and ejecting the media.
If the GDrive reports that media isn’t automatically detected, one can poll for media; typically one should not do this periodically as a poll for media operation is potentially expensive and may spin up the drive creating noise.
GDrive supports starting and stopping drives with authentication support for the former. This can be used to support a diverse set of use cases including connecting/disconnecting iSCSI devices, powering down external disk enclosures and starting/stopping multi-disk devices such as RAID devices. Note that the actual semantics and side-effects of starting/stopping a GDrive may vary according to implementation. To choose the correct verbs in e.g. a file manager, use method@Gio.Drive.get_start_stop_type.
For migrating-gnome-vfs.html note that there is no equivalent of GDrive in that API.
Inheritors
Types
Functions
Checks if a drive can be polled for media changes.
Checks if a drive can be started degraded.
Given @connection to communicate with a proxy (eg, a #GSocketConnection that is connected to the proxy server), this does the necessary handshake to connect to @proxy_address, and if required, wraps the #GIOStream to handle proxy payload.
Asynchronous version of g_proxy_connect().
See g_proxy_connect().
This is deprecated since version 2.22.
This is deprecated since version 2.22.
Ejects a drive. This is an asynchronous operation, and is finished by calling g_drive_eject_with_operation_finish() with the @drive and #GAsyncResult data returned in the @callback.
Finishes ejecting a drive. If any errors occurred during the operation,
Gets the kinds of identifiers that @drive has. Use g_drive_get_identifier() to obtain the identifiers themselves.
Gets the identifier of the given kind for @drive. The only identifier currently available is %G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE.
Gets the sort key for @drive, if any.
Gets a hint about how a drive can be started/stopped.
Gets the icon for @drive.
Get a list of mountable volumes for @drive.
Check if @drive has any mountable volumes.
Checks if @drive is capable of automatically detecting media changes.
Checks if the @drive supports removable media.
Checks if the #GDrive and/or its media is considered removable by the user. See g_drive_is_media_removable().
This signal is emitted when the #GDrive have been disconnected. If the recipient is holding references to the object they should release them so the object can be finalized.
Emitted when the physical eject button (if any) of a drive has been pressed.
Emitted when the physical stop button (if any) of a drive has been pressed.
Asynchronously polls @drive to see if media has been inserted or removed.
Finishes an operation started with g_drive_poll_for_media() on a drive.
Asynchronously starts a drive.
Finishes starting a drive.
Asynchronously stops a drive.
Finishes stopping a drive.
Some proxy protocols expect to be passed a hostname, which they will resolve to an IP address themselves. Others, like SOCKS4, do not allow this. This function will return false if @proxy is implementing such a protocol. When false is returned, the caller should resolve the destination hostname first, and then pass a #GProxyAddress containing the stringified IP address to g_proxy_connect() or g_proxy_connect_async().