git ssb

1
/*
2
 * Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de>
3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 * 1. Redistributions of source code must retain the above copyright
9
 *    notice, this list of conditions and the following disclaimer.
10
 * 2. Redistributions in binary form must reproduce the above copyright
11
 *    notice, this list of conditions and the following disclaimer in the
12
 *    documentation and/or other materials provided with the distribution.
13
 * 3. All advertising materials mentioning features or use of this software
14
 *    must display the following acknowledgement:
15
 *      This product includes software developed by Niels Provos.
16
 * 4. The name of the author may not be used to endorse or promote products
17
 *    derived from this software without specific prior written permission.
18
 *
19
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
24
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
28
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29
 */
30
31
#ifndef _BCRYPT_H_
32
#define _BCRYPT_H_
33
34
#define BCRYPT_VERSION '2'
35
#define BCRYPT_MAXSALT 16	/* Precomputation is just so nice */
36
#define BCRYPT_BLOCKS 6		/* Ciphertext blocks */
37
#define BCRYPT_MINROUNDS 16	/* we have log2(rounds) in salt */
38
#define BCRYPT_SALT_OUTPUT_SIZE  (7 + (BCRYPT_MAXSALT * 4 + 2) / 3 + 1)
39
#define BCRYPT_OUTPUT_SIZE 128
40
41
/*
42
 * Given a logarithmic cost parameter, generates a salt for use with bcrypt().
43
 *
44
 * output: the computed salt will be stored here. This buffer must be
45
 *         at least BCRYPT_SALT_OUTPUT_SIZE bytes. The result will be
46
 *         null-terminated.
47
 * log_rounds: the logarithmic cost.
48
 * rseed: a seed of BCRYPT_MAXSALT bytes. Should be obtained from a
49
 *        cryptographically secure random source.
50
 * Returns: output
51
 */
52
char *bcrypt_gensalt(char *output, u_int8_t log_rounds, u_int8_t *rseed);
53
54
/*
55
 * Given a secret and a salt, generates a salted hash (which you can then store safely).
56
 *
57
 * output: the computed salted hash will be stored here. This buffer must
58
 *         be at least BCRYPT_OUTPUT_SIZE bytes, and will become null-terminated.
59
 * key: A null-terminated secret.
60
 * salt: The salt, as generated by bcrypt_gensalt().
61
 * Returns: output on success, NULL on error.
62
 */
63
char *bcrypt(char *output, const char *key, const char *salt);
64
65
#endif /* _BCRYPT_H_ */
66