/usr/include/x86_64-linux-gnu/qcc/KeyInfo.h is in liballjoyn-common-dev-1509 15.09a+dfsg.1-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 | #ifndef _QCC_KEYINFO_H
#define _QCC_KEYINFO_H
/**
* @file
*
* This file provide public key info
*/
/******************************************************************************
* Copyright AllSeen Alliance. All rights reserved.
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
******************************************************************************/
#include <qcc/platform.h>
#include <qcc/String.h>
#include <alljoyn/Status.h>
namespace qcc {
/**
* KeyInfo
*/
class KeyInfo {
public:
/**
* KeyInfo format
*/
typedef enum {
FORMAT_ALLJOYN = 0, ///< AllJoyn format
FORMAT_JWK = 1, ///< JSON Web Key format
FORMAT_X509 = 2, ///< X.509 format
} FormatType;
/**
* Key usage
*/
typedef enum {
USAGE_SIGNING = 0, ///< key is used for signing
USAGE_ENCRYPTION = 1 ///< key is used for encryption
} KeyUsageType;
/**
* Default constructor.
*/
KeyInfo(FormatType format) : format(format), keyIdLen(0), keyId(NULL)
{
}
/**
* Default destructor.
*/
virtual ~KeyInfo()
{
delete [] keyId;
}
/**
* Assign the key id
* @param keyID the key id to copy
* @param len the key len
*/
void SetKeyId(const uint8_t* keyID, size_t len)
{
delete [] keyId;
keyId = NULL;
keyIdLen = 0;
if (len == 0) {
return;
}
keyId = new uint8_t[len];
if (keyId == NULL) {
return;
}
keyIdLen = len;
memcpy(keyId, keyID, keyIdLen * sizeof(uint8_t));
}
/**
* Retrieve the key ID.
* @return the key ID. It's a pointer to an internal buffer. Its lifetime is the same as the object's lifetime.
*/
const uint8_t* GetKeyId() const
{
return keyId;
}
/**
* Retrieve the key ID length.
* @return the key ID length.
*/
const size_t GetKeyIdLen() const
{
return keyIdLen;
}
/**
* The required size of the exported byte array.
* @return the required size of the exported byte array
*/
const size_t GetExportSize() const;
/**
* Export the KeyInfo data to a byte array.
* @param[in,out] buf the pointer to a byte array. The caller must allocateenough memory based on call GetExportSize().
* @return ER_OK for success; otherwise, an error code
*/
QStatus Export(uint8_t* buf) const;
/**
* Import a byte array generated by a KeyInfo Export.
* @param buf the export data
* @param count the size of the export data
* @return ER_OK for success; otherwise, an error code
*/
QStatus Import(const uint8_t* buf, size_t count);
/**
* Get the format
* @return the format
*/
const FormatType GetFormat() const
{
return format;
}
/**
* Comparison operators equality
* @param[in] other right hand side KeyInfo
* @return true is keys are equal.
*/
bool operator==(const KeyInfo& other) const
{
if (format != other.format) {
return false;
}
if (keyIdLen != other.keyIdLen) {
return false;
}
if (keyId == NULL || other.keyId == NULL) {
return keyId == other.keyId;
}
if (0 != memcmp(keyId, other.keyId, keyIdLen)) {
return false;
}
return true;
}
/**
* Comparison operators non-equality
* @param[in] other right hand side KeyInfo
* @return true is keys are not equal
*/
bool operator!=(const KeyInfo& other) const
{
return !(*this == other);
}
/**
* Assignment operator is private
*/
KeyInfo& operator=(const KeyInfo& other) {
if (this != &other) {
format = other.format;
keyIdLen = other.keyIdLen;
delete [] keyId;
keyId = new uint8_t[keyIdLen];
memcpy(keyId, other.keyId, keyIdLen);
}
return *this;
}
/**
* Comparison operator less than
* @param[in] other right hand side KeyInfo
* @return true if key is less than the other
*/
bool operator<(const KeyInfo& other) const
{
if (format < other.format) {
return true;
}
if (keyIdLen < other.keyIdLen) {
return true;
}
if (keyId != NULL && other.keyId != NULL && keyIdLen == other.keyIdLen) {
if (0 > memcmp(keyId, other.keyId, keyIdLen)) {
return true;
}
}
return false;
}
/**
* Copy constructor for KeyInfo
*/
KeyInfo(const KeyInfo& other) {
format = other.format;
keyIdLen = other.keyIdLen;
keyId = new uint8_t[keyIdLen];
memcpy(keyId, other.keyId, keyIdLen);
}
private:
FormatType format;
size_t keyIdLen;
uint8_t* keyId;
};
} /* namespace qcc */
#endif
|