已合并
[Profiling]文档补充说明 msprof/msprobe 子仓的 gitcode 访问凭证要求 #441
zhengkai创建于 7月21日
[Profiling]文档补充说明 msprof/msprobe 子仓的 gitcode 访问凭证要求 #441
已合并
共 3 个文件变更+5-0
| @@ -124,6 +124,7 @@ bash build.sh --cann_3rd_lib_path=${third_party_path} | |||
| 124 | 124 | ||
| 125 | - `--cann_3rd_lib_path`：第三方库存储目录，默认值为 `./third_party`。若本地不存在第三方库，编译脚本将自动从 gitcode 开源仓库下载各第三方库源码。 | 125 | - `--cann_3rd_lib_path`：第三方库存储目录，默认值为 `./third_party`。若本地不存在第三方库，编译脚本将自动从 gitcode 开源仓库下载各第三方库源码。 |
| 126 | - 编译过程中会自动下载闭源二进制包，该包含有保证功能正常运行所需的库及头文件，且仅提供 release 版本，**即使编译选项指定为 debug，也只会下载 release 版本的 tar 包**。 | 126 | - 编译过程中会自动下载闭源二进制包，该包含有保证功能正常运行所需的库及头文件，且仅提供 release 版本，**即使编译选项指定为 debug，也只会下载 release 版本的 tar 包**。 |
| 127 | +- 编译过程中会通过 `git clone` 拉取 `msprof` 和 `msprobe` 子仓（分别用于构建 msprof 分析 wheel 和同步 msaccucmp 工具）。子仓源码位于 gitcode，使用 HTTPS 协议克隆前需[配置 gitcode 个人访问令牌](https://gitcode.com/setting/token-classic)以替代登录密码，否则克隆会失败。 | ||
| 127 | - 若编译环境无法访问网络，请参考[离线编译环境准备](./docs/zh/quick_install.md#离线编译环境准备)提前完成依赖包的下载与配置，并通过 `--cann_3rd_lib_path` 参数指定依赖包所在目录后再执行编译。 | 128 | - 若编译环境无法访问网络，请参考[离线编译环境准备](./docs/zh/quick_install.md#离线编译环境准备)提前完成依赖包的下载与配置，并通过 `--cann_3rd_lib_path` 参数指定依赖包所在目录后再执行编译。 |
| 128 | - 闭源二进制包会解压到仓库根目录的 `bundle/` 下。若 `bundle/` 已存在且非空，构建会复用该目录并跳过下载；如需强制重新下载或修复残缺的 `bundle/` 目录，可执行 `bash build.sh --make_clean` 后重新编译，也可手动删除 `bundle/` 后再次执行 `bash build.sh`。 | 129 | - 闭源二进制包会解压到仓库根目录的 `bundle/` 下。若 `bundle/` 已存在且非空，构建会复用该目录并跳过下载；如需强制重新下载或修复残缺的 `bundle/` 目录，可执行 `bash build.sh --make_clean` 后重新编译，也可手动删除 `bundle/` 后再次执行 `bash build.sh`。 |
| 129 | - 更多编译参数请通过 `bash build.sh -h` 查看。 | 130 | - 更多编译参数请通过 `bash build.sh -h` 查看。 |
| @@ -125,6 +125,7 @@ bash build.sh --cann_3rd_lib_path=${third_party_path} | |||
| 125 | Parameters: | 125 | Parameters: |
| 126 | - `--cann_3rd_lib_path`: The directory for storing third-party libraries. The default value is `./third_party`. If third-party libraries do not exist locally, the build script automatically downloads the source code of each third-party library from the gitcode open source repository. | 126 | - `--cann_3rd_lib_path`: The directory for storing third-party libraries. The default value is `./third_party`. If third-party libraries do not exist locally, the build script automatically downloads the source code of each third-party library from the gitcode open source repository. |
| 127 | - The build process automatically downloads closed-source binary packages that contain the libraries and header files required for normal operation. Only release versions are provided. **Even if the build option specifies debug, only the release version tar package is downloaded**. | 127 | - The build process automatically downloads closed-source binary packages that contain the libraries and header files required for normal operation. Only release versions are provided. **Even if the build option specifies debug, only the release version tar package is downloaded**. |
| 128 | +- The build process clones the `msprof` and `msprobe` submodules via `git clone` (used for building the msprof analysis wheel and syncing the msaccucmp tool, respectively). These submodules are hosted on gitcode and require a [gitcode personal access token](https://gitcode.com/setting/token-classic) configured for HTTPS cloning; otherwise, the clone will fail. | ||
| 128 | - If the build environment cannot access the network, refer to [Offline Build Environment Preparation](docs/en/quick_install.md#offline-build-environment-preparation) to complete the download and configuration of dependency packages in advance. Then specify the dependency package directory through the `--cann_3rd_lib_path` parameter before running the build. | 129 | - If the build environment cannot access the network, refer to [Offline Build Environment Preparation](docs/en/quick_install.md#offline-build-environment-preparation) to complete the download and configuration of dependency packages in advance. Then specify the dependency package directory through the `--cann_3rd_lib_path` parameter before running the build. |
| 129 | - Closed-source binary packages are extracted to `bundle/` in the repository root. If `bundle/` already exists and is non-empty, the build reuses it and skips downloading. To force a fresh download or recover from an incomplete `bundle/`, run `bash build.sh --make_clean` before rebuilding, or manually delete `bundle/` and run `bash build.sh` again. | 130 | - Closed-source binary packages are extracted to `bundle/` in the repository root. If `bundle/` already exists and is non-empty, the build reuses it and skips downloading. To force a fresh download or recover from an incomplete `bundle/`, run `bash build.sh --make_clean` before rebuilding, or manually delete `bundle/` and run `bash build.sh` again. |
| 130 | - For more build parameters, run `bash build.sh -h`. | 131 | - For more build parameters, run `bash build.sh -h`. |
| @@ -39,6 +39,9 @@ msprof: | |||
| 39 | release: | 39 | release: |
| 40 | - src/msprof | 40 | - src/msprof |
| 41 | unrelease: | 41 | unrelease: |
| 42 | + - src/msprof/collector/basic/osal/osal_linux.c | ||
| 43 | + - src/msprof/collector/basic/osal/osal_linux_mem.c | ||
| 44 | + - src/msprof/collector/dvvp/profhal/adx/wrapper/adx_prof_api.cpp | ||
| 42 | llt: | 45 | llt: |
| 43 | ut_check: true | 46 | ut_check: true |
| 44 | st_check: false | 47 | st_check: false |