![]() |
![]() |
![]() |
UDisks Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces |
UDisksLinuxDriveAtaUDisksLinuxDriveAta — Linux implementation of UDisksDriveAta |
UDisksLinuxDriveAta; UDisksDriveAta * udisks_linux_drive_ata_new (void
); gboolean udisks_linux_drive_ata_update (UDisksLinuxDriveAta *drive
,UDisksLinuxDriveObject *object
); gboolean udisks_linux_drive_ata_refresh_smart_sync (UDisksLinuxDriveAta *drive
,gboolean nowakeup
,const gchar *simulate_path
,GCancellable *cancellable
,GError **error
); gboolean udisks_linux_drive_ata_smart_selftest_sync (UDisksLinuxDriveAta *drive
,const gchar *type
,GCancellable *cancellable
,GError **error
); void udisks_linux_drive_ata_apply_configuration (UDisksLinuxDriveAta *drive
,UDisksLinuxDevice *device
,GVariant *configuration
); gboolean udisks_linux_drive_ata_secure_erase_sync (UDisksLinuxDriveAta *drive
,uid_t caller_uid
,gboolean enhanced
,GError **error
);
GObject +----GDBusInterfaceSkeleton +----UDisksDriveAtaSkeleton +----UDisksLinuxDriveAta
typedef struct _UDisksLinuxDriveAta UDisksLinuxDriveAta;
The UDisksLinuxDriveAta structure contains only private data and should only be accessed using the provided API.
UDisksDriveAta * udisks_linux_drive_ata_new (void
);
Creates a new UDisksLinuxDriveAta instance.
Returns : |
A new UDisksLinuxDriveAta. Free with g_object_unref() . |
gboolean udisks_linux_drive_ata_update (UDisksLinuxDriveAta *drive
,UDisksLinuxDriveObject *object
);
Updates the interface.
|
A UDisksLinuxDriveAta. |
|
The enclosing UDisksLinuxDriveObject instance. |
Returns : |
TRUE if configuration has changed, FALSE otherwise. |
gboolean udisks_linux_drive_ata_refresh_smart_sync (UDisksLinuxDriveAta *drive
,gboolean nowakeup
,const gchar *simulate_path
,GCancellable *cancellable
,GError **error
);
Synchronously refreshes ATA S.M.A.R.T. data on drive
using one of
the physical drives associated with it. The calling thread is
blocked until the data has been obtained.
If nowake
is TRUE
and the disk is in a sleep state this fails
with UDISKS_ERROR_WOULD_WAKEUP
.
This may only be called if drive
has been associated with a
UDisksLinuxDriveObject instance.
This method may be called from any thread.
|
The UDisksLinuxDriveAta to refresh. |
|
If TRUE , will not wake up the disk if asleep. |
|
If not NULL , the path of a file with a libatasmart blob to use. |
|
A GCancellable or NULL . |
|
Return location for error. |
Returns : |
TRUE if the operation succeeded, FALSE if error is set. |
gboolean udisks_linux_drive_ata_smart_selftest_sync (UDisksLinuxDriveAta *drive
,const gchar *type
,GCancellable *cancellable
,GError **error
);
Starts (or aborts) a SMART self-test on drive
. Valid values for
type
includes 'short', 'extended', 'conveyance' and 'abort'.
The calling thread is blocked while sending the command to the drive but will return immediately after the drive acknowledges the command.
|
A UDisksLinuxDriveAta. |
|
The type of selftest to run. |
|
A GCancellable that can be used to cancel the operation or NULL . [allow-none]
|
|
Return location for error or NULL . |
Returns : |
TRUE if the operation succeed, FALSE if error is set. |
void udisks_linux_drive_ata_apply_configuration (UDisksLinuxDriveAta *drive
,UDisksLinuxDevice *device
,GVariant *configuration
);
Spawns a thread to apply configuration
to drive
, if any. Does not
wait for the thread to terminate.
|
A UDisksLinuxDriveAta. |
|
A UDisksLinuxDevice |
|
The configuration to apply. |
gboolean udisks_linux_drive_ata_secure_erase_sync (UDisksLinuxDriveAta *drive
,uid_t caller_uid
,gboolean enhanced
,GError **error
);
Performs an ATA Secure Erase opeartion. Blocks the calling thread until the operation completes.
This operation may take a very long time (hours) to complete.
|
A UDisksLinuxDriveAta. |
|
The unix user if of the caller requesting the operation. |
|
TRUE to use the enhanced version of the ATA secure erase command. |
|
Return location for error or NULL . |
Returns : |
TRUE if the operation succeeded, FALSE if error is set. |