Refresh both AGENTS guides and clarify module purpose, usage, ownership, threading, return values and wire formats in headers. Remove the unused timeout_heap freed_count field and unimplemented getter.
35 lines
1.7 KiB
C
35 lines
1.7 KiB
C
/**
|
|
* mem — выделение памяти с защитными полями, местом аллокации и учётом живых блоков.
|
|
* Использовать u_malloc/u_calloc/u_realloc/u_strdup и парный u_free; обычный free к этим блокам неприменим.
|
|
* Макросы передают LOCATION автоматически. OOM возвращает NULL; обнаруженное повреждение завершает процесс.
|
|
* realloc при ошибке сохраняет старый блок, при size=0 освобождает его.
|
|
* Отчёт u_report_unfreed_blocks вызывать после остановки потоков, меняющих список аллокаций.
|
|
*/
|
|
#ifndef MEM_H
|
|
#define MEM_H
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
#define XSTR(s) STR(s)
|
|
#define STR(s) #s
|
|
#define LOCATION __FILE__ ":" XSTR(__LINE__)
|
|
void u_check(void* ptr, const char* text, const char* location);
|
|
#define u_malloc(size) u_malloc_impl(size, LOCATION)
|
|
#define u_calloc(nmemb, size) u_calloc_impl(nmemb, size, LOCATION)
|
|
#define u_realloc(ptr, size) u_realloc_impl(ptr, size, LOCATION)
|
|
#define u_free(ptr) u_free_impl(ptr, LOCATION)
|
|
#define u_strdup(s) u_strdup_impl(s, LOCATION)
|
|
void* u_malloc_impl(uint32_t size, const char* location);
|
|
void* u_calloc_impl(uint32_t nmemb, uint32_t size, const char* location);
|
|
void* u_realloc_impl(void* ptr, uint32_t size, const char* location);
|
|
void u_free_impl(void* ptr, const char* location);
|
|
char* u_strdup_impl(const char* s, const char* location);
|
|
void u_report_unfreed_blocks(void);
|
|
size_t u_get_allocated_count(void);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif // MEM_H
|