Skip to content

Latest commit

 

History

History
32 lines (21 loc) · 1.36 KB

README.md

File metadata and controls

32 lines (21 loc) · 1.36 KB
Raw

eme2 - a Linux kernel module implementing the EME2 block cipher mode

This project aims to implement the EME2 mode as specified in IEEE Std 1619.2-2010 as a crypto module for the Linux kernel, mainly to allow Cryptsetup to work with it.

Building

To build the EME2 module, you need to have the header files for the Linux kernel installed (sudo apt-get install linux-headers-generic on Ubuntu). Then, just run make.

Installing

WARNING: This module is still in development and may crash or break your machine! It is highly recommended that you only use it inside a virtual machine.

To install the module, run:

sudo insmod eme2_module.ko

To reinstall, run:

sudo rmmod eme2_module && sudo insmod eme2_module.ko

To install the module that checks the test vectors, run:

sudo insmod eme2_test.ko

To see if the tests passed, run dmesg | less +G.

Using with Cryptsetup

Just install the module and use <cipher>-eme2 as the cipher spec. Note that like XTS, EME2 only works with ciphers that have block size of 16 bytes (such as AES). Also note that EME2 only supports key sizes of 32 bytes + whatever the underlying block cipher supports (e. g. for AES it is 48/56/64 bytes or 384/448/512 bits).