xref: /linux/include/crypto/chacha20poly1305.h (revision 7fc2cd2e4b398c57c9cf961cfea05eadbf34c05c)
1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */
2 /*
3  * Copyright (C) 2015-2019 Jason A. Donenfeld <Jason@zx2c4.com>. All Rights Reserved.
4  */
5 
6 #ifndef __CHACHA20POLY1305_H
7 #define __CHACHA20POLY1305_H
8 
9 #include <linux/types.h>
10 #include <linux/scatterlist.h>
11 
12 enum chacha20poly1305_lengths {
13 	XCHACHA20POLY1305_NONCE_SIZE = 24,
14 	CHACHA20POLY1305_KEY_SIZE = 32,
15 	CHACHA20POLY1305_AUTHTAG_SIZE = 16
16 };
17 
18 void chacha20poly1305_encrypt(u8 *dst, const u8 *src, const size_t src_len,
19 			      const u8 *ad, const size_t ad_len,
20 			      const u64 nonce,
21 			      const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
22 
23 bool __must_check
24 chacha20poly1305_decrypt(u8 *dst, const u8 *src, const size_t src_len,
25 			 const u8 *ad, const size_t ad_len, const u64 nonce,
26 			 const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
27 
28 void xchacha20poly1305_encrypt(u8 *dst, const u8 *src, const size_t src_len,
29 			       const u8 *ad, const size_t ad_len,
30 			       const u8 nonce[at_least XCHACHA20POLY1305_NONCE_SIZE],
31 			       const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
32 
33 bool __must_check xchacha20poly1305_decrypt(
34 	u8 *dst, const u8 *src, const size_t src_len,
35 	const u8 *ad, const size_t ad_len,
36 	const u8 nonce[at_least XCHACHA20POLY1305_NONCE_SIZE],
37 	const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
38 
39 bool chacha20poly1305_encrypt_sg_inplace(struct scatterlist *src, size_t src_len,
40 					 const u8 *ad, const size_t ad_len,
41 					 const u64 nonce,
42 					 const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
43 
44 bool chacha20poly1305_decrypt_sg_inplace(struct scatterlist *src, size_t src_len,
45 					 const u8 *ad, const size_t ad_len,
46 					 const u64 nonce,
47 					 const u8 key[at_least CHACHA20POLY1305_KEY_SIZE]);
48 
49 bool chacha20poly1305_selftest(void);
50 
51 #endif /* __CHACHA20POLY1305_H */
52