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

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



NAME    [Toc]    [Back]

       CSSM_CSP_CreateDeriveKeyContext  -  Create a cryptographic
       context to derive a symmetric key (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN    CSSMAPI     CSSM_CSP_CreateDeriveKeyContext
       CSSM_KEY_TYPE DeriveKeyType, uint32 DeriveKeyLengthInBits,
       const  CSSM_ACCESS_CREDENTIALS *AccessCred, const CSSM_KEY
       *BaseKey, uint32 IterationCount,  const  CSSM_DATA  *Salt,
       const  CSSM_CRYPTO_DATA  *Seed, 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  for  a derived key algorithm.  The
       type of symmetric key to derive.  The  logical  length  of
       the  key  in  bits to be derived ( LogicalKeySizeInBits) A
       pointer to the set of one or more credentials required  to
       access the base 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. If  the
       BaseKey  is  NULL,  then  this parameter is optional.  The
       base key used to derive the new key. The base key can be a
       public  key,  a private key, or a symmetric key The number
       of iterations to be performed during the  derivation  process.
   Used heavily by password-based derivation methods.
       A Salt used in deriving the key.  A seed used to  generate
       a  random  number.  The  caller can either pass a seed and
       seed length in bytes or pass a callback function. If  Seed
       is  NULL,  the cryptographic service provider will use its
       default seed-handling  mechanism.   Cryptographic  context

DESCRIPTION    [Toc]    [Back]

       This  function creates a cryptographic context to derive a
       symmetric key, given a handle of a CSP, an algorithm,  the
       type of symmetric key to derive, the length of the derived
       key, and an optional seed or an optional AccessCredentials
       structure  from  which  to  derive  a new key. The cryptographic
 context handle is returned. The cryptographic context
  handle  can  be  used  for calling the cryptographic
       derive key function.

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_DeriveKey(3)

[ Back ]
 Similar pages
Name OS Title
CSSM_CSP_CreateSymmetricContext Tru64 Create a symmetric encryption 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_CreatePassThroughContext Tru64 Create a custom cryptographic context (CDSA)
CSSM_CSP_CreateSignatureContext Tru64 Create a signature cryptographic context (CDSA)
CSSM_CSP_CreateAsymmetricContext Tru64 Create an asymmetric encryption 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)
DeriveKey Tru64 Derive new symmetric key (CDSA)
CSSM_DeriveKey Tru64 Derive new symmetric key (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service