Remove the duplicate documentation of pem_password_cb(3).
authorschwarze <schwarze@openbsd.org>
Tue, 19 Sep 2023 08:18:13 +0000 (08:18 +0000)
committerschwarze <schwarze@openbsd.org>
Tue, 19 Sep 2023 08:18:13 +0000 (08:18 +0000)
commit911218781d39ba8797246725888491bb8b8a3bc4
treedf039aa21059cc70f9fc9a276b5f428ce11859df
parent4159c0ed0216449d03d4ae48ab9b74a303946115
Remove the duplicate documentation of pem_password_cb(3).
While here, also:

* Avoid the misleading term "default password callback" because none of
the functions in SSL_CTX_use_certificate(3) support overriding it.
* Do not talk about "storing", "writing", and "encryption" since the cb
passed to SSL_CTX_set_default_passwd_cb(3) is never used for any of that.
* List the functions using cb.
* Document what happens by default.
* Remove the misleading words "which must be provided by the application"
because all this is actually optional.
* Make several wordings more precise.
* Below EXAMPLES, fix argument naming to agree with pem_password_cb(3),
clarify the description of what the example does, and, as suggested by tb@,
use strlcpy(3).

OK tb@
lib/libssl/man/SSL_CTX_set_default_passwd_cb.3