1e41f4b71Sopenharmony_ci# SHELL 2e41f4b71Sopenharmony_ci 3e41f4b71Sopenharmony_ciOpenHarmony内核提供的Shell支持调试常用的基本功能，包含系统、文件、网络相关命令。同时OpenHarmony内核的Shell支持添加新的命令，可以根据需求来进行定制。 4e41f4b71Sopenharmony_ci 5e41f4b71Sopenharmony_ciShell功能仅供调试使用，暂不支持tab按键补全，按键回退等功能。 6e41f4b71Sopenharmony_ci 7e41f4b71Sopenharmony_ci部分命令需要通过make menuconfig开启对应选项才可使用。 8e41f4b71Sopenharmony_ci 9e41f4b71Sopenharmony_ci## 常用命令介绍 10e41f4b71Sopenharmony_ci 11e41f4b71Sopenharmony_ci### cat 12e41f4b71Sopenharmony_ci 13e41f4b71Sopenharmony_ci用于显示文本文件的内容。需开启LOSCFG_FS_VFS。 14e41f4b71Sopenharmony_ci 15e41f4b71Sopenharmony_ci###### 命令格式 16e41f4b71Sopenharmony_ci 17e41f4b71Sopenharmony_cicat [FILE] 18e41f4b71Sopenharmony_ci 19e41f4b71Sopenharmony_ci###### 参数说明 20e41f4b71Sopenharmony_ci 21e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 22e41f4b71Sopenharmony_ci| ---- | ---------- | -------------- | 23e41f4b71Sopenharmony_ci| FILE | 文件路径。 | 已存在的文件。 | 24e41f4b71Sopenharmony_ci 25e41f4b71Sopenharmony_ci### cd 26e41f4b71Sopenharmony_ci 27e41f4b71Sopenharmony_ci用来改变当前目录。需开启LOSCFG_FS_VFS。 28e41f4b71Sopenharmony_ci 29e41f4b71Sopenharmony_ci###### 命令格式 30e41f4b71Sopenharmony_ci 31e41f4b71Sopenharmony_cicd [path] 32e41f4b71Sopenharmony_ci 33e41f4b71Sopenharmony_ci###### 参数说明 34e41f4b71Sopenharmony_ci 35e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 36e41f4b71Sopenharmony_ci| ---- | ---------- | -------------- | 37e41f4b71Sopenharmony_ci| path | 文件路径。 | 已存在的路径。 | 38e41f4b71Sopenharmony_ci 39e41f4b71Sopenharmony_ci### cp 40e41f4b71Sopenharmony_ci 41e41f4b71Sopenharmony_ci拷贝文件，创建一份副本。需开启LOSCFG_FS_VFS。 42e41f4b71Sopenharmony_ci 43e41f4b71Sopenharmony_ci###### 命令格式 44e41f4b71Sopenharmony_ci 45e41f4b71Sopenharmony_cicp [SOURCEFILE] [DESTFILE] 46e41f4b71Sopenharmony_ci 47e41f4b71Sopenharmony_ci###### 参数说明 48e41f4b71Sopenharmony_ci 49e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 50e41f4b71Sopenharmony_ci| ---------- | ---------------------- | ----------------------------------------- | 51e41f4b71Sopenharmony_ci| SOURCEFILE | 源文件路径。文件路径。 | 目前只支持文件,不支持目录；文件不可为空。 | 52e41f4b71Sopenharmony_ci| DESTFILE | 目的文件路径。 | 支持目录以及文件名；目录需有效。 | 53e41f4b71Sopenharmony_ci 54e41f4b71Sopenharmony_ci### date 55e41f4b71Sopenharmony_ci 56e41f4b71Sopenharmony_ci用于查询系统日期和时间。 57e41f4b71Sopenharmony_ci 58e41f4b71Sopenharmony_ci###### 命令格式 59e41f4b71Sopenharmony_ci 60e41f4b71Sopenharmony_cidate 61e41f4b71Sopenharmony_ci 62e41f4b71Sopenharmony_ci###### 参数说明 63e41f4b71Sopenharmony_ci 64e41f4b71Sopenharmony_ci无 65e41f4b71Sopenharmony_ci 66e41f4b71Sopenharmony_ci### free 67e41f4b71Sopenharmony_ci 68e41f4b71Sopenharmony_ci显示系统内存的使用情况。 69e41f4b71Sopenharmony_ci 70e41f4b71Sopenharmony_ci###### 命令格式 71e41f4b71Sopenharmony_ci 72e41f4b71Sopenharmony_cifree [ -k | -m ] 73e41f4b71Sopenharmony_ci 74e41f4b71Sopenharmony_ci###### 参数说明 75e41f4b71Sopenharmony_ci 76e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 77e41f4b71Sopenharmony_ci| ---- | ----------------- | -------- | 78e41f4b71Sopenharmony_ci| -k | 以KiB为单位显示。 | N/A | 79e41f4b71Sopenharmony_ci| -m | 以MiB为单位显示。 | N/A | 80e41f4b71Sopenharmony_ci 81e41f4b71Sopenharmony_ci### help 82e41f4b71Sopenharmony_ci 83e41f4b71Sopenharmony_ci显示当前操作系统内所有操作指令。 84e41f4b71Sopenharmony_ci 85e41f4b71Sopenharmony_ci###### 命令格式 86e41f4b71Sopenharmony_ci 87e41f4b71Sopenharmony_cihelp 88e41f4b71Sopenharmony_ci 89e41f4b71Sopenharmony_ci###### 参数说明 90e41f4b71Sopenharmony_ci 91e41f4b71Sopenharmony_ci无 92e41f4b71Sopenharmony_ci 93e41f4b71Sopenharmony_ci### ifconfig 94e41f4b71Sopenharmony_ci 95e41f4b71Sopenharmony_ci用来查询网卡的IP地址、网络掩码、网关、硬件mac地址等参数。需开启LWIP_SHELLCMD_ENABLE。 96e41f4b71Sopenharmony_ci 97e41f4b71Sopenharmony_ci###### 命令格式 98e41f4b71Sopenharmony_ci 99e41f4b71Sopenharmony_ciifconfig 100e41f4b71Sopenharmony_ci 101e41f4b71Sopenharmony_ci###### 参数说明 102e41f4b71Sopenharmony_ci 103e41f4b71Sopenharmony_ci无 104e41f4b71Sopenharmony_ci 105e41f4b71Sopenharmony_ci### ls 106e41f4b71Sopenharmony_ci 107e41f4b71Sopenharmony_ci用来显示当前目录的内容。需开启LOSCFG_FS_VFS。 108e41f4b71Sopenharmony_ci 109e41f4b71Sopenharmony_ci###### 命令格式 110e41f4b71Sopenharmony_ci 111e41f4b71Sopenharmony_ci###### ls [DIRECTORY] 112e41f4b71Sopenharmony_ci 113e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 114e41f4b71Sopenharmony_ci| --------- | ---------- | ------------------------------------------------------------ | 115e41f4b71Sopenharmony_ci| DIRECTORY | 文件路径。 | DIRECTORY为空时，显示当前目录的内容。<br/>DIRECTORY为有效目录路径时，会显示对应目录下的内容。<br/>当前LiteOS-M不支持根目录 "/"。 | 116e41f4b71Sopenharmony_ci 117e41f4b71Sopenharmony_ci### memusage 118e41f4b71Sopenharmony_ci 119e41f4b71Sopenharmony_ci用来显示内存使用水线。 120e41f4b71Sopenharmony_ci 121e41f4b71Sopenharmony_ci###### 命令格式 122e41f4b71Sopenharmony_ci 123e41f4b71Sopenharmony_ci###### memusage [-k/-m] 124e41f4b71Sopenharmony_ci 125e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 126e41f4b71Sopenharmony_ci| ---- | ----------------- | -------- | 127e41f4b71Sopenharmony_ci| -k | 以KiB为单位显示。 | N/A | 128e41f4b71Sopenharmony_ci| -m | 以MiB为单位显示。 | N/A | 129e41f4b71Sopenharmony_ci 130e41f4b71Sopenharmony_ci### mkdir 131e41f4b71Sopenharmony_ci 132e41f4b71Sopenharmony_ci用来创建一个目录。需开启LOSCFG_FS_VFS。 133e41f4b71Sopenharmony_ci 134e41f4b71Sopenharmony_ci###### 命令格式 135e41f4b71Sopenharmony_ci 136e41f4b71Sopenharmony_ci###### mkdir [DIRECTORY] 137e41f4b71Sopenharmony_ci 138e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 139e41f4b71Sopenharmony_ci| --------- | ---------- | ------------------------------------- | 140e41f4b71Sopenharmony_ci| DIRECTORY | 文件路径。 | DIRECTORY可以传入绝对路径和相对路径。 | 141e41f4b71Sopenharmony_ci 142e41f4b71Sopenharmony_ci### ping 143e41f4b71Sopenharmony_ci 144e41f4b71Sopenharmony_ci用来测试网络连接是否正常。需开启LWIP_SHELLCMD_ENABLE。 145e41f4b71Sopenharmony_ci 146e41f4b71Sopenharmony_ci###### 命令格式 147e41f4b71Sopenharmony_ci 148e41f4b71Sopenharmony_ci###### ping [ip] 149e41f4b71Sopenharmony_ci 150e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 151e41f4b71Sopenharmony_ci| ---- | ------------------------------ | -------- | 152e41f4b71Sopenharmony_ci| ip | 要测试是否网络连通的IPv4地址。 | N/A | 153e41f4b71Sopenharmony_ci 154e41f4b71Sopenharmony_ci### pwd 155e41f4b71Sopenharmony_ci 156e41f4b71Sopenharmony_ci用来显示当前路径。需开启LOSCFG_FS_VFS。 157e41f4b71Sopenharmony_ci 158e41f4b71Sopenharmony_ci###### 命令格式 159e41f4b71Sopenharmony_ci 160e41f4b71Sopenharmony_ci###### pwd 161e41f4b71Sopenharmony_ci 162e41f4b71Sopenharmony_ci### rm 163e41f4b71Sopenharmony_ci 164e41f4b71Sopenharmony_ci用来删除文件或文件夹。需开启LOSCFG_FS_VFS。 165e41f4b71Sopenharmony_ci 166e41f4b71Sopenharmony_ci###### 命令格式 167e41f4b71Sopenharmony_ci 168e41f4b71Sopenharmony_ci###### rm [FILE] or rm [-r/-R] [FILE] 169e41f4b71Sopenharmony_ci 170e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 171e41f4b71Sopenharmony_ci| ----- | ------------------------------- | -------------------------------- | 172e41f4b71Sopenharmony_ci| FILE | 文件名，可以是文件或者文件夹 。 | FILE可以传入绝对路径和相对路径。 | 173e41f4b71Sopenharmony_ci| -r/-R | FILE是文件夹时需要有-r /-R。 | N/A | 174e41f4b71Sopenharmony_ci 175e41f4b71Sopenharmony_ci### rmdir 176e41f4b71Sopenharmony_ci 177e41f4b71Sopenharmony_ci用来删除文件夹。需开启LOSCFG_FS_VFS。 178e41f4b71Sopenharmony_ci 179e41f4b71Sopenharmony_ci###### 命令格式 180e41f4b71Sopenharmony_ci 181e41f4b71Sopenharmony_ci###### rmdir [DIRECTORY] 182e41f4b71Sopenharmony_ci 183e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 184e41f4b71Sopenharmony_ci| --------- | ---------- | ------------------------------------- | 185e41f4b71Sopenharmony_ci| DIRECTORY | 文件路径。 | DIRECTORY可以传入绝对路径和相对路径。 | 186e41f4b71Sopenharmony_ci 187e41f4b71Sopenharmony_ci### task 188e41f4b71Sopenharmony_ci 189e41f4b71Sopenharmony_ci用来显示当前各任务状态。 190e41f4b71Sopenharmony_ci 191e41f4b71Sopenharmony_ci###### 命令格式 192e41f4b71Sopenharmony_ci 193e41f4b71Sopenharmony_ci###### task 194e41f4b71Sopenharmony_ci 195e41f4b71Sopenharmony_ci显示内容主要包括任务号，优先级，状态，栈信息，信号，事件，CPU占用率，任务名称等 196e41f4b71Sopenharmony_ci 197e41f4b71Sopenharmony_ci### touch 198e41f4b71Sopenharmony_ci 199e41f4b71Sopenharmony_ci用来创建文件。需开启LOSCFG_FS_VFS。 200e41f4b71Sopenharmony_ci 201e41f4b71Sopenharmony_ci###### 命令格式 202e41f4b71Sopenharmony_ci 203e41f4b71Sopenharmony_ci###### touch [FILE] 204e41f4b71Sopenharmony_ci 205e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 206e41f4b71Sopenharmony_ci| ---- | -------- | -------------------------------- | 207e41f4b71Sopenharmony_ci| FILE | 文件名。 | FILE可以传入绝对路径和相对路径。 | 208e41f4b71Sopenharmony_ci 209e41f4b71Sopenharmony_ci### stack 210e41f4b71Sopenharmony_ci 211e41f4b71Sopenharmony_ci用来查看指定任务的栈内容。需开启编译选项 LOSCFG_DEBUG_TOOLS，功能开启会影响性能。 212e41f4b71Sopenharmony_ci 213e41f4b71Sopenharmony_ci###### 命令格式 214e41f4b71Sopenharmony_ci 215e41f4b71Sopenharmony_ci###### stack [ID] 216e41f4b71Sopenharmony_ci 217e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 218e41f4b71Sopenharmony_ci| ---- | -------- | ------------------------ | 219e41f4b71Sopenharmony_ci| ID | 任务ID。 | 任务ID对应的任务需存在。 | 220e41f4b71Sopenharmony_ci 221e41f4b71Sopenharmony_ci### hwi 222e41f4b71Sopenharmony_ci 223e41f4b71Sopenharmony_ci用来查看中断的占用率。需开启编译选项 LOSCFG_DEBUG_TOOLS，功能开启会影响性能。 224e41f4b71Sopenharmony_ci 225e41f4b71Sopenharmony_ci###### 命令格式 226e41f4b71Sopenharmony_ci 227e41f4b71Sopenharmony_ci###### hwi 228e41f4b71Sopenharmony_ci 229e41f4b71Sopenharmony_ci### st 230e41f4b71Sopenharmony_ci 231e41f4b71Sopenharmony_ci用来查看调度信息。需开启编译选项 LOSCFG_DEBUG_TOOLS，功能开启会影响性能。 232e41f4b71Sopenharmony_ci 233e41f4b71Sopenharmony_ci###### 命令格式 234e41f4b71Sopenharmony_ci 235e41f4b71Sopenharmony_ci###### st -s | st -e 236e41f4b71Sopenharmony_ci 237e41f4b71Sopenharmony_ci| 参数 | 参数说明 | 取值范围 | 238e41f4b71Sopenharmony_ci| ---- | ---------------------- | -------- | 239e41f4b71Sopenharmony_ci| -s | 开始记录调度信息 | N/A | 240e41f4b71Sopenharmony_ci| -e | 停止记录并打印调度信息 | N/A | 241e41f4b71Sopenharmony_ci 242