GDrive {RGtk2} | R Documentation

## GDrive

### Description

Drive management

### Methods 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
       +----GDrive

### Detailed 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.

### Structures

`GDrive`

  Opaque drive object.

### Enums and Flags

`GDriveStartFlags`

  Flags used when starting a drive. Since 2.22

  `none`

    No flags set.

`GDriveStartStopType`

  Enumeration describing how a drive can be started/stopped. Since 2.22

  `unknown`

    Unknown or drive doesn't support start/stop.

  `shutdown`

    The stop method will physically shut down the drive and e.g. power down the port the drive is attached to.

  `network`

    The start/stop methods are used for connecting/disconnect to the drive over the network.

  `multidisk`

    The start/stop methods will assemble/disassemble a virtual drive from several physical drives.

  `password`

    The start/stop methods will unlock/lock the disk (for example using the ATA “SECURITY UNLOCK DEVICE” command)

### Signals

`changed(drive, user.data)`

  Emitted when the drive's state has changed.

  `drive`

    a `GDrive`.

  `user.data`

    user data set when the signal handler was connected.

`disconnected(drive, user.data)`

  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.

  `drive`

    a `GDrive`.

  `user.data`

    user data set when the signal handler was connected.

`eject-button(drive, user.data)`

  Emitted when the physical eject button (if any) of a drive has been pressed.

  `drive`

    a `GDrive`.

  `user.data`

    user data set when the signal handler was connected.

`stop-button(drive, user.data)`

  Emitted when the physical stop button (if any) of a drive has been pressed. Since 2.22

  `drive`

    a `GDrive`.

  `user.data`

    user data set when the signal handler was connected.

### Author(s)

Derived by RGtkGen from GTK+ documentation

### References

https://developer.gnome.org/gio/stable/GDrive.html

[Package RGtk2 version 2.20.36.3 Index]