ccm.c File Reference

Cipher Block Chaining-Message Authentication Code (CCM) More...

#include "core/crypto.h"
#include "aead/ccm.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
__weak_func error_t	ccmEncrypt (const CipherAlgo *cipher, void *context, const uint8_t *n, size_t nLen, const uint8_t *a, size_t aLen, const uint8_t *p, uint8_t *c, size_t length, uint8_t *t, size_t tLen)
	Authenticated encryption using CCM. More...
__weak_func error_t	ccmDecrypt (const CipherAlgo *cipher, void *context, const uint8_t *n, size_t nLen, const uint8_t *a, size_t aLen, const uint8_t *c, uint8_t *p, size_t length, const uint8_t *t, size_t tLen)
	Authenticated decryption using CCM. More...
error_t	ccmFormatBlock0 (size_t q, const uint8_t *n, size_t nLen, size_t aLen, size_t tLen, uint8_t *b)
	Format first block B(0) More...
void	ccmXorBlock (uint8_t *x, const uint8_t *a, const uint8_t *b, size_t n)
	XOR operation. More...
void	ccmFormatCounter0 (const uint8_t *n, size_t nLen, uint8_t *ctr)
	Format initial counter value CTR(0) More...
void	ccmIncCounter (uint8_t *ctr, size_t n)
	Increment counter block. More...

Detailed Description

Cipher Block Chaining-Message Authentication Code (CCM)

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.

Description

CCM mode (Cipher Block Chaining-Message Authentication Code) is a mode of operation for cryptographic block ciphers. It is an authenticated encryption algorithm designed to provide both authentication and confidentiality. CCM mode is only defined for block ciphers with a block length of 128 bits. Refer to SP 800-38D for more details

Author

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

Version

2.4.4

Definition in file ccm.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 40 of file ccm.c.

Function Documentation

ccmDecrypt()

__weak_func error_t ccmDecrypt	(	const CipherAlgo *	cipher,
		void *	context,
		const uint8_t *	n,
		size_t	nLen,
		const uint8_t *	a,
		size_t	aLen,
		const uint8_t *	c,
		uint8_t *	p,
		size_t	length,
		const uint8_t *	t,
		size_t	tLen
	)

Authenticated decryption using CCM.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	n	Nonce
[in]	nLen	Length of the nonce
[in]	a	Additional authenticated data
[in]	aLen	Length of the additional data
[in]	c	Ciphertext to be decrypted
[out]	p	Plaintext resulting from the decryption
[in]	length	Total number of data bytes to be decrypted
[in]	t	MAC to be verified
[in]	tLen	Length of the MAC

Returns

Error code

Definition at line 208 of file ccm.c.

ccmEncrypt()

__weak_func error_t ccmEncrypt	(	const CipherAlgo *	cipher,
		void *	context,
		const uint8_t *	n,
		size_t	nLen,
		const uint8_t *	a,
		size_t	aLen,
		const uint8_t *	p,
		uint8_t *	c,
		size_t	length,
		uint8_t *	t,
		size_t	tLen
	)

Authenticated encryption using CCM.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	n	Nonce
[in]	nLen	Length of the nonce
[in]	a	Additional authenticated data
[in]	aLen	Length of the additional data
[in]	p	Plaintext to be encrypted
[out]	c	Ciphertext resulting from the encryption
[in]	length	Total number of data bytes to be encrypted
[out]	t	MAC resulting from the encryption process
[in]	tLen	Length of the MAC

Returns

Error code

Definition at line 67 of file ccm.c.

ccmFormatBlock0()

error_t ccmFormatBlock0	(	size_t	q,
		const uint8_t *	n,
		size_t	nLen,
		size_t	aLen,
		size_t	tLen,
		uint8_t *	b
	)

Format first block B(0)

Parameters

[in]	q	Bit string representation of the octet length of P
[in]	n	Nonce
[in]	nLen	Length of the nonce
[in]	aLen	Length of the additional data
[in]	tLen	Length of the MAC
[out]	b	Pointer to the buffer where to format B(0)

Returns

Error code

Definition at line 353 of file ccm.c.

ccmFormatCounter0()

void ccmFormatCounter0	(	const uint8_t *	n,
		size_t	nLen,
		uint8_t *	ctr
	)

Format initial counter value CTR(0)

Parameters

[in]	n	Nonce
[in]	nLen	Length of the nonce
[out]	ctr	Pointer to the buffer where to format CTR(0)

Definition at line 418 of file ccm.c.

ccmIncCounter()

void ccmIncCounter	(	uint8_t *	ctr,
		size_t	n
	)

Increment counter block.

Parameters

[in,out]	ctr	Pointer to the counter block
[in]	n	Size in bytes of the specific part of the block to be incremented

Definition at line 440 of file ccm.c.

ccmXorBlock()

void ccmXorBlock	(	uint8_t *	x,
		const uint8_t *	a,
		const uint8_t *	b,
		size_t	n
	)

XOR operation.

Parameters

[out]	x	Block resulting from the XOR operation
[in]	a	First block
[in]	b	Second block
[in]	n	Size of the block

Definition at line 399 of file ccm.c.