GNUnet  0.11.x
crypto_hash.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2001-2013 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  GNUnet is distributed in the hope that it will be useful, but
11  WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19 
20  */
26 #include "platform.h"
27 #include "gnunet_crypto_lib.h"
28 #include "gnunet_strings_lib.h"
29 #include "benchmark.h"
30 #include <gcrypt.h>
31 
32 #define LOG(kind, ...) GNUNET_log_from (kind, "util-crypto-hash", __VA_ARGS__)
33 
34 #define LOG_STRERROR_FILE(kind, syscall, \
35  filename) GNUNET_log_from_strerror_file (kind, \
36  "util-crypto-hash", \
37  syscall, \
38  filename)
39 
40 void
41 GNUNET_CRYPTO_hash (const void *block,
42  size_t size,
43  struct GNUNET_HashCode *ret)
44 {
45  BENCHMARK_START (hash);
46  gcry_md_hash_buffer (GCRY_MD_SHA512, ret, block, size);
47  BENCHMARK_END (hash);
48 }
49 
50 
51 /* ***************** binary-ASCII encoding *************** */
52 
53 
54 void
57 {
58  char *np;
59 
60  np = GNUNET_STRINGS_data_to_string ((const unsigned char *) block,
61  sizeof(struct GNUNET_HashCode),
62  (char *) result,
63  sizeof(struct
65  - 1);
66  GNUNET_assert (NULL != np);
67  *np = '\0';
68 }
69 
70 
73  size_t enclen,
74  struct GNUNET_HashCode *result)
75 {
76  char upper_enc[enclen];
77  char *up_ptr = upper_enc;
78 
80 
81  return GNUNET_STRINGS_string_to_data (upper_enc, enclen,
82  (unsigned char *) result,
83  sizeof(struct GNUNET_HashCode));
84 }
85 
86 
87 unsigned int
89  const struct GNUNET_HashCode *b)
90 {
91  unsigned int x1 = (a->bits[1] - b->bits[1]) >> 16;
92  unsigned int x2 = (b->bits[1] - a->bits[1]) >> 16;
93 
94  return(x1 * x2);
95 }
96 
97 
98 void
100  struct GNUNET_HashCode *result)
101 {
102  for (ssize_t i = (sizeof(struct GNUNET_HashCode) / sizeof(uint32_t)) - 1;
103  i >= 0;
104  i--)
105  result->bits[i] = GNUNET_CRYPTO_random_u32 (mode, UINT32_MAX);
106 }
107 
108 
109 void
111  const struct GNUNET_HashCode *b,
112  struct GNUNET_HashCode *result)
113 {
114  for (ssize_t i = (sizeof(struct GNUNET_HashCode) / sizeof(unsigned int)) - 1;
115  i >= 0;
116  i--)
117  result->bits[i] = b->bits[i] - a->bits[i];
118 }
119 
120 
121 void
123  const struct GNUNET_HashCode *delta, struct
125 {
126  for (ssize_t i = (sizeof(struct GNUNET_HashCode) / sizeof(unsigned int)) - 1;
127  i >= 0;
128  i--)
129  result->bits[i] = delta->bits[i] + a->bits[i];
130 }
131 
132 
133 void
135  const struct GNUNET_HashCode *b,
136  struct GNUNET_HashCode *result)
137 {
138  const unsigned long long *lla = (const unsigned long long *) a;
139  const unsigned long long *llb = (const unsigned long long *) b;
140  unsigned long long *llr = (unsigned long long *) result;
141 
142  GNUNET_static_assert (8 == sizeof (unsigned long long));
143  GNUNET_static_assert (0 == sizeof (*a) % sizeof (unsigned long long));
144  for (int i = sizeof (*result) / sizeof (*llr) - 1; i>=0; i--)
145  llr[i] = lla[i] ^ llb[i];
146 }
147 
148 
149 void
151  const struct GNUNET_HashCode *hc,
154 {
157  skey,
158  sizeof(struct GNUNET_CRYPTO_SymmetricSessionKey),
159  "Hash key derivation",
160  strlen ("Hash key derivation"),
161  hc, sizeof(struct GNUNET_HashCode),
162  NULL, 0));
165  iv,
167  "Initialization vector derivation",
168  strlen ("Initialization vector derivation"),
169  hc, sizeof(struct GNUNET_HashCode),
170  NULL, 0));
171 }
172 
173 
174 unsigned int
176 {
177  const unsigned long long *llp = (const unsigned long long *) h;
178  unsigned int ret = 0;
179  unsigned int i;
180 
181  GNUNET_static_assert (8 == sizeof (unsigned long long));
182  GNUNET_static_assert (0 == sizeof (*h) % sizeof (unsigned long long));
183  for (i = 0; i<sizeof (*h) / sizeof (*llp); i++)
184  {
185  if (0LLU != llp[i])
186  break;
187  ret += sizeof (*llp) * 8;
188  }
189  if (ret == 8 * sizeof (*h))
190  return ret;
191  ret += __builtin_clzll (GNUNET_ntohll ((uint64_t) llp[i]));
192  return ret;
193 }
194 
195 
196 unsigned int
198 {
199  const unsigned long long *llp = (const unsigned long long *) h;
200  unsigned int ret = 0;
201  int i;
202 
203  GNUNET_static_assert (8 == sizeof (unsigned long long));
204  GNUNET_static_assert (0 == sizeof (*h) % sizeof (unsigned long long));
205  for (i = sizeof (*h) / sizeof (*llp) - 1; i>=0; i--)
206  {
207  if (0LLU != llp[i])
208  break;
209  ret += sizeof (*llp) * 8;
210  }
211  if (ret == 8 * sizeof (*h))
212  return ret;
213  ret += __builtin_ctzll (GNUNET_ntohll ((uint64_t) llp[i]));
214  return ret;
215 }
216 
217 
218 int
220  const struct GNUNET_HashCode *h2)
221 {
222  unsigned int *i1;
223  unsigned int *i2;
224 
225  i1 = (unsigned int *) h1;
226  i2 = (unsigned int *) h2;
227  for (ssize_t i = (sizeof(struct GNUNET_HashCode) / sizeof(unsigned int)) - 1;
228  i >= 0;
229  i--)
230  {
231  if (i1[i] > i2[i])
232  return 1;
233  if (i1[i] < i2[i])
234  return -1;
235  }
236  return 0;
237 }
238 
239 
240 int
242  const struct GNUNET_HashCode *h2,
243  const struct GNUNET_HashCode *target)
244 {
245  const unsigned long long *l1 = (const unsigned long long *) h1;
246  const unsigned long long *l2 = (const unsigned long long *) h2;
247  const unsigned long long *t = (const unsigned long long *) target;
248 
249  GNUNET_static_assert (0 == sizeof (*h1) % sizeof (*l1));
250  for (size_t i = 0; i < sizeof(*h1) / sizeof(*l1); i++)
251  {
252  unsigned long long x1 = l1[i] ^ t[i];
253  unsigned long long x2 = l2[i] ^ t[i];
254 
255  if (x1 > x2)
256  return 1;
257  if (x1 < x2)
258  return -1;
259  }
260  return 0;
261 }
262 
263 
264 void
266  struct GNUNET_CRYPTO_AuthKey *key,
267  const struct GNUNET_CRYPTO_SymmetricSessionKey *rkey,
268  const void *salt, size_t salt_len,
269  ...)
270 {
271  va_list argp;
272 
273  va_start (argp,
274  salt_len);
276  rkey,
277  salt, salt_len,
278  argp);
279  va_end (argp);
280 }
281 
282 
283 void
285  struct GNUNET_CRYPTO_AuthKey *key,
286  const struct GNUNET_CRYPTO_SymmetricSessionKey *rkey,
287  const void *salt, size_t salt_len,
288  va_list argp)
289 {
290  GNUNET_CRYPTO_kdf_v (key->key, sizeof(key->key),
291  salt, salt_len,
292  rkey, sizeof(struct GNUNET_CRYPTO_SymmetricSessionKey),
293  argp);
294 }
295 
296 
297 void
298 GNUNET_CRYPTO_hmac_raw (const void *key, size_t key_len,
299  const void *plaintext, size_t plaintext_len,
300  struct GNUNET_HashCode *hmac)
301 {
302  static int once;
303  static gcry_md_hd_t md;
304  const unsigned char *mc;
305 
306  if (! once)
307  {
308  once = 1;
309  GNUNET_assert (GPG_ERR_NO_ERROR ==
310  gcry_md_open (&md,
311  GCRY_MD_SHA512,
312  GCRY_MD_FLAG_HMAC));
313  }
314  else
315  {
316  gcry_md_reset (md);
317  }
318  gcry_md_setkey (md, key, key_len);
319  gcry_md_write (md, plaintext, plaintext_len);
320  mc = gcry_md_read (md, GCRY_MD_SHA512);
321  GNUNET_assert (NULL != mc);
322  GNUNET_memcpy (hmac->bits, mc, sizeof(hmac->bits));
323 }
324 
325 
326 void
328  const void *plaintext, size_t plaintext_len,
329  struct GNUNET_HashCode *hmac)
330 {
331  GNUNET_CRYPTO_hmac_raw ((void *) key->key, sizeof(key->key),
332  plaintext, plaintext_len,
333  hmac);
334 }
335 
336 
338 {
342  gcry_md_hd_t hd;
343 };
344 
345 
346 struct GNUNET_HashContext *
348 {
349  struct GNUNET_HashContext *hc;
350 
351  BENCHMARK_START (hash_context_start);
352  hc = GNUNET_new (struct GNUNET_HashContext);
353  GNUNET_assert (0 ==
354  gcry_md_open (&hc->hd,
355  GCRY_MD_SHA512,
356  0));
357  BENCHMARK_END (hash_context_start);
358  return hc;
359 }
360 
361 
362 void
364  const void *buf,
365  size_t size)
366 {
367  BENCHMARK_START (hash_context_read);
368  gcry_md_write (hc->hd, buf, size);
369  BENCHMARK_END (hash_context_read);
370 }
371 
372 
373 struct GNUNET_HashContext *
375 {
376  struct GNUNET_HashContext *cp;
377 
378  cp = GNUNET_new (struct GNUNET_HashContext);
379  GNUNET_assert (0 ==
380  gcry_md_copy (&cp->hd,
381  hc->hd));
382  return cp;
383 }
384 
385 
386 void
388  struct GNUNET_HashCode *r_hash)
389 {
390  const void *res = gcry_md_read (hc->hd, 0);
391 
392  BENCHMARK_START (hash_context_finish);
393 
394  GNUNET_assert (NULL != res);
395  if (NULL != r_hash)
396  GNUNET_memcpy (r_hash,
397  res,
398  sizeof(struct GNUNET_HashCode));
400  BENCHMARK_END (hash_context_finish);
401 }
402 
403 
404 void
406 {
407  gcry_md_close (hc->hd);
408  GNUNET_free (hc);
409 }
410 
411 
412 /* end of crypto_hash.c */
benchmarking for various operations
#define BENCHMARK_START(opname)
Definition: benchmark.h:57
#define BENCHMARK_END(opname)
Definition: benchmark.h:58
unsigned int GNUNET_CRYPTO_hash_count_leading_zeros(const struct GNUNET_HashCode *h)
Count the number of leading 0 bits in h.
Definition: crypto_hash.c:175
struct GNUNET_HashContext * GNUNET_CRYPTO_hash_context_start()
Start incremental hashing operation.
Definition: crypto_hash.c:347
void GNUNET_CRYPTO_hash_context_read(struct GNUNET_HashContext *hc, const void *buf, size_t size)
Add data to be hashed.
Definition: crypto_hash.c:363
void GNUNET_CRYPTO_hash_context_abort(struct GNUNET_HashContext *hc)
Abort hashing, do not bother calculating final result.
Definition: crypto_hash.c:405
struct GNUNET_HashContext * GNUNET_CRYPTO_hash_context_copy(const struct GNUNET_HashContext *hc)
Make a copy of the hash computation.
Definition: crypto_hash.c:374
void GNUNET_CRYPTO_hash_context_finish(struct GNUNET_HashContext *hc, struct GNUNET_HashCode *r_hash)
Finish the hash computation.
Definition: crypto_hash.c:387
unsigned int GNUNET_CRYPTO_hash_count_tailing_zeros(const struct GNUNET_HashCode *h)
Count the number of tailing 0 bits in h.
Definition: crypto_hash.c:197
void GNUNET_CRYPTO_hmac_raw(const void *key, size_t key_len, const void *plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
Calculate HMAC of a message (RFC 2104) TODO: Shouldn' this be the standard hmac function and the abov...
Definition: crypto_hash.c:298
static int once
Global to mark if we've run the initialization.
Definition: gnsrecord.c:68
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
static struct GNUNET_ARM_Handle * h
Connection with ARM.
Definition: gnunet-arm.c:99
static int res
struct GNUNET_HashCode key
The key used in the DHT.
static OpusEncoder * enc
OPUS encoder.
static struct GNUNET_TESTBED_Controller * mc
Handle to the master controller.
static int result
Global testing status.
static struct GNUNET_CRYPTO_PowSalt salt
Salt for PoW calcualations.
static char buf[2048]
static struct GNUNET_SCHEDULER_Task * t
Main task.
uint64_t GNUNET_ntohll(uint64_t n)
Convert unsigned 64-bit integer to host byte order.
Definition: common_endian.c:53
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
GNUNET_GenericReturnValue
Named constants for return values.
Definition: gnunet_common.h:92
@ GNUNET_YES
Definition: gnunet_common.h:97
#define GNUNET_static_assert(cond)
Assertion to be checked (if supported by C compiler) at compile time, otherwise checked at runtime an...
cryptographic primitives for GNUnet
enum GNUNET_GenericReturnValue GNUNET_CRYPTO_kdf_v(void *result, size_t out_len, const void *xts, size_t xts_len, const void *skm, size_t skm_len, va_list argp)
Derive key.
Definition: crypto_kdf.c:47
static enum @8 mode
Should we do a PUT (mode = 0) or GET (mode = 1);.
GNUNET_CRYPTO_Quality
Desired quality level for random numbers.
uint32_t GNUNET_CRYPTO_random_u32(enum GNUNET_CRYPTO_Quality mode, uint32_t i)
Produce a random value.
void GNUNET_CRYPTO_hash_difference(const struct GNUNET_HashCode *a, const struct GNUNET_HashCode *b, struct GNUNET_HashCode *result)
compute result = b - a
Definition: crypto_hash.c:110
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:41
void GNUNET_CRYPTO_hash_to_enc(const struct GNUNET_HashCode *block, struct GNUNET_CRYPTO_HashAsciiEncoded *result)
Convert hash to ASCII encoding.
Definition: crypto_hash.c:55
void GNUNET_CRYPTO_hash_create_random(enum GNUNET_CRYPTO_Quality mode, struct GNUNET_HashCode *result)
Create a random hash code.
Definition: crypto_hash.c:99
void GNUNET_CRYPTO_hmac(const struct GNUNET_CRYPTO_AuthKey *key, const void *plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
Calculate HMAC of a message (RFC 2104)
Definition: crypto_hash.c:327
void GNUNET_CRYPTO_hash_sum(const struct GNUNET_HashCode *a, const struct GNUNET_HashCode *delta, struct GNUNET_HashCode *result)
compute result = a + delta
Definition: crypto_hash.c:122
void GNUNET_CRYPTO_hash_xor(const struct GNUNET_HashCode *a, const struct GNUNET_HashCode *b, struct GNUNET_HashCode *result)
compute result = a ^ b
Definition: crypto_hash.c:134
int GNUNET_CRYPTO_hash_xorcmp(const struct GNUNET_HashCode *h1, const struct GNUNET_HashCode *h2, const struct GNUNET_HashCode *target)
Find out which of the two GNUNET_CRYPTO_hash codes is closer to target in the XOR metric (Kademlia).
Definition: crypto_hash.c:241
void GNUNET_CRYPTO_hmac_derive_key_v(struct GNUNET_CRYPTO_AuthKey *key, const struct GNUNET_CRYPTO_SymmetricSessionKey *rkey, const void *salt, size_t salt_len, va_list argp)
Derive an authentication key.
Definition: crypto_hash.c:284
enum GNUNET_GenericReturnValue GNUNET_CRYPTO_hash_from_string2(const char *enc, size_t enclen, struct GNUNET_HashCode *result)
Convert ASCII encoding back to a 'struct GNUNET_HashCode'.
Definition: crypto_hash.c:72
int GNUNET_CRYPTO_hash_cmp(const struct GNUNET_HashCode *h1, const struct GNUNET_HashCode *h2)
Compare function for HashCodes, producing a total ordering of all hashcodes.
Definition: crypto_hash.c:219
unsigned int GNUNET_CRYPTO_hash_distance_u32(const struct GNUNET_HashCode *a, const struct GNUNET_HashCode *b)
Compute the distance between 2 hashcodes.
Definition: crypto_hash.c:88
enum GNUNET_GenericReturnValue GNUNET_CRYPTO_kdf(void *result, size_t out_len, const void *xts, size_t xts_len, const void *skm, size_t skm_len,...)
Derive key.
Definition: crypto_kdf.c:90
void GNUNET_CRYPTO_hmac_derive_key(struct GNUNET_CRYPTO_AuthKey *key, const struct GNUNET_CRYPTO_SymmetricSessionKey *rkey, const void *salt, size_t salt_len,...)
Derive an authentication key.
Definition: crypto_hash.c:265
void GNUNET_CRYPTO_hash_to_aes_key(const struct GNUNET_HashCode *hc, struct GNUNET_CRYPTO_SymmetricSessionKey *skey, struct GNUNET_CRYPTO_SymmetricInitializationVector *iv)
Convert a hashcode into a key.
Definition: crypto_hash.c:150
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
char * GNUNET_STRINGS_data_to_string(const void *data, size_t size, char *out, size_t out_size)
Convert binary data to ASCII encoding using CrockfordBase32.
Definition: strings.c:682
enum GNUNET_GenericReturnValue GNUNET_STRINGS_string_to_data(const char *enc, size_t enclen, void *out, size_t out_size)
Convert CrockfordBase32 encoding back to data.
Definition: strings.c:762
void GNUNET_STRINGS_utf8_toupper(const char *input, char *output)
Convert the utf-8 input string to upper case.
Definition: strings.c:449
static unsigned int size
Size of the "table".
Definition: peer.c:67
static struct GNUNET_TIME_Relative delta
Definition: speedup.c:35
type for (message) authentication keys
0-terminated ASCII encoding of a struct GNUNET_HashCode.
A 512-bit hashcode.
uint32_t bits[512/8/sizeof(uint32_t)]
gcry_md_hd_t hd
Internal state of the hash function.
Definition: crypto_hash.c:342