crypto_interface_aes_gcm.h

Go to the documentation of this file.

/*
 * crypto_interface_aes_gcm.h
 *
 * Cryptographic Interface header file for declaring AES-GCM functions
 * for the Crypto Interface.
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

#ifndef __CRYPTO_INTERFACE_AES_GCM_HEADER__
#define __CRYPTO_INTERFACE_AES_GCM_HEADER__

#ifdef __cplusplus
extern "C" {
#endif

/* macros and context type for last two APIs at bottom of this file */
#define GCM_MODE_GENERAL  0
#define GCM_MODE_256B   100
#define GCM_MODE_4K     101
#define GCM_MODE_64K    102

typedef struct {

    BulkCtx pTblCtx;
    ubyte4 tableSize;
    MocSymCtx pMocSymCtx;
    ubyte4 enabled;

} AES_GCM_CTX;


MOC_EXTERN BulkCtx CRYPTO_INTERFACE_GCM_createCtx_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) ubyte *pKeyData,
    sbyte4 keyLen,
    sbyte4 encrypt
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_nonce_256b(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pNonce, ubyte4 nonceLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_aad_256b(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pAadData, ubyte4 aadDataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_data_256b(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pData, ubyte4 dataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_ex_256b(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pTag, ubyte4 tagLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_deleteCtx_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *pCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_cipher_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen,
    ubyte *pData,
    ubyte4 dataLen,
    ubyte4 tagLen,
    sbyte4 encrypt
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_init_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_encrypt_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pData,
    ubyte4 dataLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_decrypt_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pCipherText,
    ubyte4 cipherTextLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte pTag[/*AES_BLOCK_SIZE*/]
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_clone_256b (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    BulkCtx *ppNewCtx
    );

MOC_EXTERN BulkCtx CRYPTO_INTERFACE_GCM_createCtx_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) ubyte *pKeyData,
    sbyte4 keyLen,
    sbyte4 encrypt
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_nonce_4k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pNonce, ubyte4 nonceLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_aad_4k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pAadData, ubyte4 aadDataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_data_4k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pData, ubyte4 dataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_ex_4k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pTag, ubyte4 tagLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_deleteCtx_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *pCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_cipher_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen,
    ubyte *pData,
    ubyte4 dataLen,
    ubyte4 tagLen,
    sbyte4 encrypt
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_init_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_encrypt_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pData,
    ubyte4 dataLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_decrypt_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pCipherText,
    ubyte4 cipherTextLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte pTag[/*AES_BLOCK_SIZE*/]
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_clone_4k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    BulkCtx *ppNewCtx
    );

MOC_EXTERN BulkCtx CRYPTO_INTERFACE_GCM_createCtx_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) ubyte *pKeyData,
    sbyte4 keyLen,
    sbyte4 encrypt
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_nonce_64k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pNonce, ubyte4 nonceLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_aad_64k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pAadData, ubyte4 aadDataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_data_64k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pData, ubyte4 dataLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_ex_64k(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, ubyte *pTag, ubyte4 tagLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_deleteCtx_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *pCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_cipher_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen,
    ubyte *pData,
    ubyte4 dataLen,
    ubyte4 tagLen,
    sbyte4 encrypt
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_init_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAaData,
    ubyte4 aadLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_encrypt_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pData,
    ubyte4 dataLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_update_decrypt_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pCipherText,
    ubyte4 cipherTextLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_final_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte pTag[/*AES_BLOCK_SIZE*/]
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_GCM_clone_64k (
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    BulkCtx *ppNewCtx
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_AES_GCM_newCtx(
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *ppNewCtx,
    ubyte4 tableSizeMode, 
    ubyte *pKeyMaterial, 
    sbyte4 keyMaterialLen,
    sbyte4 encrypt);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_AES_GCM_encrypt(
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,      
    ubyte *pNonce,
    ubyte4 *pNonceLen,
    intBoolean *pWasNonceUsed,
    ubyte *pAad,
    ubyte4 aadLen,
    ubyte *pData,
    ubyte4 dataLen,
    ubyte4 tagLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_AES_GCM_decrypt(
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx,
    ubyte *pNonce,
    ubyte4 nonceLen,
    ubyte *pAad,
    ubyte4 aadLen,
    ubyte *pData,
    ubyte4 dataLen,
    ubyte4 tagLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_AES_GCM_deleteCtx(
    MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *ppCtx);

#ifdef __cplusplus
}
#endif

#endif /* __CRYPTO_INTERFACE_AES_GCM_HEADER__ */