2024-11-05 Fred Gleason <fredg@paravelsystems.com>

* Added a rdautocheck(8) utility.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>

docs/manpages/Makefile.am

@@ -57,6 +57,9 @@ all-local:	rdadmin.1\
                 rdautoback.8\
                 rdautoback.html\
                 rdautoback.pdf\
+                rdautocheck.8\
+                rdautocheck.html\
+                rdautocheck.pdf\
                 rdautorest.8\
                 rdautorest.html\
                 rdautorest.pdf\
@@ -114,6 +117,8 @@ man_MANS = rdadmin.1\
            rdalsaconfig.1\
            rdautoback.8\
            rdautorest.8\
+           rdautocheck.8\
+           rdautocheck.8\
            rdclilogedit.1\
            rd.conf.5\
            rdconvert.1\
@@ -148,6 +153,10 @@ EXTRA_DIST = exitcodes.xml\
              rdautoback.html\
              rdautoback.pdf\
              rdautoback.xml\
+             rdautocheck.8\
+             rdautocheck.html\
+             rdautocheck.pdf\
+             rdautocheck.xml\
              rdautorest.8\
              rdautorest.html\
              rdautorest.pdf\

docs/manpages/rdautocheck.xml

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<refentry id="stdin" xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <!--
+      Header
+  -->
+  <refmeta>
+    <refentrytitle>rdautocheck</refentrytitle>
+    <manvolnum>8</manvolnum>
+    <refmiscinfo class='source'>November 2024</refmiscinfo>
+    <refmiscinfo class='manual'>Linux Audio Manual</refmiscinfo>
+  </refmeta>
+  <refnamediv>
+    <refname>rdautocheck</refname>
+    <refpurpose>Display metadata for coherent Rivendell backups</refpurpose>
+  </refnamediv>
+  <info>
+    <author>
+      <personname>
+	<firstname>Fred</firstname>
+	<surname>Gleason</surname>
+	<email>fredg@paravelsystems.com</email>
+      </personname>
+      <contrib>Application Author</contrib>
+    </author>
+  </info>
+
+  <!--
+      Body
+  -->
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>rdautocheck</command>
+      <arg choice='req'><replaceable>mount-pt1</replaceable></arg>
+      <arg choice='opt'><replaceable>mount-pt2</replaceable></arg>
+      <arg choice='opt'>...</arg>
+      <sbr/>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'><title>Description</title>
+  <para>
+    <command>rdautocheck</command><manvolnum>8</manvolnum> is a command-line
+    tool used for displaying the metadata for one or more coherent backups
+    (database+audiostore) of the Rivendell Radio Automation System generated
+    by <command>rdautoback</command><manvolnum>8</manvolnum>.
+  </para>
+  <para>
+    <command>rdautocheck</command><manvolnum>8</manvolnum> will attempt
+    to mount the filesystem corresponding to each mount point specified in
+    its invocation and, if successful, print the contents of the
+    <computeroutput>INFO.txt</computeroutput> file in the mounted filesystem
+    to standard output, following which the volume will be unmounted.
+  </para>
+  </refsect1>
+
+  <refsect1 id='see_also'><title>See Also</title>
+  <para>
+  <citerefentry>
+    <refentrytitle>fstab</refentrytitle><manvolnum>5</manvolnum>
+  </citerefentry>
+  ,
+  <citerefentry>
+    <refentrytitle>rdautoback</refentrytitle><manvolnum>8</manvolnum>
+  </citerefentry>
+  ,
+  <citerefentry>
+    <refentrytitle>rdautorest</refentrytitle><manvolnum>8</manvolnum>
+  </citerefentry>
+  </para>
+  </refsect1>
+
+
+</refentry>
+