LMMP 4.3.0
Lamina High-Precision Arithmetic Library
载入中...
搜索中...
未找到
memory.c 文件参考
#include "mparam.h"
#include "impl/tmp_alloc.h"
#include "lmmp/lmmpn.h"
memory.c 的引用(Include)关系图:

浏览该文件的源代码.

宏定义

#define heap_alloc_func   global_heap.alloc
#define heap_free_func   global_heap.free
#define HSIZE   sizeof(void*)
 Copyright (C) 2026 HJimmyK (Jericho Knox)
#define realloc_func   global_heap.realloc

函数

void * lmmp_alloc (size_t size)
 内存分配函数(调用lmmp_heap_alloc_fn)
int lmmp_alloc_count (int cnt)
 堆内存分配计数器(线程局部)
void lmmp_free (void *ptr)
 内存释放函数(调用lmmp_heap_free_fn)
void lmmp_leak_tracker (const char *func, int line)
 内存泄漏检测器
static void lmmp_memory_abort (size_t size, const char *func, int line)
void * lmmp_realloc (void *oldptr, size_t new_size)
 内存重分配函数(调用lmmp_realloc_fn)
void lmmp_set_heap_allocator (const lmmp_heap_allocator_t *heap)
 设置 LMMP 全局堆内存分配函数
int lmmp_stack_deinit (void)
 LMMP 全局栈释放函数(通常不需要手动调用)
int lmmp_stack_init (size_t size)
 LMMP 全局栈初始化函数(通常不需要手动调用)

变量

__thread lmmp_heap_allocator_t global_heap
static __thread int heap_alloc_count = 0
__thread lmmp_memory_ctx lmmp_tmpmem_ctx

宏定义说明

◆ heap_alloc_func

#define heap_alloc_func   global_heap.alloc

在文件 memory.c 第 41 行定义.

被这些函数引用 lmmp_alloc() , 以及 lmmp_stack_init().

◆ heap_free_func

#define heap_free_func   global_heap.free

在文件 memory.c 第 42 行定义.

被这些函数引用 lmmp_free(), lmmp_stack_deinit() , 以及 lmmp_stack_init().

◆ HSIZE

#define HSIZE   sizeof(void*)

Copyright (C) 2026 HJimmyK (Jericho Knox)

This file is part of LMMP.

LMMP is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library. If not, see https://www.gnu.org/licenses/.

SPDX-License-Identifier: LGPL-3.0-or-later

在文件 memory.c 第 33 行定义.

◆ realloc_func

#define realloc_func   global_heap.realloc

在文件 memory.c 第 43 行定义.

被这些函数引用 lmmp_realloc().

函数说明

◆ lmmp_alloc()

void * lmmp_alloc ( size_t size)

内存分配函数(调用lmmp_heap_alloc_fn)

参数
size要分配的内存字节数
警告
size>0
注解
调用堆内存分配器,分配失败将触发 lmmp_abort
返回
返回指向分配内存的指针(分配失败不会 return NULL,而是直接触发 lmmp_abort)

在文件 memory.c 第 382 行定义.

382 {
383#if LMMP_DEBUG_PARAM_ASSERT_CHECK == 1
384 if (size == 0) {
385 lmmp_abort(LMMP_ERROR_MEMORY_ALLOC_FAILURE, "Allocating zero bytes is not allowed.", __func__, __LINE__);
386 return NULL;
387 }
388#endif // LMMP_DEBUG_PARAM_ASSERT_CHECK == 1
389 void* ret = heap_alloc_func(size);
390 if (ret == NULL)
391 lmmp_memory_abort(size, __func__, __LINE__);
392#if LMMP_DEBUG_MEMORY_LEAK == 1
394#endif
395 return ret;
396}
void lmmp_abort(lmmp_error_t type, const char *msg, const char *func, int line)
LMMP 全局退出函数,内部错误或断言失败时调用,若设置了全局退出函数,则会调用该函数,否则会调用默认的退出函数。
@ LMMP_ERROR_MEMORY_ALLOC_FAILURE
定义 lmmp.h:285
static __thread int heap_alloc_count
#define heap_alloc_func
static void lmmp_memory_abort(size_t size, const char *func, int line)

引用了 heap_alloc_count, heap_alloc_func, lmmp_abort(), lmmp_alloc(), LMMP_ERROR_MEMORY_ALLOC_FAILURE , 以及 lmmp_memory_abort().

被这些函数引用 alloc_limbs(), alloc_limbs(), check_decimal_one(), check_hex_one(), check_value(), dec_pow_extend_(), dec_pow_init_(), divides_all(), lmmp_alloc(), lmmp_fft_memstack_(), lmmp_strong_rng_init_() , 以及 TEST_CASE().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_alloc_count()

int lmmp_alloc_count ( int cnt)

堆内存分配计数器(线程局部)

参数
cnt若不为0,则将堆内存计数器置为cnt
返回
返回当前的heap分配计数(如果被设置,即返回旧的计数值),即目前未被释放的堆内存数量

在文件 memory.c 第 328 行定义.

328 {
329 if (cnt != 0) {
330 int new_cnt = cnt;
331 cnt = heap_alloc_count;
332 heap_alloc_count = new_cnt;
333 return cnt;
334 }
335 return heap_alloc_count;
336}

引用了 heap_alloc_count , 以及 lmmp_alloc_count().

被这些函数引用 lmmp_alloc_count().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_free()

void lmmp_free ( void * ptr)

内存释放函数(调用lmmp_heap_free_fn)

参数
ptr要释放的内存指针
注解
ptr 可以为空指针

在文件 memory.c 第 437 行定义.

437 {
438 heap_free_func(ptr);
439#if LMMP_DEBUG_MEMORY_LEAK == 1
440 if (ptr != NULL)
442#endif
443}
#define heap_free_func

引用了 heap_alloc_count, heap_free_func , 以及 lmmp_free().

被这些函数引用 bench_add_n(), bench_add_nc(), bench_addmul_1(), bench_addshl1_n(), bench_div(), bench_div_1(), bench_div_1_s(), bench_div_2(), bench_div_2_s(), bench_div_3_2(), bench_factorial(), bench_fib(), bench_gcd_hgcd(), bench_gcd_lehmer(), bench_is_prime_2(), bench_is_prime_2_notrial(), bench_is_prime_n(), bench_is_prime_n_notrial(), bench_is_prime_n_proth(), bench_is_prime_ulong(), bench_is_prime_ulong_notrial(), bench_is_prothprime(), bench_is_strong_lucas(), bench_mod_1(), bench_mod_2(), bench_mul(), bench_mul_1(), bench_mul_basecase(), bench_mul_fft(), bench_mul_mersenne_dc(), bench_mul_mersenne_fft(), bench_mul_n(), bench_mul_toom22(), bench_mul_toom33(), bench_mul_toom44(), bench_mullo(), bench_mullo_basecase(), bench_mullo_dc(), bench_mullo_fft(), bench_not(), bench_powlo(), bench_powmod_even(), bench_powmod_odd(), bench_shl(), bench_shlnot(), bench_shr(), bench_shr1add_n(), bench_shr1sub_n(), bench_sqr(), bench_sqr_basecase(), bench_sqrt(), bench_sub_n(), bench_sub_nc(), bench_submul_1(), bench_subshl1_n(), bezout_identity_l(), cbrt_floor_ok(), check_addmul_2(), check_decimal_one(), check_hex_one(), check_mul_n(), check_pow1_agree(), check_pow1_laws(), check_value(), check_vs_dispatch(), check_vs_oracle(), coeff_bound_l(), divides_all(), free_divexact_ctx(), lmmp_dec_pow_table_free_(), lmmp_fft_cache_free_(), lmmp_fft_memstack_(), lmmp_free(), lmmp_gcd_hgcd_(), lmmp_gcdext_hgcd_(), lmmp_hgcd_(), lmmp_hgcd_matrix_free_(), lmmp_huff_tree_free_(), lmmp_mul_fft_(), lmmp_mul_fft_unbalance_(), lmmp_mul_mersenne_dc_(), lmmp_mullo_fft_(), lmmp_prime_cache_free_(), lmmp_prime_int_table_free_(), lmmp_prime_int_table_init_(), lmmp_sqr_fft_(), lmmp_sqr_mersenne_dc_(), lmmp_strong_rng_free_(), lmmp_trialdiv_table_free_(), main(), make_odd_mod(), overlap_buf_free(), pad_add(), pad_add_value(), ref_digits(), rem_sum_ok(), run_gcdext_pair(), small_factor_q(), sqrt_floor_ok(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), TEST_CASE(), verify_div_relation() , 以及 verify_inverse().

函数调用图:

◆ lmmp_leak_tracker()

void lmmp_leak_tracker ( const char * func,
int line )

内存泄漏检测器

参数
func泄漏发生的函数名
line泄漏发生的行号
警告
内存计数器均是线程局部的,仅会检测单线程的内存泄漏。
注解
将会同时检验堆内存和栈内存,若堆内存计数器不为0,或栈内存的栈顶不在栈底,都会触发lmmp_abort 两者同时发生则将输出两者的信息。

在文件 memory.c 第 338 行定义.

338 {
339 char msg[360] = {0};
340 int offset = 0;
341 const int max_len = sizeof(msg) - 1;
342 bool t = false;
343 if (heap_alloc_count != 0) {
344 offset +=
345 snprintf(msg + offset, max_len - offset, "Heap allocations not freed: %d block(s);\n", heap_alloc_count);
346 t = true;
347 }
349 offset += snprintf(msg + offset, max_len - offset,
350 "Default stack allocator is not empty. top: %p, begin: %p, end: %p;\n",
352 t = true;
353 }
355 offset += snprintf(msg + offset, max_len - offset,
356 "Default pool allocator is not empty. top: %p, begin: %p; remain: %zu bytes, capacity: %zu "
357 "bytes;\n",
360 t = true;
361 }
362 if (t) {
363 lmmp_abort(LMMP_ERROR_MEMORY_LEAK, msg, func, line);
364 }
365}
@ LMMP_ERROR_MEMORY_LEAK
定义 lmmp.h:288
#define t
__thread lmmp_memory_ctx lmmp_tmpmem_ctx

引用了 lmmp_memory_ctx::capacity, heap_alloc_count, lmmp_abort(), LMMP_ERROR_MEMORY_LEAK, lmmp_leak_tracker, lmmp_tmpmem_ctx, lmmp_memory_ctx::pool_begin, lmmp_memory_ctx::pool_top, lmmp_memory_ctx::remain, lmmp_memory_ctx::stack_begin, lmmp_memory_ctx::stack_end, lmmp_memory_ctx::stack_top , 以及 t.

函数调用图:

◆ lmmp_memory_abort()

void lmmp_memory_abort ( size_t size,
const char * func,
int line )
inlinestatic

在文件 memory.c 第 376 行定义.

376 {
377 char msg[64];
378 snprintf(msg, sizeof(msg), "Memory allocation failed (size: %zu bytes)", size);
380}

引用了 lmmp_abort(), LMMP_ERROR_MEMORY_ALLOC_FAILURE , 以及 lmmp_memory_abort().

被这些函数引用 lmmp_alloc(), lmmp_memory_abort() , 以及 lmmp_realloc().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_realloc()

void * lmmp_realloc ( void * ptr,
size_t size )

内存重分配函数(调用lmmp_realloc_fn)

参数
ptr已分配的内存指针
size新的内存大小(字节)
警告
size>0
注解
调用堆内存重新分配器,分配失败将触发 lmmp_abort 在LMMP_DEBUG_PARAM_ASSERT_CHECK宏为1时,重分配 0 字节将触发 lmmp_abort
返回
成功返回指向新内存区域的指针(分配失败不会 return NULL,而是直接触发 lmmp_abort)

在文件 memory.c 第 409 行定义.

409 {
410#if LMMP_DEBUG_PARAM_ASSERT_CHECK == 1
411 if (new_size == 0) {
412 lmmp_abort(LMMP_ERROR_MEMORY_ALLOC_FAILURE, "Reallocating zero bytes is not allowed.", __func__, __LINE__);
413 return NULL;
414 }
415#endif // LMMP_DEBUG_PARAM_ASSERT_CHECK == 1
416 void* ret = realloc_func(oldptr, new_size);
417 if (ret == NULL) {
418 lmmp_memory_abort(new_size, __func__, __LINE__);
419 }
420#if LMMP_DEBUG_MEMORY_LEAK == 1
421 if (oldptr == NULL)
423#endif
424 return ret;
425}
#define realloc_func

引用了 heap_alloc_count, lmmp_abort(), LMMP_ERROR_MEMORY_ALLOC_FAILURE, lmmp_memory_abort(), lmmp_realloc() , 以及 realloc_func.

被这些函数引用 lmmp_realloc() , 以及 lmmp_strong_rng_extern_().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_set_heap_allocator()

void lmmp_set_heap_allocator ( const lmmp_heap_allocator_t * heap)

设置 LMMP 全局堆内存分配函数

参数
heap新的堆内存分配器,可以为NULL,此时会直接返回,而不进行任何操作。
警告
由于所有共享内存都采用堆内存分配。因此,传入新的堆分配器将会首先调用 lmmp_global_deinit 函数,释放所有共享内存,以保证老旧的堆资源被释放。 然后将会自动调用 lmmp_global_init 函数,重新分配所有线程局部内存。 同时,为保证内存不泄露,将会对堆计数器和栈顶以及缓冲池顶进行检查。 若此时堆栈分配计数器不为 0,或当前栈帧不在栈底,都会触发lmmp_abort函数, 并输出相应的错误信息。
注解
堆分配器是线程局部的,因此,创建新线程时,如有需要,请自行设置新的堆分配器。 同时也请自行保证分配器和释放器相匹配。

在文件 memory.c 第 100 行定义.

100 {
101 if (heap == NULL)
102 return;
104#if LMMP_DEBUG_MEMORY_LEAK == 1
105 lmmp_leak_tracker(__func__, __LINE__); // Check for memory leaks before setting new allocator
106#endif
107 global_heap = *heap;
109}
void lmmp_global_init(void)
全局初始化函数(线程局部的)
void lmmp_global_deinit(void)
全局释放函数(线程局部的)
#define lmmp_leak_tracker
定义 lmmp.h:440
__thread lmmp_heap_allocator_t global_heap

引用了 global_heap, lmmp_global_deinit(), lmmp_global_init(), lmmp_leak_tracker , 以及 lmmp_set_heap_allocator().

被这些函数引用 lmmp_set_heap_allocator() , 以及 test_fn_heap_balance_full_cycle().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_stack_deinit()

int lmmp_stack_deinit ( void )

LMMP 全局栈释放函数(通常不需要手动调用)

警告
请注意调用此函数后,访问之前的分配的栈空间将会导致未定义行为。在定义了 LMMP_DEBUG_MEMORY_LEAK 宏时,会检查默认栈是否为空, 则会触发lmmp_abort函数。
注解
如果此后再使用栈内存,请调用 lmmp_stack_init 函数,以重置栈空间。
返回
返回0表示成功释放,返回-1表示已经释放(并非错误)。

在文件 memory.c 第 57 行定义.

57 {
58 if (lmmp_tmpmem_ctx.stack_begin != NULL) {
60 if (lmmp_tmpmem_ctx.pool_begin != NULL)
67 lmmp_tmpmem_ctx.remain = 0; // Reset remain to 0
68 lmmp_tmpmem_ctx.capacity = 0; // Reset capacity to 0
69 return 0;
70 } else {
71 return -1;
72 }
73}

引用了 lmmp_memory_ctx::capacity, heap_free_func, lmmp_stack_deinit(), lmmp_tmpmem_ctx, lmmp_memory_ctx::pool_begin, lmmp_memory_ctx::pool_top, lmmp_memory_ctx::remain, lmmp_memory_ctx::stack_begin, lmmp_memory_ctx::stack_end , 以及 lmmp_memory_ctx::stack_top.

被这些函数引用 lmmp_stack_deinit() , 以及 stack_deinit_default_().

函数调用图:
这是这个函数的调用关系图:

◆ lmmp_stack_init()

int lmmp_stack_init ( size_t size)

LMMP 全局栈初始化函数(通常不需要手动调用)

注解
初始化默认栈,并分配大小为size的额外内存池。如果已经初始化, 则会直接返回-1,表示已经初始化(并非错误),且不进行任何其他操作。 lmmp_global_init 函数会自动调用此函数,分配的额外缓冲池大小为 LMMP_POOL_SIZE 的大小 (默认为512kb),无需手动调用。 如果你想手动设置缓冲池的大小,可以先调用 lmmp_stack_deinit 函数,再调用此函数,将 POOL_SIZE 设置为你想要的值。同时你也可以禁用缓冲池(即size为0),此时不会分配额外缓冲池。
返回
返回0表示成功初始化,返回-1表示已经初始化(并非错误)。

在文件 memory.c 第 75 行定义.

75 {
76 if (lmmp_tmpmem_ctx.stack_begin != NULL) {
77 return -1;
78 } else {
80 if (lmmp_tmpmem_ctx.stack_begin == NULL) {
81 lmmp_abort(LMMP_ERROR_MEMORY_ALLOC_FAILURE, "Failed to allocate stack memory", __func__, __LINE__);
82 }
85 if (size > LMMP_MAX_ALIGN) {
86 // 只有当size大于最大对齐单位时,才分配缓冲池
88 if (lmmp_tmpmem_ctx.pool_begin == NULL) {
89 heap_free_func(lmmp_tmpmem_ctx.stack_begin); // Free old stack memory
90 lmmp_abort(LMMP_ERROR_MEMORY_ALLOC_FAILURE, "Failed to allocate pool memory", __func__, __LINE__);
91 }
95 }
96 return 0;
97 }
98}
#define LMMP_DEFAULT_STACK_SIZE
Copyright (C) 2026 HJimmyK (Jericho Knox)
uint8_t mp_byte_t
定义 lmmp.h:91
#define LMMP_MAX_ALIGN
定义 lmmp.h:100

引用了 lmmp_memory_ctx::capacity, heap_alloc_func, heap_free_func, lmmp_abort(), LMMP_DEFAULT_STACK_SIZE, LMMP_ERROR_MEMORY_ALLOC_FAILURE, LMMP_MAX_ALIGN, lmmp_stack_init(), lmmp_tmpmem_ctx, lmmp_memory_ctx::pool_begin, lmmp_memory_ctx::pool_top, lmmp_memory_ctx::remain, lmmp_memory_ctx::stack_begin, lmmp_memory_ctx::stack_end , 以及 lmmp_memory_ctx::stack_top.

被这些函数引用 lmmp_stack_init() , 以及 stack_init_default_().

函数调用图:
这是这个函数的调用关系图:

变量说明

◆ global_heap

__thread lmmp_heap_allocator_t global_heap
初始值:
= {
.alloc = (lmmp_heap_alloc_fn)malloc,
.free = (lmmp_heap_free_fn)free,
.realloc = (lmmp_realloc_fn)realloc,
}
void *(*) lmmp_heap_alloc_fn(size_t size)
定义 lmmp.h:235
void(*) lmmp_heap_free_fn(void *ptr)
定义 lmmp.h:236
void *(*) lmmp_realloc_fn(void *ptr, size_t size)
定义 lmmp.h:237

在文件 memory.c 第 35 行定义.

被这些函数引用 lmmp_set_heap_allocator(), lmmp_temp_heap_alloc_() , 以及 lmmp_temp_heap_free_().

◆ heap_alloc_count

__thread int heap_alloc_count = 0
static

在文件 memory.c 第 45 行定义.

被这些函数引用 lmmp_alloc(), lmmp_alloc_count(), lmmp_free(), lmmp_leak_tracker() , 以及 lmmp_realloc().

◆ lmmp_tmpmem_ctx

__thread lmmp_memory_ctx lmmp_tmpmem_ctx
初始值:
= {
.stack_begin = NULL,
.stack_end = NULL,
.stack_top = NULL,
.pool_begin = NULL,
.pool_top = NULL,
.remain = 0,
.capacity = 0,
}

在文件 memory.c 第 47 行定义.

被这些函数引用 lmmp_leak_tracker(), lmmp_stack_deinit(), lmmp_stack_init(), lmmp_temp_pool_alloc_(), lmmp_temp_pool_free_(), lmmp_temp_stack_alloc_() , 以及 lmmp_temp_stack_free_().