描述
列出指定“文件”(默认为当前目录)的信息。如果既没有指定
-cftuvSUX
中任何一个,也没有指定
--sort,则按字母排序项目。
必选参数对长短选项同时适用。
- -a, --all
- 不要忽略以点号(“.”)起始的条目
- -A,
--almost-all
- 不要列出隐含的 . 和
..
- --author
- 与 -l
同时使用时,列出每个文件的作者
- -b, --escape
- 将无法显示的字符显示为C风格的转义形式
- --block-size=大小
- 与 -l
同时使用时,打印文件大小前将其除以指定的块大小;例如:"--block-size=M";参见下方的“大小”格式
- -B,
--ignore-backups
- 不要列出以 ~
结尾的项目
- -c
- 与 -lt
一起使用时:按照 ctime
排序,并显示
ctime(文件状态信息最后变更的时间);与
-l 一起使用时:显示
ctime
并按照名称排序;其它情况:按照
ctime
排序,最新的最前
- -C
- 逐列列出项目
- --color[=何时]
- 指定何时使用彩色输出;更多信息请见下文
- -d,
--directory
- 列出目录本身,而不是目录的内容
- -D, --dired
- 产生适合 Emacs 的 dired
模式使用的输出
- -f
- 按照目录顺序列出各项目
- -F,
--classify[=何时]
- 指定何时在项目后追加指示符号(*/=@|
中的一个)
- --file-type
- 类似,但不追加 "*"
字符
- --format=关键字
- across 同 -x、commas 同
-m、horizontal 同 -x、long 同
-l、single-column 同 -1、verbose 同
-l、vertical 同 -C
- --full-time
- 等于 -l --time-style=full-iso
- -g
- 类似
-l,但不列出所有者
- --group-directories-first
- 将目录排在文件前面;此选项可与
--sort
一起使用,但是一旦使用
--sort=none (-U)
则禁用此选项
- -G,
--no-group
- 使用长列表格式时,不输出组名
- -h,
--human-readable
- 同时使用 -l 或 -s
时,将大小表示为 1K 234M
2G 等
- --si
- 类似,但是使用1000的乘方,不使用1024
- -H,
--dereference-command-line
- 跟随命令行中列出的符号链接
- --dereference-command-line-symlink-to-dir
- 跟随命令行中列出的、指向目录的符号链接
- --hide=模式
- 隐藏符合指定 shell
模式的项目(-a 或
-A 使此选项失效)
- --hyperlink[=何时]
- 指定何时使用超链接显示文件名
- --indicator-style=关键字
- 指定在项目名称后追加的指示符号的风格:none(默认)、slash(同
-p)、file-type(同
--file-type)、classify(同
-F)
- -i, --inode
- 显示每个文件的索引编号(inode
号)
- -I,
--ignore=模式字符串
- 隐藏符合给定 shell
模式字符串的项目
- -k,
--kibibytes
- 显示文件系统使用量时,默认使用
1024
字节的块大小;只用于
-s
和每个目录的总计
- -l
- 使用长列表格式
- -L,
--dereference
- 显示符号链接的文件信息时,显示符号链接指向的文件的信息,而非符号链接本身的信息
- -m
- 所有项目以逗号分隔,并填满整行行宽
- -n,
--numeric-uid-gid
- 类似
-l,但列出用户和组的
ID 号
- -N, --literal
- 输出不加引号的项目名称
- -o
- 类似
-l,但不列出有关组的信息
- -p,
--indicator-style=slash
- 对目录追加 "/"
作为指示符号
- -q,
--hide-control-chars
- 以 "?"
字符代替不可打印的字符
- --show-control-chars
- 原样显示无法打印的字符(这是默认行为,除非被调用时的程序名是
"ls"
且在终端中进行输出)
- -Q,
--quote-name
- 在项目名称两侧加上双引号
- --quoting-style=关键字
- 使用指定的加引号方式显示项目名称:literal、locale、shell、shell-always、shell-escape、shell-escape-always、c、escape(该选项优先于
QUOTING_STYLE 环境变量)
- -r, --reverse
- 排序时逆序排列
- -R,
--recursive
- 递归列出子目录内容
- -s, --size
- 显示给每个文件分配的大小,单位为块
- -S
- 根据文件大小排序,最大的最前
- --sort=关键字
- 按照关键字而非名称进行排序:none(同
-U)、size(同
-S)、time(同
-t)、version(同
-v)、extension(同 -X)、width
- --time=关键字
- 改变使用的时间类型,默认为修改时间;访问时间(同
-u):atime、access、use;变更时间(同
-c):ctime、status;创建时间:birth、creation;
- 和 -l
同时使用时,关键字
指定要显示的时间类型;和
--sort=time
同时使用时,按照关键字进行排序(最新的最前)
- --time-style=时间风格
- 使用 -l
时显示的时间/日期格式;参见下面“时间风格”的相关内容
- -t
- 按时间排序,最新的最前;参见
--time
- -T,
--tabsize=列数
- 指定制表符宽度为给定列数,而非默认的
8
- -u
- 与 -lt
同时使用时:显示访问时间且按访问时间排序;与
-l
同时使用时:显示访问时间但按名称排序;其他情况:按访问时间排序,最新的最前
- -U
- 不进行排序;按照目录顺序列出项目
- -v
- 对文本中的数字(或版本号)进行自然排序
- -w,
--width=列数
- 设置输出宽度为指定列数。0
表示无限制
- -x
- 逐行列出项目而不是逐列列出
- -X
- 按照扩展名的字母顺序排序
- -Z, --context
- 输出每个文件的所有安全上下文信息
- --zero
- 以 NUL
字符而非换行结束每个输出行
- -1
- 每行只列出一个文件
- --help
- 显示此帮助信息并退出
- --version
- 显示版本信息并退出
大小的参数是一个整数,后面可以跟一个单位(例如:10K
指
10*1024)。可用的单位有
K、M、G、T、P、E、Z、Y(1024
的幂)以及 KB、MB、...(1000
的幂)。也可以使用二进制前缀:KiB=K、MiB=M,以此类推。
时间风格参数可以是
full-iso、long-iso、iso、locale,或者“+格式”。“格式”的解析方式同
date(1)。如果“格式”是
格式1<换行符>格式2
的话,则 格式1
将应用于时间较久远的文件,格式2
将应用于时间较近的文件。“时间风格”如果带有
"posix-"
前缀,则它只会在区域设置非
POSIX
时生效。另外,可以使用
TIME_STYLE
环境变量设置默认使用的风格。
“何时”参数的默认值是
"always",也可以设为
"auto" 或 "never"。
使用颜色来区分文件类型的功能默认禁用,也可以使用
--color=never 禁用。若使用
--color=auto 选项,ls
只在标准输出连接至终端时才生成颜色代码。LS_COLORS
环境变量可以改变颜色设置。可以使用
dircolors(1)
命令来设置它。
退出状态:
- 0
- 表示正常,
- 1
- 表示小问题(例如:无法访问子目录),
- 2
- 表示严重问题(例如:无法使用命令行参数)。
作者
由 Richard M. Stallman 和 David MacKenzie
编写。
报告错误
GNU coreutils 的在线帮助:
<https://www.gnu.org/software/coreutils/>
请向 <https://translationproject.org/team/zh_CN.html>
报告翻译错误。
版权
Copyright © 2022 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
本软件是自由软件:您可以自由修改和重新发布它。在法律允许的范围内,不提供任何保证。
参见
dircolors(1)
完整文档请见:
<https://www.gnu.org/software/coreutils/ls>
或者在本地使用: info
'(coreutils) ls invocation'
跋
本页面中文版由中文
man 手册页计划提供。
中文 man
手册页计划:https://github.com/man-pages-zh/manpages-zh