---
title: 头文件和库文件说明
description: "GE图引擎接口头文件在如下目录："
url: https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/latest/API/ascendgraphapi/atlasgeapi_07_0164.html
sourcePath: /source/zh/CANNCommunityEdition/920beta1/API/ascendgraphapi/atlasgeapi_07_1058.html
indexId: 2a2b459516ddbaf90655eac430ee60393f59e7527dfc874d685ac677be0b407f83
---
# 头文件和库文件说明

GE图引擎接口头文件在如下目录：

- 编译类接口：

  - ${INSTALL_DIR}/include/ge/
  - ${INSTALL_DIR}/include/parser/
  - ${INSTALL_DIR}/include/acl/
- 执行类接口：

  - ${INSTALL_DIR}/include/ge/
  - ${INSTALL_DIR}/include/graph/
  - ${INSTALL_DIR}/include/external/
  - ${INSTALL_DIR}/include/acl/
  - ${INSTALL_DIR}/include/register/
  - ${INSTALL_DIR}/include/transformer/
  - ${INSTALL_DIR}/pkg_inc/register

库文件在“${INSTALL_DIR}/lib64/”目录下，${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。

#### ge-compiler编译类接口

| 定义接口的头文件 | 用途 | 对应的库文件 |
| --- | --- | --- |
| ge/hcom\_gradient\_split\_tune.h | HCOM梯度切分调优指标、输入和结果接口。 | libhcom\_gradient\_split\_tune.so |
| ge/hcom\_ops\_stores.h | HCOM插件初始化及 OpsKernelInfoStore/GraphOptimizer 查询接口。 | libhcom\_graph\_adaptor.so |
| ge/ge\_ir\_build.h | aclgrphBuild\*、模型编译、保存及权重可刷新图接口。 | libge\_compiler.so |
| ge/ge\_utils.h | GE改图、Shape 推导、节点支持校验等工具接口。 | libge\_compiler.so |
| ge/fusion/graph\_rewriter.h | 子图替换和改图接口。 | libge\_compiler.so |
| ge/fusion/match\_result.h | Pattern匹配结果与捕获节点/张量访问。 | libge\_compiler.so |
| ge/fusion/graph\_fuse\_inspector\_utils.h | 融合前合法性检查及融合结果上报。 | libge\_compiler.so |
| ge/fusion/pattern.h | 定义待匹配图模式及捕获张量。 | libge\_compiler.so |
| ge/fusion/pattern\_matcher.h | 在目标图上执行Pattern匹配。 | libge\_compiler.so |
| ge/fusion/subgraph\_boundary.h | 描述子图输入、输出和边界。 | libge\_compiler.so |
| ge/fusion/pattern\_matcher\_config.h | 配置PatternMatcher匹配行为。 | libge\_compiler.so |
| ge/fusion/infer\_shape\_util.h | 融合/替换图的Shape推导辅助接口。 | libge\_compiler.so |
| ge/fusion/pass/decompose\_pass.h | 一对多算子分解Pass接口及注册宏。 | libge\_compiler.so |
| ge/fusion/pass/fusion\_base\_pass.h | 自定义融合Pass纯抽象基类。 | Header\-only接口；具体Pass框架消费libge\_compiler.so |
| ge/fusion/pass/fusion\_pass\_reg.h | 融合Pass注册数据和注册器。 | libge\_compiler.so |
| ge/fusion/pass/pattern\_fusion\_pass.h | Pattern融合Pass基类和替换流程。 | libge\_compiler.so |
| parser/caffe\_parser.h | Caffe 模型解析为GE Graph。 | libfmk\_parser.so |
| parser/onnx\_parser.h | ONNX 模型解析为GE Graph。 | libfmk\_onnx\_parser.so |
| parser/tensorflow\_parser.h | TensorFlow模型解析为GE Graph。 | libfmk\_parser.so |
| ge/ge\_api.h | GE初始化、Session、Graph添加/编译/执行等V1 API。 | libge\_runner.so |
| ge/ge\_api\_v2.h | GESession、V2图加载与执行接口。 | libge\_runner\_v2.so |
| ge/ge\_feature\_memory.h | 编译结果的Feature Memory描述。 | libge\_common\_base.so（实际符号归属；上层编译流程同时使用libge\_compiler.so） |
| ge/ge\_graph\_compile\_summary.h | 编译结果、流分配、外置权重摘要。 | libge\_compiler.so |
| ge/esb\_funcs.h | ES构图器C ABI。 | libeager\_style\_graph\_builder\_base.so |
| ge/compliant\_node\_builder.h | 按IR规范构造节点的链式Builder。 | libeager\_style\_graph\_builder\_base.so |
| ge/es\_c\_graph\_builder.h | ES C Graph Builder封装。 | libeager\_style\_graph\_builder\_base.so |
| ge/es\_c\_tensor\_holder.h | ES C TensorHolder封装。 | libeager\_style\_graph\_builder\_base.so |
| ge/es\_graph\_builder.h | C++模板化ES Graph Builder门面。 | Header\-only门面；调用 libeager\_style\_graph\_builder\_base.so的C ABI |
| ge/es\_tensor\_holder.h | C++ ES TensorHolder接口。 | libeager\_style\_graph\_builder\_base.so |
| ge/es\_tensor\_like.h | ES TensorLike描述与转换接口。 | libeager\_style\_graph\_builder\_base.so |
| acl/acl\_op\_compiler.h | 单算子编译、编译并执行及编译选项接口。 | libacl\_op\_compiler.so |


#### ge-executor执行类接口

| 定义接口的头文件 | 用途 | 对应的库文件 |
| --- | --- | --- |
| ge/ge\_api\_types.h | GE公共状态、张量、图和Session相关类型的聚合入口。 | Header\-only聚合头；按实际接口链接 libgraph.so/libgraph\_base.so等 |
| ge/ge\_api\_error\_codes.h | GEAPI 错误码注册与字符串转换接口。 | libge\_common\_base.so |
| ge/ge\_external\_weight\_desc.h | 外置权重位置、长度和属性描述接口。 | libge\_common\_base.so |
| external/ge\_common/ge\_api\_types.h | 兼容旧路径的GE API类型聚合入口。 | Header\-only兼容头；按实际接口链接对应库 |
| external/ge\_common/ge\_common\_api\_types.h | GE公共枚举、结构体和基础API类型定义。 | Header\-only定义头 |
| acl/acl\_mdl.h | ACL模型加载、执行、动态Shape和模型配置接口。 | libacl\_mdl.so（公开门面；运行时内部还会依赖模型执行实现库） |
| acl/acl\_base\_mdl.h | ACL模型基础类型、数据集和描述接口。 | libacl\_mdl.so（公开门面） |
| acl/acl\_op.h | ACL单算子描述、执行及算子属性接口。 | libacl\_op\_executor.so（公开门面；内部实现依赖不作为应用直链接口） |
| acl/ops/acl\_cblas.h | ACL CBLAS/矩阵计算接口。 | libacl\_cblas.so |
| exe\_graph/runtime/eager\_op\_execution\_context.h | Eager算子执行时的输入、输出、Stream和Workspace上下文。 | liblowering.so |
| exe\_graph/runtime/op\_compile\_context.h | 算子编译、Tiling和Shape推导上下文。 | liblowering.so |
| graph/graph.h | GE Graph创建、增删节点、输入输出与图属性接口。 | libgraph.so |
| graph/ct\_infer\_shape\_range\_context.h | 编译期Shape Range推导上下文。 | Header\-only接口；主要消费库libgraph.so |
| graph/ct\_infer\_shape\_context.h | 编译期Shape推导上下文。 | Header\-only接口；主要消费库libgraph.so |
| graph/operator\_reg.h | 算子原型、输入输出、属性和推导函数注册宏。 | libgraph.so为主要注册实现，并使用libgraph\_base.so基础能力 |
| graph/gnode.h | Graph节点查询、连接关系和属性访问接口。 | libgraph.so |
| graph/graph\_buffer.h | 图序列化Buffer的创建、读写和生命周期接口。 | libgraph\_base.so |
| graph/inference\_context.h | Shape/Value推导的上下文、Marks和资源管理接口。 | libgraph.so |
| graph/attr\_value.h | Graph属性值类型及序列化访问接口。 | libgraph.so |
| graph/operator.h | GE Operator创建、连接、属性和描述访问接口。 | libgraph\_base.so |
| graph/operator\_factory.h | 按类型创建Operator及查询算子注册信息。 | libgraph.so |
| graph/resource\_context.h | 图资源上下文的抽象接口和资源键。 | Header\-only接口；主要消费库libgraph.so |
| graph/kernel\_launch\_info.h | Kernel Launch参数、句柄和注册信息描述。 | libregister.so |
| graph/arg\_desc\_info.h | Kernel参数描述信息。 | libgraph.so |
| graph/custom\_op.h | 自定义算子注册、推导和验证宏。 | libgraph.so（主要公开注册符号） |
| graph/hcom\_executor.h | HCOM图执行器初始化、Finalize和执行接口。 | libhcom\_executor.so |
| register/register\_base.h | GE注册机制基础类、宏和优先级定义。 | libregister.so |
| register/op\_lib\_register.h | 算子库、OpInfo与OpsKernelInfoStore注册接口。 | libregister.so |
| register/register\_custom\_pass.h | 自定义图Pass注册及执行时机配置。 | libregister.so |
| register/op\_binary\_resource\_manager.h | 算子二进制资源注册、查询和生命周期管理。 | libregister.so |
| register/scope/scope\_fusion\_pass\_register.h | Scope Fusion Pass注册、规则和结果接口。 | libregister.so |
| transformer/transfer\_def.h | Format/Shape转换公共结构和枚举定义。 | Header\-only定义头；主要消费库libgraph.so |
| transformer/transfer\_shape\_according\_to\_format\_ext.h | 按源/目标Format转换Shape。 | libgraph.so |
| pkg\_inc/register/amct\_interface.h | AMCT插件回调及量化相关抽象接口。 | Header\-only插件接口；宿主侧主要消费库libregister.so |
| pkg\_inc/register/amct\_registry.h | AMCT插件注册、查询和实例创建。 | libregister.so |