aws_lc_rs::cipher

Struct EncryptingKey

Source
pub struct EncryptingKey { /* private fields */ }
Expand description

A cipher encryption key that does not perform block padding.

Implementations§

Source§

impl EncryptingKey

Source

pub fn ctr(key: UnboundCipherKey) -> Result<Self, Unspecified>

Constructs an EncryptingKey operating in counter (CTR) mode using the provided key.

§Errors
  • Unspecified: Returned if there is an error constructing the EncryptingKey.
Source

pub fn cfb128(key: UnboundCipherKey) -> Result<Self, Unspecified>

Constructs an EncryptingKey operating in cipher feedback 128-bit mode (CFB128) using the provided key.

§Errors
  • Unspecified: Returned if there is an error constructing the EncryptingKey.
Source

pub fn ecb(key: UnboundCipherKey) -> Result<Self, Unspecified>

Constructs an EncryptingKey operating in electronic code book mode (ECB) using the provided key.

§☠️ ️️️DANGER ☠️

Offered for computability purposes only. This is an extremely dangerous mode, and very likely not what you want to use.

§Errors
  • Unspecified: Returned if there is an error constructing the EncryptingKey.
Source

pub fn algorithm(&self) -> &Algorithm

Returns the cipher algorithm.

Source

pub fn mode(&self) -> OperatingMode

Returns the cipher operating mode.

Source

pub fn encrypt( &self, in_out: &mut [u8], ) -> Result<DecryptionContext, Unspecified>

Encrypts the data provided in in_out in-place. Returns a DecryptionContext with the randomly generated IV that was used to encrypt the data provided.

If EncryptingKey is operating in OperatingMode::ECB, then in_out.len() must be a multiple of the block length.

§Errors
  • Unspecified: Returned if cipher mode requires input to be a multiple of the block length, and in_out.len() is not. Otherwise, returned if encryption fails.
Source

pub fn less_safe_encrypt( &self, in_out: &mut [u8], context: EncryptionContext, ) -> Result<DecryptionContext, Unspecified>

Encrypts the data provided in in_out in-place using the provided EncryptionContext. This is considered “less safe” because the caller could potentially construct a EncryptionContext from a previously used IV (initialization vector). Returns a DecryptionContext produced from the provided EncryptionContext.

If EncryptingKey is operating in OperatingMode::ECB, then in_out.len() must be a multiple of the block length.

§Errors
  • Unspecified: Returned if cipher mode requires input to be a multiple of the block length, and in_out.len() is not. Otherwise returned if encryption fails.

Trait Implementations§

Source§

impl Debug for EncryptingKey

Source§

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

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