NAME    [Toc]    [Back]

       VerifyMac, CSSM_VerifyMac, CSP_VerifyMac - Verify the message
 authentication code (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN  CSSMAPI  CSSM_VerifyMac  (CSSM_CC_HANDLE
       CCHandle,  const CSSM_DATA *DataBufs, uint32 DataBufCount,
       const CSSM_DATA *Mac) SPI: CSSM_RETURN CSSMCSPI  CSP_VerifyMac
 (CSSM_CSP_HANDLE CSPHandle, CSSM_CC_HANDLE CCHandle,
       const CSSM_CONTEXT *Context,  const  CSSM_DATA  *DataBufs,
       uint32 DataBufCount, const CSSM_DATA *Mac)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The  handle  that  describes  the  context of this cryptographic
 operation used to link to the CSP-managed information.
   A pointer to a vector of CSSM_DATA structures that
       contain the  data  to  be  operated  on.   The  number  of
       DataBufs.  A pointer to the CSSM_DATA structure containing
       the MAC to verify.

SPI PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform calls to CSSM for the memory
 functions managed by CSSM.   Pointer  to  CSSM_CONTEXT
       structure that describes the attributes with this context.

DESCRIPTION    [Toc]    [Back]

       This function verifies  the  message  authentication  code
       over  all data contained in the set of input buffers based
       on the input signature.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       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

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_VerifyMacInit(3), CSSM_VerifyMacUpdate(3), CSSM_VerifyMacFinal(3)

       Functions for the CSP SPI:

       CSP_VerifyMacInit(3), CSP_VerifyMacUpdate(3),  CSP_VerifyMacFinal(3)



                                                     VerifyMac(3)