1# HiDumper概述 2 3 4## 功能简介 5 6HiDumper是OpenHarmony为开发、测试人员、IDE工具提供的系统信息获取工具，帮助开发者分析、定位问题。本章节内容适用于标准系统。 7 8## 源码目录说明 9 10 11``` 12/base/hiviewdfx/hidumper 13├── frameworks # 框架代码 14│ ├── native # 导出功能核心代码 15│ │ │── include # 头文件目录 16│ │ │── src # 源文件目录 17│ │ │── common # 通用功能代码 18│ │ │── executor # 导出过程执行器代码 19│ │ │── factory # 跟进导出项生成导出执行器 20│ │ │── manager # 导出管理核心代码 21│ │ │── util # 工具类源代码 22│── sa_profile # Hidumper sa属性文件 23│── services # Hidumper服务源码 24│ │── native # 服务C++源码 25│ │── zidl # 通讯功能源码目录 26│ │ │── include # 通讯功能头文件 27│ │ │── src # 通讯功能源代码 28├── test # 测试用例目录 29│ ├── unittest # 单元测试代码 30│ ├── moduletest # 模块级别测试代码 31``` 32 33 34# HiDumper使用指导 35 36 37## 命令参数说明 38 39 **表1** HiDumper命令参数说明 40 41| 选项 | **描述** | 42| -------- | -------- | 43| -h | 查看帮助信息。 | 44| -t [timeout] | 超时时间，单位：秒。默认值是30s。如果设置为0表示无超时限定。 | 45| -lc | 查看系统信息簇列表。 | 46| -ls | 查看系统元能力列表。 | 47| -c | 导出系统簇信息。 | 48| -c [base system] | 以base或system标签区分的系统簇信息导出。 | 49| -s | 导出全部系统元能力信息 | 50| -s [SA0 SA1] | 导出SA0、SA1等元能力id对应的元能力信息。 | 51| -s [SA] -a ['-h'] | 以-h为参数导出SA指定的系统元能力信息。 | 52| -e | 导出Faultlog模块生成的崩溃日志。 | 53| --net | 导出网络信息。 | 54| --storage | 导出存储信息。 | 55| -p | 导出进程列表及全部进程信息。 | 56| -p [pid] | 导出指定进程号的进程全部信息。 | 57| --cpuusage [pid] | 导出CPU使用信息。如果指定pid则导出该进程的CPU使用信息。 | 58| --cpufreq | 导出实际的CPU频率 | 59| --mem [pid] | 导出内存使用信息。如果指定pid则导出该进程的内存使用信息。 | 60| --zip | 将导出信息压缩到固定文件夹下。 | 61 62 63## 使用实例 64 65HiDumper可以为开发者导出系统当前基本信息，通过这些基本信息可以定位分析问题。给子服务和元能力传递复杂参数时，参数需要加双引号。 66 67具体步骤如下： 68 691. 进入设备命令行，输入 hidumper -h 获取基本信息介绍，功能语法介绍。 70 71 ``` 72 hidumper -h 73 ``` 74 752. 输入 hidumper -lc 获取系统信息分类列表。 76 77 ``` 78 hidumper -lc 79 ``` 80 813. 输入 hidumper -c 获取系统base、system等所有分类信息。 82 83 ``` 84 hidumper -c 85 ``` 86 874. 输入 hidumper -c [base | system] 按 base 或 system 分类获取系统簇信息。 88 89 ``` 90 hidumper -c base 91 hidumper -c system 92 ``` 93 945. 输入 hidumper -ls 命令获取系统中元能力列表。 95 96 ``` 97 hidumper -ls 98 ``` 99 1006. 输入 hidumper -s 命令获取系统全部元能力信息。 101 102 ``` 103 hidumper -s 104 ``` 105 1067. 运行 hidumper -s 3301 -a "-h" 命令获取id为3301的元能力的帮助。 107 108 ``` 109 hidumper -s 3301 -a "-h" 110 ``` 111 1128. 运行 hidumper -s 3008命令获取id为3008的元能力的全部信息。 113 114 ``` 115 hidumper -s 3008 116 ``` 117 1189. 运行 hidumper -e 命令获取Faultlog模块生成的崩溃历史信息。 119 120 ``` 121 hidumper -e 122 ``` 123 12410. 运行 hidumper --net 命令获取网络信息。 125 126 ``` 127 hidumper --net 128 ``` 129 13011. 运行 hidumper --storage 命令获取存储相关信息。 131 132 ``` 133 hidumper --storage 134 ``` 135 13612. 运行 hidumper -p 命令获取进程信息，包括进程、线程的列表和信息。 137 138 ``` 139 hidumper -p 140 ``` 141 14213. 运行 hidumper -p 1024 命令获取pid为1024的进程信息。 143 144 ``` 145 hidumper -p 1024 146 ``` 147 14814. 运行 hidumper --cpuusage [pid] 命令获取CPU的使用信息。如果指定了进程的pid，则只获取该进程的CPU使用信息。 149 150 ``` 151 hidumper --cpuusage 152 hidumper --cpuusage 1024 153 ``` 154 15515. 运行 hidumper --cpufreq 命令获取每一个CPU核实际运行的频率。 156 157 ``` 158 hidumper --cpufreq 159 ``` 160 16116. 运行 hidumper --mem [pid] 命令获取全部的内存使用信息。如果指定进程的pid，只获取该进程的内存使用情况。 162 163 ``` 164 hidumper --mem [pid] 165 ``` 166 当携带pid参数时输出结果中第一列标题的详细说明如下： 167 | 名称 | 描述 | 168 |----------------|----| 169 | GL | GPU内存 | 170 | Graph | 图形内存 | 171 | ark ts heap | ArkTS堆的内存占用 | 172 | guard | 保护段所占内存 | 173 | native heap | 堆内存 | 174 | AnonPage other | 其它没有被映射到文件的页所占内存 | 175 | stack | 栈内存 | 176 | .hap | 应用程序所占内存 | 177 | .db | 进程加载的.db数据文件所占内存 | 178 | .so | 进程加载的.so动态库所占内存 | 179 | .ttf | 进程加载的.ttf字体文件所占内存 | 180 | dev | 进程加载的以/dev开头的文件所占内存 | 181 | FilePage other | 其它有被映射到文件的页所占内存 | 182 18317. 运行 hidumper --zip 命令压缩信息数据到/data/dumper目录下。 184 185 ``` 186 hidumper --zip 187 ``` 188 18918. 运行 hidumper -t timeout 命令设置超时时间，单位：秒。默认值是30s。如果设置为0表示无超时限制。 190 191 ``` 192 hidumper -t [timeout] 193 ``` 194