lib/util/data_blob.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Easy management of byte-length data
   4    Copyright (C) Andrew Tridgell 2001
   5    Copyright (C) Andrew Bartlett 2001
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 */
  20
  21 #include "includes.h"
  22
  23 const DATA_BLOB data_blob_null = { NULL, 0 };
  24
  25 /**
  26  * @file
  27  * @brief Manipulation of arbitrary data blobs
  28  **/
  29
  30 /**
  31  construct a data blob, must be freed with data_blob_free()
  32  you can pass NULL for p and get a blank data blob
  33 **/
  34 _PUBLIC_ DATA_BLOB data_blob_named(const void *p, size_t length, const char *name)
  35 {
  36         DATA_BLOB ret;
  37
  38         if (p == NULL && length == 0) {
  39                 ZERO_STRUCT(ret);
  40                 return ret;
  41         }
  42
  43         if (p) {
  44                 ret.data = (uint8_t *)talloc_memdup(NULL, p, length);
  45         } else {
  46                 ret.data = talloc_array(NULL, uint8_t, length);
  47         }
  48         if (ret.data == NULL) {
  49                 ret.length = 0;
  50                 return ret;
  51         }
  52         talloc_set_name_const(ret.data, name);
  53         ret.length = length;
  54         return ret;
  55 }
  56
  57 /**
  58  construct a data blob, using supplied TALLOC_CTX
  59 **/
  60 _PUBLIC_ DATA_BLOB data_blob_talloc_named(TALLOC_CTX *mem_ctx, const void *p, size_t length, const char *name)
  61 {
  62         DATA_BLOB ret = data_blob_named(p, length, name);
  63
  64         if (ret.data) {
  65                 talloc_steal(mem_ctx, ret.data);
  66         }
  67         return ret;
  68 }
  69
  70 /**
  71  construct a zero data blob, using supplied TALLOC_CTX.
  72  use this sparingly as it initialises data - better to initialise
  73  yourself if you want specific data in the blob
  74 **/
  75 _PUBLIC_ DATA_BLOB data_blob_talloc_zero(TALLOC_CTX *mem_ctx, size_t length)
  76 {
  77         DATA_BLOB blob = data_blob_talloc(mem_ctx, NULL, length);
  78         data_blob_clear(&blob);
  79         return blob;
  80 }
  81
  82 /**
  83 free a data blob
  84 **/
  85 _PUBLIC_ void data_blob_free(DATA_BLOB *d)
  86 {
  87         if (d) {
  88                 talloc_free(d->data);
  89                 d->data = NULL;
  90                 d->length = 0;
  91         }
  92 }
  93
  94 /**
  95 clear a DATA_BLOB's contents
  96 **/
  97 _PUBLIC_ void data_blob_clear(DATA_BLOB *d)
  98 {
  99         if (d->data) {
 100                 memset(d->data, 0, d->length);
 101         }
 102 }
 103
 104 /**
 105 free a data blob and clear its contents
 106 **/
 107 _PUBLIC_ void data_blob_clear_free(DATA_BLOB *d)
 108 {
 109         data_blob_clear(d);
 110         data_blob_free(d);
 111 }
 112
 113
 114 /**
 115 check if two data blobs are equal
 116 **/
 117 _PUBLIC_ int data_blob_cmp(const DATA_BLOB *d1, const DATA_BLOB *d2)
 118 {
 119         int ret;
 120         if (d1->data == NULL && d2->data != NULL) {
 121                 return -1;
 122         }
 123         if (d1->data != NULL && d2->data == NULL) {
 124                 return 1;
 125         }
 126         if (d1->data == d2->data) {
 127                 return d1->length - d2->length;
 128         }
 129         ret = memcmp(d1->data, d2->data, MIN(d1->length, d2->length));
 130         if (ret == 0) {
 131                 return d1->length - d2->length;
 132         }
 133         return ret;
 134 }
 135
 136 /**
 137 print the data_blob as hex string
 138 **/
 139 _PUBLIC_ char *data_blob_hex_string_lower(TALLOC_CTX *mem_ctx, const DATA_BLOB *blob)
 140 {
 141         int i;
 142         char *hex_string;
 143
 144         hex_string = talloc_array(mem_ctx, char, (blob->length*2)+1);
 145         if (!hex_string) {
 146                 return NULL;
 147         }
 148
 149         /* this must be lowercase or w2k8 cannot join a samba domain,
 150            as this routine is used to encode extended DNs and windows
 151            only accepts lowercase hexadecimal numbers */
 152         for (i = 0; i < blob->length; i++)
 153                 slprintf(&hex_string[i*2], 3, "%02x", blob->data[i]);
 154
 155         hex_string[(blob->length*2)] = '\0';
 156         return hex_string;
 157 }
 158
 159 _PUBLIC_ char *data_blob_hex_string_upper(TALLOC_CTX *mem_ctx, const DATA_BLOB *blob)
 160 {
 161         int i;
 162         char *hex_string;
 163
 164         hex_string = talloc_array(mem_ctx, char, (blob->length*2)+1);
 165         if (!hex_string) {
 166                 return NULL;
 167         }
 168
 169         for (i = 0; i < blob->length; i++)
 170                 slprintf(&hex_string[i*2], 3, "%02X", blob->data[i]);
 171
 172         hex_string[(blob->length*2)] = '\0';
 173         return hex_string;
 174 }
 175
 176 /**
 177   useful for constructing data blobs in test suites, while
 178   avoiding const warnings
 179 **/
 180 _PUBLIC_ DATA_BLOB data_blob_string_const(const char *str)
 181 {
 182         DATA_BLOB blob;
 183         blob.data = discard_const_p(uint8_t, str);
 184         blob.length = str ? strlen(str) : 0;
 185         return blob;
 186 }
 187
 188 /**
 189   useful for constructing data blobs in test suites, while
 190   avoiding const warnings
 191 **/
 192 _PUBLIC_ DATA_BLOB data_blob_string_const_null(const char *str)
 193 {
 194         DATA_BLOB blob;
 195         blob.data = discard_const_p(uint8_t, str);
 196         blob.length = str ? strlen(str)+1 : 0;
 197         return blob;
 198 }
 199
 200 /**
 201  * Create a new data blob from const data
 202  */
 203
 204 _PUBLIC_ DATA_BLOB data_blob_const(const void *p, size_t length)
 205 {
 206         DATA_BLOB blob;
 207         blob.data = discard_const_p(uint8_t, p);
 208         blob.length = length;
 209         return blob;
 210 }
 211
 212
 213 /**
 214   realloc a data_blob
 215 **/
 216 _PUBLIC_ bool data_blob_realloc(TALLOC_CTX *mem_ctx, DATA_BLOB *blob, size_t length)
 217 {
 218         blob->data = talloc_realloc(mem_ctx, blob->data, uint8_t, length);
 219         if (blob->data == NULL)
 220                 return false;
 221         blob->length = length;
 222         return true;
 223 }
 224
 225
 226 /**
 227   append some data to a data blob
 228 **/
 229 _PUBLIC_ bool data_blob_append(TALLOC_CTX *mem_ctx, DATA_BLOB *blob,
 230                                    const void *p, size_t length)
 231 {
 232         size_t old_len = blob->length;
 233         size_t new_len = old_len + length;
 234         if (new_len < length || new_len < old_len) {
 235                 return false;
 236         }
 237
 238         if ((const uint8_t *)p + length < (const uint8_t *)p) {
 239                 return false;
 240         }
 241
 242         if (!data_blob_realloc(mem_ctx, blob, new_len)) {
 243                 return false;
 244         }
 245
 246         memcpy(blob->data + old_len, p, length);
 247         return true;
 248 }
 249