aclrtMemSetPidToShareableHandle

Applicable Products

Product

Supported

Ascend 950PR

√

Ascend 950DT

☓

Atlas A3 training products/Atlas A3 inference products

√

Atlas A2 training products/Atlas A2 inference products

√

Atlas 200I/500 A2 inference products

√

Atlas inference products

√

Atlas training products

√

Function

Sets the trustlist of processes that can share memory.

This API is used to set the process trustlist while calling the aclrtMemExportToShareableHandle API. This API must work with other APIs to implement memory sharing. For details, see the description of aclrtMemExportToShareableHandle.

Prototype

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

Parameters

Parameter

Input/Output

Description

shareableHandle

Input

shareableHandle exported through the aclrtMemExportToShareableHandle API.

pid

Input

Array for storing trustlisted process IDs.

You can call aclrtDeviceGetBareTgid to obtain the process ID. In the Docker scenario, the process ID on the physical machine is returned. In non-Docker scenarios, the process ID is returned.

pidNum

Input

Number of processes in the trustlist. The value must be the same as the size of the pid array.

Returns

0 on success; otherwise, failure. For details, see aclError.