chacha.c File Reference

ChaCha encryption algorithm. More...

#include "core/crypto.h"
#include "cipher/chacha.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL
#define	QUARTER_ROUND(a, b, c, d)

Functions
error_t	chachaInit (ChachaContext *context, uint_t nr, const uint8_t *key, size_t keyLen, const uint8_t *nonce, size_t nonceLen)
	Initialize ChaCha context using the supplied key and nonce. More...
void	chachaCipher (ChachaContext *context, const uint8_t *input, uint8_t *output, size_t length)
	Encrypt/decrypt data with the ChaCha algorithm. More...
void	chachaProcessBlock (ChachaContext *context)
	Generate a keystream block. More...
void	chachaDeinit (ChachaContext *context)
	Release ChaCha context. More...

Detailed Description

ChaCha encryption algorithm.

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneCRYPTO Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author

Oryx Embedded SARL (www.oryx-embedded.com)

Version

2.4.4

Definition in file chacha.c.

Macro Definition Documentation

QUARTER_ROUND

#define QUARTER_ROUND	(		a,
			b,
			c,
			d
	)

Value:

{ \
   a += b; \
   d ^= a; \
   d = ROL32(d, 16); \
   c += d; \
   b ^= c; \
   b = ROL32(b, 12); \
   a += b; \
   d ^= a; \
   d = ROL32(d, 8); \
   c += d; \
   b ^= c; \
   b = ROL32(b, 7); \
}

Definition at line 42 of file chacha.c.

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 32 of file chacha.c.

Function Documentation

chachaCipher()

void chachaCipher	(	ChachaContext *	context,
		const uint8_t *	input,
		uint8_t *	output,
		size_t	length
	)

Encrypt/decrypt data with the ChaCha algorithm.

Parameters

[in]	context	Pointer to the ChaCha context
[in]	input	Pointer to the data to encrypt/decrypt (optional)
[in]	output	Pointer to the resulting data (optional)
[in]	length	Number of bytes to be processed

Definition at line 183 of file chacha.c.

chachaDeinit()

void chachaDeinit

(

ChachaContext *

context

)

Release ChaCha context.

Parameters

[in]

context

Pointer to the ChaCha context

Definition at line 314 of file chacha.c.

chachaInit()

error_t chachaInit	(	ChachaContext *	context,
		uint_t	nr,
		const uint8_t *	key,
		size_t	keyLen,
		const uint8_t *	nonce,
		size_t	nonceLen
	)

Initialize ChaCha context using the supplied key and nonce.

Parameters

[in]	context	Pointer to the ChaCha context to initialize
[in]	nr	Number of rounds to be applied (8, 12 or 20)
[in]	key	Pointer to the key
[in]	keyLen	Length of the key, in bytes (16 or 32)
[in]	nonce	Pointer to the nonce
[in]	nonceLen	Length of the nonce, in bytes (8 or 12)

Returns

Error code

Definition at line 70 of file chacha.c.

chachaProcessBlock()

void chachaProcessBlock

(

ChachaContext *

context

)

Generate a keystream block.

Parameters

[in]

context

Pointer to the ChaCha context

Definition at line 260 of file chacha.c.