Index for Section 3

Alphabetical listing for C

Bottom of page

CSSM_CSP_CreateSignatureContext(3)
NAME
  CSSM_CSP_CreateSignatureContext - Create a signature cryptographic context
  (CDSA)

SYNOPSIS
  # include <cdsa/cssm.h>

       CSSM_RETURN CSSMAPI CSSM_CSP_CreateSignatureContext
       (CSSM_CSP_HANDLE CSPHandle,
       CSSM_ALGORITHMS AlgorithmID,
       const CSSM_ACCESS_CREDENTIALS *AccessCred,
       const CSSM_KEY *Key,
       CSSM_CC_HANDLE *NewContextHandle)

LIBRARY
  Common Security Services Manager library (libcssm.so)

PARAMETERS
  CSPHandle (input)
	  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.

  AlgorithmID (input)
	  The algorithm identification number for a signature/verification
	  algorithm.

  AccessCred (input/optional)
	  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 are required for signature operations, not
	  for verify operations.

  Key (input)
	  The key used to sign and verify. The caller passes a pointer to a
	  CSSM_KEY structure containing the key and the key length.

  NewContextHandle (output)
	  Cryptographic context handle.

DESCRIPTION
  This function creates a signature cryptographic context for sign and
  verify, given a handle of a CSP, an algorithm identification number, a key,
  and an AccessCredentials structure. The AccessCredentials structure will be
  used to unlock the private key when this context is used to perform a
  signing operation. The cryptographic context handle is returned. The
  cryptographic context handle can be used to call sign and verify
  cryptographic functions.

RETURN VALUE
  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
  Books

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

  Reference Pages

  Functions: CSSM_SignData(3), CSSM_SignDataInit(3), CSSM_SignDataUpdate(3),
  CSSM_SignDataFinal(3), CSSM_VerifyData(3), CSSM_VerifyDataInit(3),
  CSSM_VerifyDataUpdate(3), CSSM_VerifyDataFinal(3), CSSM_GetContext(3),
  CSSM_SetContext(3), CSSM_DeleteContext(3), CSSM_GetContextAttribute(3),
  CSSM_UpdateContextAttributes(3)

Index for Section 3

Alphabetical listing for C

Top of page