函数：mem_set_pid_to_shareable_handle

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

设置可共享内存的进程白名单，只有配置了白名单的进程才能用acl.rt.mem_export_to_shareable_handle接口导出的shareable_handle。

本接口需与其它接口配合使用，以便实现内存共享的目的，请参见acl.rt.mem_export_to_shareable_handle接口处的说明。

C函数原型

aclError aclrtMemSetPidToShareableHandle(uint64_t shareableHandle, int32_t *pid, size_t pidNum)

python函数

ret = acl.rt.mem_set_pid_to_shareable_handle(shareable_handle, pid)

参数名	说明
shareable_handle	int，通过acl.rt.mem_export_to_shareable_handle接口导出的shareable_handle。
pid	int，用于存放白名单进程ID的数组。进程ID可调用acl.rt.device_get_bare_tgid接口获取，Docker场景下获取到的是物理机上的进程ID，非Docker场景下获取到的是进程ID。

参数名

说明

shareable_handle

int，通过acl.rt.mem_export_to_shareable_handle接口导出的shareable_handle。

pid

int，用于存放白名单进程ID的数组。

进程ID可调用acl.rt.device_get_bare_tgid接口获取，Docker场景下获取到的是物理机上的进程ID，非Docker场景下获取到的是进程ID。

返回值	说明
ret	int，错误码，返回0表示成功，返回其它值表示失败。

在调用aclrtMemExportToShareableHandle接口的进程中，调用本接口设置进程白名单。

Ascend RC形态不支持调用本接口。

父主题： 内存管理