pub struct EcGroup(/* private fields */);Expand description
Describes the curve
A curve can be of the named curve type. These curves can be discovered
using openssl binary openssl ecparam -list_curves. Other operations
are available in the wiki. These named curves are available in the
Nid module.
Curves can also be generated using prime field parameters or a binary field.
Prime fields use the formula y^2 mod p = x^3 + ax + b mod p. Binary
fields use the formula y^2 + xy = x^3 + ax^2 + b. Named curves have
assured security. To prevent accidental vulnerabilities, they should
be preferred.
Implementations§
Source§impl EcGroup
impl EcGroup
Sourcepub fn from_curve_name(nid: Nid) -> Result<EcGroup, ErrorStack>
pub fn from_curve_name(nid: Nid) -> Result<EcGroup, ErrorStack>
Returns the group of a standard named curve.
OpenSSL documentation at EC_GROUP_new.
Methods from Deref<Target = EcGroupRef>§
Sourcepub fn components_gfp(
&self,
p: &mut BigNumRef,
a: &mut BigNumRef,
b: &mut BigNumRef,
ctx: &mut BigNumContextRef,
) -> Result<(), ErrorStack>
pub fn components_gfp( &self, p: &mut BigNumRef, a: &mut BigNumRef, b: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>
Places the components of a curve over a prime field in the provided BigNums.
The components make up the formula y^2 mod p = x^3 + ax + b mod p.
OpenSSL documentation available at EC_GROUP_get_curve_GFp
Sourcepub fn cofactor(
&self,
cofactor: &mut BigNumRef,
ctx: &mut BigNumContextRef,
) -> Result<(), ErrorStack>
pub fn cofactor( &self, cofactor: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>
Places the cofactor of the group in the provided BigNum.
OpenSSL documentation at EC_GROUP_get_cofactor
Sourcepub fn degree(&self) -> u32
pub fn degree(&self) -> u32
Returns the degree of the curve.
OpenSSL documentation at EC_GROUP_get_degree
Sourcepub fn order_bits(&self) -> u32
pub fn order_bits(&self) -> u32
Returns the number of bits in the group order.
OpenSSL documentation at EC_GROUP_order_bits
Sourcepub fn generator(&self) -> &EcPointRef
pub fn generator(&self) -> &EcPointRef
Returns the generator for the given curve as a EcPoint.
OpenSSL documentation at EC_GROUP_get0_generator
Sourcepub fn order(
&self,
order: &mut BigNumRef,
ctx: &mut BigNumContextRef,
) -> Result<(), ErrorStack>
pub fn order( &self, order: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>
Places the order of the curve in the provided BigNum.
OpenSSL documentation at EC_GROUP_get_order
Sourcepub fn set_asn1_flag(&mut self, flag: Asn1Flag)
pub fn set_asn1_flag(&mut self, flag: Asn1Flag)
Sets the flag determining if the group corresponds to a named curve or must be explicitly parameterized.
This defaults to EXPLICIT_CURVE in OpenSSL 1.0.1 and 1.0.2, but NAMED_CURVE in OpenSSL
1.1.0.
Sourcepub fn curve_name(&self) -> Option<Nid>
pub fn curve_name(&self) -> Option<Nid>
Returns the name of the curve, if a name is associated.
OpenSSL documentation at EC_GROUP_get_curve_name