9b36dd9d99
9ed2fa80d fix(toxav): remove extra copy of video frame on encode de30cf3ad docs: Add new file kinds, that should be useful to all clients. d5b5e879d fix(DHT): Correct node skipping logic timed out nodes. 30e71fe97 refactor: Generate event dispatch functions and add tox_events_dispatch. 8fdbb0b50 style: Format parameter lists in event handlers. d00dee12b refactor: Add warning logs when losing chat invites. b144e8db1 feat: Add a way to look up a file number by ID. 849281ea0 feat: Add a way to fetch groups by chat ID. a2c177396 refactor: Harden event system and improve type safety. 8f5caa656 refactor: Add MessagePack string support to bin_pack. 34e8d5ad5 chore: Add GitHub CodeQL workflow and local Docker runner. f7b068010 refactor: Add nullability annotations to event headers. 788abe651 refactor(toxav): Use system allocator for mutexes. 2e4b423eb refactor: Use specific typedefs for public API arrays. 2baf34775 docs(toxav): update idle iteration interval see 679444751876fa3882a717772918ebdc8f083354 2f87ac67b feat: Add Event Loop abstraction (Ev). f8dfc38d8 test: Fix data race in ToxScenario virtual_clock. 38313921e test(TCP): Add regression test for TCP priority queue integrity. f94a50d9a refactor(toxav): Replace mutable_mutex with dynamically allocated mutex. ad054511e refactor: Internalize DHT structs and add debug helpers. 8b467cc96 fix: Prevent potential integer overflow in group chat handshake. 4962bdbb8 test: Improve TCP simulation and add tests 5f0227093 refactor: Allow nullable data in group chat handlers. e97b18ea9 chore: Improve Windows Docker support. b14943bbd refactor: Move Logger out of Messenger into Tox. dd3136250 cleanup: Apply nullability qualifiers to C++ codebase. 1849f70fc refactor: Extract low-level networking code to net and os_network. 8fec75421 refactor: Delete tox_random, align on rng and os_random. a03ae8051 refactor: Delete tox_memory, align on mem and os_memory. 4c88fed2c refactor: Use `std::` prefixes more consistently in C++ code. 72452f2ae test: Add some more tests for onion and shared key cache. d5a51b09a cleanup: Use tox_attributes.h in tox_private.h and install it. b6f5b9fc5 test: Add some benchmarks for various high level things. 8a8d02785 test(support): Introduce threaded Tox runner and simulation barrier d68d1d095 perf(toxav): optimize audio and video intermediate buffers by keeping them around REVERT: c9cdae001 fix(toxav): remove extra copy of video frame on encode git-subtree-dir: external/toxcore/c-toxcore git-subtree-split: 9ed2fa80d582c714d6bdde6a7648220a92cddff8
100 lines
2.9 KiB
C
100 lines
2.9 KiB
C
/* SPDX-License-Identifier: GPL-3.0-or-later
|
|
* Copyright © 2016-2025 The TokTok team.
|
|
* Copyright © 2013 Tox project.
|
|
*/
|
|
|
|
/**
|
|
* Memory allocation and deallocation functions.
|
|
*/
|
|
#ifndef C_TOXCORE_TOXCORE_MEM_H
|
|
#define C_TOXCORE_TOXCORE_MEM_H
|
|
|
|
#include <stdint.h> // uint*_t
|
|
|
|
#include "attributes.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** @brief Allocate a byte array, similar to malloc. */
|
|
typedef void *_Nullable memory_malloc_cb(void *_Nullable self, uint32_t size);
|
|
/** @brief Reallocate a byte array, similar to realloc. */
|
|
typedef void *_Nullable memory_realloc_cb(void *_Nullable self, void *_Nullable ptr, uint32_t size);
|
|
/**
|
|
* @brief Deallocate a byte or object array, similar to free.
|
|
*/
|
|
typedef void memory_dealloc_cb(void *_Nullable self, void *_Nullable ptr);
|
|
|
|
/** @brief Functions wrapping standard C memory allocation functions. */
|
|
typedef struct Memory_Funcs {
|
|
memory_malloc_cb *_Nonnull malloc_callback;
|
|
memory_realloc_cb *_Nonnull realloc_callback;
|
|
memory_dealloc_cb *_Nonnull dealloc_callback;
|
|
} Memory_Funcs;
|
|
|
|
typedef struct Memory {
|
|
const Memory_Funcs *_Nonnull funcs;
|
|
void *_Nullable user_data;
|
|
} Memory;
|
|
|
|
/**
|
|
* @brief Allocate an array of a given size for built-in types.
|
|
*
|
|
* The array will not be initialised. Supported built-in types are
|
|
* `uint8_t`, `int8_t`, and `int16_t`.
|
|
*/
|
|
void *_Nullable mem_balloc(const Memory *_Nonnull mem, uint32_t size);
|
|
|
|
/**
|
|
* @brief Resize an array of a given size for built-in types.
|
|
*
|
|
* If used for a type other than byte-sized types, `size` needs to be manually
|
|
* multiplied by the element size.
|
|
*/
|
|
void *_Nullable mem_brealloc(const Memory *_Nonnull mem, void *_Nullable ptr, uint32_t size);
|
|
|
|
/**
|
|
* @brief Allocate a single zero-initialised object.
|
|
*
|
|
* Always use as `(T *)mem_alloc(mem, sizeof(T))`.
|
|
*
|
|
* @param mem The memory allocator.
|
|
* @param size Size in bytes of each element.
|
|
*/
|
|
void *_Nullable mem_alloc(const Memory *_Nonnull mem, uint32_t size);
|
|
|
|
/**
|
|
* @brief Allocate a vector (array) of objects.
|
|
*
|
|
* Always use as `(T *)mem_valloc(mem, N, sizeof(T))`.
|
|
*/
|
|
void *_Nullable mem_valloc(const Memory *_Nonnull mem, uint32_t nmemb, uint32_t size);
|
|
|
|
/**
|
|
* @brief Resize an object vector.
|
|
*
|
|
* Changes the size of (and possibly moves) the memory block pointed to by
|
|
* @p ptr to be large enough for an array of @p nmemb elements, each of which
|
|
* is @p size bytes. It is similar to the call
|
|
*
|
|
* @code
|
|
* realloc(ptr, nmemb * size);
|
|
* @endcode
|
|
*
|
|
* However, unlike that `realloc()` call, `mem_vrealloc()` fails safely in the
|
|
* case where the multiplication would overflow. If such an overflow occurs,
|
|
* `mem_vrealloc()` returns `nullptr`.
|
|
*/
|
|
void *_Nullable mem_vrealloc(const Memory *_Nonnull mem, void *_Nullable ptr, uint32_t nmemb, uint32_t size);
|
|
|
|
/** @brief Free an array, object, or object vector. */
|
|
void mem_delete(const Memory *_Nonnull mem, void *_Nullable ptr);
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
#endif /* C_TOXCORE_TOXCORE_MEM_H */
|
|
|