Struct KcApi

pub struct KcApi { /* private fields */ }

Entry structure to linux kernel crypto api. All method low level (i.e. libc calls) errors are logued at debug level to allow investigation in case of unexpected error.

Implementations

impl KcApi

pub fn new(alg_type: &str, alg_name: &str) -> Result<Self, Error>

New from algorithm name and type.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 socket and man 2 bind

pub fn set_key<T>(&self, key: &T) -> Result<(), Error>

where T: AsRef<[u8]> + Clone,

Set Cipher key. See KCAPI setsockopt

Errors

• Error::Sys(Errno) in case of low level error. See man 2 setsockopt

pub fn set_aead_auth_size(&self, size: usize) -> Result<(), Error>

Set authentication tag size for AEAD ciphers. See KCAPI setsockopt

Errors

• Error::Sys(Errno) in case of low level error. See man 2 setsockopt

pub fn init(&mut self) -> Result<(), Error>

Accept connexion to get operation socket Eventually close current connexion

Errors

• Error::Sys(Errno) in case of low level error. See man 2 close and man 2 accept

pub fn finish(&mut self) -> Result<(), Error>

Close current connexion.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 close

pub fn set_option( &self, iv: Option<&[u8]>, aad: Option<u32>, dir: Option<Direction>, ) -> Result<(), Error>

Set cipher option. See KCAPI symmetric-cipher-api and See KCAPI aead-cipher-api

Errors

• Error::Sys(Errno) in case of low level error. See man 2 sendmsg

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

Get processed data.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 read

pub fn send_data_with_option( &self, iv: Option<&[u8]>, aad: Option<u32>, dir: Option<Direction>, data: &[u8], more_data: DataPos, ) -> Result<usize, Error>

Send data to be processed.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 sendmsg

pub fn send_data(&self, data: &[u8], more_data: DataPos) -> Result<usize, Error>

Send data to be processed.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 send

pub fn send_data_no_copy( &self, data: &[u8], more_data: DataPos, ) -> Result<usize, Error>

Send data to be processed.

Errors

• Error::Sys(Errno) in case of low level error. See man 2 vmsplice, man 2 splice, man 2 close

Trait Implementations

impl Drop for KcApi

fn drop(&mut self)

Executes the destructor for this type.