CSSM_CSP_CreateSignatureContext(3)CSSM_CSP_CreateSignatureContext(3)NAMECSSM_CSP_CreateSignatureContext - Create a signature cryptographic con‐
text (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
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 a signa‐
ture/verification algorithm. A pointer to the set of one or more cre‐
dentials 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. The key used to sign
and verify. The caller passes a pointer to a CSSM_KEY structure con‐
taining the key and the key length. 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 struc‐
ture 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 repre‐
sent 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_SignDataUp‐
date(3), CSSM_SignDataFinal(3), CSSM_VerifyData(3), CSSM_Verify‐
DataInit(3), CSSM_VerifyDataUpdate(3), CSSM_VerifyDataFinal(3),
CSSM_GetContext(3), CSSM_SetContext(3), CSSM_DeleteContext(3),
CSSM_GetContextAttribute(3), CSSM_UpdateContextAttributes(3)CSSM_CSP_CreateSignatureContext(3)