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
15namespace 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*/
29void 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*/
38void 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*/
80std::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*/
98bool 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*/
106bool operator!=(const OctetString& s1, const OctetString& s2)
107 {
108 return !(s1 == s2);
109 }
110
111/*
112* Append Operation for OctetStrings
113*/
115 {
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}
void resize(size_t n)
Definition secmem.h:217
void copy(const T in[], size_t n)
Definition secmem.h:126
void set_odd_parity()
Definition symkey.cpp:47
OctetString(class RandomNumberGenerator &rng, size_t len)
Definition symkey.cpp:20
OctetString & operator^=(const OctetString &other)
Definition symkey.cpp:88
std::string as_string() const
Definition symkey.cpp:80
SecureVector< byte > bits_of() const
Definition symkey.h:30
void change(const std::string &hex_string)
Definition symkey.cpp:29
const byte * begin() const
Definition symkey.h:35
size_t length() const
Definition symkey.h:25
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
void zeroise(MemoryRegion< T > &vec)
Definition secmem.h:428
OctetString operator+(const OctetString &k1, const OctetString &k2)
Definition symkey.cpp:114
void hex_encode(char output[], const byte input[], size_t input_length, bool uppercase)
Definition hex.cpp:14
void xor_buf(byte out[], const byte in[], size_t length)
Definition xor_buf.h:21
bool operator!=(const OctetString &s1, const OctetString &s2)
Definition symkey.cpp:106
OctetString operator^(const OctetString &k1, const OctetString &k2)
Definition symkey.cpp:125
bool operator==(const OctetString &s1, const OctetString &s2)
Definition symkey.cpp:98