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

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



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

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]


       Intel   CDSA   Application    Developer's    Guide    (see

       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)

[ Back ]
 Similar pages
Name OS Title
CSSM_CSP_CreateRandomGenContext Tru64 Create a random number 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_CreatePassThroughContext Tru64 Create a custom cryptographic context (CDSA)
CSSM_CSP_CreateSymmetricContext Tru64 Create a symmetric encryption cryptographic context (CDSA)
CSSM_CSP_CreateDeriveKeyContext Tru64 Create a cryptographic context to derive a symmetric key (CDSA)
CSSM_CSP_CreateAsymmetricContext Tru64 Create an asymmetric encryption cryptographic context (CDSA)
CSSM_CSP_CreateMacContext Tru64 Create a message authentication code cryptographic context (CDSA)
VerifyDevice Tru64 Cause the cryptographic module to perform a self verification and integrity check (CDSA)
CSP_VerifyDevice Tru64 Cause the cryptographic module to perform a self verification and integrity check (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service