manage_ipcache 实用工具 - 2023.2 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 简体中文

为了在应用设计中进行内核综合期间提供更好的性能,AMD Vitis™ 编译器使用 IP 高速缓存来存储和复用综合结果。这样即可使 .xclbin 文件的构建进程免于为未曾发生更改的内核与 CU 重复执行综合。IP 高速缓存可以存储综合结果,并将其应用于设计中未更改的内核。

默认情况下,IP 高速缓存存储在工程的 Vitis IDE 工作空间内,或者从命令行运行 v++ 时,IP 高速缓存存储在构建级别。您可使用 --remote_ip_cache 指定新位置以便自定义 IP 高速缓存的位置,或者也可以使用 --no_ip_cache 来禁用 IP 高速缓存的使用。如需了解有关这些选项的更多信息,请参阅 v++ 常规选项

manage_ipcache 实用工具是一个独立实用工具,可帮助您管理自己的 IP 高速缓存存储库内容。它允许您报告 IP 高速缓存存储库的统计数据,并基于各种条件来移除其中条目。

表 1. manage_ipcache 选项
选项 描述
-c | --cache 必需。指定要使用的 IP 高速缓存目录。
-d | --disk_space <size> 删除除最近使用的条目以外的所有条目,保留的条目应与指定的磁盘空间大小(以 MB 为单位)匹配。
-h | --help 打印 manage_ipcache 命令的帮助。
-k | --keep_top <N> 删除除最近使用的前 N 个条目(N 为整数)外的所有条目。
-o | --outfile <file> 报告指定文件的 IP 高速缓存统计数据。
-p | --purge 删除所有高速缓存条目。
-r | --report 报告 stdout 的 IP 高速缓存的统计数据。
-u | --unused 删除从未曾使用(无缓存命中)的高速缓存条目。
以下示例报告了指定 IP 高速缓存的条目:
manage_ipcache --cache ./ip_cache --report

manage_ipcache 命令如果成功,则返回 0,如果发生错误,则返回 -1。