ASAN概述

ASAN(Address Sanitizer)是针对 C/C++ 的快速内存错误检测工具,在运行时检测 C/C++ 代码中的多种内存错误。
下面以社区OpenHarmony_3.2Release_标准系统、rk3568产品为例说明OpenHarmony_ASAN版本编译及使用

OpenHarmony_ASAN版本编译

编译脚本:

build_mixed_asan.sh 位于源码build/common/asan/目录下。该脚本支持--gn-args is_asan=true或者-gN:xxx,yyy,...参数,该脚本可以在编译阶段直接生成包含正常版本和asan版本的系统镜像。

编译步骤:

1)、配置开发环境并下载社区全量代码
详细方法:https://docs.openharmony.cn/pages/v3.2/zh-cn/device-dev/quick-start/quickstart-pkg-prepare.md/
2)、编译正常版本镜像,验证源码和编译环境均已准备就绪
在源码根目录下执行指令:./build.sh --product-name rk3568 --ccache
出现 =====build successful===== 则说明编译成功。
3)、使用--gn-args is_asan=true参数编译系统默认ASAN版本镜像。
在源码根目录下执行指令:./build/common/asan/build_mixed_asan.sh --product-name rk3568 --ccache --build-variant root --gn-args is_asan=true
编译成功后在 源代码根目录/out/rk3568/packages/phone/images 目录下出现如下几个镜像

其中systemX.img镜像对应的含义如下

镜像包 说明
system.img 正常版本镜像,不包含开启asan检测的服务
system2.img ASAN版本镜像,开启appspawn服务的内存检测
system5.img ASAN版本镜像,开启foundation、graphic、distributed_data服务的内存检测
system0.img ASAN版本镜像,开启 ui_service,samgr_standard,screenlockservice,timeservice,batterystats,bgtaskmgr_service,console,device_usage_statistics_service,audio_policy,pulseaudio,multimodalinput,pasteboardservice,inputmethodservice,telephony,misc,graphic,distributed_data,resource_schedule_service,deviceauth_service,deviceinfoservice,dhardware,distributedbms,distributedfile,distributedsched,dscreen,dslm_service,token_sync,useriam,accountmgr,dcamera,bluetooth_service,downloadservice,installs,locationsa,memmgrservice,storage_daemon,storage_manager,thermal,thermal_protector,privacy,accessibility,access_token,hidumper_service,camera_service,sensors_musl,bytrace,edm,faultloggerd,fms_service,hilogd,hitrace,hiview,huks_service,msdp_musl,netmanager_base,netsysnative,param_watcher,pinauth_sa_profile,watchdog服务的内存检测
systemF.img ASAN版本镜像,开启全部服务的内存检测

4)、使用-gN:xxx,yyy,...参数编译自定义检测服务的ASAN版本镜像
例如:编译开启camera_service服务内存检测的ASAN镜像,镜像序号为7
在源码根目录下执行指令:./build/common/asan/build_mixed_asan.sh --product-name rk3568 --ccache --build-variant root -g7:camera_service
编译成功后在源代码根目录/out/rk3568/packages/phone/images 目录下出现系统镜像system7.img
注意:
1.-g后的数字范围:0-9,之后是服务名,可去设备的/system/etc/init/路径下查看你想要的服务。
2.-g后的数字和服务没有什么对应关系,一个数字可以对应多个服务,数字在允许的范围内设置即可。需要注意的是,数字是生成的镜像名(如system7.img)
3.ASAN版本系统在使用过程中占用系统的内存大概是正常版本的2-3倍,对于硬件资源比较紧张的设备,需控制开启检测服务的数量,否者会造成系统卡顿甚至无法开机的情况。

OpenHarmony_ASAN版本烧录

ASAN版本烧录步骤和标准版本一样,唯一区别在于选择system.img镜像的时候,选择开启asan版本的镜像,如编译示例中的system2.img或者system0.img或者system7.img,烧录完成后重启设备即可进行后续的压测。

OpenHarmony_ASAN版本使用

1)压测:

ASAN版本压测根据用户的需求进行:
1、使用常见的稳定性测试场景测试:如系统遍历,单应用遍历,休眠唤醒,开关机等,大范围的测试系统服务是否存在内存问题。
2、因内存问题导致的cppcrash故障,确定问题场景后,使用asan版本镜像在该场景下复现该问题。

2)获取故障日志:

ASAN故障日志在设备中/data/log/sanitizer/asan/目录下,如:asan.log.01 ,需手动去设备中查看导出。

3)故障日志反编译:

将上述故障日志asan.log.01导出设备并复制到源码目录/out/rk3568/packages/phone/images中,在该目录下执行.resolve_asan_log.sh asan.log.01指令后会在该目录下会生成asan.log.01.resolved文件,后续就可以根据asan.log.01.resolved文件中的调用栈分析具体的内存问题啦!
如:

 

Logo

社区规范:仅讨论OpenHarmony相关问题。

更多推荐