[][src]Enum sequoia_openpgp::types::Curve

pub enum Curve {
    NistP256,
    NistP384,
    NistP521,
    BrainpoolP256,
    BrainpoolP512,
    Ed25519,
    Cv25519,
    Unknown(Box<[u8]>),
    // some variants omitted
}

Elliptic curves used in OpenPGP.

PublicKeyAlgorithm does not differentiate between elliptic curves. Instead, the curve is specified using an OID prepended to the key material. We provide this type to be able to match on the curves.

Note: This enum cannot be exhaustively matched to allow future extensions.

Variants

NistP256

NIST curve P-256.

NistP384

NIST curve P-384.

NistP521

NIST curve P-521.

BrainpoolP256

brainpoolP256r1.

BrainpoolP512

brainpoolP512r1.

Ed25519

D.J. Bernstein's "Twisted" Edwards curve Ed25519.

Cv25519

Elliptic curve Diffie-Hellman using D.J. Bernstein's Curve25519.

Unknown(Box<[u8]>)

Unknown curve.

Methods

impl Curve[src]

pub fn bits(&self) -> Option<usize>[src]

Returns the length of public keys over this curve in bits.

For the Kobliz curves this is the size of the underlying finite field. For X25519 it is 256.

Note: This information is useless and should not be used to gauge the security of a particular curve. This function exists only because some legacy PGP application like HKP need it.

Returns None for unknown curves.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::Curve;

assert_eq!(Curve::NistP256.bits(), Some(256));
assert_eq!(Curve::NistP384.bits(), Some(384));
assert_eq!(Curve::Ed25519.bits(), Some(256));
assert_eq!(Curve::Unknown(Box::new([0x2B, 0x11])).bits(), None);

impl Curve[src]

pub fn from_oid(oid: &[u8]) -> Curve[src]

Parses the given OID.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::Curve;

assert_eq!(Curve::from_oid(&[0x2B, 0x81, 0x04, 0x00, 0x22]), Curve::NistP384);
assert_eq!(Curve::from_oid(&[0x2B, 0x11]), Curve::Unknown(Box::new([0x2B, 0x11])));

pub fn oid(&self) -> &[u8][src]

Returns this curve's OID.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::Curve;

assert_eq!(Curve::NistP384.oid(), &[0x2B, 0x81, 0x04, 0x00, 0x22]);
assert_eq!(Curve::Unknown(Box::new([0x2B, 0x11])).oid(), &[0x2B, 0x11]);

pub fn len(&self) -> Result<usize>[src]

Returns the length of a coordinate in bits.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::Curve;

assert!(if let Ok(256) = Curve::NistP256.len() { true } else { false });
assert!(if let Ok(384) = Curve::NistP384.len() { true } else { false });
assert!(if let Ok(256) = Curve::Ed25519.len() { true } else { false });
assert!(if let Err(_) = Curve::Unknown(Box::new([0x2B, 0x11])).len() { true } else { false });

Errors

Returns Error::UnsupportedEllipticCurve if the curve is not supported.

pub fn is_supported(&self) -> bool[src]

Returns whether this algorithm is supported.

Examples

use sequoia_openpgp as openpgp;
use openpgp::types::Curve;

assert!(Curve::NistP256.is_supported());
assert!(Curve::NistP384.is_supported());
assert!(Curve::Ed25519.is_supported());
assert!(!Curve::Unknown(Box::new([0x2B, 0x11])).is_supported());

Trait Implementations

impl Clone for Curve[src]

impl Debug for Curve[src]

impl Display for Curve[src]

impl Eq for Curve[src]

impl Hash for Curve[src]

impl Ord for Curve[src]

impl PartialEq<Curve> for Curve[src]

impl PartialOrd<Curve> for Curve[src]

impl StructuralEq for Curve[src]

impl StructuralPartialEq for Curve[src]

Auto Trait Implementations

impl RefUnwindSafe for Curve

impl Send for Curve

impl Sync for Curve

impl Unpin for Curve

impl UnwindSafe for Curve

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> DynClone for T where
    T: Clone
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.