[Bug 257799] Missing OpenSSL man pages: rehash(1), config(5), crypto(7)

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 12 Aug 2021 23:54:04 +0000
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=257799

            Bug ID: 257799
           Summary: Missing OpenSSL man pages: rehash(1), config(5),
                    crypto(7)
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs_at_FreeBSD.org
          Reporter: andrew.daugherity_at_gmail.com
                CC: doc_at_FreeBSD.org

I recently discovered that the venerable c_rehash Perl script has been replaced
by builtin openssl(1) commands, first by 'openssl certhash' in LibreSSL and
then a different implementation known as 'openssl rehash' in OpenSSL 1.1+.

FreeBSD 12.2 ships OpenSSL 1.1.1h but somehow lacks the man page for this
command.  openssl(1) mentions rehash(1) in its "SEE ALSO" list at the bottom,
but the only installed man page matching that is an alias to builtin(1).  There
is no openssl-rehash(1) installed, either.  (The OpenSSL subcommands all have
man page aliases of that form, e.g. openssl-req(1) and req(1).)

It appears that the rehash man page *is* present in the source directory in POD
form.  I wrote a quick shell script that found two other missing man pages:
====
#!/bin/sh

cd /usr/src/crypto/openssl/doc
for sec in man*; do
        for f in $sec/*.pod; do
                if ! [ -f /usr/share/openssl/man/${f%.pod}.${sec#man}.gz ];
then
                        echo "Missing man page ${f%.pod}!"
                fi
        done
done
====

Output on 12.2 is:
Missing man page man1/rehash!
Missing man page man5/config!
Missing man page man7/crypto!

It appears that 13.0 does have rehash(1) -- although due the shadowing by
builtin(1) you have to search for openssl-rehash(1) -- but lacks config(5)
[about the openssl.cnf file] and crypto(7).  Note that while man pages do exist
under those names, they cover unrelated topics.

-- 
You are receiving this mail because:
You are the assignee for the bug.
Received on Thu Aug 12 2021 - 23:54:04 UTC

Original text of this message