toybox
toybox 是一个轻量级的Linux命令行工具集合，它将常用的Linux命令行工具合并到一个单独的可执行文件中。
前置条件
使用方法1
- 正常连接设备
- 使用hdc shell进入命令行执行模式
使用方法2
- 应用沙箱内运行
命令行说明
toybox的执行方式有两种：
- toybox [COMMAND] [ARGUMENTS...]
- 直接执行 [COMMAND] [ARGUMENTS...]
其中 [COMMAND] 可被替换为toybox支持的任意命令（可通过输入不带参数的toybox命令查询）。
[ARGUMENTS...] 为[COMMAND]所需要的参数。
当前版本中，不同设备对toybox的支持情况存在差异。开发者可直接执行toybox获取设备支持的全量命令。
帮助命令
格式：toybox [--long | --help | --version | [COMMAND] [ARGUMENTS...]]
| 选项 | 参数 | 说明 |
|---|---|---|
| --help | NA | 显示命令帮助。 |
| --long | NA | 显示支持的所有命令的路径。 |
| --version | NA | 显示版本号。 |
| NA | NA | 显示所有[COMMAND]支持的命令。 |
| [COMMAND] | [ARGUMENTS] | 执行具体的命令。大部分命令也支持--help和--version参数。 |
格式：help [-ahu] [COMMAND]
| 参数 | 说明 |
|---|---|
| COMMAND | 显示COMMAND的帮助。[COMMAND] 可被替换为toybox支持的任意命令。 |
| 选项 | 说明 |
|---|---|
| -a | 显示所有命令的帮助。 |
| -h | 仅显示help命令的帮助。 |
| -u | 以HTML方式显示help命令的帮助。 |
数学与计算机基础函数
| 命令 | 说明 |
|---|---|
| ascii | 显示ascii编码表。 usage: ascii |
| factor | 分解质因数。 usage: factor [-hx] NUMBER... |
| mcookie | 生成128位强随机数。 usage: mcookie [-vV] |
| mkpasswd | 对密码进行加密。 usage: mkpasswd [-P FD] [-m TYPE] [-S SALT] [PASSWORD] [SALT] |
| uuidgen | 创建并打印新的RFC4122随机UUID。 usage: uuidgen |
终端操作
| 命令 | 说明 |
|---|---|
| chvt | 切换到虚拟终端N。 usage: chvt NUM |
| chroot | 以指定的根目录运行命令。 usage: chroot NEWROOT [COMMAND [ARG...]] |
| clear | 清空终端。 usage: clear |
| nohup | 运行一个独立于终端的命令。 usage: nohup COMMAND... |
| tty | 显示连接到标准输入设备的终端的名称。 usage: tty [-s] |
| reset | 复位终端。 usage: reset |
| microcom | 简单串口终端。 usage: microcom [-s SPEED] [-X] DEVICE |
sh逻辑命令
| 命令 | 说明 |
|---|---|
| false | 返回非零值。 usage: false |
| sh | shell命令解释器。 |
| test | 通过执行测试返回true或false。没有参数时返回false。 usage: test [-bcdefghkLprSsuwx PATH] [-nz STRING] [-t FD] [X ?? Y] |
| true | 返回零。 usage: true |
| yes | 反复输出行直到被杀死。如果没有参数，则输出“y”。 usage: yes [args...] |
系统操作
| 命令 | 说明 |
|---|---|
| acpi | 查询电源、温度状态。 usage: acpi [-abctV] |
| arch | 打印系统名称。 usage: arch |
| dmesg | 显示或控制内核环形缓冲区。 usage: dmesg [-Cc] [-r |
| dnsdomainname | 显示系统的名称（与 hostname -d 一致）。 usage: dnsdomainname |
| getconf | 获取系统配置值，部分值需要path参数。 usage: getconf -a [PATH] |
| env | 设置命令调用的环境，或列出环境变量。 usage: env [-0i] [-e FILE] [-u NAME] [NAME=VALUE...] [COMMAND...] |
| hostname | 获取当前主机名。 usage: hostname [-bdsf] [-F FILENAME] [newname] |
| insmod | 加载内核模块。 usage: insmod MODULE [OPTION...] |
| logger | 记录系统日志。 usage: logger [-s] [-t TAG] [-p [FACILITY.]PRIORITY] [MESSAGE...] |
| lsmod | 显示当前已经加载的模块，它们的大小和依赖。 usage: lsmod |
| mix | 显示OSS声道，或者设置音量。 usage: mix [-d DEV] [-c CHANNEL] [-l VOL] [-r RIGHT] |
| modinfo | 显示内核模块信息。 usage: modinfo [-0] [-b basedir] [-k kernel] [-F field] [module |
| nproc | 打印处理器数量。 usage: nproc [--all] |
| oneit | 简单的初始化程序。 usage: oneit [-prn3] [-c CONSOLE] [COMMAND...] |
| partprobe | 通知内核分区表已经变化。 usage: partprobe DEVICE... |
| pivot_root | 修改根目录。 usage: pivot_root OLD NEW |
| printenv | 打印环境变量。 usage: printenv [-0] [env_var...] |
| reboot/halt/poweroff | 重启/停止/关机。 usage: reboot/halt/poweroff [-fn] [-d DELAY] |
| rfkill | 开启/关闭无线设备。 usage: rfkill COMMAND [DEVICE] |
| rmmod | 卸载内核模块。 usage: rmmod [-wf] MODULE... |
| sendevent | 发送Linux输入事件。 usage: sendevent DEVICE TYPE CODE VALUE |
| swapoff | 停用交换空间。 usage: swapoff FILE |
| swapon | 在指定的设备或文件上，使能内存交换。 usage: swapon [-d] [-p priority] filename |
| switch_root | 切换根目录，并执行新的INIT程序。 usage: switch_root [-c /dev/console] NEW_ROOT NEW_INIT... |
| uname | 打印系统信息。 usage: uname [-asnrvmo] |
| vmstat | 打印虚拟内存信息。 usage: vmstat [-n] [DELAY [COUNT]] |
时间日期
| 命令 | 说明 |
|---|---|
| cal | 打印日历。 usage: cal [-h] [[[DAY] MONTH] YEAR] |
| date | 设置/获取当前日期/时间。 usage: date [-u] [-I RES] [-r FILE] [-d DATE] [+DISPLAY_FORMAT] [-D SET_FORMAT] [SET] |
| hwclock | 获取/设置硬件时钟。 usage: hwclock [-rswtlu] [-f FILE] |
| sleep | 等待设置的时间后再退出。可以是小数。可选的后缀可以是“m”（分钟）、“h”（小时）、“d”（天）或“s”（秒，默认值）。 usage: sleep DURATION... |
| time | 运行命令行并报告真实时间、用户时间和系统时间（以秒为单位）。(真实时间=时钟时间，用户时间=命令代码使用cpu的时间，系统时间=操作系统使用cpu的时间。) usage: time [-pv] COMMAND... |
| uptime | 显示当前时间，系统运行了多长时间，用户数量，以及过去1、5和15分钟的系统负载平均值。 usage: uptime [-ps] |
| usleep | 等待设置的时间后再退出，单位微秒。 usage: usleep MICROSECONDS |
登录用户操作
| 命令 | 说明 |
|---|---|
| groups | 打印用户所在的组。 usage: groups [user] |
| id | 打印用户和组ID。 usage: id [-Ggnru] [USER...] |
| login | 用户登录。 usage: login [-p] [-h host] [-f USERNAME] [USERNAME] |
| logname/whoami | 打印当前用户名。 usage: logname/whoami |
| passwd | 更新用户的认证令牌。 usage: passwd [-a ALGO] [-dlu] [USER] |
| who | 打印有关已登录用户的信息。 usage: who |
| w | 显示用户登录情况和登录时间。 usage: w |
进程操作
| 命令 | 说明 |
|---|---|
| chrt | 获取/设置一个进程的调度策略和优先级。 usage: chrt [-Rmofrbi] {-p PID [PRIORITY] |
| iorenice | 显示/修改一个进程的IO优先级。 usage: iorenice PID [CLASS] [PRIORITY] |
| iotop | 根据I/O对进程排序。 usage: iotop [-AaKObq] [-n NUMBER] [-d SECONDS] [-p PID,] [-u USER,] |
| ionice | 显示/修改一个进程的IO调度优先级。 usage: ionice [-t] [-c CLASS] [-n LEVEL] [COMMAND... |
| kill | 向进程发送信号。 usage: kill [-l [SIGNAL] |
| killall | 向具有给定名称的所有进程发送信号（默认：SIGTERM）。 usage: killall [-l] [-iqv] [-SIGNAL |
| killall5 | 对当前会话以外的所有进程发送信号。 usage: killall5 [-l [SIGNAL]] [-SIGNAL |
| pidof | 打印具有给定名称的所有进程的PID。 usage: pidof [-s] [-o omitpid[,omitpid...]] [NAME...] |
| pkill | 按照进程名来杀死进程。 usage: pkill [-fnovx] [-SIGNAL |
| pmap | 查看进程的内存映射情况。 usage: pmap [-xq] [pids...] |
| ps | 显示进程信息。 usage: ps [-AadefLlnwZ] [-gG GROUP,] [-k FIELD,] [-o FIELD,] [-p PID,] [-t TTY,] [-uU USER,] |
| pwdx | 打印进程的工作目录。 usage: pwdx PID... |
| renice | 调整进程/组/用户级别的进程优先级。 usage: renice [-gpu] -n INCREMENT ID... |
| setsid | 在新的会话中运行命令。 usage: setsid [-t] command [args...] |
| taskset | 启动一个仅在指定处理器上运行的任务，或者修改已经存在的进程的处理器偏好。 usage: taskset [-ap] [mask] [PID |
| timeout | 创建子进程执行命令，如果子进程超时未退出，则向子进程发送一个信号。DURATION可以是小数。可选的后缀可以是“m”（分钟）、“h”（小时）、“d”（天）或“s”（秒，默认值）。 usage: timeout [-k DURATION] [-s SIGNAL] DURATION COMMAND... |
| top | 实时显示进程信息。 usage: top [-Hhbq] [-k FIELD,] [-o FIELD,] [-s SORT] [-n NUMBER] [-m LINES] [-d SECONDS] [-p PID,] [-u USER,] |
| nice | 以指定的优先级运行命令。 usage: nice [-n PRIORITY] COMMAND... |
| nsenter | 在特定的命名空间中运行指令。 usage: nsenter [-t pid] [-F] [-i] [-m] [-n] [-p] [-u] [-U] COMMAND... |
| ulimit/prlimit | 显示或者设置进程的资源限制。 usage: ulimit/prlimit [-P PID] [-SHRacdefilmnpqrstuv] [LIMIT] |
| unshare | 给一个进程创建新的命名空间，部分属性不与父进程共享。 usage: unshare [-imnpuUr] COMMAND... |
| watch | 每隔-n秒运行一次参数中的命令，显示执行结果。按q退出。 usage: watch [-tebx] [-n SEC] COMMAND... |
| xargs | 运行命令行一次或多次，附加标准输入设备中的参数。 usage: xargs [-0Pprt] [-snE STR] COMMAND... |
设备节点操作
| 命令 | 说明 |
|---|---|
| blkid | 打印文件系统的类型，标签和UUID等信息。 usage: blkid [-o TYPE] [-s TAG] [-UL] DEV... |
| blockdev | 对每个命令中的块设备调用ioctl。 usage: blockdev --OPTION... BLOCKDEV... |
| devmem | 通过 /dev/mem 读写物理地址。 usage: devmem [-f FILE] ADDR [WIDTH [DATA...]] |
| df | 显示命令行中列出的每个文件系统的总共、已使用和空闲的磁盘空间。无参数时显示已装载的所有文件系统。 usage: df [-aHhikP] [-t TYPE] [FILE...] |
| du | 显示磁盘使用情况，文件和目录占用的空间。 usage: du [-d N] [-abcHKkLlmsx] [FILE...] |
| eject | 弹出设备，默认为 /dev/cdrom 。 usage: eject [-stT] [DEVICE] |
| free | 显示物理内存和交换空间的总量、可用量和已用量。 usage: free [-bkmgt] |
| freeramdisk | 释放特定ramdisk的所有内存。 usage: freeramdisk [RAM device] |
| fsfreeze | 冻结或解冻一个文件系统。 usage: fsfreeze {-f |
| fstype | 打印文件系统的类型。 usage: fstype DEV... |
| fsync | 将文件状态与存储设备同步。 usage: fsync [-d] [FILE...] |
| i2cdetect | 检测 i2c 设备。 usage: i2cdetect [-aqry] BUS [FIRST LAST] usage: i2cdetect -F BUS usage: i2cdetect -l |
| i2cdump | 打印所有 i2c 寄存器。 usage: i2cdump [-fy] BUS CHIP |
| i2cget | 读取 i2c 寄存器。 usage: i2cget [-fy] BUS CHIP [ADDR] |
| i2cset | 写 i2c 寄存器。 usage: i2cset [-fy] BUS CHIP ADDR VALUE... MODE |
| losetup | 设置循环设备。 usage: losetup [-cdrs] [-o OFFSET] [-S SIZE] {-d DEVICE... |
| lspci | 显示 PCI 设备信息。 usage: lspci [-ekmn] [-i FILE ] |
| lsusb | 显示 USB 设备信息。 usage: lsusb |
| makedevs | 创建一系列特殊的文件，包括块设备文件，字符设备文件等。 usage: makedevs [-d device_table] rootdir |
| mount | 在目录上挂载新的文件系统。如果没有参数，则显示现有的挂载。 usage: mount [-afFrsvw] [-t TYPE] [-o OPTION,] [[DEVICE] DIR] |
| mountpoint | 检查目录或者设备是否是挂载点。 usage: mountpoint [-qd] DIR mountpoint [-qx] DEVICE |
| sync | 将缓存的数据写到磁盘。 usage: sync |
| sysctl | 读写 /proc/sys 下的系统控制数据。 usage: sysctl [-aAeNnqw] [-p [FILE] |
| tunctl | 创建或删除tun/tap虚拟以太设备。 usage: tunctl [-dtT] [-u USER] NAME |
| vconfig | 创建或删除虚拟以太设备。 usage: vconfig COMMAND [OPTIONS] |
| umount | 取消挂载文件系统。 usage: umount [-a [-t TYPE[,TYPE...]]] [-vrfD] [DIR...] |
网络操作
| 命令 | 说明 |
|---|---|
| ftpget/ftpput | 与FTP服务器沟通，支持读、写、列举文件等操作。ftpget自带-g选项。ftpput自带-s选项。 usage: ftpget/ftpput [-cvgslLmMdD] [-p PORT] [-P PASSWORD] [-u USER] HOST [LOCAL] REMOTE |
| ifconfig | 显示或配置网络接口。 usage: ifconfig [-aS] [INTERFACE [ACTION...]] |
| nbd-client | 创建nbd客户端。 usage: nbd-client [-ns] [-b BLKSZ] HOST PORT DEVICE |
| netstat | 显示网络信息。 usage: netstat [-pWrxwutneal] |
| ping/ping6 | 检测网络连通性。ping6自带-6选项。 usage: ping/ping6 [OPTIONS] HOST |
| sntp | SNTP客户端。 usage: sntp [-saSdDq] [-r SHIFT] [-mM[ADDRESS]] [-p PORT] [SERVER] |
| telnet | 连接telnet服务器。 usage: telnet HOST [PORT] |
| traceroute/traceroute6 | 跟踪报文到HOST的路径。traceroute6自带-6选项。 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] usage: traceroute6 [-dnrv] [-m MAXTTL] [-p PORT] [-q PROBES][-s SRC_IP] [-t TOS] [-w WAIT_SEC] [-i IFACE] HOST [BYTES] |
| wget | 从网络上下载资源。 usage: wget [OPTIONS]... [URL] [OPTIONS] = --max-redirect x -d -O filename -p data |
文件操作
| 命令 | 说明 |
|---|---|
| awk | awk是一个处理文本的工具，可对文档内容进行筛选、分析。 usage: awk [-F sepstring] [-v assignment]... program [argument...] or: awk [-F sepstring] -f progfile [-f progfile]... [-v assignment]... [argument...] |
| base64 | 通过base64算法进行加密/解密。 usage: base64 [-di] [-w COLUMNS] [FILE...] |
| basename | 返回删除后缀的路径名的非目录部分。 usage: basename [-a] [-s SUFFIX] NAME... |
| bunzip2 | 解压bz格式的文件。 usage: bunzip2 [-cftkv] [FILE...] |
| bzcat | 解压列举的文件到标准输出。 usage: bzcat [FILE...] |
| cat | 复制（连接）文件到标准输出设备。如果未列出任何文件，则从标准输入设备复制。“-”代表标准输入设备。 usage: cat [-etuv] [FILE...] |
| chattr | 修改Linux ext2文件系统的文件属性。 usage: chattr [-R] [-+=AacDdijsStTu] [-v version] [File...] |
| chcon | 修改文件的SELinux安全上下文。 usage: chcon [-hRv] CONTEXT FILE... |
| chgrp/chown | 修改文件的组。 usage: chgrp/chown [-RHLP] [-fvh] GROUP FILE... |
| chmod | 更改列出的文件的模式（使用-R递归）。 usage: chmod [-R] MODE FILE... |
| cksum | 对于每个文件，输出crc32的校验和、长度和文件名。如果未列出任何文件，则从标准输入设备复制。“-”代表标准输入设备。 usage: cksum [-HIPLN] [FILE...] |
| cmp | 比较文件的内容（如果只给出一个，则与标准输入设备进行比较），可选在开始时跳过字节。 usage: cmp [-ls] [-n LEN] FILE1 [FILE2 [SKIP1 [SKIP2]]] |
| comm | 读取FILE1和FILE2（这两个文件应该是有序的），并生成三个文本列作为输出：仅在FILE1中的行、仅在FILE2中的行、在两个文件中都有的行。“-”代表标准输入设备。 usage: comm [-123] FILE1 FILE2 |
| count | 将标准输入设备复制到标准输出设备，将简单的进度指示器显示到标准错误输出stderr。 usage: count [-l] |
| cp | 将文件从SOURCE复制到DEST。如果有多个源，DEST必须是一个目录。 usage: cp [-aDdFfHiLlnPpRrsTuv] [--preserve=motcxa] [-t TARGET] SOURCE... [DEST] |
| cpio | 从“newc”格式的cpio档案中读写文件。 usage: cpio -{o |
| crc32 | 输出每个文件的crc32校验和。 usage: crc32 [file...] |
| cut | 将每个FILE中的行的选定部分打印到标准输出。每个选择列表以逗号分隔，可以是数字（从1开始计数）或破折号分隔的范围（其中X-表示X到行尾，-X表示从开始到X）。 usage: cut [-Ds] [-bcCfF LIST] [-dO DELIM] [FILE...] |
| dd | 用于转换和复制文件的命令，可以用于创建磁盘镜像、备份数据、转换字符编码等任务。 usage: dd [if |
| diff | 比较文件/文件夹，输出差异。 usage: diff [-abBdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] [-F REGEX ] FILE1 FILE2 |
| dirname | 显示路径的目录部分。 usage: dirname PATH... |
| dos2unix | 将换行符格式从dos“\r\n”转换为unix“\n”。如果没有列出文件，从标准输入设备获取输入。“-”代表标准输入设备。 usage: dos2unix [FILE...] |
| echo | 将每个参数写入标准输出设备，每个参数之间有一个空格，后跟一个换行符。 usage: echo [-Een] [ARG...] |
| grep/egrep/fgrep | 显示匹配正则表达式的行。如果没有-e，则第一个参数为要匹配的正则表达式。没有文件（或“-”文件名）读取标准输入设备。如果匹配，则返回0；如果找不到匹配，则返回1；如果命令错误，则返回2。 egrep自带-E选项，fgrep自带-F选项。E和F选项不能同时选。 usage: grep/egrep/fgrep [-EFrivwcloqsHbhn] [-ABC NUM] [-m MAX] [-e REGEX]... [-MS PATTERN]... [-f REGFILE] [FILE]... |
| gzip | 压缩文件。 usage: gzip [-19cdfkt] [FILE...] |
| expand | 根据输入参数将制表符展开为空格。 usage: expand [-t TABLIST] [FILE...] |
| fallocate | 让文件系统给文件预留空间。 usage: fallocate [-o OFFSET] -l SIZE FILE |
| file | 检查给定的文件并描述其内容类型。 usage: file [-bhLs] [FILE...] |
| find | 在目录中搜索匹配的文件。 usage: find [-HL] [DIR...] [[/topic/body/section/table/tgroup/tbody/row/entry/p/options {""}) ] (options] |
| flock | 管理文件锁（advisory lock）。 usage: flock [-sxun] fd |
| fmt | 将输入重新格式化为给定行长的换行，保留现有的缩进级别，写入标准输出设备。 usage: fmt [-w WIDTH] [FILE...] |
| gunzip | 解压文件。如果没有文件，则从标准输入设备解压到标准输出设备。成功后，输入文件将被删除并替换为新的没有.gz后缀的文件。 usage: gunzip [-cfkt] [FILE...] |
| head | 将文件中的第一行复制到标准输出设备中。如果未列出任何文件，从标准输入设备拷贝。“-”代表标准输入设备。 usage: head [-cn NUM] [-qv] [FILE...] |
| hexedit | 十六进制文件编辑器，所有修改立刻写入磁盘。 usage: hexedit [-r] FILE |
| iconv | 转换文件编码。 usage: iconv [-f FROM] [-t TO] [FILE...] |
| inotifyd | 在文件系统事件出现的时候，运行特定的程序。 usage: inotifyd PROG FILE[:MASK] ... |
| install | 复制文件并设置文件属性。 usage: install [-dDpsv] [-o USER] [-g GROUP] [-m MODE] [-t TARGET] [SOURCE...] [DEST] |
| link | 创建文件的硬链接。 usage: link FILE NEWLINK |
| ln | 在 FROM 和 TO 之间创建软/硬链接。 usage: ln [-fnrsTv] [-t DIR] [FROM...] TO |
| ls | 查看当前目录有哪些文件/文件夹。 usage: ls [-1ACFHLNRSUXZabcdfghilmnopqrstuwx] [--color[=auto]] [FILE...] |
| lsattr | 列出Linux文件系统中的文件属性。标志字母在chattr帮助中定义。 usage: lsattr [-Radlv] [Files...] |
| lsof | 列出属于所有活跃进程的所有打开的文件，或使用列出的FILE的进程。 usage: lsof [-lt] [-p PID1,PID2,...] [FILE...] |
| md5sum | 计算每个输入文件的哈希，如果没有，则从标准输入设备读取。每个输入文件输出一行哈希后跟文件名。 usage: ???sum [-bcs] [FILE]... |
| mkdir | 创建一个或多个目录。 usage: mkdir [-vp] [-m MODE] [DIR...] |
| mkfifo | 创建FIFO文件（命名管道）。 usage: mkfifo [NAME...] |
| mkswap | 创建Linux的交换空间。 usage: mkswap [-L LABEL] DEVICE |
| mktemp | 安全地创建一个新文件“DIR/TEMPLATE”并打印其名称。 usage: mktemp [-dqu] [-p DIR] [TEMPLATE] |
| mknod | 创建一个特殊的文件（b为块设备，c或u为字符设备，p为命名管道）。 usage: mknod [-m MODE] NAME TYPE [MAJOR MINOR] |
| more | 查看文件，一次一页。 usage: more [FILE...] |
| mv | 移动或重命名文件。 usage: mv [-FfinTvx] [-t TARGET] SOURCE... [DEST] |
| nl | 给输入的文件添加行号。 usage: nl [-E] [-l #] [-b MODE] [-n STYLE] [-s SEPARATOR] [-v #] [-w WIDTH] [FILE...] |
| od | 以八进制/十六进制格式转储数据。 usage: od [-bcdosxv] [-j #] [-N #] [-w #] [-A doxn] [-t acdfoux[#]] |
| paste | 从每个输入文件中合并相应的行。 usage: paste [-s] [-d DELIMITERS] [FILE...] |
| patch | 将统一的diff应用于一个或多个文件。 usage: patch [-d DIR] [-i file] [-p depth] [-Rlsu] [--dry-run] |
| pgrep | 查找进程。PATTERN是扩展正则表达式，用于命令名称的检测。 usage: pgrep [-clfnovx] [-d DELIM] [-L SIGNAL] [PATTERN] [-G GID,] [-g PGRP,] [-P PPID,] [-s SID,] [-t TERM,] [-U UID,] [-u EUID,] |
| printf | 使用C语言的printf语法，根据Format格式化并打印参数。 usage: printf FORMAT [ARGUMENT...] |
| pwd | 打印工作（当前）目录。 usage: pwd [-L |
| readahead | 将文件预加载到磁盘缓存中。 usage: readahead FILE... |
| readlink | 如果没有选项，则显示symlink指向什么，如果不是symlink则返回错误。 usage: readlink [-efmnqz] FILE... |
| realpath | 显示规范绝对路径名。 usage: realpath [-LPemqsz] [--relative-base DIR] [-R DIR] FILE... |
| rev | 逆向输出每一行。 usage: rev [FILE...] |
| rm | 删除文件。 usage: rm [-fiRrv] FILE... |
| rmdir | 删除一个或多个目录。 usage: rmdir [-p] [DIR...] |
| sed | 流编辑器。将编辑脚本应用于输入行。 usage: sed [-inrszE] [-e SCRIPT]... |
| seq | 从头到尾按递增计数。省略参数默认值为1。使用两个参数作为第一个和最后一个。参数可以是负数或浮点数。 usage: seq [-w |
| setfattr | 写入POSIX扩展属性。 usage: setfattr [-h] [-x |
| sha1sum/sha256sum | 计算sha系列哈希值。 usage: ???sum [-bcs] [FILE]... |
| shred | 安全的删除文件（用随机数据覆盖文件内容）。 usage: shred [-fuxz] [-n COUNT] [-o OFFSET] [-s SIZE] FILE... |
| sort | 对从输入文件（或标准输入设备）到标准输出设备的所有文本行进行排序。 usage: sort [-Mbcdfginrsuz] [FILE...] [-k#[,#[x]] [-t X]] [-o FILE] |
| split | 将输入（或标准输入设备）数据复制到一系列输出（或“x”）文件，使用按字母顺序递增的后缀（aa,ab,ac...az,ba,bb...）。 usage: split [-a SUFFIX_LEN] [-b BYTES] [-l LINES] [-n PARTS] [INPUT [OUTPUT]] |
| stat | 显示文件或文件系统的状态。 usage: stat [-tfL] [-c FORMAT] FILE... |
| strings | 在二进制文件中显示可打印字符串。 usage: strings [-fo] [-t oxd] [-n LEN] [FILE...] |
| tac | 以相反的顺序输出行。 usage: tac [FILE...] |
| tail | 将文件中的最后几行复制到标准输出设备中。“-”代表标准输入设备。 usage: tail [-n |
| tar | 在.tar文件中创建、解压缩或列出文件。 usage: tar [-cxt] [-fvohmjkOS] [-XTCf NAME] [--selinux] [FILE...] |
| tee | 将标准输入设备复制到每个列出的文件，也复制到标准输出设备。“-”代表标准输出设备。 usage: tee [-ai] [FILE...] |
| touch | 更新每个FILE的访问和修改时间为当前时间。 usage: touch [-amch] [-d DATE] [-t TIME] [-r FILE] FILE... |
| truncate | 设置文件的长度，必要时稀疏扩展。 usage: truncate [-c] -s SIZE file... |
| uniq | 报告或过滤文件中的重复行。 usage: uniq [-cduiz] [-w MAXCHARS] [-f FIELDS] [-s CHAR] [INFILE [OUTFILE]] |
| unix2dos | 将换行符格式从unix“\n”转换为dos“\r\n”。如果没有列出文件，从标准输入设备获取输入。“-”代表标准输入设备。 usage: unix2dos [FILE...] |
| unlink | 删除文件。 usage: unlink FILE |
| uudecode | 从标准输入设备（或INFILE）解码文件。 usage: uudecode [-o OUTFILE] [INFILE] |
| uuencode | 标准输入设备（或文件）进行编码，输出到标准输出设备，在输出中包含encode-filename。 usage: uuencode [-m] [INFILE] ENCODE_FILENAME |
| wc | 统计输入中的行数、单词和字符。 usage: wc [-Llwcm] [FILE...] |
| which | 在$PATH中搜索与文件名匹配的可执行文件。 usage: which [-a] filename ... |
| xxd | 以16进制的形式显示文件内容。若没有列出任何文件，从标准输入设备复制。 usage: xxd [-eipr] [-cglos N] [file] |
| zcat | 将文件解压缩到标准输出设备。比如“gzip -dc”。 usage: zcat [-f] [FILE...] |
常见问题
报错："Unknown COMMAND xxx"
在命令行中输入"xxx"或"toybox xxx"或"help xxx"时，如果遇到报错"Unknown COMMAND xxx"，表示toybox不支持xxx命令。
如果该命令在本文的描述中，则证明产品未编译该命令。如需帮助请通过“华为开发者联盟官网”->“支持”，在线提单方式获取支持。
报错："Operation not permitted"/"Permission denied"
toybox存在大量操作文件和进程的命令，如果调用者缺少对被操作对象的权限，就会报错。
- 权限缺失。请检查被操作的文件，以及所属文件夹的读、写、执行权限，确认自己是否有权限执行。
- SELinux拦截。可以在内核日志中搜索"avc: denied"关键字。
例子：
如果出现类似avc: denied { xxx } for comm="ls" xxxxxx的日志，表示命令ls触发了SELinux拦截。
如遇权限缺失问题，又需要执行该命令，可通过“华为开发者联盟官网”->“支持”，在线提单方式获取支持。
其他Linux标准报错
toybox大部分命令为对内核的调用，出错时会通过perror打印Linux内核错误码对应的文本。
常见的错误有："File exists"/"Not a directory"/"Read-only file system"等。
这些为Linux标准错误，可以参考Linux相关资料查询报错原因。请根据具体报错，检查命令的参数或者命令的格式是否出现错误。
例子：
试图在只读文件系统中进行创建文件的操作，会有报错"Read-only file system"。
cat可以打印文件内容，如果试图cat一个目录，会有报错 "Is a directory"。
试图用ls命令查看一个不存在的文件或目录，会有报错"No such file or directory"。
命令与toybox描述不符合
如果发现在shell下输入"命令 参数"的表现与"toybox 命令 参数"不一致，可能有两种原因导致。
-
实际调用的是shell的实现而非toybox。
对于time/test/pwd/realpath/ulimit/kill等命令，shell会直接使用自己的实现。
此时如果想要调用toybox命令，请使用"toybox [COMMAND] [ARGUMENTS...]"的格式。
-
设备未将该命令配置给toybox，而是有另外的实现。
此时如果想要调用toybox命令，请使用"toybox [COMMAND] [ARGUMENTS...]"的格式。