Trait aead::AeadInPlace [−][src]
pub trait AeadInPlace {
type NonceSize: ArrayLength<u8>;
type TagSize: ArrayLength<u8>;
type CiphertextOverhead: ArrayLength<u8> + Unsigned;
fn encrypt_in_place_detached(
&self,
nonce: &Nonce<Self::NonceSize>,
associated_data: &[u8],
buffer: &mut [u8]
) -> Result<Tag<Self::TagSize>, Error>;
fn decrypt_in_place_detached(
&self,
nonce: &Nonce<Self::NonceSize>,
associated_data: &[u8],
buffer: &mut [u8],
tag: &Tag<Self::TagSize>
) -> Result<(), Error>;
fn encrypt_in_place(
&self,
nonce: &Nonce<Self::NonceSize>,
associated_data: &[u8],
buffer: &mut dyn Buffer
) -> Result<(), Error> { ... }
fn decrypt_in_place(
&self,
nonce: &Nonce<Self::NonceSize>,
associated_data: &[u8],
buffer: &mut dyn Buffer
) -> Result<(), Error> { ... }
}
Expand description
In-place stateless AEAD trait.
This trait is both object safe and has no dependencies on alloc
or std
.
Associated Types
type NonceSize: ArrayLength<u8>
type NonceSize: ArrayLength<u8>
The length of a nonce.
type TagSize: ArrayLength<u8>
type TagSize: ArrayLength<u8>
The maximum length of the nonce.
type CiphertextOverhead: ArrayLength<u8> + Unsigned
type CiphertextOverhead: ArrayLength<u8> + Unsigned
The upper bound amount of additional space required to support a ciphertext vs. a plaintext.
Required methods
Encrypt the data in-place, returning the authentication tag
Decrypt the message in-place, returning an error in the event the provided authentication tag does not match the given ciphertext (i.e. ciphertext is modified/unauthentic)
Provided methods
Encrypt the given buffer containing a plaintext message in-place.
The buffer must have sufficient capacity to store the ciphertext message, which will always be larger than the original plaintext. The exact size needed is cipher-dependent, but generally includes the size of an authentication tag.
Returns an error if the buffer has insufficient capacity to store the resulting ciphertext message.
Decrypt the message in-place, returning an error in the event the provided authentication tag does not match the given ciphertext.
The buffer will be truncated to the length of the original plaintext message upon success.