EncryptDataInit(3)EncryptDataInit(3)NAME
EncryptDataInit, CSSM_EncryptDataInit, CSP_EncryptDataInit - Initialize
the staged encrypt funciton (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_EncryptDataInit (CSSM_CC_HANDLE CCHandle)
SPI: CSSM_RETURN CSSMCSPI CSP_EncryptDataInit (CSSM_CSP_HANDLE CSPHan‐
dle, CSSM_CC_HANDLE CCHandle, const CSSM_CONTEXT *Context, CSSM_PRIVI‐
LEGE Privilege)
LIBRARY
Common Security Services Manager library (libcssm.so)
API PARAMETERS
The handle that describes the context of this cryptographic operation
used to link to the CSP-managed information.
SPI PARAMETERS
The handle that describes the add-in cryptographic service provider
module used to perform calls to CSSM for the memory functions managed
by CSSM. Pointer to CSSM_CONTEXT structure that describes the
attributes with this context. The export privilege to be applied dur‐
ing the cryptographic operation. This parameter is forwarded to the CSP
after CSSM verifies the caller and service provider privilege set
includes the specified PRIVILEGE.
DESCRIPTION
This function initializes the staged encrypt function. There may be
algorithm-specific and token-specific rules restricting the lengths of
data following data update calls making use of these parameters.
The CSP can require that the cryptographic context include access cre‐
dentials for authentication and authorization checks when using a pri‐
vate key or a secret key.
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.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3).
None specific to this call.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_QuerySize(3), CSSM_DecryptData(3), CSSM_EncryptDataInit(3),
CSSM_EncryptDataUpdate(3), CSSM_EncryptDataFinal(3), CSSM_Encrypt‐
DataP(3), CSSM_EncryptDataInitP(3), CSSM_DecryptP(3), CSSM_Decrypt‐
DataInitP(3)
Functions for the CSP SPI:
CSP_QuerySize(3), CSP_DecryptData(3), CSP_EncryptDataInit(3),
CSP_EncryptDataUpdate(3), CSP_EncryptDataFinal(3)EncryptDataInit(3)
