From f66cae6c0e66a273c5c85c8d8f7707a54a59206e Mon Sep 17 00:00:00 2001 From: Kiita Date: Fri, 12 Nov 2021 16:01:21 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BF=AE=E6=94=B9shell=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=E6=8C=87=E5=AF=BC=E6=89=8B=E5=86=8C=E8=A7=84=E8=8C=83?= =?UTF-8?q?=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 【背景】部分示例说明格式不符合标准 【修改内容】 help命令输出优化，可以分类显示系统支持的所有命令 修改所有shell命令手册中的规范问题 Signed-off-by: yansira Change-Id: I7e0451042e9b99bd27275b04358687ba957ff841 --- ...7\347\224\250\346\203\205\345\206\265.png" | Bin 7206 -> 0 bytes .../kernel-small-debug-shell-cmd-cpup.md | 2 +- .../kernel-small-debug-shell-cmd-date.md | 15 +- .../kernel-small-debug-shell-cmd-dmesg.md | 17 +- .../kernel-small-debug-shell-cmd-free.md | 2 +- .../kernel-small-debug-shell-cmd-help.md | 41 +- .../kernel-small-debug-shell-cmd-kill.md | 11 +- .../kernel-small-debug-shell-cmd-log.md | 6 +- .../kernel-small-debug-shell-cmd-memcheck.md | 5 +- .../kernel-small-debug-shell-cmd-oom.md | 34 +- .../kernel-small-debug-shell-cmd-pmm.md | 4 +- .../kernel-small-debug-shell-cmd-sem.md | 4 +- .../kernel-small-debug-shell-cmd-stack.md | 4 +- .../kernel/kernel-small-debug-shell-cmd-su.md | 2 +- .../kernel-small-debug-shell-cmd-swtmr.md | 5 +- .../kernel-small-debug-shell-cmd-sysinfo.md | 15 +- .../kernel-small-debug-shell-cmd-task.md | 4 +- .../kernel-small-debug-shell-cmd-top.md | 4 +- .../kernel-small-debug-shell-cmd-uname.md | 14 +- .../kernel-small-debug-shell-cmd-vmm.md | 9 +- .../kernel-small-debug-shell-cmd-watch.md | 11 +- .../kernel-small-debug-shell-file-cat.md | 2 +- .../kernel-small-debug-shell-file-cd.md | 2 +- .../kernel-small-debug-shell-file-chgrp.md | 2 +- .../kernel-small-debug-shell-file-chmod.md | 4 +- .../kernel-small-debug-shell-file-cp.md | 4 +- .../kernel-small-debug-shell-file-du.md | 2 +- .../kernel-small-debug-shell-file-format.md | 2 +- .../kernel-small-debug-shell-file-ls.md | 5 +- .../kernel-small-debug-shell-file-lsfd.md | 2 +- .../kernel-small-debug-shell-file-mount.md | 2 +- .../kernel-small-debug-shell-file-mv.md | 5 +- .../kernel-small-debug-shell-file-partinfo.md | 6 +- .../kernel-small-debug-shell-file-pwd.md | 2 +- .../kernel-small-debug-shell-file-rm.md | 4 +- .../kernel-small-debug-shell-file-rmdir.md | 2 +- .../kernel-small-debug-shell-file-statfs.md | 4 +- .../kernel-small-debug-shell-file-touch.md | 5 +- .../kernel-small-debug-shell-file-umount.md | 7 +- .../kernel-small-debug-shell-net-arp.md | 89 ++--- .../kernel-small-debug-shell-net-dhclient.md | 26 +- .../kernel-small-debug-shell-net-ifconfig.md | 369 +++++++++--------- .../kernel-small-debug-shell-net-ipdebug.md | 4 +- .../kernel-small-debug-shell-net-netstat.md | 11 +- .../kernel-small-debug-shell-net-ping.md | 2 +- .../kernel-small-debug-shell-net-telnet.md | 2 +- 46 files changed, 420 insertions(+), 354 deletions(-) delete mode 100755 "zh-cn/device-dev/kernel/figure/\346\237\245\347\234\213\347\263\273\347\273\237\350\265\204\346\272\220\344\275\277\347\224\250\346\203\205\345\206\265.png" diff --git "a/zh-cn/device-dev/kernel/figure/\346\237\245\347\234\213\347\263\273\347\273\237\350\265\204\346\272\220\344\275\277\347\224\250\346\203\205\345\206\265.png" "b/zh-cn/device-dev/kernel/figure/\346\237\245\347\234\213\347\263\273\347\273\237\350\265\204\346\272\220\344\275\277\347\224\250\346\203\205\345\206\265.png" deleted file mode 100755 index b69b5289481953570adc99ff0d8e33f3b61ff3f7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7206 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 a6B+Bs!3L=9az6V12e7qrw5&4sPW&$#jUTlD diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-cpup.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-cpup.md index be52d26dcbe..73dc510cc0a 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-cpup.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-cpup.md @@ -57,7 +57,7 @@ cpup \[_mode_\] \[_taskID_\] ## 输出说明 -**示例 1** 指令输出结果 +**示例** 指令输出结果 ```shell OHOS # cpup 1 5 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-date.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-date.md index a7359f79e99..dbe35452076 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-date.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-date.md @@ -13,13 +13,14 @@ date命令用于查询系统日期和时间。 ## 命令格式 -date +- date -date --help +- date --help -date +\[_Format_\] +- date +\[_Format_\] + +- date -u -date -u ## 参数说明 @@ -67,13 +68,11 @@ date -u ## 使用实例 -举例： - -输入 date +%Y--%m--%d +举例：输入 date +%Y--%m--%d ## 输出说明 -**示例 1** 按指定格式打印系统日期 +**示例** 按指定格式打印系统日期 ```shell OHOS:/$ date +%Y--%m--%d diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-dmesg.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-dmesg.md index a64be9d9455..285837cbed1 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-dmesg.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-dmesg.md @@ -13,15 +13,16 @@ dmesg命令用于控制内核dmesg缓存区。 ## 命令格式 -dmesg +- dmesg -dmesg \[_-c/-C/-D/-E/-L/-U_\] +- dmesg \[_-c/-C/-D/-E/-L/-U_\] -dmesg -s \[_size_\] +- dmesg -s \[_size_\] -dmesg -l \[_level_\] +- dmesg -l \[_level_\] + +- dmesg \> \[_fileA_\] -dmesg \> \[_fileA_\] ## 参数说明 @@ -102,13 +103,11 @@ dmesg \> \[_fileA_\] ## 使用实例 -举例： - -输入dmesg \> dmesg.log。 +举例：输入dmesg \> dmesg.log。 ## 输出说明 -**示例 1** dmesg重定向到文件。 +**示例** dmesg重定向到文件。 ```shell OHOS # dmesg > dmesg.log diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-free.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-free.md index d37eb4f96c8..3ef00f87b00 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-free.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-free.md @@ -90,7 +90,7 @@ free \[_-b | -k | -m | -g | -t_\] ## 输出说明 -**示例 1** 以三种方式显示内存使用情况 +**示例** 以三种方式显示内存使用情况 ```shell OHOS:/$ free diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-help.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-help.md index 5a1b32501a8..a5e1a75b0fb 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-help.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-help.md @@ -29,36 +29,35 @@ help用于显示当前操作系统内所有操作指令。 ## 输出说明 -**示例1** 查看系统内所有操作指令 +**示例** 查看系统内所有操作指令 ```shell OHOS:/$ help +OHOS:/$ help *******************shell commands:************************* -arp cat cat_logmpp cd chgrp chmod chown cp -cpup date dhclient dmesg dns format free help -hi3881 hwi ifconfig ipdebug kill log ls lsfd -memcheck mkdir mount netstat oom panicreset partinfo partition -ping ping6 pmm pwd reset rm rmdir sem -shm stack statfs su swtmr sync systeminfo task -telnet touch umount uname v2p vmm watch writeproc -usage: help [command] - -Show usage information for toybox commands. -Run "toybox" with no arguments for a list of available commands. -``` - -**内容声明：** +arp cat cat_logmpp cd chgrp chmod +chown cp cpup date dhclient dmesg +dns format free help hi3881 hwi +ifconfig ipdebug kill log ls lsfd +memcheck mkdir mount netstat oom panicreset +partinfo partition ping ping6 pmm pwd +reset rm rmdir sem shm stack +statfs su swtmr sync systeminfo task +telnet touch umount uname v2p vmm +watch writeproc -展示toybox指令请使用toybox。 +After shell prompt "OHOS # ": +Use ` [args ...]` to run built-in shell commands listed above. +Use `exec [args ...]` or `./ [args ...]` to run external commands. -**示例2** toybox指令集 +*******************toybox commands:************************ -```shell -OHOS:/$ toybox chgrp chmod chown cp date du free help ifconfig kill ls mkdir mount mv ping ps reboot rm rmdir top touch umount uname -``` - +Use `toybox help [command]` to show usage information for a specific command. +Use `shell` to enter interactive legacy shell. +Use `alias` to display command aliases. +``` diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-kill.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-kill.md index 2326ebaa81f..dbcead042dd 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-kill.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-kill.md @@ -71,13 +71,14 @@ kill \[-l \[_signo_\] | _-s signo_ | _-signo_\] _pid..._ ## 使用指南 -必须指定发送的信号编号及进程号。 +- 必须指定发送的信号编号及进程号。 + +- 进程编号取值范围根据系统配置变化，例如系统最大支持pid为256，则取值范围缩小为\[1-256\]。 -进程编号取值范围根据系统配置变化，例如系统最大支持pid为256，则取值范围缩小为\[1-256\]。 ## 使用实例 -1. 查看当前进程列表，查看需要杀死的进程PID（42）。 +- 查看当前进程列表，查看需要杀死的进程PID（42）。 ``` OHOS:/$ ps @@ -102,7 +103,7 @@ OHOS:/$ ps 43 8 43 2 Running 0x1d7000 0x3a000 0x1e577 0.0 toybox ``` -2. 发送信号9（SIGKILL默认行为为立即终止进程）给42号进程**test\_demo**（用户态进程）：**kill -s 9 42**（kill -9 42效果相同），并查看当前进程列表，42号进程已终止。 +发送信号9（SIGKILL默认行为为立即终止进程）给42号进程**test\_demo**（用户态进程）：**kill -s 9 42**（kill -9 42效果相同），并查看当前进程列表，42号进程已终止。 ``` OHOS:/$ kill -s 9 42 @@ -129,6 +130,8 @@ OHOS:/$ ps 45 8 45 2 Running 0x1d7000 0x3a000 0x1e9f5 0.0 toybox ``` +- 发送不存在的信号值 kill -100 31 + ## 输出说明 发送成功或失败输出结果如下。 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-log.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-log.md index d143978cd0d..8edb4bcf120 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-log.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-log.md @@ -66,12 +66,12 @@ log level \[_levelNum_\] ## 使用实例 -举例： - -输入log level 3 +举例：输入log level 3 ## 输出说明 +**示例** 设置当前日志打印级别为3 + ```shell OHOS # log level 3 Set current log level WARN diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-memcheck.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-memcheck.md index 1b6d0f6369d..989f35f97a1 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-memcheck.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-memcheck.md @@ -26,7 +26,10 @@ memcheck ## 使用实例 -举例：输入memcheck +举例： + +- 输入memcheck +- 输入memcheck出现内存越界 ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-oom.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-oom.md index 1e947e576b9..dc61c380e00 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-oom.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-oom.md @@ -12,15 +12,16 @@ ## 命令格式 -oom +- oom -oom -i \[_interval_\] +- oom -i \[_interval_\] -oom -m \[_mem byte_\] +- oom -m \[_mem byte_\] -oom -r \[_mem byte_\] +- oom -r \[_mem byte_\] + +- oom -h | --help -oom -h | --help ## 参数说明 @@ -73,11 +74,25 @@ oom -h | --help >![](../public_sys-resources/icon-note.gif) **说明：** >当系统内存不足时，会打印出内存不足的提示信息。 +- oom -i 100 + ## 输出说明 +**示例 1** oom缺省打印配置信息 + +```shell +OHOS:/$ oom +[oom] oom loop task status: enabled + oom low memory threshold: 0x80000(byte) + oom reclaim memory threshold: 0x500000(byte) + oom check interval: 100(microsecond) +``` + +系统内存不足时打印提示信息 + ```shell T:20 Enter:IT MEM 00M 001 -[oom] 0S is in low memory state +[oom] OS is in low memory state total physical memory: 0x1bcf000(byte), used: 0x1b50000(byte) ,free: 0x7f000(byte), low memory threshold: 0x80000(byte) [oom] candidate victim process init pid: 1, actual phy mem byte:82602 [oom] candidate victim process shell pid: 3, actual phy mem byte:14950e @@ -120,6 +135,13 @@ traceback 4 -- lr = 0x92427d4 fp = 0x20e20d44 lr in /usr/bin/testsuits app --> 0 traceback 5 -- 1r = 0x20c4df50 fp = 0хb0b0b0b 1r in /1ib/libc.so - -> 0x62f50 ``` +**示例 2** 设置 oom 线程任务检查的时间间隔 + +```shell +OHOS:/$ oom -i 100 +[oom] set oom check interval (100)ms successful +``` + **表 2** 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-pmm.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-pmm.md index fca464be3de..16627c7f06e 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-pmm.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-pmm.md @@ -25,11 +25,11 @@ Debug版本才具备的命令。 ## 使用实例 -输入pmm +举例：输入pmm ## 输出说明 -**示例 1** 查看物理页使用情况 +**示例** 查看物理页使用情况 ```shell OHOS # pmm diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sem.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sem.md index 0419b1128bb..3b8d57161af 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sem.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sem.md @@ -56,11 +56,11 @@ sem \[_ID__ / fulldata_\] ## 使用实例 -举例1：输入 sem fulldata +举例：输入 sem fulldata ## 输出说明 -**示例 1** 查询所有在用的信号量信息 +**示例** 查询所有在用的信号量信息 ```shell OHOS # sem diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-stack.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-stack.md index 73e950e6b90..22c5d257813 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-stack.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-stack.md @@ -25,11 +25,11 @@ stack ## 使用实例 -输入：stack +举例：输入stack ## 输出说明 -**示例 1** 系统堆栈使用情况 +**示例** 系统堆栈使用情况 ```shell OHOS # stack diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-su.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-su.md index 184b1fe6bdf..3c84c74d273 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-su.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-su.md @@ -57,7 +57,7 @@ su \[_uid_\] \[_gid_\] ## 输出说明 -**示例 1** **切换到**为uid为1000，gid为1000的用户 +**示例** 从当前用户切换至uid为1000，gid为1000的用户 ```shell OHOS # ls diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-swtmr.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-swtmr.md index d8c1b45ec5c..48e4f83a588 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-swtmr.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-swtmr.md @@ -45,7 +45,10 @@ swtmr \[_ID_\] ## 使用实例 -举例：输入swtmr和swtmr 1 +举例： + +- swtmr +- swtmr 1 ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sysinfo.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sysinfo.md index 43069734367..6daeaee0acc 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sysinfo.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-sysinfo.md @@ -29,8 +29,18 @@ systeminfo ## 输出说明 -**图 1** 查看系统资源使用情况 -![](figure/查看系统资源使用情况.png "查看系统资源使用情况") +**示例** 查看系统资源使用情况 + +```shell +OHOS:/$ systeminfo + + Module Used Total Enabled +-------------------------------------------- + Task 96 256 YES + Sem 435 1024 YES + Queue 13 1024 YES + SwTmr 20 1024 YES +``` **表 1** 输出说明 @@ -88,4 +98,3 @@ systeminfo - diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-task.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-task.md index ea62b034cbc..a6a6fee99c9 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-task.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-task.md @@ -40,7 +40,7 @@ task/task -a ## 使用指南 -- 参数缺省时默认打印部分任务信息。 +参数缺省时默认打印部分任务信息。 ## 使用实例 @@ -48,7 +48,7 @@ task/task -a ## 输出说明 -**示例 1** 查询任务部分信息 +**示例** 查询任务部分信息 ```shell OHOS # task diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-top.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-top.md index 514f1594cfa..b6126ec614d 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-top.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-top.md @@ -47,7 +47,7 @@ top \[_-a_\] ## 使用指南 -- 参数缺省时默认打印部分任务信息。 +参数缺省时默认打印部分任务信息。 ## 使用实例 @@ -55,7 +55,7 @@ top \[_-a_\] ## 输出说明 -**示例 1** top 命令显示详情 +**示例** top 命令显示详情 ```shell OHOS:/$ top diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-uname.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-uname.md index da30027e1a1..913f54dd166 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-uname.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-uname.md @@ -12,7 +12,7 @@ uname命令用于显示当前操作系统的名称，版本创建时间，系统 ## 命令格式 -uname \[_-a | -s | -r | -m | -n | -v --help_\] +uname \[_-a | -s | -r | -m | -n | -v | --help_\] **表 1** 参数说明 @@ -68,15 +68,21 @@ uname \[_-a | -s | -r | -m | -n | -v --help_\] ## 使用指南 -uname用于显示当前操作系统名称。语法uname -a | -s | -r | -m | -n | -v 描述uname 命令将正在使用的操作系统名写到标准输出中。 +- uname用于显示当前操作系统名称。 + +- 除参数--help和-a以外，其他参数可以相互搭配使用；uname -a 等价于 uname -srmnv。 + ## 使用实例 -举例：输入uname -a 、uname -ms +举例： + +- uname -a +- uname -ms ## 输出说明 -**示例 1** 查看系统信息 +**示例 1** 查看系统详细信息 ```shell OHOS:/$ uname -a diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-vmm.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-vmm.md index 3cdef6ee4ea..3a458138182 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-vmm.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-vmm.md @@ -13,9 +13,10 @@ ## 命令格式 -vmm \[_-a / -h / --help_\] +- vmm \[_-a / -h / --help_\] + +- vmm \[_pid_\] -vmm \[_pid_\] ## 参数说明 @@ -60,11 +61,11 @@ vmm \[_pid_\] ## 使用实例 -输入vmm 3 +举例：输入vmm 3 ## 输出说明 -**示例 1** PID为3的进程虚拟内存使用信息 +**示例** PID为3的进程虚拟内存使用信息 ```shell OHOS # vmm 3 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-watch.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-watch.md index 4ba183c88dd..7a7bb9c4560 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-watch.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-cmd-watch.md @@ -13,9 +13,10 @@ watch命令用于周期性的监视一个命令的运行结果。 ## 命令格式 -watch +- watch + +- watch \[_-c/-n/-t/--count/--interval/-no-title/--over_\] \[_command_\] -watch \[_-c/-n/-t/--count/--interval/-no-title/--over_\] \[_command_\] ## 参数说明 @@ -86,13 +87,11 @@ watch运行过程中可以执行**watch --over**结束本次watch命令。 ## 使用实例 -输入举例： - -watch -n 2 -c 6 task +举例：watch -n 2 -c 6 task ## 输出说明 -**示例 1** watch task 结果 +**示例** watch task 结果 ```shell OHOS # watch -n 2 -c 6 task diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cat.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cat.md index a5142c76fa9..9e04dbf213c 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cat.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cat.md @@ -48,7 +48,7 @@ cat用于显示文本文件的内容。 ## 输出说明 -**示例 1** 查看 hello-harmony.txt 文件的信息 +**示例** 查看 hello-harmony.txt 文件的信息 ```shell OHOS # cat hello-harmony.txt diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cd.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cd.md index 3396a5f6bee..ccaa2af58e6 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cd.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cd.md @@ -53,7 +53,7 @@ cd \[_path_\] ## 输出说明 -**示例 1** 显示结果如下 +**示例** 显示结果如下 ```shell OHOS:/nfs$ cd ../ diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chgrp.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chgrp.md index 22aafd1c9d2..0d12a471cf0 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chgrp.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chgrp.md @@ -57,7 +57,7 @@ chgrp \[_group_\] \[_pathname_\] ## 输出说明 -**示例 1** 修改 dev/目录下testfile 文件的群组为100 +**示例** 修改 /dev目录下testfile 文件的群组为100 ```shell OHOS:/dev$ ll testfile diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chmod.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chmod.md index d3cc5ebd5a3..8dec87d6b6e 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chmod.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-chmod.md @@ -52,11 +52,11 @@ chmod \[_mode_\] \[_filename_\] ## 使用实例 -举例：chmod 644 hello-harmony.txt ; chmod 777 hello-harmony.txt +举例：修改hello-harmony.txt 文件权限为644和777。 ## 输出说明 -**示例 1** 修改/dev目录下 hello-harmony.txt 文件的权限 +**示例** 修改/dev目录下 hello-harmony.txt 文件的权限 ```shell OHOS:/dev$ chmod 644 hello-harmony.txt diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cp.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cp.md index dd3cb63667b..13718a5a578 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cp.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-cp.md @@ -13,8 +13,6 @@ ## 命令格式 -cp --help - cp \[_SOURCEFILE_\] \[_DESTFILE_\] ## 参数说明 @@ -73,7 +71,7 @@ cp \[_SOURCEFILE_\] \[_DESTFILE_\] ## 输出说明 -**示例 1** 显示结果如下 +**示例** 同时拷贝两个文件至指定目录 ```shell OHOS:/$ ls diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-du.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-du.md index 57e9708b449..1ba75a22e23 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-du.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-du.md @@ -84,7 +84,7 @@ du \[_-kKmh_\] \[_file..._\] ## 输出说明 -**示例 1** 显示结果如下 +**示例** 显示结果如下 ```shell OHOS:/$ du -h testfile diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-format.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-format.md index 586fa16f707..e1631934f03 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-format.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-format.md @@ -63,7 +63,7 @@ format <_dev\_inodename_\> <_sectors_\> <_option_\> \[_label_\] ## 输出说明 -结果如下: +**示例** 格式化mmc卡 ```shell OHOS # format /dev/mmcblk1 128 2 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-ls.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-ls.md index a1fb4a932fd..5dee2d60e82 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-ls.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-ls.md @@ -286,7 +286,10 @@ ls \[_-ACHLSZacdfhiklmnopqrstux1_\] \[_--color_\[_=auto_\]\] \[_directory..._\] ## 使用实例 -举例：输入ls、ll +举例： + +- ls +- ll ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-lsfd.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-lsfd.md index 685e878c4ae..bf08c222220 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-lsfd.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-lsfd.md @@ -24,7 +24,7 @@ lsfd命令显示当前已经打开文件的fd号以及文件的名字。 ## 输出说明 -**示例 1** lsfd输出说明 +**示例** lsfd输出说明 ```shell OHOS # lsfd diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mount.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mount.md index 43551e38c86..1ff71d655ef 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mount.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mount.md @@ -84,7 +84,7 @@ mount后加需要挂载的设备信息、指定目录以及设备文件格式， ## 输出说明 -**示例 1** 将服务器端nfs目录192.168.1.3:/nfs挂载到当前系统下新建的/nfs目录： +**示例** 将服务器端nfs目录192.168.1.3:/nfs挂载到当前系统下新建的/nfs目录： ```shell OHOS:/$ mkdir nfs diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mv.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mv.md index 2c0dfaad23e..1c57edf36c0 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mv.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-mv.md @@ -91,9 +91,10 @@ mv \[_-fivn_\] _SOURCE... DEST_ 举例： -mv -i test.txt testpath/ +- mv -i test.txt testpath/ + +- mv test?.txt testpath/ （移动 test3.txt testA.txt test_.txt） -mv test?.txt testpath/ （移动 test3.txt testA.txt test_.txt） ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-partinfo.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-partinfo.md index 7620a18cf87..8c768cff95f 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-partinfo.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-partinfo.md @@ -40,14 +40,16 @@ partinfo <_dev\_inodename_\> ## 使用指南 -无 +无。 ## 使用实例 -partinfo /dev/mmcblk0p0 +举例：partinfo /dev/mmcblk0p0 ## 输出说明 +**示例** 查看系统分区信息 + ```shell OHOS # partinfo /dev/mmcblk0p0 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-pwd.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-pwd.md index dbb092db964..108f538119c 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-pwd.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-pwd.md @@ -29,7 +29,7 @@ pwd 命令将当前目录的全路径名称（从根目录）写入标准输出 ## 输出说明 -**示例 1** 查看当前路径 +**示例** 查看当前路径 ```shell OHOS:/sdcard/nfs$ pwd diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rm.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rm.md index 121a2b16f46..d9c59e6ffbe 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rm.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rm.md @@ -69,8 +69,8 @@ rm \[_-fv_\] _FILE or rm_ \[_-rv_\] \[_PATH_ | _filename_\]... 举例： -1. 输入rm testfile -2. 输入rm -r testpath/ +- 输入rm testfile +- 输入rm -r testpath/ ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rmdir.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rmdir.md index 5d568e398b5..c73affdd12d 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rmdir.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-rmdir.md @@ -71,7 +71,7 @@ rmdir \[_-p_\] \[_dirname..._\] ## 输出说明 -**示例 1** 删除一个名为 dir 的目录 +**示例** 删除一个名为 dir 的目录 ```shell OHOS:/test$ mkdir dir diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-statfs.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-statfs.md index 58d3d624c65..628c69d6743 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-statfs.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-statfs.md @@ -45,9 +45,9 @@ statfs \[_directory_\] 以nfs文件系统为例： -statfs /nfs +输入statfs /nfs -**示例 1** statfs输出说明 +**示例** 但因nfs文件系统信息 ```shell OHOS # statfs ./nfs diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-touch.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-touch.md index 7a10c652a07..a22e0cd4538 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-touch.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-touch.md @@ -57,7 +57,10 @@ touch \[_filename_\] ## 使用实例 -举例：输入touch file.c 输出说明 +举例： + +- touch file.c +- touch testfile1 testfile2 testfile3 ## 输出说明 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-umount.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-umount.md index 4356532dc2c..46beb6e133a 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-umount.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-file-umount.md @@ -66,11 +66,14 @@ umount后加上需要卸载的指定文件系统的目录，即将指定文件 ## 使用实例 -举例：umount ./nfs 、umount -a -t nfs ./nfs +举例： + +- umount ./nfs +- umount -a -t nfs ./nfs ## 输出说明 -将已在./nfs挂载的文件系统卸载 +将已在./nfs挂载的文件系统卸载掉。 **示例 1** umount输出示例 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-arp.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-arp.md index b1a4b7ef3ea..34c657e197e 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-arp.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-arp.md @@ -12,11 +12,12 @@ ## 命令格式 -arp +- arp -arp \[_-i IF_\] -s _IPADDR HWADDR_ +- arp \[_-i IF_\] -s _IPADDR HWADDR_ + +- arp \[_-i IF_\] -d _IPADDR_ -arp \[_-i IF_\] -d _IPADDR_ ## 参数说明 @@ -72,45 +73,45 @@ arp \[_-i IF_\] -d _IPADDR_ 举例： -1. 输入arp - - **示例 1** 打印整个 ARP 缓存表 - - ```shell - OHOS # arp - Address HWaddress Iface Type - 192.168.1.10 E6:2B:99:2C:4B:20 eth0 static - ``` - - **表 2** 参数说明 - - - - - - - - - - - - - - - - - - - -

参数

-

说明

-

Address

-

表示网络设备的IPv4地址。

-

HWaddress

-

表示网络设备的MAC地址。

-

Iface

-

表示该ARP表项使用的接口名。

-

Type

-

表示该ARP表项是动态的还是静态的，动态是指ARP表项由协议栈自动创建，静态是指ARP表项是由用户增加的。

-
+输入arp + +**示例** 打印整个 ARP 缓存表 + +```shell +OHOS # arp +Address HWaddress Iface Type +192.168.1.10 E6:2B:99:2C:4B:20 eth0 static +``` + +**表 2** 参数说明 + + + + + + + + + + + + + + + + + + + +

参数

+

说明

+

Address

+

表示网络设备的IPv4地址。

+

HWaddress

+

表示网络设备的MAC地址。

+

Iface

+

表示该ARP表项使用的接口名。

+

Type

+

表示该ARP表项是动态的还是静态的，动态是指ARP表项由协议栈自动创建，静态是指ARP表项是由用户增加的。

+
diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-dhclient.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-dhclient.md index 0afc2536a82..01be24bbbb9 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-dhclient.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-dhclient.md @@ -13,9 +13,9 @@ ## 命令格式 -dhclient <_netif name_\> +- dhclient <_netif name_\> -dhclient -x <_netif name_\> +- dhclient -x <_netif name_\> ## 参数说明 @@ -56,12 +56,20 @@ dhclient -x <_netif name_\> ## 使用指南 -dhclient eth0 - -dhclient -x eth0 +无。 ## 使用实例 +举例： + +- dhclient eth0 +- dhclient -x eth0 + + +## 输出说明 + +**示例 1** 启动网卡eth0的dhcp请求 + ```shell OHOS:/$ dhclient eth0 OHOS:/$ ifconfig @@ -71,6 +79,11 @@ lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 eth0 ip:192.168.1.10 netmask:255.255.255.0 gateway:192.168.1.1 HWaddr 42:da:81:bc:58:94 MTU:1500 Running Default Link UP OHOS:/$ +``` + +**示例 2** 关闭网卡eth0的dhcp请求 + +```shell OHOS:/$ dhclient -x eth0 NetifStatusCallback(eth0): nsc event: 0xf0 OHOS:/$ ifconfig @@ -81,6 +94,3 @@ eth0 ip:0.0.0.0 netmask:0.0.0.0 gateway:0.0.0.0 HWaddr 42:da:81:bc:58:94 MTU:1500 Running Default Link UP ``` -## 输出说明 - -无。 \ No newline at end of file diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ifconfig.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ifconfig.md index e6e68c7c605..75aa986e55d 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ifconfig.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ifconfig.md @@ -13,19 +13,21 @@ ifconfig命令用来查询和设置网卡的IP地址、网络掩码、网关、 ## 命令格式 -ifconfig +ifconfig [option] -\[_-a_\] +option: -<_interface_\> <_address_\> \[_netmask _\] \[_gateway _\] +- \[_-a_\] -\[_hw ether _\] \[_mtu _\] +- <_interface_\> <_address_\> \[_netmask _\] \[_gateway _\] +- \[_hw ether _\] \[_mtu _\] -\[_inet6 add _\] +- \[_inet6 add _\] -\[_inet6 del _\] +- \[_inet6 del _\] + +- \[_up|down_\] -\[_up|down_\] ## 参数说明 @@ -136,182 +138,183 @@ ifconfig ## 使用实例 -1. ifconfig eth0 192.168.100.31 netmask 255.255.255.0 gateway 192.168.100.1 hw ether 00:49:cb:6c:a1:31 -2. ifconfig -a -3. ifconfig eth0 inet6 add 2001:a:b:c:d:e:f:d -4. ifconfig eth0 inet6 del 2001:a:b:c:d:e:f:d +- ifconfig eth0 192.168.100.31 netmask 255.255.255.0 gateway 192.168.100.1 hw ether 00:49:cb:6c:a1:31 +- ifconfig -a +- ifconfig eth0 inet6 add 2001:a:b:c:d:e:f:d +- ifconfig eth0 inet6 del 2001:a:b:c:d:e:f:d ## 输出说明 -1. 设置网络参数 - - ```shell - OHOS:/$ ifconfig eth0 192.168.100.31 netmask 255.255.255.0 gateway 192.168.100.1 hw ether 00:49:cb:6c:a1:31 - OHOS:/$ ifconfig - lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 - ip6: ::1/64 - HWaddr 00 MTU:0 Running Link UP - eth0 ip:192.168.100.31 netmask:255.255.255.0 gateway:192.168.100.1 - HWaddr 00:49:cb:6c:a1:31 MTU:1500 Running Default Link UP - ``` - - 输出的各参数说明如下表所示： - - **表 2** 参数说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

参数

-

说明

-

ip

-

板子IP地址。

-

netmask

-

网络掩码。

-

gateway

-

网关。

-

HWaddr

-

板子硬件mac地址。

-

MTU

-

网络最大传输单元。

-

Running/Stop

-

网卡是否正在运行。

-

Default

-

有这项说明此网卡连接到默认网关。

-

Link UP/Down

-

网卡连接状态。

-
- -2. 获取协议栈统计信息 - - ```shell - OHOS # ifconfig -a - RX packets:6922 errors:0 ip dropped:4312 link dropped:67 overrun:0 bytes:0 (0.0 B) - RX packets(ip6):3 errors:0 dropped:0 overrun:0 bytes:0 (0.0 B) - TX packets:1394 errors:0 link dropped:67 overrun:0 bytes:0(0.0 B) - TX packets(ip6):3 errors:0 overrun:0 bytes:0(0.0 B) - ``` - - 输出的各参数说明如下表所示： - - **表 3** ifconfig -a 参数说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

参数

-

说明

-

RX packets

-

IP层已接收的正常数据包的个数。

-

RX error

-

IP层已接收的错误数据包的个数，错误类型包括长度错误，校验错误，IP option错误，IP首部protocol错误等。

-

RX dropped

-

IP层已丢弃的数据包的个数，丢弃原因包括数据包错误，封包无法转发，本地网卡处于关闭状态等。

-

RX overrun

-

MAC层向上层协议栈投递封包失败的个数，失败原因主要是协议栈资源不足。

-

RX bytes

-

IP层已接收的正常数据包的总长度，不包括重组未完成的分片的长度。

-

TX packets

-

IP层已正常发送或转发的数据包的个数。

-

TX error

-

IP层发送失败的数据包的个数，失败原因包括封包无法路由，封包在协议栈内处理失败等。

-

TX dropped

-

MAC层由于发送失败而丢弃的数据包个数，失败原因包括网卡驱动处理封包失败等。

-

TX overrun

-

暂未使用。

-

TX bytes

-

IP层已正常发送或者转发的数据包的总长度。

-
- -3. 设置IPv6的地址信息 - - ```shell - OHOS:/$ ifconfig eth0 inet6 add 2001:a:b:c:d:e:f:d - NetifStatusCallback(eth0): nsc event: 0x8 - NetifStatusCallback(eth0): nsc status changed: 0 - NetifStatusCallback(eth0): nsc event: 0x200 - NetifStatusCallback(eth0): nsc event: 0x8 - NetifStatusCallback(eth0): nsc status changed: 1 - NetifStatusCallback(eth0): nsc event: 0x200 - NetifStatusCallback(eth0): nsc event: 0x200 - OHOS:/$ ifconfig - lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 - ip6: ::1/64 - HWaddr 00 MTU:0 Running Link UP - eth0 ip:192.168.1.10 netmask:255.255.255.0 gateway:192.168.1.1 - ip6: 2001:A:B:C:D:E:F:D/64 - HWaddr 66:2f:e5:bd:24:e6 MTU:1500 Running Default Link UP - ``` - -4. 删除IPv6的地址信息 - - ```shell - OHOS:/$ ifconfig eth0 inet6 del 2001:a:b:c:d:e:f:d - NetifStatusCallback(eth0): nsc event: 0x200 - OHOS:/$ ifconfig - lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 - ip6: ::1/64 - HWaddr 00 MTU:0 Running Link UP - eth0 ip:192.168.1.10 netmask:255.255.255.0 gateway:192.168.1.1 - HWaddr 66:2f:e5:bd:24:e6 MTU:1500 Running Default Link UP - ``` +**示例 1** 设置网络参数 + +```shell +OHOS:/$ ifconfig eth0 192.168.100.31 netmask 255.255.255.0 gateway 192.168.100.1 hw ether 00:49:cb:6c:a1:31 +OHOS:/$ ifconfig +lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 + ip6: ::1/64 + HWaddr 00 MTU:0 Running Link UP +eth0 ip:192.168.100.31 netmask:255.255.255.0 gateway:192.168.100.1 + HWaddr 00:49:cb:6c:a1:31 MTU:1500 Running Default Link UP +``` + +输出的各参数说明如下表所示： + +**表 2** 参数说明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

参数

+

说明

+

ip

+

板子IP地址。

+

netmask

+

网络掩码。

+

gateway

+

网关。

+

HWaddr

+

板子硬件mac地址。

+

MTU

+

网络最大传输单元。

+

Running/Stop

+

网卡是否正在运行。

+

Default

+

有这项说明此网卡连接到默认网关。

+

Link UP/Down

+

网卡连接状态。

+
+ +**示例 2** 获取协议栈统计信息 + +```shell +OHOS # ifconfig -a +RX packets:6922 errors:0 ip dropped:4312 link dropped:67 overrun:0 bytes:0 (0.0 B) +RX packets(ip6):3 errors:0 dropped:0 overrun:0 bytes:0 (0.0 B) +TX packets:1394 errors:0 link dropped:67 overrun:0 bytes:0(0.0 B) +TX packets(ip6):3 errors:0 overrun:0 bytes:0(0.0 B) +``` + +输出的各参数说明如下表所示： + +**表 3** ifconfig -a 参数说明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

参数

+

说明

+

RX packets

+

IP层已接收的正常数据包的个数。

+

RX error

+

IP层已接收的错误数据包的个数，错误类型包括长度错误，校验错误，IP option错误，IP首部protocol错误等。

+

RX dropped

+

IP层已丢弃的数据包的个数，丢弃原因包括数据包错误，封包无法转发，本地网卡处于关闭状态等。

+

RX overrun

+

MAC层向上层协议栈投递封包失败的个数，失败原因主要是协议栈资源不足。

+

RX bytes

+

IP层已接收的正常数据包的总长度，不包括重组未完成的分片的长度。

+

TX packets

+

IP层已正常发送或转发的数据包的个数。

+

TX error

+

IP层发送失败的数据包的个数，失败原因包括封包无法路由，封包在协议栈内处理失败等。

+

TX dropped

+

MAC层由于发送失败而丢弃的数据包个数，失败原因包括网卡驱动处理封包失败等。

+

TX overrun

+

暂未使用。

+

TX bytes

+

IP层已正常发送或者转发的数据包的总长度。

+
+ +**示例 3** 设置IPv6的地址信息 + +```shell +OHOS:/$ ifconfig eth0 inet6 add 2001:a:b:c:d:e:f:d +NetifStatusCallback(eth0): nsc event: 0x8 +NetifStatusCallback(eth0): nsc status changed: 0 +NetifStatusCallback(eth0): nsc event: 0x200 +NetifStatusCallback(eth0): nsc event: 0x8 +NetifStatusCallback(eth0): nsc status changed: 1 +NetifStatusCallback(eth0): nsc event: 0x200 +NetifStatusCallback(eth0): nsc event: 0x200 +OHOS:/$ ifconfig +lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 + ip6: ::1/64 + HWaddr 00 MTU:0 Running Link UP +eth0 ip:192.168.1.10 netmask:255.255.255.0 gateway:192.168.1.1 + ip6: 2001:A:B:C:D:E:F:D/64 + HWaddr 66:2f:e5:bd:24:e6 MTU:1500 Running Default Link UP +``` + +**示例 4** 删除IPv6的地址信息 + +```shell +OHOS:/$ ifconfig eth0 inet6 del 2001:a:b:c:d:e:f:d +NetifStatusCallback(eth0): nsc event: 0x200 +OHOS:/$ ifconfig +lo ip:127.0.0.1 netmask:255.0.0.0 gateway:127.0.0.1 + ip6: ::1/64 + HWaddr 00 MTU:0 Running Link UP +eth0 ip:192.168.1.10 netmask:255.255.255.0 gateway:192.168.1.1 + HWaddr 66:2f:e5:bd:24:e6 MTU:1500 Running Default Link UP +``` + diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ipdebug.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ipdebug.md index 548f65d15c5..e34e37d124e 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ipdebug.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ipdebug.md @@ -15,11 +15,11 @@ ipdebug ## 使用指南 -输入命令ipdebug。 +举例：输入命令ipdebug。 ## 输出说明 -ipdebug打印信息如下： +**示例** ipdebug打印信息如下： ```shell OHOS # ipdebug diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-netstat.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-netstat.md index 5edf074e3a8..10806a95104 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-netstat.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-netstat.md @@ -17,17 +17,19 @@ netstat ## 参数说明 -无 +无。 ## 使用指南 -直接输入命令。 +无。 ## 使用实例 举例：输入netstat -**示例 1** netstat 打印信息 +## 输出说明 + +**示例** netstat 打印信息 ```shell OHOS # netstat @@ -46,8 +48,6 @@ udp 0 0 127.0.0.1:62180 127.0.0.1:62179 udp 0 0 127.0.0.1:62178 127.0.0.1:62177 ``` -## 输出说明 - **表 1** 输出说明 @@ -94,4 +94,3 @@ udp 0 0 127.0.0.1:62178 127.0.0.1:62177 >![](../public_sys-resources/icon-note.gif) **说明：** >形如“========== total sockets 32 ====== unused sockets 22 BootTime 27 s ========== ”，表示一共32个套接字，未使用套接字22个，距系统启动已经过27秒。 - diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ping.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ping.md index 0e2eab6f174..80a1f466e03 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ping.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-ping.md @@ -100,7 +100,7 @@ ping _\[-4\] \[-c cnt\] \[-f\] \[-i interval\] \[-q\] \[-s size\] _ ## 输出说明 -**示例 1** ping tftp 服务器地址 +**示例** ping tftp 服务器地址 ```shell OHOS:/$ ping 192.168.1.3 diff --git a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-telnet.md b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-telnet.md index 86038471bc1..a249d9457f6 100644 --- a/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-telnet.md +++ b/zh-cn/device-dev/kernel/kernel-small-debug-shell-net-telnet.md @@ -60,7 +60,7 @@ telnet \[_on | off_\] ## 输出说明 -**示例 1** 输入 telnet on +**示例** 输入 telnet on ```shell OHOS # telnet on -- Gitee