Changeset 94627 in vbox for trunk/include/iprt/crypto

Timestamp:

Apr 19, 2022 10:12:04 AM (3 years ago)

Author:

vboxsync

Message:

Runtime/crypto: Add additional APIs and supported algorithms for symmetric enc-/decryption, bugref:9955

File:

• trunk/include/iprt/crypto/cipher.h (modified) (4 diffs)

trunk/include/iprt/crypto/cipher.h

@@ -53 +53 @@
 /** Nil symmetric cipher handle. */
 #define NIL_RTCRCIPHER          ((RTCRCIPHER)0)
+/** Symmetric cipher context */
+typedef struct RTCRCIPHERCTXINT *RTCRCIPHERCTX;
+/** Pointer to a symmetric cipher context */
+typedef RTCRCIPHERCTX          *PRTCRCIPHERCTX;
+/** Nil symmetric cipher context */
+#define NIL_RTCRCIPHERCTX       ((RTCRCIPHERCTX)0)
 
 /**
@@ -67 +73 @@
     /** XTS-AES-256 (NIST SP 800-38E). */
     RTCRCIPHERTYPE_XTS_AES_256,
+    /** GCM-AES-128. */
+    RTCRCIPHERTYPE_GCM_AES_128,
+    /** GCM-AES-256. */
+    RTCRCIPHERTYPE_GCM_AES_256,
+    /* CTR-AES-128 */
+    RTCRCIPHERTYPE_CTR_AES_128,
+    /* CTR-AES-256 */
+    RTCRCIPHERTYPE_CTR_AES_256,
     /** End of valid symmetric cipher types. */
     RTCRCIPHERTYPE_END,
@@ -81 +95 @@
 RTDECL(uint32_t) RTCrCipherGetBlockSize(RTCRCIPHER hCipher);
 
+RTDECL(int) RTCrCipherCtxFree(RTCRCIPHERCTX phCipherCtx);
+
+RTDECL(int) RTCrCipherCtxEncryptInit(RTCRCIPHER hCipher, void const *pvKey, size_t cbKey,
+                                     void const *pvInitVector, size_t cbInitVector,
+                                     void const *pvAuthData, size_t cbAuthData,
+                                     PRTCRCIPHERCTX phCipherCtx);
+RTDECL(int) RTCrCipherCtxEncryptProcess(RTCRCIPHERCTX hCipherCtx, void const *pvPlainText, size_t cbPlainText,
+                                        void *pvEncrypted, size_t cbEncrypted, size_t *pcbEncrypted);
+RTDECL(int) RTCrCipherCtxEncryptFinish(RTCRCIPHERCTX hCipherCtx,
+                                       void *pvEncrypted, size_t *pcbEncrypted,
+                                       void *pvTag, size_t cbTag, size_t *pcbTag);
+
+RTDECL(int) RTCrCipherCtxDecryptInit(RTCRCIPHER hCipher, void const *pvKey, size_t cbKey,
+                                     void const *pvInitVector, size_t cbInitVector,
+                                     void const *pvAuthData, size_t cbAuthData,
+                                     void *pvTag, size_t cbTag, PRTCRCIPHERCTX phCipherCtx);
+RTDECL(int) RTCrCipherCtxDecryptProcess(RTCRCIPHERCTX hCipherCtx,
+                                        void const *pvEncrypted, size_t cbEncrypted,
+                                        void *pvPlainText, size_t cbPlainText, size_t *pcbPlainText);
+RTDECL(int) RTCrCipherCtxDecryptFinish(RTCRCIPHERCTX hCipherCtx,
+                                       void *pvPlainText, size_t *pcbPlainText);
+
+
 RTDECL(int) RTCrCipherEncrypt(RTCRCIPHER hCipher, void const *pvKey, size_t cbKey,
                               void const *pvInitVector, size_t cbInitVector,
@@ -89 +126 @@
                               void const *pvEncrypted, size_t cbEncrypted,
                               void *pvPlainText, size_t cbPlainText, size_t *pcbPlainText);
+RTDECL(int) RTCrCipherEncryptEx(RTCRCIPHER hCipher, void const *pvKey, size_t cbKey,
+                                void const *pvInitVector, size_t cbInitVector,
+                                void const *pvAuthData, size_t cbAuthData,
+                                void const *pvPlainText, size_t cbPlainText,
+                                void *pvEncrypted, size_t cbEncrypted, size_t *pcbEncrypted,
+                                void *pvTag, size_t cbTag, size_t *pcbTag);
+RTDECL(int) RTCrCipherDecryptEx(RTCRCIPHER hCipher, void const *pvKey, size_t cbKey,
+                                void const *pvInitVector, size_t cbInitVector,
+                                void const *pvAuthData, size_t cbAuthData,
+                                void *pvTag, size_t cbTag,
+                                void const *pvEncrypted, size_t cbEncrypted,
+                                void *pvPlainText, size_t cbPlainText, size_t *pcbPlainText);
 
 /** @} */