aclnn Return Codes

Table 1 describes the common return codes when the APIs are called.

**Table 1** Returned status codes
Status Code	Value	Description
ACLNN_SUCCESS	0	Success.
ACLNN_ERR_PARAM_NULLPTR	161001	Parameter verification error. Parameters contain null pointers which are invalid.
ACLNN_ERR_PARAM_INVALID	161002	Parameter verification error. For example, the two input data types do not meet the data type deduction requirements. To obtain the detailed error messages, call "aclGetRecentErrMsg".
ACLNN_ERR_RUNTIME_ERROR	361001	An error occurs when the API memory calls the NPU Runtime API.
ACLNN_ERR_INNER_XXX	561xxx	An internal error occurs in the API. To obtain the detailed error messages, call "aclGetRecentErrMsg". NOTE: The common internal errors are as follows. For other errors, troubleshoot them based on the error information or contact technical support. (You can obtain logs and then click Link to contact technical support.) 561101 (ACLNN_ERR_INNER_CREATE_EXECUTOR): The API fails to create aclOpExecutor. (Possible cause: OS exception). 561102 (ACLNN_ERR_INNER_NOT_TRANS_EXECUTOR): The API does not call uniqueExecutor ReleaseTo. 561103 (ACLNN_ERR_INNER_NULLPTR): In the aclnn API, the null pointer error occurs.

For more information about ACLNN_ERR_INNER_XXX status codes, see Table 2.

**Table 2** Abnormal status codes
Status Code	Value	Description
ACLNN_ERR_INNER	561000	Inner error: An inner error occurs in the API.
ACLNN_ERR_INNER_INFERSHAPE_ERROR	561001	Inner error: An error occurs when the API infers the output shape.
ACLNN_ERR_INNER_TILING_ERROR	561002	Inner error: An error occurs when the API performs tiling on the NPU kernel.
ACLNN_ERR_INNER_FIND_KERNEL_ERROR	561003	Inner error: An error occurs when the API searches for the NPU kernel. (Possible cause: The operator binary package is not installed.)
ACLNN_ERR_INNER_CREATE_EXECUTOR	561101	Inner error: The API fails to create aclOpExecutor. (Possible cause: OS exception)
ACLNN_ERR_INNER_NOT_TRANS_EXECUTOR	561102	Inner error: The API does not call uniqueExecutor ReleaseTo.
ACLNN_ERR_INNER_NULLPTR	561103	Inner error: In the aclnn API, the null pointer error occurs.
ACLNN_ERR_INNER_WRONG_ATTR_INFO_SIZE	561104	Inner error: In the aclnn API, the number of operator attributes is wrong.
ACLNN_ERR_INNER_KEY_CONFILICT	561105	Inner error: In the aclnn API, the hash keys matching the operator kernel conflict.
ACLNN_ERR_INNER_INVALID_IMPL_MODE	561106	Inner error: In the aclnn API, the implementation mode parameter of the operator is invalid.
ACLNN_ERR_INNER_OPP_PATH_NOT_FOUND	561107	Inner error: In the aclnn API, the environment variable ASCEND_OPP_PATH to be configured is not detected.
ACLNN_ERR_INNER_LOAD_JSON_FAILED	561108	Inner error: In the aclnn API, the operator information file (.json) in the kernel library fails to be loaded.
ACLNN_ERR_INNER_JSON_VALUE_NOT_FOUND	561109	Inner error: In the aclnn API, a field in the operator information file (.json) in the kernel library fails to be loaded.
ACLNN_ERR_INNER_JSON_FORMAT_INVALID	561110	Inner error: In the aclnn API, the format of the operator information file (.json) in the kernel library is invalid.
ACLNN_ERR_INNER_JSON_DTYPE_INVALID	561111	Inner error: In the aclnn API, the dtype value in the operator information file (.json) in the kernel library is invalid.
ACLNN_ERR_INNER_OPP_KERNEL_PKG_NOT_FOUND	561112	Inner error: In the aclnn API, the binary kernel library of the operator is not loaded.
ACLNN_ERR_INNER_OP_FILE_INVALID	561113	Inner error: In the aclnn API, an error occurs when a field in the operator file (.json) is loaded.
ACLNN_ERR_INNER_ATTR_NUM_OUT_OF_BOUND	561114	Inner error: In the aclnn API, the number of operator attributes is greater than that specified in the operator information file (.json).
ACLNN_ERR_INNER_ATTR_LEN_NOT_ENOUGH	561115	Inner error: In the aclnn API, the number of operator attributes is less than that specified in the operator information file (.json).
ACLNN_ERR_INNER_INPUT_NUM_IN_JSON_TOO_LARGE	561116	Inner error: In the aclnn API, the number of input operators exceeds the upper limit 32.
ACLNN_ERR_INNER_INPUT_JSON_IS_NULL	561117	Inner error: In the aclnn API, the operator information in the JSON file is missing.
ACLNN_ERR_INNER_STATIC_WORKSPACE_INVALID	561118	Inner error: In the aclnn API, an error occurs when the workspace information in the static binary .json file is parsed.
ACLNN_ERR_INNER_STATIC_BLOCK_DIM_INVALID	561119	Inner error: In the aclnn API, an error occurs when the number of used cores in the static binary .json file is parsed.

Parent topic: Framework Capability APIs