Struct aesstream::AesReader

pub struct AesReader<D: BlockDecryptor, R: Read> { /* fields omitted */ }

Wraps a Read implementation with CBC based on given BlockDecryptor

Examples

Read encrypted file.

let key: [u8; 16] = OsRng::new()?.gen();
let file = File::open("...")?;
let decryptor = AesSafe128Decryptor::new(&key);
let mut reader = AesReader::new(file, decryptor)?;
let mut decrypted = Vec::new();
reader.read_to_end(&mut decrypted)?;

Decrypt in-memory.

let encrypted = vec![];
let key: [u8; 16] = OsRng::new()?.gen();
let decryptor = AesSafe128Decryptor::new(&key);
let mut reader = AesReader::new(Cursor::new(encrypted), decryptor)?;
let mut decrypted = Vec::new();
reader.read_to_end(&mut decrypted)?;

Methods

impl<D: BlockDecryptor, R: Read> AesReader<D, R>

fn new(reader: R, dec: D) -> Result<AesReader<D, R>>

Creates a new AesReader.

Assumes that the first block of given reader is the IV.

Parameters

• reader: Reader to read encrypted data from
• dec: BlockDecryptor to use for decyrption

Examples

let key: [u8; 16] = OsRng::new()?.gen();
let decryptor = AesSafe128Decryptor::new(&key);
let file = File::open("...")?;
let mut reader = AesReader::new(file, decryptor)?;

Trait Implementations

impl<D: BlockDecryptor, R: Read> Read for AesReader<D, R>

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Reads encrypted data from the underlying reader, decrypts it and writes the result into the passed buffer.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>

Read all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Read all bytes until EOF in this source, placing them into buf.

fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>

Read the exact number of bytes required to fill buf.

fn by_ref(&mut self) -> &mut Self

Creates a "by reference" adaptor for this instance of Read.

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an Iterator over its bytes.

fn chars(self) -> Chars<Self>

🔬 This is a nightly-only experimental API. (io)

the semantics of a partial read/write of where errors happen is currently unclear and may change

Transforms this Read instance to an Iterator over chars.

fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adaptor which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

Creates an adaptor which will read at most limit bytes from it.

impl<D: BlockDecryptor, R: Read + Seek> Seek for AesReader<D, R>

fn seek(&mut self, pos: SeekFrom) -> Result<u64>

Seek to an offset, in bytes, in a stream.

When seeking, this reader takes care of reinitializing the CbcDecryptor with the correct IV. The passed position does not need to be aligned to the blocksize.