简单内存分配器

简单内存分配器 的协作图:

结构体
struct	xwmm_sma
	简单内存分配器 更多...

函数
xwer_t	xwmm_sma_init (struct xwmm_sma *sa, xwptr_t origin, xwsz_t size, xwsq_t pos, const char *name)
	XWMM API：初始化简单内存分配器对象
xwer_t	xwmm_sma_alloc (struct xwmm_sma *sa, xwsz_t size, xwsz_t aligned, void **membuf)
	XWMM API：从简单内存分配器中申请内存
xwer_t	xwmm_sma_free (struct xwmm_sma *sa, void *mem)
	XWMM API：释放内存

详细描述

简单内存分配器只分配大小最适应内存块，不对内存进行回收。

• 优点：
  • 简单，代码量非常小；
  • 运行时间稳定。
• 缺点：内存一旦分配出去不再回收，释放函数只是一个 Dummy 函数；
• 适用性：简单的RTOS应用场合或不需要回收内存的场合
• 上下文的安全性：在任何上下文（中断、中断底半部、线程）都是安全的。

函数说明

xwmm_sma_alloc()

xwer_t xwmm_sma_alloc	(	struct xwmm_sma *	sa,
		xwsz_t	size,
		xwsz_t	aligned,
		void **	membuf
	)

XWMM API：从简单内存分配器中申请内存

参数

[in]	sa	简单内存分配器对象
[in]	size	大小
[in]	aligned	申请到的内存的首地址需要对齐到的边界
[out]	membuf	指向地址缓存的指针，通过此指针缓存返回申请到的内存的首地址

返回

错误码

返回值

-EFAULT	空指针
-EINVAL	参数无效
-ENOMEM	内存不足

注解

• 同步/异步：同步
• 上下文：中断、中断底半部、线程
• 重入性：可重入

< 内存管理对齐的字节数

< 内存管理未对齐掩码

< 内存管理对齐的字节数

< 内存管理对齐的字节数

< 内存管理对齐的字节数

<No error

<No error

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

{
        xwsq_t cpos;
        xwsq_t npos;
        xwsq_t tmp;
        xwer_t rc;
 
        XWOS_VALIDATE((sa), "nullptr", -EFAULT);
        XWOS_VALIDATE((membuf), "nullptr", -EFAULT);
 
        if ((xwsz_t)0 == size) {
                rc = -EINVAL;
                *membuf = NULL;
                goto err_inval;
        }
 
        if ((xwsz_t)0 != (aligned & XWMM_UNALIGNED_MASK)) {
                rc = -EINVAL;
                *membuf = NULL;
                goto err_inval;
        }
 
        if ((xwsz_t)0 == aligned) {
                aligned = XWMM_ALIGNMENT; // cppcheck-suppress [misra-c2012-17.8]
        }
 
        // cppcheck-suppress [misra-c2012-17.8]
        size = XWBOP_ALIGN(size, (xwsz_t)XWMM_ALIGNMENT);
        do {
                cpos = xwaop_load(xwsq_t, &sa->pos, xwaop_mo_acquire);
                tmp = XWBOP_ALIGN((sa->zone.origin + cpos), aligned);
                npos = size + tmp - sa->zone.origin;
                if (npos > sa->zone.size) {
                        rc = -ENOMEM;
                        *membuf = NULL;
                        goto err_nomem;
                }
                *membuf = (void *)tmp;
        } while (XWOK != xwaop_teq_then_write(xwsq_t, &sa->pos, cpos, npos, NULL));
        return XWOK;
 
err_nomem:
err_inval:
        return rc;
}

xwmm_sma_free()

xwer_t xwmm_sma_free	(	struct xwmm_sma *	sa,
		void *	mem
	)

XWMM API：释放内存

参数

[in]	sa	简单内存分配器对象
[in]	mem	内存的首地址

返回

错误码

注解

• 同步/异步：同步
• 上下文：中断、中断底半部、线程
• 重入性：可重入

• Dummy函数，简单内存分配器不支持释放内存。

< 去除未使用变量的警告

< 去除未使用变量的警告

<No error

在文件 sma.c 第 89 行定义.

{
        XWOS_UNUSED(sa);
        XWOS_UNUSED(mem);
        return XWOK;
}

xwmm_sma_init()

xwer_t xwmm_sma_init	(	struct xwmm_sma *	sa,
		xwptr_t	origin,
		xwsz_t	size,
		xwsq_t	pos,
		const char *	name
	)

XWMM API：初始化简单内存分配器对象

参数

[in]	sa	简单内存分配器对象
[in]	origin	内存区域的首地址
[in]	size	内存区域的大小
[in]	pos	内存区域的位置
[in]	name	分配器的名字

返回

错误码

返回值

XWOK	没有错误
-EINVAL	内存的大小无效

注解

• 同步/异步：同步
• 上下文：中断、中断底半部、线程
• 重入性：不可重入

< 内存管理对齐的字节数

< 内存管理对齐的字节数

<No error

在文件 sma.c 第 20 行定义.

{
        xwer_t rc;
 
        // cppcheck-suppress [misra-c2012-17.8]
        pos = XWBOP_ALIGN(pos, (xwsz_t)XWMM_ALIGNMENT);
        if (size < pos) {
                rc = -EINVAL;
        } else {
                rc = XWOK;
                sa->zone.origin = origin;
                sa->zone.size = size;
                sa->pos = pos;
                sa->name = name;
        }
        return rc;
}