向量化检查

前提条件

已成功登录鲲鹏DevKit。

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

操作步骤

1. 在页面左侧，“亲和分析”下拉选项中选择“向量化检查”，点击创建任务，如图1所示。
   图1 向量化检查
   
2. 选择“文件上传类型”。
   • 源码文件上传，请继续执行步骤3~4。
   • BC文件上传，请继续执行步骤6~7。
3. 填写编译命令，然后单击“下一步”。

   解析编译命令后生成BC文件。

   

   • 编译命令支持make、cmake、configure、shell命令以及shell脚本，其中使用make命令时不支持make install。
   • 构建命令或者构建脚本不能对用户空间（/opt/DevKit/用户名/workspace/porting）之外的目录和文件进行创建或修改操作。
   • 若检查过程中出现生成BC文件失败的情况，可以自行生成BC文件，然后再执行6~7通过上传BC文件直接分析BC文件，进行向量化检查。
4. 选择生成的BC文件，并选择“编译器版本”后单击“确认检查”，开始向量化检查。
   图2 选择BC文件
   
   

   • 如果源码规模过大，可点击“下载”，下载生成的BC文件（可选择同时下载多个BC文件）。然后再执行6~7通过“BC文件上传”直接分析BC文件，进行内存一致性检查。
   • 当前支持的编译器版本为clang12/clang15/GCC7/GCC8/GCC9/GCC10,启用SVE后支持clang15/GCC9/GCC10。
   • SVE是ARMv8a后为增强二进制码可移植性推出的可变长度的向量化指令，以便其能够运行在更宽的SIMD unit上。
   检查完成后，单击“查看报告”可进入“向量化源码检查报告”界面，如图3所示。

   图3 向量化检查报告
   
   

   • 可点击对需要修改的源码文件按照路径或修改点数量进行排序。
   • 可点击“下载报告（.html）”获取报告到本地进行查看。
5. 若检查结果中存在需要修改的源码文件，则可单击操作报告页面顶部“源码修改建议”进入源码修改建议页面，如图4所示。
   图4 源码修改建议
   
   

   • 支持多个用户同时创建向量化检查任务。
   • 用户可在任务进行过程中单击关闭，取消任务。
   • 用户可以单击原始源代码模块右上角的上下键，进行上下切换。
   • 检查失败或检查结果为无需修改时，会产生空白报告。
6. 填写“BC文件存放路径”。可以通过以下两种方式实现：
   • 选择“已上传的BC文件”：单击填写框选择下拉框中的BC文件即可，也可以手动填写BC文件。
   • 选择“上传BC文件”：单击“上传”按钮上传BC文件。

     上传完成后，选择“编译器版本”。

7. 单击“开始检查”，开始向量化检查。检查完成后，单击“查看报告”可进入“检查报告”界面。如图5所示。
   图5 向量化检查报告
   

   BC文件检查报告中会显示建议修改点数量和建议修改代码的具体位置，可根据这些信息进行排查和修改。