xnu-3789.21.4.tar.gz

[apple/xnu.git] / EXTERNAL_HEADERS / corecrypto / ccmode_impl.h

diff --git a/EXTERNAL_HEADERS/corecrypto/ccmode_impl.h b/EXTERNAL_HEADERS/corecrypto/ccmode_impl.h
index 3e35f548ea00d788aadc965a970462657c967596..817d45070155a2ef2fb5e30b9356712dddf60822 100644 (file)
--- a/EXTERNAL_HEADERS/corecrypto/ccmode_impl.h
+++ b/EXTERNAL_HEADERS/corecrypto/ccmode_impl.h
@@ -2,8 +2,9 @@
  *  ccmode_impl.h
  *  corecrypto
  *
  *  ccmode_impl.h
  *  corecrypto
  *

- *  Created by James Murphy on 12/9/11.
- *  Copyright (c) 2011 Apple Inc. All rights reserved.
+ *  Created on 12/07/2010
+ *
+ *  Copyright (c) 2012,2015 Apple Inc. All rights reserved.

  *
  */
 
  *
  */
 


@@ -19,96 +20,114 @@ cc_aligned_struct(16) ccecb_ctx;
 /* Actual symmetric algorithm implementation should provide you one of these. */
 struct ccmode_ecb {
     size_t size;        /* first argument to ccecb_ctx_decl(). */
 /* Actual symmetric algorithm implementation should provide you one of these. */
 struct ccmode_ecb {
     size_t size;        /* first argument to ccecb_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_ecb *ecb, ccecb_ctx *ctx,
     void (*init)(const struct ccmode_ecb *ecb, ccecb_ctx *ctx,

-                 unsigned long key_len, const void *key);
-    void (*ecb)(const ccecb_ctx *ctx, unsigned long nblocks, const void *in,
+                 size_t key_len, const void *key);
+    void (*ecb)(const ccecb_ctx *ctx, size_t nblocks, const void *in,

                 void *out);
 };
 
                 void *out);
 };
 

-/* CBC mode. */
+/*!
+ * @brief corecrypto symmetrical encryption and decryption modes
+ *
+ * corecrypto supports 6 stateless en(de)cryption modes and 2 stateful authenticated en(de)cryption modes
+ * stateless modes CBC, CFB, CFB8, CTR, OFB, XTS: They provide 3 interface functions that do not return errors codes
+ *   1- ccmod_xxx_init()
+ *   2- ccmod_xxx_decrypt()
+ *   3- ccmod_xxx_encrypt()
+ * 
+ * stateful modes CCM and GCM: They provide 7 interface functions that return error codes if a function is called out of state
+ *   1- ccmod_xxx_init()
+ *   2- ccmod_xxx_setiv()
+ *   3- ccmod_xxx_aad()
+ *   4- ccmod_xxx_decrypt()
+ *   5- ccmod_xxx_encrypt()
+ *   6- ccmod_xxx_finalize()
+ *   7- ccmod_xxx_reset()
+ *
+ *  the correct call sequences are:
+ *
+ *  calls to 1, 2 and 6 arerequired
+ *  2 and 3 can be called as mant times as needed
+ *  calls to 3, 4, 5 can be skipped
+ *
+ *  1, 2*n, 3*n, 4|5, 6
+ *  1, 2*n,    , 4|5, 6
+ *  1, 2*n,    ,    , 6
+ *  1, 2*n, 3*n,    , 6
+ */
+
+// 1- CBC mode, stateless

 cc_aligned_struct(16) cccbc_ctx;
 cc_aligned_struct(16) cccbc_iv;
 
 struct ccmode_cbc {
     size_t size;        /* first argument to cccbc_ctx_decl(). */
 cc_aligned_struct(16) cccbc_ctx;
 cc_aligned_struct(16) cccbc_iv;
 
 struct ccmode_cbc {
     size_t size;        /* first argument to cccbc_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_cbc *cbc, cccbc_ctx *ctx,
     void (*init)(const struct ccmode_cbc *cbc, cccbc_ctx *ctx,

-                     unsigned long key_len, const void *key);
+                 size_t key_len, const void *key);

     /* cbc encrypt or decrypt nblocks from in to out, iv will be used and updated. */
     /* cbc encrypt or decrypt nblocks from in to out, iv will be used and updated. */

-    void (*cbc)(const cccbc_ctx *ctx, cccbc_iv *iv, unsigned long nblocks,
-                const void *in, void *out);
+    void (*cbc)(const cccbc_ctx *ctx, cccbc_iv *iv,
+                size_t nblocks, const void *in, void *out);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* CFB mode. */
+// 2- CFB mode, stateless

 cc_aligned_struct(16) cccfb_ctx;
 
 struct ccmode_cfb {
     size_t size;        /* first argument to cccfb_ctx_decl(). */
 cc_aligned_struct(16) cccfb_ctx;
 
 struct ccmode_cfb {
     size_t size;        /* first argument to cccfb_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_cfb *cfb, cccfb_ctx *ctx,
     void (*init)(const struct ccmode_cfb *cfb, cccfb_ctx *ctx,

-                 unsigned long key_len, const void *key,
-                 const void *iv);
-    void (*cfb)(cccfb_ctx *ctx, unsigned long nblocks,
-                const void *in, void *out);
+                 size_t key_len, const void *key, const void *iv);
+    void (*cfb)(cccfb_ctx *ctx, size_t nbytes, const void *in, void *out);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* CFB8 mode. */
-
+// 3- CFB8 mode, stateless

 cc_aligned_struct(16) cccfb8_ctx;
 
 struct ccmode_cfb8 {
     size_t size;        /* first argument to cccfb8_ctx_decl(). */
 cc_aligned_struct(16) cccfb8_ctx;
 
 struct ccmode_cfb8 {
     size_t size;        /* first argument to cccfb8_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_cfb8 *cfb8, cccfb8_ctx *ctx,
     void (*init)(const struct ccmode_cfb8 *cfb8, cccfb8_ctx *ctx,

-                 unsigned long key_len, const void *key,
-                 const void *iv);
-    void (*cfb8)(cccfb8_ctx *ctx, unsigned long nbytes,
-                 const void *in, void *out);
+                 size_t key_len, const void *key, const void *iv);
+    void (*cfb8)(cccfb8_ctx *ctx, size_t nbytes, const void *in, void *out);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* CTR mode. */
-
+// 4- CTR mode, stateless

 cc_aligned_struct(16) ccctr_ctx;
 
 struct ccmode_ctr {
     size_t size;        /* first argument to ccctr_ctx_decl(). */
 cc_aligned_struct(16) ccctr_ctx;
 
 struct ccmode_ctr {
     size_t size;        /* first argument to ccctr_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_ctr *ctr, ccctr_ctx *ctx,
     void (*init)(const struct ccmode_ctr *ctr, ccctr_ctx *ctx,

-                 unsigned long key_len, const void *key,
-                 const void *iv);
-    void (*ctr)(ccctr_ctx *ctx, unsigned long nblocks,
-                const void *in, void *out);
+                 size_t key_len, const void *key, const void *iv);
+    void (*ctr)(ccctr_ctx *ctx, size_t nbytes, const void *in, void *out);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* OFB mode. */
-
+// 5- OFB mode, stateless

 cc_aligned_struct(16) ccofb_ctx;
 
 struct ccmode_ofb {
     size_t size;        /* first argument to ccofb_ctx_decl(). */
 cc_aligned_struct(16) ccofb_ctx;
 
 struct ccmode_ofb {
     size_t size;        /* first argument to ccofb_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_ofb *ofb, ccofb_ctx *ctx,
     void (*init)(const struct ccmode_ofb *ofb, ccofb_ctx *ctx,

-                 unsigned long key_len, const void *key,
-                 const void *iv);
-    void (*ofb)(ccofb_ctx *ctx, unsigned long nblocks,
-                const void *in, void *out);
+                 size_t key_len, const void *key, const void *iv);
+    void (*ofb)(ccofb_ctx *ctx, size_t nbytes, const void *in, void *out);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* XTS mode. */
-
+// 6- XTS mode, stateless

 cc_aligned_struct(16) ccxts_ctx;
 cc_aligned_struct(16) ccxts_tweak;
 
 struct ccmode_xts {
     size_t size;        /* first argument to ccxts_ctx_decl(). */
     size_t tweak_size;  /* first argument to ccxts_tweak_decl(). */
 cc_aligned_struct(16) ccxts_ctx;
 cc_aligned_struct(16) ccxts_tweak;
 
 struct ccmode_xts {
     size_t size;        /* first argument to ccxts_ctx_decl(). */
     size_t tweak_size;  /* first argument to ccxts_tweak_decl(). */

-    unsigned long block_size;
+    size_t block_size;

 
     /* Create a xts key from a xts mode object.  The tweak_len here
      determines how long the tweak is in bytes, for each subsequent call to
 
     /* Create a xts key from a xts mode object.  The tweak_len here
      determines how long the tweak is in bytes, for each subsequent call to


@@ -116,49 +135,68 @@ struct ccmode_xts {
      key must point to at least 'size' cc_units of free storage.
      tweak_key must point to at least 'tweak_size' cc_units of free storage. */
     void (*init)(const struct ccmode_xts *xts, ccxts_ctx *ctx,
      key must point to at least 'size' cc_units of free storage.
      tweak_key must point to at least 'tweak_size' cc_units of free storage. */
     void (*init)(const struct ccmode_xts *xts, ccxts_ctx *ctx,

-                 unsigned long key_len, const void *key,
-                 const void *tweak_key);
+                 size_t key_len, const void *key, const void *tweak_key);

 
     /* Set the tweak (sector number), the block within the sector zero. */
     void (*set_tweak)(const ccxts_ctx *ctx, ccxts_tweak *tweak, const void *iv);
 
     /* Encrypt blocks for a sector, clients must call set_tweak before calling
        this function. Return a pointer to the tweak buffer */
 
     /* Set the tweak (sector number), the block within the sector zero. */
     void (*set_tweak)(const ccxts_ctx *ctx, ccxts_tweak *tweak, const void *iv);
 
     /* Encrypt blocks for a sector, clients must call set_tweak before calling
        this function. Return a pointer to the tweak buffer */

-    void *(*xts)(const ccxts_ctx *ctx, ccxts_tweak *tweak, unsigned long nblocks,
-                    const void *in, void *out);
+    void *(*xts)(const ccxts_ctx *ctx, ccxts_tweak *tweak,
+                 size_t nblocks, const void *in, void *out);

 
     const void *custom;
     const void *custom1;
 };
 
 
     const void *custom;
     const void *custom1;
 };
 

-/* GCM mode. */
-
+//7- GCM mode, statful

 cc_aligned_struct(16) ccgcm_ctx;
 cc_aligned_struct(16) ccgcm_ctx;

+#define  CCMODE_GCM_DECRYPTOR 78647
+#define  CCMODE_GCM_ENCRYPTOR 4073947

 
 struct ccmode_gcm {
     size_t size;        /* first argument to ccgcm_ctx_decl(). */
 
 struct ccmode_gcm {
     size_t size;        /* first argument to ccgcm_ctx_decl(). */

-    unsigned long block_size;
-    void (*init)(const struct ccmode_gcm *gcm, ccgcm_ctx *ctx,
-                 unsigned long key_len, const void *key);
-    void (*set_iv)(ccgcm_ctx *ctx, size_t iv_size, const void *iv);
-    void (*gmac)(ccgcm_ctx *ctx, unsigned long nbytes, const void *in);  // could just be gcm with NULL out
-    void (*gcm)(ccgcm_ctx *ctx, unsigned long nbytes, const void *in, void *out);
-    void (*finalize)(ccgcm_ctx *key, size_t tag_size, void *tag);
-    void (*reset)(ccgcm_ctx *ctx);
+    int encdec;        //is it encrypt or decrypt object
+    size_t block_size;
+    int (*init)(const struct ccmode_gcm *gcm, ccgcm_ctx *ctx,
+                 size_t key_len, const void *key);
+    int (*set_iv)(ccgcm_ctx *ctx, size_t iv_size, const void *iv);
+    int (*gmac)(ccgcm_ctx *ctx, size_t nbytes, const void *in);  // could just be gcm with NULL out
+    int (*gcm)(ccgcm_ctx *ctx, size_t nbytes, const void *in, void *out);
+    int (*finalize)(ccgcm_ctx *key, size_t tag_size, void *tag);
+    int (*reset)(ccgcm_ctx *ctx);

     const void *custom;
 };
 
     const void *custom;
 };
 

-/* OMAC mode. */
+//8- GCM mode, statful
+cc_aligned_struct(16) ccccm_ctx;
+cc_aligned_struct(16) ccccm_nonce;
+
+struct ccmode_ccm {
+    size_t size;        /* first argument to ccccm_ctx_decl(). */
+    size_t nonce_size;  /* first argument to ccccm_nonce_decl(). */
+    size_t block_size;
+    int (*init)(const struct ccmode_ccm *ccm, ccccm_ctx *ctx,
+                 size_t key_len, const void *key);
+    int (*set_iv)(ccccm_ctx *ctx, ccccm_nonce *nonce_ctx, size_t nonce_len, const void *nonce,
+                   size_t mac_size, size_t auth_len, size_t data_len);
+    int (*cbcmac)(ccccm_ctx *ctx, ccccm_nonce *nonce_ctx, size_t nbytes, const void *in);  // could just be ccm with NULL out
+    int (*ccm)(ccccm_ctx *ctx, ccccm_nonce *nonce_ctx, size_t nbytes, const void *in, void *out);
+    int (*finalize)(ccccm_ctx *key, ccccm_nonce *nonce_ctx, void *mac);
+    int (*reset)(ccccm_ctx *key, ccccm_nonce *nonce_ctx);
+    const void *custom;
+};

 
 

+
+/* OMAC mode. */

 cc_aligned_struct(16) ccomac_ctx;
 
 struct ccmode_omac {
     size_t size;        /* first argument to ccomac_ctx_decl(). */
 cc_aligned_struct(16) ccomac_ctx;
 
 struct ccmode_omac {
     size_t size;        /* first argument to ccomac_ctx_decl(). */

-    unsigned long block_size;
+    size_t block_size;

     void (*init)(const struct ccmode_omac *omac, ccomac_ctx *ctx,
     void (*init)(const struct ccmode_omac *omac, ccomac_ctx *ctx,

-                 unsigned long tweak_len, unsigned long key_len,
-                 const void *key);
-    int (*omac)(ccomac_ctx *ctx, unsigned long nblocks,
+                 size_t tweak_len, size_t key_len, const void *key);
+    int (*omac)(ccomac_ctx *ctx, size_t nblocks,

                 const void *tweak, const void *in, void *out);
     const void *custom;
 };
                 const void *tweak, const void *in, void *out);
     const void *custom;
 };