ccm.h File Reference

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

#include "core/crypto.h"

Go to the source code of this file.

Functions

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...
 
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.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
2.4.0

Definition in file ccm.h.

Function Documentation

◆ ccmDecrypt()

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]cipherCipher algorithm
[in]contextCipher algorithm context
[in]nNonce
[in]nLenLength of the nonce
[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]tMAC to be verified
[in]tLenLength of the MAC
Returns
Error code

Definition at line 208 of file ccm.c.

◆ ccmEncrypt()

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]cipherCipher algorithm
[in]contextCipher algorithm context
[in]nNonce
[in]nLenLength of the nonce
[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]tMAC resulting from the encryption process
[in]tLenLength 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]qBit string representation of the octet length of P
[in]nNonce
[in]nLenLength of the nonce
[in]aLenLength of the additional data
[in]tLenLength of the MAC
[out]bPointer 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]nNonce
[in]nLenLength of the nonce
[out]ctrPointer 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]ctrPointer to the counter block
[in]nSize 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]xBlock resulting from the XOR operation
[in]aFirst block
[in]bSecond block
[in]nSize of the block

Definition at line 399 of file ccm.c.