From: David Zeuthen <davidz@redhat.com>
Date: Fri, 23 Sep 2011 14:23:28 +0000 (-0400)
Subject: Update docs
X-Git-Tag: upstream/2.1.2~475
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=94f5a21c71b7f2cc96378542e2e654c2c82d92be;p=platform%2Fupstream%2Fudisks2.git

Update docs

Signed-off-by: David Zeuthen <davidz@redhat.com>
---

diff --git a/data/org.freedesktop.UDisks2.xml b/data/org.freedesktop.UDisks2.xml
index a490a11..2c99f84 100644
--- a/data/org.freedesktop.UDisks2.xml
+++ b/data/org.freedesktop.UDisks2.xml
@@ -267,12 +267,10 @@
         <varlistentry><term>error_read</term>
           <listitem><para>Last self-test failed (Read).</para></listitem></varlistentry>
         <varlistentry><term>error_handling</term>
-          <listitem><para>Last self-test failed (Damage)).</para></listitem></varlistentry>
+          <listitem><para>Last self-test failed (Damage).</para></listitem></varlistentry>
         <varlistentry><term>inprogress</term>
           <listitem><para>Self-test is currently in progress.</para></listitem></varlistentry>
         </variablelist>
-         This property is only meaningful if the property
-         #org.freedesktop.UDisks2.Drive.Ata:SmartUpdated is non-zero.
     -->
     <property name="SmartSelftestStatus" type="s" access="read"/>
 
diff --git a/doc/udisks2-sections.txt b/doc/udisks2-sections.txt
index 49e285c..f41bafb 100644
--- a/doc/udisks2-sections.txt
+++ b/doc/udisks2-sections.txt
@@ -182,6 +182,7 @@ UDisksLinuxDriveAta
 udisks_linux_drive_ata_new
 udisks_linux_drive_ata_update
 udisks_linux_drive_ata_refresh_smart_sync
+udisks_linux_drive_ata_smart_selftest_sync
 <SUBSECTION Standard>
 UDISKS_LINUX_DRIVE_ATA
 UDISKS_IS_LINUX_DRIVE_ATA
@@ -572,18 +573,41 @@ udisks_drive_ata_call_smart_update
 udisks_drive_ata_call_smart_update_finish
 udisks_drive_ata_call_smart_update_sync
 udisks_drive_ata_complete_smart_update
+udisks_drive_ata_call_smart_get_attributes
+udisks_drive_ata_call_smart_get_attributes_finish
+udisks_drive_ata_call_smart_get_attributes_sync
+udisks_drive_ata_complete_smart_get_attributes
+udisks_drive_ata_call_smart_selftest_abort
+udisks_drive_ata_call_smart_selftest_abort_finish
+udisks_drive_ata_call_smart_selftest_abort_sync
+udisks_drive_ata_complete_smart_selftest_abort
+udisks_drive_ata_call_smart_selftest_start
+udisks_drive_ata_call_smart_selftest_start_finish
+udisks_drive_ata_call_smart_selftest_start_sync
+udisks_drive_ata_complete_smart_selftest_start
 udisks_drive_ata_get_smart_supported
 udisks_drive_ata_get_smart_enabled
 udisks_drive_ata_get_smart_updated
 udisks_drive_ata_get_smart_failing
 udisks_drive_ata_get_smart_temperature
 udisks_drive_ata_get_smart_power_on_seconds
+udisks_drive_ata_get_smart_num_attributes_failed_in_the_past
+udisks_drive_ata_get_smart_num_attributes_failing
+udisks_drive_ata_get_smart_num_bad_sectors
+udisks_drive_ata_get_smart_selftest_percent_remaining
+udisks_drive_ata_get_smart_selftest_status
+udisks_drive_ata_dup_smart_selftest_status
 udisks_drive_ata_set_smart_supported
 udisks_drive_ata_set_smart_enabled
 udisks_drive_ata_set_smart_updated
 udisks_drive_ata_set_smart_failing
 udisks_drive_ata_set_smart_temperature
 udisks_drive_ata_set_smart_power_on_seconds
+udisks_drive_ata_set_smart_num_attributes_failed_in_the_past
+udisks_drive_ata_set_smart_num_attributes_failing
+udisks_drive_ata_set_smart_num_bad_sectors
+udisks_drive_ata_set_smart_selftest_percent_remaining
+udisks_drive_ata_set_smart_selftest_status
 UDisksDriveAtaProxy
 UDisksDriveAtaProxyClass
 udisks_drive_ata_proxy_new
diff --git a/src/udiskslinuxdriveata.c b/src/udiskslinuxdriveata.c
index 3dda070..ed488c2 100644
--- a/src/udiskslinuxdriveata.c
+++ b/src/udiskslinuxdriveata.c
@@ -486,6 +486,22 @@ udisks_linux_drive_ata_refresh_smart_sync (UDisksLinuxDriveAta  *drive,
 
 /* ---------------------------------------------------------------------------------------------------- */
 
+/**
+ * udisks_linux_drive_ata_smart_selftest_sync:
+ * @drive: A #UDisksLinuxDriveAta.
+ * @type: The type of selftest to run.
+ * @cancellable: (allow-none): A #GCancellable that can be used to cancel the operation or %NULL.
+ * @error: Return location for error or %NULL.
+ *
+ * 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.
+ *
+ * Returns: %TRUE if the operation succeed, %FALSE if @error is set.
+ */
 gboolean
 udisks_linux_drive_ata_smart_selftest_sync (UDisksLinuxDriveAta     *drive,
                                             const gchar             *type,