module Gio::Drive

Overview

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 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 Gio::Drive#start_stop_type.

For porting from GnomeVFS note that there is no equivalent of GDrive in that API.

Defined in:

lib/gi-crystal/src/auto/gio-2.0/drive.cr

Constructors

• .cast(obj : GObject::Object) : self

  Cast a GObject::Object to self, throws a TypeCastError if the cast can't be made.

Class Method Summary

• .cast?(obj : GObject::Object) : self | Nil
• .g_type : UInt64

Instance Method Summary

• #can_eject : Bool
• #can_poll_for_media : Bool
• #can_start : Bool
• #can_start_degraded : Bool
• #can_stop : Bool
• #changed_signal
• #disconnected_signal
• #eject(flags : Gio::MountUnmountFlags, cancellable : Gio::Cancellable | Nil, &callback : Gio::AsyncReadyCallback) : Nil

  DEPRECATED

• #eject_button_signal
• #eject_finish(result : Gio::AsyncResult) : Bool

  DEPRECATED

• #eject_with_operation(flags : Gio::MountUnmountFlags, mount_operation : Gio::MountOperation | Nil, cancellable : Gio::Cancellable | Nil, &callback : Gio::AsyncReadyCallback) : Nil
• #eject_with_operation_finish(result : Gio::AsyncResult) : Bool
• #enumerate_identifiers : Enumerable(String)
• #has_media : Bool
• #has_volumes : Bool
• #icon : Gio::Icon
• #identifier(kind : String) : String | Nil
• #is_media_check_automatic : Bool
• #is_media_removable : Bool
• #is_removable : Bool
• #name : String
• #poll_for_media(cancellable : Gio::Cancellable | Nil, &callback : Gio::AsyncReadyCallback) : Nil
• #poll_for_media_finish(result : Gio::AsyncResult) : Bool
• #sort_key : String | Nil
• #start(flags : Gio::DriveStartFlags, mount_operation : Gio::MountOperation | Nil, cancellable : Gio::Cancellable | Nil, &callback : Gio::AsyncReadyCallback) : Nil
• #start_finish(result : Gio::AsyncResult) : Bool
• #start_stop_type : Gio::DriveStartStopType
• #stop(flags : Gio::MountUnmountFlags, mount_operation : Gio::MountOperation | Nil, cancellable : Gio::Cancellable | Nil, &callback : Gio::AsyncReadyCallback) : Nil
• #stop_button_signal
• #stop_finish(result : Gio::AsyncResult) : Bool
• #symbolic_icon : Gio::Icon
• #to_unsafe
• #volumes : GLib::List

Constructor Detail

Class Method Detail

Instance Method Detail