August 2017
« Nov    

Recent Posts

DiceLockXTSIndexedFullBasedCheck, C++ program for Windows to verify DiceLock encryption cipher architecture with DiceLockXTSIndexed class encrypting full file at once

DiceLockXTSIndexedFullBasedCheck is a C++ program to verify that DiceLockXTSIndexed class implementing one of DiceLock different architectures is working as expected.

DiceLockXTSIndexed class is the cryptographic architecture aimed to storage devices based on XTS operation mode (XEX-based tweaked-codebook mode with ciphertext stealing encryption algorithm) and providing same intrinsic characteristics of DiceLock cipher architecture.

DiceLockXTSIndexed class is the class that implements DiceLock architecture with the following characteristics:
– base encryption cipher/decipher is a block cipher working with symmetric key,
ciphered index pointing symmetric key modification plus ciphertext is checked for random number test properties,
– any function that is able to change original symmetric key with new values generating index pointing out such modification,
bit random number tests that can verify that encrypted ciphertext is at random.

Current algorithm classes that can be used with DiceLockXTSIndexed architecture are:

– as base encryption cipher/decipher:

  • any of following block ciphers:
      AES (Advanced Encryption Standard) with 128, 192 or 256 key bits,
      Camellia with 128, 192 or 256 key bits,
      Serpent with 128, 192 or 256 key bits,
      Twofish with 128, 192 or 256 key bits, or
  • – symmetric key changers: IncreaseBase0IndexModifier_6_0_0_1 and DecreaseBase0IndexModifier_6_0_0_1,
    – random number tests: Frequency, Block Frequency, Cumulative Sum Forward, Cumulative Sum Reverse, Runs, Longest Run Of Ones, Rank, Universal, Approximate Entropy, Serial, Discrete Fourier Transform tests and random number test Suite with any or all previous enumerated random number tests.

    Because DiceLockXTSIndexed class can work on full length plaintext length or sector based length, there are different alternatives for encryption/decryption, we have split DiceLockXTSIndexed class tests in two main C++ program tests:
    DiceLockXTSIndexedSectorBasedCheck C++ Source Code program applying DiceLockXTSIndexed encryption/decryption on sector base,, and
    DiceLockXTSIndexedFullBasedCheck C++ Source Code program applying DiceLockXTSIndexed encryption/decryption on full plaintext length basis,.

    In this test we verify DiceLockXTSIndexedFullBasedCheck C++ Source Code program encryption/decryption on full plaintext length basis with the configuration shown below.

    While performing internal software quality assurance we have verified that DiceLockXTSIndexedFullBasedCheck in debug mode does not generate any memory leaks with any executed option.
    Debug mode was run with the corresponding debugger and the C Run-Time Libraries (CRT) debug heap functions as well as with dump memory leak information function that can be obtained executing “_CrtDumpMemoryLeaks” statement before program ends execution.

    In order to verify that DiceLockXTSIndexed class is performing the following program has been used. Execution call must be:
    DiceLockXTSIndexedFullBasedCheck [block cipher][key modifier][stream type] log_output_file, where the different values can be easily infered from source code.

    Test program in C++ language:

    // DiceLockXTSIndexedFullBasedCheck.cpp : Defines the entry point for the console application.
    #include "stdafx.h"
    #include "DiceLockCipher.h"
    using namespace DiceLockSecurity::Cipher::SymmetricCipher::DiceLock;
    using namespace DiceLockSecurity::Cipher::SymmetricCipher::BlockCipher;
    #define MIN_LENGTH_TESTS	8
    #define MAX_LENGTH_TESTS	500000
    #define RANDOM_ALPHA		0.001
    #define FILE_NAME_LENGTH	300
    BlockCiphers SetBlockCipherType(unsigned char cipher) {
    	switch (cipher) {
    		case '0' :	return AES_128;
    		case '1' :	return AES_192;
    		case '2' :	return AES_256;
    		case '3' :	return Camellia_128;
    		case '4' :	return Camellia_192;
    		case '5' :	return Camellia_256;
    		case '6' :	return Serpent_128;
    		case '7' :	return Serpent_192;
    		case '8' :	return Serpent_256;
    		case '9' :	return Twofish_128;
    		case 'A' :	return Twofish_192;
    		case 'B' :	return Twofish_256;
    	return DiceLockSecurity::Cipher::SymmetricCipher::BlockCipher::NotDefined;
    BaseIndexModifier* SetIndexModifier(unsigned long int indexer, unsigned long int indexLength) {
    	BaseIndexModifier* modifier;
    	if ( indexer == '0' ) {
    		modifier = new IncreaseBase0IndexModifier_6_0_0_1();
    	if ( indexer == '1' ) {
    		modifier = new DecreaseBase0IndexModifier_6_0_0_1();
    	return modifier;
    void RemoveIndexModifier(BaseIndexModifier* modifier, unsigned long int indexer) {
    	if ( indexer == '0' ) {
    		delete (IncreaseBase0IndexModifier_6_0_0_1*)modifier;
    	if ( indexer == '1' ) {
    		delete (DecreaseBase0IndexModifier_6_0_0_1*)modifier;
    BaseCryptoRandomStream*	SetStreamType(unsigned char stream, unsigned long int bitLength) {
    	BaseCryptoRandomStream* streamObject;
    	switch (stream) {
    		case '0' :	streamObject = new DefaultCryptoRandomStream(bitLength);
    		case '1' :	streamObject = new PhysicalCryptoRandomStream(bitLength);
    	return streamObject;
    void RemoveStreamType(BaseCryptoRandomStream* streamObject, unsigned char stream) {
    	switch (stream) {
    		case '0' :	delete (DefaultCryptoRandomStream*)streamObject;
    		case '1' :	delete (PhysicalCryptoRandomStream*)streamObject;
    void SetRandomTestsAndAlpha(RandomTestSuite* suite) {
    void VerifyDecryption(BaseCryptoRandomStream* plaintext, BaseCryptoRandomStream* decipheredtext, unsigned long int* correctDecipher, unsigned long int* incorrectDecipher) {
    	if ( plaintext->Equals(decipheredtext) ) {
    	else {
    int main(int argc, char* argv[])
    	unsigned long int performedTests;
    	unsigned long int length;
    	unsigned __int64  dataUnit;
    	unsigned long int startBlock;
    	unsigned long int reciphers;
    	unsigned long int maxReciphers;
    	unsigned long int correctDecipher;
    	unsigned long int incorrectDecipher;
    	unsigned char cipher;
    	unsigned char keyModifier;
    	unsigned char dataStream;
    	char reciphersFile[FILE_NAME_LENGTH];
    	FILE* fp;
    	FILE* fr;
    	DiceLockXTSIndexed*		diceLock;
    	XTS_Mode*				xtsMode;
    	RandomTestSuite*		randomSuite;
    	BaseIndexModifier*		modifier;
    	BaseCryptoRandomStream* key;
    	BaseCryptoRandomStream* plaintext;
    	BaseCryptoRandomStream* ciphertext;
    	BaseCryptoRandomStream* decipheredtext;
    	// Gets execution parameters from command line
    	cipher = argv[1][0];
    	keyModifier = argv[1][1];
    	dataStream = argv[1][2];
    	// Pseudo-random generation, fixed intitialitation seed allows 
    	// re-run same test with identical data
    	performedTests = 0;
    	reciphers = 0;
    	maxReciphers = 0;
    	memset(reciphersFile, 0, FILE_NAME_LENGTH);
    	strcat_s(reciphersFile, argv[2]);
    	strcat_s(reciphersFile, ".reciphered");
    	if ( fopen_s(&fr, reciphersFile, "w+") != 0 ) {
    		printf(" ERROR OPENING FILE\n");
    		return 1;
    	fprintf(fr, "keyUC,plainUC,length,dataUnit,startBlock,reciphers\n");
    	correctDecipher = 0;
    	incorrectDecipher = 0;
    	for ( length = MIN_LENGTH_TESTS; length <= MAX_LENGTH_TESTS; length = length + 8 ) {
    		printf("length: %d\n", length);
    		// Specific XTS mode operation mode parameters
    		dataUnit = (unsigned __int64)(rand());
    		startBlock = (unsigned long int)(rand() & 0x000000FF);
    		// Encryption
    		diceLock =  new DiceLockXTSIndexed();
    		xtsMode = new XTS_Mode();
    		randomSuite = new RandomTestSuite();
    		modifier = SetIndexModifier(keyModifier, xtsMode->GetBitBaseBlockLength());
    		key = SetStreamType(dataStream, diceLock->GetBitKeyLength());
    		plaintext = SetStreamType(dataStream, length);
    		ciphertext = SetStreamType(dataStream, diceLock->GetBitCiphertextLength(plaintext->GetBitLength()));
    		key->FillUC((unsigned char)(rand() & 0x000000FF));
    		plaintext->FillUC((unsigned char)(rand() & 0x000000FF));
    		diceLock->Cipher(plaintext, ciphertext, dataUnit, startBlock);
    		if ( diceLock->GetReciphers() > 0 ) {
    			if ( maxReciphers < diceLock->GetReciphers() ) {
    				maxReciphers = diceLock->GetReciphers();
    			fprintf(fr, "%02x,%02x,%d,%lli,%d,%d\n", key->GetUCPosition(0), plaintext->GetUCPosition(0), length, dataUnit, startBlock, diceLock->GetReciphers());
    		RemoveIndexModifier(modifier, keyModifier);
    		delete randomSuite;
    		delete xtsMode;
    		delete diceLock;
    		// Decryption
    		diceLock =  new DiceLockXTSIndexed();
    		xtsMode = new XTS_Mode();
    		modifier = SetIndexModifier(keyModifier, xtsMode->GetBitBaseBlockLength());
    		decipheredtext = SetStreamType(dataStream, diceLock->GetBitDecipheredtextLength(ciphertext->GetBitLength()));
    		diceLock->Decipher(ciphertext, decipheredtext, dataUnit, startBlock);
    		RemoveIndexModifier(modifier, keyModifier);
    		delete xtsMode;
    		delete diceLock;
    		// Verifying plaintext and decipheredtext
    		VerifyDecryption(plaintext, decipheredtext, &correctDecipher, &incorrectDecipher);
    		RemoveStreamType(key, dataStream);
    		RemoveStreamType(plaintext, dataStream);
    		RemoveStreamType(ciphertext, dataStream);
    		RemoveStreamType(decipheredtext, dataStream);
    	// Total Output 
    	if (fopen_s(&fp, argv[2], "w+") != 0) {
    		printf(" ERROR OPENING FILE\n");
    		return 1;
    	fprintf(fp, "Verified:\n");
    	fprintf(fp, "---------\n");
    	fprintf(fp, "%s\n", argv[2]);
    	fprintf(fp, "\n");
    	fprintf(fp, "Number of streams tested: %d\n", performedTests);
    	fprintf(fp, "\n");
    	fprintf(fp, "From length of shorter stream tested in bits: %d\n", MIN_LENGTH_TESTS);
    	fprintf(fp, "Up to length of larger stream tested in bits: %d\n", MAX_LENGTH_TESTS);
    	fprintf(fp, "\n");
    	fprintf(fp, "\n");
    	fprintf(fp, "Number of correct streams deciphered: %d\n", correctDecipher);
    	fprintf(fp, "Number of incorrect streams deciphered: %d\n", incorrectDecipher);
    	if ( incorrectDecipher == 0 ) {
    		fprintf(fp, "Incorrect deciphered streams = %d ==> ---OK---\n", incorrectDecipher);
    	else {
    		fprintf(fp, "Incorrect deciphered streams = %d ==> ---ERROR---\n", incorrectDecipher);
    	fprintf(fp, "\n");
    	fprintf(fp, "Total encrypted streams reciphered at least once: %d\n", reciphers);
    	fprintf(fp, "Maximum number of reciphers performed over one stream being reciphered: %d\n", maxReciphers);
    	fprintf(fp, "\n");
    	fprintf(fp, "File with reciphered stream data:\n");
    	fprintf(fp, "%s\n", reciphersFile);
    	fprintf(fp, "\n");
    	return 0;

    All different tests are performed over 62.500 streams and we will post each one result promptly.

    Leave a Reply