Mbed TLS v3.5.0
nist_kw.h
Go to the documentation of this file.
1
18/*
19 * Copyright The Mbed TLS Contributors
20 * SPDX-License-Identifier: Apache-2.0
21 *
22 * Licensed under the Apache License, Version 2.0 (the "License"); you may
23 * not use this file except in compliance with the License.
24 * You may obtain a copy of the License at
25 *
26 * http://www.apache.org/licenses/LICENSE-2.0
27 *
28 * Unless required by applicable law or agreed to in writing, software
29 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
30 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
31 * See the License for the specific language governing permissions and
32 * limitations under the License.
33 */
34
35#ifndef MBEDTLS_NIST_KW_H
36#define MBEDTLS_NIST_KW_H
38
39#include "mbedtls/build_info.h"
40
41#include "mbedtls/cipher.h"
42
43#ifdef __cplusplus
44extern "C" {
45#endif
46
47typedef enum {
51
52#if !defined(MBEDTLS_NIST_KW_ALT)
53// Regular implementation
54//
55
63typedef struct {
66
67#else /* MBEDTLS_NIST_key wrapping_ALT */
68#include "nist_kw_alt.h"
69#endif /* MBEDTLS_NIST_KW_ALT */
70
80
99 const unsigned char *key,
100 unsigned int keybits,
101 const int is_wrap);
102
110
133 const unsigned char *input, size_t in_len,
134 unsigned char *output, size_t *out_len, size_t out_size);
135
160 const unsigned char *input, size_t in_len,
161 unsigned char *output, size_t *out_len, size_t out_size);
162
163
164#if defined(MBEDTLS_SELF_TEST) && defined(MBEDTLS_AES_C)
172#endif /* MBEDTLS_SELF_TEST && MBEDTLS_AES_C */
173
174#ifdef __cplusplus
175}
176#endif
177
178#endif /* MBEDTLS_NIST_KW_H */
This file contains an abstraction interface for use with the cipher primitives provided by the librar...
mbedtls_cipher_id_t
Supported cipher types.
Definition: cipher.h:78
Build-time configuration info.
int mbedtls_nist_kw_setkey(mbedtls_nist_kw_context *ctx, mbedtls_cipher_id_t cipher, const unsigned char *key, unsigned int keybits, const int is_wrap)
This function initializes the key wrapping context set in the ctx parameter and sets the encryption k...
int mbedtls_nist_kw_wrap(mbedtls_nist_kw_context *ctx, mbedtls_nist_kw_mode_t mode, const unsigned char *input, size_t in_len, unsigned char *output, size_t *out_len, size_t out_size)
This function encrypts a buffer using key wrapping.
int mbedtls_nist_kw_unwrap(mbedtls_nist_kw_context *ctx, mbedtls_nist_kw_mode_t mode, const unsigned char *input, size_t in_len, unsigned char *output, size_t *out_len, size_t out_size)
This function decrypts a buffer using key wrapping.
mbedtls_nist_kw_mode_t
Definition: nist_kw.h:47
@ MBEDTLS_KW_MODE_KW
Definition: nist_kw.h:48
@ MBEDTLS_KW_MODE_KWP
Definition: nist_kw.h:49
void mbedtls_nist_kw_free(mbedtls_nist_kw_context *ctx)
This function releases and clears the specified key wrapping context and underlying cipher sub-contex...
int mbedtls_nist_kw_self_test(int verbose)
The key wrapping checkup routine.
void mbedtls_nist_kw_init(mbedtls_nist_kw_context *ctx)
This function initializes the specified key wrapping context to make references valid and prepare the...
Macro wrapper for struct's members.
#define MBEDTLS_PRIVATE(member)
The key wrapping context-type definition. The key wrapping context is passed to the APIs called.
Definition: nist_kw.h:63