Struct ffsend_api::pipe::crypto::gcm::GcmCrypt

pub struct GcmCrypt { /* fields omitted */ }

Something that can encrypt or decrypt given data using AES-GCM.

Methods

impl GcmCrypt

pub fn new(mode: CryptMode, len: usize, key: &[u8], iv: &[u8]) -> Self

Construct a new AES-GCM crypter.

It is highly recommended to use the encrypt() and decrypt() methods instead for constructing a new crypter.

The mode parameter defines whether this encrypts or decrypts. The length of the payload to encrypt or decrypt must be given to len, this excludes the appended verification tag on the encrypted payload.

The crypto key and input vector iv must also be given.

pub fn encrypt(len: usize, key: &[u8], iv: &[u8]) -> Self

Create an AES-GCM encryptor.

The size in bytes of the data to encrypt must be given as len.

The encryption key and input vector iv must also be given.

pub fn decrypt(len: usize, key: &[u8], iv: &[u8]) -> Self

Create an AES-GCM decryptor.

The size in bytes of the data to decrypt must be given as len, including the size of the suffixed tag.

The decryption key and input vector iv must also be given.

pub fn has_tag(&self) -> bool

Check if the AES-GCM cryptographic tag is known.

When decrypting, this means all data has been processed and the suffixed tag was obtained.

Trait Implementations

impl Crypt for GcmCrypt

fn crypt(&mut self, input: &[u8]) -> (usize, Option<Vec<u8>>)

Encrypt/decrypt bytes from input, return the result.

impl Pipe for GcmCrypt

type Reader = GcmReader

The wrapping reader type used for this pipe.

type Writer = GcmWriter

The wrapping writer type used for this pipe.

fn pipe(&mut self, input: &[u8]) -> (usize, Option<Vec<u8>>)

Pipe bytes from input, monitor/transform it, return the output.

fn reader(self, inner: Box<dyn Read>) -> Self::Reader

Wrap the inner reader, bytes that are read are transformed through this pipe.

fn writer(self, inner: Box<dyn Write>) -> Self::Writer

Wrap the inner writer, bytes that are read are transformed through this pipe.

fn pipe_transparent(&self, input: &[u8]) -> (usize, Option<Vec<u8>>)

Transparently pipe input by immediately returning it.

impl PipeRead<GcmCrypt> for GcmReader

fn new(crypt: GcmCrypt, inner: Box<dyn Read>) -> Self

Wrap the given inner reader, transform data using crypt.

impl PipeWrite<GcmCrypt> for GcmWriter

fn new(crypt: GcmCrypt, inner: Box<dyn Write>) -> Self

Wrap the given inner writer, transform data using crypt.

impl PipeLen for GcmCrypt

fn len_in(&self) -> usize

The number of bytes that are transfered into the pipe if fixed.

fn len_out(&self) -> usize

The number of bytes that are transfered out of the pipe if fixed.

impl Send for GcmCrypt