Function: free

Applicable Products

Product	Supported (√/x)
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Description

Frees device memory.

Prototype

C Prototype
1
aclError aclrtFree(void *devPtr)
Python Function
1
ret= acl.rt.free(dev_ptr)

Parameters

Parameter	Description
dev_ptr	Int, pointer address of the memory to be freed.

Return Values

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Restrictions

acl.rt.free frees device memory through the acl.rt.malloc or acl.rt.malloc_cached API.
This API immediately frees the input memory. No implicit device synchronization or stream synchronization is performed within the function. Ensure that the memory pointer is not accessed after this API is called.

Parent topic: Device Memory Allocation and Deallocation