src/vnet/crypto/crypto.h

   1 /*
   2  * Copyright (c) 2019 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16 #ifndef included_vnet_crypto_crypto_h
  17 #define included_vnet_crypto_crypto_h
  18
  19 #define VNET_CRYPTO_RING_SIZE 512
  20
  21 #include <vlib/vlib.h>
  22
  23 /* CRYPTO_ID, PRETTY_NAME, KEY_LENGTH_IN_BYTES */
  24 #define foreach_crypto_cipher_alg \
  25   _(DES_CBC,     "des-cbc", 7) \
  26   _(3DES_CBC,    "3des-cbc", 24) \
  27   _(AES_128_CBC, "aes-128-cbc", 16) \
  28   _(AES_192_CBC, "aes-192-cbc", 24) \
  29   _(AES_256_CBC, "aes-256-cbc", 32) \
  30   _(AES_128_CTR, "aes-128-ctr", 16) \
  31   _(AES_192_CTR, "aes-192-ctr", 24) \
  32   _(AES_256_CTR, "aes-256-ctr", 32)
  33
  34 /* CRYPTO_ID, PRETTY_NAME, KEY_LENGTH_IN_BYTES */
  35 #define foreach_crypto_aead_alg \
  36   _(AES_128_GCM, "aes-128-gcm", 16) \
  37   _(AES_192_GCM, "aes-192-gcm", 24) \
  38   _(AES_256_GCM, "aes-256-gcm", 32)
  39
  40 #define foreach_crypto_hmac_alg \
  41   _(MD5, "md5") \
  42   _(SHA1, "sha-1") \
  43   _(SHA224, "sha-224")  \
  44   _(SHA256, "sha-256")  \
  45   _(SHA384, "sha-384")  \
  46   _(SHA512, "sha-512")
  47
  48
  49 #define foreach_crypto_op_type \
  50   _(ENCRYPT, "encrypt") \
  51   _(DECRYPT, "decrypt") \
  52   _(AEAD_ENCRYPT, "aead-encrypt") \
  53   _(AEAD_DECRYPT, "aead-decrypt") \
  54   _(HMAC, "hmac")
  55
  56 typedef enum
  57 {
  58 #define _(n, s) VNET_CRYPTO_OP_TYPE_##n,
  59   foreach_crypto_op_type
  60 #undef _
  61     VNET_CRYPTO_OP_N_TYPES,
  62 } vnet_crypto_op_type_t;
  63
  64 #define foreach_crypto_op_status \
  65   _(PENDING, "pending") \
  66   _(COMPLETED, "completed") \
  67   _(FAIL_NO_HANDLER, "no-handler") \
  68   _(FAIL_BAD_HMAC, "bad-hmac") \
  69   _(FAIL_DECRYPT, "decrypt-fail")
  70
  71 typedef enum
  72 {
  73   VNET_CRYPTO_KEY_OP_ADD,
  74   VNET_CRYPTO_KEY_OP_DEL,
  75   VNET_CRYPTO_KEY_OP_MODIFY,
  76 } vnet_crypto_key_op_t;
  77
  78 typedef enum
  79 {
  80 #define _(n, s) VNET_CRYPTO_OP_STATUS_##n,
  81   foreach_crypto_op_status
  82 #undef _
  83     VNET_CRYPTO_OP_N_STATUS,
  84 } vnet_crypto_op_status_t;
  85
  86 /* *INDENT-OFF* */
  87 typedef enum
  88 {
  89   VNET_CRYPTO_ALG_NONE = 0,
  90 #define _(n, s, l) VNET_CRYPTO_ALG_##n,
  91   foreach_crypto_cipher_alg
  92   foreach_crypto_aead_alg
  93 #undef _
  94 #define _(n, s) VNET_CRYPTO_ALG_HMAC_##n,
  95   foreach_crypto_hmac_alg
  96 #undef _
  97   VNET_CRYPTO_N_ALGS,
  98 } vnet_crypto_alg_t;
  99
 100 typedef struct
 101 {
 102   u8 *data;
 103   vnet_crypto_alg_t alg:8;
 104 } vnet_crypto_key_t;
 105
 106 typedef enum
 107 {
 108   VNET_CRYPTO_OP_NONE = 0,
 109 #define _(n, s, l) VNET_CRYPTO_OP_##n##_ENC, VNET_CRYPTO_OP_##n##_DEC,
 110   foreach_crypto_cipher_alg
 111   foreach_crypto_aead_alg
 112 #undef _
 113 #define _(n, s) VNET_CRYPTO_OP_##n##_HMAC,
 114  foreach_crypto_hmac_alg
 115 #undef _
 116     VNET_CRYPTO_N_OP_IDS,
 117 } vnet_crypto_op_id_t;
 118 /* *INDENT-ON* */
 119
 120 typedef struct
 121 {
 122   char *name;
 123   vnet_crypto_op_id_t op_by_type[VNET_CRYPTO_OP_N_TYPES];
 124 } vnet_crypto_alg_data_t;
 125
 126 typedef struct
 127 {
 128   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
 129   vnet_crypto_op_id_t op:16;
 130   vnet_crypto_op_status_t status:8;
 131   u8 flags;
 132 #define VNET_CRYPTO_OP_FLAG_INIT_IV (1 << 0)
 133 #define VNET_CRYPTO_OP_FLAG_HMAC_CHECK (1 << 1)
 134   u32 key_index;
 135   u32 len;
 136   u16 aad_len;
 137   u8 digest_len, tag_len;
 138   u8 *iv;
 139   u8 *src;
 140   u8 *dst;
 141   u8 *aad;
 142   u8 *tag;
 143   u8 *digest;
 144   uword user_data;
 145 } vnet_crypto_op_t;
 146
 147 typedef struct
 148 {
 149   vnet_crypto_op_type_t type;
 150   vnet_crypto_alg_t alg;
 151   u32 active_engine_index;
 152 } vnet_crypto_op_data_t;
 153
 154 typedef struct
 155 {
 156   CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
 157   clib_bitmap_t *act_queues;
 158 } vnet_crypto_thread_t;
 159
 160 typedef u32 vnet_crypto_key_index_t;
 161
 162 typedef u32 (vnet_crypto_ops_handler_t) (vlib_main_t * vm,
 163                                          vnet_crypto_op_t * ops[], u32 n_ops);
 164
 165 typedef void (vnet_crypto_key_handler_t) (vlib_main_t * vm,
 166                                           vnet_crypto_key_op_t kop,
 167                                           vnet_crypto_key_index_t idx);
 168
 169 u32 vnet_crypto_register_engine (vlib_main_t * vm, char *name, int prio,
 170                                  char *desc);
 171
 172 void vnet_crypto_register_ops_handler (vlib_main_t * vm, u32 engine_index,
 173                                        vnet_crypto_op_id_t opt,
 174                                        vnet_crypto_ops_handler_t * oph);
 175 void vnet_crypto_register_key_handler (vlib_main_t * vm, u32 engine_index,
 176                                        vnet_crypto_key_handler_t * keyh);
 177
 178 typedef struct
 179 {
 180   char *name;
 181   char *desc;
 182   int priority;
 183   vnet_crypto_key_handler_t *key_op_handler;
 184   vnet_crypto_ops_handler_t *ops_handlers[VNET_CRYPTO_N_OP_IDS];
 185 } vnet_crypto_engine_t;
 186
 187 typedef struct
 188 {
 189   vnet_crypto_alg_data_t *algs;
 190   vnet_crypto_thread_t *threads;
 191   vnet_crypto_ops_handler_t **ops_handlers;
 192   vnet_crypto_op_data_t opt_data[VNET_CRYPTO_N_OP_IDS];
 193   vnet_crypto_engine_t *engines;
 194   vnet_crypto_key_t *keys;
 195   uword *engine_index_by_name;
 196   uword *alg_index_by_name;
 197 } vnet_crypto_main_t;
 198
 199 extern vnet_crypto_main_t crypto_main;
 200
 201 u32 vnet_crypto_submit_ops (vlib_main_t * vm, vnet_crypto_op_t ** jobs,
 202                             u32 n_jobs);
 203
 204 u32 vnet_crypto_process_ops (vlib_main_t * vm, vnet_crypto_op_t ops[],
 205                              u32 n_ops);
 206
 207 int vnet_crypto_set_handler (char *ops_handler_name, char *engine);
 208
 209 u32 vnet_crypto_key_add (vlib_main_t * vm, vnet_crypto_alg_t alg,
 210                          u8 * data, u16 length);
 211 void vnet_crypto_key_del (vlib_main_t * vm, vnet_crypto_key_index_t index);
 212
 213 format_function_t format_vnet_crypto_alg;
 214 format_function_t format_vnet_crypto_engine;
 215 format_function_t format_vnet_crypto_op;
 216 format_function_t format_vnet_crypto_op_type;
 217 format_function_t format_vnet_crypto_op_status;
 218 unformat_function_t unformat_vnet_crypto_alg;
 219
 220 static_always_inline void
 221 vnet_crypto_op_init (vnet_crypto_op_t * op, vnet_crypto_op_id_t type)
 222 {
 223   if (CLIB_DEBUG > 0)
 224     clib_memset (op, 0xfe, sizeof (*op));
 225   op->op = type;
 226   op->flags = 0;
 227   op->key_index = ~0;
 228 }
 229
 230 static_always_inline vnet_crypto_op_type_t
 231 vnet_crypto_get_op_type (vnet_crypto_op_id_t id)
 232 {
 233   vnet_crypto_main_t *cm = &crypto_main;
 234   vnet_crypto_op_data_t *od = vec_elt_at_index (cm->opt_data, id);
 235   return od->type;
 236 }
 237
 238 static_always_inline vnet_crypto_key_t *
 239 vnet_crypto_get_key (vnet_crypto_key_index_t index)
 240 {
 241   vnet_crypto_main_t *cm = &crypto_main;
 242   return vec_elt_at_index (cm->keys, index);
 243 }
 244
 245 #endif /* included_vnet_crypto_crypto_h */
 246
 247 /*
 248  * fd.io coding-style-patch-verification: ON
 249  *
 250  * Local Variables:
 251  * eval: (c-set-style "gnu")
 252  * End:
 253  */