pbkdf2.h 2.38 KB
Newer Older
Niels Möller's avatar
Niels Möller committed
1
/* pbkdf2.h
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

   PKCS #5 password-based key derivation function PBKDF2, see RFC 2898.

   Copyright (C) 2012 Simon Josefsson

   This file is part of GNU Nettle.

   GNU Nettle is free software: you can redistribute it and/or
   modify it under the terms of either:

     * the GNU Lesser General Public License as published by the Free
       Software Foundation; either version 3 of the License, or (at your
       option) any later version.

   or

     * the GNU General Public License as published by the Free
       Software Foundation; either version 2 of the License, or (at your
       option) any later version.

   or both in parallel, as here.

   GNU Nettle is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   General Public License for more details.

   You should have received copies of the GNU General Public License and
   the GNU Lesser General Public License along with this program.  If
   not, see http://www.gnu.org/licenses/.
*/
Simon Josefsson's avatar
Simon Josefsson committed
33 34 35 36 37 38 39 40 41 42 43 44 45

#ifndef NETTLE_PBKDF2_H_INCLUDED
#define NETTLE_PBKDF2_H_INCLUDED

#include "nettle-meta.h"

#ifdef __cplusplus
extern "C"
{
#endif

/* Namespace mangling */
#define pbkdf2 nettle_pbkdf2
46 47
#define pbkdf2_hmac_sha1 nettle_pbkdf2_hmac_sha1
#define pbkdf2_hmac_sha256 nettle_pbkdf2_hmac_sha256
Simon Josefsson's avatar
Simon Josefsson committed
48 49

void
Niels Möller's avatar
Niels Möller committed
50
pbkdf2 (void *mac_ctx,
Simon Josefsson's avatar
Simon Josefsson committed
51 52
	nettle_hash_update_func *update,
	nettle_hash_digest_func *digest,
Niels Möller's avatar
Niels Möller committed
53 54 55
	size_t digest_size, unsigned iterations,
	size_t salt_length, const uint8_t *salt,
	size_t length, uint8_t *dst);
Simon Josefsson's avatar
Simon Josefsson committed
56

Niels Möller's avatar
Niels Möller committed
57 58
#define PBKDF2(ctx, update, digest, digest_size,			\
	       iterations, salt_length, salt, length, dst)		\
59
  (0 ? ((update)((ctx), 0, (uint8_t *) 0),				\
Simon Josefsson's avatar
Simon Josefsson committed
60
	(digest)((ctx), 0, (uint8_t *) 0))				\
Niels Möller's avatar
Niels Möller committed
61
   : pbkdf2 ((ctx),							\
Simon Josefsson's avatar
Simon Josefsson committed
62 63
	     (nettle_hash_update_func *)(update),			\
	     (nettle_hash_digest_func *)(digest),			\
Niels Möller's avatar
Niels Möller committed
64 65
	     (digest_size), (iterations),				\
	     (salt_length), (salt), (length), (dst)))
Simon Josefsson's avatar
Simon Josefsson committed
66

67 68 69
/* PBKDF2 with specific PRFs. */

void
Niels Möller's avatar
Niels Möller committed
70
pbkdf2_hmac_sha1 (size_t key_length, const uint8_t *key,
71
		  unsigned iterations,
Niels Möller's avatar
Niels Möller committed
72 73
		  size_t salt_length, const uint8_t *salt,
		  size_t length, uint8_t *dst);
74 75

void
Niels Möller's avatar
Niels Möller committed
76
pbkdf2_hmac_sha256 (size_t key_length, const uint8_t *key,
77
		    unsigned iterations,
Niels Möller's avatar
Niels Möller committed
78 79
		    size_t salt_length, const uint8_t *salt,
		    size_t length, uint8_t *dst);
80

Simon Josefsson's avatar
Simon Josefsson committed
81 82 83 84 85
#ifdef __cplusplus
}
#endif

#endif /* NETTLE_PBKDF2_H_INCLUDED */