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 [-ah] [command]
参数 | 说明 |
---|---|
command | 显示command的帮助。[command] 可被替换为toybox支持的任意命令 |
选项 | 说明 |
---|---|
-a | 显示所有命令的帮助。 |
-h | 以html格式显示帮助。 |
数学与计算机基础函数
命令 | 说明 |
---|---|
ascii | 显示acsii编码表。usage: ascii |
factor | 分解质因数。usage: factor 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 N |
chroot | 以指定的根目录运行命令。usage: chroot NEWROOT [COMMAND [ARG…]] |
clear | 清空终端。usage: clear |
nohup | 运行一个独立于终端的命令。usage: nohup COMMAND [ARG…] |
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 [-bcdefghLPrSsuwx 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 [-i] [-u NAME] [NAME=VALUE…] [COMMAND [ARG…]] |
hostname | 获取当前主机名。usage: hostname [-bdsf] [-F FILENAME] [newname] |
insmod | 加载内核模块。usage: insmod MODULE [MODULE_OPTIONS] |
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 [-p] [-c /dev/tty0] 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] |
rfkill | 开启/关闭无线设备。usage: rfkill COMMAND [DEVICE] |
rmmod | 卸载内核模块。usage: rmmod [-wf] [MODULE] |
sendevent | 发送Linux输入事件。usage: sendevent DEVICE TYPE CODE VALUE |
swapoff | 停用交换空间。usage: swapoff swapregion |
swapon | 在指定的设备或文件上,使能内存交换。usage: swapon [-d] [-p priority] filename |
switch_root | 切换根目录,并执行新的INIT程序。usage: switch_root [-c /dev/console] NEW_ROOT NEW_INIT… |
uname | 打印系统信息。usage: uname [-asnrvm] |
vmstat | 打印虚拟内存信息。usage: vmstat [-n] [DELAY [COUNT]] |
时间日期
命令 | 说明 |
---|---|
cal | 打印日历。usage: cal [[month] year] |
date | 设置/获取当前日期/时间。usage: date [-u] [-r FILE] [-d DATE] [+DISPLAY_FORMAT] [-D SET_FORMAT] [SET] |
hwclock | 获取/设置硬件时钟。usage: hwclock [-rswtluf] |
sleep | 等待设置的时间后再退出。可以是小数。可选的后缀可以是“m”(分钟)、“h”(小时)、“d”(天)或“s”(秒,默认值)。usage: sleep DURATION |
time | 运行命令行并报告真实时间、用户时间和系统时间(以秒为单位)。(真实时间=时钟时间,用户时间=命令代码使用cpu的时间,系统时间=操作系统使用cpu的时间。)usage: time [-pv] COMMAND [ARGS…] |
uptime | 显示当前时间,系统运行了多长时间,用户数量,以及过去1、5和15分钟的系统负载平均值。usage: uptime [-ps] |
usleep | 等待设置的时间后再退出,单位微秒。usage: usleep MICROSECONDS |
登录用户操作
命令 | 说明 |
---|---|
groups | 打印用户所在的组。usage: groups [user] |
id | 打印用户和组ID。usage: id [-nGgru] [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 [-Hbq] [-k FIELD,] [-o FIELD,] [-s SORT] [-n NUMBER] [-m LINES] [-d SECONDS] [-p PID,] [-u USER,] |
nice | 以指定的优先级运行命令。usage: nice [-n PRIORITY] COMMAND [ARG…] |
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 [-teb] [-n SEC] PROG ARGS |
xargs | 运行命令行一次或多次,附加标准输入设备中的参数。usage: xargs [-0prt] [-s NUM] [-n NUM] [-E STR] COMMAND… |
设备节点操作
命令 | 说明 |
---|---|
blkid | 打印文件系统的类型,标签和UUID等信息。usage: blkid [-s TAG] [-UL] DEV… |
blockdev | 对每个命令中的块设备调用ioctl。usage: blockdev --OPTION… BLOCKDEV… |
devmem | 通过 /dev/mem 读写物理地址。usage: devmem ADDR [WIDTH [DATA]] |
df | 显示命令行中列出的每个文件系统的总共、已使用和空闲的磁盘空间。无参数时显示已装载的所有文件系统。usage: df [-HPkhi] [-t type] [FILESYSTEM …] |
du | 显示磁盘使用情况,文件和目录占用的空间。usage: du [-d N] [-askxHLlmc] [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 [-ary] BUS [FIRST LAST]i2cdetect -F BUSi2cdetect -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] DIRmountpoint [-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] HOST PORT DEVICE |
netstat | 显示网络信息。usage: netstat [-pWrxwutneal] |
ping/ping6 | 检测网络连通性。ping6自带-6选项。usage: ping/ping6 [OPTIONS] HOST |
sntp | SNTP客户端。usage: sntp [-saSdDqm] [-r SHIFT] [-m 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] |
文件操作
命令 | 说明 |
---|---|
awk | awk是一个处理文本的工具,可对文档内容进行筛选、分析。usage: awk [-F sepstring] [-v assignment]… program [argument…]awk [-F sepstring] -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 [-IPLN] [file…] |
cmp | 比较文件的内容(如果只给出一个,则与标准输入设备进行比较),可选在开始时跳过字节。usage: cmp [-l] [-s] FILE1 [FILE2 [SKIP1 [SKIP2]]] |
comm | 读取FILE1和FILE2(这两个文件应该是有序的),并生成三个文本列作为输出:仅在FILE1中的行;仅在FILE2中的行;在两个文件中都有的行。“-”代表标准输入设备usage: comm [-123] FILE1 FILE2 |
count | 将标准输入设备复制到标准输出设备,将简单的进度指示器显示到标准错误输出stderr。usage: count |
cp | 将文件从SOURCE复制到DEST。如果有多个源,DEST必须是一个目录。usage: cp [–preserve=motcxa] [-adlnrsvfipRHLP] SOURCE… DEST |
cpio | 从“newc”格式的cpio档案中中读写文件。usage: cpio -{o |
crc32 | 输出每个文件的crc32校验和。usage: crc32 [file…] |
cut | 将每个FILE中的行的选定部分打印到标准输出。每个选择列表以逗号分隔,可以是数字(从1开始计数)或破折号分隔的范围(其中X-表示X到行尾,-X表示从开始到X)。usage: cut [-Ds] [-bcfF LIST] [-dO DELIM] [FILE…] |
dd | 用于转换和复制文件的命令,可以用于创建磁盘镜像、备份数据、转换字符编码等任务。usage:dd [if=FILE] [of=FILE] [ibs=N] [obs=N] [iflag=FLAGS] [oflag=FLAGS][bs=N] [count=N] [seek=N] [skip=N][conv=notrunc |
diff | 比较文件/文件夹,输出差异。usage: diff [-abBdiNqrTstw] [-L LABEL] [-S FILE] [-U LINES] FILE1 FILE2 |
dirname | 显示路径的目录部分。usage: dirname PATH… |
dos2unix | 将换行符格式从dos“\r\n”转换为unix“\n”。如果没有列出文件,从标准输入设备获取输入。“-”代表标准输入设备。usage: dos2unix [FILE…] |
echo | 将每个参数写入标准输出设备,每个参数之间有一个空格,后跟一个换行符。usage: echo [-neE] [args…] |
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 [-19cdfk] [FILE…] |
expand | 根据输入参数将制表符展开为空格。usage: expand [-t TABLIST] [FILE…] |
fallocate | 让文件系统给文件预留空间。usage: fallocate [-l size] [-o offset] file |
file | 检查给定的文件并描述其内容类型。usage: file [-bhLs] [file…] |
find | 在目录中搜索匹配的文件。usage: find [-HL] [DIR…] [] |
flock | 管理文件锁(advisory lock)。usage: flock [-sxun] fd |
fmt | 将输入重新格式化为给定行长的换行,保留现有的缩进级别,写入标准输出设备。usage: fmt [-w WIDTH] [FILE…] |
gunzip | 解压文件。如果没有文件,则从标准输入设备解压到标准输出设备。成功后,输入文件将被删除并替换为新的没有.gz后缀的文件。usage: gunzip [-cfk] [FILE…] |
head | 将文件中的第一行复制到标准输出设备中。如果未列出任何文件,从标准输入设备拷贝. “-”代表标准输入设备usage: head [-n number] [file…] |
hexedit | 十六进制文件编辑器,所有修改立刻写入磁盘。usage: hexedit FILENAME |
iconv | 转换文件编码。usage: iconv [-f FROM] [-t TO] [FILE…] |
inotifyd | 在文件系统事件出现的时候,运行特定的程序。usage: inotifyd PROG FILE[:MASK] … |
install | 复制文件并设置文件属性。usage: install [-dDpsv] [-o USER] [-g GROUP] [-m MODE] [SOURCE…] DEST |
link | 创建文件的硬链接。usage: link FILE NEWLINK |
ln | 在 FROM 和 TO 之间创建软/硬链接。usage: ln [-sfnv] [-t DIR] [FROM…] TO |
ls | 查看当前目录有哪些文件/文件夹。usage: ls [-ACFHLRSZacdfhiklmnpqrstux1] [–color[=auto]] [directory…] |
lsattr | 列出Linux文件系统中的文件属性。标志字母在chattr帮助中定义。usage: lsattr [-Radlv] [Files…] |
lsof | 列出属于所有活跃进程的所有打开的文件,或使用列出的FILE的进程。usage: lsof [-lt] [-p PID1,PID2,…] [FILE…] |
md5sum | 计算每个输入文件的哈希,如果没有,则从标准输入设备读取。每个输入文件输出一行哈希后跟文件名。usage: md5sum [-bcs] [FILE]… |
mkdir | 创建一个或多个目录。usage: mkdir [-vp] [-m mode] [dirname…] |
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 [-fivn] 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 FILE… |
realpath | 显示规范绝对路径名usage: realpath FILE… |
rev | 逆向输出每一行。usage: rev [FILE…] |
rm | 删除文件。usage: rm [-fiRrv] FILE… |
rmdir | 删除一个或多个目录。usage: rmdir [-p] [dirname…] |
sed | 流编辑器。将编辑脚本应用于输入行。usage: sed [-inrzE] [-e SCRIPT]… |
seq | 从头到尾按递增计数。省略参数默认值为1。使用两个参数作为第一个和最后一个。参数可以是负数或浮点数。usage: seq [-w |
setfattr | 写入 POSIX 扩展属性。usage: setfattr [-h] [-x |
sha1sum/sha256sum | 计算sha系列哈希值。usage: sha?sum [-bcs] [FILE]… |
shred | 安全的删除文件(用随机数据覆盖文件内容)。usage: shred [-fuz] [-n COUNT] [-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] [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] [FILES] |
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] [input_file [output_file]] |
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] [file] encode-filename |
wc | 统计输入中的行数、单词和字符。usage: wc -lwcm [FILE…] |
which | 在$PATH中搜索与文件名匹配的可执行文件。usage: which [-a] filename … |
xxd | 以16进制的形式显示文件内容。若没有列出任何文件,从标准输入设备复制。usage: xxd [-c n] [-g n] [-i] [-l n] [-o n] [-p] [-r] [-s n] [file] |
zcat | 将文件解压缩到标准输出设备。比如“gzip -dc”。usage: zcat [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…]"的格式。