*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> GenerateMac (3)              
Title
Content
Arch
Section
 

GenerateMac(3)

Contents


NAME    [Toc]    [Back]

       GenerateMac, CSSM_GenerateMac, CSP_GenerateMac - Compute a
       message authentication code (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_GenerateMac  (CSSM_CC_HANDLE
       CCHandle,  const CSSM_DATA *DataBufs, uint32 DataBufCount,
       CSSM_DATA_PTR Mac) SPI:  CSSM_RETURN  CSSMCSPI  CSP_GenerateMac
  (CSSM_CSP_HANDLE  CSPHandle, CSSM_CC_HANDLE CCHandle,
  const   CSSM_CONTEXT   *Context,   const   CSSM_DATA
       *DataBufs, uint32 DataBufCount, CSSM_DATA_PTR 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 for the
       Message Authentication Code.

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 computes a message authentication  code  for
       all data contained in the set of input buffers.

NOTES ON API    [Toc]    [Back]

       The output is returned to the caller either by filling the
       caller-specified buffer  or  by  using  the  application's
       declared  memory  allocation  functions to allocate buffer
       space. To specify a specific, preallocated output  buffer,
       the  caller must provide an array of one or more CSSM_DATA
       structures, each containing a Length field  value  greater
       than  zero  and  a  non-NULL  data pointer field value. To
       specify automatic output buffer allocation by the CSP, the
       caller  must  provide  an  array  of one or more CSSM_DATA
       structures, each containing a Length field value equal  to
       zero  and a NULL data pointer field value. The application
       is always responsible for deallocating the memory when  it
       is no longer needed.

NOTES ON SPI    [Toc]    [Back]

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








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_OUTPUT_LENGTH_ERROR

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_GenerateMacInit(3),        CSSM_GenerateMacUpdate(3),
       CSSM_GenerateMacFinal(3)

       Functions for the CSP SPI:

       CSP_GenerateMacInit(3), CSP_GenerateMacUpdate(3), CSP_GenerateMacFinal(3)



                                                   GenerateMac(3)
[ Back ]
 Similar pages
Name OS Title
VerifyMac Tru64 Verify the message authentication code (CDSA)
CSP_VerifyMac Tru64 Verify the message authentication code (CDSA)
CSSM_VerifyMac Tru64 Verify the message authentication code (CDSA)
CSP_VerifyMacFinal Tru64 Finalize the staged message authentication code (CDSA)
CSP_VerifyMacInit Tru64 Initialize the staged message authentication code (CDSA)
CSP_GenerateMacFinal Tru64 Finalize the staged message authentication code (CDSA)
CSSM_GenerateMacInit Tru64 Initialize the staged message authentication code (CDSA)
CSSM_VerifyMacFinal Tru64 Finalize the staged message authentication code (CDSA)
CSP_GenerateMacInit Tru64 Initialize the staged message authentication code (CDSA)
CSSM_GenerateMacFinal Tru64 Finalize the staged message authentication code (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service