Bug 257799 - Missing OpenSSL man pages: rehash(1), config(5), crypto(7)
Summary: Missing OpenSSL man pages: rehash(1), config(5), crypto(7)
Status: New
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-08-12 23:54 UTC by Andrew Daugherity
Modified: 2021-08-12 23:54 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Daugherity 2021-08-12 23:54:04 UTC
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.