aclrtNotifySetImportPid

Applicability

Product	Supported
Atlas 350 Accelerator Card	x
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	x
Atlas inference product	√
Atlas training product	√

Function

Sets the trustlist of processes that can share a Notify object.

This API must be used with other APIs to synchronize tasks between processes on multiple devices. For details, see aclrtNotifyGetExportKey.

Prototype

aclError aclrtNotifySetImportPid(aclrtNotify notify, int32_t *pid, size_t num)

Parameters

Parameter	Input/Output	Description
notify	Input	Notify object. For the type definition, see aclrtNotify. The value must be the same as that of Notify in the aclrtNotifyGetExportKey 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 obtained. In the non-Docker scenario, the process ID is obtained.
num	Input	Number of processes in the trustlist. The value must be the same as the size of the pid parameter array.

Parameter

Input/Output

Description

notify

Input

Notify object. For the type definition, see aclrtNotify.

The value must be the same as that of Notify in the aclrtNotifyGetExportKey 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 obtained. In the non-Docker scenario, the process ID is obtained.

num

Input

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

Returns

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

Restrictions

This operation is not supported in the Ascend virtual instance scenario.

Parent topic: Notify Management