命令行用法
# vaitrace --help
usage: vaitrace [-h] [-c [CONFIG]] [-d] [-o [TRACESAVETO]] [-t [TIMEOUT]] [-v]
[-b] [-p] [--va] [--xat] [--txt_summary] [--fine_grained]
...
positional arguments:
cmd
optional arguments:
-h, --help show this help message and exit
-c [CONFIG] Specify the config file
-d Enable debug
-o [TRACESAVETO] Save report to, only available for txt summary mode
-t [TIMEOUT] Tracing time limitation
-v Show version
-b Bypass vaitrace, just run command
-p Trace python application
--va Generate trace data for Vitis Analyzer
--xat Save raw data for debug usage
--txt_summary Display txt summary
--fine_grained Fine-grained mode
以下提供了一些重要且常用的实参:
- cmd
- cmd 是一个可执行的 Vitis AI 追踪程序,包括程序名称和参数。
- -t
- 控制追踪时间(以毫秒为单位),从启动 [cmd] 开始计算,默认值为 30。换言之,如果,针对 vaitrace 不指定 -t,那么在 [cmd] 持续运行 30 秒后停止追踪。[cmd] 会继续正常运行,但停止收集追踪数据。
- -c
- 您可采用更多定制选项来启动追踪,只需在 JSON 配置文件上写入这些选项,并使用 -c 指定配置即可。配置文件详细信息会下一章节中详细解释。
- -o
- 报告的位置。此实参仅在文本汇总模式下可用。测试汇总信息默认输出到 STDOUT。
- --va
- 为 Vitis 分析器生成追踪数据,默认为启用,不可与 --txt_summary 搭配使用。
- --txt_summary 或 --txt
- 输出文本汇总。在此模式下,vaitrace 不会为 Vitis 分析器生成报告,不可与 --va 搭配使用。
- --fine_grained
- 在高精度模式下启动追踪。此模式会生成大量追踪数据,追踪时间以 10 秒为限。
其他实参用于调试。