openbsd/src/lib/libcrypto/man/EC_POINT_add.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:8be86af02fed1bda350c8dd14ee064cb66e3b0f5Rework EC documentation2025-04-25T19:57:12+00:00tb2025-04-25T19:57:12+00:00urn:sha1:60904c983d054a3655c2d3ac38828e2b8c9cc067
This replaces the giant, poor quality and outdated EC_GROUP_copy.3,
EC_GROUP_new.3, and EC_POINT_new.3 manuals with seven new manuals
written from scratch.
* EC_GROUP_new_by_curve_name() is the entry point for builtin curves,
* EC_GROUP_new_curve_GFp() describes lower level API that should not
usually be needed apart from a handful of accessors.
* EC_GROUP_check() contains two functions that applications should not
need because either you know for certain something is an elliptic
curve (so these checks are pointless) or you should not use it.
* EC_GROUP_get_curve_name() describes some low level ASN.1 footguns
and corresponding getters.
* EC_POINT_new() contains the simple EC_POINT allocation and freeing API
* EC_POINT_get_affine_coordinates() contains the coordinate accessors
* EC_POINT_point2oct() is about encoding elliptic curve points
While all this is quite far from perfect, the diff is getting too big
and it will be easier to improve this in tree. It is definitely more
repetitive than I would like it to be.
Reviews, tweaks and general feedback are of course welcome.
discussed with jsing
Remove EC_POINTs_{make_affine,mul}() docs2025-03-08T16:48:22+00:00tb2025-03-08T16:48:22+00:00urn:sha1:cb7d728823ffd008a96ddac1b6002b5b95b73f9fRemove EC_GROUP_{,have_}precompute_mult() docs2025-03-08T16:44:41+00:00tb2025-03-08T16:44:41+00:00urn:sha1:64d65da2f0bcaee95146f1b913b94dba853e50a9Remove EC_GFp_* and EC_METHOD_get_field_type docs2025-03-08T16:38:13+00:00tb2025-03-08T16:38:13+00:00urn:sha1:f9782c9acfdbef308a07a85a3f2b07c5b67a833eremove duplicate lines2023-04-12T09:55:22+00:00jsg2023-04-12T09:55:22+00:00urn:sha1:8af96f911bc545c28cd09df53483936ff3abf658Document behavior change of EC_POINTs_mul() again.2018-07-16T17:37:25+00:00tb2018-07-16T17:37:25+00:00urn:sha1:d163789f343ed655e4fef2a8e2ae8c3bf4c9a08cback out ecc constant time changes2018-07-15T05:38:48+00:00jsg2018-07-15T05:38:48+00:00urn:sha1:ccbfd1fe05749d4f08db7f45fe5db1fac8d14d6b
after the constant time commits various regress tests started failing
on sparc64 ssh t9, libcrypto ec ecdh ecdsa and trying to ssh out
resulted in 'invalid elliptic curve value'
ok tb@
Document behavior change of EC_POINTs_mul(3) from EC constant time changes.2018-07-11T08:42:38+00:00tb2018-07-11T08:42:38+00:00urn:sha1:15d97385463254582c8873aad0a6e99bf56deb9d
ok beck on earlier version, markup help from Schwarze.
crypto HISTORY up to 0.9.8; researched from OpenSSL git2018-03-23T00:09:11+00:00schwarze2018-03-23T00:09:11+00:00urn:sha1:d442d735f62f18f56e09751883aaed26bb21f83d