Object Hierarchy:

GLib.Drive GLib.Drive GLib.Drive GLib.Object GLib.Object GLib.Object->GLib.Drive


[ CCode ( type_id = "g_drive_get_type ()" ) ]
public interface Drive : Object

`GDrive` represents a piece of hardware connected to the machine.

It’s generally only created for removable hardware or hardware with removable media.

`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 [porting from GnomeVFS](migrating-gnome-vfs.html) note that there is no equivalent of `GDrive` in that API.

Example: Drives:

public void print_drive (Drive drive, string title) {
print (@"$title:\n");
print (" name: %s\n", drive.get_name ());
print (" can-eject: %s\n", drive.can_eject ().to_string ());
print (" can-poll-for-media: %s\n", drive.can_poll_for_media ().to_string ());
print (" can-start: %s\n", drive.can_start ().to_string ());
print (" can-start-degraded: %s\n", drive.can_start_degraded ().to_string ());
print (" can-stop: %s\n", drive.can_stop ().to_string ());
print (" has-volumes: %s\n", drive.has_volumes ().to_string ());
print (" has-media: %s\n", drive.has_media ().to_string ());
print (" is-media-check-automatic: %s\n", drive.is_media_check_automatic ().to_string ());
print (" is-media-removable: %s\n", drive.is_media_removable ().to_string ());
print (" start-stop-type: %s\n", drive.get_start_stop_type ().to_string ());

string[] kinds = drive.enumerate_identifiers ();
foreach (unowned string kind in kinds) {
print (" %s = %s\n", kind, drive.get_identifier (kind));

public static int main (string[] args) {
MainLoop loop = new MainLoop ();

VolumeMonitor monitor = VolumeMonitor.get ();

// Print a list of drives connected to the system:
List<Drive> drives = monitor.get_connected_drives ();
foreach (Drive drive in drives) {
print_drive (drive, "Connected");

// Emitted when a drive is connected to the system:
monitor.drive_connected.connect ((drive) => {
print_drive (drive, "Drive connected");

// Reject all newly connected drives:
drive.eject_with_operation.begin (MountUnmountFlags.FORCE, null, null, (obj, res) => {
try {
bool status = drive.eject_with_operation.end (res);
print ("Eject: %s: %s\n", drive.get_name (), status.to_string ());
} catch (Error e) {
print ("Error: %s\n", e.message);

// Emitted when a drive changes:
monitor.drive_changed.connect ((drive) => {
// See GLib.Drive.changed
print_drive (drive, "Drive changed");

// Emitted when a drive is disconnected from the system:
monitor.drive_disconnected.connect ((drive) => {
// See GLib.Drive.disconnected
print_drive (drive, "Drive disconnected");

// Emitted when the eject button is pressed on drive:
monitor.drive_eject_button.connect ((drive) => {
// See GLib.Drive.eject_button
print_drive (drive, "Drive eject-button");

// Emitted when the stop button is pressed on drive:
monitor.drive_stop_button.connect ((drive) => {
// See GLib.Drive.stop_button
print_drive (drive, "Drive stop-button");
}); ();
return 0;

valac --pkg gio-2.0 GLib.Drive.vala

Namespace: GLib
Package: gio-2.0




Inherited Members: