document verify job structs

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>

diff --git a/src/config/verify.rs b/src/config/verify.rs
index aa6b05c9909eea6940caa231f137e08b5941bcb7..5d326d9b0346cd4c1878cb1d887984695ea5ccd4 100644 (file)
--- a/src/config/verify.rs
+++ b/src/config/verify.rs
@@ -52,15 +52,21 @@ lazy_static! {
 #[derive(Serialize,Deserialize)]
 /// Verification Job
 pub struct VerificationJobConfig {
+    /// unique ID to address this job
     pub id: String,
+    /// the datastore ID this verificaiton job affects
     pub store: String,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// if not set to false, check the age of the last snapshot verification to filter
+    /// out recent ones, depending on 'outdated_after' configuration.
     pub ignore_verified: Option<bool>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// Reverify snapshots after X days, never if 0. Ignored if 'ignore_verified' is false.
     pub outdated_after: Option<i64>,
     #[serde(skip_serializing_if="Option::is_none")]
     pub comment: Option<String>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// when to schedule this job in calendar event notation
     pub schedule: Option<String>,
 }
 
@@ -115,23 +121,33 @@ pub struct VerificationJobConfig {
 #[derive(Serialize,Deserialize)]
 /// Status of Verification Job
 pub struct VerificationJobStatus {
+    /// unique ID to address this job
     pub id: String,
+    /// the datastore ID this verificaiton job affects
     pub store: String,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// if not set to false, check the age of the last snapshot verification to filter
+    /// out recent ones, depending on 'outdated_after' configuration.
     pub ignore_verified: Option<bool>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// Reverify snapshots after X days, never if 0. Ignored if 'ignore_verified' is false.
     pub outdated_after: Option<i64>,
     #[serde(skip_serializing_if="Option::is_none")]
     pub comment: Option<String>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// when to schedule this job in calendar event notation
     pub schedule: Option<String>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// The timestamp when this job runs the next time.
     pub next_run: Option<i64>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// The state of the last scheduled run, if any
     pub last_run_state: Option<String>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// The task UPID of the last scheduled run, if any
     pub last_run_upid: Option<String>,
     #[serde(skip_serializing_if="Option::is_none")]
+    /// When the last run was finished, combined with UPID.starttime one can calculate the duration
     pub last_run_endtime: Option<i64>,
 }