Document behavior change of EC_POINTs_mul(3) from EC constant time changes.
authortb <tb@openbsd.org>
Wed, 11 Jul 2018 08:42:38 +0000 (08:42 +0000)
committertb <tb@openbsd.org>
Wed, 11 Jul 2018 08:42:38 +0000 (08:42 +0000)
ok beck on earlier version, markup help from Schwarze.

lib/libcrypto/man/EC_POINT_add.3

index c58f401..e2a33b6 100644 (file)
@@ -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 ,