summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EC_GROUP_new.3
diff options
context:
space:
mode:
authorschwarze <>2016-12-11 14:22:43 +0000
committerschwarze <>2016-12-11 14:22:43 +0000
commit24e78a11838b5b911fc4a003f68b779f8b42e6f6 (patch)
tree92e6f5e2683d2d01cb0ba02412611bc21815b976 /src/lib/libcrypto/man/EC_GROUP_new.3
parent11d403ec421a1cca33b5766d8b16528cfce5625c (diff)
downloadopenbsd-24e78a11838b5b911fc4a003f68b779f8b42e6f6.tar.gz
openbsd-24e78a11838b5b911fc4a003f68b779f8b42e6f6.tar.bz2
openbsd-24e78a11838b5b911fc4a003f68b779f8b42e6f6.zip
Distribute the text of ec(3) to the individual EC manuals where it belongs.
Make sure EC_GROUP_new(3) points to all EC manuals and all EC manuals point back to EC_GROUP_new(3), and add some other useful links as well. Change all links to ec(3) to point to EC_GROUP_new(3) instead.
Diffstat (limited to 'src/lib/libcrypto/man/EC_GROUP_new.3')
-rw-r--r--src/lib/libcrypto/man/EC_GROUP_new.319
1 files changed, 14 insertions, 5 deletions
diff --git a/src/lib/libcrypto/man/EC_GROUP_new.3 b/src/lib/libcrypto/man/EC_GROUP_new.3
index 27916744dd..f1227da759 100644
--- a/src/lib/libcrypto/man/EC_GROUP_new.3
+++ b/src/lib/libcrypto/man/EC_GROUP_new.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EC_GROUP_new.3,v 1.5 2016/12/06 14:54:55 schwarze Exp $ 1.\" $OpenBSD: EC_GROUP_new.3,v 1.6 2016/12/11 14:22:43 schwarze Exp $
2.\" OpenSSL 9b86974e Mon Aug 17 15:21:33 2015 -0400 2.\" OpenSSL 9b86974e Mon Aug 17 15:21:33 2015 -0400
3.\" 3.\"
4.\" This file was written by Matt Caswell <matt@openssl.org>. 4.\" This file was written by Matt Caswell <matt@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: December 6 2016 $ 51.Dd $Mdocdate: December 11 2016 $
52.Dt EC_GROUP_NEW 3 52.Dt EC_GROUP_NEW 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -135,6 +135,12 @@
135.Fa "size_t nitems" 135.Fa "size_t nitems"
136.Fc 136.Fc
137.Sh DESCRIPTION 137.Sh DESCRIPTION
138The EC library provides functions for performing operations on
139elliptic curves over finite fields.
140In general, an elliptic curve satisfies an equation of the form:
141.Pp
142.Dl y^2 = x^3 + ax + b
143.Pp
138Within the library there are two forms of elliptic curves that are of 144Within the library there are two forms of elliptic curves that are of
139interest. 145interest.
140The first form is those defined over the prime field Fp. 146The first form is those defined over the prime field Fp.
@@ -143,7 +149,7 @@ The elements of Fp are the integers 0 to p-1, where
143is a prime number. 149is a prime number.
144This gives us a revised elliptic curve equation as follows: 150This gives us a revised elliptic curve equation as follows:
145.Pp 151.Pp
146.Dl y^2 mod p = x^3 +ax + b mod p 152.Dl y^2 mod p = x^3 + ax + b mod p
147.Pp 153.Pp
148The second form is those defined over a binary field F2^m where the 154The second form is those defined over a binary field F2^m where the
149elements of the field are integers of length at most m bits. 155elements of the field are integers of length at most m bits.
@@ -156,6 +162,9 @@ polynomial.
156All such curves with OpenSSL use a trinomial or a pentanomial for this 162All such curves with OpenSSL use a trinomial or a pentanomial for this
157parameter. 163parameter.
158.Pp 164.Pp
165An
166.Vt EC_GROUP
167structure is used to represent the definition of an elliptic curve.
159A new curve can be constructed by calling 168A new curve can be constructed by calling
160.Fn EC_GROUP_new , 169.Fn EC_GROUP_new ,
161using the implementation provided by 170using the implementation provided by
@@ -291,9 +300,9 @@ and
291return 1 on success or 0 on error. 300return 1 on success or 0 on error.
292.Sh SEE ALSO 301.Sh SEE ALSO
293.Xr d2i_ECPKParameters 3 , 302.Xr d2i_ECPKParameters 3 ,
294.Xr ec 3 ,
295.Xr EC_GFp_simple_method 3 , 303.Xr EC_GFp_simple_method 3 ,
296.Xr EC_GROUP_copy 3 , 304.Xr EC_GROUP_copy 3 ,
297.Xr EC_KEY_new 3 , 305.Xr EC_KEY_new 3 ,
298.Xr EC_POINT_add 3 , 306.Xr EC_POINT_add 3 ,
299.Xr EC_POINT_new 3 307.Xr EC_POINT_new 3 ,
308.Xr ECDSA_SIG_new 3