• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# toybox
2<!--Kit: Basic Services Kit-->
3<!--Subsystem: Startup-->
4<!--Owner: @yan-mingzhen-->
5<!--Designer: @liveery-->
6<!--Tester: @liuhaonan2-->
7<!--Adviser: @foryourself-->
8
9toybox 是一个轻量级的Linux命令行工具集合,它将常用的Linux命令行工具合并到一个单独的可执行文件中。
10
11## 前置条件
12
13### 使用方法1
14
15- 正常连接设备
16- 使用hdc shell进入命令行执行模式
17
18### 使用方法2
19
20- 应用沙箱内运行
21
22
23## 命令行说明
24
25toybox的执行方式有两种:
26
27- toybox [command] [arguments...]
28
29- 直接执行 [command] [arguments...]
30
31其中 [command] 可被替换为toybox支持的任意命令(可通过输入不带参数的toybox命令查询)。
32[arguments...] 为[command]所需要的参数。
33
34<!--RP1-->
35<!--RP1End-->
36
37### 帮助命令
38格式:toybox [--long | --help | --version | [command] [arguments...]]
39| 选项 | 参数 | 说明 |
40| :- | :- | :- |
41| --help | NA | 显示命令帮助。 |
42| --long | NA | 显示支持的所有命令的路径。 |
43| --version | NA | 显示版本号。|
44| NA | NA | 显示所有[command]支持的命令。 |
45| [command] | [arguments] | 执行具体的命令。大部分命令也支持--help和--version参数。 |
46
47格式:help [-ah] [command]
48| 参数 | 说明 |
49| :- | :- |
50| command | 显示command的帮助。[command] 可被替换为toybox支持的任意命令。 |
51
52| 选项 | 说明 |
53| :- | :- |
54| -a | 显示所有命令的帮助。 |
55
56### 数学与计算机基础函数
57
58| 命令 | 说明 |
59| :- | :- |
60| ascii     | 显示ascii编码表。<br />usage: ascii |
61| factor     | 分解质因数。<br />usage: factor NUMBER... |
62| mcookie    | 生成128位强随机数。<br />usage: mcookie [-vV] |
63| mkpasswd | 对密码进行加密。<br />usage: mkpasswd [-P FD] [-m TYPE] [-S SALT] [PASSWORD] [SALT] |
64| uuidgen    | 创建并打印新的RFC4122随机UUID。<br />usage: uuidgen |
65
66### 终端操作
67
68| 命令 | 说明 |
69| :- | :- |
70| chvt   | 切换到虚拟终端N。<br />usage: chvt N |
71| chroot | 以指定的根目录运行命令。<br />usage: chroot NEWROOT [COMMAND [ARG...]] |
72| clear  | 清空终端。<br />usage: clear |
73| nohup  | 运行一个独立于终端的命令。<br />usage: nohup COMMAND [ARG...] |
74| tty    | 显示连接到标准输入设备的终端的名称。<br />usage: tty [-s] |
75| reset  | 复位终端。<br />usage: reset |
76| microcom | 简单串口终端。<br />usage: microcom [-s SPEED] [-X] DEVICE |
77
78### sh逻辑命令
79
80| 命令 | 说明 |
81| :- | :- |
82| false | 返回非零值。<br />usage: false |
83| sh    | shell命令解释器。 |
84| test  | 通过执行测试返回true或false。没有参数时返回false。<br />usage: test [-bcdefghLPrSsuwx PATH] [-nz STRING] [-t FD] [X ?? Y] |
85| true  | 返回零。<br />usage: true |
86| yes   | 反复输出行直到被杀死。如果没有参数,则输出“y”。<br />usage: yes [args...] |
87
88### 系统操作
89
90| 命令 | 说明 |
91| :- | :- |
92| acpi      | 查询电源、温度状态。<br />usage: acpi [-abctV] |
93| arch      | 打印系统名称。<br />usage: arch |
94| dmesg     | 显示或控制内核环形缓冲区。<br />usage: dmesg [-Cc] [-r \| -t \| -T] [-n LEVEL] [-s SIZE] [-w] |
95| dnsdomainname | 显示系统的名称(与 hostname -d 一致)。<br />usage: dnsdomainname |
96| getconf   | 获取系统配置值,部分值需要path参数。<br />usage: getconf -a [PATH] \| -l \| NAME [PATH] |
97| env       | 设置命令调用的环境,或列出环境变量。<br />usage: env [-i] [-u NAME] [NAME=VALUE...] [COMMAND [ARG...]] |
98| hostname  | 获取当前主机名。<br />usage: hostname [-bdsf] [-F FILENAME] [newname] |
99| insmod    | 加载内核模块。<br />usage: insmod MODULE [MODULE_OPTIONS] |
100| logger    | 记录系统日志。<br />usage: logger [-s] [-t TAG] [-p [FACILITY.]PRIORITY] [message...] |
101| lsmod     | 显示当前已经加载的模块,他们的大小和依赖。<br />usage: lsmod |
102| mix       | 显示OSS声道,或者设置音量。<br />usage: mix [-d DEV] [-c CHANNEL] [-l VOL] [-r RIGHT] |
103| modinfo   | 显示内核模块信息。<br />usage: modinfo [-0] [-b basedir] [-k kernel] [-F field] [module \| file...] |
104| nproc     | 打印处理器数量。<br />usage: nproc [--all] |
105| oneit     | 简单的初始化程序。<br />usage: oneit [-p] [-c /dev/tty0] command [...] |
106| partprobe | 通知内核分区表已经变化。<br />usage: partprobe DEVICE... |
107| pivot_root | 修改根目录。<br />usage: pivot_root OLD NEW |
108| printenv  | 打印环境变量。<br />usage: printenv [-0] [env\_var...] |
109| reboot/halt/poweroff | 重启/停止/关机。<br />usage: reboot/halt/poweroff [-fn] |
110| rfkill    | 开启/关闭无线设备。<br />usage: rfkill COMMAND [DEVICE] |
111| rmmod     | 卸载内核模块。<br />usage: rmmod [-wf] [MODULE] |
112| sendevent | 发送Linux输入事件。<br />usage: sendevent DEVICE TYPE CODE VALUE |
113| swapoff   | 停用交换空间。<br />usage: swapoff swapregion |
114| swapon    | 在指定的设备或文件上,使能内存交换。<br />usage: swapon [-d] [-p priority] filename |
115| switch_root | 切换根目录,并执行新的INIT程序。<br />usage: switch_root [-c /dev/console] NEW_ROOT NEW_INIT... |
116| uname     | 打印系统信息。<br />usage: uname [-asnrvm] |
117| vmstat    | 打印虚拟内存信息。<br />usage: vmstat [-n] [DELAY [COUNT]] |
118
119### 时间日期
120
121| 命令 | 说明 |
122| :- | :- |
123| cal     | 打印日历。<br />usage: cal [[month] year] |
124| date    | 设置/获取当前日期/时间。<br />usage: date [-u] [-r FILE] [-d DATE] [+DISPLAY\_FORMAT] [SET] |
125| hwclock | 获取/设置硬件时钟。<br />usage: hwclock [-rswtluf] |
126| sleep   | 等待设置的时间后再退出。可以是小数。可选的后缀可以是“m”(分钟)、“h”(小时)、“d”(天)或“s”(秒,默认值)。<br />usage: sleep DURATION |
127| time    | 运行命令行并报告真实时间、用户时间和系统时间(以秒为单位)。(真实时间=时钟时间,用户时间=命令代码使用cpu的时间,系统时间=操作系统使用cpu的时间。)<br />usage: time [-pv] COMMAND [ARGS...] |
128| uptime  | 显示当前时间,系统运行了多长时间,用户数量,以及过去1、5和15分钟的系统负载平均值。<br />usage: uptime [-ps] |
129| usleep  | 等待设置的时间后再退出,单位微秒。<br />usage: usleep MICROSECONDS |
130
131### 登录用户操作
132
133| 命令 | 说明 |
134| :- | :- |
135| groups  | 打印用户所在的组。<br />usage: groups [user] |
136| id      | 打印用户和组ID。<br />usage: id [-nGgru] [USER...] |
137| login   | 用户登录。<br />usage: login [-p] [-h host] [-f USERNAME] [USERNAME] |
138| logname/whoami | 打印当前用户名。<br />usage: logname/whoami |
139| passwd  | 更新用户的认证令牌。<br />usage: passwd [-a ALGO] [-dlu] [USER] |
140| who     | 打印有关已登录用户的信息。 <br />usage: who |
141| w       | 显示用户登录情况和登录时间。<br />usage: w |
142
143### 进程操作
144
145| 命令 | 说明 |
146| :- | :- |
147| chrt      | 获取/设置一个进程的调度策略和优先级。<br />usage: chrt [-Rmofrbi] {-p PID [PRIORITY] \| [PRIORITY COMMAND...]} |
148| iorenice  | 显示/修改一个进程的IO优先级。<br />usage: iorenice PID [CLASS] [PRIORITY] |
149| iotop     | 根据I/O对进程排序。<br />usage: iotop [-AaKObq] [-n NUMBER] [-d SECONDS] [-p PID,] [-u USER,] |
150| ionice    | 显示/修改一个进程的IO调度优先级。<br />usage: ionice [-t] [-c CLASS] [-n LEVEL] [COMMAND...\|-p PID] |
151| kill      | 向进程发送信号。<br />usage: kill [-l [SIGNAL] \| -s SIGNAL \| -SIGNAL] pid... |
152| killall   | 向具有给定名称的所有进程发送信号(默认:SIGTERM)。<br />usage: killall [-l] [-iqv] [-SIGNAL \| -s SIGNAL]  PROCESS\_NAME... |
153| killall5  | 对当前会话以外的所有进程发送信号。<br />usage: killall5 [-l [SIGNAL]] [-SIGNAL \| -s SIGNAL] [-o PID]... |
154| pidof   | 打印具有给定名称的所有进程的PID。<br />usage: pidof [-s] [-o omitpid[,omitpid...]] [NAME...] |
155| pkill   | 按照进程名来杀死进程。<br />usage: pkill [-fnovx] [-SIGNAL \| -l SIGNAL] [PATTERN] [-G GID,] [-g PGRP,] [-P PPID,] [-s SID,] [-t TERM,] [-U UID,] [-u EUID,] |
156| pmap    | 查看进程的内存映射情况。<br />usage: pmap [-xq] [pids...] |
157| ps      | 显示进程信息。<br />usage: ps [-AadefLlnwZ] [-gG GROUP,] [-k FIELD,] [-o FIELD,] [-p PID,] [-t TTY,] [-uU USER,] |
158| pwdx    | 打印进程的工作目录。<br />usage: pwdx PID... |
159| renice  | 调整进程/组/用户级别的进程优先级。<br />usage: renice [-gpu] -n increment ID ... |
160| setsid  | 在新的会话中运行命令。<br />usage: setsid [-t] command [args...] |
161| taskset | 启动一个仅在指定处理器上运行的任务,或者修改已经存在的进程的处理器偏好。<br />usage: taskset [-ap] [mask] [PID \| cmd [args...]] |
162| timeout | 创建子进程执行命令,如果子进程超时未退出,则向子进程发送一个信号。DURATION可以是小数。可选的后缀可以是“m”(分钟)、“h”(小时)、“d”(天)或“s”(秒,默认值)。<br />usage: timeout [-k DURATION] [-s SIGNAL] DURATION COMMAND... |
163| top     | 实时显示进程信息。<br />usage: top [-Hhbq] [-k FIELD,] [-o FIELD,] [-s SORT] [-n NUMBER] [-m LINES] [-d SECONDS] [-p PID,] [-u USER,] |
164| nice    | 以指定的优先级运行命令。<br />usage: nice [-n PRIORITY] COMMAND [ARG...] |
165| nsenter | 在特定的命名空间中运行指令。<br />usage: nsenter [-t pid] [-F] [-i] [-m] [-n] [-p] [-u] [-U] COMMAND... |
166| ulimit/prlimit | 显示或者设置进程的资源限制。<br />usage: ulimit/prlimit [-P PID] [-SHRacdefilmnpqrstuv] [LIMIT] |
167| unshare | 给一个进程创建新的命名空间,部分属性不与父进程共享。<br />usage: unshare [-imnpuUr] COMMAND... |
168| watch   | 每隔-n秒运行一次参数中的命令,显示执行结果。按q退出。<br />usage: watch [-teb] [-n SEC] PROG ARGS |
169| xargs   | 运行命令行一次或多次,附加标准输入设备中的参数。<br />usage: xargs [-0prt] [-s NUM] [-n NUM] [-E STR] COMMAND... |
170
171### 设备节点操作
172
173| 命令 | 说明 |
174| :- | :- |
175| blkid       | 打印文件系统的类型,标签和UUID等信息。<br />usage: blkid [-s TAG] [-UL] DEV... |
176| blockdev    | 对每个命令中的块设备调用ioctl。<br />usage: blockdev --OPTION... BLOCKDEV... |
177| devmem      | 通过 /dev/mem 读写物理地址。<br />usage: devmem ADDR [WIDTH [DATA]] |
178| df          | 显示命令行中列出的每个文件系统的总共、已使用和空闲的磁盘空间。无参数时显示已装载的所有文件系统。<br />usage: df [-HPkhi] [-t type] [FILESYSTEM ...] |
179| du          | 显示磁盘使用情况,文件和目录占用的空间。<br />usage: du [-d N] [-askxHLlmc] [file...] |
180| eject       | 弹出设备,默认为 /dev/cdrom 。<br />usage: eject [-stT] [DEVICE] |
181| free        | 显示物理内存和交换空间的总量、可用量和已用量。<br />usage: free [-bkmgt] |
182| freeramdisk | 释放特定ramdisk的所有内存。<br />usage: freeramdisk [RAM device] |
183| fsfreeze    | 冻结或解冻一个文件系统。<br />usage: fsfreeze {-f \| -u} MOUNTPOINT |
184| fstype      | 打印文件系统的类型。<br />usage: fstype DEV... |
185| fsync       | 将文件状态与存储设备同步。<br />usage: fsync [-d] [FILE...] |
186| i2cdetect   | 检测 i2c 设备。<br />usage:<br />&emsp;i2cdetect [-ary] BUS [FIRST LAST] <br />&emsp;i2cdetect -F BUS<br />&emsp;i2cdetect -l|
187| i2cdump     | 打印所有 i2c 寄存器。<br />usage: i2cdump [-fy] BUS CHIP |
188| i2cget      | 读取 i2c 寄存器。<br />usage: i2cget [-fy] BUS CHIP ADDR |
189| i2cset      | 写 i2c 寄存器。<br />usage: i2cset [-fy] BUS CHIP ADDR VALUE... MODE |
190| losetup     | 设置循环设备。<br />usage: losetup [-cdrs] [-o OFFSET] [-S SIZE] {-d DEVICE... \| -j FILE \| -af \| {DEVICE FILE}} |
191| lspci       | 显示 PCI 设备信息。<br />usage: lspci [-ekmn] [-i FILE ] |
192| lsusb       | 显示 USB 设备信息。<br />usage: lsusb |
193| makedevs    | 创建一系列特殊的文件,包括块设备文件,字符设备文件等。<br />usage: makedevs [-d device_table] rootdir |
194| mount       | 在目录上挂载新的文件系统。如果没有参数,则显示现有的挂载。<br />usage: mount [-afFrsvw] [-t TYPE] [-o OPTION,] [[DEVICE] DIR] |
195| mountpoint  | 检查目录或者设备是否是挂载点。<br />usage:<br />&emsp;mountpoint [-qd] DIR <br />&emsp;mountpoint [-qx] DEVICE |
196| sync        | 将缓存的数据写到磁盘。<br />usage: sync |
197| sysctl      | 读写 /proc/sys 下的系统控制数据。<br />usage: sysctl [-aAeNnqw] [-p [FILE] \| KEY[=VALUE]...] |
198| tunctl      | 创建或删除tun/tap虚拟以太设备。<br />usage: tunctl [-dtT] [-u USER] NAME |
199| vconfig     | 创建或删除虚拟以太设备。<br />usage: vconfig COMMAND [OPTIONS] |
200| umount      | 取消挂载文件系统。<br />usage: umount [-a [-t TYPE[,TYPE...]]] [-vrfD] [DIR...] |
201
202### 网络操作
203
204| 命令 | 说明 |
205| :- | :- |
206| ftpget/ftpput | 与FTP服务器沟通,支持读、写、列举文件等操作。ftpget自带-g选项。ftpput自带-s选项。<br />usage: ftpget/ftpput [-cvgslLmMdD] [-p PORT] [-P PASSWORD] [-u USER] HOST [LOCAL] REMOTE |
207| ifconfig      | 显示或配置网络接口。<br />usage: ifconfig [-aS] [INTERFACE [ACTION...]] |
208| nbd-client    | 创建nbd客户端。<br />usage: nbd-client [-ns] HOST PORT DEVICE |
209| netstat   | 显示网络信息。<br />usage: netstat [-pWrxwutneal] |
210| ping/ping6    | 检测网络连通性。ping6自带-6选项。<br />usage: ping/ping6 [OPTIONS] HOST |
211| sntp    | SNTP客户端。<br />usage: sntp [-saSdDqm] [-r SHIFT] [-m ADDRESS] [-p PORT] [SERVER] |
212| telnet  | 连接telnet服务器。<br />usage: telnet HOST [PORT] |
213| traceroute/traceroute6 | 跟踪报文到HOST的路径。traceroute6自带-6选项。<br />usage: traceroute [-46FUIldnvr] [-f 1ST_TTL] [-m MAXTTL] [-p PORT] [-q PROBES] [-s SRC_IP] [-t TOS] [-w WAIT_SEC] [-g GATEWAY] [-i IFACE] [-z PAUSE_MSEC] HOST [BYTES]<br />usage: traceroute6 [-dnrv] [-m MAXTTL] [-p PORT] [-q PROBES][-s SRC_IP] [-t TOS] [-w WAIT_SEC] [-i IFACE] HOST [BYTES] |
214| wget    | 从网络上下载资源。<br />usage: wget [OPTIONS]... [URL]<br />[OPTIONS] = --max-redirect x -d -O filename -p data|
215
216### 文件操作
217
218| 命令 | 说明 |
219| :- | :- |
220| awk       | awk是一个处理文本的工具,可对文档内容进行筛选、分析。<br />usage: awk [-F sepstring] [-v assignment]... program [argument...]<br />&emsp;or:&emsp;awk [-F sepstring] -f progfile [-f progfile]... [-v assignment]... [argument...] |
221| base64    | 通过base64算法进行加密/解密。<br />usage: base64 [-di] [-w COLUMNS] [FILE...] |
222| basename  | 返回删除后缀的路径名的非目录部分。<br />usage: basename [-a] [-s SUFFIX] NAME... \| NAME [SUFFIX] |
223| bunzip2   | 解压bz格式的文件。<br />usage: bunzip2 [-cftkv] [FILE...] |
224| bzcat     | 解压列举的文件到标准输出。<br />usage: bzcat [FILE...] |
225| cat       | 复制(连接)文件到标准输出设备。如果未列出任何文件,则从标准输入设备复制。“-”代表标准输入设备。<br />usage: cat [-etuv] [FILE...] |
226| chattr    | 修改Linux ext2文件系统的文件属性。<br />usage: chattr [-R] [-+=AacDdijsStTu] [-v version] [File...] |
227| chcon     | 修改文件的SELinux安全上下文。<br />usage: chcon [-hRv] CONTEXT FILE... |
228| chgrp/chown | 修改文件的组。<br />usage: chgrp/chown [-RHLP] [-fvh] group file... |
229| chmod     | 更改列出的文件的模式(使用-R递归)。<br />usage: chmod [-R] MODE FILE... |
230| cksum     | 对于每个文件,输出crc32的校验和、长度和文件名。如果未列出任何文件,则从标准输入设备复制。“-”代表标准输入设备。<br />usage: cksum [-IPLN] [file...] |
231| cmp       | 比较文件的内容(如果只给出一个,则与标准输入设备进行比较),可选在开始时跳过字节。<br />usage: cmp [-l] [-s] FILE1 [FILE2 [SKIP1 [SKIP2]]] |
232| comm      | 读取FILE1和FILE2(这两个文件应该是有序的),并生成三个文本列作为输出:仅在FILE1中的行、仅在FILE2中的行、在两个文件中都有的行。“-”代表标准输入设备。<br />usage: comm [-123] FILE1 FILE2  |
233| count     | 将标准输入设备复制到标准输出设备,将简单的进度指示器显示到标准错误输出stderr。<br />usage: count |
234| cp        | 将文件从SOURCE复制到DEST。如果有多个源,DEST必须是一个目录。<br />usage: cp [-adfHiLlnPpRrsTv] [--preserve=motcxa] [-t TARGET] SOURCE... [DEST] |
235| cpio      | 从“newc”格式的cpio档案中中读写文件。<br />usage: cpio -{o\|t\|i\|p DEST} [-v] [--verbose] [-F FILE] [--no-preserve-owner]<br />&emsp;[ignored: -mdu -H newc] |
236| crc32     | 输出每个文件的crc32校验和。<br />usage: crc32 [file...] |
237| cut       | 将每个FILE中的行的选定部分打印到标准输出。每个选择列表以逗号分隔,可以是数字(从1开始计数)或破折号分隔的范围(其中X-表示X到行尾,-X表示从开始到X)。<br />usage: cut [-Ds] [-bcfF LIST] [-dO DELIM] [FILE...] |
238| dd        |  用于转换和复制文件的命令,可以用于创建磁盘镜像、备份数据、转换字符编码等任务。<br />usage:<br />&emsp; dd [if=FILE] [of=FILE] [ibs=N] [obs=N] [iflag=FLAGS] [oflag=FLAGS]<br />&emsp; [bs=N] [count=N] [seek=N] [skip=N]<br />&emsp; [conv=notrunc\|noerror\|sync\|fsync] [status=noxfer\|none] |
239| diff      | 比较文件/文件夹,输出差异。<br />usage: diff [-abBdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2 |
240| dirname   | 显示路径的目录部分。<br />usage: dirname PATH... |
241| dos2unix  | 将换行符格式从dos“\\r\\n”转换为unix“\\n”。如果没有列出文件,从标准输入设备获取输入。“-”代表标准输入设备。<br />usage: dos2unix [FILE...] |
242| echo      | 将每个参数写入标准输出设备,每个参数之间有一个空格,后跟一个换行符。<br />usage: echo [-neE] [args...] |
243| grep/egrep/fgrep | 显示匹配正则表达式的行。如果没有-e,则第一个参数为要匹配的正则表达式。没有文件(或“-”文件名)读取标准输入设备。如果匹配,则返回0;如果找不到匹配,则返回1;如果命令错误,则返回2。<br />egrep自带-E选项,fgrep自带-F选项。E和F选项不能同时选。<br />usage: grep/egrep/fgrep [-EFrivwcloqsHbhn] [-ABC NUM] [-m MAX] [-e REGEX]... [-MS PATTERN]... [-f REGFILE] [FILE]... |
244| gzip      | 压缩文件。<br />usage: gzip [-19cdfk] [FILE...] |
245| expand    | 根据输入参数将制表符展开为空格。<br />usage: expand [-t TABLIST] [FILE...] |
246| fallocate | 让文件系统给文件预留空间。<br />usage: fallocate [-l size] [-o offset] file |
247| file      | 检查给定的文件并描述其内容类型。<br />usage: file [-bhLs] [file...] |
248| find      | 在目录中搜索匹配的文件。<br />usage: find [-HL] [DIR...] [&lt;options&gt;] |
249| flock     | 管理文件锁(advisory lock)。<br />usage: flock [-sxun] fd |
250| fmt       | 将输入重新格式化为给定行长的换行,保留现有的缩进级别,写入标准输出设备。<br />usage: fmt [-w WIDTH] [FILE...] |
251| gunzip    | 解压文件。如果没有文件,则从标准输入设备解压到标准输出设备。成功后,输入文件将被删除并替换为新的没有.gz后缀的文件。<br />usage: gunzip [-cfk] [FILE...] |
252| head      | 将文件中的第一行复制到标准输出设备中。如果未列出任何文件,从标准输入设备拷贝。“-”代表标准输入设备。<br />usage: head [-n number] [file...] |
253| hexedit   | 十六进制文件编辑器,所有修改立刻写入磁盘。<br />usage: hexedit FILENAME |
254| iconv     | 转换文件编码。<br />usage: iconv [-f FROM] [-t TO] [FILE...] |
255| inotifyd  | 在文件系统事件出现的时候,运行特定的程序。<br />usage: inotifyd PROG FILE[:MASK] ... |
256| install   | 复制文件并设置文件属性。<br />usage: install [-dDpsv] [-o USER] [-g GROUP] [-m MODE] [-t TARGET] [SOURCE...] [DEST] |
257| link      | 创建文件的硬链接。<br />usage: link FILE NEWLINK |
258| ln        | 在 FROM 和 TO 之间创建软/硬链接。<br />usage: ln [-sfnv] [-t DIR] [FROM...] TO |
259| ls        | 查看当前目录有哪些文件/文件夹。<br />usage: ls [-ACFHLRSZacdfhiklmnpqrstux1] [--color[=auto]] [directory...] |
260| lsattr    | 列出Linux文件系统中的文件属性。标志字母在chattr帮助中定义。<br />usage: lsattr [-Radlv] [Files...] |
261| lsof      | 列出属于所有活跃进程的所有打开的文件,或使用列出的FILE的进程。<br />usage: lsof [-lt] [-p PID1,PID2,...] [FILE...] |
262| md5sum    | 计算每个输入文件的哈希,如果没有,则从标准输入设备读取。每个输入文件输出一行哈希后跟文件名。<br />usage: md5sum [-bcs] [FILE]... |
263| mkdir     | 创建一个或多个目录。<br />usage: mkdir [-vp] [-m mode] [dirname...] |
264| mkfifo    | 创建FIFO文件(命名管道)。<br />usage: mkfifo [NAME...] |
265| mkswap    | 创建Linux的交换空间。<br />usage: mkswap [-L LABEL] DEVICE |
266| mktemp    | 安全地创建一个新文件“DIR/TEMPLATE”并打印其名称。<br />usage: mktemp [-dqu] [-p DIR] [TEMPLATE] |
267| mknod     | 创建一个特殊的文件(b为块设备,c或u为字符设备,p为命名管道)。<br />usage: mknod [-m MODE] NAME TYPE [MAJOR MINOR] |
268| more      | 查看文件,一次一页。<br />usage: more [FILE...] |
269| mv        | 移动或重命名文件。<br />usage: mv [-finTv] [-t TARGET] SOURCE... [DEST] |
270| nl        | 给输入的文件添加行号。<br />usage: nl [-E] [-l #] [-b MODE] [-n STYLE] [-s SEPARATOR] [-v #] [-w WIDTH] [FILE...] |
271| od        | 以八进制/十六进制格式转储数据。<br />usage: od [-bcdosxv] [-j #] [-N #] [-w #] [-A doxn] [-t acdfoux[#]] |
272| paste     | 从每个输入文件中合并相应的行。<br />usage: paste [-s] [-d DELIMITERS] [FILE...] |
273| patch     | 将统一的diff应用于一个或多个文件。<br />usage: patch [-d DIR] [-i file] [-p depth] [-Rlsu] [--dry-run] |
274| pgrep     | 查找进程。PATTERN是扩展正则表达式,用于命令名称的检测。<br />usage: pgrep [-clfnovx] [-d DELIM] [-L SIGNAL] [PATTERN] [-G GID,] [-g PGRP,] [-P PPID,] [-s SID,] [-t TERM,] [-U UID,] [-u EUID,] |
275| printf    | 使用C语言的printf语法,根据Format格式化并打印参数。<br />usage: printf FORMAT [ARGUMENT...] |
276| pwd       | 打印工作(当前)目录。<br />usage: pwd [-L \| -P] |
277| readahead | 将文件预加载到磁盘缓存中。<br />usage: readahead FILE... |
278| readlink  | 如果没有选项,则显示symlink指向什么,如果不是symlink则返回错误。<br />usage: readlink FILE... |
279| realpath  | 显示规范绝对路径名。<br />usage: realpath FILE... |
280| rev       | 逆向输出每一行。<br />usage: rev [FILE...] |
281| rm        | 删除文件。<br />usage: rm [-fiRrv] FILE... |
282| rmdir     | 删除一个或多个目录。<br />usage: rmdir [-p] [dirname...] |
283| sed       | 流编辑器。将编辑脚本应用于输入行。<br />usage: sed [-inrzE] [-e SCRIPT]... \| SCRIPT [-f SCRIPT\_FILE]... [FILE...] |
284| seq       | 从头到尾按递增计数。省略参数默认值为1。使用两个参数作为第一个和最后一个。参数可以是负数或浮点数。<br />usage: seq [-w \| -f fmt\_str] [-s sep\_str] [first] [increment] last |
285| setfattr  | 写入POSIX扩展属性。<br />usage: setfattr [-h] [-x \| -n NAME] [-v VALUE] FILE... |
286| sha1sum/sha256sum | 计算sha系列哈希值。<br />usage: sha?sum [-bcs] [FILE]... |
287| shred     | 安全的删除文件(用随机数据覆盖文件内容)。<br />usage: shred [-fuz] [-n COUNT] [-s SIZE] FILE... |
288| sort      | 对从输入文件(或标准输入设备)到标准输出设备的所有文本行进行排序。<br />usage: sort [-Mbcdfginrsuz] [FILE...] [-k#[,#[x]] [-t X]] [-o FILE] |
289| split     | 将输入(或标准输入设备)数据复制到一系列输出(或“x”)文件,使用按字母顺序递增的后缀(aa,ab,ac...az,ba,bb...)。<br />usage: split [-a SUFFIX\_LEN] [-b BYTES] [-l LINES] [INPUT [OUTPUT]] |
290| stat      | 显示文件或文件系统的状态。<br />usage: stat [-tfL] [-c FORMAT] FILE... |
291| strings   | 在二进制文件中显示可打印字符串。<br />usage: strings [-fo] [-t oxd] [-n LEN] [FILE...] |
292| tac       | 以相反的顺序输出行。<br />usage: tac [FILE...] |
293| tail      | 将文件中的最后几行复制到标准输出设备中。“-”代表标准输入设备。<br />usage: tail [-n\|c NUMBER] [-f] [FILE...] |
294| tar       | 在.tar文件中创建、解压缩或列出文件。<br />usage: tar [-cxt] [-fvohmjkOS] [-XTCf NAME] [FILES] |
295| tee       | 将标准输入设备复制到每个列出的文件,也复制到标准输出设备。“-”代表标准输出设备。<br />usage: tee [-ai] [file...] |
296| touch     | 更新每个FILE的访问和修改时间为当前时间。<br />usage: touch [-amch] [-d DATE] [-t TIME] [-r FILE] FILE... |
297| truncate  | 设置文件的长度,必要时稀疏扩展。<br />usage: truncate [-c] -s SIZE file... |
298| uniq      | 报告或过滤文件中的重复行。<br />usage: uniq [-cduiz] [-w maxchars] [-f fields] [-s char] [input\_file [output\_file]] |
299| unix2dos  | 将换行符格式从unix“\\n”转换为dos“\\r\\n”。如果没有列出文件,从标准输入设备获取输入。“-”代表标准输入设备。<br />usage: unix2dos [FILE...] |
300| unlink    | 删除文件。<br />usage: unlink FILE |
301| uudecode  | 从标准输入设备(或INFILE)解码文件。<br />usage: uudecode [-o OUTFILE] [INFILE] |
302| uuencode  | 标准输入设备(或文件)进行编码,输出到标准输出设备,在输出中包含encode-filename。<br />usage: uuencode [-m] [file] encode-filename |
303| wc        | 统计输入中的行数、单词和字符。<br />usage: wc -lwcm [FILE...] |
304| which     | 在\$PATH中搜索与文件名匹配的可执行文件。<br />usage: which [-a] filename ... |
305| xxd       | 以16进制的形式显示文件内容。若没有列出任何文件,从标准输入设备复制。<br />usage: xxd [-c n] [-g n] [-i] [-l n] [-o n] [-p] [-r] [-s n] [file] |
306| zcat      | 将文件解压缩到标准输出设备。比如“gzip -dc”。<br /> usage: zcat [FILE...] |
307
308## 常见问题
309
310### 报错:"Unknown command xxx"
311在命令行中输入"xxx"或"toybox xxx"或"help xxx"时,如果遇到报错"Unknown command xxx",表示toybox不支持xxx命令。
312<!--RP2-->
313如果该命令在本文的描述中,则证明产品未编译该命令,建议前往OpenHarmony官方论坛提问反馈。
314<!--RP2End-->
315
316### 报错:"Operation not permitted"/"Permission denied"
317toybox存在大量操作文件和进程的命令,如果调用者缺少对被操作对象的权限,就会报错。
3181. 权限缺失。请检查被操作的文件,以及所属文件夹的读、写、执行权限,确认自己是否有权限执行。
3192. SELinux拦截。可以在内核日志中搜索"avc: denied"关键字。
320例子:
321如果出现类似avc: denied { xxx } for comm="ls" xxxxxx的日志,表示命令ls触发了SELinux拦截。
322
323<!--RP3-->
324如遇权限缺失问题,又需要执行该命令,建议前往OpenHarmony官方论坛提问反馈。
325<!--RP3End-->
326
327### 其他Linux标准报错
328toybox大部分命令为对内核的调用,出错时会通过perror打印Linux内核错误码对应的文本。
329常见的错误有:"File exists"/"Not a directory"/"Read-only file system"等。
330这些为Linux标准错误,可以参考Linux相关资料查询报错原因。请根据具体报错,检查命令的参数或者命令的格式是否出现错误。
331
332例子:
333试图在只读文件系统中进行创建文件的操作,会有报错"Read-only file system"。
334cat可以打印文件内容,如果试图cat一个目录,会有报错 "Is a directory"。
335试图用ls命令查看一个不存在的文件或目录,会有报错"No such file or directory"。
336
337### 命令与toybox描述不符合
338如果发现在shell下输入"命令 参数"的表现与"toybox 命令 参数"不一致,可能有两种原因导致。
339
3401. 实际调用的是shell的实现而非toybox。
341
342对于time/test/pwd/realpath/ulimit/kill等命令,shell会直接使用自己的实现。
343此时如果想要调用toybox命令,请使用"toybox [command] [arguments...]"的格式。
344
3452. 设备未将该命令配置给toybox,而是有另外的实现。
346
347此时如果想要调用toybox命令,请使用"toybox [command] [arguments...]"的格式。
348