描述
列出指定“檔案”(預設為當前目錄)的資訊。如果既沒有指定
-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