Mbed TLS v2.28.5
chacha20.h
Go to the documentation of this file.
1 
15 /*
16  * Copyright The Mbed TLS Contributors
17  * SPDX-License-Identifier: Apache-2.0
18  *
19  * Licensed under the Apache License, Version 2.0 (the "License"); you may
20  * not use this file except in compliance with the License.
21  * You may obtain a copy of the License at
22  *
23  * http://www.apache.org/licenses/LICENSE-2.0
24  *
25  * Unless required by applicable law or agreed to in writing, software
26  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
27  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
28  * See the License for the specific language governing permissions and
29  * limitations under the License.
30  */
31 
32 #ifndef MBEDTLS_CHACHA20_H
33 #define MBEDTLS_CHACHA20_H
34 
35 #if !defined(MBEDTLS_CONFIG_FILE)
36 #include "mbedtls/config.h"
37 #else
38 #include MBEDTLS_CONFIG_FILE
39 #endif
40 
41 #include <stdint.h>
42 #include <stddef.h>
43 
45 #define MBEDTLS_ERR_CHACHA20_BAD_INPUT_DATA -0x0051
46 
47 /* MBEDTLS_ERR_CHACHA20_FEATURE_UNAVAILABLE is deprecated and should not be
48  * used. */
50 #define MBEDTLS_ERR_CHACHA20_FEATURE_UNAVAILABLE -0x0053
51 
52 /* MBEDTLS_ERR_CHACHA20_HW_ACCEL_FAILED is deprecated and should not be used.
53  */
55 #define MBEDTLS_ERR_CHACHA20_HW_ACCEL_FAILED -0x0055
56 
57 #ifdef __cplusplus
58 extern "C" {
59 #endif
60 
61 #if !defined(MBEDTLS_CHACHA20_ALT)
62 
63 typedef struct mbedtls_chacha20_context {
64  uint32_t state[16];
65  uint8_t keystream8[64];
67 }
69 
70 #else /* MBEDTLS_CHACHA20_ALT */
71 #include "chacha20_alt.h"
72 #endif /* MBEDTLS_CHACHA20_ALT */
73 
90 
101 
119  const unsigned char key[32]);
120 
141  const unsigned char nonce[12],
142  uint32_t counter);
143 
174  size_t size,
175  const unsigned char *input,
176  unsigned char *output);
177 
206 int mbedtls_chacha20_crypt(const unsigned char key[32],
207  const unsigned char nonce[12],
208  uint32_t counter,
209  size_t size,
210  const unsigned char *input,
211  unsigned char *output);
212 
213 #if defined(MBEDTLS_SELF_TEST)
214 
220 int mbedtls_chacha20_self_test(int verbose);
221 #endif /* MBEDTLS_SELF_TEST */
222 
223 #ifdef __cplusplus
224 }
225 #endif
226 
227 #endif /* MBEDTLS_CHACHA20_H */
struct mbedtls_chacha20_context mbedtls_chacha20_context
Configuration options (set of defines)
int mbedtls_chacha20_crypt(const unsigned char key[32], const unsigned char nonce[12], uint32_t counter, size_t size, const unsigned char *input, unsigned char *output)
This function encrypts or decrypts data with ChaCha20 and the given key and nonce.
int mbedtls_chacha20_self_test(int verbose)
The ChaCha20 checkup routine.
uint8_t keystream8[64]
Definition: chacha20.h:65
int mbedtls_chacha20_setkey(mbedtls_chacha20_context *ctx, const unsigned char key[32])
This function sets the encryption/decryption key.
int mbedtls_chacha20_starts(mbedtls_chacha20_context *ctx, const unsigned char nonce[12], uint32_t counter)
This function sets the nonce and initial counter value.
void mbedtls_chacha20_free(mbedtls_chacha20_context *ctx)
This function releases and clears the specified ChaCha20 context.
int mbedtls_chacha20_update(mbedtls_chacha20_context *ctx, size_t size, const unsigned char *input, unsigned char *output)
This function encrypts or decrypts data.
void mbedtls_chacha20_init(mbedtls_chacha20_context *ctx)
This function initializes the specified ChaCha20 context.
uint32_t state[16]
Definition: chacha20.h:64