Struct EcGroupRef

pub struct EcGroupRef(/* private fields */);

Reference to EcGroup

Implementations

impl EcGroupRef

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.

This corresponds to EC_GROUP_get_curve_GFp.

pub fn components_gf2m( &self, p: &mut BigNumRef, a: &mut BigNumRef, b: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>

Places the components of a curve over a binary field in the provided BigNums. The components make up the formula y^2 + xy = x^3 + ax^2 + b.

In this form p relates to the irreducible polynomial. Each bit represents a term in the polynomial. It will be set to 3 1s or 5 1s depending on using a trinomial or pentanomial.

This corresponds to EC_GROUP_get_curve_GF2m.

pub fn cofactor( &self, cofactor: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>

Places the cofactor of the group in the provided BigNum.

This corresponds to EC_GROUP_get_cofactor.

pub fn degree(&self) -> u32

Returns the degree of the curve.

This corresponds to EC_GROUP_get_degree.

pub fn order_bits(&self) -> u32

Returns the number of bits in the group order.

This corresponds to EC_GROUP_order_bits.

pub fn generator(&self) -> &EcPointRef

Returns the generator for the given curve as an EcPoint.

This corresponds to EC_GROUP_get0_generator.

pub fn set_generator( &mut self, generator: EcPoint, order: BigNum, cofactor: BigNum, ) -> Result<(), ErrorStack>

Sets the generator point for the given curve

This corresponds to EC_GROUP_set_generator.

pub fn order( &self, order: &mut BigNumRef, ctx: &mut BigNumContextRef, ) -> Result<(), ErrorStack>

Places the order of the curve in the provided BigNum.

This corresponds to EC_GROUP_get_order.

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.

This corresponds to EC_GROUP_set_asn1_flag.

pub fn asn1_flag(&self) -> Asn1Flag

Gets the flag determining if the group corresponds to a named curve.

This corresponds to EC_GROUP_get_asn1_flag.

pub fn curve_name(&self) -> Option<Nid>

Returns the name of the curve, if a name is associated.

This corresponds to EC_GROUP_get_curve_name.

Trait Implementations

impl AsRef<EcGroupRef> for EcGroup

fn as_ref(&self) -> &EcGroupRef

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<EcGroupRef> for EcGroup

fn borrow(&self) -> &EcGroupRef

Immutably borrows from an owned value.

impl ForeignTypeRef for EcGroupRef

type CType = EC_GROUP

The raw C type.

unsafe fn from_ptr<'a>(ptr: *mut Self::CType) -> &'a Self

Constructs a shared instance of this type from its raw type.

unsafe fn from_ptr_mut<'a>(ptr: *mut Self::CType) -> &'a mut Self

Constructs a mutable reference of this type from its raw type.

fn as_ptr(&self) -> *mut Self::CType

Returns a raw pointer to the wrapped value.

impl Send for EcGroupRef

impl Sync for EcGroupRef