SNIP_CLASSIC_CRYPTO_SECTION_8_5_2_Optional_interfaces

8.5.2 Optional interfaces This section defines all interfaces, which are required to fulfill an optional functionality of the module. [SWS_CryIf_91101] Definition of optional interfaces requested by module CryIf ⌈ API Function Header File Description Crypto_CancelJob Crypto.h This interface removes the provided job from the queue and cancels the processing of the job if possible. Crypto_CustomSync Crypto.h Requests the execution of a function that is specified by the given dispatch id. Crypto_KeyCopy Crypto.h Copies a key with all its elements to another key in the same crypto driver. Note: If the actual key element is directly mapped to flash memory, there could be a bigger delay when calling this function (synchronous operation) Crypto_KeyDerive Crypto.h Derives a new key by using the key elements in the given key identified by the cryptoKeyId. The given key contains the key elements for the password, salt. The derived key is stored in the key element with the id 1 of the key identified by targetCryptoKeyId. The number of iterations is given in the key element CRYPTO_KE_KEYDERIVATION_ITERATIONS. Crypto_KeyElementCopy Crypto.h Copies a key element to another key element in the same crypto driver. Note: If the actual key element is directly mapped to flash memory, there could be a bigger delay when calling this function (synchronous operation) Crypto_KeyElementCopyPartial Crypto.h Copies a key element to another key element in the same crypto driver. The keyElementSourceOffset and keyElementCopyLength allows to copy just a part of the source key element into the destination. The offset of the target key is also specified with this function. Note: If the actual key element is directly mapped to flash memory, there could be a bigger delay when calling this function (synchronous operation). Crypto_KeyElementGet Crypto.h This interface shall be used to get a key element of the key identified by the cryptoKeyId and store the key element in the memory location pointed by the result pointer. Note: If the actual key element is directly mapped to flash memory, there could be a bigger delay when calling this function (synchronous operation). Crypto_KeyElementIdsGet Crypto.h Used to retrieve information which key elements are available in a given key. Crypto_KeyElementSet Crypto.h Sets the given key element bytes to the key identified by cryptoKeyId. Crypto_KeyExchangeCalcPubVal Crypto.h Calculates the public value for the key exchange and stores the public key in the memory location pointed by the public value pointer. Crypto_KeyExchangeCalcSecret Crypto.h Calculates the shared secret key for the key exchange with the key material of the key identified by the cryptoKeyId and the partner public key. The shared secret key is stored as a key element in the same key. ▽ △ API Function Header File Description Crypto_KeyGenerate Crypto.h Generates new key material store it in the key identified by cryptoKeyId. Crypto_KeyGetStatus Crypto.h Returns the key state of the key identified by crypto KeyId. Crypto_KeySetInvalid Crypto.h Sets invalid for the status of the key identified by cryptoKeyId. Crypto_KeySetValid Crypto.h Sets the key state of the key identified by cryptoKey Id to valid. Crypto_ProcessJob Crypto.h Performs the crypto primitive, that is configured in the job parameter. Crypto_RandomSeed Crypto.h This function generates the internal seed state using the provided entropy source. Furthermore, this function can be used to update the seed state with new entropy Csm_CallbackNotification Csm.h Notifies the CSM that a job has finished. This function is used by the underlying layer (CRYIF). Det_ReportError Det.h Service to report development errors. Det_ReportRuntimeError Det.h Service to report runtime errors. If a callout has been configured then this callout shall be called. ⌋