From 5b7f44555e154bf42504784b7e7584335ada707b Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Thu, 11 Feb 2021 13:40:11 +0100
Subject: [PATCH] docs: add manual page for verification.cfg

---
 debian/proxmox-backup-server.install |  1 +
 docs/Makefile                        |  8 +++++++
 docs/config/verification/format.rst  | 16 +++++++++++++
 docs/config/verification/man5.rst    | 35 ++++++++++++++++++++++++++++
 docs/configuration-files.rst         | 15 ++++++++++++
 src/bin/docgen.rs                    |  1 +
 src/config/verify.rs                 |  2 +-
 7 files changed, 77 insertions(+), 1 deletion(-)
 create mode 100644 docs/config/verification/format.rst
 create mode 100644 docs/config/verification/man5.rst

diff --git a/debian/proxmox-backup-server.install b/debian/proxmox-backup-server.install
index e7b51195..2189f8d9 100644
--- a/debian/proxmox-backup-server.install
+++ b/debian/proxmox-backup-server.install
@@ -25,6 +25,7 @@ usr/share/man/man5/datastore.cfg.5
 usr/share/man/man5/user.cfg.5
 usr/share/man/man5/remote.cfg.5
 usr/share/man/man5/sync.cfg.5
+usr/share/man/man5/verification.cfg.5
 usr/share/zsh/vendor-completions/_proxmox-backup-manager
 usr/share/zsh/vendor-completions/_pmtx
 usr/share/zsh/vendor-completions/_pmt
diff --git a/docs/Makefile b/docs/Makefile
index 3a0da7b0..10824da4 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -12,6 +12,7 @@ GENERATED_SYNOPSIS := 						\
 	config/user/config.rst					\
 	config/remote/config.rst				\
 	config/sync/config.rst					\
+	config/verification/config.rst				\
 	config/acl/roles.rst					\
 	config/datastore/config.rst
 
@@ -28,6 +29,7 @@ MAN5_PAGES :=				\
 	user.cfg.5			\
 	remote.cfg.5			\
 	sync.cfg.5			\
+	verification.cfg.5		\
 	datastore.cfg.5
 
 PRUNE_SIMULATOR_FILES := 					\
@@ -121,6 +123,12 @@ config/sync/config.rst: ${COMPILEDIR}/docgen
 sync.cfg.5: config/sync/man5.rst config/sync/config.rst config/sync/format.rst
 	rst2man $< >$@
 
+config/verification/config.rst: ${COMPILEDIR}/docgen
+	${COMPILEDIR}/docgen verification.cfg >$@
+
+verification.cfg.5: config/verification/man5.rst config/verification/config.rst config/verification/format.rst
+	rst2man $< >$@
+
 config/acl/roles.rst: ${COMPILEDIR}/docgen
 	${COMPILEDIR}/docgen "config::acl::Role" >$@
 
diff --git a/docs/config/verification/format.rst b/docs/config/verification/format.rst
new file mode 100644
index 00000000..dbe8bf84
--- /dev/null
+++ b/docs/config/verification/format.rst
@@ -0,0 +1,16 @@
+Each entry starts with a header ``verification: <name>``, followed by the
+job configuration options.
+
+::
+
+  verification: verify-store2
+	ignore-verified true
+	outdated-after 7
+	schedule daily
+	store store2
+
+  verification: ...
+
+
+You can use the ``proxmox-backup-manager verify-job`` command to manipulate
+this file.
diff --git a/docs/config/verification/man5.rst b/docs/config/verification/man5.rst
new file mode 100644
index 00000000..00938de8
--- /dev/null
+++ b/docs/config/verification/man5.rst
@@ -0,0 +1,35 @@
+==========================
+verification.cfg
+==========================
+
+.. include:: ../../epilog.rst
+
+-------------------------------------------------------------
+Verification Job Configuration
+-------------------------------------------------------------
+
+:Author: |AUTHOR|
+:Version: Version |VERSION|
+:Manual section: 5
+
+Description
+===========
+
+The file /etc/proxmox-backup/sync.cfg is a configuration file for
+Proxmox Backup Server. It contains the verification job
+configuration.
+
+
+File Format
+===========
+
+.. include:: format.rst
+
+
+Options
+=======
+
+.. include:: config.rst
+
+
+.. include:: ../../pbs-copyright.rst
diff --git a/docs/configuration-files.rst b/docs/configuration-files.rst
index 941f2453..912b8eae 100644
--- a/docs/configuration-files.rst
+++ b/docs/configuration-files.rst
@@ -80,3 +80,18 @@ Options
 ^^^^^^^
 
 .. include:: config/sync/config.rst
+
+
+``verification.cfg``
+~~~~~~~~~~~~~~~~~
+
+File Format
+^^^^^^^^^^^
+
+.. include:: config/verification/format.rst
+
+
+Options
+^^^^^^^
+
+.. include:: config/verification/config.rst
diff --git a/src/bin/docgen.rs b/src/bin/docgen.rs
index b47ff5ca..1cdade9d 100644
--- a/src/bin/docgen.rs
+++ b/src/bin/docgen.rs
@@ -34,6 +34,7 @@ fn main() -> Result<(), Error> {
             "user.cfg" => dump_section_config(&config::user::CONFIG),
             "remote.cfg" => dump_section_config(&config::remote::CONFIG),
             "sync.cfg" => dump_section_config(&config::sync::CONFIG),
+            "verification.cfg" => dump_section_config(&config::verify::CONFIG),
             "media-pool.cfg" => dump_section_config(&config::media_pool::CONFIG),
             "config::acl::Role" => dump_enum_properties(&config::acl::Role::API_SCHEMA)?,
             _ => bail!("docgen: got unknown type"),
diff --git a/src/config/verify.rs b/src/config/verify.rs
index 5d326d9b..81934270 100644
--- a/src/config/verify.rs
+++ b/src/config/verify.rs
@@ -18,7 +18,7 @@ use proxmox::tools::{fs::replace_file, fs::CreateOptions};
 use crate::api2::types::*;
 
 lazy_static! {
-    static ref CONFIG: SectionConfig = init();
+    pub static ref CONFIG: SectionConfig = init();
 }