Struct ring::aead::less_safe_key::LessSafeKey

source ·
pub struct LessSafeKey {
    inner: KeyInner,
    algorithm: &'static Algorithm,
}
Expand description

Immutable keys for use in situations where OpeningKey/SealingKey and NonceSequence cannot reasonably be used.

Prefer to use OpeningKey/SealingKey and NonceSequence when practical.

Fields§

§inner: KeyInner§algorithm: &'static Algorithm

Implementations§

source§

impl LessSafeKey

source

pub fn new(key: UnboundKey) -> Self

Constructs a LessSafeKey.

source

pub(super) fn new_( algorithm: &'static Algorithm, key_bytes: &[u8], ) -> Result<Self, Unspecified>

source

pub fn open_in_place_separate_tag<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, tag: Tag, in_out: &'in_out mut [u8], ciphertext: RangeFrom<usize>, ) -> Result<&'in_out mut [u8], Unspecified>
where A: AsRef<[u8]>,

Like open_in_place, except the authentication tag is passed separately.

source

pub fn open_in_place<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &'in_out mut [u8], ) -> Result<&'in_out mut [u8], Unspecified>
where A: AsRef<[u8]>,

Like super::OpeningKey::open_in_place(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to open data.

source

pub fn open_within<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &'in_out mut [u8], ciphertext_and_tag: RangeFrom<usize>, ) -> Result<&'in_out mut [u8], Unspecified>
where A: AsRef<[u8]>,

Like super::OpeningKey::open_within(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to open data.

source

pub fn seal_in_place_append_tag<A, InOut>( &self, nonce: Nonce, aad: Aad<A>, in_out: &mut InOut, ) -> Result<(), Unspecified>
where A: AsRef<[u8]>, InOut: AsMut<[u8]> + for<'in_out> Extend<&'in_out u8>,

Like super::SealingKey::seal_in_place_append_tag(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to seal data.

source

pub fn seal_in_place_separate_tag<A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &mut [u8], ) -> Result<Tag, Unspecified>
where A: AsRef<[u8]>,

Like super::SealingKey::seal_in_place_separate_tag(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to seal data.

source

pub fn algorithm(&self) -> &'static Algorithm

The key’s AEAD algorithm.

source

pub(super) fn fmt_debug( &self, type_name: &'static str, f: &mut Formatter<'_>, ) -> Result<(), Error>

Trait Implementations§

source§

impl Clone for LessSafeKey

source§

fn clone(&self) -> LessSafeKey

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for LessSafeKey

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

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> 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> ToOwned for T
where T: Clone,

§

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>,

§

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>,

§

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.