Skip to main content

Mac

Struct Mac 

Source
pub struct Mac(/* private fields */);
Expand description

A computed file MAC: 128 uppercase hex characters.

The inner string is private and PartialEq routes through subtle::ConstantTimeEq, so there is no non-constant-time way to compare two of these. Upstream uses Go’s !=; the verdict is identical and the timing channel is gone — a strict improvement that costs nothing at the wire.

Implementations§

Source§

impl Mac

Source

pub fn as_hex(&self) -> &str

The uppercase-hex rendering, for writing into the file.

A MAC is not a secret — it ships in the file, encrypted only to bind it to the data key — so exposing the string is fine. Comparing it as a plain string is what is prevented, and that is done by making PartialEq the only comparison available.

Source

pub fn from_file(hex: impl Into<String>) -> Self

Adopt a MAC recovered from a file’s decrypted mac field.

Source

pub fn is_absent(&self) -> bool

Whether this MAC is the empty string, which upstream reports as “no MAC” rather than as a mismatch against nothing.

Trait Implementations§

Source§

impl Clone for Mac

Source§

fn clone(&self) -> Mac

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Mac

Source§

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

Elided in the middle. A MAC is not secret, but a full 128-char digest in a log line is noise, and printing both ends is what makes a mismatch eyeball-comparable.

Source§

impl Eq for Mac

Source§

impl PartialEq for Mac

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

§

impl Freeze for Mac

§

impl RefUnwindSafe for Mac

§

impl Send for Mac

§

impl Sync for Mac

§

impl Unpin for Mac

§

impl UnsafeUnpin for Mac

§

impl UnwindSafe for Mac

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

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

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.