lib/cram-md5/digest.h

   1 /* digest.h --- Generate a CRAM-MD5 hex encoded HMAC-MD5 response string.
   2  * Copyright (C) 2002, 2003, 2004  Simon Josefsson
   3  *
   4  * This file is part of GNU SASL Library.
   5  *
   6  * GNU SASL Library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public License
   8  * as published by the Free Software Foundation; either version 2.1 of
   9  * the License, or (at your option) any later version.
  10  *
  11  * GNU SASL Library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with GNU SASL Library; if not, write to the Free
  18  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  19  * Boston, MA 02110-1301, USA.
  20  *
  21  */
  22
  23 #ifndef DIGEST_H
  24 # define DIGEST_H
  25
  26 /* Get size_t. */
  27 #include <stddef.h>
  28
  29 # define CRAM_MD5_DIGEST_LEN 32
  30
  31 /* Compute hex encoded HMAC-MD5 on the CHALLENGELEN long string
  32    CHALLENGE, keyed with SECRET of length SECRETLEN.  Use a
  33    CHALLENGELEN or SECRETLEN of 0 to indicate that CHALLENGE or
  34    SECRET, respectively, is zero terminated.  The RESPONSE buffer must
  35    be allocated by the caller, and must have room for
  36    CRAM_MD5_DIGEST_LEN characters.*/
  37 extern void cram_md5_digest (const char *challenge,
  38                              size_t challengelen,
  39                              const char *secret,
  40                              size_t secretlen,
  41                              char response[CRAM_MD5_DIGEST_LEN]);
  42
  43 #endif /* DIGEST_H */