mbed TLS v3.1.0
|
Buffer-based memory allocator. More...
Go to the source code of this file.
Macros | |
#define | MBEDTLS_MEMORY_VERIFY_NONE 0 |
#define | MBEDTLS_MEMORY_VERIFY_ALLOC (1 << 0) |
#define | MBEDTLS_MEMORY_VERIFY_FREE (1 << 1) |
#define | MBEDTLS_MEMORY_VERIFY_ALWAYS (MBEDTLS_MEMORY_VERIFY_ALLOC | MBEDTLS_MEMORY_VERIFY_FREE) |
SECTION: Module settings | |
The configuration options you can set for this module are in this section. Either change them in mbedtls_config.h or define them on the compiler command line. | |
#define | MBEDTLS_MEMORY_ALIGN_MULTIPLE 4 |
Functions | |
void | mbedtls_memory_buffer_alloc_init (unsigned char *buf, size_t len) |
Initialize use of stack-based memory allocator. The stack-based allocator does memory management inside the presented buffer and does not call calloc() and free(). It sets the global mbedtls_calloc() and mbedtls_free() pointers to its own functions. (Provided mbedtls_calloc() and mbedtls_free() are thread-safe if MBEDTLS_THREADING_C is defined) More... | |
void | mbedtls_memory_buffer_alloc_free (void) |
Free the mutex for thread-safety and clear remaining memory. More... | |
void | mbedtls_memory_buffer_set_verify (int verify) |
Determine when the allocator should automatically verify the state of the entire chain of headers / meta-data. (Default: MBEDTLS_MEMORY_VERIFY_NONE) More... | |
void | mbedtls_memory_buffer_alloc_status (void) |
Print out the status of the allocated memory (primarily for use after a program should have de-allocated all memory) Prints out a list of 'still allocated' blocks and their stack trace if MBEDTLS_MEMORY_BACKTRACE is defined. More... | |
void | mbedtls_memory_buffer_alloc_max_get (size_t *max_used, size_t *max_blocks) |
Get the peak heap usage so far. More... | |
void | mbedtls_memory_buffer_alloc_max_reset (void) |
Reset peak statistics. More... | |
void | mbedtls_memory_buffer_alloc_cur_get (size_t *cur_used, size_t *cur_blocks) |
Get the current heap usage. More... | |
int | mbedtls_memory_buffer_alloc_verify (void) |
Verifies that all headers in the memory buffer are correct and contain sane values. Helps debug buffer-overflow errors. More... | |
int | mbedtls_memory_buffer_alloc_self_test (int verbose) |
Checkup routine. More... | |
Buffer-based memory allocator.
Definition in file memory_buffer_alloc.h.
#define MBEDTLS_MEMORY_ALIGN_MULTIPLE 4 |
Align on multiples of this value
Definition at line 38 of file memory_buffer_alloc.h.
#define MBEDTLS_MEMORY_VERIFY_ALLOC (1 << 0) |
Definition at line 44 of file memory_buffer_alloc.h.
#define MBEDTLS_MEMORY_VERIFY_ALWAYS (MBEDTLS_MEMORY_VERIFY_ALLOC | MBEDTLS_MEMORY_VERIFY_FREE) |
Definition at line 46 of file memory_buffer_alloc.h.
#define MBEDTLS_MEMORY_VERIFY_FREE (1 << 1) |
Definition at line 45 of file memory_buffer_alloc.h.
#define MBEDTLS_MEMORY_VERIFY_NONE 0 |
Definition at line 43 of file memory_buffer_alloc.h.
void mbedtls_memory_buffer_alloc_cur_get | ( | size_t * | cur_used, |
size_t * | cur_blocks | ||
) |
Get the current heap usage.
cur_used | Current number of bytes in use or committed. This includes bytes in allocated blocks too small to split into smaller blocks but larger than the requested size. |
cur_blocks | Current number of blocks in use, including free and used |
void mbedtls_memory_buffer_alloc_free | ( | void | ) |
Free the mutex for thread-safety and clear remaining memory.
void mbedtls_memory_buffer_alloc_init | ( | unsigned char * | buf, |
size_t | len | ||
) |
Initialize use of stack-based memory allocator. The stack-based allocator does memory management inside the presented buffer and does not call calloc() and free(). It sets the global mbedtls_calloc() and mbedtls_free() pointers to its own functions. (Provided mbedtls_calloc() and mbedtls_free() are thread-safe if MBEDTLS_THREADING_C is defined)
buf | buffer to use as heap |
len | size of the buffer |
void mbedtls_memory_buffer_alloc_max_get | ( | size_t * | max_used, |
size_t * | max_blocks | ||
) |
Get the peak heap usage so far.
max_used | Peak number of bytes in use or committed. This includes bytes in allocated blocks too small to split into smaller blocks but larger than the requested size. |
max_blocks | Peak number of blocks in use, including free and used |
void mbedtls_memory_buffer_alloc_max_reset | ( | void | ) |
Reset peak statistics.
int mbedtls_memory_buffer_alloc_self_test | ( | int | verbose | ) |
Checkup routine.
void mbedtls_memory_buffer_alloc_status | ( | void | ) |
Print out the status of the allocated memory (primarily for use after a program should have de-allocated all memory) Prints out a list of 'still allocated' blocks and their stack trace if MBEDTLS_MEMORY_BACKTRACE is defined.
int mbedtls_memory_buffer_alloc_verify | ( | void | ) |
Verifies that all headers in the memory buffer are correct and contain sane values. Helps debug buffer-overflow errors.
Prints out first failure if MBEDTLS_MEMORY_DEBUG is defined. Prints out full header information if MBEDTLS_MEMORY_DEBUG is defined. (Includes stack trace information for each block if MBEDTLS_MEMORY_BACKTRACE is defined as well).
void mbedtls_memory_buffer_set_verify | ( | int | verify | ) |
Determine when the allocator should automatically verify the state of the entire chain of headers / meta-data. (Default: MBEDTLS_MEMORY_VERIFY_NONE)
verify | One of MBEDTLS_MEMORY_VERIFY_NONE, MBEDTLS_MEMORY_VERIFY_ALLOC, MBEDTLS_MEMORY_VERIFY_FREE or MBEDTLS_MEMORY_VERIFY_ALWAYS |