cmac.c File Reference

CMAC (Cipher-based Message Authentication Code) More...

#include "core/crypto.h"
#include "mac/cmac.h"

Go to the source code of this file.

Macros

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL
 

Functions

error_t cmacCompute (const CipherAlgo *cipher, const void *key, size_t keyLen, const void *data, size_t dataLen, uint8_t *mac, size_t macLen)
 Compute CMAC using the specified cipher algorithm. More...
 
error_t cmacInit (CmacContext *context, const CipherAlgo *cipher, const void *key, size_t keyLen)
 Initialize CMAC calculation. More...
 
void cmacReset (CmacContext *context)
 Reset CMAC context. More...
 
void cmacUpdate (CmacContext *context, const void *data, size_t dataLen)
 Update the CMAC context with a portion of the message being hashed. More...
 
error_t cmacFinal (CmacContext *context, uint8_t *mac, size_t macLen)
 Finish the CMAC calculation. More...
 
void cmacDeinit (CmacContext *context)
 Release CMAC context. More...
 
void cmacMul (uint8_t *x, const uint8_t *a, size_t n, uint8_t rb)
 Multiplication by x in GF(2^128) More...
 
void cmacXorBlock (uint8_t *x, const uint8_t *a, const uint8_t *b, size_t n)
 XOR operation. More...
 

Detailed Description

CMAC (Cipher-based Message Authentication Code)

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

CMAC is a block cipher-based MAC algorithm specified in NIST SP 800-38B

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

Definition in file cmac.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL   CRYPTO_TRACE_LEVEL

Definition at line 36 of file cmac.c.

Function Documentation

◆ cmacCompute()

error_t cmacCompute ( const CipherAlgo cipher,
const void *  key,
size_t  keyLen,
const void *  data,
size_t  dataLen,
uint8_t *  mac,
size_t  macLen 
)

Compute CMAC using the specified cipher algorithm.

Parameters
[in]cipherCipher algorithm used to compute CMAC
[in]keyPointer to the secret key
[in]keyLenLength of the secret key
[in]dataPointer to the input message
[in]dataLenLength of the input data
[out]macCalculated MAC value
[in]macLenExpected length of the MAC
Returns
Error code

Definition at line 58 of file cmac.c.

◆ cmacDeinit()

void cmacDeinit ( CmacContext context)

Release CMAC context.

Parameters
[in]contextPointer to the CMAC context

Definition at line 296 of file cmac.c.

◆ cmacFinal()

error_t cmacFinal ( CmacContext context,
uint8_t *  mac,
size_t  macLen 
)

Finish the CMAC calculation.

Parameters
[in]contextPointer to the CMAC context
[out]macCalculated MAC value (optional parameter)
[in]macLenExpected length of the MAC
Returns
Error code

Definition at line 237 of file cmac.c.

◆ cmacInit()

error_t cmacInit ( CmacContext context,
const CipherAlgo cipher,
const void *  key,
size_t  keyLen 
)

Initialize CMAC calculation.

Parameters
[in]contextPointer to the CMAC context to initialize
[in]cipherCipher algorithm used to compute CMAC
[in]keyPointer to the secret key
[in]keyLenLength of the secret key
Returns
Error code

Definition at line 107 of file cmac.c.

◆ cmacMul()

void cmacMul ( uint8_t *  x,
const uint8_t *  a,
size_t  n,
uint8_t  rb 
)

Multiplication by x in GF(2^128)

Parameters
[out]xPointer to the output block
[out]aPointer to the input block
[in]nSize of the block, in bytes
[in]rbRepresentation of the irreducible binary polynomial

Definition at line 318 of file cmac.c.

◆ cmacReset()

void cmacReset ( CmacContext context)

Reset CMAC context.

Parameters
[in]contextPointer to the CMAC context

Definition at line 172 of file cmac.c.

◆ cmacUpdate()

void cmacUpdate ( CmacContext context,
const void *  data,
size_t  dataLen 
)

Update the CMAC context with a portion of the message being hashed.

Parameters
[in]contextPointer to the CMAC context
[in]dataPointer to the input data
[in]dataLenLength of the buffer

Definition at line 191 of file cmac.c.

◆ cmacXorBlock()

void cmacXorBlock ( 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 input block
[in]bSecond input block
[in]nSize of the block, in bytes

Definition at line 349 of file cmac.c.