Header Files and Library Files
API Category
The API names are prefixed with acl and in the format of acl+API category abbreviation+*. The asterisk (*) indicates the operation verb and object, both of which are capitalized. In this document, APIs are referred to as acl APIs.
API Prefix |
Description |
|---|---|
aclop |
Single-operator model execution APIs |
aclblas |
BLAS APIs |
aclmdl |
Model inference APIs |
Dependent Header Files and Library Files
You can reference the header files and library files of acl APIs for compiling and running your apps only after the firmware, driver, and CANN software are installed.
Include the dependency header files based on the acl APIs to be called. Refer to the table below for details.
The header files of acl APIs are stored in the ${INSTALL_DIR}/include/ directory, and the library files are stored in the ${INSTALL_DIR}/lib64/ directory. Replace ${INSTALL_DIR} with the CANN component directory. For example, if the installation is performed by the root user, the default file storage path is /usr/local/Ascend/cann.
When building code based on acl APIs, depend on the corresponding library files based on the include header files. If redundant .so files (such as libascendcl.a) are referenced, version functions may be abnormal or there may be compatibility issues during a version update.
Header File |
Function |
Matching Library File |
|---|---|---|
acl/acl_mdl.h |
Declares the model management APIs. |
libacl_mdl.so libascendcl.so is supported in earlier versions to avoid compatibility issues. However, it will not be supported in later versions. Therefore, you are advised to use libacl_mdl.so to ensure compatibility with later versions. |
acl/acl_op.h acl/acl_op_compiler.h |
Declares single-operator calling APIs (including only single-operator model execution APIs). |
libacl_op_executor.so libacl_op_compiler.so libascendcl.so is supported in earlier versions to avoid compatibility issues. However, it will be removed in later versions. Therefore, you are advised to use libacl_op_executor.so and libacl_op_compiler.so to ensure compatibility with later versions. |
acl/ops/acl_cblas.h |
Declares the CBLAS APIs. |
libacl_cblas.so |