Struct ShaDriver 

pub struct ShaDriver<'a, H: DigestDataHash<'a, DIGEST_LEN>, const DIGEST_LEN: usize> { /* private fields */ }

Implementations

impl<'a, H: DigestDataHash<'a, DIGEST_LEN> + Sha256, const DIGEST_LEN: usize> ShaDriver<'a, H, DIGEST_LEN>

pub fn new( sha: &'a H, data_buffer: &'static mut [u8], dest_buffer: &'static mut [u8; DIGEST_LEN], grant: Grant<App, UpcallCount<{ upcall::COUNT }>, AllowRoCount<{ ro_allow::COUNT }>, AllowRwCount<{ rw_allow::COUNT }>>, ) -> ShaDriver<'a, H, DIGEST_LEN>

Trait Implementations

impl<'a, H: DigestDataHash<'a, DIGEST_LEN> + Sha256, const DIGEST_LEN: usize> ClientData<DIGEST_LEN> for ShaDriver<'a, H, DIGEST_LEN>

fn add_data_done( &self, _result: Result<(), ErrorCode>, _data: SubSlice<'static, u8>, )

Called when the data has been added to the digest.

fn add_mut_data_done( &self, _result: Result<(), ErrorCode>, data: SubSliceMut<'static, u8>, )

Called when the data has been added to the digest.

impl<'a, H: DigestDataHash<'a, DIGEST_LEN> + Sha256, const DIGEST_LEN: usize> ClientHash<DIGEST_LEN> for ShaDriver<'a, H, DIGEST_LEN>

fn hash_done( &self, result: Result<(), ErrorCode>, digest: &'static mut [u8; DIGEST_LEN], )

Called when a digest is computed.

impl<'a, H: DigestDataHash<'a, DIGEST_LEN> + Sha256, const DIGEST_LEN: usize> SyscallDriver for ShaDriver<'a, H, DIGEST_LEN>

fn command( &self, command_num: usize, data1: usize, _data2: usize, processid: ProcessId, ) -> CommandReturn

Setup and run a SHA hash.

We expect userspace to setup buffers for the data, and either the generated hash or a hash to compare with. These buffers must be allocated and specified to the kernel with allow calls.

We expect userspace not to change the value while running. If userspace changes the value we have no guarantee of what is passed to the hardware. This isn’t a security issue, it will just provide the requesting app with invalid data.

The driver will take care of clearing data from the underlying implementation by calling the clear_data() function when the hash_complete() callback is called or if an error is encountered.

command_num

• 0: driver check
• 1: set_algorithm
• 2: hash

fn allocate_grant(&self, processid: ProcessId) -> Result<(), Error>

Request to allocate a capsule’s grant for a specific process.

fn allow_userspace_readable( &self, app: ProcessId, which: usize, slice: ReadWriteProcessBuffer, ) -> Result<ReadWriteProcessBuffer, (ReadWriteProcessBuffer, ErrorCode)>

System call for a process to pass a buffer (a UserspaceReadableProcessBuffer) to the kernel that the kernel can either read or write. The kernel calls this method only after it checks that the entire buffer is within memory the process can both read and write.