LS(1) FreeBSD普通命令手册 LS(1)
名称(NAME)
ls -- 列出目录内容
大纲(SYNOPSIS)
ls [-ABCFGHILPRSTWZabcdfghiklmnopqrstuwx1] [file ...]
描述(DESCRIPTION)
对每个不同于目录类型的称为文件的操作数，ls显示出它的名称以及任何请求的、相
关的信息。对每个称为目录型文件的操作数，ls显示出包含于目录中的文件名，以及
任何请求的、相关的信息。
若没有给出操作数，则当前目录的内容将被显示出来。若给出不只一个操作数，则非
目录的操作数将首先被显示出来；目录和非目录操作数将分别以词典编纂顺序排列。
下面的选项是可用的：
- A 列出全部条目，除了“.”和“..”之外。自动设置为超级用户，除非–I被指定。
- B 强制非可打印字符(像ctype(3)定义和当前现场设置)以文件名\xxx格式打印，此
处的xxx是8进制字符的数字值。
- C 强制多列输出，当输出给一个终端时，此为默认。
- F 在每个路径名称之后紧跟着显示一个斜杠(‘/’)，在每个可执行的文件名称之后
显示一个星号(‘*’)，在每个符号链接后显示一个“在”标志(‘@’)，在每个
套接字后显示一个等于号(‘=’)，在每个空白处后面显示一个百分号(‘%’)，
在每个FIFO之后显示一个竖杠(‘|’)。
- G 允许彩色输出，此选项等价于在环境变量中定义CLICOLOR。(见下)
- H 命令行上的符号链接将被跟随，此选项假定选项-F、-d或-l中没有一个被给出。
- I 阻止-A被自动设置成超级用户。
- L 若论据是一个符号链接，列出涉及的文件或目录好于链接自身。此选项取消了-P
选项。
- P 若论据是一个符号链接，列出链接自身好于涉及的文件或目录。此选项取消了–H
和-P选项。
- R 递归列出遇到的子目录。
- S 以词典编纂顺序给操作数排序之前，按大小排序(大文件优先)。
- T 带-l选项使用时，给文件显示出完整的时间信息，包括年月日、时分秒。
- W 扫描目录时显示空白。
- Z 显示每个文件的MAC标签。参见maclabel(7)。
- a 包括名称以点形状的目录条目。
- b 像–B，但尽可能使用C逃脱代码。
- d 目录被显示为普通文件(并不递归查找)。
- f 输出不被排序。
- g 此选项不赞成使用，而且只对4.3版BSD的兼容性有效；其通常用于显示长(-l)
格式输出中的组名。
- h 带-l选项使用时，用单位后缀：Byte、Kilobyte、Megabyte、Gigabyte、Terabyte
和Petabyte来缩减数值位数到4位，或更少到用基数2位做为大小。
- i 对每个文件打印出文件的序号(节点号)。
- k 与设置环境变量BLOCKSIZE到1024有同样效果。此外，任意一个-h选项在它的
左边，其也会失效。
- l (小写字母“ell”)以长格式列出文件，在The Long Format子段落下有详细叙述。
- m 流输出格式；列出跨页的、以逗号分隔的文件。
- n 以数字显示用户或组的标识符，好于转换成长格式(-l)输出中的用户名或组名。
- o 包括以长格式(-l)输出的文件标志。
- p 若文件是一个目录，在每个文件名之后显示一个斜杠(‘/’)。
- q 强制文件名的非图形字符(像字符‘？’)的打印，当输出给一个终端时，此为默
认。
- r 逆转排列的顺序。
- s 显示文件系统中被每个文件使用的块数，地的大小和目录总数受到掌控，在The
Long Format子段落下有详述，此外（若并不要求长格式）当输出是单独一列时，
目录总数并不输出，甚至是在要求多列输出时。
- t 在以词典编纂顺序排列操作数之前，通过修改的时间（最近期修改的优先）排列。
- u 使用最近的访问时间，代替文件的最近修改时间做为排列（-t）或打印(-l).
- w 强制非可打印字符以行格式打印，当输出给终端时，此为默认。
- x 像-c一样，除了多列输出以跨列（好于向下）排序的条目增加。
- 1 (数字“1”)强制输出为每行一个条目，当输出不对终端时，此为默认。
选项-1、-C、-x和-l彼此全都覆盖。指定的最后一个决定使用的格式。
选项-c和-u彼此覆盖，指定的最后一个决定使用的文件时间。
选项-B、-b、-w和-q彼此全都覆盖。指定的最后一个决定用于非可打印字符的格式。
选项-H、-L和-P彼此全都覆盖（或部分地或全部地）。它们应用于指定的目的。
在默认情况下，ls每行列出一条到标准输出，例外的是，给终端或当选项-C与-x被指
定时。
文件信息以一个或多个空白分离的、且与选项-i、-s和-l相关的信息显示出来。
长格式（The Long Format）
若选项-l被给出，接下来的信息为每个文件显示出来：文件模式、链接数、所有者名、
组名、MAC标签、文件的字节数、缩写的月份、被最近修改的日期月份文件、最近修改
的小时文件、最近修改的分钟文件，以及路径名。
若文件的修改时间大于过去的或将来的6个月时间，则最后修改的年份将显示在小时和
分钟域的位置。
若所有者或组名不是一个书籍的用户或组名，或者-n被给出，数字形式的标识符将被显
示出来。
若文件是一个字符形或块形特殊文件，给文件的主要及次要设置数将显示在大小域。若
文件是一个符号链接，则链接到文件的路径名将在“->”之前出现。
目录内容的列出是在标识出的、被文件在文件系统中使用的数据块的总数之前出现的，
此处的文件是做为目录的内容而列出(目录内容也许会或不会包括.与..以及其他以点开
始的、依赖其他选项的文件)。
默认块大小是512字节，块大小可以和选项-K或环境变量一起设置。输出中的块数将会
被聚集，因此字节数至少像类似的文件系统块（其也许有不同的大小）一样多。
在选项-l下打印的文件模式由条目类型和权限组成。条目类型字符描述文件类型，如下：
b 块形特殊文件
c 字符形特殊文件
d 目录
l 符号链接
s 套接字链接
P FIFO先入先出
- 常规文件
接下来的三个区域是每个域三个字符：所有权限、组权限和其他权限。每个域有三个字
符位：
1. 若r，文件可读；若-，其不可读。
2. 若w，文件可写；若-，其不可写。
3. 下面中的头一个，其应用：
S 若在所有者权限内，文件不可执行并且用户标志模式是设置的。若在组
权限内，此文件不可执行并且给身份模式是设置的。
s 若在所有者权限内，文件不可执行，并且用户标志模式是设置的。若在
组权限内，文件是可执行的，并且组标志模式是设置的。
x 文件是可执行的或目录是可查找的。
- 文件既不能读、写、执行，也不是用户标志模式、组标志模式、黏性模
式(见下)。
下面的这两个只应用于最后一组(其他权限)中的敏感字符。
T 黏性位被设置(1000模式)，但并不执行或查找权限。(参见chmod(1)或
sticky(8)。)
t 黏性位被设置(1000模式)，并且是可查找的或可执行的。(参见在
chmod(1)或sticky(8)。)
若文件有一个ACL，下面的域包含一个“加”(‘+’)字符，或者若没有，则是一个空格
(‘ ’)。工具ls并不显示确切的ACL，使用getfacl(1)去做这个。
环境(ENVIRONMENT)
下面的环境变量会影响ls的执行：
BLOCKSIZE 若其被设置，它的值--—聚集到512或下降至512的倍数--—将被选
项-l和-s以字节做为块大小来使用。参见长格式子段获得更多信息。
CLICOLOR 用ANSI颜色顺序来区分文件类型。参见下面的LSCOLOR。此外在选项
-F中提到的文件类型---一些额外的属性(setuid位设置，等等)也会
显示出来。彩色化依赖于适当的tercap(1)兼容性一致的终端类型。
默认的控制台“”具有适当的兼容性，但在一个X(1)中显示彩色。例
如变量TERM必须设置成“”。其他终端类型也许需要相似的调整。若
输出并不直接给终端，彩色化是暗中禁用的，除非变量
CLICOLOR_FORCE得到定义。
CLICOLOR_FORCE 若输出并不直接给终端，颜色顺序通常不可用。其可以通过设置此标
志来覆盖。变量TERM无论如何仍然需要参考一个具有彩色能力的终
端。否则不可能决定使用哪种颜色顺序。
COLUMNS 若此变量包含一个声名为整数的字符串，其像列宽一样用于显示多个
文本列输出。工具ls计算出基于提供的宽度显示多少路径名文本列。
(参见-C和-x)
LANG 当场使用，当确定长格式-l输出中年月的顺序时。参见enviror(7)
获得更多信息。
LSCOLORS 当颜色带CLICOLOR可用时，此变量值描述用于哪个属性的什么颜色。
此字符串是数对fb格式的相关物，此处f是前景色，而b是背景色。
颜色如下：
a 黑
b 红
c 绿
c 棕
d 蓝
f 紫红
g 青
h 浅灰
A 粗黑，通常显示成灰黑
B 粗红
C 粗绿
D 粗棕
E 粗蓝
F 粗紫红
G 粗青
H 粗浅灰，看起来像亮白
X 默认前景或背景色
注意，以上是标准ANSI颜色。真实地显示也许不同，这依赖于使用中
终端的颜色兼容性。
属性的顺序如下：
1． 目录
2． 符号链接
3． 套接字
4． 管道
5． 可执行的
6． 块形特例
7． 字符形特例
8． 带setuid位设置的可执行的
9． 带setgid位设置的可执行的
10． 带黏性位的对其他人可写的目录
11． 无黏性位的对其他人可写的目录
默认是“exfxcxdxbxegedabagacad”，蓝色前景和默认背景给常规目
录，黑色前景和红色背景给setuid可执行的，等等。
LS_COLWIDTHS 若此变量被设置，其被认为是一个最小列宽的冒号界定的列表。不合
理的和不重要的宽度将被忽略(因此零标识动态大小的列)。并不是所
有列具有可更改的宽度。这些域按顺序为：节点、快数、链接数、用
户名、组名、标志、文件大小、文件名。
TERM CLICOLOR功能依赖于和颜色兼容的终端类型。
TZ 当显示日期时，显示时区。参见environ(7)获得更多信息。
退出状态(EXIT STATUS)
工具ls成功时退出0，当错误发生时>0。
兼容性(COMPATIBILITY)
组域现在自动地包含在文件的长列表中，目的是与IEEE 1003.2(“POSIX.2”)标准特殊
性兼容的。
另外参见(SEE ALSO)
chflags(1), chmod(1), getfacl(1), sort(1), xterm(1), termcap(5),maclabel(7),
symlink(7), getfmac(8), sticky(8)
标准(STANDARDS)
除了选项-I、-g、-h和-o，工具ls遵从IEE1003.1-2001(“POSIX.1”)标准。
ACT支持与IEEE 1003.2c(“POSIX.2c”)标准草案(撤回)相兼容。
历史(HISTORY)
ls命令出现于AT&T UNIX第一版。
错误(BUGS)
维持向后兼容性，许多选项之间的关系是十分复杂的。
在-s描述中提到的例外情况，也许是一个特色，此特色基于这样的实情，即单列输出通
常转到不同于终端的地方。这是否为一个设计错误还是一个争议。
阅读(1563) | 评论(0) | 转发(0) |
