openbsd/src/lib/libcrypto/man/CRYPTO_set_ex_data.3, branch OPENBSD_7_9A mirror of https://github.com/libressl/openbsd.git
https://git.lua4.win/openbsd/atom?h=OPENBSD_7_92025-06-08T22:40:31+00:00.Lb libcrypto ; OK tb@2025-06-08T22:40:31+00:00schwarze2025-06-08T22:40:31+00:00urn:sha1:8be86af02fed1bda350c8dd14ee064cb66e3b0f5Rewrite RSA_get_ex_new_index(3) and CRYPTO_set_ex_data(3) from scratch.2023-09-18T14:49:43+00:00schwarze2023-09-18T14:49:43+00:00urn:sha1:3a1872a6a9dc403ef6310c940e7b15ff91bfbbd1
The defects of the old pages were too numerous to list in full but included
vagueness, gaps, misleading statements, bad ordering, and duplication.
Use my Copyright since none of the text we inherited from OpenSSL remains.
Without doing a thorough review, tb@ thinks he likes the new pages
after quickly reading through both of them.
The CRYPTO_EX_DATA type is not opaque2023-07-28T14:34:54+00:00tb2023-07-28T14:34:54+00:00urn:sha1:a65012e9329b7bde2223964c16b2a59e310f44b5
By API misdesign, it cannot be opaque. The incorrect documentation was
added as a part of a huge commit with a lot of churn. CRYPTO_EX_DATA
typically lives as an embedded struct of an opaque struct, but it can
also be used by applications, for example to initialize libssl.
documentation error pointed out by jsing
man pages: add missing commas between subordinate and main clauses2022-03-31T17:27:26+00:00naddy2022-03-31T17:27:26+00:00urn:sha1:3d8be07546f5ec331a0f851b0ea88212376ebb95
jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.
ok jmc@
document EC_KEY_get_ex_new_index(3), EC_KEY_get_ex_data(3),2019-08-16T12:16:22+00:00schwarze2019-08-16T12:16:22+00:00urn:sha1:918b2a5b3ef77745d74e158b2141a2b9f6a3dff2
and EC_KEY_set_ex_data(3)
Tree structure for manual pages: crypto(3) links to 33 function2019-06-06T01:06:59+00:00schwarze2019-06-06T01:06:59+00:00urn:sha1:580f04977d3a77664477818e7264e008d1ba5843
group pages, and these link on to all their second-level subpages.
Only a handful of second-level pages have third-level subpages.
So all crypto pages can now be reached from the www.libressl.org
frontpage via at most four clicks, in most cases three clicks.
Also link back from leaf pages to their respective group pages
and add a couple of additional links between related pages.
Triggered by a question from deraadt@.
OK jmc@ tb@
sort the list of data structures and add the missing ECDH and ECDSA;2018-04-08T01:00:15+00:00schwarze2018-04-08T01:00:15+00:00urn:sha1:046ddca938894da3184f69b9b7e08eeadcdb7892
triggered by OpenSSL commit a73d990e Feb 27 19:02:24 2018 +0100,
but with different content
crypto HISTORY up to 0.9.5; researched from OpenSSL git2018-03-22T16:06:33+00:00schwarze2018-03-22T16:06:33+00:00urn:sha1:56ed9616f4bcc89cbb8c9e65c821f863853139b1crypto.c HISTORY up to SSLeay 0.9.0; researched from OpenSSL git2018-03-21T06:33:19+00:00schwarze2018-03-21T06:33:19+00:00urn:sha1:e1543f4f2bbeeeaee96b5288d90d06370b569723resolve duplication of names and prototypes in manuals related to ex_data2017-01-06T20:35:23+00:00schwarze2017-01-06T20:35:23+00:00urn:sha1:e6a84a396ff2905660c8a941b5c6ecd6a334c4a6
and sprinkle cross references instead; more work is obviously needed here