Botan  1.10.9
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 */
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 */
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 */
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 */
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 */
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 }
OctetString & operator^=(const OctetString &other)
Definition: symkey.cpp:88
void resize(size_t n)
Definition: secmem.h:211
bool operator!=(const OctetString &s1, const OctetString &s2)
Definition: symkey.cpp:106
BigInt n
Definition: numthry.cpp:26
SecureVector< byte > random_vec(size_t bytes)
Definition: rng.h:40
size_t hex_decode(byte output[], const char input[], size_t input_length, size_t &input_consumed, bool ignore_ws)
Definition: hex.cpp:55
bool operator==(const OctetString &s1, const OctetString &s2)
Definition: symkey.cpp:98
void copy(const T in[], size_t n)
Definition: secmem.h:120
size_t length() const
Definition: symkey.h:25
OctetString operator^(const OctetString &k1, const OctetString &k2)
Definition: symkey.cpp:125
unsigned char byte
Definition: types.h:22
SecureVector< byte > bits_of() const
Definition: symkey.h:30
RandomNumberGenerator * rng
Definition: global_rng.cpp:165
OctetString operator+(const OctetString &k1, const OctetString &k2)
Definition: symkey.cpp:114
const byte * begin() const
Definition: symkey.h:35
size_t size() const
Definition: secmem.h:29
std::string as_string() const
Definition: symkey.cpp:80
void change(const std::string &hex_string)
Definition: symkey.cpp:29
OctetString(class RandomNumberGenerator &rng, size_t len)
Definition: symkey.cpp:20
void xor_buf(byte out[], const byte in[], size_t length)
Definition: xor_buf.h:21
void zeroise(MemoryRegion< T > &vec)
Definition: secmem.h:415
void hex_encode(char output[], const byte input[], size_t input_length, bool uppercase)
Definition: hex.cpp:14
void set_odd_parity()
Definition: symkey.cpp:47