Thursday, 14 December 2017

DiceLockSecurity Knowledge

DicelockSecurity (version 9.X)

Apple Mac OS X

XDiceLock 8.0.0.1
Previous Versions
arrow XDiceLock 8.0.0.1 arrow rankTest.h
rankTest.h (Rank random number test C++ header source code file) Print E-mail
Get C++ DiceLock cipher architecture source code packages of DiceLock for Microsoft Visual Studio 2013 and DiceLock-x for Linux with Test Driver Programs and Response Test Vector files to verify that both them work as expected.
DiceLock for Windows and Linux
DiceLock Security governing software licenses are Free/Libre Source Code License and Educational and Research License

DiceLock is protected by US patent 7508945 and European Patent 1182777 where applicable.

DiceLock and DiceLock logo are trademarks or registered trademarks in the EC, USA and others.

License information can be obtained at our corporate web site




1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
 
//
//  rankTest.h
//  XDiceLock
//
//  Created by DiceLock on 1/1/12.
//  Copyright (c) 2008-2012 DiceLock Security, LLC. All rights reserved.
//
 
//
// Creator:    http://www.dicelocksecurity.com
// Version:    vers.8.0.0.1
//
// Copyright (c) 2008-2012 DiceLock Security, LLC. All rights reserved.
//
//                               DISCLAIMER
//
// THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,
// INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
// REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
// 
// DICELOCK IS A REGISTERED TRADEMARK OR TRADEMARK OF THE OWNERS.
// 
 
#ifndef XDiceLock_rankTest_h
#define XDiceLock_rankTest_h
 
#include "baseRandomTest.h"
#include "mathematicalFunctions.h"
 
 
namespace DiceLockSecurity {
    
    namespace RandomTest {
        
        class RankTest : public BaseRandomTest {
            
    protected:
            
      // Random Test Class enumerator name
      static const RandomTests  test;
      // Random Test Class minimum stream length
      static const unsigned int  minimumLength;
            
      double  chiSquared;
      unsigned int matrixNumber;
      unsigned int bitsDiscarded;
      double  p30, p31, p32;       // Probabilities
      double  f30, f31, f32;      // Frequencies
            
      // Create Matrix 
      unsigned char**  CreateMatrix(unsigned int, unsigned int);
            
      // Define Matrix 
      void DefineMatrix(BaseCryptoRandomStream*, signed int, signed int, unsigned char**, signed int);
            
      // Deletes matrix 
      void DeleteMatrix(signed int, unsigned char**);
            
      // Computes rank 
      signed int ComputeRank(signed int, signed int, unsigned char**);
            
      // Perform Elementary Row Operations
      void PerformElementaryRowOperations(signed int, signed int, signed int, signed int, unsigned char**);
            
      // Find Unit Element And Swap
      signed int FindUnitElementAndSwap(signed int, signed int, signed int, signed int, unsigned char**);
            
      // Swap Rows 
      signed int SwapRows(signed int, signed int, signed int, unsigned char**);
            
      // Determine Rank 
      signed int DetermineRank(signed int, signed int, signed int, unsigned char**);
            
    public:
            
      // Constructor, default 
      RankTest();
            
      // Constructor with a MathematicalFunctions object instantiated 
      RankTest(MathematicalFunctions*);
            
      // Destructor
      ~RankTest();
            
      // Gets the BaseRandomTest random state of the last executed BaseCryptoRandomStream
      bool IsRandom(void);
            
      // Tests randomness of the BaseCryptoRandomStream and returns the random value
      bool IsRandom(BaseCryptoRandomStream*);
            
      // Initializes the object
      void Initialize(void);
            
      // Gets the type of the object
      RandomTests GetType(void);
            
      // Gets the minimum random stream length
      unsigned int GetMinimumLength(void);
            
      // Gets the "chiSquared" result
      double GetChiSquared(void);
            
      // Gets the "matrixNumber" result
      unsigned int GetMatrixNumber(void);
            
      // Gets the "bitsDiscarded" result
      unsigned int GetBitsDiscarded(void);
            
      // Gets the "p30" result
      double GetP30(void);
            
      // Gets the "p31" result
      double GetP31(void);
            
      // Gets the "p32" result
      double GetP32(void);
            
      // Gets the "f30" result
      double GetF30(void);
            
      // Gets the "f31" result
      double GetF31(void);
            
      // Gets the "f32" result
      double GetF32(void);
            
        };
    }
}
 
#endif