Maintainer	gtk2hs-devel@lists.sourceforge.net
Stability	alpha
Portability	portable (depends on GHC)
Safe Haskell	None
Language	Haskell98

System.GIO.Volumes.Drive

Contents

Details
Types
Enums,
Methods
Signals

Description

Synopsis

Details

Drive - this represent a piece of hardware connected to the machine. It's generally only created for removable hardware or hardware with removable media.

Drive is a container class for Volume objects that stem from the same piece of media. As such, Drive 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 Drive 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.

Drive 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 Drive may vary according to implementation. To choose the correct verbs in e.g. a file manager, use driveGetStartStopType.

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

Types

newtype Drive Source #

Constructors

Drive (ForeignPtr Drive)

Instances

Eq Drive Source #
Methods (==) :: Drive -> Drive -> Bool # (/=) :: Drive -> Drive -> Bool #
Ord Drive Source #
Methods compare :: Drive -> Drive -> Ordering # (<) :: Drive -> Drive -> Bool # (<=) :: Drive -> Drive -> Bool # (>) :: Drive -> Drive -> Bool # (>=) :: Drive -> Drive -> Bool # max :: Drive -> Drive -> Drive # min :: Drive -> Drive -> Drive #
GObjectClass Drive Source #
Methods toGObject :: Drive -> GObject # unsafeCastGObject :: GObject -> Drive #
DriveClass Drive Source #

class GObjectClass o => DriveClass o Source #

Instances

DriveClass Drive Source #

Enums,

data DriveStartStopType Source #

Enumeration describing how a drive can be started/stopped.

Constructors

DriveStartStopTypeUnknown
DriveStartStopTypeShutdown
DriveStartStopTypeNetwork
DriveStartStopTypeMultidisk
DriveStartStopTypePassword

Instances

Bounded DriveStartStopType Source #
Methods minBound :: DriveStartStopType # maxBound :: DriveStartStopType #
Enum DriveStartStopType Source #
Methods succ :: DriveStartStopType -> DriveStartStopType # pred :: DriveStartStopType -> DriveStartStopType # toEnum :: Int -> DriveStartStopType # fromEnum :: DriveStartStopType -> Int # enumFrom :: DriveStartStopType -> [DriveStartStopType] # enumFromThen :: DriveStartStopType -> DriveStartStopType -> [DriveStartStopType] # enumFromTo :: DriveStartStopType -> DriveStartStopType -> [DriveStartStopType] # enumFromThenTo :: DriveStartStopType -> DriveStartStopType -> DriveStartStopType -> [DriveStartStopType] #
Eq DriveStartStopType Source #
Methods (==) :: DriveStartStopType -> DriveStartStopType -> Bool # (/=) :: DriveStartStopType -> DriveStartStopType -> Bool #
Ord DriveStartStopType Source #
Methods compare :: DriveStartStopType -> DriveStartStopType -> Ordering # (<) :: DriveStartStopType -> DriveStartStopType -> Bool # (<=) :: DriveStartStopType -> DriveStartStopType -> Bool # (>) :: DriveStartStopType -> DriveStartStopType -> Bool # (>=) :: DriveStartStopType -> DriveStartStopType -> Bool # max :: DriveStartStopType -> DriveStartStopType -> DriveStartStopType # min :: DriveStartStopType -> DriveStartStopType -> DriveStartStopType #
Show DriveStartStopType Source #
Methods showsPrec :: Int -> DriveStartStopType -> ShowS # show :: DriveStartStopType -> String # showList :: [DriveStartStopType] -> ShowS #

data DriveStartFlags Source #

Flags used when starting a drive.

Constructors

DriveStartNone

Instances

Bounded DriveStartFlags Source #
Methods minBound :: DriveStartFlags # maxBound :: DriveStartFlags #
Enum DriveStartFlags Source #
Methods succ :: DriveStartFlags -> DriveStartFlags # pred :: DriveStartFlags -> DriveStartFlags # toEnum :: Int -> DriveStartFlags # fromEnum :: DriveStartFlags -> Int # enumFrom :: DriveStartFlags -> [DriveStartFlags] # enumFromThen :: DriveStartFlags -> DriveStartFlags -> [DriveStartFlags] # enumFromTo :: DriveStartFlags -> DriveStartFlags -> [DriveStartFlags] # enumFromThenTo :: DriveStartFlags -> DriveStartFlags -> DriveStartFlags -> [DriveStartFlags] #
Eq DriveStartFlags Source #
Methods (==) :: DriveStartFlags -> DriveStartFlags -> Bool # (/=) :: DriveStartFlags -> DriveStartFlags -> Bool #
Ord DriveStartFlags Source #
Methods compare :: DriveStartFlags -> DriveStartFlags -> Ordering # (<) :: DriveStartFlags -> DriveStartFlags -> Bool # (<=) :: DriveStartFlags -> DriveStartFlags -> Bool # (>) :: DriveStartFlags -> DriveStartFlags -> Bool # (>=) :: DriveStartFlags -> DriveStartFlags -> Bool # max :: DriveStartFlags -> DriveStartFlags -> DriveStartFlags # min :: DriveStartFlags -> DriveStartFlags -> DriveStartFlags #
Show DriveStartFlags Source #
Methods showsPrec :: Int -> DriveStartFlags -> ShowS # show :: DriveStartFlags -> String # showList :: [DriveStartFlags] -> ShowS #
Flags DriveStartFlags Source #

Methods

driveGetName Source #

Arguments

:: (DriveClass drive, GlibString string)
=> drive
-> IO string	returns the name for the given drive.

Gets the name of drive.

driveGetIcon Source #

Arguments

:: DriveClass drive
=> drive
-> IO Icon	returns a `Icon`.

Gets the icon for drive.

driveHasVolumes Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive contains volumes, `False` otherwise.

Check if drive has any mountable volumes.

driveGetVolumes :: DriveClass drive => drive -> IO [Volume] Source #

Get a list of mountable volumes for drive.

driveCanEject Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive can be ejected.

Checks if drive can be eject.

driveGetStartStopType Source #

Arguments

:: DriveClass drive
=> drive
-> IO DriveStartStopType	returns A value from the `DriveStartStopType` enumeration.

Gets a hint about how a drive can be started/stopped.

driveCanStart Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive can be started, `False` otherwise.

Checks if a drive can be started.

driveCanStartDegraded Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive can be started degraded, `False` otherwise.

Checks if a drive can be started degraded.

driveCanStop Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive can be stoped, `False` otherwise.

Checks if a drive can be stoped.

driveCanPollForMedia :: DriveClass drive => drive -> IO Bool Source #

Checks if a drive can be polled for media changes.

drivePollForMedia :: DriveClass drive => drive -> Maybe Cancellable -> AsyncReadyCallback -> IO () Source #

Asynchronously polls drive to see if media has been inserted or removed.

When the operation is finished, callback will be called. You can then call drivePollForMediaFinish to obtain the result of the operation.

driveHasMedia Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if drive has media, `False` otherwise.

Checks if the drive has media. Note that the OS may not be polling the drive for media changes; see driveIsMediaCheckAutomatic for more details.

driveIsMediaCheckAutomatic Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if the drive is capabable of automatically detecting media changes, `False` otherwise.

Checks if drive is capabable of automatically detecting media changes.

driveIsMediaRemovable Source #

Arguments

:: DriveClass drive
=> drive
-> IO Bool	returns `True` if drive supports removable media, `False` otherwise.

Checks if the drive supports removable media.

driveEjectWithOperation Source #

Arguments

:: DriveClass drive
=> drive
-> [MountUnmountFlags]	`flags` flags affecting the unmount if required for eject
-> Maybe MountOperation	`mountOperation` a `MountOperation` or `Nothing` to avoid user interaction.
-> Maybe Cancellable	`cancellable` optional `Cancellable` object, `Nothing` to ignore.
-> AsyncReadyCallback	`callback` a `AsyncReadyCallback`
-> IO ()

Ejects a drive. This is an asynchronous operation, and is finished by calling driveEjectWithOperationFinish with the drive and AsyncResult data returned in the callback.

driveEjectWithOperationFinish Source #

Arguments

:: DriveClass drive
=> drive
-> AsyncResult	`result` a `AsyncResult`.
-> IO ()

Finishes ejecting a drive. If any errors occurred during the operation, error will be set to contain the errors and False will be returned.

Throws a GError if an error occurs.

driveStart Source #

Arguments

:: DriveClass drive
=> drive
-> [DriveStartFlags]	`flags` flags affecting the start operation.
-> Maybe MountOperation	`mountOperation` a `MountOperation` or `Nothing` to avoid user interaction.
-> Maybe Cancellable	`cancellable` optional `Cancellable` object, `Nothing` to ignore.
-> AsyncReadyCallback	`callback` a `AsyncReadyCallback`
-> IO ()

Asynchronously starts a drive.

When the operation is finished, callback will be called. You can then call driveStartFinish to obtain the result of the operation.

driveStartFinish Source #

Arguments

:: DriveClass drive
=> drive
-> AsyncResult	`result` a `AsyncResult`.
-> IO ()

Finishes starting a drive.

Throws a GError if an error occurs.

driveStopFinish Source #

Arguments

:: DriveClass drive
=> drive
-> AsyncResult	`result` a `AsyncResult`.
-> IO ()

Finishes stoping a drive.

Throws a GError if an error occurs.

driveEnumerateIdentifiers :: (DriveClass drive, GlibString string) => drive -> IO [string] Source #

Gets the kinds of identifiers that drive has. Use driveGetIdentifer to obtain the identifiers themselves.

driveGetIdentifier Source #

Arguments

:: (DriveClass drive, GlibString string)
=> drive
-> string	`kind` the kind of identifier to return
-> IO string

Gets the identifier of the given kind for drive. See the introduction for more information about drive identifiers.

Signals

driveChanged :: DriveClass drive => Signal drive (Drive -> IO ()) Source #

Emitted when a drive changes.

driveDisconnected :: DriveClass drive => Signal drive (Drive -> IO ()) Source #

Emitted when a drive changes.

driveEjectButton :: DriveClass drive => Signal drive (Drive -> IO ()) Source #

Emitted when the eject button is pressed on drive.

driveStopButton :: DriveClass drive => Signal drive (Drive -> IO ()) Source #

Emitted when the stop button is pressed on drive.