Struct SHA512Internal 

pub struct SHA512Internal<PARAMS: SHA2Params> { /* private fields */ }

Internal struct for SHA512. This uses a private bound so that you cannot instantiate it directly and have to use the provided and NIST-approved parameters.

Implementations

impl<PARAMS: SHA2Params> SHA512Internal<PARAMS>

pub fn new() -> Self

Creates a new SHA512 instance, ready for use.

Trait Implementations

impl<PARAMS: SHA2Params> Algorithm for SHA512Internal<PARAMS>

const ALG_NAME: &'static str = PARAMS::ALG_NAME

String name for the algorithm, used consistently across the library.

const MAX_SECURITY_STRENGTH: SecurityStrength = PARAMS::MAX_SECURITY_STRENGTH

Maximum security strength supported by the algorithm. In other words, this algorithm can produce outputs up to this security strength, but may produce outputs with lower security strength, for example, if asked to truncate.

impl<PARAMS: Clone + SHA2Params> Clone for SHA512Internal<PARAMS>

fn clone(&self) -> SHA512Internal<PARAMS>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<PARAMS: SHA2Params> Default for SHA512Internal<PARAMS>

fn default() -> Self

Returns the “default value” for a type.

impl<PARAMS: SHA2Params> Hash for SHA512Internal<PARAMS>

fn block_bitlen(&self) -> usize

As per FIPS 180-4 Figure 1

fn do_final_partial_bits( self, partial_byte: u8, num_partial_bits: usize, ) -> Result<Vec<u8>, HashError>

TODO: This is defined in FIPS 180-4 s. 5.1.2 TODO: https://pages.nist.gov/ACVP/draft-celi-acvp-sha.html TODO: It can be implemented if required

fn do_final_partial_bits_out( self, partial_byte: u8, num_partial_bits: usize, output: &mut [u8], ) -> Result<usize, HashError>

TODO: This is defined in FIPS 180-4 s. 5.1.2 TODO: https://pages.nist.gov/ACVP/draft-celi-acvp-sha.html TODO: It can be implemented if required

fn output_len(&self) -> usize

The size of the output in bytes.

fn hash(self, data: &[u8]) -> Vec<u8>

A static one-shot API that hashes the provided data. data can be of any length, including zero bytes.

fn hash_out(self, data: &[u8], output: &mut [u8]) -> usize

A static one-shot API that hashes the provided data into the provided output slice. data can be of any length, including zero bytes. The entire output buffer is zeroized before the hash output is written. The return value is the number of bytes written.

fn do_update(&mut self, block: &[u8])

Provide a chunk of data to be absorbed into the hashes. data can be of any length, including zero bytes. do_update() is intended to be used as part of a streaming interface, and so may by called multiple times.

fn do_final(self) -> Vec<u8>

Finish absorbing input and produce the hashes output. Consumes self, so this must be the final call to this object.

fn do_final_out(self, output: &mut [u8]) -> usize

Finish absorbing input and produce the hashes output. Consumes self, so this must be the final call to this object.

fn max_security_strength(&self) -> SecurityStrength

Returns the maximum security strength that this KDF is capable of supporting, based on the underlying primitives.

impl<PARAMS: SHA2Params> Suspendable<SUSPENDED_SHA512_STATE_LEN> for SHA512Internal<PARAMS>

fn suspend(self) -> [u8; 204]

Suspend operation by serializing out the state of the object.

fn from_suspended(serialized_state: [u8; 204]) -> Result<Self, SuspendableError>

Resume operation from a serialized state.