handle_read_plan_cache_from_file#

nvmath.bindings.cutensor.handle_read_plan_cache_from_file( intptr_t handle, filename, ) → uint32_t[source]#

Reads a Plan-Cache from file and overwrites the cachelines of the provided handle.

Parameters:

handle (intptr_t) – Opaque handle holding cuTENSOR’s library context.
filename (str) – Specifies the filename (including the absolute path) to the file that holds all the cache information that have previously been written by cutensorHandleWritePlanCacheToFile.

Returns:

On exit, this variable will hold the number of successfully-read cachelines, if CUTENSOR_STATUS_SUCCESS is returned. Otherwise, this variable will hold the number of cachelines that are required to read all cachelines associated to the cache pointed to by filename; in that case CUTENSOR_STATUS_INSUFFICIENT_WORKSPACE is returned.

Return type:

uint32_t