鲲鹏社区首页
中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助

使用命令行进行向量化检查

命令功能

对可向量化片段进行检查。

使用向量化需要在运行环境上准备对应编译器版本。

  • GCC版本:GCC 7/GCC 8/GCC 9/GCC 10
  • clang版本:clang12/clang15

命令格式

devkit advisor vec-check {-i INPUT_PATH | --input  INPUT_PATH}[-f BC_PATH| --bc-file BC_PATH] [-c COMMAND | --cmd COMMAND][-p  {clang,gcc} | --compiler {clang,gcc}][-o OUTPUT_PATH | --output OUTPUT_PATH]  [-r {all,json,html,csv} | --report-type {all,json,html,csv}] [-l  {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout  TIMEOUT] [--sve-enable {true,false}]

参数说明

表1 参数说明

参数

参数选项

参数说明

-i/--input

input_path

BC文件对应的源码文件夹路径。

必选参数。

例如:/home/test

-f/--bc-file

path

BC文件夹路径,该路径下必须存在BC文件。

必选参数。

例如:/home/testbc

-c/--cmd

cmd

源码的构建命令。

必选参数。

例如:'make all'

-p/--compiler

gcc,clang

编译器。

可选参数,默认为clang。

例如:gcc。

-o/--output

output_path

报告存放路径。

可选参数。

报告默认存放在当前执行路径下,名称默认为“特性名称_时间戳”。

--set-timeout

time

任务超时时间。

可选参数。

默认无超时时间,任务将持续执行直到结束。

-l/--log-level

0,1,2,3

日志等级,可选参数:0(DEBUG)、1(INFO)、2(WARNING)、3(ERROR),默认为1(INFO)。

-r/--report-type

all,json,html,csv

扫描报告的格式。

可选参数。

默认为all,即默认生成json、html、csv三种报告。

--sve-enable

true,false

是否启用sve。

可选参数,默认不开启。

关于生成BC文件的方式请参见生成BC文件

使用实例

此处以以下命令为例,请根据实际情况替换成实际需要扫描的配置文件路径。

devkit advisor vec-check -i /home/testcase/cplusproject -f /home/advisor/bc_file -c 'make' -p gcc -l 0
返回信息如下,并输出报告。
Scanned time: 2024/02/29 06:11:25
Configuration:
    Scan bc files path: /home/advisor/bc_file
    Scan source code path: /home/testcase/cplusproject
    Command: make
    Compiler: gcc
    EnableSVE: false
    Generate report path: /home/test001/DevKit-CLI-24.0.RC1-Linux-Kunpeng
    Generate report type: all
    Task Timeout Interval: The timeout period is not set.
    Log level: DEBUG

Summary:
    Scanned 1 bc files, there are 0 recommended modifications.

For the detailed information, please check
   /home/test001/DevKit-CLI-24.0.RC1-Linux-Kunpeng/vec-check_20240229061125_0cdc.json
   /home/test001/DevKit-CLI-24.0.RC1-Linux-Kunpeng/vec-check_20240229061125_0cdc.html
   /home/test001/DevKit-CLI-24.0.RC1-Linux-Kunpeng/vec-check_20240229061125_0cdc.csv

输出报告说明

表2 向量化检查输出报告参数说明

参数

说明

配置信息

显示软件源码文件及BC文件存放路径。

需要修改的源码文件

显示存在向量化问题,并需要进行修改的源码文件路径等相关信息。