glib/ghmac.h

   1 /* ghmac.h - secure data hashing
   2  *
   3  * Copyright (C) 2011  Stef Walter  <stefw@collabora.co.uk>
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Library General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Library General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Library General Public
  16  * License along with this library; if not, write to the
  17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18  * Boston, MA 02111-1307, USA.
  19  */
  20
  21 #if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
  22 #error "Only <glib.h> can be included directly."
  23 #endif
  24
  25 #ifndef __G_HMAC_H__
  26 #define __G_HMAC_H__
  27
  28 #include <glib/gtypes.h>
  29 #include "gchecksum.h"
  30
  31 G_BEGIN_DECLS
  32
  33 /**
  34  * GHmac:
  35  *
  36  * An opaque structure representing a HMAC operation.
  37  * To create a new GHmac, use g_hmac_new(). To free
  38  * a GHmac, use g_hmac_unref().
  39  *
  40  * Since: 2.30
  41  */
  42 typedef struct _GHmac       GHmac;
  43
  44 GHmac *               g_hmac_new                    (GChecksumType  digest_type,
  45                                                      const guchar  *key,
  46                                                      gsize          key_len);
  47 GHmac *               g_hmac_copy                   (const GHmac   *hmac);
  48 GHmac *               g_hmac_ref                    (GHmac         *hmac);
  49 void                  g_hmac_unref                  (GHmac         *hmac);
  50 void                  g_hmac_update                 (GHmac         *hmac,
  51                                                      const guchar  *data,
  52                                                      gssize         length);
  53 const gchar *         g_hmac_get_string             (GHmac         *hmac);
  54 void                  g_hmac_get_digest             (GHmac         *hmac,
  55                                                      guint8        *buffer,
  56                                                      gsize         *digest_len);
  57
  58 gchar                *g_compute_hmac_for_data       (GChecksumType  digest_type,
  59                                                      const guchar  *key,
  60                                                      gsize          key_len,
  61                                                      const guchar  *data,
  62                                                      gsize          length);
  63 gchar                *g_compute_hmac_for_string     (GChecksumType  digest_type,
  64                                                      const guchar  *key,
  65                                                      gsize          key_len,
  66                                                      const gchar   *str,
  67                                                      gssize         length);
  68
  69 G_END_DECLS
  70
  71 #endif /* __G_CHECKSUM_H__ */