Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
XKZJ_WCL
Docs
提交
c490b9ce
D
Docs
项目概览
XKZJ_WCL
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
c490b9ce
编写于
3月 27, 2023
作者:
O
openharmony_ci
提交者:
Gitee
3月 27, 2023
浏览文件
操作
浏览文件
下载
差异文件
!16529 优化Hicollie开发指导文档
Merge pull request !16529 from honghecun/master
上级
d653d420
2dc3ac61
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
18 addition
and
35 deletion
+18
-35
zh-cn/device-dev/subsystems/subsys-dfx-hicollie.md
zh-cn/device-dev/subsystems/subsys-dfx-hicollie.md
+18
-35
未找到文件。
zh-cn/device-dev/subsystems/subsys-dfx-hicollie.md
浏览文件 @
c490b9ce
...
...
@@ -8,45 +8,28 @@ HiCollie提供了软件看门狗功能。针对系统服务死锁、应用主线
## 接口说明
**表1**
C++接口功能描述表
**表1**
XCollieChecker接口
| 所属类 | 接口定义 | 描述 |
| -------- | -------- | -------- |
| XCollieChecker类接口 | virtual
void
CheckBlock() | 接口功能:卡死检测回调函数。
<br/>
输入参数:无。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| XCollieChecker类接口 | virtual
void
CheckThreadBlock() | 接口功能:线程卡死检测回调函数。
<br/>
输入参数:无。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| XCollie类接口 | void
RegisterXCollieChecker(const
sptr
&
lt;XCollieChecker
&
gt;
&
checker,
unsigned
int
type) | 接口功能:线程卡死检测回调函数注册。
<br/>
输入参数:
<br/>
-
checker:XCollieChecker实例指针。
<br/>
-
type:卡死检测类型,取值设置为XCOLLIE_THREAD。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| XCollie类接口 | int
SetTimer(const
std::string
&
name,
unsigned
int
timeout,
std::function
&
lt;void
(void
_)
&
gt;
func,
void
_arg,
unsigned
int
flag) | 接口功能:添加定时器。
<br/>
输入参数:
<br/>
-
name:定时器名称。
<br/>
-
timeout:超时时间,单位为秒。
<br/>
-
func:超时回调函数。
<br/>
-
arg:超时回调函数参数指针。
<br/>
-
flag:定时器操作类型。
<br/>
XCOLLIE_FLAG_DEFAULT
//
其他三个选项功能之和
<br/>
XCOLLIE_FLAG_NOOP
//
仅调用超时回调函数
<br/>
XCOLLIE_FLAG_LOG
//
生成超时故障日志
<br/>
XCOLLIE_FLAG_RECOVERY
//
进程退出
<br/>
输出参数:无。
<br/>
返回值:成功返回定时器标识,失败返回-1。 |
| XCollie类接口 | bool
UpdateTimer(int
id,
unsigned
int
timeout) | 接口功能:更新定时器。
<br/>
输入参数:
<br/>
-
id:定时器标识。
<br/>
-
timeout:超时时间,单位为秒。
<br/>
输出参数:无。
<br/>
返回值:成功返回true,失败返回false。 |
| XCollie类接口 | void
CancelTimer(int
id) | 接口功能:取消定时器。
<br/>
输入参数:定时器标识。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| 接口名称 | 描述 |
| -------- | -------- |
| virtual void CheckBlock() | 接口功能:卡死检测回调函数。
<br/>
输入参数:无。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| virtual void CheckThreadBlock() | 接口功能:线程卡死检测回调函数。
<br/>
输入参数:无。
<br/>
输出参数:无。
<br/>
返回值:无。 |
## 效果
**表2**
XCollie接口
日志打印:
```
timeout: TimeoutTimer start at 1611040305 to check 1s ago
----------StacktraceCatcher CurrentTime:2021-01-19 15:11:45 Unexecuted(-1)(LogType:Stacktrace Pid:27689 Process:XCollieTimeoutModuleTest)----------
----- pid 27689 at 2021-01-19 15:11:45 -----
Cmd line: ./XCollieTimeoutModuleTest
ABI: 'arm64'
"XCollieTimeoutM" sysTid=27689
#01 pc 00000000000174cc /data/test/XCollieTimeoutModuleTest
```
| 接口名称 | 描述 |
| -------- | -------- |
| void RegisterXCollieChecker(const sptr
<
XCollieChecker
>
&
checker, unsigned int type) | 接口功能:线程卡死检测回调函数注册。
<br/>
输入参数:
<br/>
-
**checker**
:XCollieChecker实例指针。
<br/>
-
**type**
:卡死检测类型,取值设置为
**XCOLLIE_THREAD**
。
<br/>
输出参数:无。
<br/>
返回值:无。 |
| int SetTimer(const std::string
&
name, unsigned int timeout, std::function
<
void(void*)
>
func, void
*arg, unsigned int flag) | 接口功能:添加定时器。<br/>输入参数:<br/>- **name**:定时器名称。<br/>- **timeout**:超时时间,单位为秒。<br/>- **func**:超时回调函数。<br/>- **arg**:超时回调函数参数指针。<br/>- **flag**:定时器操作类型。<br/> XCOLLIE_FLAG_DEFAULT:其他三个选项功能之和<br/> XCOLLIE_FLAG_NOOP:仅调用超时回调函数<br/> XCOLLIE_FLAG_LOG:生成超时故障日志<br/> XCOLLIE_FLAG_RECOVERY:进程退出<br/>输出参数:无。<br/>返回值:成功返回定时器标识,失败返回 **-1*
*
。 |
| bool UpdateTimer(int id, unsigned int timeout) | 接口功能:更新定时器。
<br/>
输入参数:
<br/>
-
**id**
:定时器标识。
<br/>
-
**timeout**
:超时时间,单位为秒。
<br/>
输出参数:无。
<br/>
返回值:成功返回
**true**
,失败返回
**false**
。 |
| void CancelTimer(int id) | 接口功能:取消定时器。
<br/>
输入参数:
<br/>
-
**id**
:定时器标识。
<br/>
输出参数:无。
<br/>
返回值:无。 |
## 开发实例
### C++接口开发实例
### 线程卡死监控
### 线程卡死监控开发实例
线程卡死监控功能需要开发者实现两个卡死检测回调函数,XCollieChecker类的CheckBlock和CheckThreadBlock接口函数。实现了该回调函数之后,开发者还需要通过XCollie类的RegisterXCollieChecker函数,将该回调函数的类实例成功注册。卡死监控线程会定时执行全部已成功注册的回调函数,检查线程逻辑完成标志位,判定已经成功注册的线程逻辑是否被卡死。
...
...
@@ -84,7 +67,7 @@ ABI: 'arm64'
```
### 超时监控
### 超时监控
开发实例
单个进程通过SetTimer接口函数添加定时器最多可以设置128个,超过上限则添加定时器操作会失败。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录