man: add DOI for refereed article on Forward Secure Sealing to journald.conf(5)

In journalctl(1), be more explicit about the reference to "Seal=" in
journald.conf(5) and what information can be found there.

diff --git a/man/journalctl.xml b/man/journalctl.xml
index 23bb96051dc98bd852a85d24a79ef80f8f22de99..2de72523ccc51da35f18a703d0385eb2e9cb1f27 100644 (file)
--- a/man/journalctl.xml
+++ b/man/journalctl.xml
@@ -800,10 +800,14 @@
                                 sealing key is stored in the journal
                                 data directory and shall remain on the
                                 host. The verification key should be
                                 sealing key is stored in the journal
                                 data directory and shall remain on the
                                 host. The verification key should be

-                                stored externally. Also see the
+                                stored externally. Refer to the

                                 <option>Seal=</option> option in
                                 <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
                                 <option>Seal=</option> option in
                                 <citerefentry><refentrytitle>journald.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>

-                                for details.</para></listitem>
+                                for information on Forward Secure
+                                Sealing and for a link to a refereed
+                                scholarly paper detailing the
+                                cryptographic theory it is based on.
+                                </para></listitem>

                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>

diff --git a/man/journald.conf.xml b/man/journald.conf.xml
index 7aa2e78ed34bf0177674acfebcf1981b49691057..8e642a3f593c3ded7c29542a5f7f73f0480f43df 100644 (file)
--- a/man/journald.conf.xml
+++ b/man/journald.conf.xml
@@ -130,15 +130,15 @@
                                 by
                                 <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
                                 <option>--setup-keys</option>
                                 by
                                 <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
                                 <option>--setup-keys</option>

-                                command), forward secure sealing (FSS)
+                                command), Forward Secure Sealing (FSS)

                                 for all persistent journal files is
                                 enabled. FSS is based on <ulink
                                 url="https://eprint.iacr.org/2013/397">Seekable
                                 Sequential Key Generators</ulink> by
                                 for all persistent journal files is
                                 enabled. FSS is based on <ulink
                                 url="https://eprint.iacr.org/2013/397">Seekable
                                 Sequential Key Generators</ulink> by

-                                G. A. Marson and B. Poettering and
-                                may be used to protect journal files
-                                from unnoticed
-                                alteration.</para></listitem>
+                                G. A. Marson and B. Poettering
+                                (doi:10.1007/978-3-642-40203-6_7)
+                                and may be used to protect journal files
+                                from unnoticed alteration.</para></listitem>

                         </varlistentry>
 
                         <varlistentry>
                         </varlistentry>
 
                         <varlistentry>