gsasl  1.8.0
digest.h
Go to the documentation of this file.
00001 /* digest.h --- Generate a CRAM-MD5 hex encoded HMAC-MD5 response string.
00002  * Copyright (C) 2002-2012 Simon Josefsson
00003  *
00004  * This file is part of GNU SASL Library.
00005  *
00006  * GNU SASL Library is free software; you can redistribute it and/or
00007  * modify it under the terms of the GNU Lesser General Public License
00008  * as published by the Free Software Foundation; either version 2.1 of
00009  * the License, or (at your option) any later version.
00010  *
00011  * GNU SASL Library is distributed in the hope that it will be useful,
00012  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00013  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00014  * Lesser General Public License for more details.
00015  *
00016  * You should have received a copy of the GNU Lesser General Public
00017  * License along with GNU SASL Library; if not, write to the Free
00018  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00019  * Boston, MA 02110-1301, USA.
00020  *
00021  */
00022 
00023 #ifndef DIGEST_H
00024 #define DIGEST_H
00025 
00026 /* Get size_t. */
00027 #include <stddef.h>
00028 
00029 #define CRAM_MD5_DIGEST_LEN 32
00030 
00031 /* Compute hex encoded HMAC-MD5 on the CHALLENGELEN long string
00032    CHALLENGE, keyed with SECRET of length SECRETLEN.  Use a
00033    CHALLENGELEN or SECRETLEN of 0 to indicate that CHALLENGE or
00034    SECRET, respectively, is zero terminated.  The RESPONSE buffer must
00035    be allocated by the caller, and must have room for
00036    CRAM_MD5_DIGEST_LEN characters.*/
00037 extern void cram_md5_digest (const char *challenge,
00038                              size_t challengelen,
00039                              const char *secret,
00040                              size_t secretlen,
00041                              char response[CRAM_MD5_DIGEST_LEN]);
00042 
00043 #endif /* DIGEST_H */