2 * Copyright 2009 Colin Percival
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
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.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * This file was originally written by Colin Percival as part of the Tarsnap
27 * online backup system.
29 #ifndef _CRYPTO_AESCTR_H_
30 #define _CRYPTO_AESCTR_H_
34 #include <openssl/aes.h>
37 * crypto_aesctr_init(key, nonce):
38 * Prepare to encrypt/decrypt data with AES in CTR mode, using the provided
39 * expanded key and nonce. The key provided must remain valid for the
40 * lifetime of the stream.
42 struct crypto_aesctr * crypto_aesctr_init(AES_KEY *, uint64_t);
45 * crypto_aesctr_stream(stream, inbuf, outbuf, buflen):
46 * Generate the next ${buflen} bytes of the AES-CTR stream and xor them with
47 * bytes from ${inbuf}, writing the result into ${outbuf}. If the buffers
48 * ${inbuf} and ${outbuf} overlap, they must be identical.
50 void crypto_aesctr_stream(struct crypto_aesctr *, const uint8_t *,
54 * crypto_aesctr_free(stream):
55 * Free the provided stream object.
57 void crypto_aesctr_free(struct crypto_aesctr *);
59 #endif /* !_CRYPTO_AESCTR_H_ */