From: tb <tb@openbsd.org>
Date: Wed, 11 Jul 2018 08:42:38 +0000 (+0000)
Subject: Document behavior change of EC_POINTs_mul(3) from EC constant time changes.
X-Git-Url: http://artulab.com/gitweb/?a=commitdiff_plain;h=f0c525096c604093c6c89aaf626064e883fddac6;p=openbsd

Document behavior change of EC_POINTs_mul(3) from EC constant time changes.

ok beck on earlier version, markup help from Schwarze.
---

diff --git a/lib/libcrypto/man/EC_POINT_add.3 b/lib/libcrypto/man/EC_POINT_add.3
index c58f4016a93..e2a33b6a72e 100644
--- a/lib/libcrypto/man/EC_POINT_add.3
+++ b/lib/libcrypto/man/EC_POINT_add.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: EC_POINT_add.3,v 1.8 2018/03/23 00:09:11 schwarze Exp $
+.\"	$OpenBSD: EC_POINT_add.3,v 1.9 2018/07/11 08:42:38 tb Exp $
 .\"	OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
 .\"
 .\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 23 2018 $
+.Dd $Mdocdate: July 11 2018 $
 .Dt EC_POINT_ADD 3
 .Os
 .Sh NAME
@@ -217,12 +217,30 @@ The value
 .Fa n
 may be
 .Dv NULL ,
-in which case the result is just q * m.
+in which case the result is just
 .Pp
+.Dl q * m.
+.Pp
+.Fn EC_POINTs_mul
+only supports the values 0 and 1 for
+.Fa num .
+If it is 1, then
 .Fn EC_POINTs_mul
 calculates the value
 .Pp
-.Dl generator * n + q[0] * m[0] + ... + q[num-1] * m[num-1]
+.Dl generator * n + q[0] * m[0].
+.Pp
+If
+.Fa num
+is 0 then
+.Fa q
+and
+.Fa m
+must be
+.Dv NULL ,
+and the result is just
+.Pp
+.Dl generator * n .
 .Pp
 As for
 .Fn EC_POINT_mul ,