Sergey Pastor / 1

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Nucleo

Embed: (wiki syntax)

« Back to documentation index

cipher_mode_gcm.c File Reference
Functions

cipher_mode_gcm.c File Reference

Galois/Counter Mode (GCM) More...

Go to the source code of this file.

Functions

error_t gcmInit (GcmContext *context, const CipherAlgo *cipherAlgo, void *cipherContext)
 Initialize GCM context.
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.
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.
void gcmMul (GcmContext *context, uint8_t *x)
 Multiplication operation.
void gcmXorBlock (uint8_t *x, const uint8_t *a, const uint8_t *b, size_t n)
 XOR operation.
void gcmIncCounter (uint8_t *x)
 Increment counter block.

Detailed Description

Galois/Counter Mode (GCM)

License

Copyright (C) 2010-2017 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:
1.7.6

Definition in file cipher_mode_gcm.c.

Function Documentation

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]contextPointer to the GCM context
[in]ivInitialization vector
[in]ivLenLength of the initialization vector
[in]aAdditional authenticated data
[in]aLenLength of the additional data
[in]cCiphertext to be decrypted
[out]pPlaintext resulting from the decryption
[in]lengthTotal number of data bytes to be decrypted
[in]tAuthentication tag
[in]tLenLength of the authentication tag
Returns:
Error code

Make sure the GCM context is valid

Definition at line 333 of file cipher_mode_gcm.c.

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]contextPointer to the GCM context
[in]ivInitialization vector
[in]ivLenLength of the initialization vector
[in]aAdditional authenticated data
[in]aLenLength of the additional data
[in]pPlaintext to be encrypted
[out]cCiphertext resulting from the encryption
[in]lengthTotal number of data bytes to be encrypted
[out]tAuthentication tag
[in]tLenLength of the authentication tag
Returns:
Error code

Definition at line 189 of file cipher_mode_gcm.c.

void gcmIncCounter ( uint8_t *  x )

Increment counter block.

Parameters:
[in,out]xPointer to the counter block

Definition at line 554 of file cipher_mode_gcm.c.

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

Initialize GCM context.

Parameters:
[in]contextPointer to the GCM context
[in]cipherAlgoCipher algorithm
[in]cipherContextPointer to the cipher algorithm context
Returns:
Error code

Definition at line 77 of file cipher_mode_gcm.c.

void gcmMul ( GcmContext *  context,
uint8_t *  x 
)

Multiplication operation.

Parameters:
[in]contextPointer to the GCM context
[in,out]x16-byte block to be multiplied by H

Definition at line 474 of file cipher_mode_gcm.c.

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

XOR operation.

Parameters:
[out]xBlock resulting from the XOR operation
[in]aFirst block
[in]bSecond block
[in]nSize of the block

Definition at line 539 of file cipher_mode_gcm.c.

Generated on Tue Jul 12 2022 17:10:19 by  doxygen 1.7.2