mirror of
https://github.com/RT-Thread/rt-thread.git
synced 2025-10-16 23:40:13 +08:00
60f7b3affc
This commit introduces a page poison debugging mechanism and additional assertions for memory management, improving system maintainability and debugging capabilities. The changes aim to detect illegal memory usage early and provide better clarity in managing page allocations. Changes: - Added `RT_DEBUGGING_PAGE_POISON` option to enable memory usage tracing. - Introduced a page poisoner for detecting illegal memory usage. - Implemented region-based memory tracking using bitmaps. - Enhanced spinlock protection for memory management operations. - Fixed several assertion checks for memory safety. - Renamed macros for consistency (`FLOOR` to `CEIL`). - Refined memory allocation and deallocation logic to include poisoning. - Updated Kconfig to add configurable `RT_PAGE_MAX_ORDER` and poison debugging. - Improved debugging outputs for page regions and memory operations. Signed-off-by: Shell <smokewood@qq.com>
124 lines
3.0 KiB
C
124 lines
3.0 KiB
C
/*
|
|
* Copyright (c) 2006-2019, RT-Thread Development Team
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Change Logs:
|
|
* Date Author Notes
|
|
* 2019-11-01 Jesven The first version
|
|
* 2022-12-13 WangXiaoyao Hot-pluggable, extensible
|
|
* page management algorithm
|
|
*/
|
|
#ifndef __MM_PAGE_H__
|
|
#define __MM_PAGE_H__
|
|
|
|
#include <rthw.h>
|
|
#include <rtthread.h>
|
|
#include <stdint.h>
|
|
|
|
#define GET_FLOOR(type) \
|
|
(1ul << (8 * sizeof(rt_size_t) - __builtin_clzl(2 * sizeof(type) - 1) - 1))
|
|
#define DEF_PAGE_T(fields) \
|
|
typedef struct rt_page {\
|
|
union {struct {fields}; char _padding[GET_FLOOR(struct {fields})];};\
|
|
} *rt_page_t
|
|
|
|
/**
|
|
* @brief PAGE ALLOC FLAGS
|
|
*
|
|
* @info PAGE_ANY_AVAILABLE
|
|
* page allocation default to use lower region, this behavior can change by setting
|
|
* PAGE_ANY_AVAILABLE
|
|
*/
|
|
|
|
#define PAGE_ANY_AVAILABLE 0x1ul
|
|
|
|
#define RT_PAGE_PICK_AFFID(ptr) \
|
|
((((long)ptr) & (RT_PAGE_AFFINITY_BLOCK_SIZE - 1)) / ARCH_PAGE_SIZE)
|
|
|
|
#ifdef RT_DEBUGGING_PAGE_LEAK
|
|
#define DEBUG_FIELD struct { \
|
|
/* trace list */ \
|
|
struct rt_page *tl_next; \
|
|
struct rt_page *tl_prev; \
|
|
void *caller; \
|
|
size_t trace_size; \
|
|
}
|
|
#else
|
|
#define DEBUG_FIELD
|
|
#endif
|
|
|
|
DEF_PAGE_T(
|
|
struct rt_page *next; /* same level next */
|
|
struct rt_page *pre; /* same level pre */
|
|
|
|
DEBUG_FIELD;
|
|
|
|
rt_uint32_t size_bits; /* if is ARCH_ADDRESS_WIDTH_BITS, means not free */
|
|
rt_uint32_t ref_cnt; /* page group ref count */
|
|
);
|
|
|
|
#undef GET_FLOOR
|
|
#undef DEF_PAGE_T
|
|
#undef DEBUG_FIELD
|
|
|
|
typedef struct tag_region
|
|
{
|
|
rt_size_t start;
|
|
rt_size_t end;
|
|
|
|
const char *name;
|
|
} rt_region_t;
|
|
|
|
extern const rt_size_t rt_mpr_size;
|
|
extern void *rt_mpr_start;
|
|
|
|
void rt_page_init(rt_region_t reg);
|
|
|
|
void rt_page_cleanup(void);
|
|
|
|
void *rt_pages_alloc(rt_uint32_t size_bits);
|
|
|
|
void *rt_pages_alloc_ext(rt_uint32_t size_bits, size_t flags);
|
|
|
|
void *rt_pages_alloc_tagged(rt_uint32_t size_bits, long tag, size_t flags);
|
|
|
|
rt_bool_t rt_page_is_member(rt_base_t page_pa);
|
|
|
|
void rt_page_ref_inc(void *addr, rt_uint32_t size_bits);
|
|
|
|
int rt_page_ref_get(void *addr, rt_uint32_t size_bits);
|
|
|
|
int rt_pages_free(void *addr, rt_uint32_t size_bits);
|
|
|
|
int rt_page_list(void);
|
|
|
|
rt_size_t rt_page_bits(rt_size_t size);
|
|
|
|
void rt_page_get_info(rt_size_t *total_nr, rt_size_t *free_nr);
|
|
|
|
void rt_page_high_get_info(rt_size_t *total_nr, rt_size_t *free_nr);
|
|
|
|
void *rt_page_page2addr(struct rt_page *p);
|
|
|
|
struct rt_page *rt_page_addr2page(void *addr);
|
|
|
|
/**
|
|
* @brief Install page frames at run-time
|
|
* Region size must be aligned to 2^(RT_PAGE_MAX_ORDER + ARCH_PAGE_SHIFT - 1)
|
|
* bytes currently (typically 2 MB).
|
|
*
|
|
* !WARNING this API will NOT check whether region is valid or not in list
|
|
*
|
|
* @param region region.start as first page frame(inclusive),
|
|
* region.end as first page frame after free region
|
|
* @return int 0 on success
|
|
*/
|
|
int rt_page_install(rt_region_t region);
|
|
|
|
void rt_page_leak_trace_start(void);
|
|
|
|
void rt_page_leak_trace_stop(void);
|
|
|
|
#endif /* __MM_PAGE_H__ */
|