math/mpreduce.h: Missing include files.
[u/mdw/catacomb] / symm / xtea.h
CommitLineData
ea937a0e 1/* -*-c-*-
2 *
ffd4d6a3 3 * The Extended Tiny Encryption Algorithm
ea937a0e 4 *
5 * (c) 2000 Straylight/Edgeware
6 */
7
45c0fd36 8/*----- Licensing notice --------------------------------------------------*
ea937a0e 9 *
10 * This file is part of Catacomb.
11 *
12 * Catacomb is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU Library General Public License as
14 * published by the Free Software Foundation; either version 2 of the
15 * License, or (at your option) any later version.
45c0fd36 16 *
ea937a0e 17 * Catacomb is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU Library General Public License for more details.
45c0fd36 21 *
ea937a0e 22 * You should have received a copy of the GNU Library General Public
23 * License along with Catacomb; if not, write to the Free
24 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
25 * MA 02111-1307, USA.
26 */
27
ea937a0e 28/*----- Notes on the Tiny Encryption Algorithm ----------------------------*
29 *
30 * XTEA is an amazingly simple 64-round Feistel network. It's tiny, fairly
31 * quick and surprisingly strong. It was invented by David Wheeler and Roger
32 * Needham. It's unpatented. XTEA is a new version of TEA, by the same
33 * designers, which fixes some weaknesses in TEA's key schedule.
34 *
35 * This implementation uses big-endian byte order, following SCAN.
36 */
37
38#ifndef CATACOMB_XTEA_H
39#define CATACOMB_XTEA_H
40
41#ifdef __cplusplus
42 extern "C" {
43#endif
44
45/*----- Header files ------------------------------------------------------*/
46
47#include <stddef.h>
48
49#include <mLib/bits.h>
50
51/*----- Magical numbers ---------------------------------------------------*/
52
53#define XTEA_BLKSZ 8
54#define XTEA_KEYSZ 16
55#define XTEA_CLASS (N, B, 64)
56
57extern const octet xtea_keysz[];
58
59/*----- Data structures ---------------------------------------------------*/
60
61typedef struct xtea_ctx {
d36cd240 62 unsigned r;
ea937a0e 63 uint32 k[4];
64} xtea_ctx;
65
66/*----- Functions provided ------------------------------------------------*/
67
68/* --- @xtea_init@ --- *
69 *
45c0fd36
MW
70 * Arguments: @xtea_ctx *k@ = pointer to key block
71 * @const void *buf@ = pointer to key buffer
72 * @size_t sz@ = size of key material
ea937a0e 73 *
45c0fd36 74 * Returns: ---
ea937a0e 75 *
45c0fd36 76 * Use: Initializes an XTEA key buffer. The key buffer may be up to
ea937a0e 77 * 16 bytes long.
78 */
79
80extern void xtea_init(xtea_ctx */*k*/, const void */*buf*/, size_t /*sz*/);
81
82/* --- @xtea_eblk@, @xtea_dblk@ --- *
83 *
45c0fd36
MW
84 * Arguments: @const xtea_ctx *k@ = pointer to key block
85 * @const uint32 s[2]@ = pointer to source block
86 * @uint32 d[2]@ = pointer to xteatination block
ea937a0e 87 *
45c0fd36 88 * Returns: ---
ea937a0e 89 *
45c0fd36 90 * Use: Low-level block encryption and decryption.
ea937a0e 91 */
92
93extern void xtea_eblk(const xtea_ctx */*k*/,
94 const uint32 */*s*/, uint32 */*d*/);
95extern void xtea_dblk(const xtea_ctx */*k*/,
96 const uint32 */*s*/, uint32 */*d*/);
97
98/*----- That's all, folks -------------------------------------------------*/
99
100#ifdef __cplusplus
101 }
102#endif
103
104#endif