NAME

VerifyMacFinal, CSSM_VerifyMacFinal, CSP_VerifyMacFinal − Finalize the staged message authentication code (CDSA)

SYNOPSIS

# include <cdsa/cssm.h>

API:
CSSM_RETURN CSSMAPI CSSM_VerifyMacFinal
(CSSM_CC_HANDLE CCHandle,
const CSSM_DATA ∗Mac)
SPI:
CSSM_RETURN CSSMCSPI CSP_VerifyMacFinal
(CSSM_CSP_HANDLE CSPHandle,
CSSM_CC_HANDLE CCHandle,
const CSSM_DATA ∗Mac)

LIBRARY

Common Security Services Manager library (libcssm.so)

API PARAMETERS

CCHandle (input)
The handle that describes the context of this cryptographic operation used to link to the CSP-managed information.

Mac (input)
A pointer to the CSSM_DATA structure containing the MAC to verify.

SPI PARAMETERS

CSPHandle (input)
The handle that describes the add-in cryptographic service provider module used to perform calls to CSSM for the memory functions managed by CSSM.

DESCRIPTION

This function finalizes the staged message authentication code verification function. 

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition. 

ERRORS

Errors are described in the CDSA technical standard.  See CDSA_intro(3). 

CSSMERR_CSP_INPUT_LENGTH_ERROR
CSSMERR_CSP_VERIFY_FAILED
CSSMERR_CSP_INVALID_SIGNATURE

COMMENTS FOR SPI

The output is returned to the caller as specified in  Buffer Management for Cryptographic Services. 

SEE ALSO

Books

Intel CDSA Application Developer’s Guide (see CDSA_intro(3))

Reference Pages

Functions for the CSSM API:

CSSM_VerifyMac(3), CSSM_VerifyMacInit(3), CSSM_VerifyMacUpdate(3)

Functions for the CSP SPI:

CSP_VerifyMac(3), CSP_VerifyMacInit(3), CSP_VerifyMacUpdate(3)