1 files changed, 108 insertions, 0 deletions
diff --git a/src/lib/libcrypto/man/EC_GFp_simple_method.3 b/src/lib/libcrypto/man/EC_GFp_simple_method.3
new file mode 100644
index 0000000000..8f401e85c8
--- /dev/null
+++ b/src/lib/libcrypto/man/EC_GFp_simple_method.3
@@ -0,0 +1,108 @@
+.Dd $Mdocdate: November 2 2016 $
+.Dt EC_GFP_SIMPLE_METHOD 3
+.Os
+.Sh NAME
+.Nm EC_GFp_simple_method ,
+.Nm EC_GFp_mont_method ,
+.Nm EC_GFp_nist_method ,
+.Nm EC_GFp_nistp224_method ,
+.Nm EC_GFp_nistp256_method ,
+.Nm EC_GFp_nistp521_method ,
+.Nm EC_GF2m_simple_method ,
+.Nm EC_METHOD_get_field_type
+.Nd obtain EC_METHOD objects
+.Sh SYNOPSIS
+.In openssl/ec.h
+.Ft const EC_METHOD *
+.Fn EC_GFp_simple_method void
+.Ft const EC_METHOD *
+.Fn EC_GFp_mont_method void
+.Ft const EC_METHOD *
+.Fn EC_GFp_nist_method void
+.Ft const EC_METHOD *
+.Fn EC_GFp_nistp224_method void
+.Ft const EC_METHOD *
+.Fn EC_GFp_nistp256_method void
+.Ft const EC_METHOD *
+.Fn EC_GFp_nistp521_method void
+.Ft const EC_METHOD *
+.Fn EC_GF2m_simple_method void
+.Ft int
+.Fo EC_METHOD_get_field_type
+.Fa "const EC_METHOD *meth"
+.Fc
+.Sh DESCRIPTION
+The elliptic curve library provides a number of different
+implementations through a single common interface.
+When constructing a curve using
+.Xr EC_GROUP_new 3 ,
+an implementation method must be provided.
+The functions described here all return a const pointer to an
+.Sy EC_METHOD
+structure that can be passed to
+.Xr EC_GROUP_new .
+It is important that the correct implementation type for the form
+of curve selected is used.
+.Pp
+For F2^m curves there is only one implementation choice,
+.Fn EC_GF2_simple_method .
+.Pp
+For Fp curves the lowest common denominator implementation is the
+.Fn EC_GFp_simple_method
+implementation.
+All other implementations are based on this one.
+.Fn EC_GFp_mont_method
+adds the use of montgomery multiplication (see
+.Xr BN_mod_mul_montgomery 3 ) .
+.Fn EC_GFp_nist_method
+offers an implementation optimised for use with NIST recommended
+curves.
+NIST curves are available through
+.Xr EC_GROUP_new_by_curve_name 3 .
+.Pp
+The functions
+.Fn EC_GFp_nistp224_method ,
+.Fn EC_GFp_nistp256_method ,
+and
+.Fn EC_GFp_nistp521_method
+offer 64 bit optimised implementations for the NIST P224, P256 and
+P521 curves respectively.
+Note, however, that these implementations are not available on all
+platforms.
+.Pp
+.Fn EC_METHOD_get_field_type
+identifies what type of field the
+.Vt EC_METHOD
+structure supports, which will be either F2^m or Fp.
+If the field type is Fp, then the value
+.Dv NID_X9_62_prime_field
+is returned.
+If the field type is F2^m, then the value
+.Dv NID_X9_62_characteristic_two_field
+is returned.
+These values are defined in the
+.In openssl/obj_mac.h
+header file.
+.Sh RETURN VALUES
+All
+.Fn EC_GFp*
+functions and
+.Fn EC_GF2m_simple_method
+always return a const pointer to an
+.Vt EC_METHOD
+structure.
+.Pp
+.Fn EC_METHOD_get_field_type
+returns an integer that identifies the type of field the
+.Vt EC_METHOD
+structure supports.
+.Sh SEE ALSO
+.Xr BN_mod_mul_montgomery 3 ,
+.Xr crypto 3 ,
+.Xr d2i_ECPKParameters 3 ,
+.Xr ec 3 ,
+.Xr EC_GROUP_copy 3 ,
+.Xr EC_GROUP_new 3 ,
+.Xr EC_KEY_new 3 ,
+.Xr EC_POINT_add 3 ,
+.Xr EC_POINT_new 3

diff --git a/src/lib/libcrypto/man/EC_GFp_simple_method.3 b/src/lib/libcrypto/man/EC_GFp_simple_method.3 new file mode 100644 index 0000000000..8f401e85c8 --- /dev/null +++ b/src/lib/libcrypto/man/EC_GFp_simple_method.3
@@ -0,0 +1,108 @@
	1	.Dd $Mdocdate: November 2 2016 $
	2	.Dt EC_GFP_SIMPLE_METHOD 3
	3	.Os
	4	.Sh NAME
	5	.Nm EC_GFp_simple_method ,
	6	.Nm EC_GFp_mont_method ,
	7	.Nm EC_GFp_nist_method ,
	8	.Nm EC_GFp_nistp224_method ,
	9	.Nm EC_GFp_nistp256_method ,
	10	.Nm EC_GFp_nistp521_method ,
	11	.Nm EC_GF2m_simple_method ,
	12	.Nm EC_METHOD_get_field_type
	13	.Nd obtain EC_METHOD objects
	14	.Sh SYNOPSIS
	15	.In openssl/ec.h
	16	.Ft const EC_METHOD *
	17	.Fn EC_GFp_simple_method void
	18	.Ft const EC_METHOD *
	19	.Fn EC_GFp_mont_method void
	20	.Ft const EC_METHOD *
	21	.Fn EC_GFp_nist_method void
	22	.Ft const EC_METHOD *
	23	.Fn EC_GFp_nistp224_method void
	24	.Ft const EC_METHOD *
	25	.Fn EC_GFp_nistp256_method void
	26	.Ft const EC_METHOD *
	27	.Fn EC_GFp_nistp521_method void
	28	.Ft const EC_METHOD *
	29	.Fn EC_GF2m_simple_method void
	30	.Ft int
	31	.Fo EC_METHOD_get_field_type
	32	.Fa "const EC_METHOD *meth"
	33	.Fc
	34	.Sh DESCRIPTION
	35	The elliptic curve library provides a number of different
	36	implementations through a single common interface.
	37	When constructing a curve using
	38	.Xr EC_GROUP_new 3 ,
	39	an implementation method must be provided.
	40	The functions described here all return a const pointer to an
	41	.Sy EC_METHOD
	42	structure that can be passed to
	43	.Xr EC_GROUP_new .
	44	It is important that the correct implementation type for the form
	45	of curve selected is used.
	46	.Pp
	47	For F2^m curves there is only one implementation choice,
	48	.Fn EC_GF2_simple_method .
	49	.Pp
	50	For Fp curves the lowest common denominator implementation is the
	51	.Fn EC_GFp_simple_method
	52	implementation.
	53	All other implementations are based on this one.
	54	.Fn EC_GFp_mont_method
	55	adds the use of montgomery multiplication (see
	56	.Xr BN_mod_mul_montgomery 3 ) .
	57	.Fn EC_GFp_nist_method
	58	offers an implementation optimised for use with NIST recommended
	59	curves.
	60	NIST curves are available through
	61	.Xr EC_GROUP_new_by_curve_name 3 .
	62	.Pp
	63	The functions
	64	.Fn EC_GFp_nistp224_method ,
	65	.Fn EC_GFp_nistp256_method ,
	66	and
	67	.Fn EC_GFp_nistp521_method
	68	offer 64 bit optimised implementations for the NIST P224, P256 and
	69	P521 curves respectively.
	70	Note, however, that these implementations are not available on all
	71	platforms.
	72	.Pp
	73	.Fn EC_METHOD_get_field_type
	74	identifies what type of field the
	75	.Vt EC_METHOD
	76	structure supports, which will be either F2^m or Fp.
	77	If the field type is Fp, then the value
	78	.Dv NID_X9_62_prime_field
	79	is returned.
	80	If the field type is F2^m, then the value
	81	.Dv NID_X9_62_characteristic_two_field
	82	is returned.
	83	These values are defined in the
	84	.In openssl/obj_mac.h
	85	header file.
	86	.Sh RETURN VALUES
	87	All
	88	.Fn EC_GFp*
	89	functions and
	90	.Fn EC_GF2m_simple_method
	91	always return a const pointer to an
	92	.Vt EC_METHOD
	93	structure.
	94	.Pp
	95	.Fn EC_METHOD_get_field_type
	96	returns an integer that identifies the type of field the
	97	.Vt EC_METHOD
	98	structure supports.
	99	.Sh SEE ALSO
	100	.Xr BN_mod_mul_montgomery 3 ,
	101	.Xr crypto 3 ,
	102	.Xr d2i_ECPKParameters 3 ,
	103	.Xr ec 3 ,
	104	.Xr EC_GROUP_copy 3 ,
	105	.Xr EC_GROUP_new 3 ,
	106	.Xr EC_KEY_new 3 ,
	107	.Xr EC_POINT_add 3 ,
	108	.Xr EC_POINT_new 3