mbed TLS v2.23.0

cmac.h
Go to the documentation of this file.
1
9 /*
10 * Copyright (C) 2015-2018, Arm Limited (or its affiliates), All Rights Reserved
11 * SPDX-License-Identifier: Apache-2.0
12 *
13 * Licensed under the Apache License, Version 2.0 (the "License"); you may
14 * not use this file except in compliance with the License.
15 * You may obtain a copy of the License at
16 *
17 * http://www.apache.org/licenses/LICENSE-2.0
18 *
19 * Unless required by applicable law or agreed to in writing, software
20 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
21 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
22 * See the License for the specific language governing permissions and
23 * limitations under the License.
24 *
25 * This file is part of Mbed TLS (https://tls.mbed.org)
26 */
27
28 #ifndef MBEDTLS_CMAC_H
29 #define MBEDTLS_CMAC_H
30
31 #if !defined(MBEDTLS_CONFIG_FILE)
32 #include "mbedtls/config.h"
33 #else
34 #include MBEDTLS_CONFIG_FILE
35 #endif
36
37 #include "mbedtls/cipher.h"
38
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42
43 /* MBEDTLS_ERR_CMAC_HW_ACCEL_FAILED is deprecated and should not be used. */
44 #define MBEDTLS_ERR_CMAC_HW_ACCEL_FAILED -0x007A
46 #define MBEDTLS_AES_BLOCK_SIZE 16
47 #define MBEDTLS_DES3_BLOCK_SIZE 8
48
49 #if defined(MBEDTLS_AES_C)
50 #define MBEDTLS_CIPHER_BLKSIZE_MAX 16
51 #else
52 #define MBEDTLS_CIPHER_BLKSIZE_MAX 8
53 #endif
54
55 #if !defined(MBEDTLS_CMAC_ALT)
56
60 struct mbedtls_cmac_context_t
61 {
63 unsigned char state[MBEDTLS_CIPHER_BLKSIZE_MAX];
64
67 unsigned char unprocessed_block[MBEDTLS_CIPHER_BLKSIZE_MAX];
68
70 size_t unprocessed_len;
71 };
72
73 #else /* !MBEDTLS_CMAC_ALT */
74 #include "cmac_alt.h"
75 #endif /* !MBEDTLS_CMAC_ALT */
76
93 int mbedtls_cipher_cmac_starts( mbedtls_cipher_context_t *ctx,
94 const unsigned char *key, size_t keybits );
95
112 int mbedtls_cipher_cmac_update( mbedtls_cipher_context_t *ctx,
113 const unsigned char *input, size_t ilen );
114
130 int mbedtls_cipher_cmac_finish( mbedtls_cipher_context_t *ctx,
131 unsigned char *output );
132
147 int mbedtls_cipher_cmac_reset( mbedtls_cipher_context_t *ctx );
148
171 int mbedtls_cipher_cmac( const mbedtls_cipher_info_t *cipher_info,
172 const unsigned char *key, size_t keylen,
173 const unsigned char *input, size_t ilen,
174 unsigned char *output );
175
176 #if defined(MBEDTLS_AES_C)
177
194 int mbedtls_aes_cmac_prf_128( const unsigned char *key, size_t key_len,
195 const unsigned char *input, size_t in_len,
196 unsigned char output[16] );
197 #endif /* MBEDTLS_AES_C */
198
199 #if defined(MBEDTLS_SELF_TEST) && ( defined(MBEDTLS_AES_C) || defined(MBEDTLS_DES_C) )
200
206 int mbedtls_cmac_self_test( int verbose );
207 #endif /* MBEDTLS_SELF_TEST && ( MBEDTLS_AES_C || MBEDTLS_DES_C ) */
208
209 #ifdef __cplusplus
210 }
211 #endif
212
213 #endif /* MBEDTLS_CMAC_H */
mbedtls_cipher_cmac_starts
int mbedtls_cipher_cmac_starts(mbedtls_cipher_context_t *ctx, const unsigned char *key, size_t keybits)
This function sets the CMAC key, and prepares to authenticate the input data. Must be called with an ...
mbedtls_cmac_context_t::state
unsigned char state[MBEDTLS_CIPHER_BLKSIZE_MAX]
Definition: cmac.h:63
mbedtls_cipher_cmac
int mbedtls_cipher_cmac(const mbedtls_cipher_info_t *cipher_info, const unsigned char *key, size_t keylen, const unsigned char *input, size_t ilen, unsigned char *output)
This function calculates the full generic CMAC on the input buffer with the provided key.
mbedtls_cmac_context_t::unprocessed_len
size_t unprocessed_len
Definition: cmac.h:70
MBEDTLS_CIPHER_BLKSIZE_MAX
#define MBEDTLS_CIPHER_BLKSIZE_MAX
Definition: cmac.h:50
mbedtls_cmac_context_t::unprocessed_block
unsigned char unprocessed_block[MBEDTLS_CIPHER_BLKSIZE_MAX]
Definition: cmac.h:67
mbedtls_cipher_info_t
Definition: cipher.h:251
mbedtls_cipher_cmac_reset
int mbedtls_cipher_cmac_reset(mbedtls_cipher_context_t *ctx)
This function prepares the authentication of another message with the same key as the previous CMAC o...
mbedtls_cmac_context_t
Definition: cmac.h:61
mbedtls_cipher_cmac_finish
int mbedtls_cipher_cmac_finish(mbedtls_cipher_context_t *ctx, unsigned char *output)
This function finishes the CMAC operation, and writes the result to the output buffer.
cipher.h
This file contains an abstraction interface for use with the cipher primitives provided by the librar...
mbedtls_aes_cmac_prf_128
int mbedtls_aes_cmac_prf_128(const unsigned char *key, size_t key_len, const unsigned char *input, size_t in_len, unsigned char output[16])
This function implements the AES-CMAC-PRF-128 pseudorandom function, as defined in RFC-4615: The Adva...
mbedtls_cmac_self_test
int mbedtls_cmac_self_test(int verbose)
The CMAC checkup routine.
mbedtls_cipher_context_t
Definition: cipher.h:293
config.h
Configuration options (set of defines)
mbedtls_cipher_cmac_update
int mbedtls_cipher_cmac_update(mbedtls_cipher_context_t *ctx, const unsigned char *input, size_t ilen)
This function feeds an input buffer into an ongoing CMAC computation.