1# HiDumper开发指导 2 3 4## 概述 5 6 7### 功能简介 8 9HiDumper是OpenHarmony为开发、测试人员、IDE工具提供的系统信息获取工具，帮助开发者分析、定位问题。本章节内容适用于标准系统。 10 11 12### 源码目录说明 13 14 15``` 16/base/hiviewdfx/hidumper 17├── frameworks # 框架代码 18│ ├── native # 导出功能核心代码 19│ │ │── include # 头文件目录 20│ │ │── src # 源文件目录 21│ │ │── common # 通用功能代码 22│ │ │── executor # 导出过程执行器代码 23│ │ │── factory # 跟进导出项生成导出执行器 24│ │ │── manager # 导出管理核心代码 25│ │ │── util # 工具类源代码 26│── sa_profile # Hidumper sa属性文件 27│── services # Hidumper服务源码 28│ │── native # 服务C++源码 29│ │── zidl # 通讯功能源码目录 30│ │ │── include # 通讯功能头文件 31│ │ │── src # 通讯功能源代码 32├── test # 测试用例目录 33│ ├── unittest # 单元测试代码 34│ ├── moduletest # 模块级别测试代码 35``` 36 37 38## 使用指导 39 40 41### 命令参数说明 42 43 **表1** HiDumper命令参数说明 44 45| 选项 | **描述** | 46| -------- | -------- | 47| -h | 帮助信息 | 48| -t [timeout] | 超时时间，单位：秒。默认值是30s。如果设置为0表示无超时限定。 | 49| -lc | 系统信息簇列表 | 50| -ls | 系统元能力列表 | 51| -c | 导出系统簇信息 | 52| -c [base system] | 以base或system标签区分的系统簇信息导出 | 53| -s | 导出全部系统元能力信息 | 54| -s [SA0 SA1] | 导出SA0、SA1等元能力id对应的元能力信息 | 55| -s [SA] -a ['-h'] | 以-h为参数导出SA指定的系统元能力信息 | 56| -e | 导出Faultlog模块生成的崩溃日志 | 57| --net | 导出网络信息 | 58| --storage | 导出存储信息 | 59| -p | 导出进程列表及全部进程信息 | 60| -p [pid] | 导出指定进程号的进程全部信息 | 61| --cpuusage [pid] | 导出CPU使用信息；如果指定pid则导出该进程的CPU使用信息 | 62| --cpufreq | 导出实际的CPU频率 | 63| --mem [pid] | 导出内存使用信息；如果指定pid则导出该进程的内存使用信息 | 64| --zip | 将导出信息压缩到固定文件夹下 | 65 66 67### 使用实例 68 69HiDumper可以为开发者导出系统当前基本信息，通过这些基本信息可以定位分析问题。给子服务和元能力传递复杂参数时，参数需要在双引号中。 70 71具体步骤如下： 72 731. 进入设备命令行，输入hidumper -h获取基本信息介绍，功能语法介绍。 74 75 ``` 76 hidumper -h 77 ``` 78 792. 输入hidumper -lc获取系统信息分类列表。 80 81 ``` 82 hidumper -lc 83 ``` 84 853. 输入hidumper -c获取系统base、system等所有分类信息。 86 87 ``` 88 hidumper -c 89 ``` 90 914. 输入 hidumper -c [base | system] 按 base 或 system 分类获取系统簇信息 92 93 ``` 94 hidumper -c base 95 hidumper -c system 96 ``` 97 985. 输入 hidumper -ls 命令获取系统中元能力列表 99 100 ``` 101 hidumper -ls 102 ``` 103 1046. 输入 hidumper -s 命令获取系统全部元能力信息 105 106 ``` 107 hidumper -s 108 ``` 109 1107. 运行 hidumper -s 3301 -a "-h" 命令获取id为3301的元能力的帮助 111 112 ``` 113 hidumper -s 3301 -a "-h" 114 ``` 115 1168. 运行 hidumper -s 3008命令获取id为3008的元能力的全部信息 117 118 ``` 119 hidumper -s 3008 120 ``` 121 1229. 运行 hidumper -e 命令获取Faultlog模块生成的崩溃历史信息 123 124 ``` 125 hidumper -e 126 ``` 127 12810. 运行 hidumper --net 命令获取网络信息 129 130 ``` 131 hidumper --net 132 ``` 133 13411. 运行 hidumper --storage 命令获取存储相关信息 135 136 ``` 137 hidumper --storage 138 ``` 139 14012. 运行 hidumper -p 命令获取进程信息，包括进程、线程的列表和信息 141 142 ``` 143 hidumper -p 144 ``` 145 14613. 运行 hidumper -p 1024 命令获取pid为1024的进程信息 147 148 ``` 149 hidumper -p 1024 150 ``` 151 15214. 运行 hidumper --cpuusage [pid] 命令获取CPU的使用信息；如果指定了进程的pid，则只获取该进程的CPU使用信息 153 154 ``` 155 hidumper --cpuusage 156 hidumper --cpuusage 1024 157 ``` 158 15915. 运行 hidumper --cpufreq 命令获取每一个CPU核实际运行的频率 160 161 ``` 162 hidumper --cpufreq 163 ``` 164 16516. 运行 hidumper --mem [pid] 命令获取全部的内存使用信息；如果指定进程的pid，只获取该进程的内存使用情况 166 167 ``` 168 hidumper --mem [pid] 169 ``` 170 17117. 运行 hidumper --zip 命令压缩信息数据到/data/dumper目录下 172 173 ``` 174 hidumper --zip 175 ``` 176 17718. 运行 hidumper -t timeout 命令设置超时时间，单位：秒。默认值是30s。如果设置为0表示无超时限定。 178 179 ``` 180 hidumper -t [timeout] 181 ``` 182