鸿蒙开发实战：【Faultloggerd部件】

news2024/11/19 1:34:55

theme: z-blue

简介

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：崩溃构造器，提供了崩溃构造和模拟能力。
    • Rust Panic Maker：Rust PANIC 故障构造器，提供了构造Rust模块的故障构造能力。

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

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

使用说明

进程崩溃日志生成

目前已默认开启，进程因上述异常信号崩溃将会在设备 /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<int> pidV, std::string& msg);

接口参数说明：

  • 接口返回值：

    • true：回栈成功，回栈信息存储在msg字符串对象中；
    • false：回栈失败。

  • 输入参数：

    • pid：希望回栈的进程号，如果需要回栈进程中的所有线程，则tid设定为0；
    • tid：希望回栈的线程号；
    • fd：指定写入回栈信息的文件句柄；

  • 输出参数：

    • msg：如果回栈成功，则通过msg输出回栈后的信息。

注意：此接口需要调用者是管理员（system，root）用户，或者只抓取自己用户拥有的进程信息。

样例代码：

  • dump_catcher_demo.h
#ifndef DUMP_CATCHER_DEMO_H
#define DUMP_CATCHER_DEMO_H

#include <inttypes.h>

#define NOINLINE __attribute__((noinline))

#define GEN_TEST_FUNCTION(FuncNumA, FuncNumB)          \
    __attribute__((noinline)) int TestFunc##FuncNumA() \
    {                                                  \
        return TestFunc##FuncNumB();                   \
    }

// test functions for callstack depth test
int TestFunc0(void);
int TestFunc1(void);
int TestFunc2(void);
int TestFunc3(void);
int TestFunc4(void);
int TestFunc5(void);
int TestFunc6(void);
int TestFunc7(void);
int TestFunc8(void);
int TestFunc9(void);
int TestFunc10(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"
using namespace std;

NOINLINE int TestFunc10(void)
{
    OHOS::HiviewDFX::DfxDumpCatcher dumplog;
    string msg = "";
    bool ret = dumplog.DumpCatch(getpid(), gettid(), msg);
    if (ret) {
        cout << msg << endl;
    }
    return 0;
}

// auto gen function
GEN_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)

int main(int argc, char *argv[])
{
    TestFunc0();
    return 0;
}
  • 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 = true
  part_name = "faultloggerd"
  subsystem_name = "hiviewdfx"
}
  • 执行结果：
# ./dumpcatcherdemo
#00 pc 0000000000000981(00000000004a8981) /data/test/dumpcatcherdemo
#01 pc 0000000000000a6d(00000000004a8a6d) /data/test/dumpcatcherdemo
#02 pc 0000000000000a63(00000000004a8a63) /data/test/dumpcatcherdemo
#03 pc 0000000000000a59(00000000004a8a59) /data/test/dumpcatcherdemo
#04 pc 0000000000000a4f(00000000004a8a4f) /data/test/dumpcatcherdemo
#05 pc 0000000000000a45(00000000004a8a45) /data/test/dumpcatcherdemo
#06 pc 0000000000000a3b(00000000004a8a3b) /data/test/dumpcatcherdemo
#07 pc 0000000000000a31(00000000004a8a31) /data/test/dumpcatcherdemo
#08 pc 0000000000000a27(00000000004a8a27) /data/test/dumpcatcherdemo
#09 pc 0000000000000a1d(00000000004a8a1d) /data/test/dumpcatcherdemo
#10 pc 0000000000000a13(00000000004a8a13) /data/test/dumpcatcherdemo
#11 pc 0000000000000a77(00000000004a8a77) /data/test/dumpcatcherdemo
#12 pc 00000000000c2b08(00000000b6fafb08) /system/lib/ld-musl-arm.so.1(__libc_start_main+116)
#13 pc 0000000000000938(00000000004a8938) /data/test/dumpcatcherdemo
#14 pc 00000000000008c4(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. ProcessDump 向 Faultloggerd 申请文件句柄用于存储收集到的崩溃日志数据；
  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）。

qr23.cn/AKFP8k请前往←学习更多鸿蒙开发

在这里插入图片描述

Rust Panic 故障日志收集流程

// TODO

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1525669.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

jupyter notebook使用教程

jupyter notebook使用教程

首先是打开jupyter notebook 下载安装好之后&#xff0c;直接在命令行中输入‘jupyter notebook’即可跳转到对应页面 还可以进入想要打开的文件夹&#xff0c;然后再文件夹中打开中断&#xff0c;执行‘jupyter notebook’命令&#xff0c;就能够打开对应文件界面的jupyter …
阅读更多...
Leetcode 202.快乐数 JAVA

Leetcode 202.快乐数 JAVA

题目 思路 要注意题目中说的无限循环&#xff1a;它是指在求平方和的过程中&#xff0c;会再次出现之前的值&#xff08;想象一个圈&#xff09;&#xff0c;这种情况的时候肯定算不出1来。 所以我们要设定跳出循环的条件是&#xff1a;当平方和结果为1或者出现循环了 出现循…
阅读更多...
数字逻辑-时序逻辑电路二——沐雨先生

数字逻辑-时序逻辑电路二——沐雨先生

一、实验目的 &#xff08;1&#xff09;熟悉计数器的逻辑功能及特性。 &#xff08;2&#xff09;掌握计数器的应用。 &#xff08;3&#xff09;掌握时序逻辑电路的分析和设计方法。 二、实验仪器及材料 三、实验原理 1、集成4位计数器74LS161&#xff08;74LS160&#…
阅读更多...
区块链宣传推广文案怎么写 区块链宣传推广文案的写作技巧

区块链宣传推广文案怎么写 区块链宣传推广文案的写作技巧

区块链宣传推广文案的写作技巧 随着区块链技术的不断发展和应用&#xff0c;区块链项目的宣传推广变得越来越重要。而撰写有效的区块链宣传推广文案&#xff0c;则是吸引目标受众关注的关键。下面是一些区块链宣传推广文案的写作技巧&#xff1a; 1. 简明扼要的标题&#xff1…
阅读更多...
Docker进阶教程 - 2 Docker部署SpringBoot项目

Docker进阶教程 - 2 Docker部署SpringBoot项目

更好的阅读体验&#xff1a;点这里 &#xff08; www.doubibiji.com &#xff09; 2 Docker部署SpringBoot项目 已经学习了 Dockerfile 了&#xff0c;下面介绍一下如何将 SpringBoot 项目通过 Dockerfile 来部署到 Docker 中。 1 修改项目配置 首先需要准备一个 SpringBo…
阅读更多...
c++算法学习笔记 (9) 双指针

c++算法学习笔记 (9) 双指针

1.最长连续不重复子序列 给定一个长度为 n 的整数序列&#xff0c;请找出最长的不包含重复的数的连续区间&#xff0c;输出它的长度。 输入格式 第一行包含整数 n。 第二行包含 n 个整数&#xff08;均在 0∼10^5 范围内&#xff09;&#xff0c;表示整数序列。 输出格式 …
阅读更多...
初识Java篇（JavaSE基础语法）（1）

初识Java篇（JavaSE基础语法）（1）

个人主页&#xff08;找往期文章包括但不限于本期文章中不懂的知识点&#xff09;&#xff1a; 我要学编程(ಥ_ಥ)-CSDN博客 目录 前言&#xff1a; 初识Java 运行Java程序 注释 标识符 关键字 数据类型与变量 字面常量 数据类型 变量 类型转换 类型提升 字…
阅读更多...
基于springboot在线博客系统源码和论文

基于springboot在线博客系统源码和论文

社会的发展和科学技术的进步&#xff0c;互联网技术越来越受欢迎。网络计算机的生活方式逐渐受到广大人民群众的喜爱&#xff0c;也逐渐进入了每个用户的使用。互联网具有便利性&#xff0c;速度快&#xff0c;效率高&#xff0c;成本低等优点。 因此&#xff0c;构建符合自己要…
阅读更多...
Git Bash命令初始化本地仓库，提交到远程仓库

Git Bash命令初始化本地仓库，提交到远程仓库

git init&#xff1a;初始化空仓库 // 初始化一个空仓库或者重新初始化一个存在的仓库 git init git remote // 为当前本地仓库添加一个远程仓库地址 git remote add origin https://gitee.com/xxx/demo.git git pull // 从设置好链接的远程仓库拉去已经存在的数据&#xff0c;…
阅读更多...
疯狂送树莓派Pico！与CODESYS和上海晶珩一起，探索慕尼黑上海电子展！

疯狂送树莓派Pico！与CODESYS和上海晶珩一起，探索慕尼黑上海电子展！

3月20日-3月22日 上海新国际博览中心 E2馆 2200展 上海晶珩 X CODESYS 与您相约慕尼黑上海电子展 上海晶珩&#xff08;EDATEC&#xff09;荣幸宣布&#xff0c;将与全球自动化软件领导者CODESYS公司共同参展2024慕尼黑上海电子生产设备展&#xff01; 届时&#xff0c;我…
阅读更多...
【数据结构】二叉树的相关操作以及OJ题目

【数据结构】二叉树的相关操作以及OJ题目

文章目录 1. 二叉树2.二叉树的遍历2.1前序遍历2.2中序遍历2.3后序遍历2.4层序遍历 3.树的节点个数4.树的高度5.叶子节点的个数6.第k层节点的个数7.查找x所在的节点8.树的销毁9.相关题目9.1相同的树9.2单值二叉树9.3对称二叉树9.4二叉树的构建9.5翻转二叉树9.6另一颗树的子树 10…
阅读更多...
Learn OpenGL 17 立方体贴图

Learn OpenGL 17 立方体贴图

立方体贴图 我们已经使用2D纹理很长时间了&#xff0c;但除此之外仍有更多的纹理类型等着我们探索。在本节中&#xff0c;我们将讨论的是将多个纹理组合起来映射到一张纹理上的一种纹理类型&#xff1a;立方体贴图(Cube Map)。 简单来说&#xff0c;立方体贴图就是一个包含了…
阅读更多...
Java基础夯实——八股文【2024面试题案例代码】

Java基础夯实——八股文【2024面试题案例代码】

1、Java当中的基本数据类型 Java中常见的数据类型及其对应的字节长度和取值范围如下&#xff1a; byte&#xff1a;1字节&#xff0c;取值范围为-128到127。short&#xff1a;2字节&#xff0c;取值范围为-32,768到32,767。int&#xff1a;4字节&#xff0c;取值范围为-2,147…
阅读更多...
【Greenhills】GHS-MULTI IDE-Ubuntu纯命令系统部署license文件

【Greenhills】GHS-MULTI IDE-Ubuntu纯命令系统部署license文件

【更多软件使用问题请点击亿道电子官方网站查询】 1、 文档目标 记录在Ubuntu纯命令系统中部署license文件的步骤。 2、 问题场景 客户服务器为Linux纯命令行的环境&#xff0c;客户也无其他服务器可以部署&#xff0c;需在纯命令行上尝试安装。 3、软硬件环境 1&#xff09…
阅读更多...
【Linux系统编程】进程程序替换

【Linux系统编程】进程程序替换

介绍&#xff1a; 进程程序替换是指将一个进程中正在运行的程序替换为另一个全新的程序的过程&#xff0c;但替换不是创建新进程&#xff0c;只是将对应程序的代码和数据进行替换。具体来说&#xff0c;这个替换过程涉及将磁盘中的新程序加载到内存结构中&#xff0c;并重新建立…
阅读更多...
鸿蒙Harmony应用开发—ArkTS声明式开发（容器组件：FlowItem）

鸿蒙Harmony应用开发—ArkTS声明式开发（容器组件：FlowItem）

瀑布流组件的子组件&#xff0c;用来展示瀑布流具体item。 说明&#xff1a; 该组件从API Version 9开始支持。后续版本如有新增内容&#xff0c;则采用上角标单独标记该内容的起始版本。仅支持作为Waterflow组件的子组件使用。 子组件 支持单个子组件。 接口 FlowItem() 使…
阅读更多...
【RK android6.0 实现假关机真开机效果】

【RK android6.0 实现假关机真开机效果】

RK android6.0 实现假关机真开机效果 需求描述解决方法 郑重声明:本人原创博文&#xff0c;都是实战&#xff0c;均经过实际项目验证出货的 转载请标明出处:攻城狮2015 Platform: Rockchip CPU:rk3368 OS:Android 7.1.2 Kernel: 3.10 需求描述 由于硬件设计&#xff0c;使用错误…
阅读更多...
Qt实现简单的五子棋程序

Qt实现简单的五子棋程序

Qt五子棋小程序 Qt五子棋演示及源码链接登陆界面单机模式联机模式联网模式参考 Qt五子棋 参考大佬中国象棋程序&#xff0c;使用Qt实现了一个简单的五子棋小程序&#xff0c;包含了单机、联机以及联网三种模式&#xff1b;单机模式下实现了简易的AI&#xff1b;联机模式为PtoP…
阅读更多...
Verilog case/casez/casex的区别

Verilog case/casez/casex的区别

casez/casex语句虽然EDA工具也可以综合出来&#xff0c;但是注意&#xff0c;casez/casex综合出来的电路和case语句综合出来的电路可能是不同的&#xff0c;一定要慎用。而且综合工具也会告诉你casez/casex中的“?”"x""z"的comparison is always false&a…
阅读更多...
提速增效！Figma插件推荐，助你事半功倍！

提速增效！Figma插件推荐，助你事半功倍！

随着设计工具的更换&#xff0c;设计师不再局限于传统软件的重复操作&#xff0c;而是越来越追求能够提高设计效率的插件。从Photoshop到Sketch&#xff0c;再到最受欢迎的Figma&#xff0c;插件层出不穷。Figma是一种基于浏览器和团队合作的设计工具&#xff0c;可以在任何平台…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023