cipher_internal.h 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. /**
  2. * \file cipher_internal.h
  3. *
  4. * \brief Cipher wrappers.
  5. *
  6. * \author Adriaan de Jong <[email protected]>
  7. */
  8. /*
  9. * Copyright The Mbed TLS Contributors
  10. * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
  11. *
  12. * This file is provided under the Apache License 2.0, or the
  13. * GNU General Public License v2.0 or later.
  14. *
  15. * **********
  16. * Apache License 2.0:
  17. *
  18. * Licensed under the Apache License, Version 2.0 (the "License"); you may
  19. * not use this file except in compliance with the License.
  20. * You may obtain a copy of the License at
  21. *
  22. * http://www.apache.org/licenses/LICENSE-2.0
  23. *
  24. * Unless required by applicable law or agreed to in writing, software
  25. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  26. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  27. * See the License for the specific language governing permissions and
  28. * limitations under the License.
  29. *
  30. * **********
  31. *
  32. * **********
  33. * GNU General Public License v2.0 or later:
  34. *
  35. * This program is free software; you can redistribute it and/or modify
  36. * it under the terms of the GNU General Public License as published by
  37. * the Free Software Foundation; either version 2 of the License, or
  38. * (at your option) any later version.
  39. *
  40. * This program is distributed in the hope that it will be useful,
  41. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  42. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  43. * GNU General Public License for more details.
  44. *
  45. * You should have received a copy of the GNU General Public License along
  46. * with this program; if not, write to the Free Software Foundation, Inc.,
  47. * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  48. *
  49. * **********
  50. */
  51. #ifndef MBEDTLS_CIPHER_WRAP_H
  52. #define MBEDTLS_CIPHER_WRAP_H
  53. #if !defined(MBEDTLS_CONFIG_FILE)
  54. #include "config.h"
  55. #else
  56. #include MBEDTLS_CONFIG_FILE
  57. #endif
  58. #include "cipher.h"
  59. #ifdef __cplusplus
  60. extern "C" {
  61. #endif
  62. /**
  63. * Base cipher information. The non-mode specific functions and values.
  64. */
  65. struct mbedtls_cipher_base_t
  66. {
  67. /** Base Cipher type (e.g. MBEDTLS_CIPHER_ID_AES) */
  68. mbedtls_cipher_id_t cipher;
  69. /** Encrypt using ECB */
  70. int (*ecb_func)( void *ctx, mbedtls_operation_t mode,
  71. const unsigned char *input, unsigned char *output );
  72. #if defined(MBEDTLS_CIPHER_MODE_CBC)
  73. /** Encrypt using CBC */
  74. int (*cbc_func)( void *ctx, mbedtls_operation_t mode, size_t length,
  75. unsigned char *iv, const unsigned char *input,
  76. unsigned char *output );
  77. #endif
  78. #if defined(MBEDTLS_CIPHER_MODE_CFB)
  79. /** Encrypt using CFB (Full length) */
  80. int (*cfb_func)( void *ctx, mbedtls_operation_t mode, size_t length, size_t *iv_off,
  81. unsigned char *iv, const unsigned char *input,
  82. unsigned char *output );
  83. #endif
  84. #if defined(MBEDTLS_CIPHER_MODE_OFB)
  85. /** Encrypt using OFB (Full length) */
  86. int (*ofb_func)( void *ctx, size_t length, size_t *iv_off,
  87. unsigned char *iv,
  88. const unsigned char *input,
  89. unsigned char *output );
  90. #endif
  91. #if defined(MBEDTLS_CIPHER_MODE_CTR)
  92. /** Encrypt using CTR */
  93. int (*ctr_func)( void *ctx, size_t length, size_t *nc_off,
  94. unsigned char *nonce_counter, unsigned char *stream_block,
  95. const unsigned char *input, unsigned char *output );
  96. #endif
  97. #if defined(MBEDTLS_CIPHER_MODE_XTS)
  98. /** Encrypt or decrypt using XTS. */
  99. int (*xts_func)( void *ctx, mbedtls_operation_t mode, size_t length,
  100. const unsigned char data_unit[16],
  101. const unsigned char *input, unsigned char *output );
  102. #endif
  103. #if defined(MBEDTLS_CIPHER_MODE_STREAM)
  104. /** Encrypt using STREAM */
  105. int (*stream_func)( void *ctx, size_t length,
  106. const unsigned char *input, unsigned char *output );
  107. #endif
  108. /** Set key for encryption purposes */
  109. int (*setkey_enc_func)( void *ctx, const unsigned char *key,
  110. unsigned int key_bitlen );
  111. /** Set key for decryption purposes */
  112. int (*setkey_dec_func)( void *ctx, const unsigned char *key,
  113. unsigned int key_bitlen);
  114. /** Allocate a new context */
  115. void * (*ctx_alloc_func)( void );
  116. /** Free the given context */
  117. void (*ctx_free_func)( void *ctx );
  118. };
  119. typedef struct
  120. {
  121. mbedtls_cipher_type_t type;
  122. const mbedtls_cipher_info_t *info;
  123. } mbedtls_cipher_definition_t;
  124. extern const mbedtls_cipher_definition_t mbedtls_cipher_definitions[];
  125. extern int mbedtls_cipher_supported[];
  126. #ifdef __cplusplus
  127. }
  128. #endif
  129. #endif /* MBEDTLS_CIPHER_WRAP_H */