Provided by:
manpages-zh_1.5.1-2_all 
NAME
ls, dir, vdir - 列目錄內容
n
ls [選項] [檔名...]
POSIX 標準選項: [-CFRacdilqrtu1]
GNU ():
[-1abcdfgiklmnopqrstuxABCDFGLNQRSUX] [-w cols] [-T cols] [-I pattern]
[--full-time] [--format={long,verbose,commas,across,vertical,single-
column}] [--sort={none,time,size,extension}]
[--time={atime,access,use,ctime,status}] [--color[={none,auto,always}]]
[--help] [--version] [--]
yzDESCRIPTION^
程式ls先列出非目錄的檔案項，然後是每一茈媬中的"可顯示"檔案。如果
沒有選項之外的參數【譯注：即檔名部分為空】出現，預設為 "."
（當前目錄）。 選項" -d "使得目錄與非目錄項同樣對待。除非" -a "
選項出現，文 件名以"."開始的檔案不屬"可顯示"檔案。
以當前目錄為準，每一組檔案（包括非目錄檔案項，以及每一內含檔案的目錄）分
別按檔名比較順序排序。如果" -l "選項存在，每組檔案前顯示一摘n行:
給出該組檔案長度之和（以 512 字節為單位）。
輸出是到標準輸出（ stdout ）。除非以" -C "選項n求按多列輸出，輸出
將是一行一荂C然而，輸出到終端時，單列輸出或多列輸出是不確定的。可以分別
用選項" -1 " 或" -C "來強制按單列或多列輸出。
-C 多列輸出，縱向排序。
-F 每茈媬名加" / "延伸檔名，每 FIFO 名加" | "延伸檔名， 每-
茈i運行名加" * "延伸檔名。
-R 遞歸列出遇到的子目錄。
-a 列出所有檔案，包括以 "." 開頭的隱含檔案。
-c 使用"狀態改變時間"代替"檔案蚹黈伅"為依據來排序 （使用" -t
"選項時）或列出（使用" -l "選項時）。
-d 將目錄名像其它檔案一樣列出，而不是列出它怐漱漁e。
-i 輸出檔案前先輸出檔案系列號（即 i 節點號: i-node number）。 -l
列出（以單列格式）檔案模式（ file mode ），檔案的鏈
接數，所有者名，組名，檔案大小（以字節為單位），時間信
息，及檔名。預設時，時間信息顯示最近蚹黈伅﹛F可以以 選項" -c
"和" -u "選擇顯示其它兩種時間信息。對於設 備檔案，-
鴠顯示檔案大小的區域通常顯示的是主n和次n的 號（majorand minor
device numbers）。
-q 將檔名中的非列印字符輸出為問號。（對於到終端的輸出這是預設的。）
-r 逆序排列。
-t 按時間信息排序。
-u 使用最近訪問時間代替最近蚹黈伅′馬抩琩荓]使用 " -t
"選項時）或列出（使用" -l "選項時）。
-1CXC
GNU`
如果標準輸出是終端，將多列輸出（縱向排序）。
dir ( 也被安裝為命令 d ) 等同於" ls -C "；即，檔案
預設是多列輸出，縱向排序。vdir ( 也被安裝為命令 v ) 等同於" ls
-l "； 即，檔案預設是按長格式輸出。
GNU項
-1, --format=single-column 一行輸出一-
蚗仵蛂]單列輸出）。如標準輸出不是到終端， 此選項就是預設選項。
-a, --all
列出目錄中所有檔案，包括以"."開頭的檔案。
-b, --escape
把檔名中不可輸出的字符用反斜槓加字符編號(就像在 C
語言裏一樣)的形式列出。
-c, --time=ctime, --time=status
按檔案狀態改變時間（i節點中的ctime）排序並輸出目錄內
容。如採用長格式輸出（選項"-l"），使用檔案的狀態改
變時間取代檔案蚹黈伅﹛C【譯注：所謂檔案狀態改變（i節
點中以ctime標誌），既包括檔案被蚹鵅A又包括檔案屬性（
如所有者、組、鏈接數等等）的變化】
-d, --directory
將目錄名像其它檔案一樣列出，而不是列出它怐漱漁e。
-f 不排序目錄內容；按它怞b磁碟上存儲的順序列出。同時啟 動" -a
"選項，如果在" -f "之前存在" -l "、" - -color "或" -s
"，則禁止它怴C
-gAeUNIX-i, --inode
在每蚗仵蚰秉鉿C印 i 節點號（也叫檔案序列號和索引號: file serial
number and index number）。i節點號在每-
荅S定的檔案系統中是唯一的。
-k, --kilobytes
如列出檔案大小，則以千字節KB為單位。
-l, --format=long, --format=verbose
除每蚗犰W外，增加顯示檔案類型、權、硬鏈接數、所
有者名、組名、大小（ byte ）、及時間信息（如未指明是
其它時間即指蚹黈伅﹛^。對於6茪諝H上的檔案或超出未來 1
小時的檔案，時間信息中的時分將被年代取代。
每茈媬列出前，有一行"總塊數"顯示目錄下全部檔案所
佔的磁碟空間。塊預設是 1024 字節；如果設置了 POSIXLY_CORRECT
的環境變量，除非用" -k "選項，則預設塊大小是 512 字 節。每一-
茧w鏈接都p入總塊數（因此可能契_p數），這無 疑是荅岈I。
列出的權類似於以符號表示（檔案）模式的規範。但是 ls
在每套權的第三茼r符中結合了多位（ multiple bits ）
的信息，如下： s 如果設置了 setuid 位或 setgid
位，而且也設置了相應的可執行位。 S 如果設置了 setuid 位或 setgid
位，但是沒有設置相應的可執行位。 t 如果設置了 sticky
位，而且也設置了相應的可執行位。 T 如果設置了 sticky
位，但是沒有設置相應的可執行位。 x
如果僅僅設置了可執行位而非以上四種情況。 -
其它情況（即可執行位未設置）。
-m, --format=commas
水它C出檔案，每行盡可能多，相互用逗號和一茠躓璊戴j。
-n, --numeric-uid-gid
列出數字化的 UID 和 GID 而不是使用者名和組名。
-o 以長格式列出目錄內容，但是不顯示組信息。等於使用" --format=long
--no-group "選項。提供此選項是為了與其它版本的 ls 相容。
-p 在每蚗犰W後附上一茼r符以說明該檔案的類型。類似" -F "選項但是不
標示可執行檔案。
-q, --hide-control-chars
用問號代替檔名中非列印的字符。這是預設選項。
-r, --reverse
逆序排列目錄內容。
-s, --size
在每蚗犰W左側輸出該檔案的大小，以 1024
字節的塊為單位。如果設置了 POSIXLY_CORRECT 的環境變量，除非用"
-k "選項，塊大小是 512 字節。
-t, --sort=time
按檔案最近蚹黈伅﹛] i 節點中的 mtime
）而不是按檔案名字典序排序，新檔案 靠前。
-u, --time=atime, --time=access, --time=use
類似選項" -t "，但是用檔案最近訪問時間（ i 節點中的 atime
）取代檔案
改時間。如果使用長格式列出，列印的時間是最近訪問時間。
-w, --width cols
假定螢幕寬度是 cols （ cols
以實際數字取代）列。如未用此選項，預設O這
樣獲得的：如可能先嘗試取自終端驅動，否則嘗試取自環境變量 COLUMNS
（如果設 置了的話），都不行則取 80 。
-x, --format=across, --format=horizontal
多列輸出，橫向排序。
-A, --almost-all
顯示除 "." 和 ".." 外的所有檔案。
-B, --ignore-backups
不輸出以" ~ "結尾的備份檔案，除非已經在命令行中給出。
-C, --format=vertical
多列輸出，縱向排序。當標準輸出是終端時這是預設項。使用命令名 dir
和 d 時， 則總是預設的。
-D, --dired
當採用長格式（" -l "選項）輸出時，在主n輸出後，額外列印一行：
//DIRED// BEG1 END1 BEG2 END2 ...
BEGn 和 ENDn 是無符號整數，記錄每蚗犰W的起始、結束位置在輸出中的位置（
字節偏移量）。這使得 Emacs
易於找到檔名，即使檔名包含空格或換行等非正
常字符也無需特異的搜索。
如果目錄是遞歸列出的（" -R "選項），每茪l目錄後列出類似一行：
//SUBDIRED// BEG1 END1 ... 【譯注：我測試了 TurboLinux4.0 和
RedHat6.1 ，發現它抭ㄛO在 " //DIRED// BEG1... "之後列出"
//SUBDIRED// BEG1 ... "，也即只有一 而不是在每-
茪l目錄後都有。而且" //SUBDIRED// BEG1 ... "列出的是各茪l目
錄名的偏移。】
-F, --classify, --file-type
在每蚗犰W後附上一茼r符以說明該檔案的類型。" *
"表示普通的可執行檔案； " / "表示目錄；" @ "表示符號鏈接；" |
"表示FIFOs；" = "表示套接字 (sockets)
；什麼也沒有則表示普通檔案。
-G, --no-group
以長格式列目錄時不顯示組信息。
-I, --ignorepattern
除非在命令行中給定，不n列出匹配 shell 檔名匹配式（ pattern
，不是指一般 表達式）的檔案。在 shell 中，檔名以 "."
起始的不與在檔名匹配式 (pattern) 開頭的通配符匹配。
-L, --dereference
列出符號鏈接指向的檔案的信息，而不是符號鏈接本芋C
-N, --literal
不n用引號引起檔名。
-Q, --quote-name
用雙引號引起檔名，非列印字符以 C 語言的方法表示。
-R, --recursive
遞歸列出全部目錄的內容。
-S, --sort=size
按檔案大小而不是字典序排序目錄內容，大檔案靠前。
-T, --tabsize cols
假定每茖謇穛髒e度是 cols 。預設為 8。為求效率， ls
可能在輸出中使用制表符。 Y cols 為 0，則不使用制表符。
-U, --sort=none
不排序目錄內容；按它怞b磁碟上存儲的順序列出。（選項" -U "和" -f
"的不
同是前者不啟動或禁止相關的選項。）這在列很大的目錄時特別有用，因為不加排序
能顯著的加快速度。
-X, --sort=extension
按檔案擴展名（由最後的 "."
之後的字符組成）的字典序排序。沒有擴展名的先列 出。
--color[=when]
指定是否使用顏色區別檔案類別。環境變量 LS_COLORS
指定使用的顏色。如何設置 這蚥僆q見 dircolors(1) 。 when
可以被省略，或是以下幾項之一：
none 不使用顏色，這是預設項。
auto 僅當標準輸出是終端時使用。 always 總是使用顏色。指定
--color 而且省略 when 時就等同於 --color=always 。
--full-time
列出完整的時間，而不是使用標準的縮寫。格式如同 date(1)
的預設格式；此格式 是不能改變的，但是你可以用 cut(1)
取出其中的日期字串並將結果送至命令 " date -d "。
輸出的時間包括秒是非常有用的。（ Unix
檔案系統儲存檔案的時間信息精確到秒，
因此這蚇龠竣w經給出了系統所知的全部信息。）例如，當你有一
Makefile 檔案 不能恰當的生成檔案時，這蚇龠絲|提供幫助。
GNU項
--help 列印用法信息到標準輸出並順利退出。
--version
列印版本信息到標準輸出並順利退出。
-- 結束選項表。
境
變量 POSIXLY_CORRECT 可以決定一組選擇。如果沒有設置此變量，每-
茖謇穛讀漲r 符數由變量 TABSIZE 決定。變量 COLUMNS （當它由一-
茪Q進制整數表示時）決定輸 出的列寬度（同" -C
"選項一起用時）。檔名不得為適應多列輸出而被截斷。變 量 LANG, LC_ALL,
LC_COLLATE, LC_CTYPE, LC_MESSAGES 及 LC_TIME 仍保持鼽q。 變量 TZ
給出時區供 ls 輸出相應的時間字串。變量 LS_COLORS 用以決定是否使用
顏色。
w~
在 BSD 系統上，對於從 HP-UX 系統上通過 NFS mount 而來的檔案，" -s
"選項報 告的大小只有正確漱@半；在 HP-UX 系統上，對於從 BSD 系統上通過
NFS mount 而來的檔案， ls 報告的大小則有正確漕熂。這是 HP-UX 的一-
荅妘斑y成的，它 也影響 HP-UX 上的 ls 程式。
AX到
POSIX 1003.2
見
dircolors(1)
`N
本韌yz的是 fileutils-3.16 檔案包中的 ls
，其它版本的可能略有不同。糾錯或添 加（弁遄^請 mailto: aeb@cwi.nl 和
aw@mail1.bet1.puv.fi 及 ragnar@lightside.ddns.org 。本程式的錯誤報告請
mailto: fileutils-bugs@gnu.ai.mit.edu 。
[]
wangdong <wangdong@163.net>
[]
2003.11.22
mlinuxan:
http://cmpp.linuxforum.net