3 * $Id: icrypt.h,v 1.2 1997/08/04 10:24:22 mdw Exp $
5 * Higher level IDEA encryption
7 * (c) 1997 Mark Wooding
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of `become'
14 * `Become' is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * `Become' is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with `become'; if not, write to the Free Software Foundation,
26 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 /*----- Revision history --------------------------------------------------*
32 * Revision 1.2 1997/08/04 10:24:22 mdw
33 * Sources placed under CVS control.
35 * Revision 1.1 1997/07/21 13:47:49 mdw
47 /*----- Required headers --------------------------------------------------*/
59 /*----- Type definitions --------------------------------------------------*/
61 /* --- @icrypt_job@ --- */
63 typedef struct icrypt_job
{
64 idea_key k
; /* IDEA key for en/decrypting */
65 int i
; /* Index into the IV buffer */
66 char iv
[IDEA_BLKSIZE
]; /* IV bytes for encrypting */
69 /*----- Functions provided ------------------------------------------------*/
71 /* --- @icrypt_init@ --- *
73 * Arguments: @icrypt_job *j@ = pointer to job context block
74 * @unsigned char *k@ = pointer to key data
75 * @const unsigned char *iv@ = pointer to IV
79 * Use: Primes the context block ready for encryption.
82 extern void icrypt_init(icrypt_job */
*j*/
,
84 const unsigned char */
*iv*/
);
86 /* --- @icrypt_encrypt@ --- *
88 * Arguments: @icrypt_job *j@ = job handle
89 * @const void *src@ = pointer to source buffer
90 * @void *dest@ = pointer to destination buffer
91 * @size_t sz@ = size of buffers to handle
95 * Use: Encrypts data from the source to the destination, using the
96 * key attached to the job handle.
99 extern void icrypt_encrypt(icrypt_job */
*j*/
, const void */
*src*/
,
100 void */
*dest*/
, size_t /*sz*/);
102 /* --- @icrypt_decrypt@ --- *
104 * Arguments: @icrypt_job *j@ = job handle
105 * @const void *src@ = pointer to source buffer
106 * @void *dest@ = pointer to destination buffer
107 * @size_t sz@ = size of buffers to handle
111 * Use: Decrypts data from the source to the destination, using
112 * the key attached to the job handle.
115 extern void icrypt_decrypt(icrypt_job */
*j*/
, const void */
*src*/
,
116 void */
*dest*/
, size_t /*sz*/);
118 /* --- @icrypt_reset@ --- *
120 * Arguments: @icrypt_job *j@ = pointer to job context block
121 * @unsigned char *k@ = pointer to key data, or zero for
123 * @const unsigned char *iv@ = pointer to IV, or zero
127 * Use: Alters the context block. This can be used after recovery
128 * of a session key, for example.
131 extern void icrypt_reset(icrypt_job */
*j*/
,
132 unsigned char */
*k*/
,
133 const unsigned char */
*iv*/
);
135 /* --- @icrypt_saveIV@ --- *
137 * Arguments: @icrypt_job *j@ = pointer to job context block
138 * @unsigned char *iv@ = where to store the IV
142 * Use: Writes out the job's IV after munging it a little.
145 extern void icrypt_saveIV(icrypt_job */
*j*/
, unsigned char */
*iv*/
);
147 /*----- That's all, folks -------------------------------------------------*/