blob: e761a9ea231165adaf210861c1941c2d67384d2c [file] [log] [blame]
Paul Bakker8123e9d2011-01-06 15:37:30 +00001/**
Manuel Pégourié-Gonnard50518f42015-05-26 11:04:15 +02002 * \file cipher_internal.h
Paul Bakker9af723c2014-05-01 13:03:14 +02003 *
Paul Bakker8123e9d2011-01-06 15:37:30 +00004 * \brief Cipher wrappers.
5 *
6 * \author Adriaan de Jong <dejong@fox-it.com>
Darryl Greena40a1012018-01-05 15:33:17 +00007 */
8/*
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02009 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +020010 * SPDX-License-Identifier: Apache-2.0
11 *
12 * Licensed under the Apache License, Version 2.0 (the "License"); you may
13 * not use this file except in compliance with the License.
14 * You may obtain a copy of the License at
15 *
16 * http://www.apache.org/licenses/LICENSE-2.0
17 *
18 * Unless required by applicable law or agreed to in writing, software
19 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
20 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 * See the License for the specific language governing permissions and
22 * limitations under the License.
Paul Bakker8123e9d2011-01-06 15:37:30 +000023 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000024 * This file is part of mbed TLS (https://tls.mbed.org)
Paul Bakker8123e9d2011-01-06 15:37:30 +000025 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020026#ifndef MBEDTLS_CIPHER_WRAP_H
27#define MBEDTLS_CIPHER_WRAP_H
Paul Bakker8123e9d2011-01-06 15:37:30 +000028
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020029#if !defined(MBEDTLS_CONFIG_FILE)
Paul Bakker314052f2011-08-15 09:07:52 +000030#include "config.h"
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020031#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020032#include MBEDTLS_CONFIG_FILE
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020033#endif
Manuel Pégourié-Gonnard6c5abfa2015-02-13 14:12:07 +000034
Paul Bakker314052f2011-08-15 09:07:52 +000035#include "cipher.h"
Paul Bakker8123e9d2011-01-06 15:37:30 +000036
Paul Bakker8123e9d2011-01-06 15:37:30 +000037#ifdef __cplusplus
38extern "C" {
39#endif
40
Manuel Pégourié-Gonnard5a74e8b2015-05-06 17:10:55 +010041/**
42 * Base cipher information. The non-mode specific functions and values.
43 */
44struct mbedtls_cipher_base_t
45{
46 /** Base Cipher type (e.g. MBEDTLS_CIPHER_ID_AES) */
47 mbedtls_cipher_id_t cipher;
48
49 /** Encrypt using ECB */
50 int (*ecb_func)( void *ctx, mbedtls_operation_t mode,
51 const unsigned char *input, unsigned char *output );
52
53#if defined(MBEDTLS_CIPHER_MODE_CBC)
54 /** Encrypt using CBC */
55 int (*cbc_func)( void *ctx, mbedtls_operation_t mode, size_t length,
56 unsigned char *iv, const unsigned char *input,
57 unsigned char *output );
58#endif
59
60#if defined(MBEDTLS_CIPHER_MODE_CFB)
61 /** Encrypt using CFB (Full length) */
Simon Butcher8c0fd1e2018-04-22 22:58:07 +010062
Manuel Pégourié-Gonnard5a74e8b2015-05-06 17:10:55 +010063 int (*cfb_func)( void *ctx, mbedtls_operation_t mode, size_t length, size_t *iv_off,
64 unsigned char *iv, const unsigned char *input,
65 unsigned char *output );
66#endif
67
Simon Butcher8c0fd1e2018-04-22 22:58:07 +010068#if defined(MBEDTLS_CIPHER_MODE_OFB)
69 /** Encrypt using OFB (Full length) */
70 int (*ofb_func)( void *ctx, size_t length, size_t *iv_off,
71 unsigned char *iv,
72 const unsigned char *input,
73 unsigned char *output );
74#endif
75
Manuel Pégourié-Gonnard5a74e8b2015-05-06 17:10:55 +010076#if defined(MBEDTLS_CIPHER_MODE_CTR)
77 /** Encrypt using CTR */
78 int (*ctr_func)( void *ctx, size_t length, size_t *nc_off,
79 unsigned char *nonce_counter, unsigned char *stream_block,
80 const unsigned char *input, unsigned char *output );
81#endif
82
83#if defined(MBEDTLS_CIPHER_MODE_STREAM)
84 /** Encrypt using STREAM */
85 int (*stream_func)( void *ctx, size_t length,
86 const unsigned char *input, unsigned char *output );
87#endif
88
89 /** Set key for encryption purposes */
90 int (*setkey_enc_func)( void *ctx, const unsigned char *key,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +020091 unsigned int key_bitlen );
Manuel Pégourié-Gonnard5a74e8b2015-05-06 17:10:55 +010092
93 /** Set key for decryption purposes */
94 int (*setkey_dec_func)( void *ctx, const unsigned char *key,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +020095 unsigned int key_bitlen);
Manuel Pégourié-Gonnard5a74e8b2015-05-06 17:10:55 +010096
97 /** Allocate a new context */
98 void * (*ctx_alloc_func)( void );
99
100 /** Free the given context */
101 void (*ctx_free_func)( void *ctx );
102
103};
104
Manuel Pégourié-Gonnarddace82f2013-09-18 15:12:07 +0200105typedef struct
106{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200107 mbedtls_cipher_type_t type;
108 const mbedtls_cipher_info_t *info;
109} mbedtls_cipher_definition_t;
Paul Bakker8123e9d2011-01-06 15:37:30 +0000110
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200111extern const mbedtls_cipher_definition_t mbedtls_cipher_definitions[];
Paul Bakker5e0efa72013-09-08 23:04:04 +0200112
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200113extern int mbedtls_cipher_supported[];
Paul Bakkerfab5c822012-02-06 16:45:10 +0000114
Paul Bakker8123e9d2011-01-06 15:37:30 +0000115#ifdef __cplusplus
116}
117#endif
118
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200119#endif /* MBEDTLS_CIPHER_WRAP_H */