Macros | Functions
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.0

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); \
}
ROL32
#define ROL32(a, n)
Definition: crypto.h:776
b
uint8_t b
Definition: nbns_common.h:104
c
uint8_t c
Definition: ndp.h:514
a
uint8_t a
Definition: ndp.h:411

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]contextPointer to the ChaCha context
[in]inputPointer to the data to encrypt/decrypt (optional)
[in]outputPointer to the resulting data (optional)
[in]lengthNumber of bytes to be processed

Definition at line 183 of file chacha.c.

◆ chachaDeinit()

void chachaDeinit ( ChachaContext *  context)

Release ChaCha context.

Parameters
[in]contextPointer 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]contextPointer to the ChaCha context to initialize
[in]nrNumber of rounds to be applied (8, 12 or 20)
[in]keyPointer to the key
[in]keyLenLength of the key, in bytes (16 or 32)
[in]noncePointer to the nonce
[in]nonceLenLength 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]contextPointer to the ChaCha context

Definition at line 260 of file chacha.c.