Enum sequoia_openpgp::types::HashAlgorithm

#[non_exhaustive]
pub enum HashAlgorithm {
    MD5,
    SHA1,
    RipeMD,
    SHA256,
    SHA384,
    SHA512,
    SHA224,
    Private(u8),
    Unknown(u8),
}

The OpenPGP hash algorithms as defined in Section 9.4 of RFC 4880.

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

Examples

Use HashAlgorithm to set the preferred hash algorithms on a signature:

use sequoia_openpgp as openpgp;
use openpgp::packet::signature::SignatureBuilder;
use openpgp::types::{HashAlgorithm, SignatureType};

let mut builder = SignatureBuilder::new(SignatureType::DirectKey)
    .set_hash_algo(HashAlgorithm::SHA512);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

MD5

Rivest et.al. message digest 5.

SHA1

NIST Secure Hash Algorithm (deprecated)

RipeMD

RIPEMD-160

SHA256

256-bit version of SHA2

SHA384

384-bit version of SHA2

SHA512

512-bit version of SHA2

SHA224

224-bit version of SHA2

Private(u8)

Private hash algorithm identifier.

Unknown(u8)

Unknown hash algorithm identifier.

Implementations

impl HashAlgorithm

pub fn is_supported(self) -> bool

Whether Sequoia supports this algorithm.

pub fn oid(self) -> Result<&'static [u8]>

Returns the ASN.1 OID of this hash algorithm.

impl HashAlgorithm

pub fn context(self) -> Result<Box<dyn Digest>>

Creates a new hash context for this algorithm.

Errors

Fails with Error::UnsupportedHashAlgorithm if Sequoia does not support this algorithm. See HashAlgorithm::is_supported.

impl HashAlgorithm

pub fn text_name(&self) -> Result<&str>

Returns the text name of this algorithm.

Section 9.4 of RFC 4880 defines a textual representation of hash algorithms. This is used in cleartext signed messages (see Section 7 of RFC 4880).

Examples

assert_eq!(HashAlgorithm::RipeMD.text_name()?, "RIPEMD160");

Trait Implementations

impl Clone for HashAlgorithm

fn clone(&self) -> HashAlgorithm

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HashAlgorithm

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HashAlgorithm

fn default() -> Self

Returns the “default value” for a type.

impl Display for HashAlgorithm

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<u8> for HashAlgorithm

fn from(u: u8) -> Self

Performs the conversion.

impl FromStr for HashAlgorithm

type Err = ()

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, ()>

Parses a string s to return a value of this type.

impl Hash for HashAlgorithm

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for HashAlgorithm

fn cmp(&self, other: &HashAlgorithm) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<HashAlgorithm> for HashAlgorithm

fn eq(&self, other: &HashAlgorithm) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &HashAlgorithm) -> bool

This method tests for !=.

impl PartialOrd<HashAlgorithm> for HashAlgorithm

fn partial_cmp(&self, other: &HashAlgorithm) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for HashAlgorithm

impl Eq for HashAlgorithm

impl StructuralEq for HashAlgorithm

impl StructuralPartialEq for HashAlgorithm