展锐 sysdump

        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命令无法使用

扩展：

kdump机制和crash常见使用