SysDump即Dump system memory,是一种转存储机制,是将发生异常时的内存信息、寄存器信息等有效信息转存为文件,以便于借助分析工具分析问题现场。
在系统发生诸如Kernel crash等异常时,在Kernel中完成flush cache等处理后,重启进入Uboot中完成所有数据的保存,保存过程会有相应屏幕提示,完成后根据屏幕提示重启设备,导出异常数据文件进行分析。
SysDump分为FullDump和MiniDump两个子功能,两者互不影响。
FullDump保存完整DDR信息,可以支持两种存储路径Dump2SD和Dump2PC。 Dump2SD功能依赖于SD卡,即设备需支持插入SD卡。
MiniDump保存少量信息到单独的sysdumpdb分区,然后再由Native Service程序将分区保存的RAM数据整理解析后保存到指定路径。
MiniDump功能仅Android平台的设备支持。
在资源允许的条件下,优先选择保存分析FullDump日志,因为其保存了完整的现场信息快照,更有利于深入分析问题。
硬件配置不同,SysDump触发方式也有所差异,具体如下
SysDump文件主要有:
dump_report.txt: SysDump信息文件,记录了SysDump文件的个数,重启原因等。
ylog_buf文件: 记录ylog buffer中信息。
sysdump.core*:log文件。
extend_*文件: 其他debug信息,如log_buf、per_cpu段等。
bootloader_*_log:bootloader log,last为最新的,pre为上一次的。
FullDump文件解析命令如下:
32bit Arm ® 平台
Android 13.0平台:./crash_arm -m phys_base=0x80000000 vmlinux vmcore@0x80000000
其他平台:./crash_arm -m phys_base=0x80000000 vmlinux vmcore
64bit Arm ® 平台
Android 13.0平台:./crash_arm64 -m vabits_actual=39 -m phys_offset=0x80000000 -m kimage_voffset=0xffffffbf90000000
vmcore@0x80000000 vmlinux
Android 12.0平台:./crash_arm64 -m vabits_actual=39 -m phys_offset=0x80000000 -
m kimage_voffset=0xffffffbf90000000 vmcore vmlinux
其他平台:./crash_arm64 -m phys_offset=0x80000000 vmlinux vmcore
其中:
Android 12.0及以上平台crash工具需使用7.2.8及以上版本,Android 13.0推荐使用crash8.0.0版本。
vmlinux为编译时生成的最原始的内核文件,用于kernel debug,获取路径为:out/target/product/xxxx/obj/Kernel/vmlinux
vmcore为通过SysDump收集到的系统的core dump信息,由SysDump文件sysdump.core*合成,合成命令如下:
cat sysdump.core.* > vmcore
MiniDump功能常用于无SD卡或无法Dump2PC的场景,当前设计默认开启。
MiniDump功能支持保存5份历史数据文件,对应的文件夹名称分别为1、2、3、4、5,用于存储MiniDump的压缩数据。
文件夹1永远为最新生成的数据,再次发生MiniDump时,将文件夹1命名为2,并重新创建文件夹1,超过5个文件夹时,
原有的文件夹5丢弃,以此类推。
MiniDump日志可以使用adb pull命令直接导出,MiniDump日志默认保存路径如下:
Android 11.0及之后平台默认保存在/data/minidump目录下。
Android 10.0及之前平台默认保存在/sdcard/minidump目录下。
MiniDump日志使用TRACE32 Arm ® SIMULATOR(简称T32 sim)或crash等工具进行分析。
MiniDump生成的日志文件如下图所示:
其中:
00_minidump_elfhdr:elf文件头(Android 13.0由脚本生成)。
01_minidump_regs:CPU寄存器。
02~17:寄存器前后各一页信息。
18~22:各段信息。
23~44:其他debug信息。如:irqstack,cpustack,io,sprd_log_buf,
mini_mem_info,log_buf,per_cpu段等。
45~46:bootloader log,last为最新的,pre为前一次的。
47:生成elf头文件的脚本所需的数据。
compressed_info:压缩信息,Android 13.0特有,使用脚本对MiniDump文件解
压缩时使用。
dump_report:dump描述信息。
last_kmsg.log:系统重启之前的最后的内核log信息,由脚本解析生成。
MiniDump输出文件格式:
Android 13.0平台:zlib格式的压缩文件,可以使用脚本unisoc_parse_dumplog_A13.py进行解压、合成MiniDump文件,使
用脚本generate_elfhdr_for_mini_v1.0.py生成elf头文件,使用脚本parse_log_buf_k54.py解析生成last_kmsg.log。
其他平台:gzip格式的压缩文件,可以使用脚本unisoc_parse_dumplog.py解压文件、合成MiniDump文件、解析生成
last_kmsg.log文件。
crash工具“minimal”模式分析
目前导出数据合成的MiniDump文件支持使用crash工具“minimal”模式分析,命令如下:
32bit Arm ® 平台:
./crash_arm minidump vmlinux –minimal
64bit Arm ® 平台:
Android 13.0平台:./crash_arm64 -m vabits_actual=39 -m kimage_voffset=0xffffffbf90000000 minidump vmlinux --minimal
其他平台: ./crash_arm64 -m kimage_voffset=0xffffff7f88000000 minidump vmlinux –minimal
minimal模式下, crash工具支持使用log、sym、rd等命令对MiniDump文件进行简易分析。
注意:Android 13.0平台上32bit Arm ® 平台log命令无法使用
扩展: