Struct ring::aead::LessSafeKey

[+] Show declaration

pub struct LessSafeKey { /* fields omitted */ }

[−] 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.

Implementations

impl LessSafeKey[−]

pub fn new(key: UnboundKey) -> Self[−]

Constructs a LessSafeKey from an UnboundKey.

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 OpeningKey::open_in_place(), except it accepts an arbitrary nonce.

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

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 OpeningKey::open_within(), except it accepts an arbitrary nonce.

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

pub fn seal_in_place<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>, [−]

👎 Deprecated:

Renamed to seal_in_place_append_tag.

Deprecated. Renamed to seal_in_place_append_tag().

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

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

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

The key’s AEAD algorithm.

Trait Implementations

impl Debug for LessSafeKey[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.