diff options
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 | ||
