ctr.c File Reference

Counter(CTR) mode. More...

#include "core/crypto.h"
#include "cipher_modes/ctr.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
__weak_func error_t	ctrEncrypt (const CipherAlgo *cipher, void *context, uint_t m, uint8_t *t, const uint8_t *p, uint8_t *c, size_t length)
	CTR encryption. More...
error_t	ctrDecrypt (const CipherAlgo *cipher, void *context, uint_t m, uint8_t *t, const uint8_t *c, uint8_t *p, size_t length)
	CTR decryption. More...
void	ctrIncBlock (uint8_t *ctr, uint32_t inc, size_t blockSize, size_t m)
	Increment counter block. More...

Detailed Description

Counter(CTR) mode.

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

The Counter (CTR) mode is a confidentiality mode that features the application of the forward cipher to a set of input blocks, called counters, to produce a sequence of output blocks that are exclusive-ORed with the plaintext to produce the ciphertext, and vice versa. Refer to SP 800-38A for more details

Author

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

Version

2.4.4

Definition in file ctr.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 39 of file ctr.c.

Function Documentation

ctrDecrypt()

error_t ctrDecrypt	(	const CipherAlgo *	cipher,
		void *	context,
		uint_t	m,
		uint8_t *	t,
		const uint8_t *	c,
		uint8_t *	p,
		size_t	length
	)

CTR decryption.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	m	Size in bits of the specific part of the block to be incremented
[in,out]	t	Initial counter block
[in]	c	Ciphertext to be decrypted
[out]	p	Plaintext resulting from the decryption
[in]	length	Total number of data bytes to be decrypted

Returns

Error code

Definition at line 122 of file ctr.c.

ctrEncrypt()

__weak_func error_t ctrEncrypt	(	const CipherAlgo *	cipher,
		void *	context,
		uint_t	m,
		uint8_t *	t,
		const uint8_t *	p,
		uint8_t *	c,
		size_t	length
	)

CTR encryption.

Parameters

[in]	cipher	Cipher algorithm
[in]	context	Cipher algorithm context
[in]	m	Size in bits of the specific part of the block to be incremented
[in,out]	t	Initial counter block
[in]	p	Plaintext to be encrypted
[out]	c	Ciphertext resulting from the encryption
[in]	length	Total number of data bytes to be encrypted

Returns

Error code

Definition at line 62 of file ctr.c.

ctrIncBlock()

void ctrIncBlock	(	uint8_t *	ctr,
		uint32_t	inc,
		size_t	blockSize,
		size_t	m
	)

Increment counter block.

Parameters

[in,out]	ctr	Pointer to the counter block
[in]	inc	Value of the increment
[in]	blockSize	Size of the block, in bytes
[in]	m	Size of the specific part of the block to be incremented

Definition at line 138 of file ctr.c.