openbsd/src/lib/libcrypto/man/d2i_DSAPublicKey.3, branch OPENBSD_6_8_BASE

Some of the functions in this manual need , others

2018-08-26T17:03:32+00:00

need . The functions {d2i,i2d}_DSA_params_{bio,fp}(3) were missing from the manual, so document them. The return values of the i2d_* functions are left undocumented, as these still need to be audited. ok schwarze (lots of input and help as usual)

found a complete archive of SSLeay-0.4 to SSLeay-0.8.1b tarballs

2018-03-27T17:35:50+00:00

on the web, so fix up SSLeay HISTORY accordingly

crypto HISTORY up to 0.9.5; researched from OpenSSL git

2018-03-22T16:06:33+00:00

crypto HISTORY up to 0.9.3; researched from OpenSSL git

2018-03-21T17:57:48+00:00

x509.h HISTORY up to SSLeay 0.8.1b; researched from OpenSSL git

2018-03-21T03:16:08+00:00

dsa.h HISTORY up to SSLeay 0.8.1b; researched from OpenSSL git

2018-03-20T22:37:32+00:00

Clarify what DSAparams_dup(3) does.

2016-12-25T14:38:55+00:00

Add STANDARDS references. Add cross references to manual pages documenting conversion functions that are used by the functions documented here. Mark up the names of custom ASN.1 datatypes that are defined in standards with .Vt, allowing to search for them. Do not mark up basic ASN.1 data types. They stand out by being ALL CAPS anyway, and searching for them would be pointless.

First example of how to fix the d2i_*() manuals:

2016-12-24T23:22:52+00:00

- add four missing functions found in OpenSSL doc/man3/d2i_X509.pod - simplify .Nd - drop needless extra include line - use the same parameter names as in ASN1_item_d2i(3) - point to ASN1_item_d2i(3) for details - sort the text and simplify the wording More work is needed on STANDARDS references.

Document DSAparams_dup(3). It is in and documented

2016-12-12T13:58:46+00:00

by OpenSSL, so it is clearly public. OpenSSL documents it in doc/man3/X509_dup.pod, but with wrong header file, wrong prototype, and misleading description. While here, fix the wrong d2i_DSA_SIG(3) return type and document those RETURN VALUES that i could easily figure out.

Change all references to dsa(3) to point to DSA_new(3).

2016-12-10T22:47:49+00:00

Make sure all DSA pages point back to DSA_new(3).