使用匿名共享内存(Ashmem, Anonymous Shared Memory)

概述

使用linux内核提供的驱动dev/ashmem，申请内核空间中的一块内存区域并映射至用户空间。利用其共享机制，可以实现较大数据量的进程间通信。

涉及功能

OHOS::Ashmem

C++公共基础库中的Ashmem实现，用于操作匿名共享内存(Ashmem)。

具体描述

class OHOS::Ashmem;

具体操作包括创建并映射一块ashmem内存区域并对其进行读写等。提示: 尽管被智能指针管理，Ashmem对象仍需手动解除映射并关闭。

#include <ashmem.h>

继承自 OHOS::RefBase

Public Functions

返回类型	名称
sptr< Ashmem >	CreateAshmem(const char* name, int32_t size) 使用指定名称及大小创建Ashmem对象。
	Ashmem(int fd, int32_t size) 构造Ashmem对象。
	~Ashmem() override
void	CloseAshmem() 通过文件描述符关闭当前ashmem。
int	GetAshmemFd() const 获取内核中对应ashmem的文件描述符。
int32_t	GetAshmemSize() 获取内核中ashmem区域的大小。
int	GetProtection() 获取内核中的ashmem区域的保护权限值。
bool	MapAshmem(int mapType) 将内核中的ashmem内存区域映射至用户空间。
bool	MapReadAndWriteAshmem() 以读/写模式映射ashmem内存区域。
bool	MapReadOnlyAshmem() 以只读模式映射ashmem内存区域。
const void *	ReadFromAshmem(int32_t size, int32_t offset) 从ashmem内存区域`offset`处读出数据。
bool	SetProtection(int protectionType) 设置内核中的ashmem区域的保护权限。
void	UnmapAshmem() 解除ashmem映射。
bool	WriteToAshmem(const void* data, int32_t size, int32_t offset) 在ashmem内存区域`offset`处写入数据。

使用示例

使用方法(伪代码)

sptr<Ashmem> ashmem = Ashmem::CreateAshmem(MEMORY_NAME.c_str(), MEMORY_SIZE);
if (ashmem != nullptr) {
    bool ret = ashmem->MapAshmem(PROT_READ | PROT_WRITE);
}

...

// 当使用结束时不要忘记解映射和关闭ashmem
ashmem->UnmapAshmem();
ashmem->CloseAshmem();

测试用例编译运行方法

测试用例代码参见 base/test/unittest/common/utils_ashmem_test.cpp
使用开发者自测试框架，使用方法参见：开发自测试执行框架-测试用例执行
使用以下具体命令以运行ashmem.h对应测试用例

run -t UT -tp utils -ts UtilsAshmemTest

常见问题

Ashmem对象使用结束后需要手动解除映射并关闭
- 智能指针仅管理Ashmem对象的析构，而Ashmem对象析构时不会解除内存空间的映射并关闭。
- 使用UnmapAshmem()解除映射并使用CloseAshmem()关闭。

3.0 KiB Raw Blame History Unescape Escape