[−][src]Enum sequoia_openpgp::Fingerprint
A long identifier for certificates and keys.
A Fingerprint
uniquely identifies a public key.
Currently, sequoia supports version 4 fingerprints and Key IDs only. Version 3 fingerprints and Key IDs were deprecated by RFC 4880 in 2007.
Essentially, a v4 fingerprint is a SHA-1 hash over the key's public key packet. For details, see Section 12.2 of RFC 4880.
Fingerprints are used, for example, to reference the issuing key
of a signature in its IssuerFingerprint
subpacket. As a
general rule of thumb, you should prefer using fingerprints over
KeyIDs because the latter are vulnerable to birthday attacks.
Note: This enum cannot be exhaustively matched to allow future extensions.
Examples
use openpgp::Fingerprint; let fp: Fingerprint = "0123 4567 89AB CDEF 0123 4567 89AB CDEF 0123 4567".parse()?; assert_eq!("0123456789ABCDEF0123456789ABCDEF01234567", fp.to_hex());
Variants (Non-exhaustive)
A 20 byte SHA-1 hash of the public key packet as defined in the RFC.
Used for holding fingerprint data that is not a V4 fingerprint, e.g. a V3 fingerprint (deprecated) or otherwise wrong-length data.
Implementations
impl Fingerprint
[src]
pub fn from_bytes(raw: &[u8]) -> Fingerprint
[src]
Creates a Fingerprint
from a byte slice in big endian
representation.
Examples
use openpgp::Fingerprint; let fp: Fingerprint = "0123 4567 89AB CDEF 0123 4567 89AB CDEF 0123 4567".parse()?; let bytes = [0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF, 0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF, 0x01, 0x23, 0x45, 0x67]; assert_eq!(Fingerprint::from_bytes(&bytes), fp);
pub fn as_bytes(&self) -> &[u8]
[src]
Returns the raw fingerprint as a byte slice in big endian representation.
Examples
use openpgp::Fingerprint; let fp: Fingerprint = "0123 4567 89AB CDEF 0123 4567 89AB CDEF 0123 4567".parse()?; assert_eq!(fp.as_bytes(), [0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF, 0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF, 0x01, 0x23, 0x45, 0x67]);
pub fn to_hex(&self) -> String
[src]
Converts this fingerprint to its canonical hexadecimal representation.
This representation is always uppercase and without spaces and is suitable for stable key identifiers.
The output of this function is exactly the same as formatting
this object with the :X
format specifier.
use openpgp::Fingerprint; let fp: Fingerprint = "0123 4567 89AB CDEF 0123 4567 89AB CDEF 0123 4567".parse()?; assert_eq!("0123456789ABCDEF0123456789ABCDEF01234567", fp.to_hex()); assert_eq!(format!("{:X}", fp), fp.to_hex());
pub fn from_hex(s: &str) -> Result<Self, Error>
[src]
Parses the hexadecimal representation of an OpenPGP fingerprint.
This function is the reverse of to_hex
. It also accepts
other variants of the fingerprint notation including
lower-case letters, spaces and optional leading 0x
.
use openpgp::Fingerprint; let fp = Fingerprint::from_hex("0123456789ABCDEF0123456789ABCDEF01234567")?; assert_eq!("0123456789ABCDEF0123456789ABCDEF01234567", fp.to_hex()); let fp = Fingerprint::from_hex("0123 4567 89ab cdef 0123 4567 89ab cdef 0123 4567")?; assert_eq!("0123456789ABCDEF0123456789ABCDEF01234567", fp.to_hex());
pub fn to_icao(&self) -> String
[src]
Converts the hex representation of the Fingerprint
to a
phrase in the ICAO spelling alphabet.
Examples
use openpgp::Fingerprint; let fp: Fingerprint = "01AB 4567 89AB CDEF 0123 4567 89AB CDEF 0123 4567".parse()?; assert!(fp.to_icao().starts_with("Zero One Alfa Bravo"));
Trait Implementations
impl Clone for Fingerprint
[src]
pub fn clone(&self) -> Fingerprint
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Debug for Fingerprint
[src]
impl Display for Fingerprint
[src]
impl Eq for Fingerprint
[src]
impl<'_> From<&'_ Fingerprint> for KeyID
[src]
pub fn from(fp: &Fingerprint) -> Self
[src]
impl<'_> From<&'_ Fingerprint> for KeyHandle
[src]
pub fn from(i: &Fingerprint) -> Self
[src]
impl From<Fingerprint> for KeyID
[src]
pub fn from(fp: Fingerprint) -> Self
[src]
impl From<Fingerprint> for KeyHandle
[src]
pub fn from(i: Fingerprint) -> Self
[src]
impl FromStr for Fingerprint
[src]
type Err = Error
The associated error which can be returned from parsing.
pub fn from_str(s: &str) -> Result<Self, Self::Err>
[src]
impl Hash for Fingerprint
[src]
pub fn hash<__H: Hasher>(&self, state: &mut __H)
[src]
pub fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher,
1.3.0[src]
H: Hasher,
impl LowerHex for Fingerprint
[src]
impl Marshal for Fingerprint
[src]
pub fn serialize(&self, o: &mut dyn Write) -> Result<()>
[src]
pub fn export(&self, o: &mut dyn Write) -> Result<()>
[src]
impl MarshalInto for Fingerprint
[src]
pub fn serialized_len(&self) -> usize
[src]
pub fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>
[src]
pub fn to_vec(&self) -> Result<Vec<u8>>
[src]
pub fn export_into(&self, buf: &mut [u8]) -> Result<usize>
[src]
pub fn export_to_vec(&self) -> Result<Vec<u8>>
[src]
impl Ord for Fingerprint
[src]
pub fn cmp(&self, other: &Fingerprint) -> Ordering
[src]
#[must_use]pub fn max(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn min(self, other: Self) -> Self
1.21.0[src]
#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self
1.50.0[src]
impl PartialEq<Fingerprint> for Fingerprint
[src]
pub fn eq(&self, other: &Fingerprint) -> bool
[src]
pub fn ne(&self, other: &Fingerprint) -> bool
[src]
impl PartialOrd<Fingerprint> for Fingerprint
[src]
pub fn partial_cmp(&self, other: &Fingerprint) -> Option<Ordering>
[src]
pub fn lt(&self, other: &Fingerprint) -> bool
[src]
pub fn le(&self, other: &Fingerprint) -> bool
[src]
pub fn gt(&self, other: &Fingerprint) -> bool
[src]
pub fn ge(&self, other: &Fingerprint) -> bool
[src]
impl Serialize for Fingerprint
[src]
pub fn serialize(&self, o: &mut dyn Write) -> Result<()>
[src]
pub fn export(&self, o: &mut dyn Write) -> Result<()>
[src]
impl SerializeInto for Fingerprint
[src]
pub fn serialized_len(&self) -> usize
[src]
pub fn serialize_into(&self, buf: &mut [u8]) -> Result<usize>
[src]
pub fn to_vec(&self) -> Result<Vec<u8>>
[src]
pub fn export_into(&self, buf: &mut [u8]) -> Result<usize>
[src]
pub fn export_to_vec(&self) -> Result<Vec<u8>>
[src]
impl StructuralEq for Fingerprint
[src]
impl StructuralPartialEq for Fingerprint
[src]
impl<'_> TryFrom<&'_ KeyHandle> for Fingerprint
[src]
type Error = Error
The type returned in the event of a conversion error.
pub fn try_from(i: &KeyHandle) -> Result<Self>
[src]
impl TryFrom<KeyHandle> for Fingerprint
[src]
type Error = Error
The type returned in the event of a conversion error.
pub fn try_from(i: KeyHandle) -> Result<Self>
[src]
impl UpperHex for Fingerprint
[src]
Auto Trait Implementations
impl RefUnwindSafe for Fingerprint
[src]
impl Send for Fingerprint
[src]
impl Sync for Fingerprint
[src]
impl Unpin for Fingerprint
[src]
impl UnwindSafe for Fingerprint
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> DynClone for T where
T: Clone,
[src]
T: Clone,
pub fn __clone_box(&self, Private) -> *mut ()
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,