aclrtProfTrace

Applicability

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

Description

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