NAME    [Toc]    [Back]

       CSSM_CSP_CreateKeyGenContext  -  Create  a  key generation
       cryptographic context (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN      CSSMAPI      CSSM_CSP_CreateKeyGenContext
       (CSSM_CSP_HANDLE  CSPHandle,  CSSM_ALGORITHMS AlgorithmID,
       uint32 KeySizeInBits, const CSSM_CRYPTO_DATA *Seed,  const
       CSSM_DATA   *Salt,   const   CSSM_DATE  *StartDate,  const
       CSSM_DATE *EndDate, const CSSM_DATA *Params,  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 an error.  The algorithm
       identification number of the algorithm used for key generation.
   The  logical size of the key (specified in bits).
       This refers to either the actual key size  (for  symmetric
       key  generation)  or  the modulus size (for asymmetric key
       pair generation).  A seed used to generate  the  key.  The
       caller  can either pass a seed and seed length in bytes or
       pass a callback function. If NULL is passed,  the  cryptographic
  service  provider  will use its default seed-handling
 mechanism.  A salt used  to  generate  the  key.   A
       start  date for the validity period of the key or key pair
       being generated.  An end date for the validity  period  of
       the  key  or key pair being generated.  A data buffer containing
 parameters required to generate a key pair  for  a
       specific algorithm.  Cryptographic context handle.

DESCRIPTION    [Toc]    [Back]

       This  function creates a key generation cryptographic context,
 given a handle of a CSP, an algorithm identification
       number,  a pass phrase, a modulus size (for public or private
 keypair generation), a key size  (for  symmetric  key
       generation), a seed, and a salt. The cryptographic context
       handle is returned.  The cryptographic context handle  can
       be used to call key/ or keypair generation functions.

       Additional  attributes  can  be added to the newly created
       context using the CSSM_UpdateContextAttributes() function.
       Incremental  attributes  of  interest  for  key generation
       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]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions:  CSSM_GenerateKey(3),  CSSM_GenerateKeyPair(3),
       CSSM_GetContext(3),  CSSM_SetContext(3),   CSSM_DeleteContext(3),  CSSM_GetContextAttribute(3),  CSSM_UpdateContextAttributes(3)



                                  CSSM_CSP_CreateKeyGenContext(3)