NAME    [Toc]    [Back]

       DigestDataClone, CSSM_DigestDataClone, CSP_DigestDataClone
       - Clone a staged message digest (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:     CSSM_RETURN     CSSMAPI      CSSM_DigestDataClone
       (CSSM_CC_HANDLE  CCHandle, CSSM_CC_HANDLE *ClonednewCCHandle)
   SPI:   CSSM_RETURN   CSSMCSPI   CSP_DigestDataClone
       (CSSM_CSP_HANDLE   CSPHandle,   CSSM_CC_HANDLE   CCHandle,
       CSSM_CC_HANDLE ClonednewCCHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

API PARAMETERS    [Toc]    [Back]

       The handle that describes the context of a staged  message
       digest  operation.   The cloned digest context handle. The
       handle will be set to CSSM_INVALID_HANDLE if the  function
       fails.

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.

DESCRIPTION    [Toc]    [Back]

       This function clones a given staged message digest context
       with its cryptographic attributes and intermediate result.

NOTES    [Toc]    [Back]

       When  a digest context is cloned, a new context is created
       with data associated with the parent context. Changes made
       to the parent context after calling this function will not
       be reflected in the cloned  context.  The  cloned  context
       could   be   used  with  the  CSSM_DigestDataUpdate()  and
       CSSM_DigestDataFinal() functions.

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).

       None specific to this call.

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_DigestData(3),                CSSM_DigestDataInit(3),
       CSSM_DigestDataUpdate(3), CSSM_DigestDataFinal(3)

       Functions for the CSP SPI:

       CSP_DigestData(3),    CSP_DigestDataInit(3),   CSP_DigestDataUpdate(3), CSP_DigestDataFinal(3)



                                               DigestDataClone(3)