0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心
发布

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙实战开发:【FaultLoggerd组件】讲解

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-03-12 16:22 次阅读

简介

Faultloggerd部件是OpenHarmony中C/C++运行时崩溃临时日志的生成及管理模块。面向基于 Rust 开发的部件,Faultloggerd 提供了Rust Panic故障日志生成能力。系统开发者可以在预设的路径下找到故障日志,定位相关问题。

架构

架构

  • Native InnerKits接口
    • SignalHandler:信号处理器,接收系统异常信号,触发抓取进程异常时的现场信息
    • BackTrace:本地回栈库,提供进程内本地回栈能力。
    • DumpCatcher:堆栈信息抓取工具库,提供了抓取指定进程和线程的堆栈栈信息的能力。
    • FaultloggerdClient:崩溃临时日志管理客户端,接收申请文件描述符、堆栈导出等请求。
  • Rust 接口
    • PanicHandler:Rust PANIC故障处理器,封装faultloggerd回栈能力支持rust模块PANIC故障回栈。
    • Rustc Demangle:Rust 符号demangle库,支持Rust模块mangled符号解析。
  • Faultlogger Daemon 服务
    • FaultloggerdServer:核心服务处理模块,接收并处理客户端的请求。
    • FaultloggerdSecure:权限校验模块,对运行时崩溃日志生成和抓取提供权限管理和校验能力。
    • FaultloggerdConfig:崩溃临时日志管理模块。
    • FaultloggerdPipe:数据管道传输管理模块,提供数据传输管道申请和管理能力。
  • 工具
    • DumpCatcher Command Tool:提供命令行形式的主动抓栈工具,仅在Debug版本提供。
    • ProcessDump:进程信息抓取二进制工具,通过命令行方式提供抓取指定进程、线程堆栈信息的能力。
    • crasher:崩溃构造器,提供了崩溃构造和vwin 能力。
    • Rust Panic Maker:Rust PANIC 故障构造器,提供了构造Rust模块的故障构造能力。

目前主要支持对以下C/C++运行时崩溃异常信号的处理:

信号值 信号 解释 触发原因
4 SIGILL 非法指令 执行了非法指令,通常是因为可执行文件本身出现错误,或者试图执行数据段,堆栈溢出时也有可能产生这个信号。
5 SIGTRAP 断点或陷阱异常 由断点指令或其它trap指令产生。
6 SIGABRT abort发出的信号 调用abort函数生成的信号。
7 SIGBUS 非法内存访问 非法地址,包括内存地址对齐(alignment)出错。比如访问一个四个字长的整数,但其地址不是4的倍数。它与SIGSEGV的区别在于后者是由于对合法存储地址的非法访问触发的(如访问不属于自己存储空间或只读存储空间)。
8 SIGFPE 浮点异常 在发生致命的算术运算错误时发出,不仅包括浮点运算错误,还包括溢出及除数为0等其它所有的算术的错误。
11 SIGSEGV 无效内存访问 试图访问未分配给自己的内存,或试图往没有写权限的内存地址写数据。
16 SIGSTKFLT 栈溢出 堆栈溢出。
31 SIGSYS 系统调用异常 非法的系统调用。

目录

faultloggerd/ ├── OAT.xml ├── common# 工具库和公共定义├── docs# 文档├── example# 样例代码├── frameworks# 主动抓栈实现├── interfaces │ ├── innerkits │ │ ├── backtrace# 本地回栈库│ │ ├── dump_catcher# 抓取调用栈基础库│ │ ├── faultloggerd_client# 崩溃临时日志管理服务客户端接口│ │ └── signal_handler# 异常信号处理器│ └── rust │ ├── panic_handler# Rust Panic 处理器│ ├── panic_report# Rust Panic 故障上报库│ └── rustc_demangle# Rust demangle 库├── services# faultloggerd 常驻服务├──test│ ├── funchook# hook 工具测试用例│ ├── fuzztest# 模糊测试用例│ ├── moduletest# 模块测试用例│ ├── performancetest# 性能测试用例│ ├── systemtest# 系统测试用例│ └── unittest# 单元测试用例└── tools ├── crasher_c# 崩溃构造器(C)├── crasher_cpp# 崩溃构造器(C++)├── dump_catcher# DumpCatcher 命令行工具├── panic_maker# Rust Panic 故障构造器└── process_dump# 崩溃抓栈实现

使用说明

进程崩溃日志生成

目前已默认开启,进程因上述异常信号崩溃将会在设备/data/log/faultlog/temp目录下生成完整的崩溃日志,可基于该崩溃日志进行问题定位可分析。

DumpCatcher 接口

DumpCatcher是提供给第三方模块使用的抓取调用栈基础库,其中包含了打印指定进程(或线程)的栈信息的接口函数。目前支持CPP调用栈和CPP-JS混合栈。

接口类名:DfxDumpCatcher

接口定义:

  • 默认:bool DumpCatch(int pid, int tid, std::string& msg);
  • 支持混合栈:bool DumpCatchMix(int pid, int tid, std::string& msg);
  • 支持输出到指定文件:bool DumpCatchFd(int pid, int tid, std::string& msg, int fd);
  • 支持批量抓栈:bool DumpCatchMultiPid(const std::vector pidV, std::string& msg);

接口参数说明:

  • 接口返回值:
    • true:回栈成功,回栈信息存储在msg字符串对象中;
    • false:回栈失败。
  • 输入参数:
    • pid:希望回栈的进程号,如果需要回栈进程中的所有线程,则tid设定为0
    • tid:希望回栈的线程号;
    • fd:指定写入回栈信息的文件句柄;
  • 输出参数:
    • msg:如果回栈成功,则通过msg输出回栈后的信息。

注意:此接口需要调用者是管理员(system,root)用户,或者只抓取自己用户拥有的进程信息。

样例代码:

  • dump_catcher_demo.h
#ifndefDUMP_CATCHER_DEMO_H#defineDUMP_CATCHER_DEMO_H#include< inttypes.h >#defineNOINLINE __attribute__((noinline))#defineGEN_TEST_FUNCTION(FuncNumA, FuncNumB)__attribute__((noinline))intTestFunc##FuncNumA() {returnTestFunc##FuncNumB(); }// test functions for callstack depth testintTestFunc0(void);intTestFunc1(void);intTestFunc2(void);intTestFunc3(void);intTestFunc4(void);intTestFunc5(void);intTestFunc6(void);intTestFunc7(void);intTestFunc8(void);intTestFunc9(void);intTestFunc10(void);#endif// DUMP_CATCHER_DEMO_H
  • dump_catcher_demo.cpp
#include"dump_catcher_demo.h"#include< iostream >#include< string >#include< unistd.h >#include"dfx_dump_catcher.h"usingnamespacestd;NOINLINEintTestFunc10(void){ OHOS::HiviewDFX::DfxDumpCatcher dumplog; string msg ="";boolret = dumplog.DumpCatch(getpid(),gettid(), msg);if(ret) { cout < < msg < < endl; }return0; }// auto gen functionGEN_TEST_FUNCTION(0,1)GEN_TEST_FUNCTION(1,2)GEN_TEST_FUNCTION(2,3)GEN_TEST_FUNCTION(3,4)GEN_TEST_FUNCTION(4,5)GEN_TEST_FUNCTION(5,6)GEN_TEST_FUNCTION(6,7)GEN_TEST_FUNCTION(7,8)GEN_TEST_FUNCTION(8,9)GEN_TEST_FUNCTION(9,10)intmain(intargc,char*argv[]){TestFunc0();return0; }
  • BUILD.gn:
import("//base/hiviewdfx/faultloggerd/faultloggerd.gni")import("//build/ohos.gni")config("dumpcatcherdemo_config"){ visibility = [":*"] include_dirs= [".","//utils/native/base/include","//base/hiviewdfx/faultloggerd/interfaces/innerkits/dump_catcher/include/", ] }ohos_executable("dumpcatcherdemo"){ sources = ["dump_catcher_demo.cpp"] configs = [":dumpcatcherdemo_config"] deps = ["//base/hiviewdfx/faultloggerd/interfaces/innerkits/dump_catcher:libdfx_dumpcatcher","//utils/native/base:utils", ] external_deps = ["hilog:libhilog"] install_enable =truepart_name ="faultloggerd"subsystem_name ="hiviewdfx"}
  • 执行结果:
# ./dumpcatcherdemo#00pc0000000000000981(00000000004a8981) /data/test/dumpcatcherdemo#01pc0000000000000a6d(00000000004a8a6d) /data/test/dumpcatcherdemo#02pc0000000000000a63(00000000004a8a63) /data/test/dumpcatcherdemo#03pc0000000000000a59(00000000004a8a59) /data/test/dumpcatcherdemo#04pc0000000000000a4f(00000000004a8a4f) /data/test/dumpcatcherdemo#05pc0000000000000a45(00000000004a8a45) /data/test/dumpcatcherdemo#06pc0000000000000a3b(00000000004a8a3b) /data/test/dumpcatcherdemo#07pc0000000000000a31(00000000004a8a31) /data/test/dumpcatcherdemo#08pc0000000000000a27(00000000004a8a27) /data/test/dumpcatcherdemo#09pc0000000000000a1d(00000000004a8a1d) /data/test/dumpcatcherdemo#10pc0000000000000a13(00000000004a8a13) /data/test/dumpcatcherdemo#11pc0000000000000a77(00000000004a8a77) /data/test/dumpcatcherdemo#12pc00000000000c2b08(00000000b6fafb08) /system/lib/ld-musl-arm.so.1(__libc_start_main+116)#13pc0000000000000938(00000000004a8938) /data/test/dumpcatcherdemo#14pc00000000000008c4(00000000004a88c4) /data/test/dumpcatcherdemo

DumpCatcher 命令行工具

DumpCatcher 是指提供给用户的一个抓取调用栈命令行工具,由 DumpCatcher innerkits 接口封装实现,该工具通过-p-t参数指定进程和线程,以及[-c -m -k]可选参数指定抓栈的类型,命令执行后在命令行窗口打印指定的进程的线程栈信息。

工具名称:dumpcatcher

位置:/system/bin

参数说明:

  • -p [pid]:打印指定进程下面的所有线程栈信息;
  • -p [pid] -t [tid]:打印指定进程下面的指定线程信息。
  • [-c -m -k]:可选参数, 指定打印-c(pp)C++调用栈、-m(ix)C++ JS混合调用栈、-k(ernel)调用栈类型。

返回打印说明:如果栈信息解析成功,则将信息显示到标准输出。

注意:使用此接口需要调用者是管理员(system,root)用户。

Rust Panic 故障处理器

TODO

处理流程

进程崩溃抓栈处理流程

进程崩溃抓栈处理流程

  1. 进程运行时异常崩溃后会收到来自Kernel发送的崩溃信号,由进程在启动加载的SignalHandler模块进行信号处理;
  2. 进程接收到崩溃信号后,保存当前进程上下文,fork 出子进程执行ProcessDump二进制进行抓栈;
  3. ProcessDumpFaultloggerd申请文件句柄用于存储收集到的崩溃日志数据;
  4. ProcesDump将完整崩溃日志数据写入到/data/log/faultlog/temp目录下进行临时存储;
  5. ProcessDump收集完崩溃日志后,上报给Hiview进行后续处理;
  6. Hiview接收到新增进程崩溃故障数据后,提取简易的崩溃日志存储到/data/log/faultlog/faultlogger目录下,并生成HiSysevent故障事件。

DumpCatcher 接口/命令行工具 主动抓栈处理流程

DumpCatcher主动抓栈处理流程图

  1. 进程A调用DumpCatcher库提供的系列接口(1B),或通过DumpCatcher命令行工具(1A),申请dump指定进程和线程的堆栈信息;
  2. 如果目前进程是当前进程,则直接调用BackTrace Local提供的能力进行本地回栈输出(2B);如果不是,则向Faultloggerd服务发送抓栈请求(2A);
  3. Faultloggerd接收到抓栈请求,鉴通过权和管道申请等操作后,向目标进程发送SIGDUMP(35)信号触发主动抓栈(3);
  4. 目前进程接收到SIGDUMP(35)抓栈信号后,保存当前进程上下文,fork出子进程执行ProcessDump二进制进行抓栈,通过Faultloggerd申请到的管道返回调用栈数据(4)。
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表德赢Vwin官网 网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 程序员
    +关注

    关注

    4

    文章

    945

    浏览量

    29665
  • 鸿蒙系统
    +关注

    关注

    183

    文章

    2624

    浏览量

    65670
  • HarmonyOS
    +关注

    关注

    79

    文章

    1944

    浏览量

    29679
  • OpenHarmony
    +关注

    关注

    25

    文章

    3517

    浏览量

    15625
收藏 人收藏

    评论

    相关推荐

    鸿蒙基础开发实战-(ArkTS)像素转换

    的使用。通过像素转换案例,向 开发讲解了如何使用像素单位设置 组件的尺寸、字体的大小以及不同像素单位之间的转换方法。更多 鸿蒙4.0的学习,可以前往主页学习或前往《
    发表于01-11 16:53

    鸿蒙开发基础-Web组件之cookie操作

    }) ... } ... 本文章主要是对 鸿蒙 开发当中ArkTS语言的基础应用 实战,Web 组件里的cookie操作。更多的 鸿蒙应用
    发表于01-14 21:31

    鸿蒙开发OpenHarmony组件复用案例

    ) } }, item => item) } } } 本文主要是对 鸿蒙 开发基础当中的OpenHarmony技术 组件复用示例, 更多 鸿蒙 开发
    发表于01-15 17:37

    鸿蒙实战项目开发:【短信服务】

    、OpenHarmony 多媒体技术、Napi 组件、OpenHarmony内核、Harmony南向 开发鸿蒙项目 实战等等) 鸿蒙(Harmon
    发表于03-03 21:29

    HarmonyOS实战开发-深度探索与打造个性化自定义组件

    今天分享一下 什么是自定义 组件?及其自定义 组件实战。 做过前端或者android 开发的都知道自定义 组件
    发表于05-08 16:30

    【专家问答】杨光明:鸿蒙系统研发工程师教你从0开发鸿蒙PCB开发

    `前言:本期我们邀请到了张飞 实战电子团队的 鸿蒙系统研发工程师杨光明老师@aMi杨光明,本期高手问答中老师将为我们解答大家在Linux系统 开发,单片机 开发,以及在进行
    发表于09-25 15:24

    微信小程序如何开发?微信小程序教程视频常用组件API开发项目实战

    本文档的主要内容介绍的是微信小程序如何 开发?微信小程序教程视频微信小程序入门与 实战常用 组件API 开发技巧项目 实战详细的介绍了
    发表于08-28 14:41 88次下载

    华为开发者大会分论坛HarmonyOS测试技术与实战-鸿蒙智联认证生态设备测试挑战

    HDC 2021华为 开发者大会分论坛HarmonyOS测试技术与 实战- 鸿蒙智联认证生态设备测试挑战
    的头像 发表于10-23 16:40 1674次阅读
    华为<b class='flag-5'>开发</b>者大会分论坛HarmonyOS测试技术与<b class='flag-5'>实战</b>-<b class='flag-5'>鸿蒙</b>智联认证生态设备测试挑战

    鸿蒙官方开发板功能讲解介绍

    鸿蒙官方 开发板功能 讲解,不同设备的硬件和软件差异比较。
    的头像 发表于12-01 17:58 4237次阅读

    鸿蒙ArkUI开发-Tabs组件的使用

    鸿蒙ArkUI 开发-Tabs 组件的使用
    的头像 发表于01-19 16:01 1219次阅读
    <b class='flag-5'>鸿蒙</b>ArkUI<b class='flag-5'>开发</b>-Tabs<b class='flag-5'>组件</b>的使用

    鸿蒙开发【设备开发基础知识】

    鸿蒙 开发基础知识 讲解
    的头像 发表于01-29 18:44 689次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>【设备<b class='flag-5'>开发</b>基础知识】

    鸿蒙实战开发Camera组件:【相机】

    相机 组件支持相机业务的 开发开发者可以通过已开放的接口实现相机硬件的访问、操作和新功能 开发,最常见的操作如:预览、拍照和录像等。
    的头像 发表于03-08 16:20 386次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>实战</b><b class='flag-5'>开发</b>Camera<b class='flag-5'>组件</b>:【相机】

    鸿蒙开发实战:【性能调优组件

    性能调优 组件包含系统和应用调优框架,旨在为 开发者提供一套性能调优平台,可以用来分析内存、性能等问题
    的头像 发表于03-13 15:12 269次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>实战</b>:【性能调优<b class='flag-5'>组件</b>】

    鸿蒙开发实战:【蓝牙组件

    蓝牙服务 组件为设备提供接入与使用Bluetooth的相关接口,包括BLE设备gatt相关的操作,以及BLE广播、扫描等功能。
    的头像 发表于03-13 17:27 426次阅读

    鸿蒙实战开发学习【FaultLoggerd组件

    Faultloggerd部件是OpenHarmony中C/C++运行时崩溃临时日志的生成及管理模块。面向基于 Rust 开发的部件, Faultloggerd提供了Rust Panic故障日志生成能力。系统
    的头像 发表于03-17 20:39 300次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>实战</b><b class='flag-5'>开发</b>学习【<b class='flag-5'>FaultLoggerd</b><b class='flag-5'>组件</b>】