mbed TLS v2.28.2
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 
64 {
65  uint32_t state[16];
66  uint8_t keystream8[64];
68 }
70 
71 #else /* MBEDTLS_CHACHA20_ALT */
72 #include "chacha20_alt.h"
73 #endif /* MBEDTLS_CHACHA20_ALT */
74 
91 
102 
120  const unsigned char key[32] );
121 
142  const unsigned char nonce[12],
143  uint32_t counter );
144 
175  size_t size,
176  const unsigned char *input,
177  unsigned char *output );
178 
207 int mbedtls_chacha20_crypt( const unsigned char key[32],
208  const unsigned char nonce[12],
209  uint32_t counter,
210  size_t size,
211  const unsigned char* input,
212  unsigned char* output );
213 
214 #if defined(MBEDTLS_SELF_TEST)
221 int mbedtls_chacha20_self_test( int verbose );
222 #endif /* MBEDTLS_SELF_TEST */
223 
224 #ifdef __cplusplus
225 }
226 #endif
227 
228 #endif /* MBEDTLS_CHACHA20_H */
void mbedtls_chacha20_free(mbedtls_chacha20_context *ctx)
This function releases and clears the specified ChaCha20 context.
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_setkey(mbedtls_chacha20_context *ctx, const unsigned char key[32])
This function sets the encryption/decryption key.
void mbedtls_chacha20_init(mbedtls_chacha20_context *ctx)
This function initializes the specified ChaCha20 context.
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.
int mbedtls_chacha20_self_test(int verbose)
The ChaCha20 checkup routine.
struct mbedtls_chacha20_context mbedtls_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.
Configuration options (set of defines)
uint8_t keystream8[64]
Definition: chacha20.h:66
uint32_t state[16]
Definition: chacha20.h:65