ascon_xof128.c File Reference

Ascon-XOF128 extendable-output function. More...

#include "core/crypto.h"
#include "lwc/ascon_xof128.h"

Go to the source code of this file.

Macros

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL
 

Functions

error_t asconXof128Compute (const void *input, size_t inputLen, uint8_t *output, size_t outputLen)
 Digest a message using Ascon-XOF128. More...
 
error_t asconXof128Init (AsconXof128Context *context)
 Initialize Ascon-XOF128 context. More...
 
void asconXof128Absorb (AsconXof128Context *context, const void *input, size_t length)
 Absorb data. More...
 
void asconXof128Final (AsconXof128Context *context)
 Finish absorbing phase. More...
 
void asconXof128Squeeze (AsconXof128Context *context, uint8_t *output, size_t length)
 Extract data from the squeezing phase. More...
 

Variables

const uint8_t ASCON_XOF128_OID [1] = {0x00}
 
const XofAlgo asconXof128XofAlgo
 

Detailed Description

Ascon-XOF128 extendable-output function.

License

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

Copyright (C) 2010-2026 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.

Description

Ascon-XOF128 is an eXtendable Output Functions (XOF), where the output size of the hash of the message can be selected by the user, and the supported security strength is up to 128 bits

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
2.6.6

Definition in file ascon_xof128.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 38 of file ascon_xof128.c.

Function Documentation

◆ asconXof128Absorb()

void asconXof128Absorb ( AsconXof128Context *  context,
const void *  input,
size_t  length 
)

Absorb data.

Parameters
[in]contextPointer to the Ascon-XOF128 context
[in]inputPointer to the buffer being hashed
[in]lengthLength of the buffer

Definition at line 162 of file ascon_xof128.c.

◆ asconXof128Compute()

error_t asconXof128Compute ( const void *  input,
size_t  inputLen,
uint8_t *  output,
size_t  outputLen 
)

Digest a message using Ascon-XOF128.

Parameters
[in]inputPointer to the input data
[in]inputLenLength of the input data
[out]outputPointer to the output data
[in]outputLenExpected length of the output data
Returns
Error code

Definition at line 76 of file ascon_xof128.c.

◆ asconXof128Final()

void asconXof128Final ( AsconXof128Context *  context)

Finish absorbing phase.

Parameters
[in]contextPointer to the Ascon-XOF128 context

Definition at line 206 of file ascon_xof128.c.

◆ asconXof128Init()

error_t asconXof128Init ( AsconXof128Context *  context)

Initialize Ascon-XOF128 context.

Parameters
[in]contextPointer to the Ascon-XOF128 context to initialize
Returns
Error code

Definition at line 125 of file ascon_xof128.c.

◆ asconXof128Squeeze()

void asconXof128Squeeze ( AsconXof128Context *  context,
uint8_t *  output,
size_t  length 
)

Extract data from the squeezing phase.

Parameters
[in]contextPointer to the Ascon-XOF128 context
[out]outputOutput string
[in]lengthDesired output length, in bytes

Definition at line 245 of file ascon_xof128.c.

Variable Documentation

◆ ASCON_XOF128_OID

const uint8_t ASCON_XOF128_OID[1] = {0x00}

Definition at line 48 of file ascon_xof128.c.

◆ asconXof128XofAlgo

Ascon-XOF128 algorithm context.
Definition: ascon_xof128.h:52
void asconXof128Absorb(AsconXof128Context *context, const void *input, size_t length)
Absorb data.
Definition: ascon_xof128.c:162
void(* XofAlgoAbsorb)(void *context, const void *input, size_t length)
Definition: crypto.h:1191
error_t(* XofAlgoInit)(void *context)
Definition: crypto.h:1186
const uint8_t ASCON_XOF128_OID[1]
Definition: ascon_xof128.c:48
error_t(* XofAlgoInitEx)(void *context, const char_t *custom, size_t customLen)
Definition: crypto.h:1188
void asconXof128Squeeze(AsconXof128Context *context, uint8_t *output, size_t length)
Extract data from the squeezing phase.
Definition: ascon_xof128.c:245
error_t(* XofAlgoCompute)(const void *input, size_t inputLen, uint8_t *output, size_t outputLen)
Definition: crypto.h:1180
void asconXof128Final(AsconXof128Context *context)
Finish absorbing phase.
Definition: ascon_xof128.c:206
error_t asconXof128Init(AsconXof128Context *context)
Initialize Ascon-XOF128 context.
Definition: ascon_xof128.c:125
void(* XofAlgoSqueeze)(void *context, uint8_t *output, size_t length)
Definition: crypto.h:1193
error_t(* XofAlgoComputeEx)(const void *input, size_t inputLen, const char_t *custom, size_t customLen, uint8_t *output, size_t outputLen)
Definition: crypto.h:1183
void(* XofAlgoFinal)(void *context)
Definition: crypto.h:1192
error_t asconXof128Compute(const void *input, size_t inputLen, uint8_t *output, size_t outputLen)
Digest a message using Ascon-XOF128.
Definition: ascon_xof128.c:76