pub struct Dh<T>(_, _);
Implementations
sourceimpl Dh<Params>
impl Dh<Params>
pub fn from_params(
p: BigNum,
g: BigNum,
q: BigNum
) -> Result<Dh<Params>, ErrorStack>
sourcepub fn from_pqg(
prime_p: BigNum,
prime_q: Option<BigNum>,
generator: BigNum
) -> Result<Dh<Params>, ErrorStack>
pub fn from_pqg(
prime_p: BigNum,
prime_q: Option<BigNum>,
generator: BigNum
) -> Result<Dh<Params>, ErrorStack>
Creates a DH instance based upon the given primes and generator params.
This corresponds to DH_new
and DH_set0_pqg
.
sourcepub fn set_private_key(
self,
priv_key: BigNum
) -> Result<Dh<Private>, ErrorStack>
pub fn set_private_key(
self,
priv_key: BigNum
) -> Result<Dh<Private>, ErrorStack>
Sets the private key on the DH object and recomputes the public key.
sourcepub fn generate_params(
prime_len: u32,
generator: u32
) -> Result<Dh<Params>, ErrorStack>
pub fn generate_params(
prime_len: u32,
generator: u32
) -> Result<Dh<Params>, ErrorStack>
Generates DH params based on the given prime_len
and a fixed generator
value.
This corresponds to DH_generate_parameters_ex
.
sourcepub fn generate_key(self) -> Result<Dh<Private>, ErrorStack>
pub fn generate_key(self) -> Result<Dh<Private>, ErrorStack>
Generates a public and a private key based on the DH params.
This corresponds to DH_generate_key
.
sourcepub fn params_from_pem(pem: &[u8]) -> Result<Dh<Params>, ErrorStack>
pub fn params_from_pem(pem: &[u8]) -> Result<Dh<Params>, ErrorStack>
Deserializes a PEM-encoded PKCS#3 DHpararameters structure.
The input should have a header of -----BEGIN DH PARAMETERS-----
.
This corresponds to PEM_read_bio_DHparams
.
sourcepub fn params_from_der(der: &[u8]) -> Result<Dh<Params>, ErrorStack>
pub fn params_from_der(der: &[u8]) -> Result<Dh<Params>, ErrorStack>
Deserializes a DER-encoded PKCS#3 DHparameters structure.
This corresponds to d2i_DHparams
.
sourcepub fn get_1024_160() -> Result<Dh<Params>, ErrorStack>
pub fn get_1024_160() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
sourcepub fn get_2048_224() -> Result<Dh<Params>, ErrorStack>
pub fn get_2048_224() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
sourcepub fn get_2048_256() -> Result<Dh<Params>, ErrorStack>
pub fn get_2048_256() -> Result<Dh<Params>, ErrorStack>
Requires OpenSSL 1.0.2 or newer.
sourceimpl<T> Dh<T> where
T: HasParams,
impl<T> Dh<T> where
T: HasParams,
sourcepub fn prime_p(&self) -> &BigNumRef
pub fn prime_p(&self) -> &BigNumRef
Returns the prime p
from the DH instance.
This corresponds to DH_get0_pqg
.
sourcepub fn prime_q(&self) -> Option<&BigNumRef>
pub fn prime_q(&self) -> Option<&BigNumRef>
Returns the prime q
from the DH instance.
This corresponds to DH_get0_pqg
.
sourcepub fn generator(&self) -> &BigNumRef
pub fn generator(&self) -> &BigNumRef
Returns the generator from the DH instance.
This corresponds to DH_get0_pqg
.
Methods from Deref<Target = DhRef<T>>
sourcepub fn params_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
pub fn params_to_pem(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the parameters into a PEM-encoded PKCS#3 DHparameter structure.
The output will have a header of -----BEGIN DH PARAMETERS-----
.
This corresponds to PEM_write_bio_DHparams
.
sourcepub fn params_to_der(&self) -> Result<Vec<u8>, ErrorStack>
pub fn params_to_der(&self) -> Result<Vec<u8>, ErrorStack>
Serializes the parameters into a DER-encoded PKCS#3 DHparameter structure.
This corresponds to i2d_DHparams
.
sourcepub fn public_key(&self) -> &BigNumRef
pub fn public_key(&self) -> &BigNumRef
Returns the public key from the DH instance.
This corresponds to DH_get0_key
.
sourcepub fn compute_key(&self, public_key: &BigNumRef) -> Result<Vec<u8>, ErrorStack>
pub fn compute_key(&self, public_key: &BigNumRef) -> Result<Vec<u8>, ErrorStack>
Computes a shared secret from the own private key and the given public_key
.
This corresponds to DH_compute_key
.
sourcepub fn private_key(&self) -> &BigNumRef
pub fn private_key(&self) -> &BigNumRef
Returns the private key from the DH instance.
This corresponds to DH_get0_key
.
Trait Implementations
sourceimpl<T> ForeignType for Dh<T>
impl<T> ForeignType for Dh<T>
sourceimpl<T> TryFrom<Dh<T>> for PKey<T>
impl<T> TryFrom<Dh<T>> for PKey<T>
type Error = ErrorStack
type Error = ErrorStack
The type returned in the event of a conversion error.
sourceimpl<T> TryFrom<PKey<T>> for Dh<T>
impl<T> TryFrom<PKey<T>> for Dh<T>
type Error = ErrorStack
type Error = ErrorStack
The type returned in the event of a conversion error.
impl<T> Send for Dh<T>
impl<T> Sync for Dh<T>
Auto Trait Implementations
impl<T> RefUnwindSafe for Dh<T> where
T: RefUnwindSafe,
impl<T> Unpin for Dh<T> where
T: Unpin,
impl<T> UnwindSafe for Dh<T> where
T: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more