Cryptoki: a cryptographic Token Interface

10. Functions

• 
  general-purpose functions (4 functions)
  
• 
  slot and token management functions (9 functions)
  
• 
  session management functions (8 functions)
  
• 
  object management functions (9 functions)
  
• 
  encryption functions (4 functions)
  
• 
  decryption functions (4 functions)
  
• 
  message digesting functions (5 functions)
  
• 
  signing and MACing functions (6 functions)
  
• 
  functions for verifying signatures and MACs (6 functions)
  
• 
  dual-purpose cryptographic functions (4 functions)
  
• 
  key management functions (5 functions)
  
• 
  random number generation functions (2 functions)
  
• 
  parallel function management functions (2 functions)
  

• 
  If a Cryptoki function executes successfully, it returns the value CKR_OK.
  
• 
  If a Cryptoki function does not execute successfully, it returns some value other than CKR_OK, and the token is in the same state as it was in prior to the function call. If the function call was supposed to modify the contents of certain memory addresses on the host computer, these memory addresses may have been modified, despite the failure of the function.
  
• 
  In unusual (and extremely unpleasant!) circumstances, a function can fail with the return value CKR_GENERAL_ERROR. When this happens, the token and/or host computer may be in an inconsistent state, and the goals of the function may have been partially achieved.