Crypto++ 8.2 Free C++ class library of cryptographic schemes

simon.h
Go to the documentation of this file.
1 // simon.h - written and placed in the public domain by Jeffrey Walton
2
3 /// \file simon.h
4 /// \brief Classes for the Simon block cipher
5 /// \details Simon is a block cipher designed by Ray Beaulieu, Douglas Shors, Jason Smith,
6 /// Stefan Treatman-Clark, Bryan Weeks and Louis Wingers.
7 /// \sa <A HREF="http://eprint.iacr.org/2013/404">The SIMON and SPECK Families of
8 /// Lightweight Block Ciphers</A>, <A HREF="http://iadgov.github.io/simon-speck/">
9 /// The Simon and Speck GitHub</A> and <A HREF="https://www.cryptopp.com/wiki/SIMON">
10 /// SIMON</A> on the Crypto++ wiki.
11 /// \since Crypto++ 6.0
12
13 #ifndef CRYPTOPP_SIMON_H
14 #define CRYPTOPP_SIMON_H
15
16 #include "config.h"
17 #include "seckey.h"
18 #include "secblock.h"
19
20 #if CRYPTOPP_BOOL_X64 || CRYPTOPP_BOOL_X32 || CRYPTOPP_BOOL_X86 || \
21 CRYPTOPP_BOOL_ARM32 || CRYPTOPP_BOOL_ARMV8 || \
22 CRYPTOPP_BOOL_PPC32 || CRYPTOPP_BOOL_PPC64
23 # ifndef CRYPTOPP_DISABLE_SIMON_SIMD
24 # define CRYPTOPP_SIMON128_ADVANCED_PROCESS_BLOCKS 1
25 # endif
26 #endif
27
28 // Yet another SunStudio/SunCC workaround. Failed self tests
29 // in SSE code paths on i386 for SunStudio 12.3 and below.
30 #if defined(__SUNPRO_CC) && (__SUNPRO_CC <= 0x5120)
31 # undef CRYPTOPP_SIMON128_ADVANCED_PROCESS_BLOCKS
32 #endif
33
34 NAMESPACE_BEGIN(CryptoPP)
35
36 /// \brief SIMON block cipher information
37 /// \tparam L block size of the cipher, in bytes
38 /// \tparam D default key length, in bytes
39 /// \tparam N minimum key length, in bytes
40 /// \tparam M maximum key length, in bytes
41 /// \since Crypto++ 6.0
42 template <unsigned int L, unsigned int D, unsigned int N, unsigned int M>
43 struct SIMON_Info : public FixedBlockSize<L>, VariableKeyLength<D, N, M>
44 {
45 /// \brief The algorithm name
46 /// \return the algorithm name
47 /// \details StaticAlgorithmName returns the algorithm's name as a static
48 /// member function.
49 static const std::string StaticAlgorithmName()
50 {
51 // Format is Cipher-Blocksize(Keylength)
52 return "SIMON-" + IntToString(L*8);
53 }
54 };
55
56 /// \brief SIMON block cipher base class
57 /// \tparam W the word type
58 /// \details User code should use SIMON64 or SIMON128
59 /// \sa SIMON64, SIMON128, <a href="http://www.cryptopp.com/wiki/SIMON">SIMON</a> on the Crypto++ wiki
60 /// \since Crypto++ 6.0
61 template <class W>
62 struct SIMON_Base
63 {
64 virtual ~SIMON_Base() {}
65 SIMON_Base() : m_kwords(0), m_rounds(0) {}
66
67 typedef SecBlock<W, AllocatorWithCleanup<W, true> > AlignedSecBlock;
68 mutable AlignedSecBlock m_wspace; // workspace
69 AlignedSecBlock m_rkeys; // round keys
70 unsigned int m_kwords; // number of key words
71 unsigned int m_rounds; // number of rounds
72 };
73
74 /// \brief SIMON 64-bit block cipher
75 /// \details Simon is a block cipher designed by Ray Beaulieu, Douglas Shors, Jason Smith,
76 /// Stefan Treatman-Clark, Bryan Weeks and Louis Wingers.
77 /// \details SIMON64 provides 64-bit block size. The valid key sizes are 96-bit and 128-bit.
78 /// \sa SIMON64, SIMON128, <A HREF="http://eprint.iacr.org/2013/404">The SIMON and SIMON
79 /// Families of Lightweight Block Ciphers</A>, <A HREF="http://iadgov.github.io/simon-speck/">
80 /// The Simon and Speck GitHub</A>, <a href="http://www.cryptopp.com/wiki/SIMON">SIMON</a> on the
81 /// Crypto++ wiki
82 /// \since Crypto++ 6.0
83 class CRYPTOPP_NO_VTABLE SIMON64 : public SIMON_Info<8, 12, 12, 16>, public BlockCipherDocumentation
84 {
85 public:
86 /// \brief SIMON64 block cipher base implementation
87 /// \details Provides implementation common to encryption and decryption
88 /// \since Crypto++ 6.0
89 class CRYPTOPP_NO_VTABLE Base : protected SIMON_Base<word32>, public BlockCipherImpl<SIMON_Info<8, 12, 12, 16> >
90 {
91 public:
92 /// \brief The algorithm name
93 /// \return the algorithm name
94 /// \details AlgorithmName returns the algorithm's name as a
95 /// member function.
96 std::string AlgorithmName() const {
97 return StaticAlgorithmName() + (m_kwords == 0 ? "" :
98 "(" + IntToString(m_kwords*sizeof(word32)*8) + ")");
99 }
100
101 std::string AlgorithmProvider() const;
102
103 /// \brief Provides input and output data alignment for optimal performance.
104 /// \return the input data alignment that provides optimal performance
105 /// \sa GetAlignment() and OptimalBlockSize()
106 unsigned int OptimalDataAlignment() const;
107
108 protected:
109 void UncheckedSetKey(const byte *userKey, unsigned int keyLength, const NameValuePairs &params);
110 };
111
112 /// \brief SIMON64 encryption transformation
113 /// \details Enc provides the encryption transformation.
114 /// All key sizes are supported.
115 /// \since Crypto++ 6.0
116 class CRYPTOPP_NO_VTABLE Enc : public Base
117 {
118 public:
119 void ProcessAndXorBlock(const byte *inBlock, const byte *xorBlock, byte *outBlock) const;
120 };
121
122 /// \brief SIMON64 decryption transformation
123 /// \details Dec provides the decryption transformation.
124 /// All key sizes are supported.
125 /// \since Crypto++ 6.0
126 class CRYPTOPP_NO_VTABLE Dec : public Base
127 {
128 public:
129 void ProcessAndXorBlock(const byte *inBlock, const byte *xorBlock, byte *outBlock) const;
130 };
131
132 typedef BlockCipherFinal<ENCRYPTION, Enc> Encryption;
133 typedef BlockCipherFinal<DECRYPTION, Dec> Decryption;
134 };
135
136 /// \brief SIMON 128-bit block cipher
137 /// \details Simon is a block cipher designed by Ray Beaulieu, Douglas Shors, Jason Smith,
138 /// Stefan Treatman-Clark, Bryan Weeks and Louis Wingers.
139 /// \details SIMON128 provides 128-bit block size. The valid key sizes are 128-bit, 192-bit and 256-bit.
140 /// \sa SIMON64, SIMON128, <A HREF="http://eprint.iacr.org/2013/404">The SIMON and SIMON
141 /// Families of Lightweight Block Ciphers</A>, <A HREF="http://iadgov.github.io/simon-speck/">
142 /// The Simon and Speck GitHub</A>, <a href="http://www.cryptopp.com/wiki/SIMON">SIMON</a> on the
143 /// Crypto++ wiki
144 /// \since Crypto++ 6.0
145 class CRYPTOPP_NO_VTABLE SIMON128 : public SIMON_Info<16, 16, 16, 32>, public BlockCipherDocumentation
146 {
147 public:
148 /// \brief SIMON128 block cipher base implementation
149 /// \details Provides implementation common to encryption and decryption
150 /// \since Crypto++ 6.0
151 class CRYPTOPP_NO_VTABLE Base : protected SIMON_Base<word64>, public BlockCipherImpl<SIMON_Info<16, 16, 16, 32> >
152 {
153 public:
154 /// \brief The algorithm name
155 /// \return the algorithm name
156 /// \details AlgorithmName returns the algorithm's name as a
157 /// member function.
158 std::string AlgorithmName() const {
159 return StaticAlgorithmName() + (m_kwords == 0 ? "" :
160 "(" + IntToString(m_kwords*sizeof(word64)*8) + ")");
161 }
162
163 std::string AlgorithmProvider() const;
164
165 /// \brief Provides input and output data alignment for optimal performance.
166 /// \return the input data alignment that provides optimal performance
167 /// \sa GetAlignment() and OptimalBlockSize()
168 unsigned int OptimalDataAlignment() const;
169
170 protected:
171 void UncheckedSetKey(const byte *userKey, unsigned int keyLength, const NameValuePairs &params);
172 };
173
174 /// \brief SIMON128 encryption transformation
175 /// \details Enc provides the encryption transformation.
176 /// All key sizes are supported.
177 /// \since Crypto++ 6.0
178 class CRYPTOPP_NO_VTABLE Enc : public Base
179 {
180 public:
181 void ProcessAndXorBlock(const byte *inBlock, const byte *xorBlock, byte *outBlock) const;
182 #if CRYPTOPP_SIMON128_ADVANCED_PROCESS_BLOCKS
183 size_t AdvancedProcessBlocks(const byte *inBlocks, const byte *xorBlocks, byte *outBlocks, size_t length, word32 flags) const;
184 #endif
185 };
186
187 /// \brief SIMON128 decryption transformation
188 /// \details Dec provides the decryption transformation.
189 /// All key sizes are supported.
190 /// \since Crypto++ 6.0
191 class CRYPTOPP_NO_VTABLE Dec : public Base
192 {
193 public:
194 void ProcessAndXorBlock(const byte *inBlock, const byte *xorBlock, byte *outBlock) const;
195 #if CRYPTOPP_SIMON128_ADVANCED_PROCESS_BLOCKS
196 size_t AdvancedProcessBlocks(const byte *inBlocks, const byte *xorBlocks, byte *outBlocks, size_t length, word32 flags) const;
197 #endif
198 };
199
200 typedef BlockCipherFinal<ENCRYPTION, Enc> Encryption;
201 typedef BlockCipherFinal<DECRYPTION, Dec> Decryption;
202 };
203
204 NAMESPACE_END
205
206 #endif // CRYPTOPP_SIMON_H
BlockCipherDocumentation
Provides Encryption and Decryption typedefs used by derived classes to implement a block cipher...
Definition: seckey.h:398
SIMON128::Dec
SIMON128 decryption transformation.
Definition: simon.h:191
SIMON128::Base::AlgorithmName
std::string AlgorithmName() const
The algorithm name.
Definition: simon.h:158
SecBlock
Secure memory block with allocator and cleanup.
Definition: secblock.h:709
SIMON128::Enc
SIMON128 encryption transformation.
Definition: simon.h:178
config.h
Library configuration file.
SIMON_Info::StaticAlgorithmName
static const std::string StaticAlgorithmName()
The algorithm name.
Definition: simon.h:49
BlockCipher
Interface for one direction (encryption or decryption) of a block cipher.
Definition: cryptlib.h:1278
secblock.h
Classes and functions for secure memory allocations.
FixedBlockSize
Inherited by algorithms with fixed block size.
Definition: seckey.h:40
SIMON64
SIMON 64-bit block cipher.
Definition: simon.h:83
SIMON64::Enc
SIMON64 encryption transformation.
Definition: simon.h:116
SIMON64::Base::AlgorithmName
std::string AlgorithmName() const
The algorithm name.
Definition: simon.h:96
SIMON64::Base
SIMON64 block cipher base implementation.
Definition: simon.h:89
seckey.h
Classes and functions for implementing secret key algorithms.
SIMON128
SIMON 128-bit block cipher.
Definition: simon.h:145
BlockCipherFinal< ENCRYPTION, Enc >
VariableKeyLength
Inherited by keyed algorithms with variable key length.
Definition: seckey.h:165
SIMON64::Dec
SIMON64 decryption transformation.
Definition: simon.h:126
SIMON128::Base
SIMON128 block cipher base implementation.
Definition: simon.h:151
IntToString
std::string IntToString(T value, unsigned int base=10)
Converts a value to a string.
Definition: misc.h:704
BlockCipherImpl
Provides a base implementation of Algorithm and SimpleKeyingInterface for block ciphers.
Definition: seckey.h:305
CryptoPP
Crypto++ library namespace.
SIMON_Info
SIMON block cipher information.
Definition: simon.h:43
SIMON_Base
SIMON block cipher base class.
Definition: simon.h:62
NameValuePairs
Interface for retrieving values given their names.
Definition: cryptlib.h:321