src/basic/khash.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2016 Lennart Poettering
   8 ***/
   9
  10 #include <inttypes.h>
  11 #include <sys/types.h>
  12 #include <sys/uio.h>
  13
  14 #include "macro.h"
  15
  16 typedef struct khash khash;
  17
  18 int khash_supported(void);
  19
  20 /* For plain hash functions. Hash functions commonly supported on today's kernels are: crc32c, crct10dif, crc32,
  21  * sha224, sha256, sha512, sha384, sha1, md5, md4, sha3-224, sha3-256, sha3-384, sha3-512, and more. */
  22 int khash_new(khash **ret, const char *algorithm);
  23
  24 /* For keyed hash functions. Hash functions commonly supported on today's kernels are: hmac(sha256), cmac(aes),
  25  * cmac(des3_ede), hmac(sha3-512), hmac(sha3-384), hmac(sha3-256), hmac(sha3-224), hmac(rmd160), hmac(rmd128),
  26  * hmac(sha224), hmac(sha512), hmac(sha384), hmac(sha1), hmac(md5), and more. */
  27 int khash_new_with_key(khash **ret, const char *algorithm, const void *key, size_t key_size);
  28
  29 int khash_dup(khash *h, khash **ret);
  30 khash* khash_unref(khash *h);
  31
  32 const char *khash_get_algorithm(khash *h);
  33 size_t khash_get_size(khash *h);
  34
  35 int khash_reset(khash *h);
  36
  37 int khash_put(khash *h, const void *buffer, size_t size);
  38 int khash_put_iovec(khash *h, const struct iovec *iovec, size_t n);
  39
  40 int khash_digest_data(khash *h, const void **ret);
  41 int khash_digest_string(khash *h, char **ret);
  42
  43 DEFINE_TRIVIAL_CLEANUP_FUNC(khash*, khash_unref);