用法:ls [選項]... [檔案]...
列出<檔案>的資訊 (預設為目前的目錄)。
如果不指定 -cftuvSUX 或 --sort 任何一個選項,則根據字母大小排序。
長選項必須用的參數在使用短選項時也是必需的。
-a, --all 不隱藏任何以 . 字元開始的項目
-A, --almost-all 列出除了 . 及 .. 以外的任何項目
--author 和 -l 同時使用時列出每個檔案的作者
-b, --escape 以八進位溢出序列表示不可列印的字元
--block-size=大小 塊以指定<大小>的位元組為單位
-B, --ignore-backups 不列出任何以 ~ 字元結束的項目
-c 配合 -lt:根據 ctime 排序及顯示 ctime (檔案
狀態最後更改的時間)
配合 -l:顯示 ctime 但根據名稱排序
否則:根據 ctime 排序
-C 每欄由上至下列出項目
--color[=WHEN] 控制是否使用色彩分辨檔案。WHEN 可以是
“never”、“always”或“auto”其中之一
-d, --directory 當遇到目錄時列出目錄本身而非目錄內的檔案
-D, --dired 產生適合 Emacs 的 dired 模式使用的結果
-f 不進行排序,-aU 選項生效,-lst 選項失效
-F, --classify 加上檔案類型的指示符號 (*/=@| 其中一個)
--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
對檔案分組之前先對目錄分組
-G, --no-group 以一個長列表的形式,不輸出組名
-h, --human-readable 與-l一起,以易於閱讀的格式印出檔案大小
(例如 1K 234M 2G)
--si 同上面一樣,不過使用的基底是1000而不是1024
-H, --dereference-command-line
跟隨命令列列出的符號連結
--dereference-command-line-symlink-to-dir
跟隨命令列列出的目錄的符號連結
--hide=PATTERN 隱藏符合PATTERN模式的項目
(-a 或 -A 將覆蓋此選項)
--indicator-style=方式 指定在每個項目名稱後加上指示符號<方式>:
none (預設),classify (-F),file-type (-p)
-i, --inode 印出每個檔案的 inode 號
-I, --ignore=樣式 不印出任何符合 shell 萬用字元<樣式>的項目
-k 即 --block-size=1K
-l 使用較長格式列出資訊
-L, --dereference 當顯示符號連結的檔案資訊時,顯示符號連結所指示
的對象而並非符號連結本身的資訊
-m 所有項目以逗號分隔,並填滿整行行寬
-n, --numeric-uid-gid 類似 -l,但列出 UID 及 G識別碼
-N, --literal 印出未經處理的項目名稱 (如不特別處理控制字元)
-o 類似 -l,但不列出有關組的資訊
-p, --indicator-style=slash 對目錄加上表示符號“/”
-q, --hide-control-chars 以 ? 字元代替無法列印的字元
--show-control-chars 直接顯示無法列印的字元 (這是預設,除非調用
的程式名稱是“ls”而且是在終端機畫面輸出結果)
-Q, --quote-name 將條目名稱括上雙引號
--quoting-style=方式 使用指定的 quoting <方式>顯示條目的名稱:
literal、locale、shell、shell-always、c、escape
-r, --reverse 逆序排序
-R, --recursive 遞迴列出所有子目錄
-s, --size 和 -l 同時使用時以塊為單位列出每個檔案的大小
-S 根據檔案大小排序
--sort=WORD 以下是可選用的 WORD 和它們代表的相應選項:
extension -X status -c
none -U time -t
size -S atime -u
time -t access -u
version -v use -u
--time=WORD 和 -l 同時使用時顯示 WORD 所代表的時間而非修改時
間:atime、access、use、ctime 或 status;加上
--sort=time 選項時會以指定時間作為排序關鍵字
--time-style=STYLE 和 -l 同時使用時根據 STYLE 代表的格式顯示時間:
full-iso、iso、locale、posix-iso、+FORMAT。
FORMAT 即是“date”所用的時間格式;如果 FORMAT
是 FORMAT1<新行>FORMAT2,FORMAT1 適用於較舊
的檔案而 FORMAT2 適用於較新的檔案;如果 STYLE
以“posix-”開頭,則 STYLE 僅在 POSIX 語系之外
生效。
-t 根據修改時間排序
-T, --tabsize=寬度 自行指定 tab 的<寬度>,而非 8 個字元
-t 按修改時間排序
-T, --tabsize=COLS 指定TAB使用的空格個數
-u 配合 -lt:顯示訪問時間而且依訪問時間排序
配合 -l:顯示訪問時間但根據名稱排序
否則:根據訪問時間排序
-U 不進行排序;依檔案系統原有的次序列出項目
-v 根據版本進行排序
-w, --width=COLS 自行指定螢幕寬度而不使用目前的數值
-x 逐行列出項目而不是逐欄列出
-X 根據副檔名排序
-1 每行只列出一個檔案
--help 顯示此協助資訊並離開
--version 顯示版本資訊並離開
<大小>可以是以下的單位 (單位前可加上整數):
kB 1000,K 1024,MB 1000*1000,M 1024*1024,還有 G、T、P、E、Z、Y。
預設是不會使用色彩來區別檔案的。此方式等於使用了 --color=none 選項。若使用
--color 選項但不指定 WHEN 參數等於 --color=always。當使用 --color=auto 時,
只當輸出至終端機畫面 (tty) 時才會顯示色彩。
如果一切正常,退出狀態為 0;如果出現小問題退出狀態為 1;如果出現嚴重問題則為 2。
請向 <bug-coreutils@gnu.org> 報告錯誤。