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

  man pages->Tru64 Unix man pages -> CSSM_CSP_CreateSymmetricContext (3)              



NAME    [Toc]    [Back]

       CSSM_CSP_CreateSymmetricContext   -   Create  a  symmetric
       encryption cryptographic context (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN    CSSMAPI     CSSM_CSP_CreateSymmetricContext
       *AccessCred,   const   CSSM_KEY   *Key,   const  CSSM_DATA
       *InitVector,   CSSM_PADDING   Padding,   void   *Reserved,
       CSSM_CC_HANDLE *NewContextHandle)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in cryptographic service
       provider module used to perform this function. If  a  NULL
       handle  is  specified,  CSSM returns error.  The algorithm
       identification number for symmetric encryption.  The  mode
       of  the  specified  algorithm ID.  A pointer to the set of
       one or more credentials required  to  unlock  the  private
       key.  The  credentials  structure can contain an immediate
       value for the credential, such as  a  passphrase,  or  the
       caller  can specify a callback function the CSP can use to
       obtain  one  or  more  credentials.  Credentials  may   be
       required  for  encryption, decryption, and wrapping operations.
  The key used for symmetric encryption. The  caller
       passes  a  pointer  to a CSSM_KEY structure containing the
       key.  The initial vector for symmetric encryption. This is
       typically  specified  for  block  ciphers.  The method for
       padding. This is typically specified for ciphers that pad.
       Reserved for future use.  Cryptographic context handle.

DESCRIPTION    [Toc]    [Back]

       This function creates a symmetric encryption cryptographic
       context, given a handle of a CSP, an algorithm identification
  number,  a  key, an initial vector, padding, and the
       number of encryption rounds. Algorithm-specific attributes
       must  be  added  to the context after the initial creation
       using  the  CSSM_UpdateContextAttributes()  function.  The
       cryptographic  context  handle  is  returned.  The cryptographic
 context handle  can  be  used  to  call  symmetric
       encryption  functions and the cryptographic wrap or unwrap

       Additional attributes can be added to  the  newly  created
       context  using the CSSM_UpdateContextAttributes() function
       . Incremental attributes of interest when using this  context
  to  unwrap a key include a handle-pair identifying a
       Data Storage Library service module and an open data store
       for CSPs that manage multiple, persistent key stores. If a
       CSP does not support multiple key stores, the CSP  ignores
       the presence or absence of this attribute.

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.

SEE ALSO    [Toc]    [Back]


       Intel    CDSA    Application    Developer's   Guide   (see

       Reference Pages    [Toc]    [Back]

       Functions:  CSSM_DecryptData(3),  CSSM_DecryptDataInit(3),
       CSSM_DecryptDataUpdate(3),       CSSM_DecryptDataFinal(3),
       CSSM_DeleteContext(3), CSSM_EncryptData(3),  CSSM_EncryptDataInit(3),  CSSM_EncryptDataUpdate(3), CSSM_EncryptDataFinal(3), CSSM_GetContext(3), CSSM_GetContextAttribute(3),
       CSSM_QuerySize(3),  CSSM_SetContext(3), CSSM_UpdateContextAttributes(3)

[ Back ]
 Similar pages
Name OS Title
CSSM_CSP_CreateAsymmetricContext Tru64 Create an asymmetric encryption cryptographic context (CDSA)
CSSM_CSP_CreateDeriveKeyContext Tru64 Create a cryptographic context to derive a symmetric key (CDSA)
CSSM_CSP_CreatePassThroughContext Tru64 Create a custom cryptographic context (CDSA)
CSSM_CSP_CreateKeyGenContext Tru64 Create a key generation cryptographic context (CDSA)
CSSM_CSP_CreateDigestContext Tru64 Create a digest cryptographic context (CDSA)
CSSM_CSP_CreateSignatureContext Tru64 Create a signature cryptographic context (CDSA)
CSSM_CSP_CreateMacContext Tru64 Create a message authentication code cryptographic context (CDSA)
CSSM_CSP_CreateRandomGenContext Tru64 Create a random number generation cryptographic context (CDSA)
CSSM_VerifyDevice Tru64 Cause the cryptographic module to perform a self verification and integrity check (CDSA)
VerifyDevice Tru64 Cause the cryptographic module to perform a self verification and integrity check (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service