libmain.c File Reference

#include "precomp.h"
#include "C_asm_shared.inc"
#include "buildInfo.h"

Include dependency graph for libmain.c:

Go to the source code of this file.

Macros
#define	SYMCRYPT_CHECK_ASM_OFFSET(a, b)   if( (a) != (b) ) {SymCryptFatal( b );}

Functions
VOID SYMCRYPT_CALL	SymCryptInitEnvCommon (UINT32 version)
_Analysis_noreturn_ SYMCRYPT_NOINLINE VOID SYMCRYPT_CALL	SymCryptFatalHang (UINT32 fatalCode)
VOID SYMCRYPT_CALL	SymCryptWipe (_Out_writes_bytes_(cbData) PVOID pbData, SIZE_T cbData)
VOID SYMCRYPT_CALL	SymCryptXorBytes (_In_reads_(cbBytes) PCBYTE pbSrc1, _In_reads_(cbBytes) PCBYTE pbSrc2, _Out_writes_(cbBytes) PBYTE pbResult, SIZE_T cbBytes)
UINT32	SymCryptUint32Bitsize (UINT32 value)
UINT32	SymCryptUint64Bitsize (UINT64 value)
UINT32	SymCryptUint32Bytesize (UINT32 value)
UINT32	SymCryptUint64Bytesize (UINT64 value)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptLoadLsbFirstUint32 (_In_reads_(cbSrc) PCBYTE pbSrc, SIZE_T cbSrc, _Out_ PUINT32 pDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptLoadLsbFirstUint64 (_In_reads_(cbSrc) PCBYTE pbSrc, SIZE_T cbSrc, _Out_ PUINT64 pDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptLoadMsbFirstUint32 (_In_reads_(cbSrc) PCBYTE pbSrc, SIZE_T cbSrc, _Out_ PUINT32 pDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptLoadMsbFirstUint64 (_In_reads_(cbSrc) PCBYTE pbSrc, SIZE_T cbSrc, _Out_ PUINT64 pDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptStoreLsbFirstUint32 (UINT32 src, _Out_writes_(cbDst) PBYTE pbDst, SIZE_T cbDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptStoreLsbFirstUint64 (UINT64 src, _Out_writes_(cbDst) PBYTE pbDst, SIZE_T cbDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptStoreMsbFirstUint32 (UINT32 src, _Out_writes_(cbDst) PBYTE pbDst, SIZE_T cbDst)
SYMCRYPT_ERROR SYMCRYPT_CALL	SymCryptStoreMsbFirstUint64 (UINT64 src, _Out_writes_(cbDst) PBYTE pbDst, SIZE_T cbDst)

Variables
UINT32	g_SymCryptFlags = 0
SYMCRYPT_CPU_FEATURES	g_SymCryptCpuFeaturesNotPresent = (SYMCRYPT_CPU_FEATURES) ~0
SYMCRYPT_CPU_FEATURES	g_SymCryptCpuFeaturesPresentCheck = 0
const CHAR *const	SymCryptBuildString

Macro Definition Documentation

SYMCRYPT_CHECK_ASM_OFFSET

#define SYMCRYPT_CHECK_ASM_OFFSET	(		a,
			b
	)		if( (a) != (b) ) {SymCryptFatal( b );}

Function Documentation

SymCryptFatalHang()

_Analysis_noreturn_ SYMCRYPT_NOINLINE VOID SYMCRYPT_CALL SymCryptFatalHang

(

UINT32

fatalCode

)

Definition at line 101 of file libmain.c.

{
    UINT32   fcode;
 
    //
    // Put the fatal code in a location we can find
    //
    SYMCRYPT_FORCE_WRITE32( &fcode, fatalCode );
 
fatalInfiniteLoop:
    goto fatalInfiniteLoop;
}

Referenced by SymCryptFatalEnvWindowsUsermodeWin8_1nLater().

SymCryptInitEnvCommon()

VOID SYMCRYPT_CALL SymCryptInitEnvCommon

(

UINT32

version

)

Definition at line 43 of file libmain.c.

{
    UINT32 tmp;
 
    const CHAR * p;
 
    // Assertion that verifies that the calling application was compiled with
    // the same version header files as the library.
    if( version != SYMCRYPT_API_VERSION )
    {
        SymCryptFatal( 'apiv' );
    }
 
    //
    // Use an interlocked to set the flag in case we add other flags
    // that are modified by different threads.
    //
    SYMCRYPT_ATOMIC_OR32_PRE_RELAXED( &g_SymCryptFlags, SYMCRYPT_FLAG_LIB_INITIALIZED );
 
    //
    // Do a forced write of our code version. This ensures that the code
    // version is part of the binary, so we can look at a binary and figure
    // out which version of SymCrypt it was linked with.
    //
    SYMCRYPT_FORCE_WRITE32( &tmp, SYMCRYPT_API_VERSION );
 
    //
    // Force the build string to be in memory, because otherwise the
    // compiler might get smart and remove it.
    // This ensures we can always track back to the SymCrypt source code from
    // any binary that links this library
    //
    for( p = SymCryptBuildString; *p!=0; p++ )
    {
        SYMCRYPT_FORCE_WRITE8( (PBYTE) &tmp, *p );
    }
 
    //
    // Make an inverted copy of the CPU detection results.
    // This helps us diagnose corruption of our flags
    // Force-write otherwise the compiler optimizes it away
    //
    SYMCRYPT_FORCE_WRITE32( &g_SymCryptCpuFeaturesPresentCheck, ~g_SymCryptCpuFeaturesNotPresent );
 
    //
    // Test that the C and assembler code agree on the various structure member offsets.
    // This gets optimized away in FRE builds as all the values are compile-time computable.
    //
#define SYMCRYPT_CHECK_ASM_OFFSET( a, b ) if( (a) != (b) ) {SymCryptFatal( b );}
    SYMCRYPT_CHECK_ASM_OFFSETS;
#undef SYMCRYPT_CHECK_ASM_OFFSET
}

Referenced by SymCryptInitEnvWindowsUsermodeWin8_1nLater().

SymCryptLoadLsbFirstUint32()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptLoadLsbFirstUint32	(	_In_reads_(cbSrc) PCBYTE	pbSrc,
		SIZE_T	cbSrc,
		_Out_ PUINT32	pDst
	)

Definition at line 341 of file libmain.c.

{
    UINT64 v64;
    UINT32 v32;
    SYMCRYPT_ERROR scError;
 
    scError = SymCryptLoadLsbFirstUint64( pbSrc, cbSrc, &v64 );
    if( scError != SYMCRYPT_NO_ERROR )
    {
        goto cleanup;
    }
 
    v32 = (UINT32) v64;
    if( v32 != v64 )
    {
        scError = SYMCRYPT_VALUE_TOO_LARGE;
        goto cleanup;
    }
 
    *pDst = v32;
 
cleanup:
    return scError;
}

SymCryptLoadLsbFirstUint64()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptLoadLsbFirstUint64	(	_In_reads_(cbSrc) PCBYTE	pbSrc,
		SIZE_T	cbSrc,
		_Out_ PUINT64	pDst
	)

Definition at line 371 of file libmain.c.

{
    UINT64 v;
    SYMCRYPT_ERROR scError = SYMCRYPT_NO_ERROR;
 
    v = 0;
    pbSrc += cbSrc;
    while( cbSrc > 8 )
    {
        if( *--pbSrc != 0 )
        {
            scError = SYMCRYPT_VALUE_TOO_LARGE;
            goto cleanup;
        }
        cbSrc--;
    }
 
    while( cbSrc > 0 )
    {
        v = (v << 8) | *--pbSrc;
        cbSrc--;
    }
 
    *pDst = v;
 
cleanup:
    return scError;
}

Referenced by SymCryptLoadLsbFirstUint32().

SymCryptLoadMsbFirstUint32()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptLoadMsbFirstUint32	(	_In_reads_(cbSrc) PCBYTE	pbSrc,
		SIZE_T	cbSrc,
		_Out_ PUINT32	pDst
	)

Definition at line 405 of file libmain.c.

{
    UINT64 v64;
    UINT32 v32;
    SYMCRYPT_ERROR scError;
 
    scError = SymCryptLoadMsbFirstUint64( pbSrc, cbSrc, &v64 );
    if( scError != SYMCRYPT_NO_ERROR )
    {
        goto cleanup;
    }
 
    v32 = (UINT32) v64;
    if( v32 != v64 )
    {
        scError = SYMCRYPT_VALUE_TOO_LARGE;
        goto cleanup;
    }
 
    *pDst = v32;
 
cleanup:
    return scError;
}

SymCryptLoadMsbFirstUint64()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptLoadMsbFirstUint64	(	_In_reads_(cbSrc) PCBYTE	pbSrc,
		SIZE_T	cbSrc,
		_Out_ PUINT64	pDst
	)

Definition at line 436 of file libmain.c.

{
    UINT64 v;
    SYMCRYPT_ERROR scError = SYMCRYPT_NO_ERROR;
 
    v = 0;
    while( cbSrc > 8 )
    {
        if( *pbSrc++ != 0 )
        {
            scError = SYMCRYPT_VALUE_TOO_LARGE;
            goto cleanup;
        }
        cbSrc--;
    }
 
    while( cbSrc > 0 )
    {
        v = (v << 8) | *pbSrc++;
        cbSrc--;
    }
 
    *pDst = v;
 
cleanup:
    return scError;
}

Referenced by SymCryptLoadMsbFirstUint32().

SymCryptStoreLsbFirstUint32()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptStoreLsbFirstUint32	(	UINT32	src,
		_Out_writes_(cbDst) PBYTE	pbDst,
		SIZE_T	cbDst
	)

Definition at line 470 of file libmain.c.

{
    return SymCryptStoreLsbFirstUint64( src, pbDst, cbDst );
}

SymCryptStoreLsbFirstUint64()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptStoreLsbFirstUint64	(	UINT64	src,
		_Out_writes_(cbDst) PBYTE	pbDst,
		SIZE_T	cbDst
	)

Definition at line 480 of file libmain.c.

{
    SYMCRYPT_ERROR scError = SYMCRYPT_NO_ERROR;
 
    while( cbDst > 0 )
    {
        *pbDst++ = (BYTE) src;
        src >>= 8;
        cbDst--;
    }
 
    if( src != 0 )
    {
        scError = SYMCRYPT_VALUE_TOO_LARGE;
        goto cleanup;
    }
 
cleanup:
    return scError;
}

Referenced by SymCryptStoreLsbFirstUint32().

SymCryptStoreMsbFirstUint32()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptStoreMsbFirstUint32	(	UINT32	src,
		_Out_writes_(cbDst) PBYTE	pbDst,
		SIZE_T	cbDst
	)

Definition at line 506 of file libmain.c.

{
    return SymCryptStoreMsbFirstUint64( src, pbDst, cbDst );
}

SymCryptStoreMsbFirstUint64()

SYMCRYPT_ERROR SYMCRYPT_CALL SymCryptStoreMsbFirstUint64	(	UINT64	src,
		_Out_writes_(cbDst) PBYTE	pbDst,
		SIZE_T	cbDst
	)

Definition at line 516 of file libmain.c.

{
    SYMCRYPT_ERROR scError = SYMCRYPT_NO_ERROR;
 
    pbDst += cbDst;
    while( cbDst > 0 )
    {
        *--pbDst = (BYTE) src;
        src >>= 8;
        cbDst--;
    }
 
    if( src != 0 )
    {
        scError = SYMCRYPT_VALUE_TOO_LARGE;
        goto cleanup;
    }
 
cleanup:
    return scError;
}

Referenced by SymCryptStoreMsbFirstUint32().

SymCryptUint32Bitsize()

UINT32 SymCryptUint32Bitsize

(

UINT32

value

)

Definition at line 262 of file libmain.c.

{
    UINT32 res;
 
    res = 0;
    while( value != 0 )
    {
        res += 1;
        value >>= 1;
    }
 
    return res;
}

Referenced by SymCryptUint64Bitsize().

SymCryptUint32Bytesize()

UINT32 SymCryptUint32Bytesize

(

UINT32

value

)

Definition at line 299 of file libmain.c.

{
    if( value == 0 )
    {
        return 0;
    }
    if( value < 0x100 )
    {
        return 1;
    }
    if( value < 0x10000 )
    {
        return 2;
    }
    if( value < 0x1000000 )
    {
        return 3;
    }
    return 4;
}

Referenced by SymCryptUint64Bytesize().

SymCryptUint64Bitsize()

UINT32 SymCryptUint64Bitsize

(

UINT64

value

)

Definition at line 281 of file libmain.c.

{
    UINT32 res;
    UINT32 upper;
 
    upper = (UINT32)(value >> 32);
 
    if( upper == 0 )
    {
        res = SymCryptUint32Bitsize( (UINT32) value );
    } else {
        res = 32 + SymCryptUint32Bitsize( upper );
    }
 
    return res;
}

SymCryptUint64Bytesize()

UINT32 SymCryptUint64Bytesize

(

UINT64

value

)

Definition at line 321 of file libmain.c.

{
    UINT32 res;
    UINT32 upper;
 
    upper = (UINT32)(value >> 32);
 
    if( upper == 0 )
    {
        res = SymCryptUint32Bytesize( (UINT32) value );
    } else {
        res = 4 + SymCryptUint32Bytesize( upper );
    }
 
    return res;
}

Referenced by SymCryptRsakeySizeofPublicExponent().

SymCryptWipe()

VOID SYMCRYPT_CALL SymCryptWipe	(	_Out_writes_bytes_(cbData) PVOID	pbData,
		SIZE_T	cbData
	)

Definition at line 137 of file libmain.c.

{
    volatile BYTE * p = (volatile BYTE *) pbData;
    SIZE_T i;
 
    for( i=0; i<cbData; i++ ){
        p[i] = 0;
    }
 
}

Referenced by SymCrypt802_11SaeCustomCommitCreateGeneric(), SymCrypt802_11SaeCustomCommitProcessGeneric(), SymCrypt802_11SaeCustomCreatePTGeneric(), SymCrypt802_11SaeCustomInit(), SymCrypt802_11SaeCustomInitH2EGeneric(), SYMCRYPT_HmacXxxResult(), SymCryptAesCmacResult(), SymCryptAesKwDecrypt(), SymCryptAesKwEncrypt(), SymCryptAesKwpDecrypt(), SymCryptAesKwpEncrypt(), SymCryptCcmDecrypt(), SymCryptCcmDecryptFinal(), SymCryptCcmEncryptFinal(), SymCryptChaCha20Crypt(), SymCryptDhSecretAgreement(), SymCryptDivisorWipe(), SymCryptDlgroupGenerate(), SymCryptDlgroupGetValue(), SymCryptDlgroupSetValue(), SymCryptDlgroupSetValueSafePrime(), SymCryptDlgroupWipe(), SymCryptDlkeyGenerate(), SymCryptDlkeyGetValue(), SymCryptDlkeySetValue(), SymCryptDlkeyWipe(), SymCryptDsaSignEx(), SymCryptDsaVerify(), SymCryptEcDhSecretAgreement(), SymCryptEcDsaSignEx(), SymCryptEcDsaVerify(), SymCryptEckeyGetValue(), SymCryptEckeySetRandom(), SymCryptEckeySetValue(), SymCryptEckeyWipe(), SymCryptEcpointWipe(), SymCryptEcurveAllocate(), SymCryptEcurveFree(), SymCryptEcurveInitialize(), SymCryptFdefClaimScratch(), SymCryptFdefCreateTrialDivisionContext(), SymCryptFdefFreeTrialDivisionContext(), SymCryptFdefIntAddMixedSize(), SymCryptFdefIntCopyMixedSize(), SymCryptFdefIntDivMod(), SymCryptFdefIntDivPow2(), SymCryptFdefIntMulMixedSize(), SymCryptFdefIntMulPow2(), SymCryptFdefIntSetValueUint32(), SymCryptFdefIntSetValueUint64(), SymCryptFdefIntSquare(), SymCryptFdefModElementSetValueNegUint32(), SymCryptFdefModElementSetValueUint32Generic(), SymCryptFdefModElementToIntGeneric(), SymCryptFdefModElementWipe(), SymCryptFdefModInvMontgomery(), SymCryptFdefModPreGetMontgomery(), SymCryptFdefModSetRandomGeneric(), SymCryptFdefModulusInitMontgomeryInternal(), SymCryptFdefRawDivMod(), SymCryptFdefRawMulC(), SymCryptFdefRawSquareC(), SymCryptGcmDecrypt(), SymCryptGcmPadMacData(), SymCryptGenerateSmallPrimes(), SymCryptHash(), SymCryptHashCommonPaddingMd4Style(), SymCryptHashResult(), SymCryptIntWipe(), SymCryptLmskeyAllocate(), SymCryptMlDsaHintBitPack(), SymCryptMlDsakeyFree(), SymCryptMlDsakeyGenerate(), SymCryptMlDsakeyInitialize(), SymCryptMlDsaTemporariesAllocateAndInitialize(), SymCryptMlDsaTemporariesFree(), SymCryptMlKemDecapsulate(), SymCryptMlKemEncapsulateEx(), SymCryptMlKemkeyFree(), SymCryptMlKemkeyGenerate(), SymCryptMlKemkeySetValue(), SymCryptMlKemVectorSetZero(), SymCryptModMultiExpWnafWithInterleaving(), SymCryptModulusWipe(), SymCryptPoly1305Result(), SymCryptRc4Init(), SymCryptRngAesBcc(), SymCryptRngAesGenerateBlocks(), SymCryptRsakeyCreate(), SymCryptRsakeyGenerate(), SymCryptRsakeyGetCrtValue(), SymCryptRsakeySetValueInternal(), SymCryptRsakeyWipe(), SymCryptRsaOaepApplyEncryptionPadding(), SymCryptRsaOaepDecrypt(), SymCryptRsaOaepEncrypt(), SymCryptRsaPkcs1CheckSignaturePadding(), SymCryptRsaPkcs1Decrypt(), SymCryptRsaPkcs1Encrypt(), SymCryptRsaPkcs1Sign(), SymCryptRsaPkcs1Verify(), SymCryptRsaPssApplySignaturePadding(), SymCryptRsaPssSign(), SymCryptRsaPssVerify(), SymCryptRsaPssVerifySignaturePadding(), SymCryptRsaRawDecrypt(), SymCryptRsaRawEncrypt(), SymCryptScsTableWipe(), SymCryptSessionGcmDecrypt(), SymCryptSha256Result(), SymCryptSha512Result(), SymCryptSrtpKdfDerive(), SymCryptTlsCbcHmacVerifyCore(), SymCryptWipeKnownSize(), SymCryptXmssComputePublicRoot(), SymCryptXmsskeyAllocate(), SymCryptXmssPrfInit(), SymCryptXmssRandomizedHash(), SymCryptXmssSign(), and SymCryptXmssVerifyInternal().

SymCryptXorBytes()

VOID SYMCRYPT_CALL SymCryptXorBytes	(	_In_reads_(cbBytes) PCBYTE	pbSrc1,
		_In_reads_(cbBytes) PCBYTE	pbSrc2,
		_Out_writes_(cbBytes) PBYTE	pbResult,
		SIZE_T	cbBytes
	)

Definition at line 236 of file libmain.c.

{
    SIZE_T i;
 
    for( i=0; i<cbBytes; i++ )
    {
        pbResult[i] = pbSrc1[i] ^ pbSrc2[i];
    }
}

Referenced by SymCryptAesCmacResult(), SymCryptAesGcmDecryptPartOnePass(), SymCryptAesGcmEncryptPartOnePass(), SymCryptCbcDecrypt(), SymCryptCbcEncrypt(), SymCryptCbcMac(), SymCryptCcmAddMacData(), SymCryptCfbDecrypt(), SymCryptCfbEncrypt(), SymCryptChaCha20Crypt(), SymCryptCtrMsb32(), SymCryptCtrMsb64(), SymCryptDesxDecrypt(), SymCryptDesxEncrypt(), SymCryptDlgroupGeneratePrimeQ_FIPS(), SymCryptGcmEncryptDecryptPart(), SymCryptMd2AppendBlocks(), SymCryptPbkdf2Derive(), SymCryptRngAesUpdate(), SymCryptTlsPrf1_1Derive(), SymCryptXmssChain(), SymCryptXmssRandHash(), SymCryptXtsDecryptDataUnit(), and SymCryptXtsEncryptDataUnit().

Variable Documentation

g_SymCryptCpuFeaturesNotPresent

SYMCRYPT_CPU_FEATURES g_SymCryptCpuFeaturesNotPresent = (SYMCRYPT_CPU_FEATURES) ~0

Definition at line 20 of file libmain.c.

Referenced by SymCryptInitEnvCommon(), and SymCryptInitEnvWindowsUsermodeWin8_1nLater().

g_SymCryptCpuFeaturesPresentCheck

SYMCRYPT_CPU_FEATURES g_SymCryptCpuFeaturesPresentCheck = 0

Definition at line 21 of file libmain.c.

Referenced by SymCryptInitEnvCommon().

g_SymCryptFlags

UINT32 g_SymCryptFlags = 0

Definition at line 18 of file libmain.c.

Referenced by SymCryptInitEnvCommon(), and SymCryptInitEnvWindowsUsermodeWin8_1nLater().

SymCryptBuildString

const CHAR* const SymCryptBuildString

Initial value:

=
        "v" SYMCRYPT_BUILD_INFO_VERSION
        "_" SYMCRYPT_BUILD_INFO_BRANCH
        "_" SYMCRYPT_BUILD_INFO_COMMIT
        "_" SYMCRYPT_BUILD_INFO_TIMESTAMP

Definition at line 35 of file libmain.c.

Referenced by SymCryptInitEnvCommon().