OpenHarmony实战开发-FaultLoggerd组件。

简介

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++运行时崩溃异常信号的处理:
在这里插入图片描述
目录

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 目录下生成完整的崩溃日志,可基于该崩溃日志进行问题定位可分析。

崩溃日志介绍和和常见问题指南参看:faultloggerd FAQ

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, intfd);
  • 支持批量抓栈: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
#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 = truepart_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 接口/命令行工具 主动抓栈处理流程

在这里插入图片描述

  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)。

Rust Panic 故障日志收集流程

// TODO

相关仓

DFX子系统

hiviewdfx_hiview

hiviewdfx_hilog

hiviewdfx_hiappevent

hiviewdfx_hisysevent

hiviewdfx_faultloggerd

hiviewdfx_hilog_lite

hiviewdfx_hievent_lite

hiviewdfx_hiview_lite

为了帮助大家更深入有效的学习到鸿蒙开发知识点,小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源,获取完整版方式请点击→HarmonyOS教学视频:https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

HarmonyOS教学视频:语法ArkTS、TypeScript、ArkUI等…视频教程

在这里插入图片描述
在这里插入图片描述

鸿蒙生态应用开发白皮书V2.0PDF: 获取完整版白皮书方式请点击→https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG?u=a42c4946d1514235863bb82a7b2ac128

在这里插入图片描述

鸿蒙 (Harmony OS)开发学习手册→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

一、入门必看

1.应用开发导读(ArkTS)
2………
在这里插入图片描述

二、HarmonyOS 概念→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.系统定义
2.技术架构
3.技术特性
4.系统安全
5…

在这里插入图片描述

三、如何快速入门?→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3…

在这里插入图片描述

四、开发基础知识→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
在这里插入图片描述

五、基于ArkTS 开发→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
在这里插入图片描述

更多了解更多鸿蒙开发的相关知识可以参考:https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

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

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Spring容器获取bean实例

使用spring框架的过程中获取bean是非常常见的操作,此处列举了七种获取方式: 1.使用BeanFactory从工厂中直接获取Bean实例,但是XmlBeanFactory类已经废弃,不建议使用 @Test public void getBeanTest1() {BeanFactory beanFactory = new XmlBeanFactory(new ClassPathResou…

【S32K3 MCAL配置】-4.2-CAN Driver:CanObjectId排序规则,其影响CAN报文的收发

"><--返回「Autosar_MCAL高阶配置」专栏主页--> 目录(共7页精讲,基于评估板: NXP S32K312EVB-Q172,手把手教你S32K3从入门到精通) 实现的架构:基于MCAL层 前期准备工作:

umi的好处

插件化架构&#xff1a; UMI框架采用了插件化的架构设计&#xff0c;开发者可以根据项目需求选择安装和配置不同的插件&#xff0c;扩展框架的功能。 约定式路由&#xff1a; UMI框架默认采用约定式路由&#xff0c;开发者无需手动配置路由信息&#xff0c;只需要按照约定的规…

汇舟问卷:国外问卷调查适合哪些人?

在这个快节奏的时代&#xff0c;朝九晚五的工作模式似乎已经成为许多人的固定生活模式。然而&#xff0c;这种日复一日的工作方式往往让人感到疲惫和厌倦&#xff0c;我们渴望找到一种既能赚钱又能兼顾生活的方式。 海外问卷调查作为一种适合在家做的赚钱方式&#xff0c;这两…

【Golang学习笔记】从零开始搭建一个Web框架(二)

文章目录 模块化路由前缀树路由 前情提示&#xff1a; 【Golang学习笔记】从零开始搭建一个Web框架&#xff08;一&#xff09;-CSDN博客 模块化路由 路由在kilon.go文件中导致路由和引擎交织在一起&#xff0c;如果要实现路由功能的拓展增强&#xff0c;那将会非常麻烦&…

华为OD-C卷-游戏分组[100分]

题目描述 部门准备举办一场王者荣耀表演赛&#xff0c;有 10 名游戏爱好者参与&#xff0c;分为两队&#xff0c;每队 5 人。 每位参与者都有一个评分&#xff0c;代表着他的游戏水平。为了表演赛尽可能精彩&#xff0c;我们需要把 10 名参赛者分为示例尽量相近的两队。 一队…

基于Springboot+Vue的Java项目-课程作业管理系统(附演示视频+源码+LW)

大家好&#xff01;我是程序员一帆&#xff0c;感谢您阅读本文&#xff0c;欢迎一键三连哦。 &#x1f49e;当前专栏&#xff1a;Java毕业设计 精彩专栏推荐&#x1f447;&#x1f3fb;&#x1f447;&#x1f3fb;&#x1f447;&#x1f3fb; &#x1f380; Python毕业设计 &am…

密码学基础--搞清RFC和PKCS(2)

目录 1.引入 ​2. RFC是什么 3. PKCS是什么 4.小结 1.引入 老规矩&#xff0c;先从RFC是什么开始说起 ​2. RFC是什么 RFC是“Request for Comments”的缩写&#xff0c;本身它是一系列文件&#xff0c;描述了互联网的各种协议、技术规范、方法。它们由互联网工程任务组&…

rocketmq面试

broker主从复制机制 同步复制&#xff1a; 等Master和Slave均写成功后&#xff0c;才反馈给客户端写成功状态&#xff1b; 如果Master出故障&#xff0c; Slave上有全部的备份数据&#xff0c;容易恢复&#xff0c;但是同步复制会增大数据写入延迟&#xff0c;降低系统吞吐量。…

DDD之DP对象的应用

定义 在领域驱动设计&#xff08;Domain-Driven Design&#xff0c;DDD&#xff09;中&#xff0c;“Domain Primitive”&#xff08;领域原语&#xff09;是指领域模型中的基本数据类型或值对象&#xff0c;它们代表了业务领域中的最基本的、不可分割的数据元素。Domain Prim…

Linux系统常见20问题及处理方法(涵盖了安装、配置、使用、维护等方面)

一、系统启动问题 1. 无法启动系统 示例: 开机后出现黑屏或无法进入登录界面。 可能原因: 硬件故障: 电源故障:电源线未连接或电源损坏。内存故障:内存条松动或损坏。主板故障:主板损坏。显卡故障:显卡损坏。GRUB引导菜单错误: 引导菜单配置错误:引导菜单中没有可引导的…

Linux第86步_了解“阻塞和非阻塞IO”以及相关处理函数

1、IO “应用程序”对“驱动设备“进行输入/输出操作&#xff0c;简称IO操作&#xff0c;它是Input和Output的缩写。 2、阻塞IO 阻塞IO是“应用程序”对“驱动设备”进行操作&#xff0c;若不能获取到设备资源&#xff0c;则阻塞IO应用程序的线程会被“挂起”&#xff0c;直到…

使用LNMP部署动态网站环境

目录 实验环境 一、配置LNMP架构环境 二、验证部署的LNMP 动态网站环境是否可用 三、配置过程中遇到的问题及解决思路 实验环境 centos7 192.168.81.131/24 一、配置LNMP架构环境 概念及配置手册参考第20章 使用LNMP架构部署动态网站环境。 | 《Linux就该这么学》 安装g…

Java编程练习之接口的声明及实现

1.创建老师类和学生类&#xff0c;两个类都实现了问候接口和工作接口&#xff0c;模拟上课的场景&#xff0c;运行效果如下&#xff1a; package Zaria; interface hello{public void speak(); } interface work{public void dowork(); } class Student implements hello,work{…

PCL 基于马氏距离KMeans点云聚类

文章目录 一、简介二、算法步骤三、代码实现四、实现效果参考资料一、简介 在诸多的聚类方法中,K-Means聚类方法是属于“基于原型的聚类”(也称为原型聚类)的方法,此类方法均是假设聚类结构能通过一组原型刻画,在现实聚类中极为常用。通常情况下,该类算法会先对原型进行初始…

嵌入式与移动物联网开发教程和案例

一、嵌入式与移动物联网概述 嵌入式系统是指嵌入到设备中的专用计算机系统&#xff0c;用于控制、监视或辅助设备操作。而移动物联网则是指通过物联网技术将各种智能设备与互联网连接起来&#xff0c;实现设备之间的互联互通和智能化管理。嵌入式与移动物联网技术的结合&#…

深入剖析Cargo缓存机制

一、介绍 Cargo作为Rust的包管理工具&#xff0c;不仅在项目构建中扮演了重要的角色&#xff0c;其高效的缓存机制也为Rust开发者节省了大量的时间。本文将深入探讨Cargo的缓存原理和使用技巧&#xff0c;并提供丰富的示例让你轻松掌握Cargo缓存的管理和优化。 二、Cargo缓存…

相位校正啊

相位校正是信号处理中的一种常见技术&#xff0c;用于确保多个信号在相位上对齐&#xff0c;这对于后续的信号分析和处理至关重要。在处理三相信号时&#xff0c;相位校正尤为重要&#xff0c;因为它可以保证三相之间的相位关系准确&#xff0c;从而正确分析信号特性和检测问题…

MongoDB聚合运算符:$pow

文章目录 语法使用 举例 MongoDB聚合运算符&#xff1a; p o w ‘ pow pow‘pow聚合运算符用于求数字指定的指数并返回结果。 语法 { $pow: [ <number>, <exponent> ] }参数说明&#xff1a; <number>表达式可以是任何可解析为数值的表达式<exponent&g…

golang 协程题目

都是一个货色&#xff0c;要么使用无缓冲channel, 要么使用有缓冲chanwaitgroup等待协程退出&#xff0c;或者使用全局变量判断是否终止协程 2个协程交替打印奇数和偶数 无缓冲channel实现 package mainimport "fmt"func main() {maxval : 10ch1 : make(chan stru…