字节对齐检查

前提条件

已成功登录鲲鹏DevKit。

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

操作步骤

1. 在页面左侧，“亲和分析”下拉选项中选择“字节对齐检查”，单击创建任务，如图1所示。
   图1 字节对齐检查
   

   表1 字节对齐检查参数说明

   参数	说明
   任务名称	字节对齐检查任务名称，工具默认会自动生成任务名称，也可根据实际情况进行自定义修改。
   源码文件存放路径	选择“已上传的源码”：单击填写框选择下拉框中的源码路径即可，也可以手动填写源码路径。 选择“上传源码”：单击“上传”按钮上传压缩包（上传过程中自动解压）或文件夹。 说明： 支持上传tar，tar.bz，tar.bz2，tar.gz，tar.xz，tbz，tbz2，tgz，txz，zip格式的压缩包，只允许同时上传一个压缩包。源码文件压缩包小于或等于1GB，解压后小于或等于剩余磁盘空间的一半。 只允许同时上传一个文件夹，文件夹小于或等于剩余磁盘空间的一半。 手动上传软件包时，需先检查是否存在上传目录，若不存在，则需创建工具指定路径，并给devkit用户开通读写和执行权限。
   编译命令	源码编译命令。在服务器中正常执行的编译命令，若存在多个编译命令需使用英文分号分割。 例如：cd build;cmake ..;make 说明： 编译命令不支持设置一般变量和环境变量。 例如：CFLAGS='-O0 -g';make或export CFLAGS='-O0 -g';make

2. 单击“开始检查”，开始字节对齐检查。检查完成后，自动跳转至检查报告界面，如图2所示。
   图2 字节对齐检查报告
   
   

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

   表2 报告结果参数说明

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

3. 单击“查看建议源码”可进入源码对齐检查结果界面，如图3所示。
   图3 建议代码
   

   表3 建议代码界面参数说明

   参数	说明
   原始源代码	原始源代码。
   结构变量内存空间分配	显示代码中需要对齐的32位和64位字节内存空间。

   

   • 支持多个用户同时创建字节对齐检查任务。
   • 用户可在任务进行过程中单击关闭，取消任务。
   • 若需要修改当前成功或失败任务的配置，可单击当前任务名称右侧的按钮进行重启任务操作。
   • 对于64位运行模式检查和字节对齐检查，在同一时刻同一用户只能进行其中一个。
   • 用户可以单击原始源代码模块右上角的上下键，进行上下切换。
   • 用户如使用快捷键进行源码操作，需注意因输入法或IDE环境导致的快捷键被占用问题。
   • 分析结果可能因环境不同而产生差异，属于正常情况。
   • 若扫描结果与代码行无法对应，则此处代码可能为宏展开。
   • 若提示任务超时，请参见用户进行任务时提示任务超时的解决方法进行处理。