ascon-aead-inc-80pq.c File Reference

#include "aead/ascon-aead-common.h"
#include "core/ascon-util-snp.h"
#include <string.h>

Go to the source code of this file.

Functions
void	ascon80pq_aead_start (ascon80pq_state_t *state, const unsigned char *ad, size_t adlen, const unsigned char *npub, const unsigned char *k)
	Starts encrypting or decrypting a packet with ASCON-80pq in incremental mode. More...
void	ascon80pq_aead_abort (ascon80pq_state_t *state)
	Aborts use of ASCON-80pq in incremental mode. More...
void	ascon80pq_aead_encrypt_block (ascon80pq_state_t *state, const unsigned char *in, unsigned char *out, size_t len)
	Encrypts a block of data with ASCON-80pq in incremental mode. More...
void	ascon80pq_aead_encrypt_finalize (ascon80pq_state_t *state, unsigned char *tag)
	Finalizes an incremental ASCON-80pq encryption operation and generates the authentication tag. More...
void	ascon80pq_aead_decrypt_block (ascon80pq_state_t *state, const unsigned char *in, unsigned char *out, size_t len)
	Decrypts a block of data with ASCON-80pq in incremental mode. More...
int	ascon80pq_aead_decrypt_finalize (ascon80pq_state_t *state, const unsigned char *tag)
	Finalizes an incremental ASCON-80pq decryption operation and checks the authentication tag. More...

Function Documentation

ascon80pq_aead_abort()

void ascon80pq_aead_abort

(

ascon80pq_state_t *

state

)

Aborts use of ASCON-80pq in incremental mode.

Parameters

state

State to abort.

This function may be used any time after ascon80pq_aead_start() and before the encryption or decryption process is finalized to abort the process entirely and free the state.

Definition at line 55 of file ascon-aead-inc-80pq.c.

ascon80pq_aead_decrypt_block()

void ascon80pq_aead_decrypt_block	(	ascon80pq_state_t *	state,
		const unsigned char *	in,
		unsigned char *	out,
		size_t	len
	)

Decrypts a block of data with ASCON-80pq in incremental mode.

Parameters

state	State to use for ASCON-80pq encryption operations.
in	Buffer that contains the ciphertext to decrypt.
out	Buffer to receive the plaintext output. Can be the same buffer as in.
len	Length of the plaintext and ciphertext in bytes.

See also

ascon80pq_aead_encrypt_block(), ascon80pq_aead_start(), ascon80pq_aead_decrypt_finalize()

Examples

asconcrypt/asconcrypt.c.

Definition at line 92 of file ascon-aead-inc-80pq.c.

ascon80pq_aead_decrypt_finalize()

int ascon80pq_aead_decrypt_finalize	(	ascon80pq_state_t *	state,
		const unsigned char *	tag
	)

Finalizes an incremental ASCON-80pq decryption operation and checks the authentication tag.

Parameters

state	State to use for ASCON-80pq encryption operations.
tag	Points to the buffer containing the ciphertext's authentication tag. Must be at least ASCON80PQ_TAG_SIZE bytes in length.

Returns

0 on success, -1 if the authentication tag was incorrect, or some other negative number if there was an error in the parameters.

The contents of state will be freed by this function, destroying any sensitive material that may be present.

See also

ascon80pq_aead_decrypt_block(), ascon80pq_aead_start()

Examples

asconcrypt/asconcrypt.c.

Definition at line 102 of file ascon-aead-inc-80pq.c.

ascon80pq_aead_encrypt_block()

void ascon80pq_aead_encrypt_block	(	ascon80pq_state_t *	state,
		const unsigned char *	in,
		unsigned char *	out,
		size_t	len
	)

Encrypts a block of data with ASCON-80pq in incremental mode.

Parameters

state	State to use for ASCON-80pq encryption operations.
in	Buffer that contains the plaintext to encrypt.
out	Buffer to receive the ciphertext output. Can be the same buffer as in.
len	Length of the plaintext and ciphertext in bytes.

See also

ascon80pq_aead_decrypt_block(), ascon80pq_aead_start(), ascon80pq_aead_encrypt_finalize()

Examples

asconcrypt/asconcrypt.c.

Definition at line 64 of file ascon-aead-inc-80pq.c.

ascon80pq_aead_encrypt_finalize()

void ascon80pq_aead_encrypt_finalize	(	ascon80pq_state_t *	state,
		unsigned char *	tag
	)

Finalizes an incremental ASCON-80pq encryption operation and generates the authentication tag.

Parameters

state	State to use for ASCON-80pq encryption operations.
tag	Points to the buffer to receive the authentication tag. Must be at least ASCON80PQ_TAG_SIZE bytes in length.

The contents of state will be freed by this function, destroying any sensitive material that may be present.

See also

ascon80pq_aead_encrypt_block(), ascon80pq_aead_start()

Examples

asconcrypt/asconcrypt.c.

Definition at line 74 of file ascon-aead-inc-80pq.c.

ascon80pq_aead_start()

void ascon80pq_aead_start	(	ascon80pq_state_t *	state,
		const unsigned char *	ad,
		size_t	adlen,
		const unsigned char *	npub,
		const unsigned char *	k
	)

Starts encrypting or decrypting a packet with ASCON-80pq in incremental mode.

Parameters

state	State to initialize for ASCON-80pq operations.
ad	Buffer that contains associated data to authenticate along with the packet but which does not need to be encrypted.
adlen	Length of the associated data in bytes.
npub	Points to the public nonce for the packet which must be 16 bytes in length.
k	Points to the 20 bytes of the key to use to encrypt the packet.

The following sequence can be used to encrypt a list of i plaintext message blocks (m) to produce i ciphertext message blocks (c) and an authentication tag (t).

ascon80pq_state_t state;
ascon80pq_aead_start(&state, ad, adlen, npub, k);
ascon80pq_aead_encrypt_block(&state, m1, c1, m1_len);
ascon80pq_aead_encrypt_block(&state, m2, c2, m2_len);
...;
ascon80pq_aead_encrypt_block(&state, mi, ci, mi_len);
ascon80pq_aead_encrypt_finalize(&state, t);

Decryption uses a similar sequence:

ascon80pq_state_t state;
ascon80pq_aead_start(&state, ad, adlen, npub, k);
ascon80pq_aead_decrypt_block(&state, c1, m1, c1_len);
ascon80pq_aead_decrypt_block(&state, c2, m2, c2_len);
...;
ascon80pq_aead_decrypt_block(&state, ci, mi, ci_len);
if (ascon80pq_aead_decrypt_finalize(&state, t) < 0)
    ...; // decryption has failed!

It is very important that the plaintext output from decryption be discarded if the authentication tag fails to verify. Applications should not use any of the data before verifying the tag.

See also

ascon80pq_aead_encrypt_block(), ascon80pq_aead_decrypt_block(), ascon80pq_aead_encrypt_finalize(), ascon80pq_aead_decrypt_finalize()

Examples

asconcrypt/asconcrypt.c.

Definition at line 30 of file ascon-aead-inc-80pq.c.