向量化检查

前提条件

已成功登录鲲鹏DevKit。

• “/opt”为工具默认安装目录，下文以此默认路径为例，请根据实际情况替换。
• 当前特性在Web界面中需要手动上传文件或压缩包；在插件工具中支持扫描本地工程，若源码为压缩包格式，请先解压然后选择解压后文件夹。

操作步骤

1. 在页面左侧，“亲和分析”下拉选项中选择“向量化检查”，单击创建任务，如图1所示。
   图1 向量化检查
   
2. 填写“源码文件存放路径”，可以通过以下两种方式实现：
   • 手动填写源码文件的绝对路径。
   • 单击右侧“选择文件夹”，选择源码文件存储文件夹。
3. 填写编译命令。例如：“cd src;cmake ..;make”。
   

   • 编译命令支持make、cmake、configure、shell命令以及shell脚本，其中使用make命令时不支持make install。
   • 构建命令或者构建脚本不能对用户空间（/opt/DevKit/workspace/用户名）之外的目录和文件进行创建或修改操作。
4. 填写“BC文件存放路径”。可以通过以下两种方式实现：
   • 手动填写BC文件的绝对路径。
   • 单击右侧“选择文件夹”，选择BC文件存储文件夹。
5. 选择“是否启用SVE”，默认是“否”。
   

   SVE是ARMv8a后为增强二进制码可移植性推出的可变长度的向量化指令，以便其能够运行在更宽的SIMD unit上。

6. 选择“编译器类型”。当前支持gcc和clang。
   

   当前支持的编译器版本为clang12/clang15/clang16/GCC7/GCC8/GCC9/GCC10，启用SVE后支持clang15/clang16/GCC9/GCC10。

   填写完成后，单击“开始检查”，开始向量化检查。检查完成后，自动跳转至检查报告界面，如图2所示。

   图2 向量化检查报告
   
   

   • 可单击对需修改的源码文件按照路径或建议项数量进行排序。
   • 可单击界面右上角“下载报告”，选择“下载报告 (.csv)”或“下载报告 (.html)”，下载分析报告到本地进行查看。或单击任务右侧“”按钮，选择“下载报告 (.csv)”或“下载报告 (.html)”，下载分析报告到本地进行查看。

   表1 报告结果参数说明

   参数	说明
   源码文件统计
   需修改文件数	源码文件路径下扫描出需要修改的文件总数。
   需修改代码行	需要修改的代码行数。
   建议项总数	建议修改的项目总数。为了更好更快地在鲲鹏平台上运行程序，我们建议您按照建议项进行修改。
   需修改的源码文件	显示需要修改的源码文件和建议项数量，通过单击操作列“查看建议源码”可以快速进入对应的源码文件建议页面。

7. 若检查结果中存在需要修改的源码文件，则可单击“查看建议源码”进入源码修改建议页面，如图3所示。具体的向量化源码修改建议请参考向量化源码修改建议。
   图3 源码修改建议
   
   

   • 支持多个用户同时创建向量化检查任务。
   • 用户可在任务进行过程中单击关闭，取消任务。
   • 若需要修改当前成功或失败任务的配置，可单击当前任务名称右侧的按钮进行重启任务操作。
   • 检查失败或检查结果为无需修改时，会产生空白报告。