1
0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
RIOT/sys/include/crypto/modes/ecb.h
Marian Buschsieweke edc43201db
tree-wide: fix typos in doc and comments
This should not change any generated binary
2023-10-16 12:17:48 +02:00

70 lines
2.0 KiB
C

/*
* Copyright (C) 2015 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup sys_crypto
* @{
*
* @file ecb.h
* @brief Electronic code book mode of operation for block ciphers
*
* @author Freie Universitaet Berlin, Computer Systems & Telematics
* @author Nico von Geyso <nico.geyso@fu-berlin.de>
*/
#ifndef CRYPTO_MODES_ECB_H
#define CRYPTO_MODES_ECB_H
#include "crypto/ciphers.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Encrypt data of arbitrary length in ecb mode. Caution each identical
* block results in an identical encrypted block. Normally you do not
* want to use ECB.
*
*
* @param cipher Already initialized cipher struct
* @param input pointer to input data to encrypt
* @param length length of the input data
* @param output pointer to allocated memory for encrypted data. It has to
* be of size data_len + BLOCK_SIZE - data_len % BLOCK_SIZE.
*
* @return Length of encrypted data on a successful encryption
* @return A negative error code if something went wrong
*
*/
int cipher_encrypt_ecb(const cipher_t *cipher, const uint8_t *input,
size_t length, uint8_t *output);
/**
* @brief Decrypts data of arbitrary length in ecb mode.
*
*
* @param cipher Already initialized cipher struct
* @param input pointer to input data to decrypt
* @param length length of the input data
* @param output pointer to allocated memory for plaintext data. It has to
* be of size `length`.
*
* @return Length of decrypted data on a successful decryption
* @return A negative error code if something went wrong
*/
int cipher_decrypt_ecb(const cipher_t *cipher, const uint8_t *input,
size_t length, uint8_t *output);
#ifdef __cplusplus
}
#endif
#endif /* CRYPTO_MODES_ECB_H */
/** @} */