Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 12 Aug 2021 23:54:04 +0000
From:      bugzilla-noreply@freebsd.org
To:        bugs@FreeBSD.org
Subject:   [Bug 257799] Missing OpenSSL man pages: rehash(1), config(5), crypto(7)
Message-ID:  <bug-257799-227@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D257799

            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@FreeBSD.org
          Reporter: andrew.daugherity@gmail.com
                CC: doc@FreeBSD.org

I recently discovered that the venerable c_rehash Perl script has been repl=
aced
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 botto=
m,
but the only installed man page matching that is an alias to builtin(1).  T=
here
is no openssl-rehash(1) installed, either.  (The OpenSSL subcommands all ha=
ve
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:
=3D=3D=3D=3D
#!/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
=3D=3D=3D=3D

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 e=
xist
under those names, they cover unrelated topics.

--=20
You are receiving this mail because:
You are the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-257799-227>