Botan: src/algo_base/symkey.cpp Source File

Botan 1.10.17

symkey.cpp
Go to the documentation of this file.
1 /*
2 * OctetString
3 * (C) 1999-2007 Jack Lloyd
4 *
5 * Distributed under the terms of the Botan license
6 */
7
8 #include <botan/symkey.h>
9 #include <botan/internal/xor_buf.h>
10 #include <botan/rng.h>
11 #include <botan/pipe.h>
12 #include <botan/hex.h>
13 #include <algorithm>
14
15 namespace Botan {
16
17 /*
18 * Create an OctetString from RNG output
19 */
20 OctetString::OctetString(RandomNumberGenerator& rng,
21 size_t length)
22 {
23 bits = rng.random_vec(length);
24 }
25
26 /*
27 * Create an OctetString from a hex string
28 */
29 void OctetString::change(const std::string& hex_string)
30 {
31 bits.resize(1 + hex_string.length() / 2);
32 bits.resize(hex_decode(&bits[0], hex_string));
33 }
34
35 /*
36 * Create an OctetString from a byte string
37 */
38 void OctetString::change(const byte in[], size_t n)
39 {
40 bits.resize(n);
41 bits.copy(in, n);
42 }
43
44 /*
45 * Set the parity of each key byte to odd
46 */
47 void OctetString::set_odd_parity()
48 {
49 const byte ODD_PARITY[256] = {
50 0x01, 0x01, 0x02, 0x02, 0x04, 0x04, 0x07, 0x07, 0x08, 0x08, 0x0B, 0x0B,
51 0x0D, 0x0D, 0x0E, 0x0E, 0x10, 0x10, 0x13, 0x13, 0x15, 0x15, 0x16, 0x16,
52 0x19, 0x19, 0x1A, 0x1A, 0x1C, 0x1C, 0x1F, 0x1F, 0x20, 0x20, 0x23, 0x23,
53 0x25, 0x25, 0x26, 0x26, 0x29, 0x29, 0x2A, 0x2A, 0x2C, 0x2C, 0x2F, 0x2F,
54 0x31, 0x31, 0x32, 0x32, 0x34, 0x34, 0x37, 0x37, 0x38, 0x38, 0x3B, 0x3B,
55 0x3D, 0x3D, 0x3E, 0x3E, 0x40, 0x40, 0x43, 0x43, 0x45, 0x45, 0x46, 0x46,
56 0x49, 0x49, 0x4A, 0x4A, 0x4C, 0x4C, 0x4F, 0x4F, 0x51, 0x51, 0x52, 0x52,
57 0x54, 0x54, 0x57, 0x57, 0x58, 0x58, 0x5B, 0x5B, 0x5D, 0x5D, 0x5E, 0x5E,
58 0x61, 0x61, 0x62, 0x62, 0x64, 0x64, 0x67, 0x67, 0x68, 0x68, 0x6B, 0x6B,
59 0x6D, 0x6D, 0x6E, 0x6E, 0x70, 0x70, 0x73, 0x73, 0x75, 0x75, 0x76, 0x76,
60 0x79, 0x79, 0x7A, 0x7A, 0x7C, 0x7C, 0x7F, 0x7F, 0x80, 0x80, 0x83, 0x83,
61 0x85, 0x85, 0x86, 0x86, 0x89, 0x89, 0x8A, 0x8A, 0x8C, 0x8C, 0x8F, 0x8F,
62 0x91, 0x91, 0x92, 0x92, 0x94, 0x94, 0x97, 0x97, 0x98, 0x98, 0x9B, 0x9B,
63 0x9D, 0x9D, 0x9E, 0x9E, 0xA1, 0xA1, 0xA2, 0xA2, 0xA4, 0xA4, 0xA7, 0xA7,
64 0xA8, 0xA8, 0xAB, 0xAB, 0xAD, 0xAD, 0xAE, 0xAE, 0xB0, 0xB0, 0xB3, 0xB3,
65 0xB5, 0xB5, 0xB6, 0xB6, 0xB9, 0xB9, 0xBA, 0xBA, 0xBC, 0xBC, 0xBF, 0xBF,
66 0xC1, 0xC1, 0xC2, 0xC2, 0xC4, 0xC4, 0xC7, 0xC7, 0xC8, 0xC8, 0xCB, 0xCB,
67 0xCD, 0xCD, 0xCE, 0xCE, 0xD0, 0xD0, 0xD3, 0xD3, 0xD5, 0xD5, 0xD6, 0xD6,
68 0xD9, 0xD9, 0xDA, 0xDA, 0xDC, 0xDC, 0xDF, 0xDF, 0xE0, 0xE0, 0xE3, 0xE3,
69 0xE5, 0xE5, 0xE6, 0xE6, 0xE9, 0xE9, 0xEA, 0xEA, 0xEC, 0xEC, 0xEF, 0xEF,
70 0xF1, 0xF1, 0xF2, 0xF2, 0xF4, 0xF4, 0xF7, 0xF7, 0xF8, 0xF8, 0xFB, 0xFB,
71 0xFD, 0xFD, 0xFE, 0xFE };
72
73 for(size_t j = 0; j != bits.size(); ++j)
74 bits[j] = ODD_PARITY[bits[j]];
75 }
76
77 /*
78 * Hex encode an OctetString
79 */
80 std::string OctetString::as_string() const
81 {
82 return hex_encode(&bits[0], bits.size());
83 }
84
85 /*
86 * XOR Operation for OctetStrings
87 */
88 OctetString& OctetString::operator^=(const OctetString& k)
89 {
90 if(&k == this) { zeroise(bits); return (*this); }
91 xor_buf(&bits[0], k.begin(), std::min(length(), k.length()));
92 return (*this);
93 }
94
95 /*
96 * Equality Operation for OctetStrings
97 */
98 bool operator==(const OctetString& s1, const OctetString& s2)
99 {
100 return (s1.bits_of() == s2.bits_of());
101 }
102
103 /*
104 * Unequality Operation for OctetStrings
105 */
106 bool operator!=(const OctetString& s1, const OctetString& s2)
107 {
108 return !(s1 == s2);
109 }
110
111 /*
112 * Append Operation for OctetStrings
113 */
114 OctetString operator+(const OctetString& k1, const OctetString& k2)
115 {
116 SecureVector<byte> out;
117 out += k1.bits_of();
118 out += k2.bits_of();
119 return OctetString(out);
120 }
121
122 /*
123 * XOR Operation for OctetStrings
124 */
125 OctetString operator^(const OctetString& k1, const OctetString& k2)
126 {
127 SecureVector<byte> ret(std::max(k1.length(), k2.length()));
128 ret.copy(k1.begin(), k1.length());
129 xor_buf(ret, k2.begin(), k2.length());
130 return OctetString(ret);
131 }
132
133 }
Botan::OctetString::operator^=
OctetString & operator^=(const OctetString &other)
Definition: symkey.cpp:88
Botan::MemoryRegion::resize
void resize(size_t n)
Definition: secmem.h:217
Botan::OctetString::as_string
std::string as_string() const
Definition: symkey.cpp:80
Botan::operator!=
bool operator!=(const OctetString &s1, const OctetString &s2)
Definition: symkey.cpp:106
Botan::OctetString
Definition: symkey.h:19
Botan::RandomNumberGenerator
Definition: rng.h:20
Botan::hex_decode
size_t hex_decode(byte output[], const char input[], size_t input_length, size_t &input_consumed, bool ignore_ws)
Definition: hex.cpp:55
Botan::operator==
bool operator==(const OctetString &s1, const OctetString &s2)
Definition: symkey.cpp:98
Botan::MemoryRegion::copy
void copy(const T in[], size_t n)
Definition: secmem.h:126
Botan::OctetString::begin
const byte * begin() const
Definition: symkey.h:35
Botan::operator^
OctetString operator^(const OctetString &k1, const OctetString &k2)
Definition: symkey.cpp:125
Botan::byte
unsigned char byte
Definition: types.h:22
Botan::operator+
OctetString operator+(const OctetString &k1, const OctetString &k2)
Definition: symkey.cpp:114
Botan
Definition: algo_base.h:14
Botan::OctetString::length
size_t length() const
Definition: symkey.h:25
Botan::CT::max
T max(T a, T b)
Definition: ct_utils.h:120
Botan::OctetString::change
void change(const std::string &hex_string)
Definition: symkey.cpp:29
Botan::MemoryRegion::size
size_t size() const
Definition: secmem.h:29
Botan::CT::min
T min(T a, T b)
Definition: ct_utils.h:127
Botan::OctetString::OctetString
OctetString(class RandomNumberGenerator &rng, size_t len)
Definition: symkey.cpp:20
Botan::SecureVector< byte >
Botan::OctetString::bits_of
SecureVector< byte > bits_of() const
Definition: symkey.h:30
Botan::xor_buf
void xor_buf(byte out[], const byte in[], size_t length)
Definition: xor_buf.h:21
Botan::zeroise
void zeroise(MemoryRegion< T > &vec)
Definition: secmem.h:428
Botan::hex_encode
void hex_encode(char output[], const byte input[], size_t input_length, bool uppercase)
Definition: hex.cpp:14
Botan::OctetString::set_odd_parity
void set_odd_parity()
Definition: symkey.cpp:47