xref: /openbsd/include/blf.h (revision 832bedbc)
1 /* $OpenBSD: blf.h,v 1.8 2021/11/29 01:04:45 djm Exp $ */
2 /*
3  * Blowfish - a fast block cipher designed by Bruce Schneier
4  *
5  * Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de>
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 3. 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 _BLF_H_
32 #define _BLF_H_
33 
34 /* Schneier specifies a maximum key length of 56 bytes.
35  * This ensures that every key bit affects every cipher
36  * bit.  However, the subkeys can hold up to 72 bytes.
37  * Warning: For normal blowfish encryption only 56 bytes
38  * of the key affect all cipherbits.
39  */
40 
41 #define BLF_N	16			/* Number of Subkeys */
42 #define BLF_MAXKEYLEN ((BLF_N-2)*4)	/* 448 bits */
43 #define BLF_MAXUTILIZED ((BLF_N+2)*4)	/* 576 bits */
44 
45 /* Blowfish context */
46 typedef struct BlowfishContext {
47 	u_int32_t S[4][256];	/* S-Boxes */
48 	u_int32_t P[BLF_N + 2];	/* Subkeys */
49 } blf_ctx;
50 
51 /* Raw access to customized Blowfish
52  *	blf_key is just:
53  *	Blowfish_initstate( state )
54  *	Blowfish_expand0state( state, key, keylen )
55  */
56 
57 void Blowfish_encipher(blf_ctx *, u_int32_t *, u_int32_t *);
58 void Blowfish_decipher(blf_ctx *, u_int32_t *, u_int32_t *);
59 void Blowfish_initstate(blf_ctx *);
60 void Blowfish_expand0state(blf_ctx *, const u_int8_t *, u_int16_t);
61 void Blowfish_expandstate
62 (blf_ctx *, const u_int8_t *, u_int16_t, const u_int8_t *, u_int16_t);
63 
64 /* Standard Blowfish */
65 
66 void blf_key(blf_ctx *, const u_int8_t *, u_int16_t);
67 void blf_enc(blf_ctx *, u_int32_t *, u_int16_t);
68 void blf_dec(blf_ctx *, u_int32_t *, u_int16_t);
69 
70 void blf_ecb_encrypt(blf_ctx *, u_int8_t *, u_int32_t);
71 void blf_ecb_decrypt(blf_ctx *, u_int8_t *, u_int32_t);
72 
73 void blf_cbc_encrypt(blf_ctx *, u_int8_t *, u_int8_t *, u_int32_t);
74 void blf_cbc_decrypt(blf_ctx *, u_int8_t *, u_int8_t *, u_int32_t);
75 
76 /* Converts u_int8_t to u_int32_t */
77 u_int32_t Blowfish_stream2word(const u_int8_t *, u_int16_t , u_int16_t *);
78 
79 #endif
80