diff options
author | schwarze <> | 2016-12-11 14:22:43 +0000 |
---|---|---|
committer | schwarze <> | 2016-12-11 14:22:43 +0000 |
commit | 24e78a11838b5b911fc4a003f68b779f8b42e6f6 (patch) | |
tree | 92e6f5e2683d2d01cb0ba02412611bc21815b976 /src/lib/libcrypto/man/EC_GROUP_new.3 | |
parent | 11d403ec421a1cca33b5766d8b16528cfce5625c (diff) | |
download | openbsd-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.3 | 19 |
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 |
138 | The EC library provides functions for performing operations on | ||
139 | elliptic curves over finite fields. | ||
140 | In general, an elliptic curve satisfies an equation of the form: | ||
141 | .Pp | ||
142 | .Dl y^2 = x^3 + ax + b | ||
143 | .Pp | ||
138 | Within the library there are two forms of elliptic curves that are of | 144 | Within the library there are two forms of elliptic curves that are of |
139 | interest. | 145 | interest. |
140 | The first form is those defined over the prime field Fp. | 146 | The 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 | |||
143 | is a prime number. | 149 | is a prime number. |
144 | This gives us a revised elliptic curve equation as follows: | 150 | This 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 |
148 | The second form is those defined over a binary field F2^m where the | 154 | The second form is those defined over a binary field F2^m where the |
149 | elements of the field are integers of length at most m bits. | 155 | elements of the field are integers of length at most m bits. |
@@ -156,6 +162,9 @@ polynomial. | |||
156 | All such curves with OpenSSL use a trinomial or a pentanomial for this | 162 | All such curves with OpenSSL use a trinomial or a pentanomial for this |
157 | parameter. | 163 | parameter. |
158 | .Pp | 164 | .Pp |
165 | An | ||
166 | .Vt EC_GROUP | ||
167 | structure is used to represent the definition of an elliptic curve. | ||
159 | A new curve can be constructed by calling | 168 | A new curve can be constructed by calling |
160 | .Fn EC_GROUP_new , | 169 | .Fn EC_GROUP_new , |
161 | using the implementation provided by | 170 | using the implementation provided by |
@@ -291,9 +300,9 @@ and | |||
291 | return 1 on success or 0 on error. | 300 | return 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 | ||