hash.c File Reference

#include "precomp.h"

Include dependency graph for hash.c:

Go to the source code of this file.

Functions
VOID SYMCRYPT_CALL	SymCryptHashAppendInternal (_In_ PCSYMCRYPT_HASH pHash, _Inout_ PSYMCRYPT_COMMON_HASH_STATE pState, _In_reads_bytes_(cbData) PCBYTE pbData, SIZE_T cbData)
VOID SYMCRYPT_CALL	SymCryptHashCommonPaddingMd4Style (_In_ PCSYMCRYPT_HASH pHash, _Inout_ PSYMCRYPT_COMMON_HASH_STATE pState)
SIZE_T SYMCRYPT_CALL	SymCryptHashResultSize (_In_ PCSYMCRYPT_HASH pHash)
SIZE_T SYMCRYPT_CALL	SymCryptHashInputBlockSize (_In_ PCSYMCRYPT_HASH pHash)
SIZE_T SYMCRYPT_CALL	SymCryptHashStateSize (_In_ PCSYMCRYPT_HASH pHash)
VOID SYMCRYPT_CALL	SymCryptHash (_In_ PCSYMCRYPT_HASH pHash, _In_reads_(cbData) PCBYTE pbData, SIZE_T cbData, _Out_writes_(SYMCRYPT_MIN(cbResult, pHash->resultSize)) PBYTE pbResult, SIZE_T cbResult)
VOID SYMCRYPT_CALL	SymCryptHashInit (_In_ PCSYMCRYPT_HASH pHash, _Out_writes_bytes_(pHash->stateSize) PVOID pState)
VOID SYMCRYPT_CALL	SymCryptHashAppend (_In_ PCSYMCRYPT_HASH pHash, _Inout_updates_bytes_(pHash->stateSize) PVOID pState, _In_reads_(cbData) PCBYTE pbData, SIZE_T cbData)
VOID SYMCRYPT_CALL	SymCryptHashResult (_In_ PCSYMCRYPT_HASH pHash, _Inout_updates_bytes_(pHash->stateSize) PVOID pState, _Out_writes_(SYMCRYPT_MIN(cbResult, pHash->resultSize)) PBYTE pbResult, SIZE_T cbResult)
VOID SYMCRYPT_CALL	SymCryptHashStateCopy (_In_ PCSYMCRYPT_HASH pHash, _In_reads_(pHash->stateSize) PCVOID pSrc, _Out_writes_(pHash->stateSize) PVOID pDst)

Function Documentation

SymCryptHash()

VOID SYMCRYPT_CALL SymCryptHash	(	_In_ PCSYMCRYPT_HASH	pHash,
		_In_reads_(cbData) PCBYTE	pbData,
		SIZE_T	cbData,
		_Out_writes_(SYMCRYPT_MIN(cbResult, pHash->resultSize)) PBYTE	pbResult,
		SIZE_T	cbResult
	)

Definition at line 155 of file hash.c.

{
    SYMCRYPT_HASH_STATE hash;
 
    _Analysis_assume_( pHash->stateSize <= sizeof( hash ) );
    SymCryptHashInit( pHash, &hash );
    SymCryptHashAppend( pHash, &hash, pbData, cbData );
    SymCryptHashResult( pHash, &hash, pbResult, cbResult );
    SymCryptWipe( &hash, pHash->stateSize );
}

Referenced by SymCryptDlgroupGeneratePrimeP_FIPS(), SymCryptDlgroupGeneratePrimeQ_FIPS(), SymCryptHmacExpandKey(), SymCryptRsaOaepApplyEncryptionPadding(), SymCryptRsaOaepRemoveEncryptionPadding(), SymCryptRsaPssApplySignaturePadding(), and SymCryptRsaPssVerifySignaturePadding().

SymCryptHashAppend()

VOID SYMCRYPT_CALL SymCryptHashAppend	(	_In_ PCSYMCRYPT_HASH	pHash,
		_Inout_updates_bytes_(pHash->stateSize) PVOID	pState,
		_In_reads_(cbData) PCBYTE	pbData,
		SIZE_T	cbData
	)

Definition at line 182 of file hash.c.

{
    (*pHash->appendFunc)( pState, pbData, cbData );
}

Referenced by LmsComputeOtsPubKeyCandidate(), LmsComputeRootCandidate(), LmsHashMessage(), LmsOtskeyComputePrivate(), LmsOtskeyComputePublic(), LmsOtskeySign(), SymCryptDlgroupGenerateGenG_FIPS(), SymCryptHash(), SymCryptHmacAppend(), SymCryptHmacExpandKey(), SymCryptHmacResult(), SymCryptRsaPaddingMaskGeneration(), SymCryptSshKdfDerive(), SymCryptSshKdfExpandKey(), SymCryptSskdfHash(), SymCryptXmssChain(), SymCryptXmssCreateWotspSecret(), SymCryptXmssPrf(), SymCryptXmssPrfInit(), SymCryptXmssPrfKey(), SymCryptXmssRandHash(), SymCryptXmssRandomizedHash(), and update_hash_impl().

SymCryptHashAppendInternal()

VOID SYMCRYPT_CALL SymCryptHashAppendInternal	(	_In_ PCSYMCRYPT_HASH	pHash,
		_Inout_ PSYMCRYPT_COMMON_HASH_STATE	pState,
		_In_reads_bytes_(cbData) PCBYTE	pbData,
		SIZE_T	cbData
	)

Definition at line 10 of file hash.c.

{
    UINT32  bytesInBuffer;
    UINT32  freeInBuffer;
    SIZE_T  tmp;
 
    SYMCRYPT_CHECK_MAGIC( pState );
 
    pState->dataLengthL += cbData;
    if( pState->dataLengthL < cbData ) {
        pState->dataLengthH ++;                         // This is almost-unreachable code as it requires 2^64 bytes to be hashed.
    }
 
    bytesInBuffer = pState->bytesInBuffer;
 
    //
    // If previous data in buffer, buffer new input and transform if possible.
    //
    if( bytesInBuffer > 0 )
    {
        SYMCRYPT_ASSERT( pHash->inputBlockSize > bytesInBuffer );
 
        freeInBuffer = pHash->inputBlockSize - bytesInBuffer;
        if( cbData < freeInBuffer )
        {
            //
            // All the data will fit in the buffer.
            // We don't do anything here.
            // As cbData < inputBlockSize the bulk data processing is skipped,
            // and the data will be copied to the buffer at the end
            // of this code.
        } else {
            //
            // Enough data to fill the whole buffer & process it
            //
            memcpy(&pState->buffer[bytesInBuffer], pbData, freeInBuffer);
            pbData += freeInBuffer;
            cbData -= freeInBuffer;
            (*pHash->appendBlockFunc)( (PBYTE)pState + pHash->chainOffset, &pState->buffer[0], pHash->inputBlockSize, &tmp );
 
            bytesInBuffer = 0;
        }
    }
 
    //
    // Internal buffer is empty; process all remaining whole blocks in the input
    //
    if( cbData >= pHash->inputBlockSize )
    {
        (*pHash->appendBlockFunc)( (PBYTE)pState + pHash->chainOffset, pbData, cbData, &tmp );
        SYMCRYPT_ASSERT( tmp < pHash->inputBlockSize );
        pbData += cbData - tmp;
        cbData = tmp;
    }
 
    SYMCRYPT_ASSERT( cbData < pHash->inputBlockSize );
 
    //
    // buffer remaining input if necessary.
    //
    if( cbData > 0 )
    {
        memcpy( &pState->buffer[bytesInBuffer], pbData, cbData );
        bytesInBuffer += (UINT32) cbData;
    }
 
    pState->bytesInBuffer = bytesInBuffer;
}

Referenced by SymCryptMd2Append(), SymCryptMd4Append(), SymCryptMd5Append(), and SymCryptSha1Append().

SymCryptHashCommonPaddingMd4Style()

VOID SYMCRYPT_CALL SymCryptHashCommonPaddingMd4Style	(	_In_ PCSYMCRYPT_HASH	pHash,
		_Inout_ PSYMCRYPT_COMMON_HASH_STATE	pState
	)

Definition at line 85 of file hash.c.

{
    SIZE_T tmp;
    SIZE_T bytesInBuffer = pState->bytesInBuffer;
 
    SYMCRYPT_CHECK_MAGIC( pState );
    SYMCRYPT_ASSERT( pHash->inputBlockSize == 64 );
    SYMCRYPT_ASSERT( bytesInBuffer == (pState->dataLengthL & 0x3f) );
 
    //
    // The buffer is never completely full, so we can always put the first
    // padding byte in.
    //
    pState->buffer[bytesInBuffer++] = 0x80;
 
    if( bytesInBuffer > 64-8 ) {
        //
        // No room for the rest of the padding. Pad with zeroes & process block
        // bytesInBuffer is at most 64, so we do not have an integer underflow
        //
        SymCryptWipe( &pState->buffer[bytesInBuffer], 64-bytesInBuffer );
        (*pHash->appendBlockFunc)( (PBYTE)pState + pHash->chainOffset, pState->buffer, 64, &tmp );
        SYMCRYPT_ASSERT( tmp == 0 );
        bytesInBuffer = 0;
    }
 
    //
    // Set rest of padding
    // At this point bytesInBuffer <= 64-8, so we don't have an underflow
    // We wipe to the end of the buffer as it is 16-aligned,
    // and it is faster to wipe to an aligned point
    //
    SymCryptWipe( &pState->buffer[bytesInBuffer], 64-bytesInBuffer );
    SYMCRYPT_STORE_LSBFIRST64( &pState->buffer[64-8], pState->dataLengthL * 8 );
 
    //
    // Process the final block
    //
    (*pHash->appendBlockFunc)( (PBYTE)pState + pHash->chainOffset, pState->buffer, 64, &tmp );
}

Referenced by SymCryptMd4Result(), and SymCryptMd5Result().

SymCryptHashInit()

VOID SYMCRYPT_CALL SymCryptHashInit	(	_In_ PCSYMCRYPT_HASH	pHash,
		_Out_writes_bytes_(pHash->stateSize) PVOID	pState
	)

Definition at line 173 of file hash.c.

{
    (*pHash->initFunc)( pState );
}

Referenced by init_hash_impl(), LmsComputeOtsPubKeyCandidate(), LmsComputeRootCandidate(), LmsHashMessage(), LmsOtskeyComputePrivate(), LmsOtskeyComputePublic(), LmsOtskeySign(), SymCryptDlgroupGenerateGenG_FIPS(), SymCryptHash(), SymCryptHmacExpandKey(), SymCryptRsaPaddingMaskGeneration(), SymCryptSshKdfExpandKey(), SymCryptSskdfHash(), and SymCryptXmssPrfInit().

SymCryptHashInputBlockSize()

SIZE_T SYMCRYPT_CALL SymCryptHashInputBlockSize

(

_In_ PCSYMCRYPT_HASH

pHash

)

Definition at line 140 of file hash.c.

{
    return pHash->inputBlockSize;
}

Referenced by hash_block_len_impl(), and SymCryptSskdfMacExpandSalt().

SymCryptHashResult()

VOID SYMCRYPT_CALL SymCryptHashResult	(	_In_ PCSYMCRYPT_HASH	pHash,
		_Inout_updates_bytes_(pHash->stateSize) PVOID	pState,
		_Out_writes_(SYMCRYPT_MIN(cbResult, pHash->resultSize)) PBYTE	pbResult,
		SIZE_T	cbResult
	)

Definition at line 193 of file hash.c.

{
    BYTE    buf[SYMCRYPT_HASH_MAX_RESULT_SIZE];
 
    _Analysis_assume_( pHash->resultSize <= SYMCRYPT_HASH_MAX_RESULT_SIZE );
 
    (*pHash->resultFunc)( pState, buf );
    memcpy( pbResult, buf, SYMCRYPT_MIN( cbResult, pHash->resultSize ));
    SymCryptWipe( buf, pHash->resultSize );
}

Referenced by finalize_hash_impl(), LmsComputeOtsPubKeyCandidate(), LmsComputeRootCandidate(), LmsHashMessage(), LmsOtskeyComputePrivate(), LmsOtskeyComputePublic(), LmsOtskeySign(), SymCryptDlgroupGenerateGenG_FIPS(), SymCryptHash(), SymCryptHmacResult(), SymCryptRsaPaddingMaskGeneration(), SymCryptSshKdfDerive(), SymCryptSskdfHash(), SymCryptXmssChain(), SymCryptXmssCreateWotspSecret(), SymCryptXmssPrf(), SymCryptXmssRandHash(), and SymCryptXmssRandomizedHash().

SymCryptHashResultSize()

SIZE_T SYMCRYPT_CALL SymCryptHashResultSize

(

_In_ PCSYMCRYPT_HASH

pHash

)

Definition at line 132 of file hash.c.

{
    return pHash->resultSize;
}

Referenced by hash_len_impl(), SymCryptDlgroupGenerate(), SymCryptDlgroupGenerateGenG_FIPS(), SymCryptDlgroupGeneratePrimeP_FIPS(), SymCryptDlgroupGeneratePrimeQ_FIPS(), SymCryptDlgroupScratchSpace_FIPS(), SymCryptRsaOaepApplyEncryptionPadding(), SymCryptRsaOaepRemoveEncryptionPadding(), SymCryptRsaPaddingMaskGeneration(), SymCryptRsaPssApplySignaturePadding(), SymCryptRsaPssVerifySignaturePadding(), and SymCryptSshKdfDerive().

SymCryptHashStateCopy()

VOID SYMCRYPT_CALL SymCryptHashStateCopy	(	_In_ PCSYMCRYPT_HASH	pHash,
		_In_reads_(pHash->stateSize) PCVOID	pSrc,
		_Out_writes_(pHash->stateSize) PVOID	pDst
	)

Definition at line 210 of file hash.c.

{
    (*pHash->stateCopyFunc)( pSrc, pDst );
}

Referenced by SymCryptHmacInit(), SymCryptHmacKeyCopy(), SymCryptHmacResult(), SymCryptHmacStateCopy(), SymCryptSshKdfDerive(), SymCryptXmssChain(), and SymCryptXmssRandHash().

SymCryptHashStateSize()

SIZE_T SYMCRYPT_CALL SymCryptHashStateSize

(

_In_ PCSYMCRYPT_HASH

pHash

)

Definition at line 147 of file hash.c.

{
    return pHash->stateSize;
}

Referenced by SymCryptDlgroupGenerateGenG_FIPS(), SymCryptDlgroupScratchSpace_FIPS(), SymCryptRsaOaepApplyEncryptionPadding(), SymCryptRsaOaepRemoveEncryptionPadding(), SymCryptRsaPssApplySignaturePadding(), and SymCryptRsaPssVerifySignaturePadding().