| 1 | /*
|
|---|
| 2 | * Copyright 2015-2021 The OpenSSL Project Authors. All Rights Reserved.
|
|---|
| 3 | *
|
|---|
| 4 | * Licensed under the Apache License 2.0 (the "License"). You may not use
|
|---|
| 5 | * this file except in compliance with the License. You can obtain a copy
|
|---|
| 6 | * in the file LICENSE in the source distribution or at
|
|---|
| 7 | * https://www.openssl.org/source/license.html
|
|---|
| 8 | */
|
|---|
| 9 |
|
|---|
| 10 | #ifndef OSSL_CRYPTO_CHACHA_H
|
|---|
| 11 | #define OSSL_CRYPTO_CHACHA_H
|
|---|
| 12 | # ifndef RT_WITHOUT_PRAGMA_ONCE /* VBOX */
|
|---|
| 13 | # pragma once
|
|---|
| 14 | # endif /* VBOX */
|
|---|
| 15 |
|
|---|
| 16 | #if defined(VBOX) && !defined(RT_OS_WINDOWS) && !defined(RT_OS_OS2)
|
|---|
| 17 | # include "openssl-mangling.h"
|
|---|
| 18 | #endif
|
|---|
| 19 | #include <stddef.h>
|
|---|
| 20 |
|
|---|
| 21 | /*
|
|---|
| 22 | * ChaCha20_ctr32 encrypts |len| bytes from |inp| with the given key and
|
|---|
| 23 | * nonce and writes the result to |out|, which may be equal to |inp|.
|
|---|
| 24 | * The |key| is not 32 bytes of verbatim key material though, but the
|
|---|
| 25 | * said material collected into 8 32-bit elements array in host byte
|
|---|
| 26 | * order. Same approach applies to nonce: the |counter| argument is
|
|---|
| 27 | * pointer to concatenated nonce and counter values collected into 4
|
|---|
| 28 | * 32-bit elements. This, passing crypto material collected into 32-bit
|
|---|
| 29 | * elements as opposite to passing verbatim byte vectors, is chosen for
|
|---|
| 30 | * efficiency in multi-call scenarios.
|
|---|
| 31 | */
|
|---|
| 32 | void ChaCha20_ctr32(unsigned char *out, const unsigned char *inp,
|
|---|
| 33 | size_t len, const unsigned int key[8],
|
|---|
| 34 | const unsigned int counter[4]);
|
|---|
| 35 | #ifdef INCLUDE_C_CHACHA20
|
|---|
| 36 | /* The fallback implementation for `ChaCha20_ctr32`. */
|
|---|
| 37 | void ChaCha20_ctr32_c(unsigned char *out, const unsigned char *inp, size_t len,
|
|---|
| 38 | const unsigned int key[8], const unsigned int counter[4]);
|
|---|
| 39 | #endif
|
|---|
| 40 |
|
|---|
| 41 | /*
|
|---|
| 42 | * You can notice that there is no key setup procedure. Because it's
|
|---|
| 43 | * as trivial as collecting bytes into 32-bit elements, it's reckoned
|
|---|
| 44 | * that below macro is sufficient.
|
|---|
| 45 | */
|
|---|
| 46 | #define CHACHA_U8TOU32(p) ( \
|
|---|
| 47 | ((unsigned int)(p)[0]) | ((unsigned int)(p)[1]<<8) | \
|
|---|
| 48 | ((unsigned int)(p)[2]<<16) | ((unsigned int)(p)[3]<<24) )
|
|---|
| 49 |
|
|---|
| 50 | #define CHACHA_KEY_SIZE 32
|
|---|
| 51 | #define CHACHA_CTR_SIZE 16
|
|---|
| 52 | #define CHACHA_BLK_SIZE 64
|
|---|
| 53 |
|
|---|
| 54 | #endif
|
|---|
