# ls
- [命令功能](#section01)
- [命令格式](#section02)
- [参数说明](#section03)
- [使用指南](#section04)
- [使用实例](#section05)
- [输出说明](#section06)
## 命令功能
ls命令用来显示当前目录的内容。
## 命令格式
ls \[_-ACHLSZacdfhiklmnopqrstux1_\] \[_--color_\[_=auto_\]\] \[_directory..._\]
> **说明：** 系统启动过程中已经通过 alias 为 ls=toybox ls --color=auto 、ll = ls -alF 、 la=ls -A 和 l=ls -CF 赋能，使这几个命令的初始行为就和linux相同（详细效果见输出说明）。所以若要查看help列表，请输入'toybox ls --help'。
## 参数说明
**表 1** 展示功能参数说明
参数
参数说明
取值范围
--help
查看ls命令支持的参数列表，使用方式。
N/A
-a
显示所有文件包括.hidden隐藏类型的文件。
N/A
-b
转义非图形字符。
N/A
-c
使用ctime作为文件的时间戳。"ls -lc"
N/A
-d
只显示path名称不显示path所包含的内容。
N/A
-i
显示文件的节点号。
N/A
-p
在path名称后放一个"/"。
N/A
-q
显示不可打印字符比如'?'。
N/A
-s
统计目录和其成员所占用的内存大小，单位为1024字节。
N/A
-u
以文件的最后访问时间为时间戳，配合 -l 一起使用。
N/A
-A
列出所有文件除了.和..
N/A
-H
跟随命令行符号链接。
N/A
-L
跟随符号链接。
N/A
-Z
安全上下文。
N/A
path
path为空时，显示当前目录的内容。
path为无效文件名时，显示失败，提示：
ls error: No such directory。
path为有效目录路径时，会显示对应目录下的内容。
1.为空。
2.有效的目录路径。
**表2** 输出格式参数说明
参数
参数说明
取值范围
-1
每行列出一个文件。
N/A
-c
列，垂直排序。
N/A
-g
类似于 -l 但没有所有者。
N/A
-h
统计path目录下文件的总大小，单位为KiB。
N/A
-l
详细的显示path目录下文件的信息。
N/A
-m
文件之间添加逗号。
N/A
-n
类似 -l 数字格式显示uid/gid。
N/A
-o
类似 -l 但显示列表不包括组。
N/A
-x
列，水平排序。
N/A
-ll
文件的时间属性显示纳秒。
N/A
--color
彩色打印。
默认配置为：device=yellow symlink=turquoise/red dir=blue socket=purple files: exe=green suid=red suidfile=redback stickydir=greenback=auto means detect if output is a tty.