1# devicedebug工具
2
3
4devicedebug工具向开发者提供对调试应用发送信号的能力，目前仅支持向AMS管理的debug类型的应用进程的pid发送signal信号，达到终止对应pid进程的能力。
5
6> **说明：**
7>
8> 在使用本工具前，开发者需要先获取<!--Del-->[<!--DelEnd-->hdc工具<!--Del-->](../../device-dev/subsystems/subsys-toolchain-hdc-guide.md)<!--DelEnd-->，执行hdc shell。
9
10**表1** devicedebug工具命令列表
11
12| 命令 | 描述 |
13| -------- | -------- |
14| help/-h | 帮助命令，显示devicedebug支持的命令信息。 |
15| kill | 终止进程命令，用来终止对应pid进程。 |
16
17
18## 帮助命令
19```bash
20devicedebug help
21```
22
23**表2** help命令列表
24
25| 命令    | 描述       |
26| ------- | ---------- |
27| devicedebug help | 显示devicedebug支持的命令信息。 |
28
29示例：
30
31```bash
32# 显示帮助信息。
33devicedebug help
34```
35
36
37## 终止进程命令
38
39```bash
40devicedebug kill
41```
42用于向debug类型的应用进程发送signal（1-64）信号，应用进程接受到信号后终止对应pid进程。
43
44**表3** kill命令列表
45  | 命令 | 描述 |
46  | -------- |-------------------|
47  | help/-h | 帮助信息。|
48  | -\<signal\> \<pid\> |  必选字段，signal（1-64）为终止信号，终止pid对应的debug类型的应用进程。 |
49
50  **返回值**：
51
52  当pid对应的进程为非应用进程时，返回"devicedebug: kill: {pid}: No such app process"；当pid对应的进程为非debug类型的应用进程时，返回"devicedebug: kill: process: {pid} is not debuggable app"。
53
54示例：
55  ```bash
56  # 以终止12111进程，signal信号9为例。
57  devicedebug kill -9 12111
58  ```
59
60