gcm.c File Reference

Galois/Counter Mode (GCM) More...

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

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Functions
__weak_func error_t	gcmInit (GcmContext *context, const CipherAlgo *cipherAlgo, void *cipherContext)
	Initialize GCM context. More...
__weak_func error_t	gcmEncrypt (GcmContext *context, const uint8_t *iv, size_t ivLen, 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 GCM. More...
__weak_func error_t	gcmDecrypt (GcmContext *context, const uint8_t *iv, size_t ivLen, 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 GCM. More...
__weak_func void	gcmMul (GcmContext *context, uint8_t *x)
	Multiplication operation in GF(2^128) More...
void	gcmXorBlock (uint8_t *x, const uint8_t *a, const uint8_t *b, size_t n)
	XOR operation. More...
void	gcmIncCounter (uint8_t *ctr)
	Increment counter block. More...

Detailed Description

Galois/Counter Mode (GCM)

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 Galois/Counter Mode (GCM) is an authenticated encryption algorithm designed to provide both data authenticity (integrity) and confidentiality. Refer to SP 800-38D for more details

Author

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

Version

2.4.4

Definition in file gcm.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 38 of file gcm.c.

Function Documentation

gcmDecrypt()

__weak_func error_t gcmDecrypt	(	GcmContext *	context,
		const uint8_t *	iv,
		size_t	ivLen,
		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 GCM.

Parameters

[in]	context	Pointer to the GCM context
[in]	iv	Initialization vector
[in]	ivLen	Length of the initialization vector
[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	Authentication tag
[in]	tLen	Length of the authentication tag

Returns

Error code

Definition at line 361 of file gcm.c.

gcmEncrypt()

__weak_func error_t gcmEncrypt	(	GcmContext *	context,
		const uint8_t *	iv,
		size_t	ivLen,
		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 GCM.

Parameters

[in]	context	Pointer to the GCM context
[in]	iv	Initialization vector
[in]	ivLen	Length of the initialization vector
[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	Authentication tag
[in]	tLen	Length of the authentication tag

Returns

Error code

Definition at line 214 of file gcm.c.

gcmIncCounter()

void gcmIncCounter

(

uint8_t *

ctr

)

Increment counter block.

Parameters

[in,out]

ctr

Pointer to the counter block

Definition at line 614 of file gcm.c.

gcmInit()

__weak_func error_t gcmInit	(	GcmContext *	context,
		const CipherAlgo *	cipherAlgo,
		void *	cipherContext
	)

Initialize GCM context.

Parameters

[in]	context	Pointer to the GCM context
[in]	cipherAlgo	Cipher algorithm
[in]	cipherContext	Pointer to the cipher algorithm context

Returns

Error code

Definition at line 99 of file gcm.c.

gcmMul()

__weak_func void gcmMul	(	GcmContext *	context,
		uint8_t *	x
	)

Multiplication operation in GF(2^128)

Parameters

[in]	context	Pointer to the GCM context
[in,out]	x	16-byte block to be multiplied by H

Definition at line 508 of file gcm.c.

gcmXorBlock()

void gcmXorBlock	(	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 597 of file gcm.c.