13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/* $Id$ */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** @file
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * IPRT - Crypto - Cryptographic Hash / Message Digest API
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/*
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * Copyright (C) 2006-2014 Oracle Corporation
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync *
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * available from http://www.virtualbox.org. This file is free software;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * you can redistribute it and/or modify it under the terms of the GNU
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * General Public License (GPL) as published by the Free Software
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync *
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * The contents of this file may alternatively be used under the terms
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * of the Common Development and Distribution License Version 1.0
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * VirtualBox OSE distribution, in which case the provisions of the
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * CDDL are applicable instead of those of the GPL.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync *
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * You may elect to license modified versions of this file under the
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * terms and conditions of either the GPL or the CDDL or both.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/*******************************************************************************
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync* Header Files *
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync*******************************************************************************/
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include "internal/iprt.h"
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include <iprt/crypto/digest.h>
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include <iprt/asm.h>
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include <iprt/err.h>
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include <iprt/mem.h>
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#include <iprt/string.h>
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/*******************************************************************************
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync* Structures and Typedefs *
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync*******************************************************************************/
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/**
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * Generic message digest instance.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsynctypedef struct RTCRDIGESTINT
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** Magic value (RTCRDIGESTINT_MAGIC). */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t u32Magic;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** Reference counter. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t volatile cRefs;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** Pointer to the message digest descriptor. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PCRTCRDIGESTDESC pDesc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** The offset into abState of the storage space . At
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * least RTCRDIGESTDESC::cbHash bytes is available at that location. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t offHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** State. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t uState;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** The number of bytes consumed. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint64_t cbConsumed;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /** Opaque data specific to the message digest algorithm, size given by
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * RTCRDIGESTDESC::cbState. This is followed by space for the final hash at
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * offHash with size RTCRDIGESTDESC::cbHash. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint8_t abState[1];
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync} RTCRDIGESTINT;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** Pointer to a message digest instance. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsynctypedef RTCRDIGESTINT *PRTCRDIGESTINT;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** Magic value for RTCRDIGESTINT::u32Magic (Ralph C. Merkle). */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#define RTCRDIGESTINT_MAGIC UINT32_C(0x19520202)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** @name RTCRDIGESTINT::uState values.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * @{ */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** Ready for more data. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#define RTCRDIGEST_STATE_READY UINT32_C(1)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** The hash has been finalized and can be found at offHash. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#define RTCRDIGEST_STATE_FINAL UINT32_C(2)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** Busted state, can happen after re-init. */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync#define RTCRDIGEST_STATE_BUSTED UINT32_C(3)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync/** @} */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(int) RTCrDigestCreate(PRTCRDIGEST phDigest, PCRTCRDIGESTDESC pDesc, void *pvOpaque)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(phDigest, VERR_INVALID_POINTER);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pDesc, VERR_INVALID_POINTER);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync int rc = VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t offHash = RT_ALIGN_32(pDesc->cbState, 8);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = (PRTCRDIGESTINT)RTMemAllocZ(RT_OFFSETOF(RTCRDIGESTINT, abState[offHash + pDesc->cbHash]));
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->u32Magic = RTCRDIGESTINT_MAGIC;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->cRefs = 1;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->offHash = offHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->pDesc = pDesc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->uState = RTCRDIGEST_STATE_READY;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pDesc->pfnInit)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync rc = pDesc->pfnInit(pThis->abState, pvOpaque, false /*fReInit*/);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (RT_SUCCESS(rc))
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync *phDigest = pThis;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->u32Magic = 0;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RTMemFree(pThis);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync rc = VERR_NO_MEMORY;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return rc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(int) RTCrDigestClone(PRTCRDIGEST phDigest, RTCRDIGEST hSrc)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(phDigest, VERR_INVALID_POINTER);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(hSrc, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(hSrc->u32Magic == RTCRDIGESTINT_MAGIC, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync int rc = VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t const offHash = hSrc->offHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = (PRTCRDIGESTINT)RTMemAllocZ(RT_OFFSETOF(RTCRDIGESTINT, abState[offHash + hSrc->pDesc->cbHash]));
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->u32Magic = RTCRDIGESTINT_MAGIC;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->cRefs = 1;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->offHash = offHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->pDesc = hSrc->pDesc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (hSrc->pDesc->pfnClone)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync rc = hSrc->pDesc->pfnClone(pThis->abState, hSrc->abState);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memcpy(pThis->abState, hSrc->abState, offHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memcpy(&pThis->abState[offHash], &hSrc->abState[offHash], hSrc->pDesc->cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->uState = hSrc->uState;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (RT_SUCCESS(rc))
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync *phDigest = pThis;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->u32Magic = 0;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RTMemFree(pThis);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync rc = VERR_NO_MEMORY;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return rc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(int) RTCrDigestReset(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->cbConsumed = 0;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->uState = RTCRDIGEST_STATE_READY;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync int rc = VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->pDesc->pfnInit)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync rc = pThis->pDesc->pfnInit(pThis->abState, NULL, true /*fReInit*/);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (RT_FAILURE(rc))
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->uState = RTCRDIGEST_STATE_BUSTED;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RT_BZERO(&pThis->abState[pThis->offHash], pThis->pDesc->cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RT_BZERO(pThis->abState, pThis->offHash + pThis->pDesc->cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return rc;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(uint32_t) RTCrDigestRetain(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, UINT32_MAX);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, UINT32_MAX);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t cRefs = ASMAtomicIncU32(&pThis->cRefs);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync Assert(cRefs < 64);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return cRefs;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(uint32_t) RTCrDigestRelease(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis == NIL_RTCRDIGEST)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return 0;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, UINT32_MAX);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, UINT32_MAX);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t cRefs = ASMAtomicDecU32(&pThis->cRefs);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (!cRefs)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->u32Magic = ~RTCRDIGESTINT_MAGIC;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->pDesc->pfnDelete)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->pDesc->pfnDelete(pThis->abState);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RTMemFree(pThis);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync Assert(cRefs < 64);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return cRefs;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(int) RTCrDigestUpdate(RTCRDIGEST hDigest, void const *pvData, size_t cbData)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->uState == RTCRDIGEST_STATE_READY, VERR_INVALID_STATE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->pDesc->pfnUpdate(pThis->abState, pvData, cbData);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->cbConsumed += cbData;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(int) RTCrDigestFinal(RTCRDIGEST hDigest, void *pvHash, size_t cbHash)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, VERR_INVALID_HANDLE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->uState == RTCRDIGEST_STATE_READY || pThis->uState == RTCRDIGEST_STATE_FINAL, VERR_INVALID_STATE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrNullReturn(pvHash, VERR_INVALID_POINTER);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /*
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * Make sure the hash calculation is final.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->uState == RTCRDIGEST_STATE_READY)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->pDesc->pfnFinal(pThis->abState, &pThis->abState[pThis->offHash]);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync pThis->uState = RTCRDIGEST_STATE_FINAL;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->uState == RTCRDIGEST_STATE_FINAL, VERR_INVALID_STATE);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync /*
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync * Copy out the hash if requested.
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync */
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (cbHash > 0)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t cbNeeded = pThis->pDesc->cbHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->pDesc->pfnGetHashSize)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync cbNeeded = pThis->pDesc->pfnGetHashSize(pThis->abState);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync Assert(cbNeeded > 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (cbNeeded == cbHash)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memcpy(pvHash, &pThis->abState[pThis->offHash], cbNeeded);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else if (cbNeeded > cbHash)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memcpy(pvHash, &pThis->abState[pThis->offHash], cbNeeded);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memset((uint8_t *)pvHash + cbNeeded, 0, cbHash - cbNeeded);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VINF_BUFFER_UNDERFLOW;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync else
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync memcpy(pvHash, &pThis->abState[pThis->offHash], cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VERR_BUFFER_OVERFLOW;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return VINF_SUCCESS;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(bool) RTCrDigestMatch(RTCRDIGEST hDigest, void const *pvHash, size_t cbHash)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync int rc = RTCrDigestFinal(pThis, NULL, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertRCReturn(rc, false);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pvHash, false);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return pThis->pDesc->cbHash == cbHash
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync && !memcmp(&pThis->abState[pThis->offHash], pvHash, cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(uint8_t const *) RTCrDigestGetHash(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, NULL);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, NULL);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync int rc = RTCrDigestFinal(pThis, NULL, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertRCReturn(rc, NULL);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return &pThis->abState[pThis->offHash];
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(uint32_t) RTCrDigestGetHashSize(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->pDesc->pfnGetHashSize)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync {
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync uint32_t cbHash = pThis->pDesc->pfnGetHashSize(pThis->abState);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync Assert(cbHash <= pThis->pDesc->cbHash);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return cbHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync }
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return pThis->pDesc->cbHash;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(uint64_t) RTCrDigestGetConsumedSize(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, 0);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return pThis->cbConsumed;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(bool) RTCrDigestIsFinalized(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, false);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, false);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return pThis->uState == RTCRDIGEST_STATE_FINAL;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsyncRTDECL(RTDIGESTTYPE) RTCrDigestGetType(RTCRDIGEST hDigest)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync{
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync PRTCRDIGESTINT pThis = hDigest;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertPtrReturn(pThis, RTDIGESTTYPE_INVALID);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync AssertReturn(pThis->u32Magic == RTCRDIGESTINT_MAGIC, RTDIGESTTYPE_INVALID);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync RTDIGESTTYPE enmType = pThis->pDesc->enmType;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync if (pThis->pDesc->pfnGetDigestType)
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync enmType = pThis->pDesc->pfnGetDigestType(pThis->abState);
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync return enmType;
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync}
13493ab7596e827b8d0caab2c89e635dd65f78f9vboxsync