Description
Drive managementMethods and Functions
gDriveGetName(object)
gDriveGetIcon(object)
gDriveHasVolumes(object)
gDriveGetVolumes(object)
gDriveCanEject(object)
gDriveGetStartStopType(object)
gDriveCanStart(object)
gDriveCanStartDegraded(object)
gDriveCanStop(object)
gDriveCanPollForMedia(object)
gDrivePollForMedia(object, cancellable = NULL, callback, user.data = NULL)
gDrivePollForMediaFinish(object, result, .errwarn = TRUE)
gDriveHasMedia(object)
gDriveIsMediaCheckAutomatic(object)
gDriveIsMediaRemovable(object)
gDriveEject(object, flags = "G_MOUNT_UNMOUNT_NONE", cancellable = NULL, callback, user.data = NULL)
gDriveEjectFinish(object, result, .errwarn = TRUE)
gDriveEjectWithOperation(object, flags, mount.operation, cancellable = NULL, callback, user.data = NULL)
gDriveEjectWithOperationFinish(object, result, .errwarn = TRUE)
gDriveStart(object, flags, mount.operation, cancellable = NULL, callback, user.data = NULL)
gDriveStartFinish(object, result, .errwarn = TRUE)
gDriveStop(object, flags, mount.operation, cancellable = NULL, callback, user.data = NULL)
gDriveStopFinish(object, result, .errwarn = TRUE)
gDriveEnumerateIdentifiers(object)
gDriveGetIdentifier(object, kind)Hierarchy
GInterface
+----GDriveDetailed Description
GDrive - this represent 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 GVolume 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, determing 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 potententially 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 gDriveGetStartStopType.
For porting from GnomeVFS note that there is no equivalent of
GDrive in that API.References
http://library.gnome.org/devel//gio/GDrive.html