Intel EP80579 Benutzerhandbuch

Seite von 76
Security Software—Using the Intel
®
 QuickAssist Technology Cryptographic API
Intel
®
 EP80579 Software for Security Applications on Intel
®
 QuickAssist Technology
PG
August 2009
58
Order Number: 320183-004US
12.0
Using the Intel
®
 QuickAssist Technology 
Cryptographic API 
The Intel
®
 QuickAssist Technology Cryptographic API for the Lookaside Model is 
described in the API user reference document 
. Most of the API functions 
support both asynchronous and synchronous invocation, except for those used to 
initialize and remove sessions and for getting statistics which support synchronous 
invocation only. This chapter provides a brief overview of the API.
12.1
What’s New in this Chapter
 an
: New Note to explain shim support
12.2
Intel
®
 QuickAssist Technology Cryptographic API
The API is documented in the 
 document. The API can be split into three 
broad areas. These are as follows:
• Common: The cpa.h, cpa_cy_common.h and icp_lac_cfg.h files define common 
API, enums and so on, which both the symmetric and asymmetric APIs use.
• Instance Management: The cpa_cy_im.h file defines the functions for managing 
instances. 
• Symmetric: The cpa_cy_sym.h file contains the symmetric API for hashing, 
cipher, algorithm chaining and authenticated encryption. The cpa_cy_key.h file 
Table 13.
Cryptographic Common Interface Summary (icp_lac_cfg.h)
Method
Description
icp_AsdCfgLacInit
Initialize the Cryptographic Service setting up all static data 
tables.
icp_AsdCfgLacShutdown
Shutdown the Cryptographic Service, therefore cleaning up all 
resources owned by the module
icp_AsdCfgLacStart
Start the Cryptographic services, it is assumed at this point 
Cryptographic has been initialized. 
icp_AsdCfgLacStop
Stop the Cryptographic services.
Note:
These APIs are called by the ASD component to ensure correct initialization/shutdown procedures.
Table 14.
Cryptographic Instance Management Summary (cpa_cy_im.h)
Method
Description
cpaCyStartInstance
This function will initialize and start the Cryptographic 
component.
cpaCyStopInstance
This function will stop the Cryptographic component and free all 
system resources associated with it.