forked from Green-Sky/tomato
596ea37298
e58eb27a8 fix(toxav): remove extra copy of video frame on encode Tested and works, but there might be alignment issues and other stuff. 206ea3530 refactor: Explicitly pass dependencies to constructors. 7cefa93cf fix(toxencryptsave): Wipe salt and passkey after usage. 7c3be2342 refactor: Add file/line to tox-bootstrapd logging. f84e8cdce refactor: Move loglogdata out of network.c. 390f7db06 refactor: Move random and memory OS-specifics to `os_*` files. REVERT: 640e6cace fix(toxav): remove extra copy of video frame on encode Tested and works, but there might be alignment issues and other stuff. git-subtree-dir: external/toxcore/c-toxcore git-subtree-split: e58eb27a84f9fa0cd996868e079f39e90a5c04b6
54 lines
1.5 KiB
C
54 lines
1.5 KiB
C
/* SPDX-License-Identifier: GPL-3.0-or-later
|
|
* Copyright © 2022-2025 The TokTok team.
|
|
*/
|
|
|
|
#ifndef C_TOXCORE_TOXCORE_TOX_RANDOM_IMPL_H
|
|
#define C_TOXCORE_TOXCORE_TOX_RANDOM_IMPL_H
|
|
|
|
#include "tox_memory.h"
|
|
#include "tox_random.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** @brief Fill a byte array with random bytes.
|
|
*
|
|
* This is the key generator callback and as such must be a cryptographically
|
|
* secure pseudo-random number generator (CSPRNG). The security of Tox heavily
|
|
* depends on the security of this RNG.
|
|
*/
|
|
typedef void tox_random_bytes_cb(void *self, uint8_t *bytes, uint32_t length);
|
|
|
|
/** @brief Generate a random integer between 0 and @p upper_bound.
|
|
*
|
|
* Should produce a uniform random distribution, but Tox security does not
|
|
* depend on this being correct. In principle, it could even be a non-CSPRNG.
|
|
*/
|
|
typedef uint32_t tox_random_uniform_cb(void *self, uint32_t upper_bound);
|
|
|
|
/** @brief Virtual function table for Random. */
|
|
struct Tox_Random_Funcs {
|
|
tox_random_bytes_cb *bytes_callback;
|
|
tox_random_uniform_cb *uniform_callback;
|
|
};
|
|
|
|
/** @brief Random number generator object.
|
|
*
|
|
* Can be used by test code and fuzzers to make toxcore behave in specific
|
|
* well-defined (non-random) ways. Production code ought to use libsodium's
|
|
* CSPRNG and use `os_random` below.
|
|
*/
|
|
struct Tox_Random {
|
|
const Tox_Random_Funcs *funcs;
|
|
void *user_data;
|
|
|
|
const Tox_Memory *mem;
|
|
};
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* C_TOXCORE_TOXCORE_TOX_RANDOM_IMPL_H */
|