Botan 3.1.1
Crypto and TLS for C&
Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
Botan::GOST_28147_89 Class Referencefinal

#include <gost_28147.h>

Inheritance diagram for Botan::GOST_28147_89:
Botan::Block_Cipher_Fixed_Params< 8, 32 > Botan::BlockCipher Botan::SymmetricAlgorithm

Public Types

enum  
 

Public Member Functions

size_t block_size () const final override
 
void clear () override
 
BlockCipher * clone () const
 
void decrypt (const uint8_t in[], uint8_t out[]) const
 
void decrypt (std::span< const uint8_t > in, std::span< uint8_t > out) const
 
void decrypt (std::span< uint8_t > block) const
 
void decrypt (uint8_t block[]) const
 
void decrypt_n (const uint8_t in[], uint8_t out[], size_t blocks) const override
 
void decrypt_n_xex (uint8_t data[], const uint8_t mask[], size_t blocks) const final override
 
void encrypt (const uint8_t in[], uint8_t out[]) const
 
void encrypt (std::span< const uint8_t > in, std::span< uint8_t > out) const
 
void encrypt (std::span< uint8_t > block) const
 
void encrypt (uint8_t block[]) const
 
void encrypt_n (const uint8_t in[], uint8_t out[], size_t blocks) const override
 
void encrypt_n_xex (uint8_t data[], const uint8_t mask[], size_t blocks) const final override
 
 GOST_28147_89 (const GOST_28147_89_Params &params)
 
 GOST_28147_89 (const std::vector< uint32_t > &other_SBOX, std::string_view name)
 
 GOST_28147_89 (std::string_view param_name)
 
bool has_keying_material () const override
 
Key_Length_Specification key_spec () const final override
 
size_t maximum_keylength () const
 
size_t minimum_keylength () const
 
std::string name () const override
 
std::unique_ptr< BlockCipher > new_object () const override
 
size_t parallel_bytes () const
 
virtual size_t parallelism () const
 
virtual std::string provider () const
 
void set_key (const SymmetricKey &key)
 
void set_key (const uint8_t key[], size_t length)
 
void set_key (std::span< const uint8_t > key)
 
bool valid_keylength (size_t length) const
 

Static Public Member Functions

static std::unique_ptr< BlockCipher > create (std::string_view algo_spec, std::string_view provider="")
 
static std::unique_ptr< BlockCipher > create_or_throw (std::string_view algo_spec, std::string_view provider="")
 
static std::vector< std::string > providers (std::string_view algo_spec)
 

Protected Member Functions

void assert_key_material_set () const
 
void assert_key_material_set (bool predicate) const
 

Detailed Description

GOST 28147-89

Definition at line 58 of file gost_28147.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum
inherited

Definition at line 196 of file block_cipher.h.

196{ BLOCK_SIZE = BS };
Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE
@ BLOCK_SIZE
Definition: block_cipher.h:196

Constructor & Destructor Documentation

◆ GOST_28147_89() [1/3]

Botan::GOST_28147_89::GOST_28147_89 ( const GOST_28147_89_Params &  params)
explicit
Parameters
paramsthe sbox parameters to use

Definition at line 57 of file gost_28147.cpp.

57 :
58 m_SBOX(1024), m_name(fmt("GOST-28147-89({})", param.param_name())) {
59 // Convert the parallel 4x4 sboxes into larger word-based sboxes
60
61 for(size_t i = 0; i != 256; ++i) {
62 m_SBOX[i] = rotl<11, uint32_t>(param.sbox_pair(0, i));
63 m_SBOX[i + 256] = rotl<19, uint32_t>(param.sbox_pair(1, i));
64 m_SBOX[i + 512] = rotl<27, uint32_t>(param.sbox_pair(2, i));
65 m_SBOX[i + 768] = rotl<3, uint32_t>(param.sbox_pair(3, i));
66 }
67}
Botan::fmt
std::string fmt(std::string_view format, const T &... args)
Definition: fmt.h:53

References Botan::GOST_28147_89_Params::sbox_pair().

◆ GOST_28147_89() [2/3]

Botan::GOST_28147_89::GOST_28147_89 ( std::string_view  param_name)
inlineexplicit

Definition at line 78 of file gost_28147.h.

78: GOST_28147_89(GOST_28147_89_Params(param_name)) {}
Botan::GOST_28147_89::GOST_28147_89
GOST_28147_89(const GOST_28147_89_Params &params)
Definition: gost_28147.cpp:57

◆ GOST_28147_89() [3/3]

Botan::GOST_28147_89::GOST_28147_89 ( const std::vector< uint32_t > &  other_SBOX,
std::string_view  name 
)
inlineexplicit

Definition at line 80 of file gost_28147.h.

80 :
81 m_SBOX(other_SBOX), m_EK(8), m_name(name) {}
Botan::GOST_28147_89::name
std::string name() const override
Definition: gost_28147.cpp:69

Member Function Documentation

◆ assert_key_material_set() [1/2]

void Botan::SymmetricAlgorithm::assert_key_material_set ( ) const
inlineprotectedinherited

Definition at line 139 of file sym_algo.h.

139{ assert_key_material_set(has_keying_material()); }
Botan::SymmetricAlgorithm::has_keying_material
virtual bool has_keying_material() const =0
Botan::SymmetricAlgorithm::assert_key_material_set
void assert_key_material_set() const
Definition: sym_algo.h:139

References Botan::SymmetricAlgorithm::assert_key_material_set().

Referenced by Botan::SymmetricAlgorithm::assert_key_material_set(), Botan::Salsa20::cipher_bytes(), Botan::AES_128::decrypt_n(), Botan::AES_192::decrypt_n(), Botan::AES_256::decrypt_n(), Botan::ARIA_128::decrypt_n(), Botan::ARIA_192::decrypt_n(), Botan::ARIA_256::decrypt_n(), Botan::Blowfish::decrypt_n(), Botan::Camellia_128::decrypt_n(), Botan::Camellia_192::decrypt_n(), Botan::Camellia_256::decrypt_n(), Botan::CAST_128::decrypt_n(), Botan::DES::decrypt_n(), Botan::TripleDES::decrypt_n(), decrypt_n(), Botan::IDEA::decrypt_n(), Botan::Lion::decrypt_n(), Botan::Noekeon::decrypt_n(), Botan::SEED::decrypt_n(), Botan::Serpent::decrypt_n(), Botan::SHACAL2::decrypt_n(), Botan::SM4::decrypt_n(), Botan::Threefish_512::decrypt_n(), Botan::Twofish::decrypt_n(), Botan::AES_128::encrypt_n(), Botan::AES_192::encrypt_n(), Botan::AES_256::encrypt_n(), Botan::ARIA_128::encrypt_n(), Botan::ARIA_192::encrypt_n(), Botan::ARIA_256::encrypt_n(), Botan::Blowfish::encrypt_n(), Botan::Camellia_128::encrypt_n(), Botan::Camellia_192::encrypt_n(), Botan::Camellia_256::encrypt_n(), Botan::CAST_128::encrypt_n(), Botan::DES::encrypt_n(), Botan::TripleDES::encrypt_n(), encrypt_n(), Botan::IDEA::encrypt_n(), Botan::Lion::encrypt_n(), Botan::Noekeon::encrypt_n(), Botan::SEED::encrypt_n(), Botan::Serpent::encrypt_n(), Botan::SHACAL2::encrypt_n(), Botan::SM4::encrypt_n(), Botan::Threefish_512::encrypt_n(), Botan::Twofish::encrypt_n(), Botan::GHASH::final(), Botan::GHASH::ghash_update(), Botan::ChaCha::seek(), Botan::CTR_BE::seek(), Botan::Salsa20::seek(), Botan::OCB_Mode::set_associated_data_n(), Botan::Salsa20::set_iv_bytes(), Botan::GHASH::update(), and Botan::GHASH::update_associated_data().

◆ assert_key_material_set() [2/2]

void Botan::SymmetricAlgorithm::assert_key_material_set ( bool  predicate) const
inlineprotectedinherited

Definition at line 141 of file sym_algo.h.

141 {
142 if(!predicate)
143 throw_key_not_set_error();
144 }

◆ block_size()

size_t Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 , BlockCipher >::block_size ( ) const
inlinefinaloverridevirtualinherited
Returns
block size of this algorithm

Implements Botan::BlockCipher.

Definition at line 198 of file block_cipher.h.

198{ return BS; }

◆ clear()

void Botan::GOST_28147_89::clear ( )
overridevirtual

Reset the internal state. This includes not just the key, but any partial message that may have been in process.

Implements Botan::SymmetricAlgorithm.

Definition at line 160 of file gost_28147.cpp.

160 {
161 zap(m_EK);
162}
Botan::zap
void zap(std::vector< T, Alloc > &vec)
Definition: secmem.h:117

References Botan::zap().

Referenced by Botan::GOST_34_11::clear().

◆ clone()

BlockCipher * Botan::BlockCipher::clone ( ) const
inlineinherited

Definition at line 170 of file block_cipher.h.

170{ return this->new_object().release(); }
Botan::BlockCipher::new_object
virtual std::unique_ptr< BlockCipher > new_object() const =0

◆ create()

std::unique_ptr< BlockCipher > Botan::BlockCipher::create ( std::string_view  algo_spec,
std::string_view  provider = "" 
)
staticinherited

Create an instance based on a name If provider is empty then best available is chosen.

Parameters
algo_specalgorithm name
providerprovider implementation to choose
Returns
a null pointer if the algo/provider combination cannot be found

Definition at line 87 of file block_cipher.cpp.

87 {
88#if defined(BOTAN_HAS_COMMONCRYPTO)
89 if(provider.empty() || provider == "commoncrypto") {
90 if(auto bc = make_commoncrypto_block_cipher(algo))
91 return bc;
92
93 if(!provider.empty())
94 return nullptr;
95 }
96#endif
97
98 // TODO: CryptoAPI
99 // TODO: /dev/crypto
100
101 // Only base providers from here on out
102 if(provider.empty() == false && provider != "base") {
103 return nullptr;
104 }
105
106#if defined(BOTAN_HAS_AES)
107 if(algo == "AES-128") {
108 return std::make_unique<AES_128>();
109 }
110
111 if(algo == "AES-192") {
112 return std::make_unique<AES_192>();
113 }
114
115 if(algo == "AES-256") {
116 return std::make_unique<AES_256>();
117 }
118#endif
119
120#if defined(BOTAN_HAS_ARIA)
121 if(algo == "ARIA-128") {
122 return std::make_unique<ARIA_128>();
123 }
124
125 if(algo == "ARIA-192") {
126 return std::make_unique<ARIA_192>();
127 }
128
129 if(algo == "ARIA-256") {
130 return std::make_unique<ARIA_256>();
131 }
132#endif
133
134#if defined(BOTAN_HAS_SERPENT)
135 if(algo == "Serpent") {
136 return std::make_unique<Serpent>();
137 }
138#endif
139
140#if defined(BOTAN_HAS_SHACAL2)
141 if(algo == "SHACAL2") {
142 return std::make_unique<SHACAL2>();
143 }
144#endif
145
146#if defined(BOTAN_HAS_TWOFISH)
147 if(algo == "Twofish") {
148 return std::make_unique<Twofish>();
149 }
150#endif
151
152#if defined(BOTAN_HAS_THREEFISH_512)
153 if(algo == "Threefish-512") {
154 return std::make_unique<Threefish_512>();
155 }
156#endif
157
158#if defined(BOTAN_HAS_BLOWFISH)
159 if(algo == "Blowfish") {
160 return std::make_unique<Blowfish>();
161 }
162#endif
163
164#if defined(BOTAN_HAS_CAMELLIA)
165 if(algo == "Camellia-128") {
166 return std::make_unique<Camellia_128>();
167 }
168
169 if(algo == "Camellia-192") {
170 return std::make_unique<Camellia_192>();
171 }
172
173 if(algo == "Camellia-256") {
174 return std::make_unique<Camellia_256>();
175 }
176#endif
177
178#if defined(BOTAN_HAS_DES)
179 if(algo == "DES") {
180 return std::make_unique<DES>();
181 }
182
183 if(algo == "TripleDES" || algo == "3DES" || algo == "DES-EDE") {
184 return std::make_unique<TripleDES>();
185 }
186#endif
187
188#if defined(BOTAN_HAS_NOEKEON)
189 if(algo == "Noekeon") {
190 return std::make_unique<Noekeon>();
191 }
192#endif
193
194#if defined(BOTAN_HAS_CAST_128)
195 if(algo == "CAST-128" || algo == "CAST5") {
196 return std::make_unique<CAST_128>();
197 }
198#endif
199
200#if defined(BOTAN_HAS_IDEA)
201 if(algo == "IDEA") {
202 return std::make_unique<IDEA>();
203 }
204#endif
205
206#if defined(BOTAN_HAS_SEED)
207 if(algo == "SEED") {
208 return std::make_unique<SEED>();
209 }
210#endif
211
212#if defined(BOTAN_HAS_SM4)
213 if(algo == "SM4") {
214 return std::make_unique<SM4>();
215 }
216#endif
217
218 const SCAN_Name req(algo);
219
220#if defined(BOTAN_HAS_GOST_28147_89)
221 if(req.algo_name() == "GOST-28147-89") {
222 return std::make_unique<GOST_28147_89>(req.arg(0, "R3411_94_TestParam"));
223 }
224#endif
225
226#if defined(BOTAN_HAS_CASCADE)
227 if(req.algo_name() == "Cascade" && req.arg_count() == 2) {
228 auto c1 = BlockCipher::create(req.arg(0));
229 auto c2 = BlockCipher::create(req.arg(1));
230
231 if(c1 && c2) {
232 return std::make_unique<Cascade_Cipher>(std::move(c1), std::move(c2));
233 }
234 }
235#endif
236
237#if defined(BOTAN_HAS_LION)
238 if(req.algo_name() == "Lion" && req.arg_count_between(2, 3)) {
239 auto hash = HashFunction::create(req.arg(0));
240 auto stream = StreamCipher::create(req.arg(1));
241
242 if(hash && stream) {
243 const size_t block_size = req.arg_as_integer(2, 1024);
244 return std::make_unique<Lion>(std::move(hash), std::move(stream), block_size);
245 }
246 }
247#endif
248
249 BOTAN_UNUSED(req);
250 BOTAN_UNUSED(provider);
251
252 return nullptr;
253}
BOTAN_UNUSED
#define BOTAN_UNUSED
Definition: assert.h:118
Botan::BlockCipher::create
static std::unique_ptr< BlockCipher > create(std::string_view algo_spec, std::string_view provider="")
Definition: block_cipher.cpp:87
Botan::BlockCipher::block_size
virtual size_t block_size() const =0
Botan::BlockCipher::provider
virtual std::string provider() const
Definition: block_cipher.h:65
Botan::HashFunction::create
static std::unique_ptr< HashFunction > create(std::string_view algo_spec, std::string_view provider="")
Definition: hash.cpp:103
Botan::StreamCipher::create
static std::unique_ptr< StreamCipher > create(std::string_view algo_spec, std::string_view provider="")
Definition: stream_cipher.cpp:39
Botan::make_commoncrypto_block_cipher
std::unique_ptr< BlockCipher > make_commoncrypto_block_cipher(std::string_view name)
Definition: commoncrypto_block.cpp:133

References Botan::SCAN_Name::algo_name(), Botan::SCAN_Name::arg(), Botan::SCAN_Name::arg_as_integer(), Botan::SCAN_Name::arg_count(), Botan::SCAN_Name::arg_count_between(), Botan::BlockCipher::block_size(), BOTAN_UNUSED, Botan::BlockCipher::create(), Botan::HashFunction::create(), Botan::StreamCipher::create(), Botan::make_commoncrypto_block_cipher(), and Botan::BlockCipher::provider().

Referenced by botan_block_cipher_init(), Botan::AEAD_Mode::create(), Botan::Cipher_Mode::create(), Botan::BlockCipher::create(), Botan::MessageAuthenticationCode::create(), Botan::StreamCipher::create(), and Botan::BlockCipher::create_or_throw().

◆ create_or_throw()

std::unique_ptr< BlockCipher > Botan::BlockCipher::create_or_throw ( std::string_view  algo_spec,
std::string_view  provider = "" 
)
staticinherited

Create an instance based on a name, or throw if the algo/provider combination cannot be found. If provider is empty then best available is chosen.

Definition at line 256 of file block_cipher.cpp.

256 {
257 if(auto bc = BlockCipher::create(algo, provider)) {
258 return bc;
259 }
260 throw Lookup_Error("Block cipher", algo, provider);
261}

References Botan::BlockCipher::create(), and Botan::BlockCipher::provider().

Referenced by botan_nist_kw_dec(), botan_nist_kw_enc(), Botan::TLS::Connection_Cipher_State::Connection_Cipher_State(), Botan::Encrypted_PSK_Database::Encrypted_PSK_Database(), Botan::rfc3394_keyunwrap(), and Botan::rfc3394_keywrap().

◆ decrypt() [1/4]

void Botan::BlockCipher::decrypt ( const uint8_t  in[],
uint8_t  out[] 
) const
inlineinherited

Decrypt a block.

Parameters
inThe ciphertext block to be decypted as a byte array. Must be of length block_size().
outThe byte array designated to hold the decrypted block. Must be of length block_size().

Definition at line 83 of file block_cipher.h.

83{ decrypt_n(in, out, 1); }
Botan::BlockCipher::decrypt_n
virtual void decrypt_n(const uint8_t in[], uint8_t out[], size_t blocks) const =0

Referenced by Botan::nist_key_unwrap(), and Botan::nist_key_unwrap_padded().

◆ decrypt() [2/4]

void Botan::BlockCipher::decrypt ( std::span< const uint8_t >  in,
std::span< uint8_t >  out 
) const
inlineinherited

Decrypt one or more blocks

Parameters
inthe input buffer (multiple of block_size())
outthe output buffer (same size as in)

Definition at line 131 of file block_cipher.h.

131 {
132 return decrypt_n(in.data(), out.data(), in.size() / block_size());
133 }

◆ decrypt() [3/4]

void Botan::BlockCipher::decrypt ( std::span< uint8_t >  block) const
inlineinherited

Decrypt one or more blocks

Parameters
blockthe input/output buffer (multiple of block_size())

Definition at line 113 of file block_cipher.h.

113 {
114 return decrypt_n(block.data(), block.data(), block.size() / block_size());
115 }

◆ decrypt() [4/4]

void Botan::BlockCipher::decrypt ( uint8_t  block[]) const
inlineinherited

Decrypt a block.

Parameters
blockthe ciphertext block to be decrypted Must be of length block_size(). Will hold the result when the function has finished.

Definition at line 99 of file block_cipher.h.

99{ decrypt_n(block, block, 1); }

◆ decrypt_n()

void Botan::GOST_28147_89::decrypt_n ( const uint8_t  in[],
uint8_t  out[],
size_t  blocks 
) const
overridevirtual

Decrypt one or more blocks

Parameters
inthe input buffer (multiple of block_size())
outthe output buffer (same size as in)
blocksthe number of blocks to process

Implements Botan::BlockCipher.

Definition at line 121 of file gost_28147.cpp.

121 {
122 assert_key_material_set();
123
124 for(size_t i = 0; i != blocks; ++i) {
125 uint32_t N1 = load_le<uint32_t>(in, 0);
126 uint32_t N2 = load_le<uint32_t>(in, 1);
127
128 GOST_ROUND2<0, 1>(N1, N2, m_SBOX, m_EK);
129 GOST_ROUND2<2, 3>(N1, N2, m_SBOX, m_EK);
130 GOST_ROUND2<4, 5>(N1, N2, m_SBOX, m_EK);
131 GOST_ROUND2<6, 7>(N1, N2, m_SBOX, m_EK);
132
133 for(size_t j = 0; j != 3; ++j) {
134 GOST_ROUND2<7, 6>(N1, N2, m_SBOX, m_EK);
135 GOST_ROUND2<5, 4>(N1, N2, m_SBOX, m_EK);
136 GOST_ROUND2<3, 2>(N1, N2, m_SBOX, m_EK);
137 GOST_ROUND2<1, 0>(N1, N2, m_SBOX, m_EK);
138 }
139
140 store_le(out, N2, N1);
141 in += BLOCK_SIZE;
142 out += BLOCK_SIZE;
143 }
144}
Botan::load_le< uint32_t >
constexpr uint32_t load_le< uint32_t >(const uint8_t in[], size_t off)
Definition: loadstor.h:192
Botan::store_le
constexpr void store_le(uint16_t in, uint8_t out[2])
Definition: loadstor.h:422

References Botan::SymmetricAlgorithm::assert_key_material_set(), Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE, Botan::load_le< uint32_t >(), and Botan::store_le().

◆ decrypt_n_xex()

void Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 , BlockCipher >::decrypt_n_xex ( uint8_t  data[],
const uint8_t  mask[],
size_t  blocks 
) const
inlinefinaloverridevirtualinherited

Reimplemented from Botan::BlockCipher.

Definition at line 207 of file block_cipher.h.

207 {
208 xor_buf(data, mask, blocks * BS);
209 this->decrypt_n(data, data, blocks);
210 xor_buf(data, mask, blocks * BS);
211 }
Botan::xor_buf
void xor_buf(uint8_t out[], const uint8_t in[], size_t length)
Definition: mem_ops.h:236

◆ encrypt() [1/4]

void Botan::BlockCipher::encrypt ( const uint8_t  in[],
uint8_t  out[] 
) const
inlineinherited

Encrypt a block.

Parameters
inThe plaintext block to be encrypted as a byte array. Must be of length block_size().
outThe byte array designated to hold the encrypted block. Must be of length block_size().

Definition at line 74 of file block_cipher.h.

74{ encrypt_n(in, out, 1); }
Botan::BlockCipher::encrypt_n
virtual void encrypt_n(const uint8_t in[], uint8_t out[], size_t blocks) const =0

Referenced by Botan::nist_key_wrap(), Botan::nist_key_wrap_padded(), and Botan::CFB_Mode::shift_register().

◆ encrypt() [2/4]

void Botan::BlockCipher::encrypt ( std::span< const uint8_t >  in,
std::span< uint8_t >  out 
) const
inlineinherited

Encrypt one or more blocks

Parameters
inthe input buffer (multiple of block_size())
outthe output buffer (same size as in)

Definition at line 122 of file block_cipher.h.

122 {
123 return encrypt_n(in.data(), out.data(), in.size() / block_size());
124 }

◆ encrypt() [3/4]

void Botan::BlockCipher::encrypt ( std::span< uint8_t >  block) const
inlineinherited

Encrypt one or more blocks

Parameters
blockthe input/output buffer (multiple of block_size())

Definition at line 105 of file block_cipher.h.

105 {
106 return encrypt_n(block.data(), block.data(), block.size() / block_size());
107 }

◆ encrypt() [4/4]

void Botan::BlockCipher::encrypt ( uint8_t  block[]) const
inlineinherited

Encrypt a block.

Parameters
blockthe plaintext block to be encrypted Must be of length block_size(). Will hold the result when the function has finished.

Definition at line 91 of file block_cipher.h.

91{ encrypt_n(block, block, 1); }

◆ encrypt_n()

void Botan::GOST_28147_89::encrypt_n ( const uint8_t  in[],
uint8_t  out[],
size_t  blocks 
) const
overridevirtual

Encrypt one or more blocks

Parameters
inthe input buffer (multiple of block_size())
outthe output buffer (same size as in)
blocksthe number of blocks to process

Implements Botan::BlockCipher.

Definition at line 92 of file gost_28147.cpp.

92 {
93 assert_key_material_set();
94
95 for(size_t i = 0; i != blocks; ++i) {
96 uint32_t N1 = load_le<uint32_t>(in, 0);
97 uint32_t N2 = load_le<uint32_t>(in, 1);
98
99 for(size_t j = 0; j != 3; ++j) {
100 GOST_ROUND2<0, 1>(N1, N2, m_SBOX, m_EK);
101 GOST_ROUND2<2, 3>(N1, N2, m_SBOX, m_EK);
102 GOST_ROUND2<4, 5>(N1, N2, m_SBOX, m_EK);
103 GOST_ROUND2<6, 7>(N1, N2, m_SBOX, m_EK);
104 }
105
106 GOST_ROUND2<7, 6>(N1, N2, m_SBOX, m_EK);
107 GOST_ROUND2<5, 4>(N1, N2, m_SBOX, m_EK);
108 GOST_ROUND2<3, 2>(N1, N2, m_SBOX, m_EK);
109 GOST_ROUND2<1, 0>(N1, N2, m_SBOX, m_EK);
110
111 store_le(out, N2, N1);
112
113 in += BLOCK_SIZE;
114 out += BLOCK_SIZE;
115 }
116}

References Botan::SymmetricAlgorithm::assert_key_material_set(), Botan::Block_Cipher_Fixed_Params< 8, 32 >::BLOCK_SIZE, Botan::load_le< uint32_t >(), and Botan::store_le().

◆ encrypt_n_xex()

void Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 , BlockCipher >::encrypt_n_xex ( uint8_t  data[],
const uint8_t  mask[],
size_t  blocks 
) const
inlinefinaloverridevirtualinherited

Reimplemented from Botan::BlockCipher.

Definition at line 201 of file block_cipher.h.

201 {
202 xor_buf(data, mask, blocks * BS);
203 this->encrypt_n(data, data, blocks);
204 xor_buf(data, mask, blocks * BS);
205 }

◆ has_keying_material()

bool Botan::GOST_28147_89::has_keying_material ( ) const
overridevirtual
Returns
true if a key has been set on this object

Implements Botan::SymmetricAlgorithm.

Definition at line 146 of file gost_28147.cpp.

146 {
147 return !m_EK.empty();
148}

◆ key_spec()

Key_Length_Specification Botan::Block_Cipher_Fixed_Params< BS, KMIN, 0 , 1 , BlockCipher >::key_spec ( ) const
inlinefinaloverridevirtualinherited
Returns
object describing limits on key size

Implements Botan::SymmetricAlgorithm.

Definition at line 213 of file block_cipher.h.

213{ return Key_Length_Specification(KMIN, KMAX, KMOD); }

◆ maximum_keylength()

size_t Botan::SymmetricAlgorithm::maximum_keylength ( ) const
inlineinherited
Returns
maximum allowed key length

Definition at line 95 of file sym_algo.h.

95{ return key_spec().maximum_keylength(); }
Botan::Key_Length_Specification::maximum_keylength
size_t maximum_keylength() const
Definition: sym_algo.h:54
Botan::SymmetricAlgorithm::key_spec
virtual Key_Length_Specification key_spec() const =0

◆ minimum_keylength()

size_t Botan::SymmetricAlgorithm::minimum_keylength ( ) const
inlineinherited
Returns
minimum allowed key length

Definition at line 100 of file sym_algo.h.

100{ return key_spec().minimum_keylength(); }
Botan::Key_Length_Specification::minimum_keylength
size_t minimum_keylength() const
Definition: sym_algo.h:49

◆ name()

std::string Botan::GOST_28147_89::name ( ) const
overridevirtual
Returns
the algorithm name

Implements Botan::SymmetricAlgorithm.

Definition at line 69 of file gost_28147.cpp.

69 {
70 return m_name;
71}

◆ new_object()

std::unique_ptr< BlockCipher > Botan::GOST_28147_89::new_object ( ) const
inlineoverridevirtual
Returns
new object representing the same algorithm as *this

Implements Botan::BlockCipher.

Definition at line 67 of file gost_28147.h.

67 {
68 return std::make_unique<GOST_28147_89>(m_SBOX, m_name);
69 }

◆ parallel_bytes()

size_t Botan::BlockCipher::parallel_bytes ( ) const
inlineinherited
Returns
prefererred parallelism of this cipher in bytes

Definition at line 59 of file block_cipher.h.

59{ return parallelism() * block_size() * BOTAN_BLOCK_CIPHER_PAR_MULT; }
Botan::BlockCipher::parallelism
virtual size_t parallelism() const
Definition: block_cipher.h:54
BOTAN_BLOCK_CIPHER_PAR_MULT
#define BOTAN_BLOCK_CIPHER_PAR_MULT
Definition: build.h:429

References BOTAN_BLOCK_CIPHER_PAR_MULT.

Referenced by Botan::CBC_Mode::ideal_granularity().

◆ parallelism()

virtual size_t Botan::BlockCipher::parallelism ( ) const
inlinevirtualinherited
Returns
native parallelism of this cipher in blocks

Reimplemented in Botan::AES_128, Botan::AES_192, Botan::AES_256, Botan::IDEA, Botan::Noekeon, Botan::Serpent, Botan::SHACAL2, and Botan::SM4.

Definition at line 54 of file block_cipher.h.

54{ return 1; }

◆ provider()

virtual std::string Botan::BlockCipher::provider ( ) const
inlinevirtualinherited
Returns
provider information about this implementation. Default is "base", might also return "sse2", "avx2", "openssl", or some other arbitrary string.

Reimplemented in Botan::AES_128, Botan::AES_192, Botan::AES_256, Botan::IDEA, Botan::Noekeon, Botan::Serpent, Botan::SHACAL2, and Botan::SM4.

Definition at line 65 of file block_cipher.h.

65{ return "base"; }

Referenced by Botan::BlockCipher::create(), and Botan::BlockCipher::create_or_throw().

◆ providers()

std::vector< std::string > Botan::BlockCipher::providers ( std::string_view  algo_spec)
staticinherited
Returns
list of available providers for this algorithm, empty if not available
Parameters
algo_specalgorithm name

Definition at line 263 of file block_cipher.cpp.

263 {
264 return probe_providers_of<BlockCipher>(algo, {"base", "commoncrypto"});
265}

◆ set_key() [1/3]

void Botan::SymmetricAlgorithm::set_key ( const SymmetricKey &  key)
inlineinherited

Set the symmetric key of this object.

Parameters
keythe SymmetricKey to be set.

Definition at line 113 of file sym_algo.h.

113{ set_key(key.begin(), key.length()); }
Botan::SymmetricAlgorithm::set_key
void set_key(const SymmetricKey &key)
Definition: sym_algo.h:113

References Botan::OctetString::begin(), Botan::OctetString::length(), and Botan::SymmetricAlgorithm::set_key().

Referenced by Botan::Sodium::crypto_stream_salsa20(), Botan::Sodium::crypto_stream_salsa20_xor_ic(), Botan::Sodium::crypto_stream_xsalsa20(), Botan::Sodium::crypto_stream_xsalsa20_xor_ic(), Botan::FPE::fe1_decrypt(), Botan::FPE::fe1_encrypt(), Botan::Sphincs_Hash_Functions_Sha2::PRF_msg(), Botan::Sodium::randombytes_buf_deterministic(), and Botan::SymmetricAlgorithm::set_key().

◆ set_key() [2/3]

void Botan::SymmetricAlgorithm::set_key ( const uint8_t  key[],
size_t  length 
)
inherited

Set the symmetric key of this object.

Parameters
keythe to be set as a byte array.
lengthin bytes of key param

Definition at line 17 of file sym_algo.cpp.

17 {
18 if(!valid_keylength(length)) {
19 throw Invalid_Key_Length(name(), length);
20 }
21 key_schedule(key, length);
22}
Botan::SymmetricAlgorithm::valid_keylength
bool valid_keylength(size_t length) const
Definition: sym_algo.h:107
Botan::SymmetricAlgorithm::name
virtual std::string name() const =0

References Botan::SymmetricAlgorithm::name(), and Botan::SymmetricAlgorithm::valid_keylength().

◆ set_key() [3/3]

void Botan::SymmetricAlgorithm::set_key ( std::span< const uint8_t >  key)
inlineinherited

Set the symmetric key of this object.

Parameters
keythe contiguous byte range to be set.

Definition at line 119 of file sym_algo.h.

119{ set_key(key.data(), key.size()); }

References Botan::SymmetricAlgorithm::set_key().

Referenced by Botan::SymmetricAlgorithm::set_key().

◆ valid_keylength()

bool Botan::SymmetricAlgorithm::valid_keylength ( size_t  length) const
inlineinherited

Check whether a given key length is valid for this algorithm.

Parameters
lengththe key length to be checked.
Returns
true if the key length is valid.

Definition at line 107 of file sym_algo.h.

107{ return key_spec().valid_keylength(length); }
Botan::Key_Length_Specification::valid_keylength
bool valid_keylength(size_t length) const
Definition: sym_algo.h:42

Referenced by Botan::SymmetricAlgorithm::set_key().

The documentation for this class was generated from the following files:
Generated by doxygen 1.9.6