aclrtProfTrace

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

Delivers a custom profiling logging task at a specified position on the network. This API is asynchronous.

Prototype

aclError aclrtProfTrace(void *userdata, int32_t length, aclrtStream stream)

Parameters

Parameter	Input/Output	Description
userdata	Input	Custom information.
length	Input	Length of user data, in bytes. It is recommended that length be set to 18 bytes. If it is less than 18 bytes, 0s are automatically added to the end of the data until the length reaches 18 bytes. If the length exceeds 18 bytes, an error is reported.
stream	Input	Stream for executing the logging task. For details about the type definition, see aclrtStream.

Parameter

Input/Output

Description

userdata

Input

Custom information.

length

Input

Length of user data, in bytes.

It is recommended that length be set to 18 bytes. If it is less than 18 bytes, 0s are automatically added to the end of the data until the length reaches 18 bytes. If the length exceeds 18 bytes, an error is reported.

stream

Input

Stream for executing the logging task. For details about the type definition, see aclrtStream.

Returns

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

Parent topic: Other APIs