ecb.h File Reference

Electronic codebook (ECB). More...

#include <ipxe/crypto.h>

Go to the source code of this file.

Macros
#define	ECB_CIPHER(_ecb_name, _ecb_cipher, _raw_cipher, _raw_context, _blocksize)
	Create an electronic codebook mode of behaviour of an existing cipher.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
int	ecb_setkey (struct cipher_algorithm *cipher, void *ctx, const void *key, size_t keylen)
	Set key.
void	ecb_encrypt (struct cipher_algorithm *cipher, void *ctx, const void *src, void *dst, size_t len)
	Encrypt data.
void	ecb_decrypt (struct cipher_algorithm *cipher, void *ctx, const void *src, void *dst, size_t len)
	Decrypt data.

Detailed Description

Electronic codebook (ECB).

Definition in file ecb.h.

Macro Definition Documentation

ECB_CIPHER

#define ECB_CIPHER	(		_ecb_name,
			_ecb_cipher,
			_raw_cipher,
			_raw_context,
			_blocksize )

Value:

struct cipher_algorithm _ecb_cipher = {                                 \
        .name           = #_ecb_name,                                   \
        .ctxsize        = sizeof ( _raw_context ),                      \
        .blocksize      = _blocksize,                                   \
        .alignsize      = _blocksize,                                   \
        .authsize       = 0,                                            \
        .confidential   = 1,                                            \
        .setkey         = ecb_setkey,                                   \
        .setiv          = cipher_null_setiv,                            \
        .encrypt        = ecb_encrypt,                                  \
        .decrypt        = ecb_decrypt,                                  \
        .auth           = cipher_null_auth,                             \
        .priv           = &_raw_cipher,                                 \
};

Create an electronic codebook mode of behaviour of an existing cipher.

Parameters

_ecb_name	Name for the new ECB cipher
_ecb_cipher	New cipher algorithm
_raw_cipher	Underlying cipher algorithm
_raw_context	Context structure for the underlying cipher
_blocksize	Cipher block size

Definition at line 31 of file ecb.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

References ctx, key, len, and src.

ecb_setkey()

int ecb_setkey ( struct cipher_algorithm * cipher, void * ctx, const void * key, size_t keylen )

extern

Set key.

Parameters

cipher	Cipher algorithm
ctx	Context
key	Key
keylen	Key length

Return values

rc	Return status code

Definition at line 46 of file ecb.c.

                                                  {
        struct cipher_algorithm *raw_cipher = cipher->priv;
 
        return cipher_setkey ( raw_cipher, ctx, key, keylen );
}

References cipher_setkey(), ctx, key, and cipher_algorithm::priv.

ecb_encrypt()

void ecb_encrypt ( struct cipher_algorithm * cipher, void * ctx, const void * src, void * dst, size_t len )

extern

Encrypt data.

Parameters

cipher	Cipher algorithm
ctx	Context
src	Data to encrypt
dst	Buffer for encrypted data
len	Length of data

Definition at line 62 of file ecb.c.

                                                            {
        struct cipher_algorithm *raw_cipher = cipher->priv;
        size_t blocksize = raw_cipher->blocksize;
 
        assert ( ( len % blocksize ) == 0 );
 
        while ( len ) {
                cipher_encrypt ( raw_cipher, ctx, src, dst, blocksize );
                dst += blocksize;
                src += blocksize;
                len -= blocksize;
        }
}

References assert, cipher_algorithm::blocksize, cipher_encrypt, ctx, len, cipher_algorithm::priv, and src.

ecb_decrypt()

void ecb_decrypt ( struct cipher_algorithm * cipher, void * ctx, const void * src, void * dst, size_t len )

extern

Decrypt data.

Parameters

cipher	Cipher algorithm
ctx	Context
src	Data to decrypt
dst	Buffer for decrypted data
len	Length of data

Definition at line 86 of file ecb.c.

                                                            {
        struct cipher_algorithm *raw_cipher = cipher->priv;
        size_t blocksize = raw_cipher->blocksize;
 
        assert ( ( len % blocksize ) == 0 );
 
        while ( len ) {
                cipher_decrypt ( raw_cipher, ctx, src, dst, blocksize );
                dst += blocksize;
                src += blocksize;
                len -= blocksize;
        }
}

References assert, cipher_algorithm::blocksize, cipher_decrypt, ctx, len, cipher_algorithm::priv, and src.